@seifer-webapp-factory/kits 0.1.0

package/dist/backend/observability/core/health.d.ts

@@ -0,0 +1,40 @@
+/**
+ * US-1104 — Liveness/readiness. `livez` = het proces leeft (altijd up). `readyz` aggregeert
+ * geïnjecteerde health-checks via de HealthCheck-port met een timeout en **fail-closed**: één
+ * verplichte check `down`/timeout/exception ⇒ readiness `down` (HTTP 503). Geen domeinkennis.
+ */
+export interface HealthCheckResult {
+    status: 'up' | 'down';
+    detail?: string;
+}
+export interface HealthCheck {
+    name: string;
+    /** Verplichte checks beïnvloeden readiness. Default `true`. */
+    required?: boolean;
+    check(): Promise<HealthCheckResult> | HealthCheckResult;
+}
+export interface CheckReport {
+    name: string;
+    status: 'up' | 'down';
+    required: boolean;
+    detail?: string;
+}
+export interface HealthReport {
+    status: 'up' | 'down';
+    http: 200 | 503;
+    checks: CheckReport[];
+}
+export interface Health {
+    livez(): {
+        status: 'up';
+        http: 200;
+    };
+    readyz(): Promise<HealthReport>;
+}
+export interface HealthOptions {
+    checks: HealthCheck[];
+    /** Timeout per check in ms. Default 1000. */
+    timeoutMs?: number;
+}
+export declare function createHealth(options: HealthOptions): Health;
+//# sourceMappingURL=health.d.ts.map

package/dist/backend/observability/core/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../../backend/src/observability/core/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC,GAAG,iBAAiB,CAAC;CACzD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,IAAI,EAAE,GAAG,GAAG,GAAG,CAAC;IAChB,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,IAAI;QAAE,MAAM,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,GAAG,CAAA;KAAE,CAAC;IACrC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAkC3D"}

package/dist/backend/observability/core/health.js

@@ -0,0 +1,51 @@
+/**
+ * US-1104 — Liveness/readiness. `livez` = het proces leeft (altijd up). `readyz` aggregeert
+ * geïnjecteerde health-checks via de HealthCheck-port met een timeout en **fail-closed**: één
+ * verplichte check `down`/timeout/exception ⇒ readiness `down` (HTTP 503). Geen domeinkennis.
+ */
+export function createHealth(options) {
+    const timeoutMs = options.timeoutMs ?? 1000;
+    return {
+        livez: () => ({ status: 'up', http: 200 }),
+        async readyz() {
+            const checks = await Promise.all(options.checks.map(async (check) => {
+                const required = check.required ?? true;
+                try {
+                    const result = await withTimeout(Promise.resolve(check.check()), timeoutMs);
+                    return {
+                        name: check.name,
+                        status: result.status,
+                        required,
+                        ...(result.detail ? { detail: result.detail } : {}),
+                    };
+                }
+                catch (error) {
+                    // Fail-closed; geen ruwe exception-details lekken.
+                    return {
+                        name: check.name,
+                        status: 'down',
+                        required,
+                        detail: error instanceof TimeoutError ? 'timeout' : 'error',
+                    };
+                }
+            }));
+            const up = checks.every((c) => c.status === 'up' || !c.required);
+            return { status: up ? 'up' : 'down', http: up ? 200 : 503, checks };
+        },
+    };
+}
+class TimeoutError extends Error {
+}
+function withTimeout(promise, ms) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new TimeoutError()), ms);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=health.js.map

package/dist/backend/observability/core/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../../backend/src/observability/core/health.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsCH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAE5C,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAE1C,KAAK,CAAC,MAAM;YACV,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAwB,EAAE;gBACvD,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC;gBACxC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;oBAC5E,OAAO;wBACL,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,QAAQ;wBACR,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBACpD,CAAC;gBACJ,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,mDAAmD;oBACnD,OAAO;wBACL,IAAI,EAAE,KAAK,CAAC,IAAI;wBAChB,MAAM,EAAE,MAAM;wBACd,QAAQ;wBACR,MAAM,EAAE,KAAK,YAAY,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO;qBAC5D,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CACH,CAAC;YAEF,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACjE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QACtE,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,YAAa,SAAQ,KAAK;CAAG;AAEnC,SAAS,WAAW,CAAI,OAAmB,EAAE,EAAU;IACrD,OAAO,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CACV,CAAC,KAAK,EAAE,EAAE;YACR,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACR,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,22 @@
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LoggerOptions {
+    service: string;
+    labels?: Record<string, unknown>;
+    /** Extra te redigeren sleutels bovenop de veilige defaults. */
+    redactKeys?: string[];
+    /** Minimale niveau. Default `info`. */
+    level?: LogLevel;
+    /** Sink voor elke regel. Default `process.stdout`. */
+    sink?: (line: string) => void;
+    clock?: () => number;
+}
+export interface Logger {
+    debug(message: string, fields?: Record<string, unknown>): void;
+    info(message: string, fields?: Record<string, unknown>): void;
+    warn(message: string, fields?: Record<string, unknown>): void;
+    error(message: string, fields?: Record<string, unknown>): void;
+    /** Nieuwe logger met extra labels erbovenop. */
+    child(labels: Record<string, unknown>): Logger;
+}
+export declare function createLogger(options: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../backend/src/observability/core/logger.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAI3D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,uCAAuC;IACvC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,sDAAsD;IACtD,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,gDAAgD;IAChD,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;CAChD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAuC3D"}

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

@@ -0,0 +1,45 @@
+/**
+ * US-1101 — Gestructureerde JSON-logger. Emit één JSON-object per regel met vaste velden
+ * (timestamp, level, message, service, labels, correlation-/trace-id) plus vrije velden. Service-naam,
+ * labels en redactie-regels komen uit config; geen domeinkennis. Redactie staat standaard aan.
+ */
+import { getObsContext } from './context.js';
+import { DEFAULT_REDACT_KEYS, safeStringify } from './redaction.js';
+const LEVEL_ORDER = { debug: 10, info: 20, warn: 30, error: 40 };
+export function createLogger(options) {
+    const service = options.service;
+    const labels = options.labels ?? {};
+    const minLevel = LEVEL_ORDER[options.level ?? 'info'];
+    const sink = options.sink ?? ((line) => process.stdout.write(line + '\n'));
+    const clock = options.clock ?? Date.now;
+    const redactKeys = new Set([...DEFAULT_REDACT_KEYS, ...(options.redactKeys ?? [])].map((k) => k.toLowerCase()));
+    function log(level, message, fields) {
+        if (LEVEL_ORDER[level] < minLevel)
+            return;
+        const ctx = getObsContext();
+        // Gereserveerde velden staan achteraan zodat ze niet door user-velden overschreven worden.
+        const record = {
+            ...(fields ?? {}),
+            timestamp: new Date(clock()).toISOString(),
+            level,
+            message,
+            service,
+            ...labels,
+            ...(ctx?.correlationId ? { correlationId: ctx.correlationId } : {}),
+            ...(ctx?.traceId ? { traceId: ctx.traceId } : {}),
+        };
+        sink(safeStringify(record, redactKeys));
+    }
+    const logger = {
+        debug: (m, f) => log('debug', m, f),
+        info: (m, f) => log('info', m, f),
+        warn: (m, f) => log('warn', m, f),
+        error: (m, f) => log('error', m, f),
+        child: (childLabels) => createLogger({
+            ...options,
+            labels: { ...labels, ...childLabels },
+        }),
+    };
+    return logger;
+}
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../backend/src/observability/core/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAIpE,MAAM,WAAW,GAA6B,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;AAuB3F,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,MAAM,QAAQ,GAAG,WAAW,CAAC,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,GAAG,CACxB,CAAC,GAAG,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CACpF,CAAC;IAEF,SAAS,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,MAAgC;QAC7E,IAAI,WAAW,CAAC,KAAK,CAAC,GAAG,QAAQ;YAAE,OAAO;QAC1C,MAAM,GAAG,GAAG,aAAa,EAAE,CAAC;QAC5B,2FAA2F;QAC3F,MAAM,MAAM,GAA4B;YACtC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE;YAC1C,KAAK;YACL,OAAO;YACP,OAAO;YACP,GAAG,MAAM;YACT,GAAG,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClD,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,MAAM,GAAW;QACrB,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;QACjC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACnC,KAAK,EAAE,CAAC,WAAW,EAAE,EAAE,CACrB,YAAY,CAAC;YACX,GAAG,OAAO;YACV,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE,GAAG,WAAW,EAAE;SACtC,CAAC;KACL,CAAC;IACF,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/backend/observability/core/metrics.d.ts

@@ -0,0 +1,63 @@
+/**
+ * US-1102 — RED-metrics (Rate/Errors/Duration) met export in Prometheus-tekstformaat. Labelnamen zijn
+ * begrensd (bounded cardinality); ontbrekende labels vallen terug op een veilige placeholder. Het
+ * renderen van één kapotte metriek laat de rest intact (geen crash).
+ */
+export type LabelValues = Record<string, string | number>;
+interface Metric {
+    render(): string;
+}
+declare class Counter implements Metric {
+    #private;
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    constructor(name: string, help: string, labelNames: string[]);
+    inc(labels?: LabelValues, value?: number): void;
+    render(): string;
+}
+declare class Gauge implements Metric {
+    #private;
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    constructor(name: string, help: string, labelNames: string[]);
+    set(labels: LabelValues | undefined, value: number): void;
+    render(): string;
+}
+declare class Histogram implements Metric {
+    #private;
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    readonly buckets: number[];
+    constructor(name: string, help: string, labelNames: string[], buckets: number[]);
+    observe(labels: LabelValues | undefined, value: number): void;
+    render(): string;
+}
+export declare class MetricsRegistry {
+    #private;
+    counter(name: string, help: string, labelNames?: string[]): Counter;
+    gauge(name: string, help: string, labelNames?: string[]): Gauge;
+    histogram(name: string, help: string, labelNames: string[], buckets: number[]): Histogram;
+    /** Rendert alle metrieken; een kapotte metriek wordt overgeslagen (US-1102 AC3). */
+    render(): string;
+}
+export interface RedSample {
+    route?: string;
+    method?: string;
+    status?: string | number;
+    durationSeconds: number;
+    error?: boolean;
+}
+export interface RedMetrics {
+    registry: MetricsRegistry;
+    observe(sample: RedSample): void;
+    render(): string;
+}
+export declare function createRedMetrics(options: {
+    service: string;
+    buckets?: number[];
+}): RedMetrics;
+export {};
+//# sourceMappingURL=metrics.d.ts.map

package/dist/backend/observability/core/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../../backend/src/observability/core/metrics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AAiC1D,UAAU,MAAM;IACd,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,cAAM,OAAQ,YAAW,MAAM;;IAG3B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE;gBAFpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE;IAE/B,GAAG,CAAC,MAAM,GAAE,WAAgB,EAAE,KAAK,SAAI,GAAG,IAAI;IAO9C,MAAM,IAAI,MAAM;CAOjB;AAED,cAAM,KAAM,YAAW,MAAM;;IAGzB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE;gBAFpB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE;IAE/B,GAAG,CAAC,MAAM,EAAE,WAAW,YAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAIlD,MAAM,IAAI,MAAM;CAOjB;AAED,cAAM,SAAU,YAAW,MAAM;;IAG7B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE;gBAHjB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,EAAE,MAAM,EAAE;IAE5B,OAAO,CAAC,MAAM,EAAE,WAAW,YAAK,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IActD,MAAM,IAAI,MAAM;CAcjB;AAED,qBAAa,eAAe;;IAE1B,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,GAAG,OAAO;IAKvE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,GAAG,KAAK;IAKnE,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,SAAS;IAKzF,oFAAoF;IACpF,MAAM,IAAI,MAAM;CAWjB;AAID,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACjC,MAAM,IAAI,MAAM,CAAC;CAClB;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,UAAU,CA2B7F"}

package/dist/backend/observability/core/metrics.js

@@ -0,0 +1,172 @@
+const PLACEHOLDER = 'unknown';
+function normalize(labelNames, provided) {
+    const out = {};
+    for (const name of labelNames) {
+        const value = provided[name];
+        out[name] = value === undefined || value === null ? PLACEHOLDER : String(value);
+    }
+    return out;
+}
+function seriesKey(labels) {
+    return Object.keys(labels)
+        .sort()
+        .map((k) => `${k}=${labels[k]}`)
+        .join(',');
+}
+function formatLabels(labels, extra) {
+    const all = { ...labels, ...(extra ?? {}) };
+    const parts = Object.keys(all)
+        .sort()
+        .map((k) => `${k}="${escapeLabel(all[k])}"`);
+    return parts.length > 0 ? `{${parts.join(',')}}` : '';
+}
+function escapeLabel(value) {
+    return value.replace(/\\/g, '\\\\').replace(/\n/g, '\\n').replace(/"/g, '\\"');
+}
+class Counter {
+    name;
+    help;
+    labelNames;
+    #series = new Map();
+    constructor(name, help, labelNames) {
+        this.name = name;
+        this.help = help;
+        this.labelNames = labelNames;
+    }
+    inc(labels = {}, value = 1) {
+        const norm = normalize(this.labelNames, labels);
+        const key = seriesKey(norm);
+        const existing = this.#series.get(key);
+        if (existing)
+            existing.value += value;
+        else
+            this.#series.set(key, { labels: norm, value });
+    }
+    render() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} counter`];
+        for (const { labels, value } of this.#series.values()) {
+            lines.push(`${this.name}${formatLabels(labels)} ${value}`);
+        }
+        return lines.join('\n');
+    }
+}
+class Gauge {
+    name;
+    help;
+    labelNames;
+    #series = new Map();
+    constructor(name, help, labelNames) {
+        this.name = name;
+        this.help = help;
+        this.labelNames = labelNames;
+    }
+    set(labels = {}, value) {
+        const norm = normalize(this.labelNames, labels);
+        this.#series.set(seriesKey(norm), { labels: norm, value });
+    }
+    render() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} gauge`];
+        for (const { labels, value } of this.#series.values()) {
+            lines.push(`${this.name}${formatLabels(labels)} ${value}`);
+        }
+        return lines.join('\n');
+    }
+}
+class Histogram {
+    name;
+    help;
+    labelNames;
+    buckets;
+    #series = new Map();
+    constructor(name, help, labelNames, buckets) {
+        this.name = name;
+        this.help = help;
+        this.labelNames = labelNames;
+        this.buckets = buckets;
+    }
+    observe(labels = {}, value) {
+        const norm = normalize(this.labelNames, labels);
+        const key = seriesKey(norm);
+        let entry = this.#series.get(key);
+        if (!entry) {
+            entry = { labels: norm, counts: new Array(this.buckets.length).fill(0), sum: 0, count: 0 };
+            this.#series.set(key, entry);
+        }
+        entry.sum += value;
+        entry.count += 1;
+        for (let i = 0; i < this.buckets.length; i++) {
+            if (value <= this.buckets[i])
+                entry.counts[i]++;
+        }
+    }
+    render() {
+        const lines = [`# HELP ${this.name} ${this.help}`, `# TYPE ${this.name} histogram`];
+        for (const entry of this.#series.values()) {
+            let cumulative = 0;
+            for (let i = 0; i < this.buckets.length; i++) {
+                cumulative += entry.counts[i];
+                lines.push(`${this.name}_bucket${formatLabels(entry.labels, { le: String(this.buckets[i]) })} ${cumulative}`);
+            }
+            lines.push(`${this.name}_bucket${formatLabels(entry.labels, { le: '+Inf' })} ${entry.count}`);
+            lines.push(`${this.name}_sum${formatLabels(entry.labels)} ${entry.sum}`);
+            lines.push(`${this.name}_count${formatLabels(entry.labels)} ${entry.count}`);
+        }
+        return lines.join('\n');
+    }
+}
+export class MetricsRegistry {
+    #metrics = [];
+    counter(name, help, labelNames = []) {
+        const c = new Counter(name, help, labelNames);
+        this.#metrics.push(c);
+        return c;
+    }
+    gauge(name, help, labelNames = []) {
+        const g = new Gauge(name, help, labelNames);
+        this.#metrics.push(g);
+        return g;
+    }
+    histogram(name, help, labelNames, buckets) {
+        const h = new Histogram(name, help, labelNames, buckets);
+        this.#metrics.push(h);
+        return h;
+    }
+    /** Rendert alle metrieken; een kapotte metriek wordt overgeslagen (US-1102 AC3). */
+    render() {
+        const blocks = [];
+        for (const metric of this.#metrics) {
+            try {
+                blocks.push(metric.render());
+            }
+            catch {
+                // metriek overslaan; rest blijft renderbaar
+            }
+        }
+        return blocks.join('\n') + '\n';
+    }
+}
+const DEFAULT_BUCKETS = [0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5];
+export function createRedMetrics(options) {
+    const registry = new MetricsRegistry();
+    const labelNames = ['service', 'route', 'method', 'status'];
+    const requests = registry.counter('requests_total', 'Total number of requests', labelNames);
+    const errors = registry.counter('errors_total', 'Total number of errored requests', labelNames);
+    const duration = registry.histogram('request_duration_seconds', 'Request duration in seconds', labelNames, options.buckets ?? DEFAULT_BUCKETS);
+    return {
+        registry,
+        observe(sample) {
+            const labels = {
+                service: options.service,
+                route: sample.route ?? PLACEHOLDER,
+                method: sample.method ?? PLACEHOLDER,
+                status: sample.status ?? PLACEHOLDER,
+            };
+            requests.inc(labels);
+            if (sample.error)
+                errors.inc(labels);
+            duration.observe(labels, sample.durationSeconds);
+        },
+        render: () => registry.render(),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/backend/observability/core/metrics.js.map

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

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

@@ -0,0 +1,10 @@
+/**
+ * US-1101 — Redactie + veilige serialisatie voor de logger. Gevoelige velden (op sleutelnaam,
+ * case-insensitief, ook genest) worden vervangen door `[REDACTED]`; circulaire referenties door
+ * `[Circular]`. De serialisatie gooit nooit een exception naar de aanroeper.
+ */
+export declare const REDACTED = "[REDACTED]";
+export declare const DEFAULT_REDACT_KEYS: string[];
+/** Serialiseert een waarde naar JSON met redactie van gevoelige sleutels en circular-bescherming. */
+export declare function safeStringify(value: unknown, redactKeys: Set<string>): string;
+//# sourceMappingURL=redaction.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../../../../backend/src/observability/core/redaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,QAAQ,eAAe,CAAC;AAErC,eAAO,MAAM,mBAAmB,UAkB/B,CAAC;AAEF,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAgB7E"}

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

@@ -0,0 +1,48 @@
+/**
+ * US-1101 — Redactie + veilige serialisatie voor de logger. Gevoelige velden (op sleutelnaam,
+ * case-insensitief, ook genest) worden vervangen door `[REDACTED]`; circulaire referenties door
+ * `[Circular]`. De serialisatie gooit nooit een exception naar de aanroeper.
+ */
+export const REDACTED = '[REDACTED]';
+export const DEFAULT_REDACT_KEYS = [
+    'password',
+    'pass',
+    'token',
+    'authorization',
+    'secret',
+    'apikey',
+    'api_key',
+    'accesstoken',
+    'access_token',
+    'refreshtoken',
+    'refresh_token',
+    'cookie',
+    'set-cookie',
+    'ssn',
+    'creditcard',
+    'card',
+    'pin',
+];
+/** Serialiseert een waarde naar JSON met redactie van gevoelige sleutels en circular-bescherming. */
+export function safeStringify(value, redactKeys) {
+    const seen = new WeakSet();
+    try {
+        return JSON.stringify(value, function replacer(key, val) {
+            if (key && redactKeys.has(key.toLowerCase()))
+                return REDACTED;
+            if (val !== null && typeof val === 'object') {
+                if (seen.has(val))
+                    return '[Circular]';
+                seen.add(val);
+            }
+            if (typeof val === 'bigint')
+                return val.toString();
+            return val;
+        });
+    }
+    catch {
+        // Laatste redmiddel: nooit gooien naar de aanroeper.
+        return JSON.stringify({ error: '[Unserializable]' });
+    }
+}
+//# sourceMappingURL=redaction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.js","sourceRoot":"","sources":["../../../../backend/src/observability/core/redaction.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,YAAY,CAAC;AAErC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU;IACV,MAAM;IACN,OAAO;IACP,eAAe;IACf,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,QAAQ;IACR,YAAY;IACZ,KAAK;IACL,YAAY;IACZ,MAAM;IACN,KAAK;CACN,CAAC;AAEF,qGAAqG;AACrG,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,UAAuB;IACnE,MAAM,IAAI,GAAG,IAAI,OAAO,EAAU,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,QAAQ,CAAC,GAAG,EAAE,GAAG;YACrD,IAAI,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;gBAAE,OAAO,QAAQ,CAAC;YAC9D,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBAC5C,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAAE,OAAO,YAAY,CAAC;gBACvC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;YACnD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;QACrD,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}

package/dist/backend/observability/core/tracing.d.ts

@@ -0,0 +1,52 @@
+export interface SpanData {
+    name: string;
+    service: string;
+    traceId: string;
+    spanId: string;
+    parentSpanId: string | undefined;
+    startTime: number;
+    endTime: number | undefined;
+    attributes: Record<string, unknown>;
+    status: 'unset' | 'ok' | 'error';
+}
+export interface SpanExporter {
+    export(span: SpanData): void;
+}
+export interface SpanContext {
+    traceId: string;
+    spanId: string;
+}
+export interface Span {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly parentSpanId: string | undefined;
+    setAttribute(key: string, value: unknown): void;
+    setStatus(status: 'ok' | 'error'): void;
+    end(): void;
+}
+export interface IdGenerator {
+    traceId(): string;
+    spanId(): string;
+}
+export interface TracerOptions {
+    service: string;
+    exporter: SpanExporter;
+    idGenerator?: IdGenerator;
+    clock?: () => number;
+}
+export interface Tracer {
+    startSpan(name: string, options?: {
+        parent?: SpanContext;
+        attributes?: Record<string, unknown>;
+    }): Span;
+    runWithSpan<T>(span: Span, fn: () => T): T;
+    activeSpan(): Span | undefined;
+    /** Leidt een span-context af uit een inkomende `traceparent`-header, of `undefined` als ongeldig. */
+    extract(headers: Record<string, string | string[] | undefined>): SpanContext | undefined;
+    /** Zet de `traceparent`-header op basis van de gegeven of actieve span (uitgaande call). */
+    inject(headers: Record<string, string>, span?: Span): void;
+    /** Server-span: neemt de parent over uit de headers, of start een nieuwe root-trace (US-1103 AC3). */
+    startServerSpan(name: string, headers: Record<string, string | string[] | undefined>): Span;
+}
+export declare function createTracer(options: TracerOptions): Tracer;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/backend/observability/core/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../../backend/src/observability/core/tracing.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,IAAI;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IAChD,SAAS,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,GAAG,IAAI,CAAC;IACxC,GAAG,IAAI,IAAI,CAAC;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,IAAI,MAAM,CAAC;IAClB,MAAM,IAAI,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,MAAM;IACrB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACxG,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3C,UAAU,IAAI,IAAI,GAAG,SAAS,CAAC;IAC/B,qGAAqG;IACrG,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,WAAW,GAAG,SAAS,CAAC;IACzF,4FAA4F;IAC5F,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3D,sGAAsG;IACtG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;CAC7F;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAmF3D"}

package/dist/backend/observability/core/tracing.js

@@ -0,0 +1,88 @@
+/**
+ * US-1103 — Tracing met W3C-`traceparent`-propagatie. Start/beëindigt spans, propageert de
+ * trace-context (trace-id, span-id, correlation-id) over async-grenzen en inkomende/uitgaande HTTP-
+ * headers, en exporteert spans via een Exporter-port. De correlation-id wordt gedeeld met de logger
+ * (US-1101). Minimale, OTel-compatibele implementatie zonder zware SDK-dep.
+ */
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { randomBytes } from 'node:crypto';
+import { getObsContext, runWithContext } from './context.js';
+const TRACEPARENT = /^00-([0-9a-f]{32})-([0-9a-f]{16})-[0-9a-f]{2}$/;
+export function createTracer(options) {
+    const service = options.service;
+    const clock = options.clock ?? Date.now;
+    const genTraceId = options.idGenerator?.traceId ?? (() => randomBytes(16).toString('hex'));
+    const genSpanId = options.idGenerator?.spanId ?? (() => randomBytes(8).toString('hex'));
+    const spanStorage = new AsyncLocalStorage();
+    const tracer = {
+        startSpan(name, spanOptions = {}) {
+            const parent = spanOptions.parent ?? activeContext();
+            const traceId = parent?.traceId ?? genTraceId();
+            const spanId = genSpanId();
+            const data = {
+                name,
+                service,
+                traceId,
+                spanId,
+                parentSpanId: parent?.spanId,
+                startTime: clock(),
+                endTime: undefined,
+                attributes: { ...(spanOptions.attributes ?? {}) },
+                status: 'unset',
+            };
+            let ended = false;
+            return {
+                traceId,
+                spanId,
+                parentSpanId: data.parentSpanId,
+                setAttribute: (key, value) => {
+                    data.attributes[key] = value;
+                },
+                setStatus: (status) => {
+                    data.status = status;
+                },
+                end: () => {
+                    if (ended)
+                        return;
+                    ended = true;
+                    data.endTime = clock();
+                    options.exporter.export({ ...data, attributes: { ...data.attributes } });
+                },
+            };
+        },
+        runWithSpan(span, fn) {
+            const existing = getObsContext();
+            return runWithContext({
+                traceId: span.traceId,
+                spanId: span.spanId,
+                correlationId: existing?.correlationId ?? span.traceId,
+            }, () => spanStorage.run(span, fn));
+        },
+        activeSpan: () => spanStorage.getStore(),
+        extract(headers) {
+            const raw = headers['traceparent'];
+            const value = Array.isArray(raw) ? raw[0] : raw;
+            if (!value)
+                return undefined;
+            const match = TRACEPARENT.exec(value);
+            if (!match)
+                return undefined;
+            return { traceId: match[1], spanId: match[2] };
+        },
+        inject(headers, span = tracer.activeSpan()) {
+            if (!span)
+                return;
+            headers['traceparent'] = `00-${span.traceId}-${span.spanId}-01`;
+        },
+        startServerSpan(name, headers) {
+            const parent = tracer.extract(headers);
+            return tracer.startSpan(name, parent ? { parent } : {});
+        },
+    };
+    function activeContext() {
+        const span = spanStorage.getStore();
+        return span ? { traceId: span.traceId, spanId: span.spanId } : undefined;
+    }
+    return tracer;
+}
+//# sourceMappingURL=tracing.js.map