@seifer-webapp-factory/kits 0.1.0

package/dist/backend/jobs/core/ports.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Poorten & types voor de jobs-kit. Job-handlers, de queue-store, het backoff-beleid en de
+ * idempotency-store worden geïnjecteerd; de kit kent geen concrete job-logica.
+ */
+export type Clock = () => number;
+/** Persistente job-representatie (payload is reeds geserialiseerd). */
+export interface JobRecord {
+    id: string;
+    name: string;
+    payload: string;
+    attempts: number;
+    maxAttempts: number;
+    /** ms epoch waarop de job verwerkbaar is (delay/retry). */
+    availableAt: number;
+    enqueuedAt: number;
+    idempotencyKey?: string;
+    lastError?: string;
+    history?: {
+        attempt: number;
+        error: string;
+        at: number;
+    }[];
+}
+export interface QueueStats {
+    waiting: number;
+    delayed: number;
+    processing: number;
+    dead: number;
+}
+/**
+ * Queue-store-poort (US-0801 AC4). Reserveert jobs met een lease (visibility-timeout), zodat een
+ * gecrashte worker de job niet permanent blokkeert. Adapters: in-memory en Redis.
+ */
+export interface QueueStore {
+    push(job: JobRecord): Promise<void>;
+    /** Reserveer één verwerkbare job atomair met een lease; verlopen leases komen terug beschikbaar. */
+    reserve(nowMs: number, leaseMs: number): Promise<JobRecord | null>;
+    /** Markeer een gereserveerde job als voltooid (verwijderd). */
+    complete(jobId: string): Promise<void>;
+    /** Plan een gereserveerde job opnieuw (bijgewerkte attempts/availableAt/history). */
+    reschedule(job: JobRecord): Promise<void>;
+    /** Verplaats een gereserveerde job naar de dead-letter-queue. */
+    deadLetter(job: JobRecord): Promise<void>;
+    /** Geef een gereserveerde job terug aan de queue (bv. bij shutdown). */
+    release(jobId: string, availableAtMs: number): Promise<void>;
+    /** Lijst dead-letter-jobs (inspectie). */
+    listDeadLetter(): Promise<JobRecord[]>;
+    /** Herplan een dead-letter-job in de hoofdqueue met gereset pogingsteller. */
+    requeueDeadLetter(jobId: string, nowMs: number): Promise<JobRecord | null>;
+    stats(nowMs: number): Promise<QueueStats>;
+}
+export interface JobContext {
+    jobId: string;
+    jobName: string;
+    attempt: number;
+}
+export type JobHandler<P = unknown> = (payload: P, context: JobContext) => Promise<void> | void;
+export interface HandlerRegistry {
+    get(name: string): JobHandler | undefined;
+    register<P>(name: string, handler: JobHandler<P>): void;
+}
+/** Backoff-beleid voor retries (US-0802). */
+export interface BackoffPolicy {
+    computeDelayMs(attempt: number): number;
+}
+/** Idempotency-store (US-0804): registreert succesvol verwerkte keys + serialiseert duplicaten. */
+export interface IdempotencyLock {
+    release(): Promise<void>;
+}
+export interface IdempotencyStore {
+    isProcessed(key: string): Promise<boolean>;
+    markProcessed(key: string, ttlMs: number): Promise<void>;
+    /** Verkrijg een verwerkings-lock op de key; `null` als een ander de key al verwerkt. */
+    acquire(key: string, ttlMs: number): Promise<IdempotencyLock | null>;
+}
+export interface Serializer {
+    serialize(value: unknown): string;
+    deserialize<T>(raw: string): T;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/backend/jobs/core/ports.d.ts.map

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

package/dist/backend/jobs/core/ports.js

@@ -0,0 +1,6 @@
+/**
+ * Poorten & types voor de jobs-kit. Job-handlers, de queue-store, het backoff-beleid en de
+ * idempotency-store worden geïnjecteerd; de kit kent geen concrete job-logica.
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/backend/jobs/core/ports.js.map

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

package/dist/backend/jobs/core/queue.d.ts

@@ -0,0 +1,16 @@
+import type { Clock, QueueStore, Serializer } from './ports.js';
+export interface EnqueueOptions {
+    maxAttempts?: number;
+    delayMs?: number;
+    idempotencyKey?: string;
+}
+export interface Queue {
+    enqueue<P>(name: string, payload: P, options?: EnqueueOptions): Promise<string>;
+}
+export interface QueueOptions {
+    clock?: Clock;
+    serializer?: Serializer;
+    defaultMaxAttempts?: number;
+}
+export declare function createQueue(store: QueueStore, options?: QueueOptions): Queue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/backend/jobs/core/queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../../backend/src/jobs/core/queue.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAa,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAG3E,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACpB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACjF;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,YAAiB,GAAG,KAAK,CAsBhF"}

package/dist/backend/jobs/core/queue.js

@@ -0,0 +1,29 @@
+/**
+ * US-0801 — Enqueue-API. Plaatst een getypte job op de pluggable {@link QueueStore}. Ondersteunt
+ * delay, max-pogingen en een idempotencyKey (US-0804). Payload wordt geserialiseerd; geen domeinkennis.
+ */
+import { randomUUID } from 'node:crypto';
+import { jsonSerializer } from './serializer.js';
+export function createQueue(store, options = {}) {
+    const clock = options.clock ?? Date.now;
+    const serializer = options.serializer ?? jsonSerializer;
+    const defaultMaxAttempts = options.defaultMaxAttempts ?? 3;
+    return {
+        async enqueue(name, payload, enqueueOptions = {}) {
+            const now = clock();
+            const job = {
+                id: randomUUID(),
+                name,
+                payload: serializer.serialize(payload),
+                attempts: 0,
+                maxAttempts: enqueueOptions.maxAttempts ?? defaultMaxAttempts,
+                availableAt: now + (enqueueOptions.delayMs ?? 0),
+                enqueuedAt: now,
+                ...(enqueueOptions.idempotencyKey ? { idempotencyKey: enqueueOptions.idempotencyKey } : {}),
+            };
+            await store.push(job);
+            return job.id;
+        },
+    };
+}
+//# sourceMappingURL=queue.js.map

package/dist/backend/jobs/core/queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../../backend/src/jobs/core/queue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAkBjD,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,UAAwB,EAAE;IACvE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,cAAc,CAAC;IACxD,MAAM,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,IAAI,CAAC,CAAC;IAE3D,OAAO;QACL,KAAK,CAAC,OAAO,CAAI,IAAY,EAAE,OAAU,EAAE,iBAAiC,EAAE;YAC5E,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;YACpB,MAAM,GAAG,GAAc;gBACrB,EAAE,EAAE,UAAU,EAAE;gBAChB,IAAI;gBACJ,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC;gBACtC,QAAQ,EAAE,CAAC;gBACX,WAAW,EAAE,cAAc,CAAC,WAAW,IAAI,kBAAkB;gBAC7D,WAAW,EAAE,GAAG,GAAG,CAAC,cAAc,CAAC,OAAO,IAAI,CAAC,CAAC;gBAChD,UAAU,EAAE,GAAG;gBACf,GAAG,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,cAAc,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5F,CAAC;YACF,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACtB,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/jobs/core/registry.d.ts

@@ -0,0 +1,4 @@
+import type { HandlerRegistry, JobHandler } from './ports.js';
+/** Eenvoudige handler-registry; handlers worden door het project geïnjecteerd (US-0801). */
+export declare function createRegistry(handlers?: Record<string, JobHandler>): HandlerRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/backend/jobs/core/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../backend/src/jobs/core/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE9D,4FAA4F;AAC5F,wBAAgB,cAAc,CAAC,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAM,GAAG,eAAe,CAQzF"}

package/dist/backend/jobs/core/registry.js

@@ -0,0 +1,11 @@
+/** Eenvoudige handler-registry; handlers worden door het project geïnjecteerd (US-0801). */
+export function createRegistry(handlers = {}) {
+    const map = new Map(Object.entries(handlers));
+    return {
+        get: (name) => map.get(name),
+        register: (name, handler) => {
+            map.set(name, handler);
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/backend/jobs/core/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../backend/src/jobs/core/registry.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,MAAM,UAAU,cAAc,CAAC,WAAuC,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAqB,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,OAAO;QACL,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;QAC5B,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YAC1B,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,OAAqB,CAAC,CAAC;QACvC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/jobs/core/scheduler.d.ts

@@ -0,0 +1,30 @@
+import type { Clock } from './ports.js';
+import type { Queue } from './queue.js';
+export interface CronDefinition {
+    /** Job-naam die op de queue wordt geplaatst. */
+    jobName: string;
+    /** Cron-expressie (5 velden). */
+    cron: string;
+    /** Payload-factory per tick. */
+    payload?: () => unknown | Promise<unknown>;
+    /** Idempotency-key per geplande tick (multi-instance exactly-once). */
+    idempotencyKey?: (scheduledMs: number) => string;
+    maxAttempts?: number;
+}
+export interface SchedulerOptions {
+    clock?: Clock;
+    tzOffsetMinutes?: number;
+    /** Poll-interval van de interne timer. Default 1000. */
+    tickIntervalMs?: number;
+    /** Multi-instance-guard: `true` als deze instance de tick mag enqueuen. */
+    tryLock?: (key: string, ttlMs: number) => Promise<boolean>;
+    lockTtlMs?: number;
+}
+export interface Scheduler {
+    start(): void;
+    stop(): Promise<void>;
+    /** Verwerk alle op `nowMs` verschuldigde definities (voor deterministische tests). */
+    tick(nowMs: number): Promise<void>;
+}
+export declare function createScheduler(queue: Queue, definitions: CronDefinition[], options?: SchedulerOptions): Scheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/backend/jobs/core/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../../backend/src/jobs/core/scheduler.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,uEAAuE;IACvE,cAAc,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAQD,wBAAgB,eAAe,CAC7B,KAAK,EAAE,KAAK,EACZ,WAAW,EAAE,cAAc,EAAE,EAC7B,OAAO,GAAE,gBAAqB,GAC7B,SAAS,CAiDX"}

package/dist/backend/jobs/core/scheduler.js

@@ -0,0 +1,53 @@
+/**
+ * US-0803 — Cron-scheduler. Enqueued terugkerende jobs op geïnjecteerde cron-schema's. In een
+ * multi-instance-omgeving zorgt een geïnjecteerde `tryLock` dat elke tick maar één keer wordt
+ * ge-enqueued. Ongeldige cron-expressies falen fail-fast bij initialisatie. Domein-loos.
+ */
+import { nextAfter, parseCron } from './cron.js';
+export function createScheduler(queue, definitions, options = {}) {
+    const clock = options.clock ?? Date.now;
+    const tz = options.tzOffsetMinutes ?? 0;
+    const lockTtlMs = options.lockTtlMs ?? 55_000;
+    // Fail-fast: parse alle cron-expressies bij initialisatie (US-0803 AC3).
+    const scheduled = definitions.map((definition) => {
+        const cron = parseCron(definition.cron);
+        return { definition, cron, nextRun: nextAfter(cron, clock(), tz) };
+    });
+    let timer;
+    async function tick(nowMs) {
+        for (const entry of scheduled) {
+            if (nowMs < entry.nextRun)
+                continue;
+            const scheduledMs = entry.nextRun;
+            entry.nextRun = nextAfter(entry.cron, nowMs, tz); // altijd vooruit, ook bij skip
+            const lockKey = `scheduler:${entry.definition.jobName}:${scheduledMs}`;
+            if (options.tryLock && !(await options.tryLock(lockKey, lockTtlMs))) {
+                continue; // een andere instance enqueued deze tick (US-0803 AC2)
+            }
+            const payload = entry.definition.payload ? await entry.definition.payload() : {};
+            await queue.enqueue(entry.definition.jobName, payload, {
+                ...(entry.definition.maxAttempts ? { maxAttempts: entry.definition.maxAttempts } : {}),
+                ...(entry.definition.idempotencyKey
+                    ? { idempotencyKey: entry.definition.idempotencyKey(scheduledMs) }
+                    : {}),
+            });
+        }
+    }
+    return {
+        start() {
+            if (timer)
+                return;
+            timer = setInterval(() => {
+                void tick(clock());
+            }, options.tickIntervalMs ?? 1000);
+        },
+        async stop() {
+            if (timer) {
+                clearInterval(timer);
+                timer = undefined;
+            }
+        },
+        tick,
+    };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/backend/jobs/core/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../../backend/src/jobs/core/scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAuB,MAAM,WAAW,CAAC;AAuCtE,MAAM,UAAU,eAAe,CAC7B,KAAY,EACZ,WAA6B,EAC7B,UAA4B,EAAE;IAE9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACxC,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC;IAE9C,yEAAyE;IACzE,MAAM,SAAS,GAAgB,WAAW,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAC5D,MAAM,IAAI,GAAG,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACxC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,IAAI,KAAiD,CAAC;IAEtD,KAAK,UAAU,IAAI,CAAC,KAAa;QAC/B,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,KAAK,GAAG,KAAK,CAAC,OAAO;gBAAE,SAAS;YACpC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC;YAClC,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,+BAA+B;YAEjF,MAAM,OAAO,GAAG,aAAa,KAAK,CAAC,UAAU,CAAC,OAAO,IAAI,WAAW,EAAE,CAAC;YACvE,IAAI,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC;gBACpE,SAAS,CAAC,uDAAuD;YACnE,CAAC;YAED,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjF,MAAM,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE;gBACrD,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtF,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,cAAc;oBACjC,CAAC,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE;oBAClE,CAAC,CAAC,EAAE,CAAC;aACR,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK;YACH,IAAI,KAAK;gBAAE,OAAO;YAClB,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,KAAK,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACrB,CAAC,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,KAAK,CAAC,IAAI;YACR,IAAI,KAAK,EAAE,CAAC;gBACV,aAAa,CAAC,KAAK,CAAC,CAAC;gBACrB,KAAK,GAAG,SAAS,CAAC;YACpB,CAAC;QACH,CAAC;QACD,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/backend/jobs/core/serializer.d.ts

@@ -0,0 +1,3 @@
+import type { Serializer } from './ports.js';
+export declare const jsonSerializer: Serializer;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/backend/jobs/core/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../../../backend/src/jobs/core/serializer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,eAAO,MAAM,cAAc,EAAE,UAG5B,CAAC"}

package/dist/backend/jobs/core/serializer.js

@@ -0,0 +1,5 @@
+export const jsonSerializer = {
+    serialize: (value) => JSON.stringify(value),
+    deserialize: (raw) => JSON.parse(raw),
+};
+//# sourceMappingURL=serializer.js.map

package/dist/backend/jobs/core/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../../../backend/src/jobs/core/serializer.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,SAAS,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;IAC3C,WAAW,EAAE,CAAI,GAAW,EAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAM;CACzD,CAAC"}

package/dist/backend/jobs/core/worker.d.ts

@@ -0,0 +1,28 @@
+/**
+ * US-0801 — Worker die geïnjecteerde handlers uitvoert, met configureerbare concurrency en graceful
+ * shutdown. US-0802 — retries met backoff en dead-letter na uitputting. US-0804 — exactly-once-effect
+ * via idempotency-keys (skip duplicaat, serialiseer gelijktijdige duplicaten, faal ⇒ geen no-op).
+ */
+import { type JobsError } from './errors.js';
+import type { BackoffPolicy, Clock, HandlerRegistry, IdempotencyStore, JobRecord, QueueStore, Serializer } from './ports.js';
+export interface WorkerOptions {
+    concurrency?: number;
+    /** Lease/visibility-timeout voor gereserveerde jobs. Default 30000. */
+    leaseMs?: number;
+    /** Poll-interval als er niets te doen is. Default 50. */
+    pollIntervalMs?: number;
+    backoff?: BackoffPolicy;
+    idempotency?: IdempotencyStore;
+    idempotencyTtlMs?: number;
+    clock?: Clock;
+    serializer?: Serializer;
+    onError?: (error: JobsError | Error, job: JobRecord) => void;
+}
+export interface Worker {
+    start(): void;
+    stop(): Promise<void>;
+    /** Verwerk hooguit één beschikbare job. Retourneert `true` als er een job verwerkt is. */
+    runOnce(): Promise<boolean>;
+}
+export declare function createWorker(store: QueueStore, registry: HandlerRegistry, options?: WorkerOptions): Worker;
+//# sourceMappingURL=worker.d.ts.map

package/dist/backend/jobs/core/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../../backend/src/jobs/core/worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAgC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAC3E,OAAO,KAAK,EACV,aAAa,EACb,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,UAAU,EACX,MAAM,YAAY,CAAC;AAIpB,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;CAC9D;AAED,MAAM,WAAW,MAAM;IACrB,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,0FAA0F;IAC1F,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC7B;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAmGR"}

package/dist/backend/jobs/core/worker.js

@@ -0,0 +1,118 @@
+/**
+ * US-0801 — Worker die geïnjecteerde handlers uitvoert, met configureerbare concurrency en graceful
+ * shutdown. US-0802 — retries met backoff en dead-letter na uitputting. US-0804 — exactly-once-effect
+ * via idempotency-keys (skip duplicaat, serialiseer gelijktijdige duplicaten, faal ⇒ geen no-op).
+ */
+import { NoHandlerError, redactReason } from './errors.js';
+import { jsonSerializer } from './serializer.js';
+import { fixedBackoff } from './backoff.js';
+export function createWorker(store, registry, options = {}) {
+    const concurrency = options.concurrency ?? 1;
+    const leaseMs = options.leaseMs ?? 30_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 50;
+    const backoff = options.backoff ?? fixedBackoff(1000);
+    const serializer = options.serializer ?? jsonSerializer;
+    const clock = options.clock ?? Date.now;
+    const idempotency = options.idempotency;
+    const idempotencyTtlMs = options.idempotencyTtlMs ?? 24 * 60 * 60 * 1000;
+    const inFlight = new Set();
+    let running = false;
+    let loopDone;
+    async function processJob(job) {
+        const handler = registry.get(job.name);
+        if (!handler) {
+            // Onbekende handler: niet stil verwijderen, maar naar dead-letter (US-0801 AC3).
+            const error = new NoHandlerError(job.name);
+            await store.deadLetter(withFailure(job, job.attempts + 1, error.message, clock()));
+            options.onError?.(error, job);
+            return;
+        }
+        const key = job.idempotencyKey;
+        let idemLock = null;
+        if (key && idempotency) {
+            if (await idempotency.isProcessed(key)) {
+                await store.complete(job.id); // reeds verwerkt: no-op (US-0804 AC1)
+                return;
+            }
+            idemLock = await idempotency.acquire(key, leaseMs); // lock alleen tijdens verwerking
+            if (!idemLock) {
+                // Een ander verwerkt dezelfde key: later opnieuw proberen (US-0804 AC2).
+                await store.reschedule({ ...job, availableAt: clock() + pollIntervalMs * 2 });
+                return;
+            }
+        }
+        try {
+            await handler(serializer.deserialize(job.payload), {
+                jobId: job.id,
+                jobName: job.name,
+                attempt: job.attempts + 1,
+            });
+            if (key && idempotency)
+                await idempotency.markProcessed(key, idempotencyTtlMs);
+            await store.complete(job.id);
+        }
+        catch (error) {
+            // Key NIET markeren: retry blijft mogelijk (US-0804 AC3).
+            const attempts = job.attempts + 1;
+            const failed = withFailure(job, attempts, redactReason(error), clock());
+            if (attempts < job.maxAttempts) {
+                failed.availableAt = clock() + backoff.computeDelayMs(attempts);
+                await store.reschedule(failed); // US-0802 AC1
+            }
+            else {
+                await store.deadLetter(failed); // US-0802 AC2
+            }
+            options.onError?.(error, job);
+        }
+        finally {
+            await idemLock?.release();
+        }
+    }
+    async function runOnce() {
+        const job = await store.reserve(clock(), leaseMs);
+        if (!job)
+            return false;
+        await processJob(job);
+        return true;
+    }
+    async function loop() {
+        while (running) {
+            if (inFlight.size < concurrency) {
+                const job = await store.reserve(clock(), leaseMs);
+                if (job) {
+                    const promise = processJob(job).catch(() => undefined);
+                    const tracked = promise.finally(() => inFlight.delete(tracked));
+                    inFlight.add(tracked);
+                    continue;
+                }
+            }
+            await delay(pollIntervalMs);
+        }
+    }
+    return {
+        start() {
+            if (running)
+                return;
+            running = true;
+            loopDone = loop();
+        },
+        async stop() {
+            running = false;
+            await loopDone; // stop met reserveren
+            await Promise.all([...inFlight]); // laat lopende jobs afronden (US-0801 AC2)
+        },
+        runOnce,
+    };
+}
+function withFailure(job, attempt, reason, at) {
+    return {
+        ...job,
+        attempts: attempt,
+        lastError: reason,
+        history: [...(job.history ?? []), { attempt, error: reason, at }],
+    };
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=worker.js.map

package/dist/backend/jobs/core/worker.js.map

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

package/dist/backend/jobs/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `jobs` kit — domein-loos async werk: enqueue + worker (concurrency, graceful shutdown), retries met
+ * backoff + dead-letter, cron-scheduler en idempotency-keys. Pluggable queue-store (in-memory + Redis);
+ * job-handlers, beleid en schema's worden geïnjecteerd.
+ */
+export { createQueue, type Queue, type EnqueueOptions, type QueueOptions } from './core/queue.js';
+export { createWorker, type Worker, type WorkerOptions } from './core/worker.js';
+export { createRegistry } from './core/registry.js';
+export { exponentialBackoff, fixedBackoff, type ExponentialBackoffOptions, } from './core/backoff.js';
+export { parseCron, nextAfter, type CronExpression } from './core/cron.js';
+export { createScheduler, type Scheduler, type SchedulerOptions, type CronDefinition, } from './core/scheduler.js';
+export { jsonSerializer } from './core/serializer.js';
+export type { Clock, JobRecord, QueueStore, QueueStats, JobContext, JobHandler, HandlerRegistry, BackoffPolicy, IdempotencyStore, IdempotencyLock, Serializer, } from './core/ports.js';
+export { JobsError, NoHandlerError, CronParseError } from './core/errors.js';
+export { inMemoryQueueStore } from './adapters/in-memory-queue-store.js';
+export { inMemoryIdempotencyStore } from './adapters/in-memory-idempotency.js';
+export { redisQueueStore, type RedisJobsClient, type RedisQueueStoreOptions, } from './adapters/redis-queue-store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../backend/src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,KAAK,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EACL,kBAAkB,EAClB,YAAY,EACZ,KAAK,yBAAyB,GAC/B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EACL,eAAe,EACf,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EACV,KAAK,EACL,SAAS,EACT,UAAU,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,UAAU,GACX,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC"}

package/dist/backend/jobs/index.js

@@ -0,0 +1,23 @@
+/**
+ * `jobs` kit — domein-loos async werk: enqueue + worker (concurrency, graceful shutdown), retries met
+ * backoff + dead-letter, cron-scheduler en idempotency-keys. Pluggable queue-store (in-memory + Redis);
+ * job-handlers, beleid en schema's worden geïnjecteerd.
+ */
+// Queue + worker (US-0801)
+export { createQueue } from './core/queue.js';
+export { createWorker } from './core/worker.js';
+export { createRegistry } from './core/registry.js';
+// Retries/backoff (US-0802)
+export { exponentialBackoff, fixedBackoff, } from './core/backoff.js';
+// Cron-scheduler (US-0803)
+export { parseCron, nextAfter } from './core/cron.js';
+export { createScheduler, } from './core/scheduler.js';
+// Serializer
+export { jsonSerializer } from './core/serializer.js';
+// Fouten
+export { JobsError, NoHandlerError, CronParseError } from './core/errors.js';
+// Adapters (dep-vrij; Redis-adapter gebruikt een structurele client)
+export { inMemoryQueueStore } from './adapters/in-memory-queue-store.js';
+export { inMemoryIdempotencyStore } from './adapters/in-memory-idempotency.js';
+export { redisQueueStore, } from './adapters/redis-queue-store.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../backend/src/jobs/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,2BAA2B;AAC3B,OAAO,EAAE,WAAW,EAAsD,MAAM,iBAAiB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAmC,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,4BAA4B;AAC5B,OAAO,EACL,kBAAkB,EAClB,YAAY,GAEb,MAAM,mBAAmB,CAAC;AAE3B,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAuB,MAAM,gBAAgB,CAAC;AAC3E,OAAO,EACL,eAAe,GAIhB,MAAM,qBAAqB,CAAC;AAE7B,aAAa;AACb,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAiBtD,SAAS;AACT,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE7E,qEAAqE;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EACL,eAAe,GAGhB,MAAM,iCAAiC,CAAC"}

package/dist/backend/mailer/adapters/dev-inbox.d.ts

@@ -0,0 +1,17 @@
+import type { OutgoingMessage, Transport } from '../core/ports.js';
+export interface CapturedMessage extends OutgoingMessage {
+    messageId: string;
+    sentAt: number;
+}
+export interface DevInboxTransport extends Transport {
+    messages(): CapturedMessage[];
+    find(filter: {
+        to?: string;
+        subject?: string;
+    }): CapturedMessage[];
+    clear(): void;
+}
+export declare function devInboxTransport(options?: {
+    clock?: () => number;
+}): DevInboxTransport;
+//# sourceMappingURL=dev-inbox.d.ts.map

package/dist/backend/mailer/adapters/dev-inbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-inbox.d.ts","sourceRoot":"","sources":["../../../../backend/src/mailer/adapters/dev-inbox.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEnE,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAkB,SAAQ,SAAS;IAClD,QAAQ,IAAI,eAAe,EAAE,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,EAAE,CAAC;IACnE,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAAG,iBAAiB,CAwB3F"}

package/dist/backend/mailer/adapters/dev-inbox.js

@@ -0,0 +1,29 @@
+/**
+ * US-0901/US-0904 — Dev-inbox-transport: implementeert de {@link Transport}-poort maar levert niets
+ * extern af; elk bericht wordt in een in-memory inbox opgevangen, doorzoekbaar en leegbaar voor tests.
+ */
+import { randomUUID } from 'node:crypto';
+export function devInboxTransport(options = {}) {
+    const clock = options.clock ?? Date.now;
+    const inbox = [];
+    return {
+        name: 'dev-inbox',
+        async send(message) {
+            const messageId = randomUUID();
+            inbox.push({ ...message, messageId, sentAt: clock() });
+            return { messageId, transport: 'dev-inbox' };
+        },
+        messages: () => inbox.map((m) => ({ ...m })),
+        find: (filter) => inbox
+            .filter((m) => (filter.to === undefined || toList(m.to).includes(filter.to)) &&
+            (filter.subject === undefined || m.subject === filter.subject))
+            .map((m) => ({ ...m })),
+        clear: () => {
+            inbox.length = 0;
+        },
+    };
+}
+function toList(to) {
+    return Array.isArray(to) ? to : [to];
+}
+//# sourceMappingURL=dev-inbox.js.map

package/dist/backend/mailer/adapters/dev-inbox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-inbox.js","sourceRoot":"","sources":["../../../../backend/src/mailer/adapters/dev-inbox.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAczC,MAAM,UAAU,iBAAiB,CAAC,UAAoC,EAAE;IACtE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACxC,MAAM,KAAK,GAAsB,EAAE,CAAC;IAEpC,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,KAAK,CAAC,IAAI,CAAC,OAAO;YAChB,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC;YAC/B,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QAC/C,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC5C,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CACf,KAAK;aACF,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,MAAM,CAAC,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC7D,CAAC,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,OAAO,CAAC,CACjE;aACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,KAAK,EAAE,GAAG,EAAE;YACV,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,EAAqB;IACnC,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACvC,CAAC"}

package/dist/backend/mailer/adapters/i18n-renderer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * US-0903 — {@link MailerI18n}-adapter op de i18n-kit. Resolvet `<template>.subject/.text/.html` via de
+ * fallback-chain van de i18n-catalogus en interpoleert/pluraliseert. `null` bij een ontbrekende sleutel;
+ * een ontbrekende variabele wordt een getypeerde template-fout.
+ */
+import { type Catalogs } from '../../i18n/index.js';
+import type { MailerI18n } from '../core/ports.js';
+export declare function i18nRenderer(options: {
+    catalogs: Catalogs;
+    defaultLocale: string;
+    supportedLocales?: string[];
+}): MailerI18n;
+//# sourceMappingURL=i18n-renderer.d.ts.map

package/dist/backend/mailer/adapters/i18n-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-renderer.d.ts","sourceRoot":"","sources":["../../../../backend/src/mailer/adapters/i18n-renderer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAA0D,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE5G,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7D,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACpC,QAAQ,EAAE,QAAQ,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,GAAG,UAAU,CAgBb"}

package/dist/backend/mailer/adapters/i18n-renderer.js

@@ -0,0 +1,27 @@
+/**
+ * US-0903 — {@link MailerI18n}-adapter op de i18n-kit. Resolvet `<template>.subject/.text/.html` via de
+ * fallback-chain van de i18n-catalogus en interpoleert/pluraliseert. `null` bij een ontbrekende sleutel;
+ * een ontbrekende variabele wordt een getypeerde template-fout.
+ */
+import { buildMessage, createCatalogResolver, MissingParamError } from '../../i18n/index.js';
+import { MailerTemplateError } from '../core/errors.js';
+export function i18nRenderer(options) {
+    const resolver = createCatalogResolver(options);
+    return {
+        resolve(locale, key, params) {
+            const resolved = resolver.resolveKey(locale, key);
+            if (!resolved)
+                return null;
+            try {
+                return { text: buildMessage(resolved.locale, resolved.value, params), locale: resolved.locale };
+            }
+            catch (error) {
+                if (error instanceof MissingParamError) {
+                    throw new MailerTemplateError(`Ontbrekende variabele(n): ${error.params.join(', ')}`);
+                }
+                throw error;
+            }
+        },
+    };
+}
+//# sourceMappingURL=i18n-renderer.js.map

package/dist/backend/mailer/adapters/i18n-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-renderer.js","sourceRoot":"","sources":["../../../../backend/src/mailer/adapters/i18n-renderer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAE,iBAAiB,EAAiB,MAAM,qBAAqB,CAAC;AAC5G,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGxD,MAAM,UAAU,YAAY,CAAC,OAI5B;IACC,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,OAAO;QACL,OAAO,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM;YACzB,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAClD,IAAI,CAAC,QAAQ;gBAAE,OAAO,IAAI,CAAC;YAC3B,IAAI,CAAC;gBACH,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAkB,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;YAC9G,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,KAAK,YAAY,iBAAiB,EAAE,CAAC;oBACvC,MAAM,IAAI,mBAAmB,CAAC,6BAA6B,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACxF,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/mailer/adapters/in-memory-templates.d.ts

@@ -0,0 +1,6 @@
+/**
+ * US-0902 — {@link TemplateStore}-referentie-adapter: levert geïnjecteerde templates uit een record.
+ */
+import type { Template, TemplateStore } from '../core/ports.js';
+export declare function inMemoryTemplateStore(templates: Record<string, Template>): TemplateStore;
+//# sourceMappingURL=in-memory-templates.d.ts.map