webapp-factory 0.1.0

package/dist/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/observability/core/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../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/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

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

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

package/dist/observability/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `observability` kit — domein-loze telemetrie: gestructureerde JSON-logger met redactie (US-1101),
+ * RED/Prometheus-metrics (US-1102), OTel-achtige tracing met W3C-context-propagatie (US-1103) en
+ * liveness/readiness-probes (US-1104). Gedeelde correlation-context; service-naam/labels geïnjecteerd.
+ *
+ * De NestJS-adapter (/metrics, /livez, /readyz) zit onder `webapp-factory/backend-foundation/observability/nestjs`.
+ */
+export { runWithContext, getObsContext, type ObsContext } from './core/context.js';
+export { createLogger, type Logger, type LoggerOptions, type LogLevel } from './core/logger.js';
+export { REDACTED, DEFAULT_REDACT_KEYS, safeStringify } from './core/redaction.js';
+export { MetricsRegistry, createRedMetrics, type RedMetrics, type RedSample, type LabelValues, } from './core/metrics.js';
+export { createTracer, type Tracer, type Span, type SpanData, type SpanContext, type SpanExporter, type IdGenerator, type TracerOptions, } from './core/tracing.js';
+export { createHealth, type Health, type HealthCheck, type HealthCheckResult, type HealthReport, type CheckReport, type HealthOptions, } from './core/health.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGnF,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGnF,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,KAAK,MAAM,EACX,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,GACnB,MAAM,kBAAkB,CAAC"}

package/dist/observability/index.js

@@ -0,0 +1,19 @@
+/**
+ * `observability` kit — domein-loze telemetrie: gestructureerde JSON-logger met redactie (US-1101),
+ * RED/Prometheus-metrics (US-1102), OTel-achtige tracing met W3C-context-propagatie (US-1103) en
+ * liveness/readiness-probes (US-1104). Gedeelde correlation-context; service-naam/labels geïnjecteerd.
+ *
+ * De NestJS-adapter (/metrics, /livez, /readyz) zit onder `webapp-factory/backend-foundation/observability/nestjs`.
+ */
+// Gedeelde context
+export { runWithContext, getObsContext } from './core/context.js';
+// Logger (US-1101)
+export { createLogger } from './core/logger.js';
+export { REDACTED, DEFAULT_REDACT_KEYS, safeStringify } from './core/redaction.js';
+// Metrics (US-1102)
+export { MetricsRegistry, createRedMetrics, } from './core/metrics.js';
+// Tracing (US-1103)
+export { createTracer, } from './core/tracing.js';
+// Health (US-1104)
+export { createHealth, } from './core/health.js';
+//# sourceMappingURL=index.js.map

package/dist/observability/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mBAAmB;AACnB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAmB,MAAM,mBAAmB,CAAC;AAEnF,mBAAmB;AACnB,OAAO,EAAE,YAAY,EAAkD,MAAM,kBAAkB,CAAC;AAChG,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEnF,oBAAoB;AACpB,OAAO,EACL,eAAe,EACf,gBAAgB,GAIjB,MAAM,mBAAmB,CAAC;AAE3B,oBAAoB;AACpB,OAAO,EACL,YAAY,GAQb,MAAM,mBAAmB,CAAC;AAE3B,mBAAmB;AACnB,OAAO,EACL,YAAY,GAOb,MAAM,kBAAkB,CAAC"}

package/dist/observability/nestjs/observability.module.d.ts

@@ -0,0 +1,35 @@
+/**
+ * NestJS-adapter: serveert `/metrics` (Prometheus-tekst, US-1102), `/livez` en `/readyz` (US-1104).
+ * De pure logica zit in de core; dit is de HTTP-binding. `@nestjs/common` is een optionele
+ * peer-dependency.
+ */
+import { type DynamicModule } from '@nestjs/common';
+import type { Health } from '../core/health.js';
+import type { RedMetrics } from '../core/metrics.js';
+export declare const OBS_METRICS: unique symbol;
+export declare const OBS_HEALTH: unique symbol;
+interface ResponseLike {
+    setHeader(name: string, value: string): unknown;
+    status(code: number): {
+        send(body: string): unknown;
+        json(body: unknown): unknown;
+    };
+}
+export declare class ObservabilityController {
+    private readonly metrics;
+    private readonly health;
+    constructor(metrics: RedMetrics | null, health: Health | null);
+    serveMetrics(res: ResponseLike): void;
+    livez(res: ResponseLike): void;
+    readyz(res: ResponseLike): Promise<void>;
+}
+export interface ObservabilityModuleOptions {
+    metrics?: RedMetrics;
+    health?: Health;
+    global?: boolean;
+}
+export declare class ObservabilityModule {
+    static forRoot(options: ObservabilityModuleOptions): DynamicModule;
+}
+export {};
+//# sourceMappingURL=observability.module.d.ts.map

package/dist/observability/nestjs/observability.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.module.d.ts","sourceRoot":"","sources":["../../../src/observability/nestjs/observability.module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAKL,KAAK,aAAa,EAEnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,eAAO,MAAM,WAAW,eAAsC,CAAC;AAC/D,eAAO,MAAM,UAAU,eAAqC,CAAC;AAE7D,UAAU,YAAY;IACpB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,IAAI,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;KAAE,CAAC;CACrF;AAED,qBACa,uBAAuB;IAEX,OAAO,CAAC,QAAQ,CAAC,OAAO;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADL,OAAO,EAAE,UAAU,GAAG,IAAI,EAC3B,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5D,YAAY,CAAQ,GAAG,EAAE,YAAY,GAAG,IAAI;IAM5C,KAAK,CAAQ,GAAG,EAAE,YAAY,GAAG,IAAI;IAK/B,MAAM,CAAQ,GAAG,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;CAQtD;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,aAAa;CAanE"}

package/dist/observability/nestjs/observability.module.js

@@ -0,0 +1,87 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+/**
+ * NestJS-adapter: serveert `/metrics` (Prometheus-tekst, US-1102), `/livez` en `/readyz` (US-1104).
+ * De pure logica zit in de core; dit is de HTTP-binding. `@nestjs/common` is een optionele
+ * peer-dependency.
+ */
+import { Controller, Get, Inject, Res, } from '@nestjs/common';
+export const OBS_METRICS = Symbol.for('observability.metrics');
+export const OBS_HEALTH = Symbol.for('observability.health');
+let ObservabilityController = class ObservabilityController {
+    metrics;
+    health;
+    constructor(metrics, health) {
+        this.metrics = metrics;
+        this.health = health;
+    }
+    serveMetrics(res) {
+        res.setHeader('Content-Type', 'text/plain; version=0.0.4; charset=utf-8');
+        res.status(200).send(this.metrics ? this.metrics.render() : '');
+    }
+    livez(res) {
+        res.status(200).json({ status: 'up' });
+    }
+    async readyz(res) {
+        if (!this.health) {
+            res.status(200).json({ status: 'up', checks: [] });
+            return;
+        }
+        const report = await this.health.readyz();
+        res.status(report.http).json({ status: report.status, checks: report.checks });
+    }
+};
+__decorate([
+    Get('metrics'),
+    __param(0, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], ObservabilityController.prototype, "serveMetrics", null);
+__decorate([
+    Get('livez'),
+    __param(0, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], ObservabilityController.prototype, "livez", null);
+__decorate([
+    Get('readyz'),
+    __param(0, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], ObservabilityController.prototype, "readyz", null);
+ObservabilityController = __decorate([
+    Controller(),
+    __param(0, Inject(OBS_METRICS)),
+    __param(1, Inject(OBS_HEALTH)),
+    __metadata("design:paramtypes", [Object, Object])
+], ObservabilityController);
+export { ObservabilityController };
+export class ObservabilityModule {
+    static forRoot(options) {
+        const providers = [
+            { provide: OBS_METRICS, useValue: options.metrics ?? null },
+            { provide: OBS_HEALTH, useValue: options.health ?? null },
+        ];
+        return {
+            module: ObservabilityModule,
+            global: options.global ?? true,
+            controllers: [ObservabilityController],
+            providers,
+            exports: [OBS_METRICS, OBS_HEALTH],
+        };
+    }
+}
+//# sourceMappingURL=observability.module.js.map

package/dist/observability/nestjs/observability.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.module.js","sourceRoot":"","sources":["../../../src/observability/nestjs/observability.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;;;GAIG;AACH,OAAO,EACL,UAAU,EACV,GAAG,EACH,MAAM,EACN,GAAG,GAGJ,MAAM,gBAAgB,CAAC;AAIxB,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAQtD,IAAM,uBAAuB,GAA7B,MAAM,uBAAuB;IAEM;IACD;IAFvC,YACwC,OAA0B,EAC3B,MAAqB;QADpB,YAAO,GAAP,OAAO,CAAmB;QAC3B,WAAM,GAAN,MAAM,CAAe;IACzD,CAAC;IAGJ,YAAY,CAAQ,GAAiB;QACnC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,0CAA0C,CAAC,CAAC;QAC1E,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAGD,KAAK,CAAQ,GAAiB;QAC5B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAGK,AAAN,KAAK,CAAC,MAAM,CAAQ,GAAiB;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;YACnD,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1C,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;CACF,CAAA;AAnBC;IADC,GAAG,CAAC,SAAS,CAAC;IACD,WAAA,GAAG,EAAE,CAAA;;;;2DAGlB;AAGD;IADC,GAAG,CAAC,OAAO,CAAC;IACN,WAAA,GAAG,EAAE,CAAA;;;;oDAEX;AAGK;IADL,GAAG,CAAC,QAAQ,CAAC;IACA,WAAA,GAAG,EAAE,CAAA;;;;qDAOlB;AAzBU,uBAAuB;IADnC,UAAU,EAAE;IAGR,WAAA,MAAM,CAAC,WAAW,CAAC,CAAA;IACnB,WAAA,MAAM,CAAC,UAAU,CAAC,CAAA;;GAHV,uBAAuB,CA0BnC;;AAQD,MAAM,OAAO,mBAAmB;IAC9B,MAAM,CAAC,OAAO,CAAC,OAAmC;QAChD,MAAM,SAAS,GAAe;YAC5B,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI,EAAE;YAC3D,EAAE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI,EAAE;SAC1D,CAAC;QACF,OAAO;YACL,MAAM,EAAE,mBAAmB;YAC3B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,WAAW,EAAE,CAAC,uBAAuB,CAAC;YACtC,SAAS;YACT,OAAO,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;SACnC,CAAC;IACJ,CAAC;CACF"}

package/dist/persistence/adapters/in-memory-driver.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Dep-vrije in-memory {@link Driver}-adapter met een begrensde SQL-engine die exact de statements
+ * begrijpt die de kit genereert (tx-control, ledger, health, en de repository-CRUD met
+ * gelijkheids-filters + order/limit/offset). Bedoeld voor de eigen tests én voor consumer-tests
+ * zonder Docker. Onbekende statements (bv. project-DDL uit migraties) worden als no-op behandeld.
+ *
+ * Aanname: de primaire sleutel is de kolom `id`.
+ */
+import type { Driver, Row } from '../core/ports.js';
+type Store = Map<string, Map<string, Row>>;
+/** Maakt een in-memory driver; `database` is toegankelijk voor test-asserties/reset. */
+export declare function inMemoryDriver(): Driver & {
+    readonly database: {
+        tables: Store;
+    };
+};
+export {};
+//# sourceMappingURL=in-memory-driver.d.ts.map

package/dist/persistence/adapters/in-memory-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-driver.d.ts","sourceRoot":"","sources":["../../../src/persistence/adapters/in-memory-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAiC,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEnF,KAAK,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;AAiQ3C,wFAAwF;AACxF,wBAAgB,cAAc,IAAI,MAAM,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,CAAA;CAAE,CAMlF"}

package/dist/persistence/adapters/in-memory-driver.js

@@ -0,0 +1,229 @@
+class InMemoryDatabase {
+    tables = new Map();
+}
+function cloneStore(src) {
+    const out = new Map();
+    for (const [table, rows] of src) {
+        const inner = new Map();
+        for (const [key, row] of rows)
+            inner.set(key, structuredClone(row));
+        out.set(table, inner);
+    }
+    return out;
+}
+const norm = (sql) => sql.trim().replace(/\s+/g, ' ');
+function uniqueViolation() {
+    const err = new Error('duplicate key value violates unique constraint');
+    err.code = '23505';
+    return err;
+}
+class InMemoryConnection {
+    #db;
+    #work = null;
+    #savepoints = [];
+    constructor(db) {
+        this.#db = db;
+    }
+    #store() {
+        return this.#work ?? this.#db.tables;
+    }
+    #ensure(table) {
+        const store = this.#store();
+        let rows = store.get(table);
+        if (!rows) {
+            rows = new Map();
+            store.set(table, rows);
+        }
+        return rows;
+    }
+    async execute(sql, params = []) {
+        return this.#dispatch(norm(sql), params);
+    }
+    async close() {
+        this.#work = null;
+        this.#savepoints = [];
+    }
+    #dispatch(sql, params) {
+        // Transactie-control
+        if (/^BEGIN$/i.test(sql)) {
+            this.#work = cloneStore(this.#db.tables);
+            this.#savepoints = [];
+            return empty();
+        }
+        if (/^COMMIT$/i.test(sql)) {
+            if (this.#work)
+                this.#db.tables = this.#work;
+            this.#work = null;
+            this.#savepoints = [];
+            return empty();
+        }
+        if (/^ROLLBACK$/i.test(sql)) {
+            this.#work = null;
+            this.#savepoints = [];
+            return empty();
+        }
+        let m;
+        if ((m = /^SAVEPOINT "(.+?)"$/i.exec(sql))) {
+            this.#savepoints.push({ name: m[1], snapshot: cloneStore(this.#store()) });
+            return empty();
+        }
+        if ((m = /^RELEASE SAVEPOINT "(.+?)"$/i.exec(sql))) {
+            const idx = this.#savepoints.findIndex((s) => s.name === m[1]);
+            if (idx >= 0)
+                this.#savepoints.splice(idx);
+            return empty();
+        }
+        if ((m = /^ROLLBACK TO SAVEPOINT "(.+?)"$/i.exec(sql))) {
+            const idx = this.#savepoints.findIndex((s) => s.name === m[1]);
+            if (idx >= 0) {
+                this.#work = cloneStore(this.#savepoints[idx].snapshot);
+                this.#savepoints.splice(idx + 1);
+            }
+            return empty();
+        }
+        if (/^SELECT 1$/i.test(sql)) {
+            return { rows: [{ '?column?': 1 }], rowCount: 1 };
+        }
+        if ((m = /^CREATE TABLE IF NOT EXISTS "(.+?)"/i.exec(sql))) {
+            this.#ensure(m[1]);
+            return empty();
+        }
+        if ((m = /^INSERT INTO "(.+?)" \((.+?)\) VALUES \((.+?)\)( RETURNING \*)?$/i.exec(sql))) {
+            return this.#insert(m[1], m[2], m[3], params, Boolean(m[4]));
+        }
+        if ((m = /^SELECT COUNT\(\*\)::int AS "count" FROM "(.+?)"(?: WHERE (.+))?$/i.exec(sql))) {
+            const rows = this.#filter(m[1], m[2], params);
+            return { rows: [{ count: rows.length }], rowCount: 1 };
+        }
+        if ((m =
+            /^SELECT (.+?) FROM "(.+?)"(?: WHERE (.+?))?(?: ORDER BY (.+?))?(?: LIMIT (\d+|\$\d+))?(?: OFFSET (\d+|\$\d+))?$/i.exec(sql))) {
+            return this.#select(m[1], m[2], m[3], m[4], m[5], m[6], params);
+        }
+        if ((m = /^UPDATE "(.+?)" SET (.+?) WHERE (.+?)( RETURNING \*)?$/i.exec(sql))) {
+            return this.#update(m[1], m[2], m[3], params, Boolean(m[4]));
+        }
+        if ((m = /^DELETE FROM "(.+?)" WHERE (.+)$/i.exec(sql))) {
+            return this.#delete(m[1], m[2], params);
+        }
+        if ((m = /^TRUNCATE TABLE (.+?)(?: RESTART IDENTITY)?(?: CASCADE)?$/i.exec(sql))) {
+            for (const table of splitIdents(m[1]))
+                this.#store().get(table)?.clear();
+            return empty();
+        }
+        // Onbekend statement (bv. project-DDL): no-op.
+        return empty();
+    }
+    #insert(table, colList, valList, params, returning) {
+        const columns = splitIdents(colList);
+        const tokens = valList.split(',').map((t) => t.trim());
+        const rows = this.#ensure(table);
+        const row = {};
+        columns.forEach((col, i) => {
+            row[col] = resolveToken(tokens[i], params);
+        });
+        const key = row['id'] !== undefined ? String(row['id']) : `__auto_${rows.size + 1}`;
+        if (row['id'] !== undefined && rows.has(key))
+            throw uniqueViolation();
+        rows.set(key, row);
+        return returning ? { rows: [structuredClone(row)], rowCount: 1 } : empty();
+    }
+    #select(cols, table, where, order, limit, offset, params) {
+        let rows = this.#filter(table, where, params);
+        if (order)
+            rows = sortRows(rows, order);
+        if (offset)
+            rows = rows.slice(Number(resolveToken(offset, params)));
+        if (limit)
+            rows = rows.slice(0, Number(resolveToken(limit, params)));
+        const projected = cols.trim() === '*' ? rows : rows.map((r) => project(r, splitIdents(cols)));
+        return { rows: projected.map((r) => structuredClone(r)), rowCount: projected.length };
+    }
+    #update(table, setClause, where, params, returning) {
+        const targets = this.#filter(table, where, params);
+        const assignments = setClause.split(',').map((a) => a.trim());
+        for (const row of targets) {
+            for (const assignment of assignments) {
+                const am = /^"(.+?)" = (\$\d+|[^ ]+)$/.exec(assignment);
+                if (am)
+                    row[am[1]] = resolveToken(am[2], params);
+            }
+        }
+        return returning
+            ? { rows: targets.map((r) => structuredClone(r)), rowCount: targets.length }
+            : { rows: [], rowCount: targets.length };
+    }
+    #delete(table, where, params) {
+        const rows = this.#store().get(table);
+        if (!rows)
+            return empty();
+        const doomed = this.#filter(table, where, params);
+        let count = 0;
+        for (const [key, row] of rows) {
+            if (doomed.includes(row)) {
+                rows.delete(key);
+                count++;
+            }
+        }
+        return { rows: [], rowCount: count };
+    }
+    #filter(table, where, params) {
+        const rows = [...(this.#store().get(table)?.values() ?? [])];
+        if (!where)
+            return rows;
+        const predicates = where.split(' AND ').map((clause) => {
+            const cm = /^"(.+?)" = (\$\d+|[^ ]+)$/.exec(clause.trim());
+            if (!cm)
+                return () => true;
+            const col = cm[1];
+            const expected = resolveToken(cm[2], params);
+            return (row) => row[col] === expected;
+        });
+        return rows.filter((row) => predicates.every((p) => p(row)));
+    }
+}
+function empty() {
+    return { rows: [], rowCount: 0 };
+}
+function splitIdents(list) {
+    return list.split(',').map((c) => c.trim().replace(/^"|"$/g, ''));
+}
+function project(row, cols) {
+    const out = {};
+    for (const col of cols)
+        out[col] = row[col];
+    return out;
+}
+function resolveToken(token, params) {
+    const t = token.trim();
+    if (t.startsWith('$'))
+        return params[Number(t.slice(1)) - 1];
+    if (/^-?\d+$/.test(t))
+        return Number(t);
+    return t.replace(/^'|'$/g, '');
+}
+function sortRows(rows, order) {
+    const keys = order.split(',').map((part) => {
+        const om = /^"(.+?)" (ASC|DESC)$/i.exec(part.trim());
+        return { field: om?.[1] ?? '', desc: (om?.[2] ?? 'ASC').toUpperCase() === 'DESC' };
+    });
+    return [...rows].sort((a, b) => {
+        for (const { field, desc } of keys) {
+            const av = a[field];
+            const bv = b[field];
+            if (av === bv)
+                continue;
+            const cmp = av < bv ? -1 : 1;
+            return desc ? -cmp : cmp;
+        }
+        return 0;
+    });
+}
+/** Maakt een in-memory driver; `database` is toegankelijk voor test-asserties/reset. */
+export function inMemoryDriver() {
+    const db = new InMemoryDatabase();
+    return {
+        create: async () => new InMemoryConnection(db),
+        database: db,
+    };
+}
+//# sourceMappingURL=in-memory-driver.js.map

package/dist/persistence/adapters/in-memory-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-driver.js","sourceRoot":"","sources":["../../../src/persistence/adapters/in-memory-driver.ts"],"names":[],"mappings":"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"}

package/dist/persistence/adapters/pg-driver.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Echte Postgres-{@link Driver} bovenop `node-postgres` (`pg`). Verbindingsparameters komen via
+ * config-injectie binnen; secrets worden nooit gelogd. `pg` is een optionele peer-dependency.
+ */
+import { type ClientConfig } from 'pg';
+import type { Driver } from '../core/ports.js';
+/** Verbindingsconfiguratie (bij voorkeur geladen via de config-kit). */
+export interface PgConnectionConfig {
+    host: string;
+    port?: number;
+    database: string;
+    user: string;
+    /** Wachtwoord; geef een reeds-opgeloste string door (bv. `Secret.reveal()` uit de config-kit). */
+    password?: string;
+    ssl?: ClientConfig['ssl'];
+    /** Statement/connect-timeout in ms. */
+    connectionTimeoutMs?: number;
+}
+/** Maakt een Postgres-driver; elke `create()` opent een nieuwe fysieke verbinding. */
+export declare function pgDriver(config: PgConnectionConfig): Driver;
+//# sourceMappingURL=pg-driver.d.ts.map

package/dist/persistence/adapters/pg-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-driver.d.ts","sourceRoot":"","sources":["../../../src/persistence/adapters/pg-driver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAU,KAAK,YAAY,EAAE,MAAM,IAAI,CAAC;AAC/C,OAAO,KAAK,EAAE,MAAM,EAAsC,MAAM,kBAAkB,CAAC;AAEnF,wEAAwE;AACxE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IAC1B,uCAAuC;IACvC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAmBD,sFAAsF;AACtF,wBAAgB,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAoB3D"}