@ddd-ts-kit/testing 0.9.0 → 0.11.0

package/dist/contracts/event-store/stream-suite.js

@@ -0,0 +1,91 @@
+import { CONCURRENCY_CONFLICT } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import { failureOf } from '../failure-of.js';
+import { eventOf } from './event-of.js';
+/** One stream: appended at the version it was read at, read back in order, refused when somebody appended first. */
+export class StreamSuite extends ContractSuite {
+    tests() {
+        this.appendsAndReads();
+        this.readsWhatWasAppended();
+        this.refusesStaleVersions();
+        this.keepsStreamsApart();
+    }
+    appendsAndReads() {
+        this.it('creates a stream at version 0 and gives its events back in order, numbered from 1', async () => {
+            const appended = await this.subject.append('consignment-c1', 0, [eventOf('e1'), eventOf('e2')]);
+            const read = await this.subject.readStream('consignment-c1');
+            this.expect(appended.version).toBe(2);
+            this.expect(read.map(({ id, version, stream }) => ({ id, version, stream }))).toEqual([
+                { id: 'e1', version: 1, stream: 'consignment-c1' },
+                { id: 'e2', version: 2, stream: 'consignment-c1' },
+            ]);
+        });
+        this.it('gives back the type, the version of the shape, the data, the metadata and the instant as appended', async () => {
+            const data = {
+                label: 'é ✓',
+                weight: 12.5,
+                fragile: true,
+                none: null,
+                items: [{ sku: 'a' }],
+                nested: { depth: 2 },
+            };
+            await this.subject.append('consignment-c1', 0, [{ ...eventOf('e1', data), schemaVersion: 3 }]);
+            const [read] = await this.subject.readStream('consignment-c1');
+            this.expect(read?.type).toBe('shipping.consignment.weighed');
+            this.expect(read?.schemaVersion).toBe(3);
+            this.expect(read?.data).toEqual(data);
+            this.expect(read?.metadata).toEqual({ aggregateId: 'c1', correlationId: 'corr-e1' });
+            this.expect(read?.occurredAt.toISOString()).toBe('2026-03-01T10:00:00.000Z');
+        });
+    }
+    readsWhatWasAppended() {
+        this.it('appends to a stream at the version it has, and reads it after a version', async () => {
+            await this.subject.append('consignment-c1', 0, [eventOf('e1')]);
+            await this.subject.append('consignment-c1', 1, [eventOf('e2'), eventOf('e3')]);
+            const after = await this.subject.readStream('consignment-c1', 1);
+            this.expect(after.map(({ id, version }) => `${id}@${version}`)).toEqual(['e2@2', 'e3@3']);
+        });
+        this.it('appends nothing at the version the stream has, and refuses nothing at another one', async () => {
+            await this.subject.append('consignment-c1', 0, [eventOf('e1')]);
+            const unchanged = await this.subject.append('consignment-c1', 1, []);
+            const refused = await failureOf(() => this.subject.append('consignment-c1', 0, []));
+            this.expect(unchanged).toEqual({ version: 1, position: 1 });
+            this.expect(codeOf(refused)).toBe(CONCURRENCY_CONFLICT);
+        });
+        this.it('reads an unknown stream as empty', async () => {
+            this.expect(await this.subject.readStream('consignment-unknown')).toEqual([]);
+        });
+    }
+    refusesStaleVersions() {
+        this.it('refuses with a concurrency conflict an append at a version the stream no longer has, and keeps none of it', async () => {
+            await this.subject.append('consignment-c1', 0, [eventOf('e1')]);
+            const behind = await failureOf(() => this.subject.append('consignment-c1', 0, [eventOf('e2')]));
+            const ahead = await failureOf(() => this.subject.append('consignment-c1', 2, [eventOf('e3')]));
+            this.expect([codeOf(behind), codeOf(ahead)]).toEqual([CONCURRENCY_CONFLICT, CONCURRENCY_CONFLICT]);
+            this.expect((await this.subject.readStream('consignment-c1')).map(({ id }) => id)).toEqual(['e1']);
+        });
+        this.it('lets one of two appends at the same version through, and refuses the other', async () => {
+            await this.subject.append('consignment-c1', 0, [eventOf('e1')]);
+            const outcomes = await Promise.all([
+                failureOf(() => this.subject.append('consignment-c1', 1, [eventOf('left')])),
+                failureOf(() => this.subject.append('consignment-c1', 1, [eventOf('right')])),
+            ]);
+            this.expect(outcomes.filter((failure) => failure === undefined).length).toBe(1);
+            this.expect(outcomes.map(codeOf).filter((code) => code === CONCURRENCY_CONFLICT).length).toBe(1);
+            this.expect((await this.subject.readStream('consignment-c1')).length).toBe(2);
+        });
+    }
+    keepsStreamsApart() {
+        this.it('numbers each stream on its own', async () => {
+            await this.subject.append('consignment-c1', 0, [eventOf('a1'), eventOf('a2')]);
+            await this.subject.append('consignment-c2', 0, [eventOf('b1')]);
+            const second = await this.subject.readStream('consignment-c2');
+            this.expect(second.map(({ id, version }) => `${id}@${version}`)).toEqual(['b1@1']);
+            this.expect((await this.subject.readStream('consignment-c1')).length).toBe(2);
+        });
+    }
+}
+function codeOf(failure) {
+    return typeof failure === 'object' && failure !== null && 'code' in failure ? failure.code : undefined;
+}
+//# sourceMappingURL=stream-suite.js.map

package/dist/contracts/event-store/stream-suite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-suite.js","sourceRoot":"","sources":["../../../src/contracts/event-store/stream-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAmB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,oHAAoH;AACpH,MAAM,OAAO,WAAY,SAAQ,aAAyB;IAC9C,KAAK;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC5B,IAAI,CAAC,iBAAiB,EAAE,CAAC;IAC3B,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,EAAE,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;YACtG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChG,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YAE7D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEtC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACpF,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE;gBAClD,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE;aACnD,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CACL,mGAAmG,EACnG,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,GAAG;gBACX,KAAK,EAAE,KAAK;gBACZ,MAAM,EAAE,IAAI;gBACZ,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,IAAI;gBACV,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;gBACrB,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;aACrB,CAAC;YAEF,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/F,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YAE/D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;YAC7D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC,CAAC;YACrF,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC/E,CAAC,CACF,CAAC;IACJ,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;YAC5F,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChE,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAE/E,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC;YAEjE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5F,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,mFAAmF,EAAE,KAAK,IAAI,EAAE;YACtG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEhE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACrE,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAEpF,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,kCAAkC,EAAE,KAAK,IAAI,EAAE;YACrD,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,qBAAqB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,oBAAoB;QAC1B,IAAI,CAAC,EAAE,CACL,2GAA2G,EAC3G,KAAK,IAAI,EAAE;YACT,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEhE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAChG,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/F,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC,CAAC;YACnG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACrG,CAAC,CACF,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,4EAA4E,EAAE,KAAK,IAAI,EAAE;YAC/F,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEhE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACjC,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC5E,SAAS,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;aAC9E,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjG,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB;QACvB,IAAI,CAAC,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;YACnD,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC/E,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAEhE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC;YAE/D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;YACnF,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,MAAM,CAAC,OAAgB;IAC9B,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACzG,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { EventSourcingStores, EventStore } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+export interface EventStoreContractOptions {
+    readonly name: string;
+    /** A fresh, empty store; called before each test. */
+    createStore(): Awaitable<EventStore>;
+    /** The snapshot, checkpoint and key stores that come with it, fresh and empty; their suite runs when given. */
+    readonly createCompanions?: () => Awaitable<Pick<EventSourcingStores, 'snapshots' | 'checkpoints' | 'subjectKeys'>>;
+}
+/**
+ * What every adapter of the kernel `EventStore` port guarantees, the in-memory one included:
+ * an append at the version the stream still has, a concurrency conflict otherwise and nothing
+ * kept of it, each stream in its order, the whole store in the order of the appends with a
+ * position, and a read from a position. With `createCompanions`, the stores that come with it:
+ * snapshots never replaced by an older one, checkpoints moved from where they stand, keys of data
+ * subjects destroyed by an erasure.
+ */
+export declare function eventStoreContract(runner: ContractRunner, options: EventStoreContractOptions): void;
+//# sourceMappingURL=event-store-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/event-store-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,WAAW,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC;IACrC,+GAA+G;IAC/G,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,SAAS,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC,CAAC,CAAC;CACrH;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAanG"}

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

@@ -0,0 +1,21 @@
+import { CompanionStoresSuite } from './event-store/companion-stores-suite.js';
+import { StoreSuite } from './event-store/store-suite.js';
+import { StreamSuite } from './event-store/stream-suite.js';
+/**
+ * What every adapter of the kernel `EventStore` port guarantees, the in-memory one included:
+ * an append at the version the stream still has, a concurrency conflict otherwise and nothing
+ * kept of it, each stream in its order, the whole store in the order of the appends with a
+ * position, and a read from a position. With `createCompanions`, the stores that come with it:
+ * snapshots never replaced by an older one, checkpoints moved from where they stand, keys of data
+ * subjects destroyed by an erasure.
+ */
+export function eventStoreContract(runner, options) {
+    const create = () => options.createStore();
+    new StreamSuite(runner, create).describe(`${options.name} (event store contract: streams)`);
+    new StoreSuite(runner, create).describe(`${options.name} (event store contract: the whole store)`);
+    const { createCompanions } = options;
+    if (createCompanions !== undefined) {
+        new CompanionStoresSuite(runner, () => createCompanions()).describe(`${options.name} (event store contract: snapshots, checkpoints, keys)`);
+    }
+}
+//# sourceMappingURL=event-store-contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-contract.js","sourceRoot":"","sources":["../../src/contracts/event-store-contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAU5D;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAsB,EAAE,OAAkC;IAC3F,MAAM,MAAM,GAAG,GAA0B,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAElE,IAAI,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,kCAAkC,CAAC,CAAC;IAC5F,IAAI,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,0CAA0C,CAAC,CAAC;IAEnG,MAAM,EAAE,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAErC,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,gBAAgB,EAAE,CAAC,CAAC,QAAQ,CACjE,GAAG,OAAO,CAAC,IAAI,uDAAuD,CACvE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/contracts/event-store-unit-of-work-contract.d.ts

@@ -0,0 +1,15 @@
+import type { Awaitable } from './awaitable.js';
+import type { ContractRunner } from './contract-runner.js';
+import type { EventStoreUnderContract } from './event-store/event-store-under-contract.js';
+export interface EventStoreUnitOfWorkContractOptions {
+    readonly name: string;
+    /** An empty event store and an empty outbox of one database, bound to one unit of work; called before each test. */
+    createSubject(): Awaitable<EventStoreUnderContract>;
+}
+/**
+ * No double write for an event-sourced aggregate: what its save appends to its stream and what the
+ * publisher of its events writes to the outbox commit in one transaction, so nothing is published
+ * for an append that was rolled back or refused. Held by every transactional event store.
+ */
+export declare function eventStoreUnitOfWorkContract(runner: ContractRunner, options: EventStoreUnitOfWorkContractOptions): void;
+//# sourceMappingURL=event-store-unit-of-work-contract.d.ts.map

package/dist/contracts/event-store-unit-of-work-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-unit-of-work-contract.d.ts","sourceRoot":"","sources":["../../src/contracts/event-store-unit-of-work-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAG3F,MAAM,WAAW,mCAAmC;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oHAAoH;IACpH,aAAa,IAAI,SAAS,CAAC,uBAAuB,CAAC,CAAC;CACrD;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,mCAAmC,GAC3C,IAAI,CAIN"}

package/dist/contracts/event-store-unit-of-work-contract.js

@@ -0,0 +1,10 @@
+import { OneTransactionSuite } from './event-store/one-transaction-suite.js';
+/**
+ * No double write for an event-sourced aggregate: what its save appends to its stream and what the
+ * publisher of its events writes to the outbox commit in one transaction, so nothing is published
+ * for an append that was rolled back or refused. Held by every transactional event store.
+ */
+export function eventStoreUnitOfWorkContract(runner, options) {
+    new OneTransactionSuite(runner, () => options.createSubject()).describe(`${options.name} (event store contract: one transaction with the outbox)`);
+}
+//# sourceMappingURL=event-store-unit-of-work-contract.js.map

package/dist/contracts/event-store-unit-of-work-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-unit-of-work-contract.js","sourceRoot":"","sources":["../../src/contracts/event-store-unit-of-work-contract.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAQ7E;;;;GAIG;AACH,MAAM,UAAU,4BAA4B,CAC1C,MAAsB,EACtB,OAA4C;IAE5C,IAAI,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,QAAQ,CACrE,GAAG,OAAO,CAAC,IAAI,0DAA0D,CAC1E,CAAC;AACJ,CAAC"}

package/dist/contracts/job-store/a-job.d.ts

@@ -0,0 +1,24 @@
+import type { EnqueuedBy } from '@ddd-ts-kit/kernel';
+export interface JobOverrides {
+    readonly name?: string;
+    readonly queue?: string;
+    readonly runAt?: Date;
+    readonly idempotencyKey?: string;
+    readonly payload?: unknown;
+    /** The tenant of the work that enqueues it: `tenant-3` by default, `null` for none. */
+    readonly tenantId?: string | null;
+    readonly subject?: string;
+}
+/** A job of the contract: `billing.compile-statements`, due at `NOW` unless told otherwise. */
+export declare function aJob(id: string, overrides?: JobOverrides): {
+    id: string;
+    name: string;
+    queue: string;
+    payload: {};
+    enqueuedBy: EnqueuedBy;
+    enqueuedAt: Date;
+    runAt: Date;
+    idempotencyKey?: string;
+    subject?: string;
+};
+//# sourceMappingURL=a-job.d.ts.map

package/dist/contracts/job-store/a-job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-job.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/a-job.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOrD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,uFAAuF;IACvF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+FAA+F;AAC/F,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,GAAE,YAAiB;;;;;;;;;;EAc5D"}

package/dist/contracts/job-store/a-job.js

@@ -0,0 +1,28 @@
+import { NOW, QUEUE } from './job-fixtures.js';
+const TENANT = 'tenant-3';
+const TRACEPARENT = '00-0af7651916cd43dd8448eb211c80319c-b7ad6b7169203331-01';
+/** A job of the contract: `billing.compile-statements`, due at `NOW` unless told otherwise. */
+export function aJob(id, overrides = {}) {
+    const { name = 'billing.compile-statements', queue = QUEUE, runAt = NOW, idempotencyKey, subject } = overrides;
+    return {
+        id,
+        name,
+        queue,
+        payload: overrides.payload ?? { month: '2026-02', customers: ['c-1', 'c-2'], draft: false, total: 12.5 },
+        enqueuedBy: enqueuedBy(overrides.tenantId === undefined ? TENANT : overrides.tenantId),
+        enqueuedAt: NOW,
+        runAt,
+        ...(idempotencyKey === undefined ? {} : { idempotencyKey }),
+        ...(subject === undefined ? {} : { subject }),
+    };
+}
+function enqueuedBy(tenantId) {
+    const tenant = tenantId === null ? {} : { tenantId };
+    return {
+        correlationId: 'corr-1',
+        actor: { id: 'user-7', type: 'user', ...tenant, roles: ['accountant'], attributes: {} },
+        ...tenant,
+        traceparent: TRACEPARENT,
+    };
+}
+//# sourceMappingURL=a-job.js.map

package/dist/contracts/job-store/a-job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"a-job.js","sourceRoot":"","sources":["../../../src/contracts/job-store/a-job.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,MAAM,MAAM,GAAG,UAAU,CAAC;AAE1B,MAAM,WAAW,GAAG,yDAAyD,CAAC;AAa9E,+FAA+F;AAC/F,MAAM,UAAU,IAAI,CAAC,EAAU,EAAE,SAAS,GAAiB,EAAE;IAC3D,MAAM,EAAE,IAAI,GAAG,4BAA4B,EAAE,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC;IAE/G,OAAO;QACL,EAAE;QACF,IAAI;QACJ,KAAK;QACL,OAAO,EAAE,SAAS,CAAC,OAAO,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE;QACxG,UAAU,EAAE,UAAU,CAAC,SAAS,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QACtF,UAAU,EAAE,GAAG;QACf,KAAK;QACL,GAAG,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC;QAC3D,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;KAC9C,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,QAAuB;IACzC,MAAM,MAAM,GAAG,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;IAErD,OAAO;QACL,aAAa,EAAE,QAAQ;QACvB,KAAK,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QACvF,GAAG,MAAM;QACT,WAAW,EAAE,WAAW;KACzB,CAAC;AACJ,CAAC"}

package/dist/contracts/job-store/claim-suite.d.ts

@@ -0,0 +1,15 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** What `add` keeps and what `claim` hands out: due jobs of the queue, earliest first, each to one claim. */
+export declare class ClaimSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private handsOutWhatWasAdded;
+    private respectsTheInstant;
+    private dropsDuplicates;
+    private keepsTheKeysOfTenantsApart;
+    private leasesWhatItHandsOut;
+    private addMany;
+    private claim;
+    private claimedIds;
+}
+//# sourceMappingURL=claim-suite.d.ts.map

package/dist/contracts/job-store/claim-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claim-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/claim-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,6GAA6G;AAC7G,qBAAa,UAAW,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IAClE,SAAS,CAAC,KAAK,IAAI,IAAI,CAMtB;IAED,OAAO,CAAC,oBAAoB;IAsC5B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,0BAA0B;IA+BlC,OAAO,CAAC,oBAAoB;YA+Bd,OAAO;IAMrB,OAAO,CAAC,KAAK;YAIC,UAAU;CAGzB"}

package/dist/contracts/job-store/claim-suite.js

@@ -0,0 +1,126 @@
+import { ContractSuite } from '../contract-suite.js';
+import { aJob } from './a-job.js';
+import { LEASE_MS, NOW, QUEUE } from './job-fixtures.js';
+import { later } from './later.js';
+/** What `add` keeps and what `claim` hands out: due jobs of the queue, earliest first, each to one claim. */
+export class ClaimSuite extends ContractSuite {
+    tests() {
+        this.handsOutWhatWasAdded();
+        this.respectsTheInstant();
+        this.dropsDuplicates();
+        this.keepsTheKeysOfTenantsApart();
+        this.leasesWhatItHandsOut();
+    }
+    handsOutWhatWasAdded() {
+        this.it('starts empty', async () => {
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 0, dead: 0 });
+            this.expect(await this.claimedIds(10, NOW)).toEqual([]);
+            this.expect(await this.subject.find('unknown')).toBe(undefined);
+        });
+        this.it('hands out the job exactly as added, the attempt counted, and shows it running', async () => {
+            const added = await this.subject.add(aJob('job-1'));
+            const [claimed] = await this.claim(10, NOW);
+            const { enqueuedBy, payload, name } = aJob('job-1');
+            this.expect(added).toEqual({ id: 'job-1', duplicate: false });
+            this.expect(claimed).toEqual({
+                id: 'job-1',
+                name,
+                queue: QUEUE,
+                payload,
+                enqueuedBy,
+                enqueuedAt: NOW,
+                attempt: 1,
+            });
+            this.expect((await this.subject.find('job-1'))?.status).toBe('running');
+            this.expect(await this.subject.stats(QUEUE)).toEqual({ waiting: 0, running: 1, dead: 0 });
+        });
+        this.it('hands out the earliest first and only the jobs of the queue asked', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(-1_000) }));
+            await this.subject.add(aJob('job-2', { runAt: later(-3_000) }));
+            await this.subject.add(aJob('job-3', { name: 'audit.verify-chain', queue: 'audit' }));
+            await this.subject.add(aJob('job-4', { runAt: later(-1_000) }));
+            this.expect(await this.claimedIds(10, NOW)).toEqual(['job-2', 'job-1', 'job-4']);
+        });
+    }
+    respectsTheInstant() {
+        this.it('keeps a job due later until its instant', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(60_000) }));
+            this.expect(await this.claimedIds(10, later(59_999))).toEqual([]);
+            this.expect(await this.claimedIds(10, later(60_000))).toEqual(['job-1']);
+        });
+        this.it('honours the limit and leaves the rest to the next claim', async () => {
+            await this.addMany(['job-1', 'job-2', 'job-3']);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['job-1', 'job-2']);
+            this.expect(await this.claimedIds(2, NOW)).toEqual(['job-3']);
+        });
+    }
+    dropsDuplicates() {
+        this.it('answers the job already kept for the same name and idempotency key, and adds nothing', async () => {
+            await this.subject.add(aJob('job-1', { idempotencyKey: 'feb' }));
+            const again = await this.subject.add(aJob('job-2', { idempotencyKey: 'feb' }));
+            const otherName = await this.subject.add(aJob('job-3', { idempotencyKey: 'feb', name: 'billing.send-statements' }));
+            this.expect(again).toEqual({ id: 'job-1', duplicate: true });
+            this.expect(otherName).toEqual({ id: 'job-3', duplicate: false });
+            this.expect(await this.subject.find('job-2')).toBe(undefined);
+        });
+    }
+    keepsTheKeysOfTenantsApart() {
+        this.it('keeps the idempotency keys of two tenants, and of work without a tenant, apart', async () => {
+            await this.subject.add(aJob('job-1', { idempotencyKey: 'feb' }));
+            const otherTenant = await this.subject.add(aJob('job-2', { idempotencyKey: 'feb', tenantId: 'tenant-4' }));
+            const noTenant = await this.subject.add(aJob('job-3', { idempotencyKey: 'feb', tenantId: null }));
+            const noTenantAgain = await this.subject.add(aJob('job-4', { idempotencyKey: 'feb', tenantId: null }));
+            this.expect([otherTenant, noTenant, noTenantAgain]).toEqual([
+                { id: 'job-2', duplicate: false },
+                { id: 'job-3', duplicate: false },
+                { id: 'job-3', duplicate: true },
+            ]);
+        });
+        this.it('shows the tenant and the subject of a job, never its payload', async () => {
+            await this.subject.add(aJob('job-1', { subject: 'customer-9' }));
+            await this.subject.add(aJob('job-2', { tenantId: null }));
+            const [first, second] = [await this.subject.find('job-1'), await this.subject.find('job-2')];
+            this.expect([first?.tenantId, first?.subject, first !== undefined && 'payload' in first]).toEqual([
+                'tenant-3',
+                'customer-9',
+                false,
+            ]);
+            this.expect([second?.tenantId, second?.subject]).toEqual([undefined, undefined]);
+        });
+    }
+    leasesWhatItHandsOut() {
+        this.it('hides a claimed job until its lease ends, then hands it out again, one attempt more', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(10, NOW);
+            this.expect(await this.claimedIds(10, later(LEASE_MS - 1))).toEqual([]);
+            const [again] = await this.claim(10, later(LEASE_MS));
+            this.expect(again?.attempt).toBe(2);
+        });
+        this.it('keeps a job hidden while its heartbeats extend the lease', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(10, NOW);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 1 }, later(LEASE_MS * 2))).toBe(true);
+            this.expect(await this.claimedIds(10, later(LEASE_MS))).toEqual([]);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 2 }, later(LEASE_MS * 3))).toBe(false);
+        });
+        this.it('never hands the same job to two concurrent claims', async () => {
+            await this.addMany(['job-1', 'job-2', 'job-3', 'job-4', 'job-5', 'job-6']);
+            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);
+        });
+    }
+    async addMany(ids) {
+        for (const id of ids) {
+            await this.subject.add(aJob(id));
+        }
+    }
+    claim(limit, now) {
+        return this.subject.claim({ queue: QUEUE, limit, now, leaseMs: LEASE_MS });
+    }
+    async claimedIds(limit, now) {
+        return (await this.claim(limit, now)).map((job) => job.id);
+    }
+}
+//# sourceMappingURL=claim-suite.js.map

package/dist/contracts/job-store/claim-suite.js.map

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

package/dist/contracts/job-store/job-fixtures.d.ts

@@ -0,0 +1,5 @@
+/** The instants and the queue every job of the contract uses. */
+export declare const NOW: Date;
+export declare const LEASE_MS = 30000;
+export declare const QUEUE = "billing";
+//# sourceMappingURL=job-fixtures.d.ts.map

package/dist/contracts/job-store/job-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-fixtures.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/job-fixtures.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,eAAO,MAAM,GAAG,MAAuC,CAAC;AAExD,eAAO,MAAM,QAAQ,QAAS,CAAC;AAE/B,eAAO,MAAM,KAAK,YAAY,CAAC"}

package/dist/contracts/job-store/job-fixtures.js

@@ -0,0 +1,5 @@
+/** The instants and the queue every job of the contract uses. */
+export const NOW = new Date('2026-03-01T10:00:00.000Z');
+export const LEASE_MS = 30_000;
+export const QUEUE = 'billing';
+//# sourceMappingURL=job-fixtures.js.map

package/dist/contracts/job-store/job-fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-fixtures.js","sourceRoot":"","sources":["../../../src/contracts/job-store/job-fixtures.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAExD,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE/B,MAAM,CAAC,MAAM,KAAK,GAAG,SAAS,CAAC"}

package/dist/contracts/job-store/job-store-under-contract.d.ts

@@ -0,0 +1,61 @@
+import type { EnqueuedBy, EnqueuedJob, JobProgress, QueuedJob } from '@ddd-ts-kit/kernel';
+interface Lease {
+    readonly id: string;
+    readonly attempt: number;
+}
+interface Claimed {
+    readonly id: string;
+    readonly name: string;
+    readonly queue: string;
+    readonly payload: unknown;
+    readonly enqueuedBy: EnqueuedBy;
+    readonly enqueuedAt: Date;
+    readonly attempt: number;
+    readonly checkpoint?: unknown;
+}
+/**
+ * The job store port of `@ddd-ts-kit/scheduling`, restated structurally so that this package
+ * does not depend on it. Any `JobStore` fits.
+ */
+export interface JobStoreUnderContract {
+    add(job: {
+        readonly id: string;
+        readonly name: string;
+        readonly queue: string;
+        readonly payload: unknown;
+        readonly enqueuedBy: EnqueuedBy;
+        readonly enqueuedAt: Date;
+        readonly runAt: Date;
+        readonly idempotencyKey?: string;
+        readonly subject?: string;
+    }): Promise<EnqueuedJob>;
+    claim(request: {
+        queue: string;
+        limit: number;
+        now: Date;
+        leaseMs: number;
+    }): Promise<Claimed[]>;
+    heartbeat(lease: Lease, leaseUntil: Date): Promise<boolean>;
+    update(lease: Lease, update: {
+        progress?: JobProgress;
+        checkpoint?: unknown;
+    }, leaseUntil: Date): Promise<boolean>;
+    complete(lease: Lease, at: Date): Promise<boolean>;
+    fail(lease: Lease, failure: {
+        errorCode: string;
+        retryAt: Date | null;
+        at: Date;
+    }): Promise<boolean>;
+    release(lease: Lease, runAt: Date): Promise<boolean>;
+    cancel(id: string, at: Date): Promise<boolean>;
+    find(id: string): Promise<QueuedJob | undefined>;
+    retryDead(ids: readonly string[], now: Date): Promise<number>;
+    purgeFinished(before: Date): Promise<number>;
+    stats(queue: string): Promise<{
+        readonly waiting: number;
+        readonly running: number;
+        readonly dead: number;
+    }>;
+}
+export {};
+//# sourceMappingURL=job-store-under-contract.d.ts.map

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

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

package/dist/contracts/job-store/job-store-under-contract.js

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

package/dist/contracts/job-store/job-store-under-contract.js.map

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

package/dist/contracts/job-store/keep-suite.d.ts

@@ -0,0 +1,11 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { JobStoreUnderContract } from './job-store-under-contract.js';
+/** Cancellation and housekeeping. */
+export declare class KeepSuite extends ContractSuite<JobStoreUnderContract> {
+    protected tests(): void;
+    private cancels;
+    private purges;
+    private finished;
+    private claim;
+}
+//# sourceMappingURL=keep-suite.d.ts.map

package/dist/contracts/job-store/keep-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/keep-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAE3E,qCAAqC;AACrC,qBAAa,SAAU,SAAQ,aAAa,CAAC,qBAAqB,CAAC;IACjE,SAAS,CAAC,KAAK,IAAI,IAAI,CAGtB;IAED,OAAO,CAAC,OAAO;IA+Bf,OAAO,CAAC,MAAM;YAcA,QAAQ;IAMtB,OAAO,CAAC,KAAK;CAGd"}

package/dist/contracts/job-store/keep-suite.js

@@ -0,0 +1,55 @@
+import { ContractSuite } from '../contract-suite.js';
+import { aJob } from './a-job.js';
+import { LEASE_MS, NOW, QUEUE } from './job-fixtures.js';
+import { later } from './later.js';
+/** Cancellation and housekeeping. */
+export class KeepSuite extends ContractSuite {
+    tests() {
+        this.cancels();
+        this.purges();
+    }
+    cancels() {
+        this.it('cancels a waiting job: it is never handed out', async () => {
+            await this.subject.add(aJob('job-1', { runAt: later(60_000) }));
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(true);
+            const job = await this.subject.find('job-1');
+            this.expect([job?.status, job?.finishedAt]).toEqual(['cancelled', NOW]);
+            this.expect(await this.claim(later(60_000))).toEqual([]);
+        });
+        this.it('cancels a running job: its next report is refused', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(NOW);
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(true);
+            this.expect(await this.subject.heartbeat({ id: 'job-1', attempt: 1 }, later(LEASE_MS))).toBe(false);
+            this.expect(await this.subject.complete({ id: 'job-1', attempt: 1 }, NOW)).toBe(false);
+        });
+        this.it('cannot cancel what is over or unknown', async () => {
+            await this.subject.add(aJob('job-1'));
+            await this.claim(NOW);
+            await this.subject.complete({ id: 'job-1', attempt: 1 }, NOW);
+            this.expect(await this.subject.cancel('job-1', NOW)).toBe(false);
+            this.expect(await this.subject.cancel('unknown', NOW)).toBe(false);
+        });
+    }
+    purges() {
+        this.it('purges what succeeded or was cancelled before the instant, and keeps the dead', async () => {
+            await this.finished('job-1', (lease) => this.subject.complete(lease, NOW));
+            await this.finished('job-2', (lease) => this.subject.fail(lease, { errorCode: 'X', retryAt: null, at: NOW }));
+            await this.subject.add(aJob('job-3', { runAt: later(60_000) }));
+            await this.subject.cancel('job-3', later(1_000));
+            this.expect(await this.subject.purgeFinished(NOW)).toBe(0);
+            this.expect(await this.subject.purgeFinished(later(1_001))).toBe(2);
+            this.expect(await this.subject.find('job-1')).toBe(undefined);
+            this.expect((await this.subject.find('job-2'))?.status).toBe('dead');
+        });
+    }
+    async finished(id, finish) {
+        await this.subject.add(aJob(id));
+        await this.claim(NOW);
+        await finish({ id, attempt: 1 });
+    }
+    claim(now) {
+        return this.subject.claim({ queue: QUEUE, limit: 10, now, leaseMs: LEASE_MS });
+    }
+}
+//# sourceMappingURL=keep-suite.js.map

package/dist/contracts/job-store/keep-suite.js.map

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

package/dist/contracts/job-store/later.d.ts

@@ -0,0 +1,3 @@
+/** That many milliseconds after `NOW`. */
+export declare function later(ms: number): Date;
+//# sourceMappingURL=later.d.ts.map

package/dist/contracts/job-store/later.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"later.d.ts","sourceRoot":"","sources":["../../../src/contracts/job-store/later.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtC"}