webapp-factory 0.1.0

package/dist/jobs/core/cron.js

@@ -0,0 +1,101 @@
+/**
+ * US-0803 — Minimale cron-parser (5 velden: minuut uur dag-vd-maand maand dag-vd-week) met validatie
+ * en `nextAfter`. Ondersteunt sterretje, stappen (elke-n), bereiken (a-b, a-b-elke-n), lijsten
+ * (a,b,c) en losse waarden. Tijdzone via een vaste offset in minuten. Ongeldige expressies falen
+ * fail-fast; domein-loos.
+ */
+import { CronParseError } from './errors.js';
+const FIELDS = [
+    ['minuut', 0, 59],
+    ['uur', 0, 23],
+    ['dag-van-de-maand', 1, 31],
+    ['maand', 1, 12],
+    ['dag-van-de-week', 0, 6],
+];
+export function parseCron(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new CronParseError(expression, 'verwacht 5 velden');
+    }
+    const parsed = parts.map((field, i) => {
+        const [name, min, max] = FIELDS[i];
+        return parseField(field, min, max, expression, name);
+    });
+    return {
+        minutes: parsed[0].values,
+        hours: parsed[1].values,
+        daysOfMonth: parsed[2].values,
+        months: parsed[3].values,
+        daysOfWeek: parsed[4].values,
+        domRestricted: parsed[2].restricted,
+        dowRestricted: parsed[4].restricted,
+    };
+}
+function parseField(field, min, max, expression, name) {
+    const values = new Set();
+    // Voor de dom/dow-OR-regel: het veld beperkt de dag alleen als het niet `*` is.
+    const restricted = field.trim() !== '*';
+    for (const part of field.split(',')) {
+        const [rangePart, stepPart] = part.split('/');
+        const step = stepPart === undefined ? 1 : toInt(stepPart, expression, name);
+        if (step <= 0)
+            throw new CronParseError(expression, `ongeldige stap in "${name}"`);
+        let start = min;
+        let end = max;
+        if (rangePart !== '*') {
+            const bounds = (rangePart ?? '').split('-');
+            start = toInt(bounds[0], expression, name);
+            end = bounds[1] !== undefined ? toInt(bounds[1], expression, name) : start;
+        }
+        if (start < min || end > max || start > end) {
+            throw new CronParseError(expression, `waarde buiten bereik in "${name}" (${min}-${max})`);
+        }
+        for (let v = start; v <= end; v += step)
+            values.add(normalizeDow(v, name, max));
+    }
+    return { values, restricted };
+}
+function normalizeDow(value, name, max) {
+    // Sta 7 = zondag toe voor dag-van-de-week (0-6).
+    if (name === 'dag-van-de-week' && value === 7)
+        return 0;
+    return value > max ? max : value;
+}
+function toInt(raw, expression, name) {
+    const n = Number(raw);
+    if (!Number.isInteger(n))
+        throw new CronParseError(expression, `niet-numerieke waarde in "${name}"`);
+    return n;
+}
+/** Volgende matchende tijdstip (ms epoch) strikt ná `fromMs`. */
+export function nextAfter(cron, fromMs, tzOffsetMinutes = 0) {
+    const offset = tzOffsetMinutes * 60_000;
+    const t = new Date(fromMs + offset);
+    t.setUTCSeconds(0, 0);
+    t.setUTCMinutes(t.getUTCMinutes() + 1);
+    const limit = 366 * 24 * 60 * 4; // ~4 jaar aan minuten
+    for (let i = 0; i < limit; i++) {
+        if (matches(cron, t))
+            return t.getTime() - offset;
+        t.setUTCMinutes(t.getUTCMinutes() + 1);
+    }
+    throw new CronParseError('(runtime)', 'geen volgende tijd gevonden binnen de horizon');
+}
+function matches(cron, date) {
+    if (!cron.minutes.has(date.getUTCMinutes()))
+        return false;
+    if (!cron.hours.has(date.getUTCHours()))
+        return false;
+    if (!cron.months.has(date.getUTCMonth() + 1))
+        return false;
+    const domOk = cron.daysOfMonth.has(date.getUTCDate());
+    const dowOk = cron.daysOfWeek.has(date.getUTCDay());
+    if (cron.domRestricted && cron.dowRestricted)
+        return domOk || dowOk;
+    if (cron.domRestricted)
+        return domOk;
+    if (cron.dowRestricted)
+        return dowOk;
+    return true;
+}
+//# sourceMappingURL=cron.js.map

package/dist/jobs/core/cron.js.map

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

package/dist/jobs/core/errors.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Foutentaxonomie voor jobs-kit. Fouten lekken geen job-payloads of secrets.
+ */
+export declare class JobsError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/** Geen handler geregistreerd voor de job-naam (US-0801 AC3). */
+export declare class NoHandlerError extends JobsError {
+    constructor(jobName: string);
+}
+/** Ongeldige cron-expressie (US-0803 AC3). */
+export declare class CronParseError extends JobsError {
+    constructor(expression: string, reason: string);
+}
+/** Redigeert een reden zodat er geen payload/secret in een fout/log belandt. */
+export declare function redactReason(input: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

package/dist/jobs/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/jobs/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,SAAU,SAAQ,KAAK;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM1C;AAED,iEAAiE;AACjE,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,OAAO,EAAE,MAAM;CAG5B;AAED,8CAA8C;AAC9C,qBAAa,cAAe,SAAQ,SAAS;gBAC/B,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAG/C;AAED,gFAAgF;AAChF,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGnD"}

package/dist/jobs/core/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Foutentaxonomie voor jobs-kit. Fouten lekken geen job-payloads of secrets.
+ */
+export class JobsError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Geen handler geregistreerd voor de job-naam (US-0801 AC3). */
+export class NoHandlerError extends JobsError {
+    constructor(jobName) {
+        super(`Geen handler geregistreerd voor job "${jobName}"`, 'NO_HANDLER');
+    }
+}
+/** Ongeldige cron-expressie (US-0803 AC3). */
+export class CronParseError extends JobsError {
+    constructor(expression, reason) {
+        super(`Ongeldige cron-expressie "${expression}": ${reason}`, 'CRON_PARSE');
+    }
+}
+/** Redigeert een reden zodat er geen payload/secret in een fout/log belandt. */
+export function redactReason(input) {
+    const text = input instanceof Error ? input.message : String(input);
+    return text.replace(/(password|pwd|token|secret)\s*[=:]\s*[^\s;,&]+/gi, '$1=***');
+}
+//# sourceMappingURL=errors.js.map

package/dist/jobs/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/jobs/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,SAAU,SAAQ,KAAK;IACzB,IAAI,CAAS;IACtB,YAAY,OAAe,EAAE,IAAY;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAED,iEAAiE;AACjE,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,YAAY,OAAe;QACzB,KAAK,CAAC,wCAAwC,OAAO,GAAG,EAAE,YAAY,CAAC,CAAC;IAC1E,CAAC;CACF;AAED,8CAA8C;AAC9C,MAAM,OAAO,cAAe,SAAQ,SAAS;IAC3C,YAAY,UAAkB,EAAE,MAAc;QAC5C,KAAK,CAAC,6BAA6B,UAAU,MAAM,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;IAC7E,CAAC;CACF;AAED,gFAAgF;AAChF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,IAAI,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpE,OAAO,IAAI,CAAC,OAAO,CAAC,kDAAkD,EAAE,QAAQ,CAAC,CAAC;AACpF,CAAC"}

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

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

package/dist/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/jobs/core/ports.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","sourceRoot":"","sources":["../../../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/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/jobs/core/registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../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/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/jobs/core/scheduler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../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/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/jobs/core/serializer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../../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/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/jobs/core/worker.d.ts.map

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

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