webapp-factory 0.1.0

package/dist/rate-limit/core/enforcer.js

@@ -0,0 +1,27 @@
+export async function enforceRateLimit(key, options) {
+    try {
+        const result = await options.limiter.consume(key, options.cost);
+        const headers = rateLimitHeaders(result);
+        if (result.allowed) {
+            return { allowed: true, status: 200, headers, result };
+        }
+        headers['Retry-After'] = String(Math.max(1, Math.ceil(result.retryAfterMs / 1000)));
+        return { allowed: false, status: 429, headers, result };
+    }
+    catch {
+        // Store onbereikbaar → fail-beleid (geen details lekken).
+        if ((options.failPolicy ?? 'closed') === 'open') {
+            return { allowed: true, status: 200, headers: {} };
+        }
+        return { allowed: false, status: 503, headers: { 'Retry-After': '1' } };
+    }
+}
+/** Bouwt de informatieve `X-RateLimit-*`-headers uit een resultaat. */
+export function rateLimitHeaders(result) {
+    return {
+        'X-RateLimit-Limit': String(result.limit),
+        'X-RateLimit-Remaining': String(Math.max(0, result.remaining)),
+        'X-RateLimit-Reset': String(Math.max(0, Math.ceil(result.resetMs / 1000))),
+    };
+}
+//# sourceMappingURL=enforcer.js.map

package/dist/rate-limit/core/enforcer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enforcer.js","sourceRoot":"","sources":["../../../src/rate-limit/core/enforcer.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAuB;IACzE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAChE,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;QAC1D,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC,KAAK,MAAM,EAAE,CAAC;YAChD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QACrD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,gBAAgB,CAAC,MAAuB;IACtD,OAAO;QACL,mBAAmB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QACzC,uBAAuB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;QAC9D,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC;KAC3E,CAAC;AACJ,CAAC"}

package/dist/rate-limit/core/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Foutentaxonomie voor rate-limit. Config-fouten benoemen de ongeldige waarde; store-fouten lekken
+ * nooit een connectiestring of secret.
+ */
+export declare class RateLimitError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/** Ongeldige/ontbrekende limiet-config (US-0601/US-0602 AC3). Faalt fail-fast, nooit "onbeperkt". */
+export declare class RateLimitConfigError extends RateLimitError {
+    constructor(field: string, value: unknown);
+}
+/** Store tijdelijk onbereikbaar (US-0603/US-0604 AC3). Bevat geen connectie-/secret-details. */
+export declare class StoreUnavailableError extends RateLimitError {
+    constructor();
+}
+/** Bewaakt dat een numerieke config-waarde positief is; gooit anders {@link RateLimitConfigError}. */
+export declare function assertPositive(field: string, value: number): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/rate-limit/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/rate-limit/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAM1C;AAED,qGAAqG;AACrG,qBAAa,oBAAqB,SAAQ,cAAc;gBAC1C,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO;CAG1C;AAED,gGAAgG;AAChG,qBAAa,qBAAsB,SAAQ,cAAc;;CAIxD;AAED,sGAAsG;AACtG,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIjE"}

package/dist/rate-limit/core/errors.js

@@ -0,0 +1,32 @@
+/**
+ * Foutentaxonomie voor rate-limit. Config-fouten benoemen de ongeldige waarde; store-fouten lekken
+ * nooit een connectiestring of secret.
+ */
+export class RateLimitError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** Ongeldige/ontbrekende limiet-config (US-0601/US-0602 AC3). Faalt fail-fast, nooit "onbeperkt". */
+export class RateLimitConfigError extends RateLimitError {
+    constructor(field, value) {
+        super(`Ongeldige rate-limit-config: "${field}" moet positief zijn (kreeg ${String(value)})`, 'RATE_LIMIT_CONFIG');
+    }
+}
+/** Store tijdelijk onbereikbaar (US-0603/US-0604 AC3). Bevat geen connectie-/secret-details. */
+export class StoreUnavailableError extends RateLimitError {
+    constructor() {
+        super('Rate-limit-store is niet bereikbaar', 'STORE_UNAVAILABLE');
+    }
+}
+/** Bewaakt dat een numerieke config-waarde positief is; gooit anders {@link RateLimitConfigError}. */
+export function assertPositive(field, value) {
+    if (typeof value !== 'number' || !Number.isFinite(value) || value <= 0) {
+        throw new RateLimitConfigError(field, value);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/rate-limit/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/rate-limit/core/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,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,qGAAqG;AACrG,MAAM,OAAO,oBAAqB,SAAQ,cAAc;IACtD,YAAY,KAAa,EAAE,KAAc;QACvC,KAAK,CAAC,iCAAiC,KAAK,+BAA+B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACpH,CAAC;CACF;AAED,gGAAgG;AAChG,MAAM,OAAO,qBAAsB,SAAQ,cAAc;IACvD;QACE,KAAK,CAAC,qCAAqC,EAAE,mBAAmB,CAAC,CAAC;IACpE,CAAC;CACF;AAED,sGAAsG;AACtG,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,KAAa;IACzD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QACvE,MAAM,IAAI,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/dist/rate-limit/core/ports.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Poorten & types voor de rate-limit-kit. Limieten per route, de store-adapter en de sleutel-afleiding
+ * worden geïnjecteerd; de kit bevat geen domeinkennis.
+ */
+export type Clock = () => number;
+/** Uitkomst van een rate-limit-evaluatie. */
+export interface RateLimitResult {
+    allowed: boolean;
+    limit: number;
+    /** Resterende capaciteit/requests (afgerond naar beneden). */
+    remaining: number;
+    /** ms tot de teller reset / de bucket weer vol is. */
+    resetMs: number;
+    /** ms tot de volgende request is toegestaan (0 als toegestaan). */
+    retryAfterMs: number;
+}
+/** Resultaat van een atomaire store-operatie (zonder `limit`; de limiter vult die aan). */
+export interface StoreResult {
+    allowed: boolean;
+    remaining: number;
+    resetMs: number;
+    retryAfterMs: number;
+}
+export interface TokenBucketParams {
+    capacity: number;
+    /** Tokens die per milliseconde worden bijgevuld. */
+    refillPerMs: number;
+    cost: number;
+    nowMs: number;
+}
+export interface SlidingWindowParams {
+    limit: number;
+    windowMs: number;
+    cost: number;
+    nowMs: number;
+}
+/**
+ * Store-abstractie (US-0603): voert de atomaire teller-/bucket-operaties uit. Adapters: in-memory
+ * (single-instance) en Redis (gedistribueerd, atomair via Lua).
+ */
+export interface RateLimitStore {
+    consumeTokenBucket(key: string, params: TokenBucketParams): Promise<StoreResult>;
+    consumeSlidingWindow(key: string, params: SlidingWindowParams): Promise<StoreResult>;
+}
+/** Een geconfigureerde limiter over een store; deelbaar over algoritmen (US-0601/US-0602). */
+export interface RateLimiter {
+    readonly limit: number;
+    consume(key: string, cost?: number): Promise<RateLimitResult>;
+}
+//# sourceMappingURL=ports.d.ts.map

package/dist/rate-limit/core/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../../src/rate-limit/core/ports.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC;AAEjC,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,2FAA2F;AAC3F,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACjF,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACtF;AAED,8FAA8F;AAC9F,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC/D"}

package/dist/rate-limit/core/ports.js

@@ -0,0 +1,6 @@
+/**
+ * Poorten & types voor de rate-limit-kit. Limieten per route, de store-adapter en de sleutel-afleiding
+ * worden geïnjecteerd; de kit bevat geen domeinkennis.
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/rate-limit/core/ports.js.map

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

package/dist/rate-limit/core/sliding-window.d.ts

@@ -0,0 +1,9 @@
+import type { Clock, RateLimitStore, RateLimiter } from './ports.js';
+export interface SlidingWindowConfig {
+    /** Maximaal aantal requests binnen het venster. */
+    limit: number;
+    /** Venstergrootte in seconden. */
+    windowSeconds: number;
+}
+export declare function slidingWindowLimiter(config: SlidingWindowConfig, store: RateLimitStore, clock?: Clock): RateLimiter;
+//# sourceMappingURL=sliding-window.d.ts.map

package/dist/rate-limit/core/sliding-window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliding-window.d.ts","sourceRoot":"","sources":["../../../src/rate-limit/core/sliding-window.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,cAAc,EACrB,KAAK,GAAE,KAAgB,GACtB,WAAW,CAiBb"}

package/dist/rate-limit/core/sliding-window.js

@@ -0,0 +1,24 @@
+/**
+ * US-0602 — Sliding-window-limiter (voortschrijdend venster via gewogen teller). Vermijdt de
+ * grens-burst van een vast venster. Config-validatie fail-fast; atomaire telling via de
+ * {@link RateLimitStore}-poort — dezelfde store-abstractie als token-bucket.
+ */
+import { assertPositive } from './errors.js';
+export function slidingWindowLimiter(config, store, clock = Date.now) {
+    assertPositive('limit', config.limit);
+    assertPositive('windowSeconds', config.windowSeconds);
+    const windowMs = config.windowSeconds * 1000;
+    return {
+        limit: config.limit,
+        async consume(key, cost = 1) {
+            const result = await store.consumeSlidingWindow(key, {
+                limit: config.limit,
+                windowMs,
+                cost,
+                nowMs: clock(),
+            });
+            return { ...result, limit: config.limit };
+        },
+    };
+}
+//# sourceMappingURL=sliding-window.js.map

package/dist/rate-limit/core/sliding-window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sliding-window.js","sourceRoot":"","sources":["../../../src/rate-limit/core/sliding-window.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAU7C,MAAM,UAAU,oBAAoB,CAClC,MAA2B,EAC3B,KAAqB,EACrB,QAAe,IAAI,CAAC,GAAG;IAEvB,cAAc,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IACtC,cAAc,CAAC,eAAe,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;IAE7C,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,oBAAoB,CAAC,GAAG,EAAE;gBACnD,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,QAAQ;gBACR,IAAI;gBACJ,KAAK,EAAE,KAAK,EAAE;aACf,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/rate-limit/core/token-bucket.d.ts

@@ -0,0 +1,9 @@
+import type { Clock, RateLimitStore, RateLimiter } from './ports.js';
+export interface TokenBucketConfig {
+    /** Maximale burst-capaciteit (tokens). */
+    capacity: number;
+    /** Bijvul-rate in tokens per seconde. */
+    refillPerSecond: number;
+}
+export declare function tokenBucketLimiter(config: TokenBucketConfig, store: RateLimitStore, clock?: Clock): RateLimiter;
+//# sourceMappingURL=token-bucket.d.ts.map

package/dist/rate-limit/core/token-bucket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.d.ts","sourceRoot":"","sources":["../../../src/rate-limit/core/token-bucket.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,cAAc,EACrB,KAAK,GAAE,KAAgB,GACtB,WAAW,CAiBb"}

package/dist/rate-limit/core/token-bucket.js

@@ -0,0 +1,24 @@
+/**
+ * US-0601 — Token-bucket-limiter. Per sleutel een bucket met burst-capaciteit die met een
+ * configureerbare rate wordt bijgevuld. Config-validatie fail-fast (nooit stil terugvallen op
+ * "onbeperkt toestaan"); de atomaire state loopt via de {@link RateLimitStore}-poort.
+ */
+import { assertPositive } from './errors.js';
+export function tokenBucketLimiter(config, store, clock = Date.now) {
+    assertPositive('capacity', config.capacity);
+    assertPositive('refillPerSecond', config.refillPerSecond);
+    const refillPerMs = config.refillPerSecond / 1000;
+    return {
+        limit: config.capacity,
+        async consume(key, cost = 1) {
+            const result = await store.consumeTokenBucket(key, {
+                capacity: config.capacity,
+                refillPerMs,
+                cost,
+                nowMs: clock(),
+            });
+            return { ...result, limit: config.capacity };
+        },
+    };
+}
+//# sourceMappingURL=token-bucket.js.map

package/dist/rate-limit/core/token-bucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-bucket.js","sourceRoot":"","sources":["../../../src/rate-limit/core/token-bucket.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAU7C,MAAM,UAAU,kBAAkB,CAChC,MAAyB,EACzB,KAAqB,EACrB,QAAe,IAAI,CAAC,GAAG;IAEvB,cAAc,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5C,cAAc,CAAC,iBAAiB,EAAE,MAAM,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC;IAElD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,QAAQ;QACtB,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC;YACzB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,kBAAkB,CAAC,GAAG,EAAE;gBACjD,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW;gBACX,IAAI;gBACJ,KAAK,EAAE,KAAK,EAAE;aACf,CAAC,CAAC;YACH,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/rate-limit/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `rate-limit` kit — domein-loze throttling: token-bucket + sliding-window over een pluggable atomaire
+ * store (in-memory + Redis), met enforcement-middleware en standaard-headers. Pure core + adapters.
+ *
+ * De NestJS-guard zit onder `webapp-factory/backend-foundation/rate-limit/nestjs`.
+ */
+export { tokenBucketLimiter, type TokenBucketConfig } from './core/token-bucket.js';
+export { slidingWindowLimiter, type SlidingWindowConfig } from './core/sliding-window.js';
+export { enforceRateLimit, rateLimitHeaders, type RateLimitDecision, type EnforceOptions, } from './core/enforcer.js';
+export type { Clock, RateLimiter, RateLimitResult, RateLimitStore, StoreResult, TokenBucketParams, SlidingWindowParams, } from './core/ports.js';
+export { RateLimitError, RateLimitConfigError, StoreUnavailableError, } from './core/errors.js';
+export { inMemoryRateLimitStore } from './adapters/in-memory-store.js';
+export { redisRateLimitStore, type RedisLike, type RedisRateLimitStoreOptions, } from './adapters/redis-store.js';
+export { rateLimitMiddleware, type RateLimitMiddlewareOptions } from './nodejs/middleware.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/rate-limit/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/rate-limit/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG1F,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,GACpB,MAAM,oBAAoB,CAAC;AAG5B,YAAY,EACV,KAAK,EACL,WAAW,EACX,eAAe,EACf,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,0BAA0B,GAChC,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EAAE,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/rate-limit/index.js

@@ -0,0 +1,19 @@
+/**
+ * `rate-limit` kit — domein-loze throttling: token-bucket + sliding-window over een pluggable atomaire
+ * store (in-memory + Redis), met enforcement-middleware en standaard-headers. Pure core + adapters.
+ *
+ * De NestJS-guard zit onder `webapp-factory/backend-foundation/rate-limit/nestjs`.
+ */
+// Algoritmen (US-0601/US-0602)
+export { tokenBucketLimiter } from './core/token-bucket.js';
+export { slidingWindowLimiter } from './core/sliding-window.js';
+// Enforcement + headers (US-0604)
+export { enforceRateLimit, rateLimitHeaders, } from './core/enforcer.js';
+// Fouten
+export { RateLimitError, RateLimitConfigError, StoreUnavailableError, } from './core/errors.js';
+// Adapters (dep-vrij; de Redis-store gebruikt een structurele `RedisLike`-client)
+export { inMemoryRateLimitStore } from './adapters/in-memory-store.js';
+export { redisRateLimitStore, } from './adapters/redis-store.js';
+// Node/express-middleware (US-0604)
+export { rateLimitMiddleware } from './nodejs/middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/rate-limit/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rate-limit/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,OAAO,EAAE,kBAAkB,EAA0B,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAA4B,MAAM,0BAA0B,CAAC;AAE1F,kCAAkC;AAClC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC;AAa5B,SAAS;AACT,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAE1B,kFAAkF;AAClF,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EACL,mBAAmB,GAGpB,MAAM,2BAA2B,CAAC;AAEnC,oCAAoC;AACpC,OAAO,EAAE,mBAAmB,EAAmC,MAAM,wBAAwB,CAAC"}

package/dist/rate-limit/nestjs/rate-limit.module.d.ts

@@ -0,0 +1,25 @@
+/**
+ * NestJS-adapter voor US-0604: een `RateLimitGuard` die per request de limiter evalueert, de
+ * `X-RateLimit-*`-headers zet en bij weigering een `429` (met `Retry-After`) gooit. De pure
+ * enforcement-logica zit in de core. `@nestjs/common` is een optionele peer-dependency.
+ */
+import { type CanActivate, type DynamicModule, type ExecutionContext } from '@nestjs/common';
+import type { RateLimiter } from '../core/ports.js';
+export declare const RATE_LIMIT_OPTIONS: unique symbol;
+export interface RateLimitGuardOptions {
+    limiter: RateLimiter;
+    /** Leidt de sleutel af uit het request (bv. IP of user-id). */
+    getKey: (request: unknown) => string;
+    failPolicy?: 'open' | 'closed';
+    cost?: number;
+    global?: boolean;
+}
+export declare class RateLimitGuard implements CanActivate {
+    private readonly options;
+    constructor(options: RateLimitGuardOptions);
+    canActivate(context: ExecutionContext): Promise<boolean>;
+}
+export declare class RateLimitModule {
+    static forRoot(options: RateLimitGuardOptions): DynamicModule;
+}
+//# sourceMappingURL=rate-limit.module.d.ts.map

package/dist/rate-limit/nestjs/rate-limit.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.module.d.ts","sourceRoot":"","sources":["../../../src/rate-limit/nestjs/rate-limit.module.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,eAAO,MAAM,kBAAkB,eAAmC,CAAC;AAMnE,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,WAAW,CAAC;IACrB,+DAA+D;IAC/D,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,MAAM,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,qBACa,cAAe,YAAW,WAAW;IACR,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,qBAAqB;IAEjF,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;CAsB/D;AAED,qBAAa,eAAe;IAC1B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,aAAa;CAY9D"}

package/dist/rate-limit/nestjs/rate-limit.module.js

@@ -0,0 +1,63 @@
+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 voor US-0604: een `RateLimitGuard` die per request de limiter evalueert, de
+ * `X-RateLimit-*`-headers zet en bij weigering een `429` (met `Retry-After`) gooit. De pure
+ * enforcement-logica zit in de core. `@nestjs/common` is een optionele peer-dependency.
+ */
+import { HttpException, Inject, Injectable, } from '@nestjs/common';
+import { enforceRateLimit } from '../core/enforcer.js';
+export const RATE_LIMIT_OPTIONS = Symbol.for('rate-limit.options');
+let RateLimitGuard = class RateLimitGuard {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async canActivate(context) {
+        const request = context.switchToHttp().getRequest();
+        const response = context.switchToHttp().getResponse();
+        const decision = await enforceRateLimit(this.options.getKey(request), {
+            limiter: this.options.limiter,
+            ...(this.options.failPolicy ? { failPolicy: this.options.failPolicy } : {}),
+            ...(this.options.cost !== undefined ? { cost: this.options.cost } : {}),
+        });
+        for (const [header, value] of Object.entries(decision.headers)) {
+            response.header(header, value);
+        }
+        if (!decision.allowed) {
+            throw new HttpException({ error: { code: 'RATE_LIMITED', message: 'Too Many Requests' } }, decision.status);
+        }
+        return true;
+    }
+};
+RateLimitGuard = __decorate([
+    Injectable(),
+    __param(0, Inject(RATE_LIMIT_OPTIONS)),
+    __metadata("design:paramtypes", [Object])
+], RateLimitGuard);
+export { RateLimitGuard };
+export class RateLimitModule {
+    static forRoot(options) {
+        const providers = [
+            { provide: RATE_LIMIT_OPTIONS, useValue: options },
+            RateLimitGuard,
+        ];
+        return {
+            module: RateLimitModule,
+            global: options.global ?? true,
+            providers,
+            exports: [RateLimitGuard, RATE_LIMIT_OPTIONS],
+        };
+    }
+}
+//# sourceMappingURL=rate-limit.module.js.map

package/dist/rate-limit/nestjs/rate-limit.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.module.js","sourceRoot":"","sources":["../../../src/rate-limit/nestjs/rate-limit.module.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA;;;;GAIG;AACH,OAAO,EACL,aAAa,EACb,MAAM,EACN,UAAU,GAKX,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAgB5D,IAAM,cAAc,GAApB,MAAM,cAAc;IACgC;IAAzD,YAAyD,OAA8B;QAA9B,YAAO,GAAP,OAAO,CAAuB;IAAG,CAAC;IAE3F,KAAK,CAAC,WAAW,CAAC,OAAyB;QACzC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAW,CAAC;QAC7D,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,WAAW,EAAgB,CAAC;QAEpE,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;YACpE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;YAC7B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3E,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxE,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/D,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,MAAM,IAAI,aAAa,CACrB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EACjE,QAAQ,CAAC,MAAM,CAChB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AAzBY,cAAc;IAD1B,UAAU,EAAE;IAEE,WAAA,MAAM,CAAC,kBAAkB,CAAC,CAAA;;GAD5B,cAAc,CAyB1B;;AAED,MAAM,OAAO,eAAe;IAC1B,MAAM,CAAC,OAAO,CAAC,OAA8B;QAC3C,MAAM,SAAS,GAAe;YAC5B,EAAE,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAO,EAAE;YAClD,cAAc;SACf,CAAC;QACF,OAAO;YACL,MAAM,EAAE,eAAe;YACvB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,SAAS;YACT,OAAO,EAAE,CAAC,cAAc,EAAE,kBAAkB,CAAC;SAC9C,CAAC;IACJ,CAAC;CACF"}

package/dist/rate-limit/nodejs/middleware.d.ts

@@ -0,0 +1,16 @@
+/**
+ * US-0604 — Node/connect/express-compatibele rate-limit-middleware. Bepaalt de sleutel via een
+ * callback, evalueert de limiter en zet de standaard-headers; bij weigering `429` + `Retry-After`.
+ * Werkt ook in een Nest-express-app via `app.use(...)`.
+ */
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import type { RateLimiter } from '../core/ports.js';
+export interface RateLimitMiddlewareOptions {
+    limiter: RateLimiter;
+    /** Leidt de rate-limit-sleutel af uit het request (bv. IP of user-id). */
+    keyOf: (req: IncomingMessage) => string;
+    failPolicy?: 'open' | 'closed';
+    cost?: number;
+}
+export declare function rateLimitMiddleware(options: RateLimitMiddlewareOptions): (req: IncomingMessage, res: ServerResponse, next: () => void) => Promise<void>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/rate-limit/nodejs/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../src/rate-limit/nodejs/middleware.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,WAAW,CAAC;IACrB,0EAA0E;IAC1E,KAAK,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAC;IACxC,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,IACvD,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,MAAM,IAAI,KAAG,OAAO,CAAC,IAAI,CAAC,CA2B1F"}

package/dist/rate-limit/nodejs/middleware.js

@@ -0,0 +1,26 @@
+import { enforceRateLimit } from '../core/enforcer.js';
+export function rateLimitMiddleware(options) {
+    return async (req, res, next) => {
+        const decision = await enforceRateLimit(options.keyOf(req), {
+            limiter: options.limiter,
+            ...(options.failPolicy ? { failPolicy: options.failPolicy } : {}),
+            ...(options.cost !== undefined ? { cost: options.cost } : {}),
+        });
+        for (const [header, value] of Object.entries(decision.headers)) {
+            res.setHeader(header, value);
+        }
+        if (decision.allowed) {
+            next();
+            return;
+        }
+        res.statusCode = decision.status;
+        res.setHeader('Content-Type', 'application/json');
+        res.end(JSON.stringify({
+            error: {
+                code: decision.status === 429 ? 'RATE_LIMITED' : 'STORE_UNAVAILABLE',
+                message: decision.status === 429 ? 'Too Many Requests' : 'Service Unavailable',
+            },
+        }));
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/rate-limit/nodejs/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../../../src/rate-limit/nodejs/middleware.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAWvD,MAAM,UAAU,mBAAmB,CAAC,OAAmC;IACrE,OAAO,KAAK,EAAE,GAAoB,EAAE,GAAmB,EAAE,IAAgB,EAAiB,EAAE;QAC1F,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE;YAC1D,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9D,CAAC,CAAC;QAEH,KAAK,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/D,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC/B,CAAC;QAED,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrB,IAAI,EAAE,CAAC;YACP,OAAO;QACT,CAAC;QAED,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;QACjC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QAClD,GAAG,CAAC,GAAG,CACL,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,mBAAmB;gBACpE,OAAO,EAAE,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,qBAAqB;aAC/E;SACF,CAAC,CACH,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/test-kit/adapters/infra-bootstrap.d.ts

@@ -0,0 +1,40 @@
+/**
+ * US-1401 — Testcontainers-bootstrap (Postgres/Redis). Bouwt voort op de persistence-kit-harness voor
+ * Postgres en start een wegwerp-Redis via testcontainers. Levert connectie-handles + `reset()` (schone
+ * staat tussen tests, zonder herstart) en `stop()` (gegarandeerde opruiming, ook bij een fout tijdens de
+ * bootstrap). Container-selectie/images komen uit geïnjecteerde config; geen domeinaannames.
+ *
+ * `testcontainers` wordt lui geladen; import van deze module vereist Docker pas bij `bootstrapTestInfra`.
+ */
+import { type TestDatabase } from '../../persistence/pg.js';
+import type { Migration } from '../../persistence/index.js';
+export interface PostgresInfraOptions {
+    migrations?: Migration[];
+    /** Tabellen die `reset()` leegmaakt tussen tests. */
+    managedTables?: string[];
+    image?: string;
+}
+export interface RedisInfraOptions {
+    image?: string;
+}
+export interface TestInfraOptions {
+    postgres?: PostgresInfraOptions;
+    redis?: RedisInfraOptions;
+}
+export interface RedisHandle {
+    uri: string;
+    host: string;
+    port: number;
+    /** FLUSHALL — schone staat tussen tests. */
+    reset(): Promise<void>;
+}
+export interface TestInfra {
+    postgres?: TestDatabase;
+    redis?: RedisHandle;
+    /** Zet alle ingeschakelde stores terug naar de basisstaat (US-1401 AC2). */
+    reset(): Promise<void>;
+    /** Stopt en ruimt alle containers op (US-1401 AC3). */
+    stop(): Promise<void>;
+}
+export declare function bootstrapTestInfra(options?: TestInfraOptions): Promise<TestInfra>;
+//# sourceMappingURL=infra-bootstrap.d.ts.map

package/dist/test-kit/adapters/infra-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"infra-bootstrap.d.ts","sourceRoot":"","sources":["../../../src/test-kit/adapters/infra-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAA+C,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACzG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,WAAW,oBAAoB;IACnC,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,4EAA4E;IAC5E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,uDAAuD;IACvD,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,CAAC,CAuD3F"}

package/dist/test-kit/adapters/infra-bootstrap.js

@@ -0,0 +1,64 @@
+/**
+ * US-1401 — Testcontainers-bootstrap (Postgres/Redis). Bouwt voort op de persistence-kit-harness voor
+ * Postgres en start een wegwerp-Redis via testcontainers. Levert connectie-handles + `reset()` (schone
+ * staat tussen tests, zonder herstart) en `stop()` (gegarandeerde opruiming, ook bij een fout tijdens de
+ * bootstrap). Container-selectie/images komen uit geïnjecteerde config; geen domeinaannames.
+ *
+ * `testcontainers` wordt lui geladen; import van deze module vereist Docker pas bij `bootstrapTestInfra`.
+ */
+import { startTestDatabase, postgresContainerFactory } from '../../persistence/pg.js';
+export async function bootstrapTestInfra(options = {}) {
+    const stops = [];
+    let postgres;
+    let redis;
+    try {
+        if (options.postgres) {
+            postgres = await startTestDatabase({
+                migrations: options.postgres.migrations ?? [],
+                ...(options.postgres.managedTables ? { managedTables: options.postgres.managedTables } : {}),
+                ...(options.postgres.image ? { containerFactory: postgresContainerFactory({ image: options.postgres.image }) } : {}),
+            });
+            const db = postgres;
+            stops.push(() => db.stop());
+        }
+        if (options.redis) {
+            const { GenericContainer, Wait } = await import('testcontainers');
+            const container = await new GenericContainer(options.redis.image ?? 'redis:7-alpine')
+                .withExposedPorts(6379)
+                .withWaitStrategy(Wait.forLogMessage(/Ready to accept connections/))
+                .start();
+            stops.push(async () => {
+                await container.stop();
+            });
+            const host = container.getHost();
+            const port = container.getMappedPort(6379);
+            redis = {
+                uri: `redis://${host}:${port}`,
+                host,
+                port,
+                reset: async () => {
+                    await container.exec(['redis-cli', 'FLUSHALL']);
+                },
+            };
+        }
+    }
+    catch (error) {
+        // Geen halve/lekkende containers achterlaten (AC3).
+        for (const stop of stops.reverse())
+            await stop().catch(() => undefined);
+        throw new Error(`test-kit infra-bootstrap mislukt (is de Docker-daemon bereikbaar?): ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return {
+        ...(postgres ? { postgres } : {}),
+        ...(redis ? { redis } : {}),
+        reset: async () => {
+            await postgres?.reset();
+            await redis?.reset();
+        },
+        stop: async () => {
+            for (const stop of stops.reverse())
+                await stop().catch(() => undefined);
+        },
+    };
+}
+//# sourceMappingURL=infra-bootstrap.js.map

package/dist/test-kit/adapters/infra-bootstrap.js.map

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

package/dist/test-kit/core/contract.d.ts

@@ -0,0 +1,49 @@
+/**
+ * US-1404 — Contract-test-harness. Verifieert dat een provider een geïnjecteerd contract nakomt: per
+ * interactie status + body (subset-match: extra velden toegestaan, ontbrekende/afwijkende velden falen).
+ * Afwijkingen worden precies gerapporteerd (pad + verwacht vs. werkelijk). Contracten zijn geïnjecteerde
+ * data; de provider-koppeling is een adapter (bv. de HTTP-test-client).
+ */
+export type ContractMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+export interface Contract {
+    name?: string;
+    request: {
+        method: ContractMethod;
+        path: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+        token?: string;
+    };
+    expect: {
+        status: number;
+        /** Verwachte (deel)body; extra velden in de response zijn toegestaan. */
+        body?: unknown;
+    };
+}
+export interface Deviation {
+    path: string;
+    expected: unknown;
+    actual: unknown;
+}
+export interface ContractResult {
+    name: string;
+    verified: boolean;
+    deviations: Deviation[];
+}
+export interface ContractReport {
+    verified: boolean;
+    results: ContractResult[];
+}
+/** Structureel provider-contract (de HTTP-test-client voldoet hieraan via `request`). */
+export interface ContractProvider {
+    request(method: string, path: string, options?: {
+        body?: unknown;
+        headers?: Record<string, string>;
+        token?: string;
+    }): Promise<{
+        status: number;
+        body: unknown;
+    }>;
+}
+export declare function verifyContracts(provider: ContractProvider, contracts: Contract[]): Promise<ContractReport>;
+//# sourceMappingURL=contract.d.ts.map

package/dist/test-kit/core/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/test-kit/core/contract.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,QAAQ;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE;QACP,MAAM,EAAE,cAAc,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,MAAM,EAAE,MAAM,CAAC;QACf,yEAAyE;QACzE,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,SAAS,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,yFAAyF;AACzF,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CACL,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7E,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAC/C;AAED,wBAAsB,eAAe,CACnC,QAAQ,EAAE,gBAAgB,EAC1B,SAAS,EAAE,QAAQ,EAAE,GACpB,OAAO,CAAC,cAAc,CAAC,CAoBzB"}