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

package/dist/harness/create-test-buses.d.ts

@@ -0,0 +1,49 @@
+import { FixedActorContext, FixedClock, FixedExecutionScope, InMemoryCommandBus, InMemoryDomainEventDispatcher, InMemoryEventBus, InMemoryQueryBus, InMemoryUnitOfWork, SequentialIdGenerator, type ExecutionContext, type IntegrationEvent } from '@ddd-ts-kit/kernel';
+export interface TestBusesOptions {
+    /** The instant the clock is frozen at. Default 2026-01-01T00:00:00.000Z. */
+    readonly now?: Date;
+    /** Prefix of the generated identifiers. Default `id`, giving `id-1`, `id-2`... */
+    readonly idPrefix?: string;
+    /**
+     * What infrastructure sees as the work in progress. Default: the user `test-user`, without
+     * role, correlation `test-correlation`, origin `test`.
+     */
+    readonly executionContext?: ExecutionContext;
+}
+export interface TestBuses {
+    /** Runs every command in `unitOfWork`, as the bus of the application does. */
+    readonly commandBus: InMemoryCommandBus;
+    readonly queryBus: InMemoryQueryBus;
+    readonly eventBus: InMemoryEventBus;
+    /**
+     * Where the domain events of what the repositories wrapped by `dispatching` saved are
+     * dispatched: at the end of the command, as in the application. `domainEvents.on(name, handler,
+     * { phase: 'after-commit' })` attaches a handler of the other phase, and
+     * `domainEvents.afterCommitFailures` holds what such handlers threw.
+     */
+    readonly domainEvents: InMemoryDomainEventDispatcher;
+    readonly unitOfWork: InMemoryUnitOfWork;
+    readonly clock: FixedClock;
+    readonly ids: SequentialIdGenerator;
+    /**
+     * For the fakes and adapters that stamp audit columns or scope by tenant. Replace the context
+     * with `executionScope.enter(context)`, or run a block in another one with `scoped`.
+     */
+    readonly executionScope: FixedExecutionScope;
+    /** Follows `executionScope`; `actorContext.actAs(actor)` changes the actor of both. */
+    readonly actorContext: FixedActorContext;
+    /**
+     * The repository fake as the application hands it to a handler: its save hands the domain
+     * events of the aggregate to `domainEvents`, which hears them once the command handler has
+     * returned. The handler under test only saves.
+     */
+    dispatching<T extends object>(repository: T): T;
+    /** The integration events published so far, optionally of one type only. */
+    publishedEvents<Payload = unknown>(type?: string): IntegrationEvent<Payload>[];
+}
+/**
+ * Everything a handler spec needs, in memory and deterministic: register the handler under
+ * test, execute a command, assert the repository fake and `publishedEvents()`.
+ */
+export declare function createTestBuses(options?: TestBusesOptions): TestBuses;
+//# sourceMappingURL=create-test-buses.d.ts.map

package/dist/harness/create-test-buses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-buses.d.ts","sourceRoot":"","sources":["../../src/harness/create-test-buses.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EAIrB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,QAAQ,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;IACpB,kFAAkF;IAClF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CAC9C;AAED,MAAM,WAAW,SAAS;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,6BAA6B,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,uFAAuF;IACvF,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAC;IACzC;;;;OAIG;IACH,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;IAChD,4EAA4E;IAC5E,eAAe,CAAC,OAAO,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;CAChF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAyBzE"}

package/dist/harness/create-test-buses.js

@@ -0,0 +1,35 @@
+import { FixedActorContext, FixedClock, FixedExecutionScope, InMemoryCommandBus, InMemoryDomainEventDispatcher, InMemoryEventBus, InMemoryQueryBus, InMemoryUnitOfWork, SequentialIdGenerator, dispatchingOnSave, unitOfWorkMiddleware, executionContext, } from '@ddd-ts-kit/kernel';
+/**
+ * Everything a handler spec needs, in memory and deterministic: register the handler under
+ * test, execute a command, assert the repository fake and `publishedEvents()`.
+ */
+export function createTestBuses(options = {}) {
+    const eventBus = new InMemoryEventBus();
+    const context = options.executionContext ?? DEFAULT_EXECUTION_CONTEXT;
+    const actorContext = new FixedActorContext(context.actor);
+    const domainEvents = new InMemoryDomainEventDispatcher();
+    const unitOfWork = new InMemoryUnitOfWork();
+    return {
+        commandBus: new InMemoryCommandBus().use(unitOfWorkMiddleware(unitOfWork)),
+        queryBus: new InMemoryQueryBus(),
+        eventBus,
+        domainEvents,
+        dispatching: (repository) => dispatchingOnSave(repository, () => domainEvents),
+        unitOfWork,
+        clock: new FixedClock(options.now ?? new Date('2026-01-01T00:00:00.000Z')),
+        ids: new SequentialIdGenerator(options.idPrefix),
+        executionScope: new FixedExecutionScope(context, actorContext),
+        actorContext,
+        publishedEvents(type) {
+            const events = eventBus.published.filter((event) => type === undefined || event.type === type);
+            // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- the payload type is the caller's claim about what the handler under test published; nothing here can check it
+            return events;
+        },
+    };
+}
+const DEFAULT_EXECUTION_CONTEXT = executionContext({
+    correlationId: 'test-correlation',
+    actor: { id: 'test-user', type: 'user', roles: [], attributes: {} },
+    origin: 'test',
+});
+//# sourceMappingURL=create-test-buses.js.map

package/dist/harness/create-test-buses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-test-buses.js","sourceRoot":"","sources":["../../src/harness/create-test-buses.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,6BAA6B,EAC7B,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GAGjB,MAAM,oBAAoB,CAAC;AA8C5B;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAO,GAAqB,EAAE;IAC5D,MAAM,QAAQ,GAAG,IAAI,gBAAgB,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,IAAI,yBAAyB,CAAC;IACtE,MAAM,YAAY,GAAG,IAAI,iBAAiB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,IAAI,6BAA6B,EAAE,CAAC;IACzD,MAAM,UAAU,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAE5C,OAAO;QACL,UAAU,EAAE,IAAI,kBAAkB,EAAE,CAAC,GAAG,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;QAC1E,QAAQ,EAAE,IAAI,gBAAgB,EAAE;QAChC,QAAQ;QACR,YAAY;QACZ,WAAW,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC;QAC9E,UAAU;QACV,KAAK,EAAE,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1E,GAAG,EAAE,IAAI,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC;QAChD,cAAc,EAAE,IAAI,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC;QAC9D,YAAY;QACZ,eAAe,CAAoB,IAAa;YAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAE/F,6KAA6K;YAC7K,OAAO,MAAqC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;IACjD,aAAa,EAAE,kBAAkB;IACjC,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;IACnE,MAAM,EAAE,MAAM;CACf,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+export { CONCURRENCY_CONFLICT, ConcurrencyError } from '@ddd-ts-kit/kernel';
+export type { Buildable } from './builders/buildable.js';
+export { Builder } from './builders/builder.js';
+export type { Defaults } from './builders/defaults.js';
+export { defineBuilder } from './builders/define-builder.js';
+export { GenericBuilder } from './builders/generic-builder.js';
+export { lazy } from './builders/lazy.js';
+export type { Resolvable } from './builders/resolvable.js';
+export { resolve } from './builders/resolve.js';
+export { resetSequences, sequence } from './builders/sequence.js';
+export { aSession } from './execution/a-session.js';
+export { anExecutionContext } from './execution/an-execution-context.js';
+export { ExecutionContextBuilder } from './execution/execution-context-builder.js';
+export { scoped } from './execution/scoped.js';
+export { SessionBuilder } from './execution/session-builder.js';
+export { createTestBuses, type TestBuses, type TestBusesOptions } from './harness/create-test-buses.js';
+export { InMemoryRepository, type InMemoryRepositoryOptions } from './repositories/in-memory-repository.js';
+export { snapshots } from './repositories/snapshots.js';
+export { expectNoSecret } from './secrecy/expect-no-secret.js';
+export type { AsyncOutcome } from './scenarios/async-outcome.js';
+export type { AsyncScenario } from './scenarios/async-scenario.js';
+export type { EventMatcher } from './scenarios/event-matcher.js';
+export type { EventSource } from './scenarios/event-source.js';
+export { given } from './scenarios/given.js';
+export type { Outcome } from './scenarios/outcome.js';
+export { scenario, type Scenario } from './scenarios/scenario.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC5E,YAAY,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAAE,KAAK,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,YAAY,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+export { CONCURRENCY_CONFLICT, ConcurrencyError } from '@ddd-ts-kit/kernel';
+export { Builder } from './builders/builder.js';
+export { defineBuilder } from './builders/define-builder.js';
+export { GenericBuilder } from './builders/generic-builder.js';
+export { lazy } from './builders/lazy.js';
+export { resolve } from './builders/resolve.js';
+export { resetSequences, sequence } from './builders/sequence.js';
+export { aSession } from './execution/a-session.js';
+export { anExecutionContext } from './execution/an-execution-context.js';
+export { ExecutionContextBuilder } from './execution/execution-context-builder.js';
+export { scoped } from './execution/scoped.js';
+export { SessionBuilder } from './execution/session-builder.js';
+export { createTestBuses } from './harness/create-test-buses.js';
+export { InMemoryRepository } from './repositories/in-memory-repository.js';
+export { snapshots } from './repositories/snapshots.js';
+export { expectNoSecret } from './secrecy/expect-no-secret.js';
+export { given } from './scenarios/given.js';
+export { scenario } from './scenarios/scenario.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE5E,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,eAAe,EAAyC,MAAM,gCAAgC,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAAkC,MAAM,wCAAwC,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAK/D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAiB,MAAM,yBAAyB,CAAC"}

package/dist/repositories/in-memory-repository.d.ts

@@ -0,0 +1,30 @@
+import { type AggregateRoot, type Repository } from '@ddd-ts-kit/kernel';
+import type { SnapshotCodec } from './snapshot-codec.js';
+/**
+ * How the fake keeps its own copy, so that mutating an aggregate after `save` (or a loaded
+ * one before saving it) never changes what is stored. Either a `clone` function, or the
+ * snapshot pair a real adapter's mapper already has; snapshots go through `structuredClone`.
+ */
+export type InMemoryRepositoryOptions<A> = {
+    readonly clone: (aggregate: A) => A;
+} | SnapshotCodec<A, unknown>;
+/**
+ * A working repository over a Map: the fake of any aggregate repository port. Use it as is or
+ * extend it to add the finders of the port. It enforces optimistic concurrency on `version`
+ * like a real adapter, and passes the same `repositoryContract`.
+ */
+export declare class InMemoryRepository<A extends AggregateRoot<Id>, Id extends string | number = string> implements Repository<A, Id> {
+    private readonly entries;
+    private readonly keep;
+    constructor(options: InMemoryRepositoryOptions<A>);
+    findById(id: Id): Promise<A | undefined>;
+    save(aggregate: A): Promise<void>;
+    /** Copies of every stored aggregate, in insertion order, for assertions and finders. */
+    all(): A[];
+    count(): number;
+    clear(): void;
+    /** For subclasses whose port has a removal method. */
+    protected remove(id: Id): boolean;
+    private revive;
+}
+//# sourceMappingURL=in-memory-repository.d.ts.map

package/dist/repositories/in-memory-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-repository.d.ts","sourceRoot":"","sources":["../../src/repositories/in-memory-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,yBAAyB,CAAC,CAAC,IAAI;IAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,CAAA;CAAE,GAAG,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAQ/G;;;;GAIG;AACH,qBAAa,kBAAkB,CAAC,CAAC,SAAS,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,CAC9F,YAAW,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC;IAE5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2B;IAEnD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IAEjD,YAAY,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,EAEhD;IAEK,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAI7C;IAEK,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtC;IAED,wFAAwF;IACxF,GAAG,IAAI,CAAC,EAAE,CAET;IAED,KAAK,IAAI,MAAM,CAEd;IAED,KAAK,IAAI,IAAI,CAEZ;IAED,sDAAsD;IACtD,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAEhC;IAED,OAAO,CAAC,MAAM;CAOf"}

package/dist/repositories/in-memory-repository.js

@@ -0,0 +1,58 @@
+import { ConcurrencyError } from '@ddd-ts-kit/kernel';
+/**
+ * A working repository over a Map: the fake of any aggregate repository port. Use it as is or
+ * extend it to add the finders of the port. It enforces optimistic concurrency on `version`
+ * like a real adapter, and passes the same `repositoryContract`.
+ */
+export class InMemoryRepository {
+    entries = new Map();
+    keep;
+    constructor(options) {
+        this.keep = 'clone' in options ? keptByCloning(options.clone) : keptAsSnapshot(options);
+    }
+    async findById(id) {
+        const entry = this.entries.get(id);
+        return entry === undefined ? undefined : this.revive(entry);
+    }
+    async save(aggregate) {
+        const current = this.entries.get(aggregate.id)?.version ?? 0;
+        if (aggregate.version !== current) {
+            throw new ConcurrencyError(aggregate.id);
+        }
+        const version = current + 1;
+        this.entries.set(aggregate.id, { load: this.keep(aggregate), version });
+        aggregate.version = version;
+    }
+    /** Copies of every stored aggregate, in insertion order, for assertions and finders. */
+    all() {
+        return [...this.entries.values()].map((entry) => this.revive(entry));
+    }
+    count() {
+        return this.entries.size;
+    }
+    clear() {
+        this.entries.clear();
+    }
+    /** For subclasses whose port has a removal method. */
+    remove(id) {
+        return this.entries.delete(id);
+    }
+    revive(entry) {
+        const aggregate = entry.load();
+        aggregate.version = entry.version;
+        return aggregate;
+    }
+}
+function keptByCloning(clone) {
+    return (aggregate) => {
+        const stored = clone(aggregate);
+        return () => clone(stored);
+    };
+}
+function keptAsSnapshot(codec) {
+    return (aggregate) => {
+        const stored = structuredClone(codec.toSnapshot(aggregate));
+        return () => codec.fromSnapshot(structuredClone(stored));
+    };
+}
+//# sourceMappingURL=in-memory-repository.js.map

package/dist/repositories/in-memory-repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-repository.js","sourceRoot":"","sources":["../../src/repositories/in-memory-repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAuC,MAAM,oBAAoB,CAAC;AAgB3F;;;;GAIG;AACH,MAAM,OAAO,kBAAkB;IAGZ,OAAO,GAAG,IAAI,GAAG,EAAgB,CAAC;IAElC,IAAI,CAA4B;IAEjD,YAAY,OAAqC;QAC/C,IAAI,CAAC,IAAI,GAAG,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1F,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,EAAM;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEnC,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAY;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC;QAE7D,IAAI,SAAS,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QAC3C,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,GAAG,CAAC,CAAC;QAE5B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QACxE,SAAS,CAAC,OAAO,GAAG,OAAO,CAAC;IAC9B,CAAC;IAED,wFAAwF;IACxF,GAAG;QACD,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,KAAK;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAED,sDAAsD;IAC5C,MAAM,CAAC,EAAM;QACrB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAEO,MAAM,CAAC,KAAe;QAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAE/B,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAElC,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED,SAAS,aAAa,CAAI,KAA0B;IAClD,OAAO,CAAC,SAAS,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;QAEhC,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAI,KAAgC;IACzD,OAAO,CAAC,SAAS,EAAE,EAAE;QACnB,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;QAE5D,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC"}

package/dist/repositories/snapshot-codec.d.ts

@@ -0,0 +1,6 @@
+/** The pair a mapper already has: an aggregate to plain data, and back. */
+export interface SnapshotCodec<A, Snapshot> {
+    readonly toSnapshot: (aggregate: A) => Snapshot;
+    readonly fromSnapshot: (snapshot: Snapshot) => A;
+}
+//# sourceMappingURL=snapshot-codec.d.ts.map

package/dist/repositories/snapshot-codec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-codec.d.ts","sourceRoot":"","sources":["../../src/repositories/snapshot-codec.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,WAAW,aAAa,CAAC,CAAC,EAAE,QAAQ;IACxC,QAAQ,CAAC,UAAU,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,QAAQ,CAAC;IAChD,QAAQ,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,CAAC,CAAC;CAClD"}

package/dist/repositories/snapshot-codec.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshot-codec.js.map

package/dist/repositories/snapshot-codec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-codec.js","sourceRoot":"","sources":["../../src/repositories/snapshot-codec.ts"],"names":[],"mappings":""}

package/dist/repositories/snapshots.d.ts

@@ -0,0 +1,5 @@
+import type { InMemoryRepositoryOptions } from './in-memory-repository.js';
+import type { SnapshotCodec } from './snapshot-codec.js';
+/** Infers the snapshot type so `toSnapshot` and `fromSnapshot` are checked against each other. */
+export declare function snapshots<A, Snapshot>(codec: SnapshotCodec<A, Snapshot>): InMemoryRepositoryOptions<A>;
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/repositories/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/repositories/snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,yBAAyB,CAAC,CAAC,CAAC,CAMtG"}

package/dist/repositories/snapshots.js

@@ -0,0 +1,9 @@
+/** Infers the snapshot type so `toSnapshot` and `fromSnapshot` are checked against each other. */
+export function snapshots(codec) {
+    return {
+        toSnapshot: codec.toSnapshot,
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- the options erase the snapshot type, and only values produced by `toSnapshot` above are ever passed back
+        fromSnapshot: (snapshot) => codec.fromSnapshot(snapshot),
+    };
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/repositories/snapshots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.js","sourceRoot":"","sources":["../../src/repositories/snapshots.ts"],"names":[],"mappings":"AAGA,kGAAkG;AAClG,MAAM,UAAU,SAAS,CAAc,KAAiC;IACtE,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,wKAAwK;QACxK,YAAY,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,QAAoB,CAAC;KACrE,CAAC;AACJ,CAAC"}

package/dist/scenarios/act.d.ts

@@ -0,0 +1,5 @@
+import type { EventSource } from './event-source.js';
+import type { Recorded } from './recorded.js';
+/** Runs the action on the aggregate and records its events, the ones of the arrangement discarded. */
+export declare function act<A extends EventSource>(aggregate: A, action: (aggregate: A) => unknown): Recorded<A> | Promise<Recorded<A>>;
+//# sourceMappingURL=act.d.ts.map

package/dist/scenarios/act.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.d.ts","sourceRoot":"","sources":["../../src/scenarios/act.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,sGAAsG;AACtG,wBAAgB,GAAG,CAAC,CAAC,SAAS,WAAW,EACvC,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,OAAO,GAChC,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAuBpC"}

package/dist/scenarios/act.js

@@ -0,0 +1,21 @@
+import { isPromiseLike } from './is-promise-like.js';
+/** Runs the action on the aggregate and records its events, the ones of the arrangement discarded. */
+export function act(aggregate, action) {
+    aggregate.pullEvents();
+    const record = (thrown) => ({
+        aggregate,
+        events: aggregate.pullEvents(),
+        thrown,
+    });
+    try {
+        const result = action(aggregate);
+        if (isPromiseLike(result)) {
+            return Promise.resolve(result).then(() => record(undefined), (error) => record({ error }));
+        }
+        return record(undefined);
+    }
+    catch (error) {
+        return record({ error });
+    }
+}
+//# sourceMappingURL=act.js.map

package/dist/scenarios/act.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"act.js","sourceRoot":"","sources":["../../src/scenarios/act.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,sGAAsG;AACtG,MAAM,UAAU,GAAG,CACjB,SAAY,EACZ,MAAiC;IAEjC,SAAS,CAAC,UAAU,EAAE,CAAC;IAEvB,MAAM,MAAM,GAAG,CAAC,MAA6B,EAAe,EAAE,CAAC,CAAC;QAC9D,SAAS;QACT,MAAM,EAAE,SAAS,CAAC,UAAU,EAAE;QAC9B,MAAM;KACP,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;QAEjC,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CACjC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EACvB,CAAC,KAAc,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CACtC,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC"}

package/dist/scenarios/async-outcome.d.ts

@@ -0,0 +1,5 @@
+import type { Outcome } from './outcome.js';
+/** The outcome of an asynchronous `when` or arrangement: same assertions, to be awaited. */
+export interface AsyncOutcome<A> extends Outcome<A>, PromiseLike<void> {
+}
+//# sourceMappingURL=async-outcome.d.ts.map

package/dist/scenarios/async-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-outcome.d.ts","sourceRoot":"","sources":["../../src/scenarios/async-outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,4FAA4F;AAC5F,MAAM,WAAW,YAAY,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC;CAAG"}

package/dist/scenarios/async-outcome.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=async-outcome.js.map

package/dist/scenarios/async-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-outcome.js","sourceRoot":"","sources":["../../src/scenarios/async-outcome.ts"],"names":[],"mappings":""}

package/dist/scenarios/async-scenario.d.ts

@@ -0,0 +1,5 @@
+import type { AsyncOutcome } from './async-outcome.js';
+export interface AsyncScenario<A> {
+    when(action: (aggregate: A) => unknown): AsyncOutcome<A>;
+}
+//# sourceMappingURL=async-scenario.d.ts.map

package/dist/scenarios/async-scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-scenario.d.ts","sourceRoot":"","sources":["../../src/scenarios/async-scenario.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;CAC1D"}

package/dist/scenarios/async-scenario.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=async-scenario.js.map

package/dist/scenarios/async-scenario.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-scenario.js","sourceRoot":"","sources":["../../src/scenarios/async-scenario.ts"],"names":[],"mappings":""}

package/dist/scenarios/deferred-outcome.d.ts

@@ -0,0 +1,18 @@
+import type { AsyncOutcome } from './async-outcome.js';
+import type { ErrorClass } from './error-class.js';
+import type { EventMatcher } from './event-matcher.js';
+import type { Recorded } from './recorded.js';
+/** The assertions of an outcome that is not known yet: each one waits for it, the chain is awaited. */
+export declare class DeferredOutcome<A> implements AsyncOutcome<A> {
+    private readonly pending;
+    static of<A>(recorded: Promise<Recorded<A>>): DeferredOutcome<A>;
+    private constructor();
+    thenEvents(expected: readonly EventMatcher[]): this;
+    thenEventNames(expected: readonly string[]): this;
+    thenNoEvent(): this;
+    thenError(typeOrCode: ErrorClass | string, code?: string): this;
+    thenState(inspectState: (aggregate: A) => void): this;
+    then<Fulfilled = void, Rejected = never>(onFulfilled?: ((value: undefined) => Fulfilled | PromiseLike<Fulfilled>) | null, onRejected?: ((reason: unknown) => Rejected | PromiseLike<Rejected>) | null): PromiseLike<Fulfilled | Rejected>;
+    private after;
+}
+//# sourceMappingURL=deferred-outcome.d.ts.map

package/dist/scenarios/deferred-outcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-outcome.d.ts","sourceRoot":"","sources":["../../src/scenarios/deferred-outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,uGAAuG;AACvG,qBAAa,eAAe,CAAC,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,CAAC;IAKpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ5C,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAE/D;IAED,OAAO,eAAuE;IAE9E,UAAU,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAElD;IAED,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAEhD;IAED,WAAW,IAAI,IAAI,CAElB;IAED,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAI9D;IAED,SAAS,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAEpD;IAED,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EACrC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,SAAS,KAAK,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,EAC/E,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC1E,WAAW,CAAC,SAAS,GAAG,QAAQ,CAAC,CAEnC;IAED,OAAO,CAAC,KAAK;CAId"}

package/dist/scenarios/deferred-outcome.js

@@ -0,0 +1,34 @@
+import { ImmediateOutcome } from './immediate-outcome.js';
+/** The assertions of an outcome that is not known yet: each one waits for it, the chain is awaited. */
+export class DeferredOutcome {
+    pending;
+    static of(recorded) {
+        return new DeferredOutcome(recorded.then((result) => new ImmediateOutcome(result)));
+    }
+    constructor(pending) {
+        this.pending = pending;
+    }
+    thenEvents(expected) {
+        return this.after((outcome) => outcome.thenEvents(expected));
+    }
+    thenEventNames(expected) {
+        return this.after((outcome) => outcome.thenEventNames(expected));
+    }
+    thenNoEvent() {
+        return this.after((outcome) => outcome.thenNoEvent());
+    }
+    thenError(typeOrCode, code) {
+        return this.after((outcome) => typeof typeOrCode === 'string' ? outcome.thenError(typeOrCode) : outcome.thenError(typeOrCode, code));
+    }
+    thenState(inspectState) {
+        return this.after((outcome) => outcome.thenState(inspectState));
+    }
+    then(onFulfilled, onRejected) {
+        return this.pending.then(() => undefined).then(onFulfilled, onRejected);
+    }
+    after(assert) {
+        // eslint-disable-next-line ddd-ts-kit/clean-no-escape-hatch -- Outcome methods answer `this`; the chain stays immutable, so the answer is a new object of the same class
+        return new DeferredOutcome(this.pending.then(assert));
+    }
+}
+//# sourceMappingURL=deferred-outcome.js.map

package/dist/scenarios/deferred-outcome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred-outcome.js","sourceRoot":"","sources":["../../src/scenarios/deferred-outcome.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D,uGAAuG;AACvG,MAAM,OAAO,eAAe;IAKW,OAAO;IAJ5C,MAAM,CAAC,EAAE,CAAI,QAA8B;QACzC,OAAO,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACtF,CAAC;IAED,YAAqC,OAAqC;uBAArC,OAAO;IAAiC,CAAC;IAE9E,UAAU,CAAC,QAAiC;QAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED,cAAc,CAAC,QAA2B;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,SAAS,CAAC,UAA+B,EAAE,IAAa;QACtD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAC5B,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CACrG,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,YAAoC;QAC5C,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CACF,WAA+E,EAC/E,UAA2E;QAE3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IAC1E,CAAC;IAEO,KAAK,CAAC,MAA6D;QACzE,yKAAyK;QACzK,OAAO,IAAI,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAS,CAAC;IAChE,CAAC;CACF"}

package/dist/scenarios/describe-event.d.ts

@@ -0,0 +1,3 @@
+import type { DomainEvent } from '@ddd-ts-kit/kernel';
+export declare function describeEvent(event: DomainEvent): string;
+//# sourceMappingURL=describe-event.d.ts.map

package/dist/scenarios/describe-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-event.d.ts","sourceRoot":"","sources":["../../src/scenarios/describe-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAIxD"}

package/dist/scenarios/describe-event.js

@@ -0,0 +1,6 @@
+import { show } from './show.js';
+export function describeEvent(event) {
+    const { name, ...rest } = event;
+    return `${name} ${show(rest)}`;
+}
+//# sourceMappingURL=describe-event.js.map

package/dist/scenarios/describe-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe-event.js","sourceRoot":"","sources":["../../src/scenarios/describe-event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;IAEhC,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACjC,CAAC"}

package/dist/scenarios/error-class.d.ts

@@ -0,0 +1,2 @@
+export type ErrorClass = abstract new (...args: never[]) => Error;
+//# sourceMappingURL=error-class.d.ts.map

package/dist/scenarios/error-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-class.d.ts","sourceRoot":"","sources":["../../src/scenarios/error-class.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC"}

package/dist/scenarios/error-class.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-class.js.map

package/dist/scenarios/error-class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-class.js","sourceRoot":"","sources":["../../src/scenarios/error-class.ts"],"names":[],"mappings":""}

package/dist/scenarios/event-matcher.d.ts

@@ -0,0 +1,11 @@
+import type { DomainEvent } from '@ddd-ts-kit/kernel';
+type EventClass = abstract new (...args: never[]) => DomainEvent;
+/**
+ * How an expected event is described: its name, its class, or the properties that matter
+ * (a subset: properties left out are not compared).
+ */
+export type EventMatcher = string | EventClass | {
+    readonly [property: string]: unknown;
+};
+export {};
+//# sourceMappingURL=event-matcher.d.ts.map

package/dist/scenarios/event-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-matcher.d.ts","sourceRoot":"","sources":["../../src/scenarios/event-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,KAAK,UAAU,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,WAAW,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG;IAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC"}

package/dist/scenarios/event-matcher.js

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

package/dist/scenarios/event-matcher.js.map

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

package/dist/scenarios/event-mismatches.d.ts

@@ -0,0 +1,5 @@
+import type { DomainEvent } from '@ddd-ts-kit/kernel';
+import type { EventMatcher } from './event-matcher.js';
+/** Why the event is not the one the matcher describes, one line per difference; none when it is. */
+export declare function eventMismatches(event: DomainEvent, matcher: EventMatcher, where: string): string[];
+//# sourceMappingURL=event-mismatches.d.ts.map

package/dist/scenarios/event-mismatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-mismatches.d.ts","sourceRoot":"","sources":["../../src/scenarios/event-mismatches.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,oGAAoG;AACpG,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAYlG"}

package/dist/scenarios/event-mismatches.js

@@ -0,0 +1,33 @@
+import { isDeepStrictEqual } from 'node:util';
+import { describeEvent } from './describe-event.js';
+import { show } from './show.js';
+/** Why the event is not the one the matcher describes, one line per difference; none when it is. */
+export function eventMismatches(event, matcher, where) {
+    if (typeof matcher === 'string') {
+        return matcher === event.name ? [] : [`${where}: expected name ${show(matcher)}, recorded ${show(event.name)}`];
+    }
+    if (typeof matcher === 'function') {
+        return event instanceof matcher
+            ? []
+            : [`${where}: expected an instance of ${matcher.name}, recorded ${describeEvent(event)}`];
+    }
+    return subsetDifferences(event, matcher, where);
+}
+function subsetDifferences(actual, expected, path) {
+    if (isPlainObject(expected) && typeof actual === 'object' && actual !== null) {
+        return Object.entries(expected).flatMap(([key, value]) => {
+            // Reflect.get rather than a spread: an event class may expose a property through a getter.
+            const recorded = Reflect.get(actual, key);
+            return subsetDifferences(recorded, value, `${path}.${key}`);
+        });
+    }
+    return isDeepStrictEqual(actual, expected) ? [] : [`${path}: expected ${show(expected)}, recorded ${show(actual)}`];
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+//# sourceMappingURL=event-mismatches.js.map

package/dist/scenarios/event-mismatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-mismatches.js","sourceRoot":"","sources":["../../src/scenarios/event-mismatches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,oGAAoG;AACpG,MAAM,UAAU,eAAe,CAAC,KAAkB,EAAE,OAAqB,EAAE,KAAa;IACtF,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,mBAAmB,IAAI,CAAC,OAAO,CAAC,cAAc,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClH,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,KAAK,YAAY,OAAO;YAC7B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,GAAG,KAAK,6BAA6B,OAAO,CAAC,IAAI,cAAc,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAe,EAAE,QAAiB,EAAE,IAAY;IACzE,IAAI,aAAa,CAAC,QAAQ,CAAC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAC7E,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;YACvD,2FAA2F;YAC3F,MAAM,QAAQ,GAAY,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YAEnD,OAAO,iBAAiB,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,cAAc,IAAI,CAAC,QAAQ,CAAC,cAAc,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACtH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAY,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAExD,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC;AAC9D,CAAC"}

package/dist/scenarios/event-source.d.ts

@@ -0,0 +1,6 @@
+import type { DomainEvent } from '@ddd-ts-kit/kernel';
+/** What a scenario needs from an aggregate: the events it recorded. */
+export interface EventSource {
+    pullEvents(): DomainEvent[];
+}
+//# sourceMappingURL=event-source.d.ts.map

package/dist/scenarios/event-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-source.d.ts","sourceRoot":"","sources":["../../src/scenarios/event-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,uEAAuE;AACvE,MAAM,WAAW,WAAW;IAC1B,UAAU,IAAI,WAAW,EAAE,CAAC;CAC7B"}

package/dist/scenarios/event-source.js

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

package/dist/scenarios/event-source.js.map

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

package/dist/scenarios/given.d.ts

@@ -0,0 +1,9 @@
+import type { Resolvable } from '../builders/resolvable.js';
+import type { EventSource } from './event-source.js';
+import { type Scenario } from './scenario.js';
+/**
+ * Starts a scenario from an aggregate (or its builder) in its "given" state. The events
+ * recorded while arranging are discarded, so only the events of `when` are asserted.
+ */
+export declare function given<A extends EventSource>(aggregate: A | Resolvable<A>): Scenario<A>;
+//# sourceMappingURL=given.d.ts.map

package/dist/scenarios/given.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"given.d.ts","sourceRoot":"","sources":["../../src/scenarios/given.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,eAAe,CAAC;AAExD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,SAAS,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAEtF"}

package/dist/scenarios/given.js

@@ -0,0 +1,10 @@
+import { resolve } from '../builders/resolve.js';
+import { scenario } from './scenario.js';
+/**
+ * Starts a scenario from an aggregate (or its builder) in its "given" state. The events
+ * recorded while arranging are discarded, so only the events of `when` are asserted.
+ */
+export function given(aggregate) {
+    return scenario(() => resolve(aggregate));
+}
+//# sourceMappingURL=given.js.map

package/dist/scenarios/given.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"given.js","sourceRoot":"","sources":["../../src/scenarios/given.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGjD,OAAO,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,KAAK,CAAwB,SAA4B;IACvE,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5C,CAAC"}