@shirudo/ddd-kit 3.0.0-rc.4 → 3.0.0-rc.6

package/dist/testing.d.ts

@@ -1,5 +1,4 @@
-import { At as AnyDomainEvent, Et as IAggregateRoot, G as DispatchTrackingOutbox, L as CommandOutboxCommitCandidate, U as CommittedDomainEvent, Z as Outbox, a as StreamReadResult, b as IdempotencyStore, c as ProjectionCheckpointStore, en as Id, f as DeadlineStore, h as IdempotencyClaimHandle, i as ReadStreamOptions, it as PublishedCommand, n as EventStore, q as EventCommitCandidate, t as SnapshotStore, wt as AggregateAddress, z as CommandOutboxWriter } from "./chunks/snapshot-store.js";
-
+import { Lt as PublishedCommand, P as EventBus, Pt as AggregateAddress, R as Aggregate, W as Id, Y as CommandOutboxCommitCandidate, Z as CommandOutboxWriter, _ as IdempotencyStore, a as StreamReadResult, c as ProjectionCheckpointStore, ct as EventCommitCandidate, f as IdempotencyClaimHandle, i as ReadStreamOptions, n as EventStore, nt as Outbox, st as CommittedDomainEvent, t as SnapshotStore, tt as DispatchTrackingOutbox, ut as AnyDomainEvent, w as DeadlineStore } from "./chunks/snapshot-store.js";
 //#region src/testing/contract-assertions.d.ts
 /**
  * One entry of a contract test suite. Every suite (repository,
@@ -119,12 +118,12 @@ declare function createDeadlineStoreContractTests(harness: DeadlineStoreContract
 //#endregion
 //#region src/testing/es-repository-contract.d.ts
 /** Event-sourced repositories normally expose no physical removal. */
-interface EsContractRepository<TAggregate extends IAggregateRoot<Id<string>, AnyDomainEvent>> {
+interface EsContractRepository<TAggregate extends Aggregate<Id<string>, AnyDomainEvent>> {
   findById(id: TAggregate["id"]): Promise<TAggregate | undefined>;
   add(aggregate: TAggregate): void;
   update(aggregate: TAggregate): void;
 }
-interface EsRepositoryContractEnvironment<TAggregate extends IAggregateRoot<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
+interface EsRepositoryContractEnvironment<TAggregate extends Aggregate<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
   run<R>(work: (context: {
     repository: EsContractRepository<TAggregate>;
   }) => Promise<R>): Promise<R>;
@@ -133,7 +132,7 @@ interface EsRepositoryContractEnvironment<TAggregate extends IAggregateRoot<Id<s
   committedStreamEvents(stream: AggregateAddress<TAggregate["id"]>, options: ReadStreamOptions): Promise<StreamReadResult<TEvent>>;
   teardown?(): Promise<void>;
 }
-interface EsRepositoryContractHarness<TAggregate extends IAggregateRoot<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
+interface EsRepositoryContractHarness<TAggregate extends Aggregate<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
   createEnvironment(): Promise<EsRepositoryContractEnvironment<TAggregate, TEvent>>;
   /** Fresh aggregate with exactly one recorded creation event. */
   createAggregate(): TAggregate;
@@ -142,6 +141,12 @@ interface EsRepositoryContractHarness<TAggregate extends IAggregateRoot<Id<strin
   /** Applies exactly one event and advances the aggregate version by one. */
   mutate(aggregate: TAggregate): void;
   snapshotState?(aggregate: TAggregate): unknown;
+  /**
+   * Persists a snapshot of the aggregate at its current version in the
+   * environment's snapshot store, so the next load there starts from it.
+   * Enables the snapshot catch-up proof.
+   */
+  captureSnapshot?(aggregate: TAggregate, environment: EsRepositoryContractEnvironment<TAggregate, TEvent>): Promise<void>;
 }
 type EsRepositoryContractTest = ContractTest;
 /**
@@ -152,7 +157,52 @@ type EsRepositoryContractTest = ContractTest;
  * same transaction as the outbox. `run` must support overlapping calls so the
  * mandatory stale-writer proof exercises a real stream OCC predicate.
  */
-declare function createEsRepositoryContractTests<TAggregate extends IAggregateRoot<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent>(harness: EsRepositoryContractHarness<TAggregate, TEvent>): EsRepositoryContractTest[];
+declare function createEsRepositoryContractTests<TAggregate extends Aggregate<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent>(harness: EsRepositoryContractHarness<TAggregate, TEvent>): EsRepositoryContractTest[];
+//#endregion
+//#region src/testing/event-bus-contract.d.ts
+/** One entry of the event-bus contract suite. */
+type EventBusContractTest = ContractTest;
+/**
+ * What the suite runs against. The harness creates one per test and tears
+ * it down afterwards. No transaction wrapper: the port is in-process and
+ * transaction-free by design.
+ */
+interface EventBusContractEnvironment<Evt extends AnyDomainEvent> {
+  /** The implementation under test. */
+  readonly bus: EventBus<Evt>;
+  /** Release connections, drop schemas, etc. Called in a finally. */
+  teardown?(): Promise<void>;
+}
+/**
+ * What an implementation supplies to run the event-bus contract suite.
+ *
+ * The suite mints no events, so it stays free of any event union. The two
+ * factories must produce DIFFERENT `type` values: the suite subscribes to
+ * both to prove that ordering holds across types and that a catch-all
+ * subscription sees every type.
+ */
+interface EventBusContractHarness<Evt extends AnyDomainEvent> {
+  createEnvironment(): Promise<EventBusContractEnvironment<Evt>>;
+  /** An event of the first type. Called repeatedly; each call may differ. */
+  createFirstEvent(): Evt;
+  /** An event of the second type, whose `type` differs from the first. */
+  createSecondEvent(): Evt;
+}
+/**
+ * The event-bus contract test suite: the proof that an implementation
+ * delivers the guarantees the `EventBus` port documents. Ordering,
+ * parallelism within one event, and error collection after the batch are
+ * a **port contract, not a kit guarantee**; this suite is how an
+ * implementation demonstrates them.
+ *
+ * The suite covers the port and nothing else. Construction options of the
+ * kit's own adapter, such as a publish-depth bound or an observer bundle,
+ * are not port behavior and are not pinned here.
+ *
+ * Framework-agnostic: bind with
+ * `(test.skipped ? it.skip : it)(test.name, test.run)`.
+ */
+declare function createEventBusContractTests<Evt extends AnyDomainEvent>(harness: EventBusContractHarness<Evt>): EventBusContractTest[];
 //#endregion
 //#region src/testing/event-store-contract.d.ts
 /** One named contract test for an EventStore adapter. */
@@ -441,7 +491,7 @@ declare function createProjectionCheckpointStoreContractTests<TCtx>(harness: Pro
 //#endregion
 //#region src/testing/repository-contract.d.ts
 /** Application-facing state-stored repository exercised by the suite. */
-interface ContractRepository<TAggregate extends IAggregateRoot<Id<string>, AnyDomainEvent>> {
+interface ContractRepository<TAggregate extends Aggregate<Id<string>, AnyDomainEvent>> {
   findById(id: TAggregate["id"]): Promise<TAggregate | undefined>;
   add(aggregate: TAggregate): void;
   update(aggregate: TAggregate): void;
@@ -449,7 +499,7 @@ interface ContractRepository<TAggregate extends IAggregateRoot<Id<string>, AnyDo
   remove?(aggregate: TAggregate): void;
 }
 /** One isolated real-adapter environment. `run` must permit overlapping calls. */
-interface RepositoryContractEnvironment<TAggregate extends IAggregateRoot<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
+interface RepositoryContractEnvironment<TAggregate extends Aggregate<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
   run<R>(work: (context: {
     repository: ContractRepository<TAggregate>;
   }) => Promise<R>): Promise<R>;
@@ -459,7 +509,7 @@ interface RepositoryContractEnvironment<TAggregate extends IAggregateRoot<Id<str
   teardown?(): Promise<void>;
 }
 /** Fixtures and observable projections supplied by an adapter package. */
-interface RepositoryContractHarness<TAggregate extends IAggregateRoot<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
+interface RepositoryContractHarness<TAggregate extends Aggregate<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent> {
   createEnvironment(): Promise<RepositoryContractEnvironment<TAggregate, TEvent>>;
   /** A fresh aggregate with a unique id. */
   createAggregate(): TAggregate;
@@ -502,7 +552,7 @@ type RepositoryContractTest = ContractTest;
  * callback returns, while the transaction is still open. A test that passes
  * because `add` or `update` writes early is not a conforming implementation.
  */
-declare function createRepositoryContractTests<TAggregate extends IAggregateRoot<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent>(harness: RepositoryContractHarness<TAggregate, TEvent>): RepositoryContractTest[];
+declare function createRepositoryContractTests<TAggregate extends Aggregate<Id<string>, TEvent>, TEvent extends AnyDomainEvent = AnyDomainEvent>(harness: RepositoryContractHarness<TAggregate, TEvent>): RepositoryContractTest[];
 //#endregion
 //#region src/testing/snapshot-store-contract.d.ts
 /** One contract test; bind with `(test.skipped ? it.skip : it)(test.name, test.run)`. */
@@ -552,5 +602,5 @@ interface SnapshotStoreContractHarness {
  */
 declare function createSnapshotStoreContractTests(harness: SnapshotStoreContractHarness): SnapshotStoreContractTest[];
 //#endregion
-export { type CommandOutboxContractEnvironment, type CommandOutboxContractHarness, type CommandOutboxContractTest, type ContractRepository, type DeadlineStoreContractEnvironment, type DeadlineStoreContractHarness, type DeadlineStoreContractTest, type EsContractRepository, type EsRepositoryContractEnvironment, type EsRepositoryContractHarness, type EsRepositoryContractTest, type EventStoreContractEnvironment, type EventStoreContractHarness, type EventStoreContractTest, type IdempotencyStoreContractEnvironment, type IdempotencyStoreContractHarness, type IdempotencyStoreContractTest, type OutboxContractEnvironment, type OutboxContractHarness, type OutboxContractTest, type ProjectionCheckpointStoreContractEnvironment, type ProjectionCheckpointStoreContractHarness, type ProjectionCheckpointStoreContractTest, type RepositoryContractEnvironment, type RepositoryContractHarness, type RepositoryContractTest, type SnapshotStoreContractEnvironment, type SnapshotStoreContractHarness, type SnapshotStoreContractTest, createCommandOutboxContractTests, createDeadlineStoreContractTests, createEsRepositoryContractTests, createEventStoreContractTests, createIdempotencyStoreContractTests, createOutboxContractTests, createProjectionCheckpointStoreContractTests, createRepositoryContractTests, createSnapshotStoreContractTests };
+export { type CommandOutboxContractEnvironment, type CommandOutboxContractHarness, type CommandOutboxContractTest, type ContractRepository, type DeadlineStoreContractEnvironment, type DeadlineStoreContractHarness, type DeadlineStoreContractTest, type EsContractRepository, type EsRepositoryContractEnvironment, type EsRepositoryContractHarness, type EsRepositoryContractTest, type EventBusContractEnvironment, type EventBusContractHarness, type EventBusContractTest, type EventStoreContractEnvironment, type EventStoreContractHarness, type EventStoreContractTest, type IdempotencyStoreContractEnvironment, type IdempotencyStoreContractHarness, type IdempotencyStoreContractTest, type OutboxContractEnvironment, type OutboxContractHarness, type OutboxContractTest, type ProjectionCheckpointStoreContractEnvironment, type ProjectionCheckpointStoreContractHarness, type ProjectionCheckpointStoreContractTest, type RepositoryContractEnvironment, type RepositoryContractHarness, type RepositoryContractTest, type SnapshotStoreContractEnvironment, type SnapshotStoreContractHarness, type SnapshotStoreContractTest, createCommandOutboxContractTests, createDeadlineStoreContractTests, createEsRepositoryContractTests, createEventBusContractTests, createEventStoreContractTests, createIdempotencyStoreContractTests, createOutboxContractTests, createProjectionCheckpointStoreContractTests, createRepositoryContractTests, createSnapshotStoreContractTests };
 //# sourceMappingURL=testing.d.ts.map