import { afterEach, describe, expect, it } from "vitest"; import { checkToken, configuredToken, providedToken, queryTokenMatches, readCookie, TOKEN_COOKIE, TOKEN_HEADER } from "./auth.js"; /** 极简 reply 替身:记录是否写出 401 */ const makeReply = () => { const calls: number[] = []; return { calls, status(code: number) { calls.push(code); return { send: (body: unknown) => body }; }, }; }; const original = process.env.LPT_AI_TOKEN; afterEach(() => { if (original === undefined) { delete process.env.LPT_AI_TOKEN; } else { process.env.LPT_AI_TOKEN = original; } }); describe("AI 入站令牌", () => { it("未配置令牌时放行,保持开发环境零摩擦", () => { delete process.env.LPT_AI_TOKEN; expect(configuredToken()).toBe(""); const reply = makeReply(); expect(checkToken({ headers: {} }, reply)).toBe(true); expect(reply.calls).toEqual([]); }); it("配置令牌后,缺令牌的请求被拒绝", () => { process.env.LPT_AI_TOKEN = "secret-token"; const reply = makeReply(); expect(checkToken({ headers: {} }, reply)).toBe(false); expect(reply.calls).toEqual([401]); }); it("配置令牌后,header 提供正确令牌放行", () => { process.env.LPT_AI_TOKEN = "secret-token"; const reply = makeReply(); expect(checkToken({ headers: { [TOKEN_HEADER]: "secret-token" } }, reply)).toBe(true); expect(reply.calls).toEqual([]); }); it("支持用 query 传令牌(便于在浏览器里打开 /admin)", () => { process.env.LPT_AI_TOKEN = "secret-token"; const reply = makeReply(); expect(checkToken({ headers: {}, query: { token: "secret-token" } }, reply)).toBe(true); }); it("令牌错误被拒绝", () => { process.env.LPT_AI_TOKEN = "secret-token"; const reply = makeReply(); expect(checkToken({ headers: { [TOKEN_HEADER]: "wrong" } }, reply)).toBe(false); expect(reply.calls).toEqual([401]); }); it("空白令牌视为未配置", () => { process.env.LPT_AI_TOKEN = " "; expect(configuredToken()).toBe(""); expect(checkToken({ headers: {} }, makeReply())).toBe(true); }); it("支持 cookie 传令牌:面板 HTML 与它后续的 fetch 是两个独立请求", () => { process.env.LPT_AI_TOKEN = "secret-token"; const reply = makeReply(); expect( checkToken({ headers: { cookie: `${TOKEN_COOKIE}=secret-token` } }, reply), ).toBe(true); expect(reply.calls).toEqual([]); }); it("cookie 与其它 cookie 混在一起时仍能取出令牌", () => { process.env.LPT_AI_TOKEN = "secret-token"; const reply = makeReply(); expect( checkToken( { headers: { cookie: `a=1; ${TOKEN_COOKIE}=secret-token; b=2` } }, reply, ), ).toBe(true); }); it("header 优先于 cookie,避免旧 cookie 把新令牌挡在门外", () => { process.env.LPT_AI_TOKEN = "new-token"; const reply = makeReply(); expect( checkToken( { headers: { [TOKEN_HEADER]: "new-token", cookie: `${TOKEN_COOKIE}=old-token` } }, reply, ), ).toBe(true); }); }); describe("readCookie", () => { it("取出 URL 编码的值", () => { expect(readCookie("t=a%20b", "t")).toBe("a b"); }); it("编码非法时退回原值,不抛异常", () => { expect(readCookie("t=%E0%A4%A", "t")).toBe("%E0%A4%A"); }); it("缺失时返回 undefined", () => { expect(readCookie(undefined, "t")).toBeUndefined(); expect(readCookie("a=1", "t")).toBeUndefined(); expect(readCookie("novalue", "t")).toBeUndefined(); }); }); describe("providedToken", () => { it("按 header → query → cookie 的优先级取值", () => { process.env.LPT_AI_TOKEN = "secret-token"; expect( providedToken({ headers: { [TOKEN_HEADER]: "from-header", cookie: `${TOKEN_COOKIE}=from-cookie` }, query: { token: "from-query" }, }), ).toBe("from-header"); expect( providedToken({ headers: {}, query: { token: "from-query" } }), ).toBe("from-query"); expect( providedToken({ headers: { cookie: `${TOKEN_COOKIE}=from-cookie` } }), ).toBe("from-cookie"); expect(providedToken({ headers: {} })).toBe(""); }); }); describe("queryTokenMatches", () => { it("仅在 query 令牌正确时返回 true,用于决定要不要下发 cookie", () => { process.env.LPT_AI_TOKEN = "secret-token"; expect(queryTokenMatches({ query: { token: "secret-token" } })).toBe(true); expect(queryTokenMatches({ query: { token: "wrong" } })).toBe(false); expect(queryTokenMatches({})).toBe(false); }); it("未配置令牌时不下发 cookie", () => { delete process.env.LPT_AI_TOKEN; expect(queryTokenMatches({ query: { token: "" } })).toBe(false); }); });