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

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

@@ -0,0 +1,116 @@
+import { ProjectionRebuild } from '@ddd-ts-kit/kernel';
+import { ReadModelStoreSuite } from './read-model-store-suite.js';
+import { rowOf as row } from './row-of.js';
+import { SourceOfTruth } from './source-of-truth.js';
+import { stampedAt as at } from './stamped-at.js';
+/** A rebuild from the source of truth that loses no event, whatever happens while it runs. */
+export class RebuildSuite extends ReadModelStoreSuite {
+    tests() {
+        this.closesAfterEach();
+        this.rebuilds();
+        this.rebuildsUnderEvents();
+        this.appliesAfterTheSwap();
+        this.rebuildsAroundDeletions();
+        this.survivesARebuild();
+    }
+    rebuilds() {
+        this.it('rebuilds from the source alone: wrong rows are corrected, rows the source does not hold are gone', async () => {
+            const source = this.sourceOf(['a1', 'a3', 'a4', 'a5'], 2);
+            await this.put({ ...row('a1'), title: 'wrong' }, at('evt-1', 1));
+            await this.put(row('a2'), at('evt-1', 1));
+            const report = await this.rebuild(source);
+            this.expect(report).toEqual({ copied: 4, reread: 0, rounds: 0 });
+            this.expect(source.exportedPages).toBe(2);
+            this.expect(await this.ids()).toEqual(['a1', 'a3', 'a4', 'a5']);
+            this.expect(await this.store.get('a1')).toEqual(row('a1'));
+            this.expect(await this.subject.table.rebuilding()).toBe(false);
+        });
+        this.it('leaves the table as it was when the export fails', async () => {
+            const source = this.sourceOf(['a1', 'a3', 'a4'], 2);
+            source.duringExport = () => Promise.reject(new Error('the source is down'));
+            await this.put(row('a2'), at('evt-1', 1));
+            this.expect(await this.rebuild(source).then(() => 'rebuilt', () => 'failed')).toBe('failed');
+            this.expect(await this.ids()).toEqual(['a2']);
+            this.expect(await this.subject.table.rebuilding()).toBe(false);
+            this.expect(await this.put(row('a5'), at('evt-2', 2))).toBe('applied');
+        });
+    }
+    rebuildsUnderEvents() {
+        for (const key of ['a1', 'a5']) {
+            this.it(`loses no event applied while it exports, ${key === 'a1' ? 'on a row already copied' : 'on a row not copied yet'}`, async () => {
+                const source = this.sourceOf(['a1', 'a3', 'a4', 'a5'], 2);
+                const renamed = { ...row(key), title: 'renamed meanwhile' };
+                source.duringExport = async () => {
+                    source.put({ key, row: renamed, stamp: at('evt-9', 9) });
+                    await this.store.upsertIfNewer(key, at('evt-9', 9), (current) => current === undefined ? undefined : renamed);
+                };
+                const report = await this.rebuild(source);
+                this.expect(await this.store.get(key)).toEqual(renamed);
+                this.expect(source.lookups).toEqual([[key]]);
+                this.expect(report.reread).toBe(1);
+            });
+        }
+        this.it('reads the touched keys again in rounds before it holds the writers', async () => {
+            const source = this.sourceOf(['a1', 'a3', 'a4'], 2);
+            source.duringExport = async () => {
+                source.put({ key: 'a3', row: { ...row('a3'), seats: 9 }, stamp: at('evt-9', 9) });
+                await this.put({ ...row('a3'), seats: 9 }, at('evt-9', 9));
+            };
+            const { table, unitOfWork } = this.subject;
+            const report = await new ProjectionRebuild({ table, source, unitOfWork, settledBelow: 0 }).run();
+            this.expect(report).toEqual({ copied: 3, reread: 1, rounds: 1 });
+            this.expect((await this.store.get('a3'))?.seats).toBe(9);
+        });
+    }
+    appliesAfterTheSwap() {
+        this.it('applies after the swap what the source did not hold yet, and only that', async () => {
+            await this.rebuild(this.sourceOf(['a1', 'a3'], 5));
+            this.expect(await this.put({ ...row('a1'), title: 'already in the export' }, at('evt-4', 4))).toBe('stale');
+            this.expect(await this.put({ ...row('a1'), title: 'new' }, at('evt-6', 6))).toBe('applied');
+            this.expect((await this.store.get('a1'))?.title).toBe('new');
+        });
+    }
+    rebuildsAroundDeletions() {
+        this.it('drops a row deleted while it exports, for good', async () => {
+            const source = this.sourceOf(['a1', 'a3', 'a4'], 2);
+            await this.put(row('a1'), at('evt-1', 1));
+            source.duringExport = async () => {
+                source.remove('a1');
+                await this.store.delete('a1', at('evt-9', 9));
+            };
+            await this.rebuild(source);
+            this.expect(await this.ids()).toEqual(['a3', 'a4']);
+            this.expect(await this.put(row('a1'), at('evt-5', 5))).toBe('stale');
+        });
+        this.it('keeps the trace of a row deleted before it started', async () => {
+            await this.put(row('a2'), at('evt-1', 1));
+            await this.store.delete('a2', at('evt-4', 4));
+            await this.rebuild(this.sourceOf(['a1'], 2));
+            this.expect(await this.put(row('a2'), at('evt-3', 3))).toBe('stale');
+            this.expect(await this.put(row('a2'), at('evt-9', 9))).toBe('applied');
+            this.expect(await this.ids()).toEqual(['a1', 'a2']);
+        });
+    }
+    survivesARebuild() {
+        this.it('is the same table after two rebuilds: keys stay unique, rows are written and listed', async () => {
+            await this.rebuild(this.sourceOf(['a1', 'a3'], 2));
+            await this.rebuild(this.sourceOf(['a1', 'a3', 'a4'], 3));
+            this.expect(await this.subject.table.insert({ key: 'a4', row: row('a4'), stamp: at('evt-9', 9) })).toBe(false);
+            this.expect(await this.put(row('a5'), at('evt-9', 9))).toBe('applied');
+            this.expect(await this.ids()).toEqual(['a1', 'a3', 'a4', 'a5']);
+        });
+    }
+    rebuild(source) {
+        const { table, unitOfWork } = this.subject;
+        return new ProjectionRebuild({ table, source, unitOfWork }).run();
+    }
+    /** A source holding these rows of the dataset, each stamped at the minute given. */
+    sourceOf(keys, minute) {
+        const source = new SourceOfTruth();
+        for (const key of keys) {
+            source.put({ key, row: row(key), stamp: at(`evt-${String(minute)}`, minute) });
+        }
+        return source;
+    }
+}
+//# sourceMappingURL=rebuild-suite.js.map

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

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

package/dist/contracts/read-model/row-of.d.ts

@@ -0,0 +1,4 @@
+import type { CriteriaContractRow } from '../criteria/criteria-contract-row.js';
+/** The row of the contract dataset with this id. */
+export declare function rowOf(id: string): CriteriaContractRow;
+//# sourceMappingURL=row-of.d.ts.map

package/dist/contracts/read-model/row-of.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-of.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/row-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAGhF,oDAAoD;AACpD,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,mBAAmB,CAQrD"}

package/dist/contracts/read-model/row-of.js

@@ -0,0 +1,10 @@
+import { criteriaContractRows } from '../criteria/criteria-contract-rows.js';
+/** The row of the contract dataset with this id. */
+export function rowOf(id) {
+    const found = criteriaContractRows().find((candidate) => candidate.id === id);
+    if (found === undefined) {
+        throw new Error(`The contract dataset holds no row ${id}`);
+    }
+    return found;
+}
+//# sourceMappingURL=row-of.js.map

package/dist/contracts/read-model/row-of.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-of.js","sourceRoot":"","sources":["../../../src/contracts/read-model/row-of.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAE7E,oDAAoD;AACpD,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAE9E,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,qCAAqC,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,11 @@
+import { ReadModelStoreSuite } from './read-model-store-suite.js';
+/** Rows that round trip, events applied once and in order, deletions that last, and searching. */
+export declare class RowsSuite extends ReadModelStoreSuite {
+    protected tests(): void;
+    private keepsRows;
+    private appliesInOrder;
+    private appliesByVersion;
+    private deletes;
+    private searches;
+}
+//# sourceMappingURL=rows-suite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rows-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/rows-suite.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE,kGAAkG;AAClG,qBAAa,SAAU,SAAQ,mBAAmB;IAChD,SAAS,CAAC,KAAK,IAAI,IAAI,CAOtB;IAED,OAAO,CAAC,SAAS;IAgCjB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,OAAO;IA2Bf,OAAO,CAAC,QAAQ;CAwCjB"}

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

@@ -0,0 +1,122 @@
+import { Criteria, cursorPage, scoped } from '@ddd-ts-kit/kernel';
+import { criteriaContractRows } from '../criteria/criteria-contract-rows.js';
+import { everything } from './everything.js';
+import { ReadModelStoreSuite } from './read-model-store-suite.js';
+import { rowOf as row } from './row-of.js';
+import { stampedAt as at } from './stamped-at.js';
+/** Rows that round trip, events applied once and in order, deletions that last, and searching. */
+export class RowsSuite extends ReadModelStoreSuite {
+    tests() {
+        this.closesAfterEach();
+        this.keepsRows();
+        this.appliesInOrder();
+        this.appliesByVersion();
+        this.deletes();
+        this.searches();
+    }
+    keepsRows() {
+        this.it('answers nothing for a key it does not hold', async () => {
+            this.expect(await this.store.get('a1')).toBe(undefined);
+        });
+        this.it('gives back every row as it was written: instants, decimals, booleans and nulls', async () => {
+            for (const row of criteriaContractRows()) {
+                this.expect(await this.put(row, at('evt-1', 1))).toBe('applied');
+            }
+            for (const row of criteriaContractRows()) {
+                this.expect(await this.store.get(row.id)).toEqual(row);
+            }
+        });
+        this.it('hands the current row to the change of a later event', async () => {
+            await this.put(row('a1'), at('evt-1', 1));
+            const written = await this.store.upsertIfNewer('a1', at('evt-2', 2), (current) => current === undefined ? undefined : { ...current, seats: current.seats + 1 });
+            this.expect(written).toBe('applied');
+            this.expect(await this.store.get('a1')).toEqual({ ...row('a1'), seats: 3 });
+        });
+        this.it('writes nothing when the change answers nothing', async () => {
+            this.expect(await this.store.upsertIfNewer('a1', at('evt-1', 1), () => undefined)).toBe('ignored');
+            this.expect(await this.store.get('a1')).toBe(undefined);
+        });
+    }
+    appliesInOrder() {
+        this.it('ignores an event delivered twice', async () => {
+            await this.put(row('a1'), at('evt-1', 1));
+            this.expect(await this.put({ ...row('a1'), title: 'again' }, at('evt-1', 1))).toBe('stale');
+            this.expect(await this.store.get('a1')).toEqual(row('a1'));
+        });
+        this.it('ignores an event older than what the row holds', async () => {
+            await this.put(row('a1'), at('evt-2', 2));
+            this.expect(await this.put({ ...row('a1'), title: 'late' }, at('evt-1', 1))).toBe('stale');
+            this.expect(await this.store.get('a1')).toEqual(row('a1'));
+        });
+        this.it('orders two events of the same instant by their id, whichever comes first', async () => {
+            await this.put({ ...row('a1'), title: 'b' }, at('evt-b', 1));
+            this.expect(await this.put({ ...row('a1'), title: 'a' }, at('evt-a', 1))).toBe('stale');
+            this.expect(await this.put({ ...row('a1'), title: 'c' }, at('evt-c', 1))).toBe('applied');
+            this.expect((await this.store.get('a1'))?.title).toBe('c');
+        });
+        this.it('ends on the latest of several events applied at once', async () => {
+            const minutes = [3, 1, 4, 2];
+            await Promise.all(minutes.map((minute) => this.put({ ...row('a1'), seats: minute }, at(`evt-${String(minute)}`, minute))));
+            this.expect((await this.store.get('a1'))?.seats).toBe(4);
+        });
+    }
+    appliesByVersion() {
+        this.it('orders by version when both stamps carry one, whatever the clocks say', async () => {
+            await this.put({ ...row('a1'), title: 'v2' }, { ...at('evt-2', 5), version: 2 });
+            this.expect(await this.put({ ...row('a1'), title: 'v1' }, { ...at('evt-1', 9), version: 1 })).toBe('stale');
+            this.expect(await this.put({ ...row('a1'), title: 'v3' }, { ...at('evt-3', 1), version: 3 })).toBe('applied');
+            this.expect((await this.store.get('a1'))?.title).toBe('v3');
+        });
+        this.it('keeps the version with the row', async () => {
+            await this.put(row('a1'), { ...at('evt-1', 1), version: 7 });
+            this.expect((await this.subject.table.find('a1'))?.stamp).toEqual({ ...at('evt-1', 1), version: 7 });
+        });
+    }
+    deletes() {
+        this.it('removes a row, and an older event delivered late does not bring it back', async () => {
+            await this.put(row('a1'), at('evt-1', 1));
+            this.expect(await this.store.delete('a1', at('evt-3', 3))).toBe('applied');
+            this.expect(await this.store.get('a1')).toBe(undefined);
+            this.expect(await this.put(row('a1'), at('evt-2', 2))).toBe('stale');
+            this.expect(await this.store.get('a1')).toBe(undefined);
+        });
+        this.it('writes a row again when a later event recreates it', async () => {
+            await this.put(row('a1'), at('evt-1', 1));
+            await this.store.delete('a1', at('evt-2', 2));
+            this.expect(await this.put({ ...row('a1'), title: 'back' }, at('evt-3', 3))).toBe('applied');
+            this.expect((await this.store.get('a1'))?.title).toBe('back');
+        });
+        this.it('ignores a deletion older than the row, or of a row it never held', async () => {
+            await this.put(row('a1'), at('evt-2', 2));
+            this.expect(await this.store.delete('a1', at('evt-1', 1))).toBe('stale');
+            this.expect(await this.store.delete('a2', at('evt-1', 1))).toBe('ignored');
+            this.expect(await this.store.get('a1')).toEqual(row('a1'));
+        });
+    }
+    searches() {
+        this.it('searches by criteria, without the deleted rows', async () => {
+            for (const written of criteriaContractRows()) {
+                await this.put(written, at('evt-1', 1));
+            }
+            await this.store.delete('a8', at('evt-2', 2));
+            const booked = Criteria.of().where('status', 'eq', 'booked').orderBy('seats', 'desc');
+            const page = await this.store.search(scoped(booked, everything));
+            this.expect(page.items.map(({ id }) => id)).toEqual(['a7', 'a1', 'a4']);
+            this.expect(page.total).toBe(3);
+        });
+        this.it('pages by cursor and narrows by the scope of the actor', async () => {
+            for (const written of criteriaContractRows()) {
+                await this.put(written, at('evt-1', 1));
+            }
+            const acme = (cursor) => this.store.search(scoped(Criteria.of().page(cursorPage({ limit: 3, ...(cursor === undefined ? {} : { cursor }) })), { kind: 'filter', filter: { tenantId: 'acme' } }, { filter: { tenantId: 'tenantId' } }));
+            const first = await acme();
+            const second = await acme(first.nextCursor);
+            this.expect([first, second].map((page) => page.items.map(({ id }) => id))).toEqual([
+                ['a1', 'a2', 'a3'],
+                ['a6', 'a7'],
+            ]);
+            this.expect((await this.store.search(scoped(Criteria.of(), { kind: 'none' }))).items).toEqual([]);
+        });
+    }
+}
+//# sourceMappingURL=rows-suite.js.map

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

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

package/dist/contracts/read-model/source-of-truth.d.ts

@@ -0,0 +1,17 @@
+import { type Page, type ReadModelSource, type StampedRow } from '@ddd-ts-kit/kernel';
+/**
+ * The fake of the context a read model is rebuilt from: rows by key, exported two at a time,
+ * and counting how it was read. `duringExport` runs between two pages, which is where a test
+ * makes an event arrive.
+ */
+export declare class SourceOfTruth<Row> implements ReadModelSource<Row> {
+    readonly lookups: string[][];
+    exportedPages: number;
+    duringExport: (page: number) => Promise<void>;
+    private readonly rows;
+    put(entry: StampedRow<Row>): void;
+    remove(key: string): void;
+    export(cursor: string | undefined): Promise<Page<StampedRow<Row>>>;
+    lookup(keys: readonly string[]): Promise<ReadonlyMap<string, StampedRow<Row>>>;
+}
+//# sourceMappingURL=source-of-truth.d.ts.map

package/dist/contracts/read-model/source-of-truth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-of-truth.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/source-of-truth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,IAAI,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAE9F;;;;GAIG;AACH,qBAAa,aAAa,CAAC,GAAG,CAAE,YAAW,eAAe,CAAC,GAAG,CAAC;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAM;IAElC,aAAa,SAAK;IAElB,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAA2B;IAExE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsC;IAE3D,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAEhC;IAED,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAExB;IAEK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAevE;IAEK,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAUnF;CACF"}

package/dist/contracts/read-model/source-of-truth.js

@@ -0,0 +1,36 @@
+import { pageOf } from '@ddd-ts-kit/kernel';
+/**
+ * The fake of the context a read model is rebuilt from: rows by key, exported two at a time,
+ * and counting how it was read. `duringExport` runs between two pages, which is where a test
+ * makes an event arrive.
+ */
+export class SourceOfTruth {
+    lookups = [];
+    exportedPages = 0;
+    duringExport = () => Promise.resolve();
+    rows = new Map();
+    put(entry) {
+        this.rows.set(entry.key, entry);
+    }
+    remove(key) {
+        this.rows.delete(key);
+    }
+    async export(cursor) {
+        if (cursor !== undefined) {
+            await this.duringExport(this.exportedPages);
+        }
+        const after = [...this.rows.keys()].sort().filter((key) => cursor === undefined || key > cursor);
+        const keys = after.slice(0, 2);
+        const last = keys.at(-1);
+        this.exportedPages += 1;
+        return pageOf(keys.flatMap((key) => this.rows.get(key) ?? []), after.length > 2 && last !== undefined ? { nextCursor: last } : {});
+    }
+    async lookup(keys) {
+        this.lookups.push([...keys]);
+        return new Map(keys.flatMap((key) => {
+            const entry = this.rows.get(key);
+            return entry === undefined ? [] : [[key, entry]];
+        }));
+    }
+}
+//# sourceMappingURL=source-of-truth.js.map

package/dist/contracts/read-model/source-of-truth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-of-truth.js","sourceRoot":"","sources":["../../../src/contracts/read-model/source-of-truth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAoD,MAAM,oBAAoB,CAAC;AAE9F;;;;GAIG;AACH,MAAM,OAAO,aAAa;IACf,OAAO,GAAe,EAAE,CAAC;IAElC,aAAa,GAAG,CAAC,CAAC;IAElB,YAAY,GAAoC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAEvD,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE3D,GAAG,CAAC,KAAsB;QACxB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAA0B;QACrC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,KAAK,SAAS,IAAI,GAAG,GAAG,MAAM,CAAC,CAAC;QACjG,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzB,IAAI,CAAC,aAAa,IAAI,CAAC,CAAC;QAExB,OAAO,MAAM,CACX,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAC/C,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CACnE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAuB;QAClC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QAE7B,OAAO,IAAI,GAAG,CACZ,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEjC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACnD,CAAC,CAAC,CACH,CAAC;IACJ,CAAC;CACF"}

package/dist/contracts/read-model/stamped-at.d.ts

@@ -0,0 +1,4 @@
+import type { EventStamp } from '@ddd-ts-kit/kernel';
+/** The stamp of an event that occurred at this minute of the hour the contract plays in. */
+export declare function stampedAt(eventId: string, minute: number): EventStamp;
+//# sourceMappingURL=stamped-at.d.ts.map

package/dist/contracts/read-model/stamped-at.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamped-at.d.ts","sourceRoot":"","sources":["../../../src/contracts/read-model/stamped-at.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAErE"}

package/dist/contracts/read-model/stamped-at.js

@@ -0,0 +1,5 @@
+/** The stamp of an event that occurred at this minute of the hour the contract plays in. */
+export function stampedAt(eventId, minute) {
+    return { eventId, occurredAt: new Date(Date.UTC(2026, 9, 10, 12, minute)) };
+}
+//# sourceMappingURL=stamped-at.js.map

package/dist/contracts/read-model/stamped-at.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stamped-at.js","sourceRoot":"","sources":["../../../src/contracts/read-model/stamped-at.ts"],"names":[],"mappings":"AAEA,4FAA4F;AAC5F,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,MAAc;IACvD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+import type { ReadModelStoreUnderContract } from './read-model/read-model-store-under-contract.js';
+export interface ReadModelStoreContractOptions {
+    readonly name: string;
+    /** Called before each test. */
+    createTable(): Awaitable<ReadModelStoreUnderContract>;
+}
+/**
+ * What every adapter of `ReadModelTable` guarantees under `TableReadModelStore`, the
+ * in-memory one included: rows that round trip, events applied once and in order whatever
+ * the order of their delivery, deletions that last, and a rebuild that loses no event.
+ */
+export declare function readModelStoreContract(runner: ContractRunner, options: ReadModelStoreContractOptions): void;
+//# sourceMappingURL=read-model-store-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-store-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/read-model-store-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAGnG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+BAA+B;IAC/B,WAAW,IAAI,SAAS,CAAC,2BAA2B,CAAC,CAAC;CACvD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAK3G"}

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

@@ -0,0 +1,13 @@
+import { RebuildSuite } from './read-model/rebuild-suite.js';
+import { RowsSuite } from './read-model/rows-suite.js';
+/**
+ * What every adapter of `ReadModelTable` guarantees under `TableReadModelStore`, the
+ * in-memory one included: rows that round trip, events applied once and in order whatever
+ * the order of their delivery, deletions that last, and a rebuild that loses no event.
+ */
+export function readModelStoreContract(runner, options) {
+    const create = () => options.createTable();
+    new RowsSuite(runner, create).describe(`${options.name} (read model store contract: rows)`);
+    new RebuildSuite(runner, create).describe(`${options.name} (read model store contract: rebuild)`);
+}
+//# sourceMappingURL=read-model-store-contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"read-model-store-contract.js","sourceRoot":"","sources":["../../src/contracts/read-model-store-contract.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAQvD;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAsB,EAAE,OAAsC;IACnG,MAAM,MAAM,GAAG,GAA2C,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAEnF,IAAI,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,oCAAoC,CAAC,CAAC;IAC5F,IAAI,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,uCAAuC,CAAC,CAAC;AACpG,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { AggregateRoot, Repository } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface RepositoryContractOptions<A extends AggregateRoot<Id>, Id extends string | number> {
+    readonly name: string;
+    /** A fresh, empty repository; called before each test. */
+    createRepository(): Awaitable<Repository<A, Id>>;
+    /** A new valid aggregate with an id of its own at each call. */
+    createAggregate(): A;
+    /** Any business operation that changes what `stateOf` returns. */
+    mutate(aggregate: A): void;
+    idOf(aggregate: A): Id;
+    /** A plain-data view of the business state (not of `version`), compared with `toEqual`. */
+    stateOf(aggregate: A): unknown;
+}
+/** What every adapter of a `Repository` port, fake or real, guarantees to the application layer. */
+export declare function repositoryContract<A extends AggregateRoot<Id>, Id extends string | number = string>(runner: ContractRunner, options: RepositoryContractOptions<A, Id>): void;
+//# sourceMappingURL=repository-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"repository-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/repository-contract.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM;IAChG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,gBAAgB,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACjD,gEAAgE;IAChE,eAAe,IAAI,CAAC,CAAC;IACrB,kEAAkE;IAClE,MAAM,CAAC,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3B,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,EAAE,CAAC;IACvB,2FAA2F;IAC3F,OAAO,CAAC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC;CAChC;AAED,oGAAoG;AACpG,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EACjG,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,yBAAyB,CAAC,CAAC,EAAE,EAAE,CAAC,GACxC,IAAI,CAEN"}

package/dist/contracts/repository-contract.js

@@ -0,0 +1,103 @@
+import { CONCURRENCY_CONFLICT } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from './contract-suite.js';
+import { failureOf } from './failure-of.js';
+/** What every adapter of a `Repository` port, fake or real, guarantees to the application layer. */
+export function repositoryContract(runner, options) {
+    new RepositorySuite(runner, options).describe(`${options.name} (repository contract)`);
+}
+class RepositorySuite extends ContractSuite {
+    options;
+    constructor(runner, options) {
+        super(runner, () => options.createRepository());
+        this.options = options;
+    }
+    tests() {
+        this.findsWhatWasSaved();
+        this.keepsAggregatesApart();
+        this.storesTheChangesOfLaterSaves();
+        this.ignoresWhatWasNotSaved();
+        this.refusesToOverwriteAnUnseenChange();
+    }
+    findsWhatWasSaved() {
+        const { options } = this;
+        this.it('finds a saved aggregate with the state it was saved in', async () => {
+            const aggregate = options.createAggregate();
+            await this.subject.save(aggregate);
+            const found = await this.reload(aggregate);
+            this.expect(options.idOf(found)).toBe(options.idOf(aggregate));
+            this.expect(options.stateOf(found)).toEqual(options.stateOf(aggregate));
+        });
+        this.it('gives undefined for an id that was never saved', async () => {
+            await this.subject.save(options.createAggregate());
+            const unknownId = options.idOf(options.createAggregate());
+            this.expect(await this.subject.findById(unknownId)).toBe(undefined);
+        });
+    }
+    keepsAggregatesApart() {
+        const { options } = this;
+        this.it('keeps aggregates apart', async () => {
+            const first = options.createAggregate();
+            const second = options.createAggregate();
+            options.mutate(second);
+            await this.subject.save(first);
+            await this.subject.save(second);
+            this.expect(options.stateOf(await this.reload(first))).toEqual(options.stateOf(first));
+            this.expect(options.stateOf(await this.reload(second))).toEqual(options.stateOf(second));
+        });
+    }
+    storesTheChangesOfLaterSaves() {
+        const { options } = this;
+        this.it('stores the changes of a loaded aggregate that is saved again', async () => {
+            const aggregate = options.createAggregate();
+            await this.subject.save(aggregate);
+            const loaded = await this.reload(aggregate);
+            options.mutate(loaded);
+            await this.subject.save(loaded);
+            this.expect(options.stateOf(await this.reload(aggregate))).toEqual(options.stateOf(loaded));
+        });
+        this.it('accepts several saves of the same instance in a row', async () => {
+            const aggregate = options.createAggregate();
+            await this.subject.save(aggregate);
+            options.mutate(aggregate);
+            await this.subject.save(aggregate);
+            this.expect(options.stateOf(await this.reload(aggregate))).toEqual(options.stateOf(aggregate));
+        });
+    }
+    ignoresWhatWasNotSaved() {
+        const { options } = this;
+        this.it('is not affected by a mutation that is not saved', async () => {
+            const aggregate = options.createAggregate();
+            // Copied: `stateOf` may hand out a live view of the aggregate about to be mutated.
+            const saved = structuredClone(options.stateOf(aggregate));
+            await this.subject.save(aggregate);
+            options.mutate(aggregate);
+            options.mutate(await this.reload(aggregate));
+            this.expect(options.stateOf(await this.reload(aggregate))).toEqual(saved);
+        });
+    }
+    refusesToOverwriteAnUnseenChange() {
+        const { options } = this;
+        this.it('refuses to overwrite a change it has not seen', async () => {
+            const aggregate = options.createAggregate();
+            await this.subject.save(aggregate);
+            const mine = await this.reload(aggregate);
+            const theirs = await this.reload(aggregate);
+            options.mutate(theirs);
+            await this.subject.save(theirs);
+            const failure = await failureOf(() => this.subject.save(mine));
+            this.expect(codeOf(failure)).toBe(CONCURRENCY_CONFLICT);
+            this.expect(options.stateOf(await this.reload(aggregate))).toEqual(options.stateOf(theirs));
+        });
+    }
+    async reload(aggregate) {
+        const found = await this.subject.findById(this.options.idOf(aggregate));
+        if (found === undefined) {
+            throw new Error('The saved aggregate was not found');
+        }
+        return found;
+    }
+}
+function codeOf(error) {
+    return typeof error === 'object' && error !== null && 'code' in error ? error.code : undefined;
+}
+//# sourceMappingURL=repository-contract.js.map

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

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

package/dist/contracts/unit-of-work/after-commit-suite.d.ts

@@ -0,0 +1,12 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { UnitOfWorkUnderContract } from './unit-of-work-under-contract.js';
+/** The `after-commit` phase: after the commit, never without it, and never in the way of the caller. */
+export declare class AfterCommitSuite extends ContractSuite<UnitOfWorkUnderContract> {
+    protected tests(): void;
+    private runsOnceCommitted;
+    /** What another connection sees where the subject has one; what the unit of work sees otherwise. */
+    private seenFromOutside;
+    private isolatesFailures;
+    private refusesToSave;
+}
+//# sourceMappingURL=after-commit-suite.d.ts.map

package/dist/contracts/unit-of-work/after-commit-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"after-commit-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/unit-of-work/after-commit-suite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAIhF,wGAAwG;AACxG,qBAAa,gBAAiB,SAAQ,aAAa,CAAC,uBAAuB,CAAC;IAC1E,SAAS,CAAC,KAAK,IAAI,IAAI,CAQtB;IAED,OAAO,CAAC,iBAAiB;IA4BzB,oGAAoG;YACtF,eAAe;IAM7B,OAAO,CAAC,gBAAgB;IA4BxB,OAAO,CAAC,aAAa;CA2BtB"}