Jakob Wennberg
d4f82cafc4
Recapt shuts down in four days, taking product analytics and session replay with it. This adds PostHog Cloud EU alongside it; the Recapt removal follows separately so events can be confirmed landing first. Wiring choices that are not the tutorial defaults: - Same-origin reverse proxy (/rl -> eu.i.posthog.com) instead of adding PostHog hosts to the CSP. connect-src 'self' and script-src 'self' already cover it, tracking blockers have no third-party host to match, and the Recapt allowlist entries in next.config.ts get replaced by nothing at all when they go. Needs skipTrailingSlashRedirect, since PostHog sends trailing-slash API requests; verified that trailing-slash URLs on normal routes still resolve 200 rather than 404. - /rl is excluded from the proxy.ts matcher. Middleware runs BEFORE next.config rewrites, so without this updateSession() treats an ingestion POST as an unknown protected path and 307s it to /login. Verified with a control: /zz/flags/ -> 307 /login, /rl/flags/ -> 200 from PostHog. This fails silently otherwise, because asset loads keep working through the rewrite while no events arrive. - persistence: 'memory' so nothing is written to the device and no cookie-consent banner is required. Everything post-login is unaffected: AnalyticsIdentify re-identifies on each dashboard load. - session_recording.maskTextSelector: '*'. PostHog masks inputs but not text by default, and this app renders org numbers (which for an enskild firma ARE the owner's personnummer), customer names and balances as ordinary text. Replays show where a user gets stuck, never what their books say. buildGroupProperties() also refuses to send org_number at all, with a test pinning it. - Error tracking registers through the existing lib/observability sink rather than bypassing it, so every error-level createLogger() line is captured already redacted. instrumentation.ts onRequestError covers what escapes uncaught. Analytics is hosted-only: isAnalyticsEnabled() short-circuits on NEXT_PUBLIC_SELF_HOSTED and no Docker sentinel is added, so self-hosted runs with zero third-party runtime code. Recapt got that outcome only by accident, via a missing sentinel; here it is explicit and tested. vitest.config.ts aliases 'server-only' to a stub: it is a build-time guard whose real entry point always throws, which broke 48 test files the moment a server-only module entered the graph. request-context.ts was already carrying the same latent trap. Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
49 lines
2.0 KiB
TypeScript
49 lines
2.0 KiB
TypeScript
/**
|
|
* PostHog analytics gate.
|
|
*
|
|
* Analytics is a HOSTED-ONLY feature. Self-hosted deployments never load
|
|
* PostHog: an AGPL operator running their own instance should not have their
|
|
* users' behaviour shipped to our project, and the token is not baked into
|
|
* the Docker image (no `__NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN__` sentinel in
|
|
* Dockerfile / docker-entrypoint.sh, deliberately). Recapt achieved the same
|
|
* result only by accident, via that missing sentinel; here it is explicit.
|
|
*
|
|
* Mirrors the shape of `isBankIdEnabled()` in lib/auth/bankid.ts: self-hosted
|
|
* short-circuits first, then the feature's own env var decides.
|
|
*/
|
|
|
|
export const POSTHOG_TOKEN_VAR = 'NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN'
|
|
|
|
export function isAnalyticsEnabled(): boolean {
|
|
if (process.env.NEXT_PUBLIC_SELF_HOSTED === 'true') return false
|
|
return Boolean(process.env.NEXT_PUBLIC_POSTHOG_PROJECT_TOKEN)
|
|
}
|
|
|
|
/**
|
|
* A missing token must never break the app, but it must not fail silently
|
|
* either: without it every capture is dropped and the integration looks
|
|
* healthy while zero events arrive (PostHog's own framework rule). So we warn
|
|
* loudly in development and stay a no-op in production.
|
|
*
|
|
* Returns true when the caller should proceed with initialisation.
|
|
*/
|
|
export function warnIfAnalyticsMisconfigured(): boolean {
|
|
if (isAnalyticsEnabled()) return true
|
|
|
|
// Self-hosted is a deliberate off, not a misconfiguration: stay quiet.
|
|
if (process.env.NEXT_PUBLIC_SELF_HOSTED === 'true') return false
|
|
|
|
if (process.env.NODE_ENV === 'development') {
|
|
// console, not createLogger(): this runs in the browser from
|
|
// instrumentation-client.ts before anything else is wired, and the point
|
|
// is for a developer to see it in the devtools console immediately.
|
|
// eslint-disable-next-line no-console
|
|
console.warn(
|
|
`${POSTHOG_TOKEN_VAR} variable required by PostHog is missing or un-configured, ` +
|
|
`this causes events to be silently missed. This error stops appearing once ` +
|
|
`${POSTHOG_TOKEN_VAR} is configured`
|
|
)
|
|
}
|
|
return false
|
|
}
|