@ddd-ts-kit/testing 0.0.0-stage → 0.1.1

package/dist/contracts/logger-contract.d.ts

@@ -0,0 +1,14 @@
+import type { ContractRunner } from './contract-runner.js';
+import type { CreateLogger } from './logger/create-logger.js';
+export interface LoggerContractOptions {
+    readonly name: string;
+    /** Called before each test, and by the tests that need another level or a scrubbing logger. */
+    readonly createLogger: CreateLogger;
+}
+/**
+ * What every implementation of the kernel `Logger` port guarantees, the in-memory one included:
+ * entries, children, the fields of the work in progress and levels in a first suite; errors as
+ * fields and the flush in a second.
+ */
+export declare function loggerContract(runner: ContractRunner, options: LoggerContractOptions): void;
+//# sourceMappingURL=logger-contract.d.ts.map

package/dist/contracts/logger-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/logger-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAI9D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAG3F"}

package/dist/contracts/logger-contract.js

@@ -0,0 +1,12 @@
+import { LoggerEntriesSuite } from './logger/logger-entries-suite.js';
+import { LoggerShutdownSuite } from './logger/logger-shutdown-suite.js';
+/**
+ * What every implementation of the kernel `Logger` port guarantees, the in-memory one included:
+ * entries, children, the fields of the work in progress and levels in a first suite; errors as
+ * fields and the flush in a second.
+ */
+export function loggerContract(runner, options) {
+    new LoggerEntriesSuite(runner, options.createLogger).describe(`${options.name} (logger contract)`);
+    new LoggerShutdownSuite(runner, options.createLogger).describe(`${options.name} (logger contract: errors and flush)`);
+}
+//# sourceMappingURL=logger-contract.js.map

package/dist/contracts/logger-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-contract.js","sourceRoot":"","sources":["../../src/contracts/logger-contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAQxE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB,EAAE,OAA8B;IACnF,IAAI,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,oBAAoB,CAAC,CAAC;IACnG,IAAI,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,sCAAsC,CAAC,CAAC;AACxH,CAAC"}

package/dist/contracts/outbox-store-contract.d.ts

@@ -0,0 +1,36 @@
+import type { IntegrationEvent } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+/**
+ * The outbox store port of `@ddd-ts-kit/events`, restated structurally so that this package
+ * does not depend on it. Any `OutboxStore` fits.
+ */
+export interface OutboxStoreUnderContract {
+    append(events: readonly IntegrationEvent[]): Promise<void>;
+    claimBatch(limit: number, now: Date): Promise<{
+        readonly event: IntegrationEvent;
+        readonly status: string;
+        readonly attempts: number;
+        readonly lastErrorCode?: string;
+    }[]>;
+    markPublished(ids: readonly string[], at: Date): Promise<void>;
+    markFailed(id: string, error: {
+        readonly code: string;
+    }, nextAttemptAt: Date | null): Promise<void>;
+    retryDead(ids: readonly string[], now: Date): Promise<number>;
+    purgePublished(before: Date): Promise<number>;
+    stats(): Promise<{
+        readonly pending: number;
+        readonly failed: number;
+        readonly dead: number;
+    }>;
+}
+export interface OutboxStoreContractOptions {
+    readonly name: string;
+    /** A fresh, empty store; called before each test. */
+    createStore(): Awaitable<OutboxStoreUnderContract>;
+    /** The lease the created store is configured with: how long a claim hides a record. */
+    readonly leaseMs: number;
+}
+export declare function outboxStoreContract(runner: ContractRunner, options: OutboxStoreContractOptions): void;
+//# sourceMappingURL=outbox-store-contract.d.ts.map

package/dist/contracts/outbox-store-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-store-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/outbox-store-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,MAAM,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,UAAU,CACR,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,IAAI,GACR,OAAO,CACR;QACE,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;QACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,EAAE,CACJ,CAAC;IACF,aAAa,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,aAAa,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpG,SAAS,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,cAAc,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,KAAK,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChG;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,WAAW,IAAI,SAAS,CAAC,wBAAwB,CAAC,CAAC;IACnD,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAErG"}

package/dist/contracts/outbox-store-contract.js

@@ -0,0 +1,148 @@
+import { ContractSuite } from './contract-suite.js';
+import { failureOf } from './failure-of.js';
+import { fullEnvelope } from './full-envelope.js';
+export function outboxStoreContract(runner, options) {
+    new OutboxStoreSuite(runner, options).describe(`${options.name} (outbox store contract)`);
+}
+const NOW = new Date('2026-03-01T10:00:00.000Z');
+class OutboxStoreSuite extends ContractSuite {
+    options;
+    constructor(runner, options) {
+        super(runner, () => options.createStore());
+        this.options = options;
+    }
+    tests() {
+        this.handsOutWhatWasAppended();
+        this.returnsTheEventAsAppended();
+        this.leasesWhatItHandsOut();
+        this.followsTheOutcomeOfAnAttempt();
+        this.revivesDeadRecords();
+        this.purgesAndRefusesDuplicates();
+    }
+    handsOutWhatWasAppended() {
+        this.it('starts empty', async () => {
+            this.expect(await this.subject.stats()).toEqual({ pending: 0, failed: 0, dead: 0 });
+            this.expect(await this.subject.claimBatch(10, NOW)).toEqual([]);
+        });
+        this.it('hands out the appended events oldest first and counts the attempt', async () => {
+            await this.subject.append([outboxEvent('evt-1'), outboxEvent('evt-2')]);
+            await this.subject.append([outboxEvent('evt-3')]);
+            this.expect(await this.subject.stats()).toEqual({ pending: 3, failed: 0, dead: 0 });
+            const claimed = await this.subject.claimBatch(10, NOW);
+            this.expect(claimed.map((record) => record.event.id)).toEqual(['evt-1', 'evt-2', 'evt-3']);
+            this.expect(claimed.map((record) => record.attempts)).toEqual([1, 1, 1]);
+            this.expect(claimed.map((record) => record.status)).toEqual(['pending', 'pending', 'pending']);
+        });
+    }
+    returnsTheEventAsAppended() {
+        this.it('returns the event exactly as appended, trace and correlation included', async () => {
+            const appended = fullEnvelope(outboxEvent('evt-1'));
+            await this.subject.append([appended, outboxEvent('evt-2')]);
+            const claimed = await this.subject.claimBatch(10, NOW);
+            this.expect(claimed[0]?.event).toEqual(appended);
+            this.expect(claimed[1]?.event).toEqual(outboxEvent('evt-2'));
+            this.expect(claimed[1]?.event.traceparent).toBe(undefined);
+            this.expect(claimed[1]?.event.correlationId).toBe(undefined);
+        });
+    }
+    leasesWhatItHandsOut() {
+        this.it('honours the limit and leaves the rest to the next claim', async () => {
+            await this.subject.append([outboxEvent('evt-1'), outboxEvent('evt-2'), outboxEvent('evt-3')]);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['evt-1', 'evt-2']);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['evt-3']);
+        });
+        this.it('hides a claimed record until its lease expires, then hands it out again', async () => {
+            await this.subject.append([outboxEvent('evt-1')]);
+            await this.subject.claimBatch(10, NOW);
+            this.expect(await this.claimedIds(10, NOW)).toEqual([]);
+            this.expect(await this.claimedIds(10, later(this.options.leaseMs - 1))).toEqual([]);
+            const again = await this.subject.claimBatch(10, later(this.options.leaseMs));
+            this.expect(again.map((record) => record.event.id)).toEqual(['evt-1']);
+            this.expect(again[0]?.attempts).toBe(2);
+        });
+        this.it('never hands the same record to two concurrent claims', async () => {
+            await this.subject.append(['1', '2', '3', '4', '5', '6'].map((n) => outboxEvent(`evt-${n}`)));
+            const batches = await Promise.all([this.claimedIds(4, NOW), this.claimedIds(4, NOW)]);
+            const ids = batches.flat();
+            this.expect(ids.length).toBe(6);
+            this.expect(new Set(ids).size).toBe(6);
+        });
+    }
+    followsTheOutcomeOfAnAttempt() {
+        this.it('never hands out a published record again', async () => {
+            await this.subject.append([outboxEvent('evt-1'), outboxEvent('evt-2')]);
+            await this.subject.claimBatch(10, NOW);
+            await this.subject.markPublished(['evt-1'], NOW);
+            this.expect(await this.subject.stats()).toEqual({ pending: 1, failed: 0, dead: 0 });
+            this.expect(await this.claimedIds(10, later(this.options.leaseMs * 10))).toEqual(['evt-2']);
+        });
+        this.it('retries a failed record at its next attempt, not before', async () => {
+            await this.subject.append([outboxEvent('evt-1')]);
+            await this.subject.claimBatch(10, NOW);
+            await this.subject.markFailed('evt-1', { code: 'BROKER_DOWN' }, later(5_000));
+            this.expect(await this.subject.stats()).toEqual({ pending: 1, failed: 1, dead: 0 });
+            this.expect(await this.claimedIds(10, later(4_999))).toEqual([]);
+            const retried = await this.subject.claimBatch(10, later(5_000));
+            this.expect(retried.map((record) => record.event.id)).toEqual(['evt-1']);
+            this.expect(retried[0]?.attempts).toBe(2);
+            this.expect(retried[0]?.lastErrorCode).toBe('BROKER_DOWN');
+        });
+    }
+    revivesDeadRecords() {
+        this.it('sets a dead record aside for good', async () => {
+            await this.subject.append([outboxEvent('evt-1'), outboxEvent('evt-2')]);
+            await this.subject.claimBatch(10, NOW);
+            await this.subject.markFailed('evt-1', { code: 'BROKER_DOWN' }, null);
+            this.expect(await this.subject.stats()).toEqual({ pending: 1, failed: 0, dead: 1 });
+            this.expect(await this.claimedIds(10, later(this.options.leaseMs * 10))).toEqual(['evt-2']);
+        });
+        this.it('puts dead records back in the queue with a fresh attempt budget', async () => {
+            await this.subject.append([outboxEvent('evt-1'), outboxEvent('evt-2')]);
+            await this.subject.claimBatch(10, NOW);
+            await this.subject.markFailed('evt-1', { code: 'BROKER_DOWN' }, null);
+            await this.subject.markPublished(['evt-2'], NOW);
+            const revivedCount = await this.subject.retryDead(['evt-1', 'evt-2', 'unknown'], later(1_000));
+            this.expect(revivedCount).toBe(1);
+            this.expect(await this.subject.stats()).toEqual({ pending: 1, failed: 1, dead: 0 });
+            this.expect(await this.claimedIds(10, later(999))).toEqual([]);
+            const revived = await this.subject.claimBatch(10, later(1_000));
+            this.expect(revived.map((record) => record.event.id)).toEqual(['evt-1']);
+            this.expect(revived[0]?.attempts).toBe(1);
+        });
+    }
+    purgesAndRefusesDuplicates() {
+        this.it('purges only what was published before the given instant', async () => {
+            await this.subject.append([outboxEvent('evt-1'), outboxEvent('evt-2'), outboxEvent('evt-3')]);
+            await this.subject.claimBatch(10, NOW);
+            await this.subject.markPublished(['evt-1'], NOW);
+            await this.subject.markPublished(['evt-2'], later(1_000));
+            this.expect(await this.subject.purgePublished(NOW)).toBe(0);
+            this.expect(await this.subject.purgePublished(later(1_000))).toBe(1);
+            this.expect(await this.subject.stats()).toEqual({ pending: 1, failed: 0, dead: 0 });
+            this.expect(await this.subject.purgePublished(later(2_000))).toBe(1);
+        });
+        this.it('refuses an event id it already holds, and nothing of that batch gets in', async () => {
+            await this.subject.append([outboxEvent('evt-1')]);
+            const batch = [outboxEvent('evt-2'), outboxEvent('evt-1')];
+            const failure = await failureOf(() => this.subject.append(batch));
+            this.expect(failure !== undefined).toBe(true);
+            this.expect(await this.subject.stats()).toEqual({ pending: 1, failed: 0, dead: 0 });
+        });
+    }
+    async claimedIds(limit, at) {
+        return (await this.subject.claimBatch(limit, at)).map((record) => record.event.id);
+    }
+}
+function later(ms) {
+    return new Date(NOW.getTime() + ms);
+}
+function outboxEvent(id) {
+    return {
+        id,
+        type: 'contract.thing.happened',
+        version: 1,
+        occurredAt: '2026-03-01T09:59:59.000Z',
+        payload: { thingId: `thing-${id}` },
+    };
+}
+//# sourceMappingURL=outbox-store-contract.js.map

package/dist/contracts/outbox-store-contract.js.map

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

package/dist/contracts/processed-event-store-contract.d.ts

@@ -0,0 +1,11 @@
+import type { ProcessedEventStore } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface ProcessedEventStoreContractOptions {
+    readonly name: string;
+    /** A fresh, empty store; called before each test. */
+    createStore(): Awaitable<ProcessedEventStore>;
+}
+/** What every adapter of the kernel `ProcessedEventStore` port guarantees, the in-memory one included. */
+export declare function processedEventStoreContract(runner: ContractRunner, options: ProcessedEventStoreContractOptions): void;
+//# sourceMappingURL=processed-event-store-contract.d.ts.map

package/dist/contracts/processed-event-store-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processed-event-store-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/processed-event-store-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,WAAW,IAAI,SAAS,CAAC,mBAAmB,CAAC,CAAC;CAC/C;AAED,0GAA0G;AAC1G,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,kCAAkC,GAAG,IAAI,CAErH"}

package/dist/contracts/processed-event-store-contract.js

@@ -0,0 +1,40 @@
+import { ContractSuite } from './contract-suite.js';
+/** What every adapter of the kernel `ProcessedEventStore` port guarantees, the in-memory one included. */
+export function processedEventStoreContract(runner, options) {
+    new ProcessedEventStoreSuite(runner, options).describe(`${options.name} (processed event store contract)`);
+}
+class ProcessedEventStoreSuite extends ContractSuite {
+    constructor(runner, options) {
+        super(runner, () => options.createStore());
+    }
+    tests() {
+        this.marksOnce();
+        this.keepsMarksApart();
+    }
+    marksOnce() {
+        this.it('says yes the first time an event is seen by a consumer, no afterwards', async () => {
+            this.expect(await this.subject.markProcessed('billing', 'evt-1')).toBe(true);
+            this.expect(await this.subject.markProcessed('billing', 'evt-1')).toBe(false);
+            this.expect(await this.subject.markProcessed('billing', 'evt-1')).toBe(false);
+        });
+        this.it('says yes to exactly one of several concurrent deliveries', async () => {
+            const answers = await Promise.all(Array.from({ length: 5 }, () => this.subject.markProcessed('billing', 'evt-1')));
+            this.expect(answers.filter((first) => first).length).toBe(1);
+        });
+    }
+    keepsMarksApart() {
+        this.it('keeps consumers apart', async () => {
+            await this.subject.markProcessed('billing', 'evt-1');
+            this.expect(await this.subject.markProcessed('shipping', 'evt-1')).toBe(true);
+        });
+        this.it('keeps events apart', async () => {
+            await this.subject.markProcessed('billing', 'evt-1');
+            this.expect(await this.subject.markProcessed('billing', 'evt-2')).toBe(true);
+        });
+        this.it('does not confuse a separator inside a consumer name or an event id', async () => {
+            await this.subject.markProcessed('billing:evt', '1');
+            this.expect(await this.subject.markProcessed('billing', 'evt:1')).toBe(true);
+        });
+    }
+}
+//# sourceMappingURL=processed-event-store-contract.js.map

package/dist/contracts/processed-event-store-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"processed-event-store-contract.js","sourceRoot":"","sources":["../../src/contracts/processed-event-store-contract.ts"],"names":[],"mappings":"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"}

package/dist/contracts/rate-limiter-contract.d.ts

@@ -0,0 +1,13 @@
+import type { RateLimiter } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface RateLimiterContractOptions {
+    readonly name: string;
+    /** A limiter that has seen no call; called before each test. */
+    createLimiter(): Awaitable<RateLimiter>;
+    /** Makes the time of the limiter pass by exactly that long: advances the clock it reads. */
+    elapse(ms: number): Awaitable<void>;
+}
+/** What every adapter of the kernel `RateLimiter` port guarantees, the in-memory one included. */
+export declare function rateLimiterContract(runner: ContractRunner, options: RateLimiterContractOptions): void;
+//# sourceMappingURL=rate-limiter-contract.d.ts.map

package/dist/contracts/rate-limiter-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/rate-limiter-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAG3D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gEAAgE;IAChE,aAAa,IAAI,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,4FAA4F;IAC5F,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,kGAAkG;AAClG,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,0BAA0B,GAAG,IAAI,CAErG"}

package/dist/contracts/rate-limiter-contract.js

@@ -0,0 +1,86 @@
+import { ContractSuite } from './contract-suite.js';
+/** What every adapter of the kernel `RateLimiter` port guarantees, the in-memory one included. */
+export function rateLimiterContract(runner, options) {
+    new RateLimiterSuite(runner, options).describe(`${options.name} (rate limiter contract)`);
+}
+const THREE_PER_SECOND = { limit: 3, windowMs: 1_000 };
+class RateLimiterSuite extends ContractSuite {
+    options;
+    constructor(runner, options) {
+        super(runner, () => options.createLimiter());
+        this.options = options;
+    }
+    tests() {
+        this.limits();
+        this.slides();
+        this.isolates();
+    }
+    limits() {
+        this.it('allows calls up to the limit and counts down what remains', async () => {
+            const decisions = [await this.consume(), await this.consume(), await this.consume()];
+            this.expect(decisions).toEqual([
+                { allowed: true, remaining: 2, retryAfterMs: 0 },
+                { allowed: true, remaining: 1, retryAfterMs: 0 },
+                { allowed: true, remaining: 0, retryAfterMs: 0 },
+            ]);
+        });
+        this.it('refuses the call beyond the limit and says when to come back', async () => {
+            await this.consume();
+            await this.options.elapse(100);
+            await this.consume();
+            await this.options.elapse(100);
+            await this.consume();
+            await this.options.elapse(100);
+            this.expect(await this.consume()).toEqual({ allowed: false, remaining: 0, retryAfterMs: 700 });
+        });
+        this.it('does not count a refused call', async () => {
+            for (let call = 0; call < 3; call += 1) {
+                await this.consume();
+            }
+            await this.options.elapse(500);
+            for (let call = 0; call < 5; call += 1) {
+                await this.consume();
+            }
+            await this.options.elapse(500);
+            this.expect((await this.consume()).allowed).toBe(true);
+        });
+    }
+    slides() {
+        this.it('allows a call again as soon as the oldest one has left the window, and only as many', async () => {
+            await this.consume();
+            await this.options.elapse(400);
+            await this.consume();
+            await this.consume();
+            await this.options.elapse(599);
+            this.expect((await this.consume()).allowed).toBe(false);
+            await this.options.elapse(1);
+            this.expect(await this.consume()).toEqual({ allowed: true, remaining: 0, retryAfterMs: 0 });
+            this.expect(await this.consume()).toEqual({ allowed: false, remaining: 0, retryAfterMs: 400 });
+        });
+        this.it('starts afresh once the whole window has passed without a call', async () => {
+            for (let call = 0; call < 3; call += 1) {
+                await this.consume();
+            }
+            await this.options.elapse(1_000);
+            this.expect(await this.consume()).toEqual({ allowed: true, remaining: 2, retryAfterMs: 0 });
+        });
+    }
+    isolates() {
+        this.it('keeps keys apart', async () => {
+            for (let call = 0; call < 3; call += 1) {
+                await this.consume('client-a');
+            }
+            this.expect((await this.consume('client-a')).allowed).toBe(false);
+            this.expect(await this.consume('client-b')).toEqual({ allowed: true, remaining: 2, retryAfterMs: 0 });
+        });
+        this.it('allows exactly the limit among calls made at the same time', async () => {
+            const decisions = await Promise.all(Array.from({ length: 10 }, () => this.consume()));
+            this.expect(decisions.filter((decision) => decision.allowed).length).toBe(3);
+            this.expect(decisions.filter((decision) => !decision.allowed).every((decision) => decision.retryAfterMs === 1_000)).toBe(true);
+        });
+    }
+    consume(key = 'client-a') {
+        return this.subject.consume(key, THREE_PER_SECOND);
+    }
+}
+//# sourceMappingURL=rate-limiter-contract.js.map

package/dist/contracts/rate-limiter-contract.js.map

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

package/dist/contracts/read-model/everything.d.ts

@@ -0,0 +1,5 @@
+/** The scope of an actor who reads every row. */
+export declare const everything: {
+    readonly kind: 'all';
+};
+//# sourceMappingURL=everything.d.ts.map

package/dist/contracts/read-model/everything.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"everything.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/everything.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,eAAO,MAAM,UAAU;aAAK,IAAI,EAAE,KAAK;CAAW,CAAC"}

package/dist/contracts/read-model/everything.js

@@ -0,0 +1,3 @@
+/** The scope of an actor who reads every row. */
+export const everything = { kind: 'all' };
+//# sourceMappingURL=everything.js.map

package/dist/contracts/read-model/everything.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"everything.js","sourceRoot":"","sources":["../../../src/contracts/read-model/everything.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,IAAI,EAAE,KAAK,EAAW,CAAC"}

package/dist/contracts/read-model/read-model-store-suite.d.ts

@@ -0,0 +1,14 @@
+import { TableReadModelStore, type EventStamp } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import type { CriteriaContractRow } from '../criteria/criteria-contract-row.js';
+import type { ReadModelStoreUnderContract } from './read-model-store-under-contract.js';
+type Row = CriteriaContractRow;
+/** A suite about a `TableReadModelStore` over the table under contract, closed after each test. */
+export declare abstract class ReadModelStoreSuite extends ContractSuite<ReadModelStoreUnderContract> {
+    protected closesAfterEach(): void;
+    protected get store(): TableReadModelStore<Row>;
+    protected put(written: Row, stamp: EventStamp): Promise<string>;
+    protected ids(): Promise<string[]>;
+}
+export {};
+//# sourceMappingURL=read-model-store-suite.d.ts.map

package/dist/contracts/read-model/read-model-store-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-store-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/read-model-store-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,mBAAmB,EAAU,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AAExF,KAAK,GAAG,GAAG,mBAAmB,CAAC;AAE/B,mGAAmG;AACnG,8BAAsB,mBAAoB,SAAQ,aAAa,CAAC,2BAA2B,CAAC;IAC1F,SAAS,CAAC,eAAe,IAAI,IAAI,CAIhC;IAED,SAAS,KAAK,KAAK,IAAI,mBAAmB,CAAC,GAAG,CAAC,CAE9C;IAED,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9D;IAED,UAAgB,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAIvC;CACF"}

package/dist/contracts/read-model/read-model-store-suite.js

@@ -0,0 +1,23 @@
+import { Criteria, TableReadModelStore, scoped } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import { criteriaContractDefinition } from '../criteria/criteria-contract-definition.js';
+import { everything } from './everything.js';
+/** A suite about a `TableReadModelStore` over the table under contract, closed after each test. */
+export class ReadModelStoreSuite extends ContractSuite {
+    closesAfterEach() {
+        this.afterEach(async () => {
+            await this.subject.close?.();
+        });
+    }
+    get store() {
+        return new TableReadModelStore(this.subject.table, criteriaContractDefinition);
+    }
+    put(written, stamp) {
+        return this.store.upsertIfNewer(written.id, stamp, () => written);
+    }
+    async ids() {
+        const page = await this.store.search(scoped(Criteria.of().orderBy('id'), everything));
+        return page.items.map(({ id }) => id);
+    }
+}
+//# sourceMappingURL=read-model-store-suite.js.map

package/dist/contracts/read-model/read-model-store-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-store-suite.js","sourceRoot":"","sources":["../../../src/contracts/read-model/read-model-store-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAmB,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAEzF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAK7C,mGAAmG;AACnG,MAAM,OAAgB,mBAAoB,SAAQ,aAA0C;IAChF,eAAe;QACvB,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE;YACxB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAc,KAAK;QACjB,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;IACjF,CAAC;IAES,GAAG,CAAC,OAAY,EAAE,KAAiB;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;IACpE,CAAC;IAES,KAAK,CAAC,GAAG;QACjB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;QAE3F,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/contracts/read-model/read-model-store-under-contract.d.ts

@@ -0,0 +1,11 @@
+import type { ReadModelTable, UnitOfWork } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from '../awaitable.js';
+import type { CriteriaContractRow } from '../criteria/criteria-contract-row.js';
+export interface ReadModelStoreUnderContract {
+    /** The table of `CriteriaContractRow`, empty. */
+    readonly table: ReadModelTable<CriteriaContractRow>;
+    /** The unit of work of its database: the swap of a rebuild runs in it. */
+    readonly unitOfWork: UnitOfWork;
+    close?(): Awaitable<void>;
+}
+//# sourceMappingURL=read-model-store-under-contract.d.ts.map

package/dist/contracts/read-model/read-model-store-under-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-store-under-contract.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/read-model-store-under-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEhF,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC,mBAAmB,CAAC,CAAC;IACpD,0EAA0E;IAC1E,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;CAC3B"}

package/dist/contracts/read-model/read-model-store-under-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=read-model-store-under-contract.js.map

package/dist/contracts/read-model/read-model-store-under-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-store-under-contract.js","sourceRoot":"","sources":["../../../src/contracts/read-model/read-model-store-under-contract.ts"],"names":[],"mappings":""}

package/dist/contracts/read-model/rebuild-suite.d.ts

@@ -0,0 +1,14 @@
+import { ReadModelStoreSuite } from './read-model-store-suite.js';
+/** A rebuild from the source of truth that loses no event, whatever happens while it runs. */
+export declare class RebuildSuite extends ReadModelStoreSuite {
+    protected tests(): void;
+    private rebuilds;
+    private rebuildsUnderEvents;
+    private appliesAfterTheSwap;
+    private rebuildsAroundDeletions;
+    private survivesARebuild;
+    private rebuild;
+    /** A source holding these rows of the dataset, each stamped at the minute given. */
+    private sourceOf;
+}
+//# sourceMappingURL=rebuild-suite.d.ts.map

package/dist/contracts/read-model/rebuild-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuild-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/rebuild-suite.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAOlE,8FAA8F;AAC9F,qBAAa,YAAa,SAAQ,mBAAmB;IACnD,SAAS,CAAC,KAAK,IAAI,IAAI,CAOtB;IAED,OAAO,CAAC,QAAQ;IAsChB,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,uBAAuB;IA4B/B,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,OAAO;IAMf,oFAAoF;IACpF,OAAO,CAAC,QAAQ;CASjB"}