@ddd-ts-kit/testing 0.8.0 → 0.10.0

package/README.md

@@ -184,6 +184,22 @@ side, so they read well under any runner. An error raised by `when` is never swa
 assertion but `thenError` fails on it. When `when` (or the arrangement) is asynchronous, the
 chain is a promise: `await given(order).when(async (o) => ...).thenEventNames([...])`.
 
+### An event-sourced aggregate
+
+`givenEvents(rehydrate, events)` rebuilds the aggregate by replaying its history, without a
+database, and the scenario goes on as above: one command, then the events it recorded or the
+refusal.
+
+```ts
+givenEvents((id, history) => AttendanceRecord.rehydrate(id, history), [opened, noShowNoted, noShowNoted])
+  .when((record) => record.noteNoShow('appointment-9', now))
+  .thenEvents([NoShowNoted, AttendanceRecordBarred]);
+```
+
+`expectSnapshotEquivalence({ events, rehydrate, policy, state })` proves the snapshots of an
+aggregate: for every version of the history, the aggregate rebuilt from the snapshot its policy
+would store and the events after it has the state and the version of the full replay.
+
 ## Refusals
 
 A business refusal is known by its code, and carries its facts as data: a test asserts both,
@@ -436,12 +452,15 @@ repositoryContract(runner, { ...options, name: 'DrizzleOrderRepository', createR
 | `unitOfWorkContract` | any `UnitOfWork`, called through `run` without a command bus: domain events wait for the end and are dispatched before the commit, so handlers see every save and what they write, the outbox included, commits with it; a failure in a save, in the work, in a handler or in the commit (a deferred constraint) leaves nothing behind; `after-commit` handlers run once the rows are committed, never otherwise. An adapter not built on `withinUnitOfWork` fails here |
 | `outboxStoreContract` | any outbox store: order, limit, lease, concurrent claims, published, failed, dead, `retryDead`, purge; with `carriesTenant: true`, the tenant of each event kept |
 | `processedEventStoreContract` | any `ProcessedEventStore`: once per consumer and event, also under concurrent deliveries |
+| `eventStoreContract` | any `EventStore`: a stream created at version 0 and read back in order, numbered from 1, with its type, shape version, data, metadata and instant; an append at a version the stream no longer has (behind or ahead) refused with `CONCURRENCY_CONFLICT` and nothing kept of it; one of two appends at the same version through; streams numbered apart; the whole store read in the order of the appends, positions rising from 1, after a position and within a limit; `head()` |
+| `eventStoreUnitOfWorkContract` | a transactional `EventStore` with the outbox of its database under one `UnitOfWork`: the stream and the outbox records published for its events commit together; nothing left in the outbox for an append rolled back, nor for one refused by a concurrency conflict. `createSubject()` answers `{ unitOfWork, store, outbox }` |
 | `cacheContract` | any `Cache`: round trip of every shape of value, isolation of entries, deletion, time to live |
 | `lockContract` | any `Lock`: one holder at a time also under concurrent requests, release, expiry, a late release ignored, growing fencing token, `waitMs` |
 | `jobSchedulerContract` | any `JobScheduler`: registration and description, a duplicate name and an unreadable schedule refused, `runNow` (also for a disabled job, an unknown name rejected), nothing by time before `start` or after `stop`, no overlap by default, a failing job answered `failed` with its code while the others go on, the execution context of a run |
 | `loggerContract` | any `Logger`: every level with its message and fields of every shape, level and message that no field forges, children that add their fields and nest, fields read at each entry, an entry below the level dropped without reading a field, `isLevelEnabled` answering what is written (for a child too), no throw on a circular field or a getter that throws, at the top of the fields included; an `Error` passed as a field written as its description (`type`, `code` of a `DomainError`, `message`, own `stack`, `cause`, eight errors deep at most), its message replaced when the logger scrubs unless it is a `DomainError`; every entry in the sink once `flush()` resolves, then no throw from a log call or a second flush. `createLogger({ level, fields, scrubMessages })` answers the logger and `lines()`, what its sink received as `{ level, message, fields }`. No capability flag: `InMemoryLogger` takes the same three options and passes the whole suite |
 | `criteriaContract` | any translator of criteria, the in-memory evaluator included: a table of criteria and the ids each answers, in order, over eight fixed rows. Every operator on every type it applies to, decimals as numbers, instants to the millisecond and across zones, case and the characters a `LIKE` would trip on, nulls under each operator, `and`, `or`, `not` and what a negation does to a null, sorts with ties and nulls in both directions, offset pages with their total, every sort walked by cursor one and two rows at a time, the four kinds of access scope, and hostile values. `createReadModel(rows)` answers `{ search(scopedCriteria) }` over exactly those rows, read with `criteriaContractDefinition` |
 | `readModelStoreContract` | any `ReadModelTable` under `TableReadModelStore`: rows of every type round trip, the current row handed to a later event, an event applied once, never one older than the row, order by event id at the same instant and by version when given, concurrent writes ending on the latest, deletions that last, listing by criteria and scope, and `ProjectionRebuild`: rebuilt from the source alone, no event lost while it exports (on a row already copied and on one not yet), stale and new events after the swap, deletions during and before it, a failed export leaving the table as it was, the table still itself after two rebuilds. `createTable()` answers `{ table, unitOfWork }`; `SourceOfTruth` is the fake of the source |
+| `fileStorageContract` | any `FileStorage`: content round trip with size, media type and checksum, several mebibytes streamed, a write beyond `maxBytes` refused leaving the previous content, keys that could leave their place refused, deletion, copy, move, listing by prefix, signed download and upload links that expire, refuse a changed signature or another media type, and are never signed for more than an hour, a download served as an attachment even without a name. `follow` sends a request to a link: `fetch` by default, `followServed(storage)` for a storage the application serves |
 | `rateLimiterContract` | any `RateLimiter`: limit, `remaining` and `retryAfterMs`, refused calls not counted, sliding window, isolation of keys, concurrent calls |
 
 The cache, lock and rate limiter suites also take `elapse(ms)`, which makes time pass for the

package/dist/contracts/event-store/companion-stores-suite.d.ts

@@ -0,0 +1,12 @@
+import { type EventSourcingStores } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+type Companions = Pick<EventSourcingStores, 'snapshots' | 'checkpoints' | 'subjectKeys'>;
+/** The stores that come with an event store: snapshots, checkpoints of the subscriptions, keys of the data subjects. */
+export declare class CompanionStoresSuite extends ContractSuite<Companions> {
+    protected tests(): void;
+    private keepsTheLatestSnapshot;
+    private movesCheckpointsFromWhereTheyStand;
+    private destroysKeys;
+}
+export {};
+//# sourceMappingURL=companion-stores-suite.d.ts.map

package/dist/contracts/event-store/companion-stores-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"companion-stores-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/companion-stores-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,KAAK,UAAU,GAAG,IAAI,CAAC,mBAAmB,EAAE,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC,CAAC;AAEzF,wHAAwH;AACxH,qBAAa,oBAAqB,SAAQ,aAAa,CAAC,UAAU,CAAC;IACjE,SAAS,CAAC,KAAK,IAAI,IAAI,CAItB;IAED,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,kCAAkC;IA6B1C,OAAO,CAAC,YAAY;CAcrB"}

package/dist/contracts/event-store/companion-stores-suite.js

@@ -0,0 +1,60 @@
+import { CONCURRENCY_CONFLICT } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import { failureOf } from '../failure-of.js';
+/** The stores that come with an event store: snapshots, checkpoints of the subscriptions, keys of the data subjects. */
+export class CompanionStoresSuite extends ContractSuite {
+    tests() {
+        this.keepsTheLatestSnapshot();
+        this.movesCheckpointsFromWhereTheyStand();
+        this.destroysKeys();
+    }
+    keepsTheLatestSnapshot() {
+        this.it('keeps the snapshot of a stream as saved, and never replaces it by an older one', async () => {
+            const { snapshots } = this.subject;
+            const later = { stream: 'consignment-c1', version: 6, schemaVersion: 2, data: { grams: 600, tags: ['a'] } };
+            await snapshots.save({ stream: 'consignment-c1', version: 3, schemaVersion: 2, data: { grams: 300 } });
+            await snapshots.save(later);
+            await snapshots.save({ stream: 'consignment-c1', version: 4, schemaVersion: 2, data: { grams: 400 } });
+            this.expect(await snapshots.find('consignment-c1')).toEqual(later);
+            this.expect(await snapshots.find('consignment-c2')).toBe(undefined);
+        });
+    }
+    movesCheckpointsFromWhereTheyStand() {
+        this.it('starts a subscriber at 0 and moves it from where it stands, refusing a move from elsewhere', async () => {
+            const { checkpoints } = this.subject;
+            this.expect(await checkpoints.position('shipping.weights')).toBe(0);
+            await checkpoints.advance('shipping.weights', 0, 4);
+            await checkpoints.advance('shipping.weights', 4, 9);
+            const stale = await failureOf(() => checkpoints.advance('shipping.weights', 4, 12));
+            const fresh = await failureOf(() => checkpoints.advance('shipping.labels', 3, 5));
+            this.expect([codeOf(stale), codeOf(fresh)]).toEqual([CONCURRENCY_CONFLICT, CONCURRENCY_CONFLICT]);
+            this.expect(await checkpoints.position('shipping.weights')).toBe(9);
+            this.expect(await checkpoints.position('shipping.labels')).toBe(0);
+        });
+        this.it('lets one of two runs starting from 0 move the checkpoint', async () => {
+            const { checkpoints } = this.subject;
+            const outcomes = await Promise.all([
+                failureOf(() => checkpoints.advance('shipping.weights', 0, 3)),
+                failureOf(() => checkpoints.advance('shipping.weights', 0, 3)),
+            ]);
+            this.expect(outcomes.filter((failure) => failure === undefined).length).toBe(1);
+        });
+    }
+    destroysKeys() {
+        this.it('gives a subject one key until it is erased, then a new one that the old id never finds', async () => {
+            const { subjectKeys } = this.subject;
+            const first = await subjectKeys.keyFor('patient-1');
+            this.expect(await subjectKeys.keyFor('patient-1')).toEqual(first);
+            this.expect(await subjectKeys.find(first.id)).toEqual(first);
+            this.expect(Buffer.from(first.material, 'base64').length).toBe(32);
+            this.expect(await subjectKeys.erase('patient-1')).toBe(true);
+            this.expect(await subjectKeys.find(first.id)).toBe(undefined);
+            this.expect(await subjectKeys.erase('patient-1')).toBe(false);
+            this.expect((await subjectKeys.keyFor('patient-1')).id === first.id).toBe(false);
+        });
+    }
+}
+function codeOf(failure) {
+    return typeof failure === 'object' && failure !== null && 'code' in failure ? failure.code : undefined;
+}
+//# sourceMappingURL=companion-stores-suite.js.map

package/dist/contracts/event-store/companion-stores-suite.js.map

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

package/dist/contracts/event-store/consignment-registered.d.ts

@@ -0,0 +1,8 @@
+import type { DomainEvent } from '@ddd-ts-kit/kernel';
+export declare class ConsignmentRegistered implements DomainEvent {
+    readonly aggregateId: string;
+    readonly occurredAt: Date;
+    readonly name = "shipping.consignment.registered";
+    constructor(aggregateId: string, occurredAt: Date);
+}
+//# sourceMappingURL=consignment-registered.d.ts.map

package/dist/contracts/event-store/consignment-registered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consignment-registered.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/consignment-registered.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qBAAa,qBAAsB,YAAW,WAAW;IAIrD,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,UAAU,EAAE,IAAI;IAJ3B,QAAQ,CAAC,IAAI,qCAAqC;IAElD,YACW,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,IAAI,EACvB;CACL"}

package/dist/contracts/event-store/consignment-registered.js

@@ -0,0 +1,10 @@
+export class ConsignmentRegistered {
+    aggregateId;
+    occurredAt;
+    name = 'shipping.consignment.registered';
+    constructor(aggregateId, occurredAt) {
+        this.aggregateId = aggregateId;
+        this.occurredAt = occurredAt;
+    }
+}
+//# sourceMappingURL=consignment-registered.js.map

package/dist/contracts/event-store/consignment-registered.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consignment-registered.js","sourceRoot":"","sources":["../../../src/contracts/event-store/consignment-registered.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,qBAAqB;IAIrB,WAAW;IACX,UAAU;IAJZ,IAAI,GAAG,iCAAiC,CAAC;IAElD,YACW,WAAmB,EACnB,UAAgB;2BADhB,WAAW;0BACX,UAAU;IAClB,CAAC;CACL"}

package/dist/contracts/event-store/consignment-weighed.d.ts

@@ -0,0 +1,9 @@
+import type { DomainEvent } from '@ddd-ts-kit/kernel';
+export declare class ConsignmentWeighed implements DomainEvent {
+    readonly aggregateId: string;
+    readonly occurredAt: Date;
+    readonly grams: number;
+    readonly name = "shipping.consignment.weighed";
+    constructor(aggregateId: string, occurredAt: Date, grams: number);
+}
+//# sourceMappingURL=consignment-weighed.d.ts.map

package/dist/contracts/event-store/consignment-weighed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consignment-weighed.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/consignment-weighed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,qBAAa,kBAAmB,YAAW,WAAW;IAIlD,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,UAAU,EAAE,IAAI;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM;IALxB,QAAQ,CAAC,IAAI,kCAAkC;IAE/C,YACW,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,IAAI,EAChB,KAAK,EAAE,MAAM,EACpB;CACL"}

package/dist/contracts/event-store/consignment-weighed.js

@@ -0,0 +1,12 @@
+export class ConsignmentWeighed {
+    aggregateId;
+    occurredAt;
+    grams;
+    name = 'shipping.consignment.weighed';
+    constructor(aggregateId, occurredAt, grams) {
+        this.aggregateId = aggregateId;
+        this.occurredAt = occurredAt;
+        this.grams = grams;
+    }
+}
+//# sourceMappingURL=consignment-weighed.js.map

package/dist/contracts/event-store/consignment-weighed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consignment-weighed.js","sourceRoot":"","sources":["../../../src/contracts/event-store/consignment-weighed.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,kBAAkB;IAIlB,WAAW;IACX,UAAU;IACV,KAAK;IALP,IAAI,GAAG,8BAA8B,CAAC;IAE/C,YACW,WAAmB,EACnB,UAAgB,EAChB,KAAa;2BAFb,WAAW;0BACX,UAAU;qBACV,KAAK;IACb,CAAC;CACL"}

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

@@ -0,0 +1,16 @@
+import { EventSourcedAggregate, type AggregateHistory, type Appliers } from '@ddd-ts-kit/kernel';
+import { ConsignmentRegistered } from './consignment-registered.js';
+import { ConsignmentWeighed } from './consignment-weighed.js';
+export type ConsignmentEvent = ConsignmentRegistered | ConsignmentWeighed;
+/** The event-sourced aggregate of the contract: born registered, weighed any number of times. */
+export declare class Consignment extends EventSourcedAggregate<ConsignmentEvent> {
+    private grams;
+    private constructor();
+    static register(id: string): Consignment;
+    static rehydrate(id: string, history: AggregateHistory<ConsignmentEvent>): Consignment;
+    weigh(grams: number): this;
+    get weight(): number;
+    protected appliers(): Appliers<ConsignmentEvent>;
+    private applyWeighed;
+}
+//# sourceMappingURL=consignment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consignment.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/consignment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,KAAK,gBAAgB,EAAE,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;AAI1E,iGAAiG;AACjG,qBAAa,WAAY,SAAQ,qBAAqB,CAAC,gBAAgB,CAAC;IACtE,OAAO,CAAC,KAAK,CAAK;IAElB,OAAO,eAEN;IAED,MAAM,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,CAMvC;IAED,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,WAAW,CAErF;IAED,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIzB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,SAAS,CAAC,QAAQ,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAK/C;IAED,OAAO,CAAC,YAAY;CAGrB"}

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

@@ -0,0 +1,36 @@
+import { EventSourcedAggregate } from '@ddd-ts-kit/kernel';
+import { ConsignmentRegistered } from './consignment-registered.js';
+import { ConsignmentWeighed } from './consignment-weighed.js';
+const AT = new Date('2026-03-01T10:00:00.000Z');
+/** The event-sourced aggregate of the contract: born registered, weighed any number of times. */
+export class Consignment extends EventSourcedAggregate {
+    grams = 0;
+    constructor(id) {
+        super(id);
+    }
+    static register(id) {
+        const consignment = new Consignment(id);
+        consignment.record(new ConsignmentRegistered(id, AT));
+        return consignment;
+    }
+    static rehydrate(id, history) {
+        return new Consignment(id).replay(history);
+    }
+    weigh(grams) {
+        this.record(new ConsignmentWeighed(this.id, AT, grams));
+        return this;
+    }
+    get weight() {
+        return this.grams;
+    }
+    appliers() {
+        return {
+            'shipping.consignment.registered': () => undefined,
+            'shipping.consignment.weighed': (event) => this.applyWeighed(event),
+        };
+    }
+    applyWeighed(event) {
+        this.grams = event.grams;
+    }
+}
+//# sourceMappingURL=consignment.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consignment.js","sourceRoot":"","sources":["../../../src/contracts/event-store/consignment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAwC,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAI9D,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAEhD,iGAAiG;AACjG,MAAM,OAAO,WAAY,SAAQ,qBAAuC;IAC9D,KAAK,GAAG,CAAC,CAAC;IAElB,YAAoB,EAAU;QAC5B,KAAK,CAAC,EAAE,CAAC,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,EAAU;QACxB,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;QAExC,WAAW,CAAC,MAAM,CAAC,IAAI,qBAAqB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAEtD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,EAAU,EAAE,OAA2C;QACtE,OAAO,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;QAExD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAES,QAAQ;QAChB,OAAO;YACL,iCAAiC,EAAE,GAAG,EAAE,CAAC,SAAS;YAClD,8BAA8B,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;SACpE,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,KAAyB;QAC5C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC3B,CAAC;CACF"}

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

@@ -0,0 +1,10 @@
+import { type EventStore } from '@ddd-ts-kit/kernel';
+import { Consignment } from './consignment.js';
+/** The repository adapter of the contract: it delegates to `EventSourcedRepository`, and knows nothing of events. */
+export declare class Consignments {
+    private readonly streams;
+    constructor(store: EventStore);
+    findById(id: string): Promise<Consignment | undefined>;
+    save(consignment: Consignment): Promise<void>;
+}
+//# sourceMappingURL=consignments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consignments.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/consignments.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8D,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AAItE,qHAAqH;AACrH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAEhF,YAAY,KAAK,EAAE,UAAU,EAmB5B;IAED,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAErD;IAED,IAAI,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5C;CACF"}

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

@@ -0,0 +1,34 @@
+import { EventSerializer, EventSourcedRepository, defineStoredEvent } from '@ddd-ts-kit/kernel';
+import { Consignment } from './consignment.js';
+import { ConsignmentRegistered } from './consignment-registered.js';
+import { ConsignmentWeighed } from './consignment-weighed.js';
+/** The repository adapter of the contract: it delegates to `EventSourcedRepository`, and knows nothing of events. */
+export class Consignments {
+    streams;
+    constructor(store) {
+        this.streams = new EventSourcedRepository({
+            store,
+            category: 'shipping.consignment',
+            serializer: new EventSerializer({
+                'shipping.consignment.registered': defineStoredEvent(ConsignmentRegistered, {
+                    version: 1,
+                    encode: () => ({}),
+                    decode: (_data, { aggregateId, occurredAt }) => new ConsignmentRegistered(aggregateId, occurredAt),
+                }),
+                'shipping.consignment.weighed': defineStoredEvent(ConsignmentWeighed, {
+                    version: 1,
+                    encode: (event) => ({ grams: event.grams }),
+                    decode: (data, { aggregateId, occurredAt }) => new ConsignmentWeighed(aggregateId, occurredAt, data.number('grams')),
+                }),
+            }),
+            rehydrate: (id, history) => Consignment.rehydrate(id, history),
+        });
+    }
+    findById(id) {
+        return this.streams.findById(id);
+    }
+    save(consignment) {
+        return this.streams.save(consignment);
+    }
+}
+//# sourceMappingURL=consignments.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"consignments.js","sourceRoot":"","sources":["../../../src/contracts/event-store/consignments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,iBAAiB,EAAmB,MAAM,oBAAoB,CAAC;AACjH,OAAO,EAAE,WAAW,EAAyB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,qHAAqH;AACrH,MAAM,OAAO,YAAY;IACN,OAAO,CAAwD;IAEhF,YAAY,KAAiB;QAC3B,IAAI,CAAC,OAAO,GAAG,IAAI,sBAAsB,CAAC;YACxC,KAAK;YACL,QAAQ,EAAE,sBAAsB;YAChC,UAAU,EAAE,IAAI,eAAe,CAAmB;gBAChD,iCAAiC,EAAE,iBAAiB,CAAC,qBAAqB,EAAE;oBAC1E,OAAO,EAAE,CAAC;oBACV,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;oBAClB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,IAAI,qBAAqB,CAAC,WAAW,EAAE,UAAU,CAAC;iBACnG,CAAC;gBACF,8BAA8B,EAAE,iBAAiB,CAAC,kBAAkB,EAAE;oBACpE,OAAO,EAAE,CAAC;oBACV,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;oBAC3C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAC5C,IAAI,kBAAkB,CAAC,WAAW,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;iBACxE,CAAC;aACH,CAAC;YACF,SAAS,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,CAAC;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,QAAQ,CAAC,EAAU;QACjB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,WAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;CACF"}

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

@@ -0,0 +1,4 @@
+import type { EventToAppend } from '@ddd-ts-kit/kernel';
+/** An event to append, told apart by its id, with data that exercises the JSON round trip. */
+export declare function eventOf(id: string, data?: EventToAppend['data']): EventToAppend;
+//# sourceMappingURL=event-of.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-of.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/event-of.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAIxD,8FAA8F;AAC9F,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,aAAa,CAAC,MAAM,CAAiB,GAAG,aAAa,CAS9F"}

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

@@ -0,0 +1,13 @@
+const AT = new Date('2026-03-01T10:00:00.000Z');
+/** An event to append, told apart by its id, with data that exercises the JSON round trip. */
+export function eventOf(id, data = { label: id }) {
+    return {
+        id,
+        type: 'shipping.consignment.weighed',
+        schemaVersion: 1,
+        data,
+        metadata: { aggregateId: 'c1', correlationId: `corr-${id}` },
+        occurredAt: AT,
+    };
+}
+//# sourceMappingURL=event-of.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-of.js","sourceRoot":"","sources":["../../../src/contracts/event-store/event-of.ts"],"names":[],"mappings":"AAEA,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;AAEhD,8FAA8F;AAC9F,MAAM,UAAU,OAAO,CAAC,EAAU,EAAE,IAAI,GAA0B,EAAE,KAAK,EAAE,EAAE,EAAE;IAC7E,OAAO;QACL,EAAE;QACF,IAAI,EAAE,8BAA8B;QACpC,aAAa,EAAE,CAAC;QAChB,IAAI;QACJ,QAAQ,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC5D,UAAU,EAAE,EAAE;KACf,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { EventStore, UnitOfWork } from '@ddd-ts-kit/kernel';
+import type { Awaitable } from '../awaitable.js';
+import type { OutboxStoreUnderContract } from '../outbox-store-contract.js';
+/** An event store and the outbox of the same database, both bound to one unit of work, all empty. */
+export interface EventStoreUnderContract {
+    readonly unitOfWork: UnitOfWork;
+    readonly store: EventStore;
+    readonly outbox: Pick<OutboxStoreUnderContract, 'append' | 'claimBatch' | 'stats'>;
+    close?(): Awaitable<void>;
+}
+//# sourceMappingURL=event-store-under-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"event-store-under-contract.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/event-store-under-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAE5E,qGAAqG;AACrG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;IACnF,KAAK,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;CAC3B"}

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

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

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

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

package/dist/contracts/event-store/one-transaction-suite.d.ts

@@ -0,0 +1,18 @@
+import { ContractSuite } from '../contract-suite.js';
+import type { EventStoreUnderContract } from './event-store-under-contract.js';
+/**
+ * No double write: the events of an aggregate and the integration events published for them are
+ * written by one transaction. The store is fed by the save; the publisher, a handler of the domain
+ * events run before the commit, feeds the outbox: both commit, or neither does.
+ */
+export declare class OneTransactionSuite extends ContractSuite<EventStoreUnderContract> {
+    protected tests(): void;
+    private commitsTogether;
+    private publishesNothingRefused;
+    private published;
+    /** The repository of the composition root: events leave with the save, and the publisher writes to the outbox before the commit. */
+    private publishing;
+    private integrationOf;
+    private relayed;
+}
+//# sourceMappingURL=one-transaction-suite.d.ts.map

package/dist/contracts/event-store/one-transaction-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-transaction-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/one-transaction-suite.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAM/E;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,aAAa,CAAC,uBAAuB,CAAC;IAC7E,SAAS,CAAC,KAAK,IAAI,IAAI,CAOtB;IAED,OAAO,CAAC,eAAe;IA+BvB,OAAO,CAAC,uBAAuB;IAoB/B,OAAO,CAAC,SAAS,CAAK;IAEtB,oIAAoI;IACpI,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,aAAa;YAYP,OAAO;CAKtB"}

package/dist/contracts/event-store/one-transaction-suite.js

@@ -0,0 +1,92 @@
+import { InMemoryDomainEventDispatcher, dispatchingOnSave, } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+import { failureOf } from '../failure-of.js';
+import { Consignment } from './consignment.js';
+import { Consignments } from './consignments.js';
+const LATER = new Date('2100-01-01T00:00:00.000Z');
+class TruckLost extends Error {
+}
+/**
+ * No double write: the events of an aggregate and the integration events published for them are
+ * written by one transaction. The store is fed by the save; the publisher, a handler of the domain
+ * events run before the commit, feeds the outbox: both commit, or neither does.
+ */
+export class OneTransactionSuite extends ContractSuite {
+    tests() {
+        this.afterEach(async () => {
+            await this.subject.close?.();
+        });
+        this.commitsTogether();
+        this.publishesNothingRefused();
+    }
+    commitsTogether() {
+        this.it('commits the stream and the outbox records published for its events together', async () => {
+            const consignments = this.publishing();
+            await this.subject.unitOfWork.run(() => consignments.save(Consignment.register('c1').weigh(300)));
+            this.expect((await this.subject.store.readStream('shipping.consignment-c1')).length).toBe(2);
+            this.expect(await this.relayed()).toEqual([
+                'shipping.consignment.registered c1',
+                'shipping.consignment.weighed c1',
+            ]);
+        });
+        this.it('leaves nothing in the outbox for an append that was rolled back', async () => {
+            const consignments = this.publishing();
+            const failure = await failureOf(() => this.subject.unitOfWork.run(async () => {
+                await consignments.save(Consignment.register('c1'));
+                throw new TruckLost();
+            }));
+            this.expect(failure instanceof TruckLost).toBe(true);
+            this.expect(await this.subject.store.readStream('shipping.consignment-c1')).toEqual([]);
+            this.expect((await this.subject.outbox.stats()).pending).toBe(0);
+            this.expect(await this.relayed()).toEqual([]);
+        });
+    }
+    publishesNothingRefused() {
+        this.it('publishes nothing for an append refused by a concurrency conflict', async () => {
+            const consignments = this.publishing();
+            await this.subject.unitOfWork.run(() => consignments.save(Consignment.register('c1')));
+            const stale = await loaded(consignments, 'c1');
+            const winner = await loaded(consignments, 'c1');
+            await this.subject.unitOfWork.run(() => consignments.save(winner.weigh(100)));
+            const refused = await failureOf(() => this.subject.unitOfWork.run(() => consignments.save(stale.weigh(200))));
+            this.expect(refused === undefined).toBe(false);
+            this.expect((await this.subject.store.readStream('shipping.consignment-c1')).length).toBe(2);
+            this.expect((await this.relayed()).length).toBe(2);
+        });
+    }
+    published = 0;
+    /** The repository of the composition root: events leave with the save, and the publisher writes to the outbox before the commit. */
+    publishing() {
+        const dispatcher = new InMemoryDomainEventDispatcher();
+        const publish = async (event) => this.subject.outbox.append([this.integrationOf(event)]);
+        dispatcher.on('shipping.consignment.registered', publish, { phase: 'before-commit' });
+        dispatcher.on('shipping.consignment.weighed', publish, { phase: 'before-commit' });
+        return dispatchingOnSave(new Consignments(this.subject.store), () => dispatcher);
+    }
+    integrationOf(event) {
+        this.published += 1;
+        return {
+            id: `evt-${this.published}`,
+            type: event.name,
+            version: 1,
+            occurredAt: event.occurredAt.toISOString(),
+            payload: { consignmentId: event.aggregateId },
+        };
+    }
+    async relayed() {
+        return (await this.subject.outbox.claimBatch(100, LATER)).map(({ event }) => `${event.type} ${idOf(event.payload)}`);
+    }
+}
+async function loaded(consignments, id) {
+    const consignment = await consignments.findById(id);
+    if (consignment === undefined) {
+        throw new Error(`Consignment ${id} was saved and is not found`);
+    }
+    return consignment;
+}
+function idOf(payload) {
+    return typeof payload === 'object' && payload !== null && 'consignmentId' in payload
+        ? String(payload.consignmentId)
+        : '';
+}
+//# sourceMappingURL=one-transaction-suite.js.map

package/dist/contracts/event-store/one-transaction-suite.js.map

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

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

@@ -0,0 +1,10 @@
+import type { EventStore } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+/** The whole store: read in the order of the appends, from a position, page by page, for the subscriptions. */
+export declare class StoreSuite extends ContractSuite<EventStore> {
+    protected tests(): void;
+    private readsInOrder;
+    private givesConcurrentAppendsTheirOwnPositions;
+    private readsFromAPosition;
+}
+//# sourceMappingURL=store-suite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/store-suite.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,+GAA+G;AAC/G,qBAAa,UAAW,SAAQ,aAAa,CAAC,UAAU,CAAC;IACvD,SAAS,CAAC,KAAK,IAAI,IAAI,CAItB;IAED,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,uCAAuC;IAqB/C,OAAO,CAAC,kBAAkB;CAY3B"}

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

@@ -0,0 +1,44 @@
+import { ContractSuite } from '../contract-suite.js';
+import { eventOf } from './event-of.js';
+/** The whole store: read in the order of the appends, from a position, page by page, for the subscriptions. */
+export class StoreSuite extends ContractSuite {
+    tests() {
+        this.readsInOrder();
+        this.givesConcurrentAppendsTheirOwnPositions();
+        this.readsFromAPosition();
+    }
+    readsInOrder() {
+        this.it('reads every stream in the order the events were appended, positions rising from 1', async () => {
+            await this.subject.append('consignment-c1', 0, [eventOf('a1')]);
+            await this.subject.append('consignment-c2', 0, [eventOf('b1'), eventOf('b2')]);
+            await this.subject.append('consignment-c1', 1, [eventOf('a2')]);
+            const all = await this.subject.readAll(0, 10);
+            this.expect(all.map(({ id }) => id)).toEqual(['a1', 'b1', 'b2', 'a2']);
+            this.expect(all.map(({ position }) => position)).toEqual([1, 2, 3, 4]);
+        });
+        this.it('says at which position the store is: 0 when empty, then the position of the last event', async () => {
+            const empty = await this.subject.head();
+            const appended = await this.subject.append('consignment-c1', 0, [eventOf('a1'), eventOf('a2')]);
+            this.expect([empty, appended.position, await this.subject.head()]).toEqual([0, 2, 2]);
+        });
+    }
+    givesConcurrentAppendsTheirOwnPositions() {
+        this.it('gives concurrent appends to several streams positions of their own, without a gap, each stream in order', async () => {
+            await Promise.all(['c1', 'c2', 'c3', 'c4', 'c5'].map((id) => this.subject.append(`consignment-${id}`, 0, [eventOf(`${id}-a`), eventOf(`${id}-b`)])));
+            const all = await this.subject.readAll(0, 100);
+            this.expect(all.map(({ position }) => position)).toEqual([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
+            this.expect(all.every((event, index) => event.version === 1 || all[index - 1]?.stream === event.stream)).toBe(true);
+        });
+    }
+    readsFromAPosition() {
+        this.it('reads after a position, no more than the limit, then nothing past the last one', async () => {
+            await this.subject.append('consignment-c1', 0, [eventOf('a1'), eventOf('a2'), eventOf('a3'), eventOf('a4')]);
+            const page = await this.subject.readAll(1, 2);
+            const rest = await this.subject.readAll(3, 10);
+            this.expect(page.map(({ id }) => id)).toEqual(['a2', 'a3']);
+            this.expect(rest.map(({ id }) => id)).toEqual(['a4']);
+            this.expect(await this.subject.readAll(4, 10)).toEqual([]);
+        });
+    }
+}
+//# sourceMappingURL=store-suite.js.map

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

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

package/dist/contracts/event-store/stream-suite.d.ts

@@ -0,0 +1,11 @@
+import { type EventStore } from '@ddd-ts-kit/kernel';
+import { ContractSuite } from '../contract-suite.js';
+/** One stream: appended at the version it was read at, read back in order, refused when somebody appended first. */
+export declare class StreamSuite extends ContractSuite<EventStore> {
+    protected tests(): void;
+    private appendsAndReads;
+    private readsWhatWasAppended;
+    private refusesStaleVersions;
+    private keepsStreamsApart;
+}
+//# sourceMappingURL=stream-suite.d.ts.map

package/dist/contracts/event-store/stream-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-suite.d.ts","sourceRoot":"","sources":["../../../src/contracts/event-store/stream-suite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAIrD,oHAAoH;AACpH,qBAAa,WAAY,SAAQ,aAAa,CAAC,UAAU,CAAC;IACxD,SAAS,CAAC,KAAK,IAAI,IAAI,CAKtB;IAED,OAAO,CAAC,eAAe;IAqCvB,OAAO,CAAC,oBAAoB;IAyB5B,OAAO,CAAC,oBAAoB;IA4B5B,OAAO,CAAC,iBAAiB;CAW1B"}