import type { CaptchaConfig, CaptchaProvider, CaptchaSurface } from "./types.js"; type EnvLike = Record; function present(value: string | undefined): string | undefined { const trimmed = value?.trim(); return trimmed ? trimmed : undefined; } /** * Resolves the captcha config from env. mCaptcha remains the default provider * for compatibility; set CAPTCHA_PROVIDER=cap to use Cap. * * CAPTCHA_PROVIDER=mcaptcha|cap * MCAPTCHA_INSTANCE_URL=https://captcha.tool-ctrl.de * MCAPTCHA_ACCOUNT_SECRET= * MCAPTCHA_SITEKEY_LOGIN / _FORMS / _BOOKING= * * CAP_INSTANCE_URL=https://captcha.hivegrid.de * CAP_SITE_SECRET= * CAP_SITE_SECRET_LOGIN / _FORMS / _BOOKING= * CAP_SITEKEY_LOGIN / _FORMS / _BOOKING= * * CAPTCHA_FAIL_OPEN=true|false (development/test only; default false) */ export function resolveCaptchaConfig(env: EnvLike): CaptchaConfig { const provider = resolveProvider(env); if (provider === "cap") { const sharedSecret = present(env.CAP_SITE_SECRET); return { provider, instanceUrl: present(env.CAP_INSTANCE_URL), accountSecret: sharedSecret, sitekeys: { login: present(env.CAP_SITEKEY_LOGIN), forms: present(env.CAP_SITEKEY_FORMS), booking: present(env.CAP_SITEKEY_BOOKING), }, secrets: { login: present(env.CAP_SITE_SECRET_LOGIN) ?? sharedSecret, forms: present(env.CAP_SITE_SECRET_FORMS) ?? sharedSecret, booking: present(env.CAP_SITE_SECRET_BOOKING) ?? sharedSecret, }, failOpen: resolveFailOpen(env), }; } const accountSecret = present(env.MCAPTCHA_ACCOUNT_SECRET); return { provider, instanceUrl: present(env.MCAPTCHA_INSTANCE_URL), accountSecret, sitekeys: { login: present(env.MCAPTCHA_SITEKEY_LOGIN), forms: present(env.MCAPTCHA_SITEKEY_FORMS), booking: present(env.MCAPTCHA_SITEKEY_BOOKING), }, secrets: { login: accountSecret, forms: accountSecret, booking: accountSecret, }, failOpen: resolveFailOpen(env), }; } function resolveFailOpen(env: EnvLike): boolean { const runtime = present(env.NODE_ENV)?.toLowerCase(); return (runtime === "development" || runtime === "test") && present(env.CAPTCHA_FAIL_OPEN)?.toLowerCase() === "true"; } function resolveProvider(env: EnvLike): CaptchaProvider { const explicit = present(env.CAPTCHA_PROVIDER)?.toLowerCase(); if (explicit === "cap") return "cap"; return "mcaptcha"; } export function getSitekey( config: CaptchaConfig, surface: CaptchaSurface, ): string | undefined { return config.sitekeys[surface]; } export function getSecret( config: CaptchaConfig, surface: CaptchaSurface, ): string | undefined { return config.secrets[surface] ?? config.accountSecret; } /** True when the instance + at least one secret are present (sitekeys checked per-surface). */ export function isCaptchaConfigured(config: CaptchaConfig): boolean { return Boolean(config.instanceUrl && (config.accountSecret || Object.values(config.secrets).some(Boolean))); }