import { createHmac, timingSafeEqual } from "node:crypto"; type EnvRecord = Record; export type MarketingTokenPurpose = "unsub" | "optin"; export interface MarketingTokenPayload { readonly purpose: MarketingTokenPurpose; readonly tenantId: string; readonly kontaktId: string; readonly campaignId: string | null; readonly iat: number; } export interface SignMarketingTokenInput { readonly purpose: MarketingTokenPurpose; readonly tenantId: string; readonly kontaktId: string; readonly campaignId?: string | null; readonly now?: () => Date; readonly secret?: string; readonly env?: EnvRecord; } export interface VerifyMarketingTokenOptions { readonly secret?: string; readonly env?: EnvRecord; readonly expectedPurpose?: MarketingTokenPurpose; } export class MarketingTokenSecretMissingError extends Error { override readonly name = "MarketingTokenSecretMissingError"; constructor() { super("MARKETING_TOKEN_SECRET env var is not set; cannot sign or verify marketing tokens."); } } const TOKEN_VERSION = "m1"; const MIN_SECRET_BYTES = 32; function getSecret(override?: string, env?: EnvRecord): Buffer { const raw = override ?? env?.MARKETING_TOKEN_SECRET ?? env?.LEAD_CONVERSION_SECRET; if (!raw || raw.length < MIN_SECRET_BYTES) throw new MarketingTokenSecretMissingError(); return Buffer.from(raw, "utf8"); } function b64uEncode(input: Buffer | string): string { const buf = Buffer.isBuffer(input) ? input : Buffer.from(input, "utf8"); return buf.toString("base64url"); } function b64uDecode(input: string): Buffer | null { if (!/^[A-Za-z0-9_-]+$/u.test(input)) return null; try { return Buffer.from(input, "base64url"); } catch { return null; } } function nowSec(now?: () => Date): number { return Math.floor((now ? now() : new Date()).getTime() / 1000); } export function signMarketingToken(input: SignMarketingTokenInput): string { if (!input.tenantId || !input.kontaktId) { throw new TypeError("signMarketingToken: tenantId and kontaktId required"); } const secret = getSecret(input.secret, input.env); const payload: MarketingTokenPayload = { purpose: input.purpose, tenantId: input.tenantId, kontaktId: input.kontaktId, campaignId: input.campaignId ?? null, iat: nowSec(input.now), }; const payloadB64 = b64uEncode(JSON.stringify(payload)); const sig = createHmac("sha256", secret).update(`${TOKEN_VERSION}.${payloadB64}`).digest(); return `${TOKEN_VERSION}.${payloadB64}.${b64uEncode(sig)}`; } export function verifyMarketingToken(token: string | null | undefined, options: VerifyMarketingTokenOptions = {}): MarketingTokenPayload | null { if (!token || typeof token !== "string") return null; const parts = token.split("."); if (parts.length !== 3) return null; const [version, payloadB64, sigB64] = parts; if (version !== TOKEN_VERSION) return null; let secret: Buffer; try { secret = getSecret(options.secret, options.env); } catch { return null; } const expected = createHmac("sha256", secret).update(`${version}.${payloadB64}`).digest(); const actual = b64uDecode(sigB64); if (!actual || actual.length !== expected.length) return null; if (!timingSafeEqual(actual, expected)) return null; const payloadBuf = b64uDecode(payloadB64); if (!payloadBuf) return null; let parsed: unknown; try { parsed = JSON.parse(payloadBuf.toString("utf8")); } catch { return null; } if (!parsed || typeof parsed !== "object") return null; const rec = parsed as Record; const purpose = rec.purpose; if (purpose !== "unsub" && purpose !== "optin") return null; if (options.expectedPurpose && purpose !== options.expectedPurpose) return null; if (typeof rec.tenantId !== "string" || rec.tenantId.length === 0) return null; if (typeof rec.kontaktId !== "string" || rec.kontaktId.length === 0) return null; return { purpose, tenantId: rec.tenantId, kontaktId: rec.kontaktId, campaignId: typeof rec.campaignId === "string" ? rec.campaignId : null, iat: typeof rec.iat === "number" ? rec.iat : 0, }; }