import { createHmac, randomBytes, timingSafeEqual } from "node:crypto"; import { loadRequiredWebConfig, resolveHostOnlyCookiePolicy, } from "@hivegrid/config"; import type { AdminCalendarProviderName } from "@hivegrid/integrations/admin-calendar-provider"; const SECURE_COOKIE = "__Host-hivegrid_admin_calendar_oauth"; const LOCAL_COOKIE = "hivegrid_admin_calendar_oauth"; const TTL_MS = 10 * 60 * 1_000; type StatePayload = { readonly state: string; readonly adminUserId: string; readonly provider: AdminCalendarProviderName; readonly createdAt: number; }; export function createAdminCalendarOAuthState(input: { readonly adminUserId: string; readonly provider: AdminCalendarProviderName; readonly now?: () => number; readonly secret?: string; }) { const payload: StatePayload = { state: randomBytes(32).toString("hex"), adminUserId: required(input.adminUserId), provider: input.provider, createdAt: input.now?.() ?? Date.now(), }; const encoded = Buffer.from(JSON.stringify(payload)).toString("base64url"); const policy = cookiePolicy(); return { state: payload.state, cookie: [ `${policy.name}=${encoded}.${sign(encoded, resolveSecret(input.secret))}`, `Path=${policy.path}`, "HttpOnly", "SameSite=Lax", `Max-Age=${TTL_MS / 1_000}`, ...(policy.secure ? ["Secure"] : []), ].join("; "), }; } export function consumeAdminCalendarOAuthState( request: Request, input: { readonly expectedState: string; readonly expectedProvider: AdminCalendarProviderName; readonly expectedAdminUserId: string; readonly now?: () => number; readonly secret?: string; } ): | { readonly ok: true; readonly clearCookie: string } | { readonly ok: false; readonly reason: | "missing" | "malformed" | "invalid_signature" | "expired" | "mismatch"; readonly clearCookie: string; } { const policy = cookiePolicy(); const clearCookie = [ `${policy.name}=`, `Path=${policy.path}`, "HttpOnly", "SameSite=Lax", "Max-Age=0", ...(policy.secure ? ["Secure"] : []), ].join("; "); const value = readCookie(request, policy.name); if (!value) return { ok: false, reason: "missing", clearCookie }; const [encoded, signature, ...rest] = value.split("."); if (!encoded || !signature || rest.length) { return { ok: false, reason: "malformed", clearCookie }; } const expected = sign(encoded, resolveSecret(input.secret)); const left = Buffer.from(signature); const right = Buffer.from(expected); if (left.length !== right.length || !timingSafeEqual(left, right)) { return { ok: false, reason: "invalid_signature", clearCookie }; } let payload: StatePayload; try { payload = JSON.parse(Buffer.from(encoded, "base64url").toString("utf8")); } catch { return { ok: false, reason: "malformed", clearCookie }; } const now = input.now?.() ?? Date.now(); if ( !Number.isFinite(payload.createdAt) || payload.createdAt > now + 60_000 || now - payload.createdAt > TTL_MS ) { return { ok: false, reason: "expired", clearCookie }; } if ( payload.state !== input.expectedState || payload.provider !== input.expectedProvider || payload.adminUserId !== input.expectedAdminUserId ) { return { ok: false, reason: "mismatch", clearCookie }; } return { ok: true, clearCookie }; } function cookiePolicy() { const config = loadRequiredWebConfig(); return resolveHostOnlyCookiePolicy({ nodeEnv: config.nodeEnv, routing: config.routing, secureName: SECURE_COOKIE, localName: LOCAL_COOKIE, maxAge: TTL_MS / 1_000, }); } function resolveSecret(override?: string) { const secret = override ?? loadRequiredWebConfig().sessionSecret; if (!secret || Buffer.byteLength(secret) < 32) { throw new Error("SESSION_SECRET is required for admin calendar OAuth state."); } return secret; } function sign(value: string, secret: string) { return createHmac("sha256", secret).update(value).digest("base64url"); } function readCookie(request: Request, name: string) { for (const segment of request.headers.get("cookie")?.split(/;\s*/) ?? []) { const separator = segment.indexOf("="); if (separator > 0 && segment.slice(0, separator) === name) { return segment.slice(separator + 1); } } return null; } function required(value: string) { const normalized = value.trim(); if (!normalized) throw new Error("adminUserId is required"); return normalized; }