123 lines
4.1 KiB
TypeScript
123 lines
4.1 KiB
TypeScript
import { createHmac, timingSafeEqual } from "node:crypto";
|
|
|
|
type EnvRecord = Record<string, string | undefined>;
|
|
|
|
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<string, unknown>;
|
|
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,
|
|
};
|
|
}
|
|
|