// @vitest-environment node import { beforeEach, describe, expect, it, vi } from "vitest"; import type { ActionFunctionArgs, LoaderFunctionArgs } from "react-router"; const { MockAdminSsoConfigError } = vi.hoisted(() => ({ MockAdminSsoConfigError: class MockAdminSsoConfigError extends Error {}, })); vi.mock("~/modules/admin-sso", () => ({ AdminSsoConfigError: MockAdminSsoConfigError, getAdminSsoClient: vi.fn(), readAdminSsoEnv: vi.fn(), })); vi.mock("~/modules/admin-sso/logout.server", () => ({ clearIdTokenCookie: vi.fn(() => "__Host-hivegrid_admin_sso_id_token=; Path=/; HttpOnly; SameSite=Lax; Max-Age=0; Secure"), readIdTokenFromRequest: vi.fn(), })); vi.mock("~/modules/admin-sso/audit.server", () => ({ writeAdminSsoAuditEvent: vi.fn(), })); vi.mock("~/utils/session.server", () => ({ getUserInfo: vi.fn(), getUserSession: vi.fn(), storage: { destroySession: vi.fn() }, validateCSRFToken: vi.fn(), })); vi.mock("~/services/auth/sessionLifecycle.server", () => ({ endServerSession: vi.fn() })); import { getAdminSsoClient, readAdminSsoEnv } from "~/modules/admin-sso"; import { clearIdTokenCookie, readIdTokenFromRequest } from "~/modules/admin-sso/logout.server"; import { writeAdminSsoAuditEvent } from "~/modules/admin-sso/audit.server"; import { getUserInfo, getUserSession, storage, validateCSRFToken } from "~/utils/session.server"; import { endServerSession } from "~/services/auth/sessionLifecycle.server"; import { action, loader } from "./auth.admin.logout"; type SessionMock = { get: ReturnType; }; function sessionMock(): SessionMock { return { get: vi.fn((key: string) => (key === "sessionToken" ? "session-token-1" : undefined)) }; } function request(init?: RequestInit) { return new Request("https://admin.example.test/auth/admin/logout", init); } async function callAction(req = request({ method: "POST" })) { return action({ request: req, params: {}, context: {} } as ActionFunctionArgs); } async function callLoader(req = request()) { return loader({ request: req, params: {}, context: {} } as LoaderFunctionArgs); } describe("auth admin logout route", () => { let session: SessionMock; beforeEach(() => { vi.clearAllMocks(); session = sessionMock(); vi.mocked(getUserInfo).mockResolvedValue({ userId: "admin-user-1" } as Awaited>); vi.mocked(getUserSession).mockResolvedValue(session as Awaited>); vi.mocked(storage.destroySession).mockResolvedValue("app_session=; Path=/; HttpOnly; Max-Age=0" as never); vi.mocked(endServerSession).mockResolvedValue(undefined as never); vi.mocked(readIdTokenFromRequest).mockReturnValue(null); vi.mocked(readAdminSsoEnv).mockReturnValue({ postLogoutRedirectUri: "https://admin.example.test/login?logged_out=1" } as ReturnType< typeof readAdminSsoEnv >); vi.mocked(getAdminSsoClient).mockResolvedValue({ endSessionUrl: vi.fn(() => "https://idp.example.test/end-session?id_token_hint=id-token-value"), } as Awaited>); }); it("clears the local app session and admin id-token cookie without an IdP token", async () => { const response = await callAction(); expect(response.status).toBe(302); expect(validateCSRFToken).toHaveBeenCalledWith(expect.any(Request)); expect(response.headers.get("Location")).toBe("/login?logged_out=1"); expect(readAdminSsoEnv).not.toHaveBeenCalled(); expect(getAdminSsoClient).not.toHaveBeenCalled(); expect(endServerSession).toHaveBeenCalledWith("session-token-1"); expect(storage.destroySession).toHaveBeenCalledWith(session); expect(clearIdTokenCookie).toHaveBeenCalledOnce(); const setCookie = response.headers.get("Set-Cookie") ?? ""; expect(setCookie).toContain("app_session="); expect(setCookie).toContain("__Host-hivegrid_admin_sso_id_token="); expect(setCookie).toContain("Max-Age=0"); expect(writeAdminSsoAuditEvent).toHaveBeenCalledWith( expect.objectContaining({ action: "admin.logout.sso", actorAdminUserId: "admin-user-1", meta: { hadIdToken: false }, }) ); }); it("uses RP-initiated logout when a readable id token is present", async () => { vi.mocked(readIdTokenFromRequest).mockReturnValue("id-token-value"); const response = await callAction(); expect(response.status).toBe(302); expect(response.headers.get("Location")).toBe("https://idp.example.test/end-session?id_token_hint=id-token-value"); const client = await vi.mocked(getAdminSsoClient).mock.results[0]?.value; expect(client.endSessionUrl).toHaveBeenCalledWith({ id_token_hint: "id-token-value", post_logout_redirect_uri: "https://admin.example.test/login?logged_out=1", }); expect(storage.destroySession).toHaveBeenCalledWith(session); expect(response.headers.get("Set-Cookie")).toContain("__Host-hivegrid_admin_sso_id_token="); expect(writeAdminSsoAuditEvent).toHaveBeenCalledWith(expect.objectContaining({ meta: { hadIdToken: true } })); }); it("falls back to local logout if IdP configuration is unavailable", async () => { vi.mocked(readIdTokenFromRequest).mockReturnValue("id-token-value"); vi.mocked(readAdminSsoEnv).mockImplementation(() => { throw new MockAdminSsoConfigError("missing env"); }); const response = await callAction(); expect(response.status).toBe(302); expect(response.headers.get("Location")).toBe("/login?logged_out=1"); expect(getAdminSsoClient).not.toHaveBeenCalled(); expect(storage.destroySession).toHaveBeenCalledWith(session); expect(response.headers.get("Set-Cookie")).toContain("Max-Age=0"); }); it("rejects GET logout without changing session state", async () => { const response = await callLoader(); expect(response.status).toBe(405); expect(response.headers.get("Allow")).toBe("POST"); expect(response.headers.get("Cache-Control")).toBe("no-store"); expect(getUserInfo).not.toHaveBeenCalled(); expect(getUserSession).not.toHaveBeenCalled(); expect(storage.destroySession).not.toHaveBeenCalled(); expect(clearIdTokenCookie).not.toHaveBeenCalled(); }); it("rejects a forged POST before reading or clearing authentication state", async () => { vi.mocked(validateCSRFToken).mockRejectedValueOnce(new Error("CSRF tokens do not match")); await expect(callAction()).rejects.toThrow("CSRF tokens do not match"); expect(getUserInfo).not.toHaveBeenCalled(); expect(getUserSession).not.toHaveBeenCalled(); expect(storage.destroySession).not.toHaveBeenCalled(); }); });