Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/packages/captcha/src/config.ts
T

96 lines
3.1 KiB
TypeScript

import type { CaptchaConfig, CaptchaProvider, CaptchaSurface } from "./types.js";
type EnvLike = Record<string, string | undefined>;
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=<dashboard account secret>
* MCAPTCHA_SITEKEY_LOGIN / _FORMS / _BOOKING=<public sitekeys>
*
* CAP_INSTANCE_URL=https://captcha.hivegrid.de
* CAP_SITE_SECRET=<fallback site secret>
* CAP_SITE_SECRET_LOGIN / _FORMS / _BOOKING=<per-surface site secrets>
* CAP_SITEKEY_LOGIN / _FORMS / _BOOKING=<public sitekeys>
*
* 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)));
}