@seifer-webapp-factory/kits 0.1.0

package/dist/frontend/observability/adapters/sinks.js

@@ -0,0 +1,40 @@
+/** Schrijft gestructureerde records naar de console (default voor de browser). */
+export function consoleLogSink(sink = console) {
+    return {
+        write(record) {
+            const line = `[${record.service}] ${record.level.toUpperCase()}: ${record.message}`;
+            sink[record.level](line, record.context);
+        },
+    };
+}
+/** Verzamelt log-records in het geheugen. */
+export function collectingLogSink() {
+    const records = [];
+    return {
+        records,
+        write(record) {
+            records.push(record);
+        },
+    };
+}
+/** Verzamelt foutrapporten in het geheugen. */
+export function collectingErrorSink() {
+    const reports = [];
+    return {
+        reports,
+        capture(report) {
+            reports.push(report);
+        },
+    };
+}
+/** Verzamelt metric-records in het geheugen. */
+export function collectingMetricSink() {
+    const metrics = [];
+    return {
+        metrics,
+        record(metric) {
+            metrics.push(metric);
+        },
+    };
+}
+//# sourceMappingURL=sinks.js.map

package/dist/frontend/observability/adapters/sinks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sinks.js","sourceRoot":"","sources":["../../../../frontend/src/observability/adapters/sinks.ts"],"names":[],"mappings":"AAiBA,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,OAAoB,OAAO;IACxD,OAAO;QACL,KAAK,CAAC,MAAM;YACV,MAAM,IAAI,GAAG,IAAI,MAAM,CAAC,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,OAAO,EAAE,CAAC;YACpF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAgB,EAAE,CAAC;IAChC,OAAO;QACL,OAAO;QACP,KAAK,CAAC,MAAM;YACV,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,mBAAmB;IACjC,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,OAAO;QACL,OAAO;QACP,OAAO,CAAC,MAAM;YACZ,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,OAAO;QACL,OAAO;QACP,MAAM,CAAC,MAAM;YACX,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/frontend/observability/core/error-reporter.d.ts

@@ -0,0 +1,32 @@
+import type { Clock, ErrorSink } from './ports.js';
+import type { Redactor } from './redaction.js';
+/**
+ * Error-reporting-port + global handlers. De handlers worden op een geïnjecteerde,
+ * window-achtige event-target geregistreerd (addEventListener 'error'/'unhandledrejection'),
+ * NIET hard gebonden aan de globale `window`. Zo is de kit testbaar met een fake target en
+ * SSR-veilig. Registratie is idempotent en opruimbaar (unregister); geen module-globale state.
+ */
+/** Minimale, injecteerbare window-achtige event-target. */
+export interface EventTargetLike {
+    addEventListener(type: string, listener: (event: unknown) => void): void;
+    removeEventListener(type: string, listener: (event: unknown) => void): void;
+}
+export interface ErrorReporterOptions {
+    readonly service: string;
+    readonly sink: ErrorSink;
+    /** Optionele PII-redactor die op de fout-context wordt toegepast. */
+    readonly redactor?: Redactor;
+    /** Injecteerbare klok voor deterministische timestamps. Default: systeemklok. */
+    readonly clock?: Clock;
+}
+export interface ErrorReporter {
+    /** Rapporteer handmatig een fout met optionele context. */
+    report(error: unknown, context?: Readonly<Record<string, unknown>>): void;
+    /**
+     * Registreer global handlers op de gegeven target. Idempotent: een tweede aanroep voegt
+     * geen extra listeners toe. Geeft een unregister-functie terug die alle listeners opruimt.
+     */
+    installGlobalHandlers(target: EventTargetLike): () => void;
+}
+export declare function createErrorReporter(options: ErrorReporterOptions): ErrorReporter;
+//# sourceMappingURL=error-reporter.d.ts.map

package/dist/frontend/observability/core/error-reporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporter.d.ts","sourceRoot":"","sources":["../../../../frontend/src/observability/core/error-reporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAgC,SAAS,EAAE,MAAM,YAAY,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;GAKG;AAEH,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACzE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CAC7E;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E;;;OAGG;IACH,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,IAAI,CAAC;CAC5D;AAkBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAuDhF"}

package/dist/frontend/observability/core/error-reporter.js

@@ -0,0 +1,64 @@
+/** Haalt message + stack uit een ruw error-/rejection-event of losse fout. */
+function normalize(input) {
+    const e = input;
+    const cause = e?.error ?? e?.reason ?? input;
+    if (cause instanceof Error) {
+        return { message: cause.message, stack: cause.stack };
+    }
+    if (typeof e?.message === 'string') {
+        return { message: e.message };
+    }
+    if (cause !== undefined && cause !== null) {
+        return { message: String(cause) };
+    }
+    return { message: 'Onbekende fout' };
+}
+export function createErrorReporter(options) {
+    const { service, sink, redactor } = options;
+    const clock = options.clock ?? { now: () => new Date() };
+    // Per-instance registratie-state (geen module-globale mutable state).
+    let installed = false;
+    let cleanup = () => { };
+    const dispatch = (type, input, context = {}) => {
+        const { message, stack } = normalize(input);
+        const redacted = redactor ? redactor.redact(context) : { ...context };
+        const report = {
+            type,
+            message,
+            ...(stack !== undefined ? { stack } : {}),
+            service,
+            timestamp: clock.now().toISOString(),
+            context: redacted,
+        };
+        // Een falende sink mag geen nieuwe global error triggeren (geen recursie) of de app crashen.
+        try {
+            sink.capture(report);
+        }
+        catch {
+            // bewust stil.
+        }
+    };
+    return {
+        report(error, context) {
+            dispatch('error', error, context);
+        },
+        installGlobalHandlers(target) {
+            // Idempotent: tweede aanroep laat de bestaande handler-set staan.
+            if (installed)
+                return cleanup;
+            const onError = (event) => dispatch('error', event);
+            const onRejection = (event) => dispatch('unhandledrejection', event);
+            target.addEventListener('error', onError);
+            target.addEventListener('unhandledrejection', onRejection);
+            installed = true;
+            cleanup = () => {
+                target.removeEventListener('error', onError);
+                target.removeEventListener('unhandledrejection', onRejection);
+                installed = false;
+                cleanup = () => { };
+            };
+            return cleanup;
+        },
+    };
+}
+//# sourceMappingURL=error-reporter.js.map

package/dist/frontend/observability/core/error-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-reporter.js","sourceRoot":"","sources":["../../../../frontend/src/observability/core/error-reporter.ts"],"names":[],"mappings":"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"}

package/dist/frontend/observability/core/logger.d.ts

@@ -0,0 +1,29 @@
+import type { Clock, LogLevel, LogSink } from './ports.js';
+import type { Redactor } from './redaction.js';
+/**
+ * Gestructureerde client-logger. Levels + context-labels, PII-redactie vóór de sink, dispatch
+ * naar één of meer geïnjecteerde LogSinks. Geen module-globale state: alle afhankelijkheden
+ * (sinks, service-naam, redactor, klok) worden per instance geïnjecteerd → SSR/hydratie-veilig.
+ */
+export interface LoggerOptions {
+    /** Service-naam die op elk record meegaat. */
+    readonly service: string;
+    /** Eén of meer sinks die elk record ontvangen. */
+    readonly sinks: readonly LogSink[];
+    /** Minimumniveau; records daaronder worden overgeslagen. Default: 'info'. */
+    readonly minLevel?: LogLevel;
+    /** Optionele PII-redactor die op de context wordt toegepast. */
+    readonly redactor?: Redactor;
+    /** Injecteerbare klok voor deterministische timestamps. Default: systeemklok. */
+    readonly clock?: Clock;
+}
+export interface Logger {
+    debug(message: string, context?: Readonly<Record<string, unknown>>): void;
+    info(message: string, context?: Readonly<Record<string, unknown>>): void;
+    warn(message: string, context?: Readonly<Record<string, unknown>>): void;
+    error(message: string, context?: Readonly<Record<string, unknown>>): void;
+    log(level: LogLevel, message: string, context?: Readonly<Record<string, unknown>>): void;
+}
+/** Bouwt een logger uit de geïnjecteerde opties. */
+export declare function createLogger(options: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/frontend/observability/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../frontend/src/observability/core/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAa,OAAO,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACzE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IACzE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;CAC1F;AAID,oDAAoD;AACpD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAyC3D"}

package/dist/frontend/observability/core/logger.js

@@ -0,0 +1,39 @@
+const LEVEL_ORDER = { debug: 10, info: 20, warn: 30, error: 40 };
+/** Bouwt een logger uit de geïnjecteerde opties. */
+export function createLogger(options) {
+    const { service, sinks, redactor } = options;
+    const minLevel = options.minLevel ?? 'info';
+    const clock = options.clock ?? { now: () => new Date() };
+    const threshold = LEVEL_ORDER[minLevel];
+    const log = (level, message, context = {}) => {
+        // Records onder het minimumniveau worden achterwege gelaten.
+        if (LEVEL_ORDER[level] < threshold)
+            return;
+        const redacted = redactor ? redactor.redact(context) : { ...context };
+        const record = {
+            level,
+            message,
+            timestamp: clock.now().toISOString(),
+            service,
+            context: redacted,
+        };
+        for (const sink of sinks) {
+            // Een falende sink mag de aanroepende code niet laten crashen; hooguit gaat dit
+            // ene record naar déze sink verloren.
+            try {
+                sink.write(record);
+            }
+            catch {
+                // bewust stil: geen recursie, geen crash.
+            }
+        }
+    };
+    return {
+        log,
+        debug: (message, context) => log('debug', message, context),
+        info: (message, context) => log('info', message, context),
+        warn: (message, context) => log('warn', message, context),
+        error: (message, context) => log('error', message, context),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/frontend/observability/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../frontend/src/observability/core/logger.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,GAA6B,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAE3F,oDAAoD;AACpD,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC7C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC;IAC5C,MAAM,KAAK,GAAU,OAAO,CAAC,KAAK,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAExC,MAAM,GAAG,GAAG,CACV,KAAe,EACf,OAAe,EACf,UAA6C,EAAE,EACzC,EAAE;QACR,6DAA6D;QAC7D,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS;YAAE,OAAO;QAE3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC;QACtE,MAAM,MAAM,GAAc;YACxB,KAAK;YACL,OAAO;YACP,SAAS,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YACpC,OAAO;YACP,OAAO,EAAE,QAAQ;SAClB,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,gFAAgF;YAChF,sCAAsC;YACtC,IAAI,CAAC;gBACH,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,0CAA0C;YAC5C,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,GAAG;QACH,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;QAC3D,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACzD,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;QACzD,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/frontend/observability/core/ports.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Ports voor de observability-kit. De core kent alleen deze abstracties; het project levert
+ * de adapters (log-sink, error-sink, metric-sink, trace-provider). Geen domeinkennis, geen
+ * framework, geen concreet transport. Clock/IdGen zijn injecteerbaar voor deterministische tests.
+ */
+/** Log-niveaus in oplopende ernst. */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Gestructureerd log-record dat een sink ontvangt (nooit vrije console-strings). */
+export interface LogRecord {
+    readonly level: LogLevel;
+    readonly message: string;
+    /** ISO-8601 timestamp, deterministisch via de geïnjecteerde Clock. */
+    readonly timestamp: string;
+    readonly service: string;
+    readonly context: Readonly<Record<string, unknown>>;
+}
+/** LogSink-port: schrijft één gestructureerd, reeds geredigeerd record weg naar een transport. */
+export interface LogSink {
+    write(record: LogRecord): void;
+}
+/** Type van een opgevangen fout, afgeleid uit het browser-event. */
+export type ErrorReportType = 'error' | 'unhandledrejection';
+/** Genormaliseerd foutrapport dat een ErrorSink ontvangt. */
+export interface ErrorReport {
+    readonly type: ErrorReportType;
+    readonly message: string;
+    readonly stack?: string;
+    readonly service: string;
+    readonly timestamp: string;
+    readonly context: Readonly<Record<string, unknown>>;
+}
+/** ErrorSink-port: ontvangt genormaliseerde foutrapporten (bv. Sentry, HTTP-collector). */
+export interface ErrorSink {
+    capture(report: ErrorReport): void;
+}
+/** Metric-record voor RUM/web-vitals. Bevat labels maar nooit PII. */
+export interface MetricRecord {
+    readonly name: string;
+    readonly value: number;
+    readonly unit: string;
+    readonly service: string;
+    readonly labels: Readonly<Record<string, string>>;
+}
+/** MetricSink-port: ontvangt metric-records (bv. Prometheus-pushgateway, HTTP-collector). */
+export interface MetricSink {
+    record(metric: MetricRecord): void;
+}
+/** Actieve W3C trace-context. traceId = 32 hex, spanId = 16 hex, flags = 2 hex. */
+export interface TraceContext {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly flags: string;
+}
+/**
+ * TraceContextProvider-port: levert de reeds actieve trace-context (bv. een bestaande
+ * OTel-web-SDK). `current()` geeft `undefined` als er nog geen context is.
+ */
+export interface TraceContextProvider {
+    current(): TraceContext | undefined;
+}
+/** Klok-port voor deterministische timestamps in tests. */
+export interface Clock {
+    now(): Date;
+}
+/** Id-generator-port voor deterministische trace-/span-ids in tests. */
+export interface IdGen {
+    /** 32 hex-tekens (16 bytes). */
+    traceId(): string;
+    /** 16 hex-tekens (8 bytes). */
+    spanId(): string;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/frontend/observability/core/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../../frontend/src/observability/core/ports.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,qFAAqF;AACrF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,kGAAkG;AAClG,MAAM,WAAW,OAAO;IACtB,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;CAChC;AAED,oEAAoE;AACpE,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,oBAAoB,CAAC;AAE7D,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACrD;AAED,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACpC;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,6FAA6F;AAC7F,MAAM,WAAW,UAAU;IACzB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;CACpC;AAED,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,IAAI,YAAY,GAAG,SAAS,CAAC;CACrC;AAED,2DAA2D;AAC3D,MAAM,WAAW,KAAK;IACpB,GAAG,IAAI,IAAI,CAAC;CACb;AAED,wEAAwE;AACxE,MAAM,WAAW,KAAK;IACpB,gCAAgC;IAChC,OAAO,IAAI,MAAM,CAAC;IAClB,+BAA+B;IAC/B,MAAM,IAAI,MAAM,CAAC;CAClB"}

package/dist/frontend/observability/core/ports.js

@@ -0,0 +1,7 @@
+/**
+ * Ports voor de observability-kit. De core kent alleen deze abstracties; het project levert
+ * de adapters (log-sink, error-sink, metric-sink, trace-provider). Geen domeinkennis, geen
+ * framework, geen concreet transport. Clock/IdGen zijn injecteerbaar voor deterministische tests.
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/frontend/observability/core/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../../../frontend/src/observability/core/ports.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/frontend/observability/core/redaction.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PII-redactie: vervangt gevoelige waarden vóór ze een sink bereiken. De policy is
+ * injecteerbaar (velden-denylist + patroon-matchers); de core kent geen concrete velden.
+ * Redactie is diep (recursief over geneste objecten en arrays) en muteert de invoer niet.
+ */
+export interface RedactionPolicy {
+    /** Veldnamen (case-insensitive) waarvan de waarde altijd geredigeerd wordt. */
+    readonly fields?: readonly string[];
+    /** Patronen die op string-waarden gematcht worden en de hele waarde redigeren. */
+    readonly patterns?: readonly RegExp[];
+    /** Vervangwaarde. Default: '[REDACTED]'. */
+    readonly placeholder?: string;
+}
+export interface Redactor {
+    /** Geeft een diepe kopie terug waarin gevoelige waarden vervangen zijn. */
+    redact(context: Readonly<Record<string, unknown>>): Record<string, unknown>;
+}
+/** Bouwt een Redactor uit een policy. Zonder policy laat hij alles ongewijzigd door. */
+export declare function createRedactor(policy?: RedactionPolicy): Redactor;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/frontend/observability/core/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../../../frontend/src/observability/core/redaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7E;AAID,wFAAwF;AACxF,wBAAgB,cAAc,CAAC,MAAM,GAAE,eAAoB,GAAG,QAAQ,CAiCrE"}

package/dist/frontend/observability/core/redaction.js

@@ -0,0 +1,38 @@
+/**
+ * PII-redactie: vervangt gevoelige waarden vóór ze een sink bereiken. De policy is
+ * injecteerbaar (velden-denylist + patroon-matchers); de core kent geen concrete velden.
+ * Redactie is diep (recursief over geneste objecten en arrays) en muteert de invoer niet.
+ */
+const DEFAULT_PLACEHOLDER = '[REDACTED]';
+/** Bouwt een Redactor uit een policy. Zonder policy laat hij alles ongewijzigd door. */
+export function createRedactor(policy = {}) {
+    const fields = new Set((policy.fields ?? []).map((f) => f.toLowerCase()));
+    const patterns = policy.patterns ?? [];
+    const placeholder = policy.placeholder ?? DEFAULT_PLACEHOLDER;
+    const matchesPattern = (value) => patterns.some((p) => p.test(value));
+    const redactValue = (value) => {
+        if (typeof value === 'string') {
+            return matchesPattern(value) ? placeholder : value;
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => redactValue(item));
+        }
+        if (value !== null && typeof value === 'object') {
+            return redactRecord(value);
+        }
+        return value;
+    };
+    const redactRecord = (input) => {
+        const out = {};
+        for (const [key, value] of Object.entries(input)) {
+            out[key] = fields.has(key.toLowerCase()) ? placeholder : redactValue(value);
+        }
+        return out;
+    };
+    return {
+        redact(context) {
+            return redactRecord(context);
+        },
+    };
+}
+//# sourceMappingURL=redaction.js.map

package/dist/frontend/observability/core/redaction.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../../../frontend/src/observability/core/redaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAgBH,MAAM,mBAAmB,GAAG,YAAY,CAAC;AAEzC,wFAAwF;AACxF,MAAM,UAAU,cAAc,CAAC,SAA0B,EAAE;IACzD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IACvC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,mBAAmB,CAAC;IAE9D,MAAM,cAAc,GAAG,CAAC,KAAa,EAAW,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvF,MAAM,WAAW,GAAG,CAAC,KAAc,EAAW,EAAE;QAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC;QACrD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,YAAY,CAAC,KAAgC,CAAC,CAAC;QACxD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,CAAC,KAA8B,EAA2B,EAAE;QAC/E,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAC9E,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,OAAO;QACL,MAAM,CAAC,OAAO;YACZ,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/frontend/observability/core/rum.d.ts

@@ -0,0 +1,35 @@
+import type { MetricSink } from './ports.js';
+/**
+ * Web-vitals/RUM-collector. Hard-dependt NIET op het `web-vitals` npm-package: metrics worden
+ * geïnjecteerd via `reportMetric(name, value)`. De collector labelt ze (service-naam + labels,
+ * nooit PII), stuurt ze naar de geïnjecteerde MetricSink en houdt een per-instance aggregatie
+ * bij (count/min/max/sum/avg/last). Geen module-globale state → SSR/hydratie-veilig.
+ */
+/** Kern web-vitals (informatief; elke naam is toegestaan). */
+export type WebVitalName = 'LCP' | 'CLS' | 'INP' | 'TTFB' | 'FCP';
+/** Geaggregeerde statistiek per metric-naam. */
+export interface MetricAggregate {
+    readonly name: string;
+    readonly count: number;
+    readonly last: number;
+    readonly min: number;
+    readonly max: number;
+    readonly sum: number;
+    readonly avg: number;
+}
+export interface RumCollectorOptions {
+    readonly service: string;
+    readonly sink: MetricSink;
+    /** Statische labels (bv. route, sessie-context). Geen PII. */
+    readonly labels?: Readonly<Record<string, string>>;
+    /** Default-eenheid als `reportMetric` er geen meegeeft. Default: 'ms'. */
+    readonly defaultUnit?: string;
+}
+export interface RumCollector {
+    /** Rapporteer één metric-waarde (van een injecteerde bron, bv. web-vitals of PerformanceObserver). */
+    reportMetric(name: string, value: number, unit?: string): void;
+    /** Momentopname van de geaggregeerde metrics tot nu toe. */
+    snapshot(): readonly MetricAggregate[];
+}
+export declare function createRumCollector(options: RumCollectorOptions): RumCollector;
+//# sourceMappingURL=rum.d.ts.map

package/dist/frontend/observability/core/rum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rum.d.ts","sourceRoot":"","sources":["../../../../frontend/src/observability/core/rum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAgB,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;GAKG;AAEH,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAElE,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,0EAA0E;IAC1E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,sGAAsG;IACtG,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,4DAA4D;IAC5D,QAAQ,IAAI,SAAS,eAAe,EAAE,CAAC;CACxC;AAUD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CA0C7E"}

package/dist/frontend/observability/core/rum.js

@@ -0,0 +1,42 @@
+export function createRumCollector(options) {
+    const { service, sink } = options;
+    const labels = options.labels ?? {};
+    const defaultUnit = options.defaultUnit ?? 'ms';
+    // Per-instance aggregatie-state.
+    const aggregates = new Map();
+    return {
+        reportMetric(name, value, unit) {
+            const record = {
+                name,
+                value,
+                unit: unit ?? defaultUnit,
+                service,
+                labels,
+            };
+            sink.record(record);
+            const existing = aggregates.get(name);
+            if (existing === undefined) {
+                aggregates.set(name, { count: 1, last: value, min: value, max: value, sum: value });
+            }
+            else {
+                existing.count += 1;
+                existing.last = value;
+                existing.min = Math.min(existing.min, value);
+                existing.max = Math.max(existing.max, value);
+                existing.sum += value;
+            }
+        },
+        snapshot() {
+            return [...aggregates.entries()].map(([name, a]) => ({
+                name,
+                count: a.count,
+                last: a.last,
+                min: a.min,
+                max: a.max,
+                sum: a.sum,
+                avg: a.sum / a.count,
+            }));
+        },
+    };
+}
+//# sourceMappingURL=rum.js.map

package/dist/frontend/observability/core/rum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rum.js","sourceRoot":"","sources":["../../../../frontend/src/observability/core/rum.ts"],"names":[],"mappings":"AA+CA,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IAEhD,iCAAiC;IACjC,MAAM,UAAU,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEvD,OAAO;QACL,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI;YAC5B,MAAM,MAAM,GAAiB;gBAC3B,IAAI;gBACJ,KAAK;gBACL,IAAI,EAAE,IAAI,IAAI,WAAW;gBACzB,OAAO;gBACP,MAAM;aACP,CAAC;YACF,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAEpB,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YACtF,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,KAAK,IAAI,CAAC,CAAC;gBACpB,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC;gBACtB,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC7C,QAAQ,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC7C,QAAQ,CAAC,GAAG,IAAI,KAAK,CAAC;YACxB,CAAC;QACH,CAAC;QACD,QAAQ;YACN,OAAO,CAAC,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACnD,IAAI;gBACJ,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,EAAE,CAAC,CAAC,GAAG;gBACV,GAAG,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/frontend/observability/core/trace.d.ts

@@ -0,0 +1,32 @@
+import type { IdGen, TraceContext, TraceContextProvider } from './ports.js';
+/** Formatteert een trace-context als W3C traceparent-headerwaarde. */
+export declare function formatTraceparent(ctx: TraceContext): string;
+/** Parset een traceparent-headerwaarde; geeft `undefined` bij een ongeldig formaat. */
+export declare function parseTraceparent(value: string): TraceContext | undefined;
+/** Valideert of een trace-context wél-gevormde ids en flags heeft. */
+export declare function isValidTraceContext(ctx: TraceContext): boolean;
+/** Genereert een nieuwe trace-context (nieuwe trace-id + span-id) via de IdGen. */
+export declare function generateTraceContext(idGen: IdGen, flags?: string): TraceContext;
+/** Zet een bestaande trace voort: zelfde trace-id + flags, nieuwe (child-)span-id. */
+export declare function continueTraceContext(parent: TraceContext, idGen: IdGen): TraceContext;
+export interface TracePropagatorOptions {
+    readonly idGen: IdGen;
+    /** Toegestane origins (bv. 'https://api.example.com'). Alleen hierheen gaat de header. */
+    readonly allowedOrigins: readonly string[];
+    /** Optionele provider die een reeds actieve context levert (bv. OTel-web-SDK). */
+    readonly provider?: TraceContextProvider;
+    /** Standaard-flags voor nieuwe traces. Default: '01' (sampled). */
+    readonly flags?: string;
+}
+export interface TracePropagator {
+    /** Levert de trace-context die op deze request meegaat, of `undefined` bij een niet-toegestane origin. */
+    contextFor(targetUrl: string): TraceContext | undefined;
+    /**
+     * Levert de headers voor een uitgaande request: `{ traceparent }` voor toegestane origins,
+     * of een leeg object zodat er geen trace-context naar derden lekt.
+     */
+    headersFor(targetUrl: string): Record<string, string>;
+}
+/** Bouwt een propagator die per-request een traceparent-header samenstelt met origin-filter. */
+export declare function createTracePropagator(options: TracePropagatorOptions): TracePropagator;
+//# sourceMappingURL=trace.d.ts.map

package/dist/frontend/observability/core/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../../frontend/src/observability/core/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAmB5E,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAE3D;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CASxE;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAE9D;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,GAAE,MAAsB,GAAG,YAAY,CAE9F;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,YAAY,CAErF;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,0FAA0F;IAC1F,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACzC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,0GAA0G;IAC1G,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAAC;IACxD;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvD;AAWD,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAqBtF"}

package/dist/frontend/observability/core/trace.js

@@ -0,0 +1,76 @@
+/**
+ * W3C Trace Context-propagatie. Pure functies om een `traceparent`-header te formatteren/parsen
+ * en een propagator-port voor de http-interceptor. Ids komen van een geïnjecteerde IdGen
+ * (deterministisch in tests). De header wordt alleen naar toegestane origins gestuurd; er is
+ * geen module-globale state en geen vaste vendor → SSR-veilig en portabel.
+ */
+/** W3C traceparent-versie. */
+const VERSION = '00';
+/** Standaard trace-flags: sampled. */
+const DEFAULT_FLAGS = '01';
+const TRACE_ID_RE = /^[0-9a-f]{32}$/;
+const SPAN_ID_RE = /^[0-9a-f]{16}$/;
+const FLAGS_RE = /^[0-9a-f]{2}$/;
+const TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+/** Formatteert een trace-context als W3C traceparent-headerwaarde. */
+export function formatTraceparent(ctx) {
+    return `${VERSION}-${ctx.traceId}-${ctx.spanId}-${ctx.flags}`;
+}
+/** Parset een traceparent-headerwaarde; geeft `undefined` bij een ongeldig formaat. */
+export function parseTraceparent(value) {
+    const match = TRACEPARENT_RE.exec(value.trim());
+    if (match === null)
+        return undefined;
+    const traceId = match[2];
+    const spanId = match[3];
+    const flags = match[4];
+    // all-zero trace-/span-id is ongeldig volgens de spec.
+    if (/^0+$/.test(traceId) || /^0+$/.test(spanId))
+        return undefined;
+    return { traceId, spanId, flags };
+}
+/** Valideert of een trace-context wél-gevormde ids en flags heeft. */
+export function isValidTraceContext(ctx) {
+    return TRACE_ID_RE.test(ctx.traceId) && SPAN_ID_RE.test(ctx.spanId) && FLAGS_RE.test(ctx.flags);
+}
+/** Genereert een nieuwe trace-context (nieuwe trace-id + span-id) via de IdGen. */
+export function generateTraceContext(idGen, flags = DEFAULT_FLAGS) {
+    return { traceId: idGen.traceId(), spanId: idGen.spanId(), flags };
+}
+/** Zet een bestaande trace voort: zelfde trace-id + flags, nieuwe (child-)span-id. */
+export function continueTraceContext(parent, idGen) {
+    return { traceId: parent.traceId, spanId: idGen.spanId(), flags: parent.flags };
+}
+/** Bepaalt de origin van een URL; `undefined` bij een onparseerbare waarde. */
+function originOf(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Bouwt een propagator die per-request een traceparent-header samenstelt met origin-filter. */
+export function createTracePropagator(options) {
+    const { idGen, provider } = options;
+    const flags = options.flags ?? DEFAULT_FLAGS;
+    const allowed = new Set(options.allowedOrigins);
+    const contextFor = (targetUrl) => {
+        const origin = originOf(targetUrl);
+        if (origin === undefined || !allowed.has(origin))
+            return undefined;
+        const existing = provider?.current();
+        return existing ? continueTraceContext(existing, idGen) : generateTraceContext(idGen, flags);
+    };
+    return {
+        contextFor,
+        headersFor(targetUrl) {
+            const ctx = contextFor(targetUrl);
+            const headers = {};
+            if (ctx)
+                headers['traceparent'] = formatTraceparent(ctx);
+            return headers;
+        },
+    };
+}
+//# sourceMappingURL=trace.js.map

package/dist/frontend/observability/core/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../../frontend/src/observability/core/trace.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,8BAA8B;AAC9B,MAAM,OAAO,GAAG,IAAI,CAAC;AACrB,sCAAsC;AACtC,MAAM,aAAa,GAAG,IAAI,CAAC;AAE3B,MAAM,WAAW,GAAG,gBAAgB,CAAC;AACrC,MAAM,UAAU,GAAG,gBAAgB,CAAC;AACpC,MAAM,QAAQ,GAAG,eAAe,CAAC;AACjC,MAAM,cAAc,GAAG,6DAA6D,CAAC;AAErF,sEAAsE;AACtE,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO,GAAG,OAAO,IAAI,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;AAChE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;IAClC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAW,CAAC;IACjC,uDAAuD;IACvD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAClE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,GAAiB;IACnD,OAAO,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAClG,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,KAAY,EAAE,QAAgB,aAAa;IAC9E,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC;AACrE,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,MAAoB,EAAE,KAAY;IACrE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;AAClF,CAAC;AAsBD,+EAA+E;AAC/E,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAEhD,MAAM,UAAU,GAAG,CAAC,SAAiB,EAA4B,EAAE;QACjE,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QACnE,MAAM,QAAQ,GAAG,QAAQ,EAAE,OAAO,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/F,CAAC,CAAC;IAEF,OAAO;QACL,UAAU;QACV,UAAU,CAAC,SAAS;YAClB,MAAM,GAAG,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;YAClC,MAAM,OAAO,GAA2B,EAAE,CAAC;YAC3C,IAAI,GAAG;gBAAE,OAAO,CAAC,aAAa,CAAC,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;YACzD,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/frontend/observability/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * observability-kit (frontend) — gestructureerde client-logger met PII-redactie, error-reporting
+ * met injecteerbare global handlers, web-vitals/RUM-collector en W3C trace-context-propagatie.
+ * Pure core (ports & adapters) + injecteerbare sinks/target/idgen; framework-vrij, geen
+ * module-globale state, SSR/hydratie-veilig. Geen harde dependency op `web-vitals` of `window`.
+ */
+export type { LogLevel, LogRecord, LogSink, ErrorReportType, ErrorReport, ErrorSink, MetricRecord, MetricSink, TraceContext, TraceContextProvider, Clock, IdGen, } from './core/ports.js';
+export { createRedactor } from './core/redaction.js';
+export type { RedactionPolicy, Redactor } from './core/redaction.js';
+export { createLogger } from './core/logger.js';
+export type { Logger, LoggerOptions } from './core/logger.js';
+export { createErrorReporter } from './core/error-reporter.js';
+export type { ErrorReporter, ErrorReporterOptions, EventTargetLike, } from './core/error-reporter.js';
+export { createRumCollector } from './core/rum.js';
+export type { RumCollector, RumCollectorOptions, MetricAggregate, WebVitalName, } from './core/rum.js';
+export { formatTraceparent, parseTraceparent, isValidTraceContext, generateTraceContext, continueTraceContext, createTracePropagator, } from './core/trace.js';
+export type { TracePropagator, TracePropagatorOptions } from './core/trace.js';
+export { consoleLogSink, collectingLogSink, collectingErrorSink, collectingMetricSink, } from './adapters/sinks.js';
+export { systemClock, fixedClock, fixedIdGen, sequentialIdGen, randomIdGen, } from './adapters/id-clock.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/frontend/observability/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../frontend/src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,QAAQ,EACR,SAAS,EACT,OAAO,EACP,eAAe,EACf,WAAW,EACX,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,oBAAoB,EACpB,KAAK,EACL,KAAK,GACN,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,eAAe,GAChB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,eAAe,EACf,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAG/E,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,WAAW,EACX,UAAU,EACV,UAAU,EACV,eAAe,EACf,WAAW,GACZ,MAAM,wBAAwB,CAAC"}