import { describe, expect, test } from "vitest"; import { resolveApiSessionCookiePolicy, resolveHostOnlyCookiePolicy, resolveSessionCookiePolicy, resolveWebSessionCookiePolicy } from "./session-cookie.js"; const productionRouting = { appBaseDomain: "example.com", protocol: "https" as const, }; describe("session cookie policy", () => { test("sets a shared hardened cookie policy for production app base domains", () => { const policy = resolveSessionCookiePolicy({ nodeEnv: "production", routing: productionRouting, name: "session", maxAge: 60 * 60, }); expect(policy).toEqual({ name: "session", maxAge: 3600, domain: "example.com", sameSite: "lax", secure: true, httpOnly: true, path: "/", }); expect(JSON.stringify(policy)).not.toContain("secret"); }); test("keeps localhost cookies domainless for local development", () => { expect( resolveSessionCookiePolicy({ nodeEnv: "development", routing: { appBaseDomain: "localhost:3000", protocol: "http", }, }) ).toEqual({ sameSite: "lax", secure: false, httpOnly: true, path: "/", }); expect( resolveSessionCookiePolicy({ nodeEnv: "development", routing: { appBaseDomain: "app.localhost", protocol: "http", }, }) ).not.toHaveProperty("domain"); }); test("enables secure cookies for HTTPS routing outside production", () => { expect( resolveSessionCookiePolicy({ nodeEnv: "test", routing: { appBaseDomain: "example.test", protocol: "https", }, }) ).toMatchObject({ domain: "example.test", sameSite: "lax", secure: true, httpOnly: true, path: "/", }); }); test("resolves API session cookies with the API name and host-only production hardening", () => { const policy = resolveApiSessionCookiePolicy({ nodeEnv: "production", routing: productionRouting, maxAge: 60 * 15, }); expect(policy).toEqual({ name: "hivegrid_api_session", maxAge: 900, sameSite: "lax", secure: true, httpOnly: true, path: "/", }); expect(policy.name).not.toBe("hivegrid_session"); expect(policy).not.toHaveProperty("domain"); expect(JSON.stringify(policy)).not.toContain("secret"); }); test("keeps API session cookies domainless and insecure on localhost HTTP", () => { const policy = resolveApiSessionCookiePolicy({ nodeEnv: "development", routing: { appBaseDomain: "localhost:3000", protocol: "http", }, }); expect(policy).toEqual({ name: "hivegrid_api_session", sameSite: "lax", secure: false, httpOnly: true, path: "/", }); }); test("uses distinct secure and local names for arbitrary host-only auth cookies", () => { expect( resolveHostOnlyCookiePolicy({ nodeEnv: "test", routing: productionRouting, secureName: "__Host-hivegrid_auth_marker", localName: "hivegrid_auth_marker", maxAge: 60, }) ).toEqual({ name: "__Host-hivegrid_auth_marker", maxAge: 60, sameSite: "lax", secure: true, httpOnly: true, path: "/", }); expect( resolveHostOnlyCookiePolicy({ nodeEnv: "development", routing: { appBaseDomain: "localhost:3000", protocol: "http" }, secureName: "__Host-hivegrid_auth_marker", localName: "hivegrid_auth_marker", }) ).toMatchObject({ name: "hivegrid_auth_marker", secure: false, path: "/" }); }); test.each(["app", "admin"] as const)("uses a distinct host-prefixed production cookie for the %s surface", (surface) => { const policy = resolveWebSessionCookiePolicy({ nodeEnv: "production", routing: productionRouting, surface, maxAge: 900, }); expect(policy).toEqual({ name: `__Host-hivegrid_${surface}_session`, maxAge: 900, sameSite: surface === "admin" ? "strict" : "lax", secure: true, httpOnly: true, path: "/", }); expect(policy).not.toHaveProperty("domain"); }); test.each(["app", "admin"] as const)("uses a localhost-compatible host-only cookie for the %s surface", (surface) => { const policy = resolveWebSessionCookiePolicy({ nodeEnv: "development", routing: { appBaseDomain: "localhost:3000", protocol: "http" }, surface, }); expect(policy).toMatchObject({ name: `hivegrid_${surface}_session`, sameSite: surface === "admin" ? "strict" : "lax", secure: false, path: "/", }); expect(policy).not.toHaveProperty("domain"); }); });