@ddd-ts-kit/testing 0.2.0 → 0.3.0

package/README.md

@@ -161,7 +161,7 @@ it('records the payment of a placed order', () => {
 it('refuses to pay an order twice', () => {
   given(anOrder().paid())
     .when((order) => order.pay())
-    .thenError(OrderAlreadyPaid, 'ORDER_ALREADY_PAID')
+    .thenError('ORDER_ALREADY_PAID')
     .thenState((order) => expect(order.status).toBe('paid'));
 });
 ```
@@ -175,7 +175,8 @@ the same with the arrangement as a function, replayed from a fresh aggregate at
 | `thenEvents([...])` | exactly these events, in order; each described by its name, its class, or the properties that matter |
 | `thenEventNames([...])` | exactly these names, in order |
 | `thenNoEvent()` | nothing was recorded |
-| `thenError(ErrorClass, code?)`, `thenError(code)` | the action threw that error |
+| `thenError(code)`, `thenError(code, facts)` | the action refused with that code, whatever the class of the error, carrying these facts when given (it may carry others) |
+| `thenError(ErrorClass, code?)` | the action threw an instance of that class: for an error that is one class, as 0.2 wrote them |
 | `thenState((aggregate) => ...)` | your own assertions on the aggregate pass |
 
 Failures are `AssertionError`s of `node:assert` with the expected and recorded events side by
@@ -183,6 +184,25 @@ 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([...])`.
 
+## Refusals
+
+A business refusal is known by its code, and carries its facts as data: a test asserts both,
+never a message and never the class of one refusal.
+
+```ts
+import { expectRefusal } from '@ddd-ts-kit/testing';
+
+expectRefusal(() => calendar.slotFor('consultation', startsAt, now), 'BOOKING_TOO_LATE', { notice: 120 });
+expectRefusal(Email.create('ada@'), 'INVALID_EMAIL');
+await expectRefusal(() => commands.execute(command), 'SLOT_TAKEN', { calendarId: 'calendar-1' });
+```
+
+`expectRefusal(subject, code, facts?)` reads an action, which it runs, a `Result`, or an error
+already caught. An action that returns a promise gives a promise to await. It answers the
+error, and fails with an `AssertionError` that names what was refused instead, or the facts
+that differ, one line each. The facts given must be carried with those values; the refusal may
+carry others.
+
 ## Handlers
 
 ```ts
@@ -292,7 +312,7 @@ afterAll(() => server.close());
 | `client.get / post / put / patch / delete` | JSON in, `{ status, headers, body }` out; `body` is parsed when the content type is JSON, text otherwise; a 4xx or 5xx is a response, not an exception |
 | `client.post(path, body, { headers })`, `client.withHeaders(headers)` | headers for one call, or a client for another caller |
 | `expectStatus(response, 201)` | hands the response back, or fails showing the body, where the API says why |
-| `expectProblem(response, { status, code })` | asserts an RFC 9457 `application/problem+json` answer and returns the document |
+| `expectProblem(response, { status, code, facts })` | asserts an RFC 9457 `application/problem+json` answer and returns the document; `code` and `facts` are optional, and `facts` names the facts the document must expose, as JSON writes them (a date is its ISO text) |
 | `eventually(assertion, { timeoutMs = 2000, intervalMs = 20 })` | retries until the assertion passes; when the time is up, fails quoting the last error |
 | `collectEvents(subscriber, types)` | records published integration events: `received(type?)`, `waitFor(type, predicate?, options?)`, `stop()` |
 
@@ -349,7 +369,7 @@ levels of `docs/ARCHITECTURE.md` (the adapter level is the contract suites, belo
 it('refuses to pay an order twice', () => {
   given(anOrder().paid())
     .when((order) => order.pay(at))
-    .thenError(OrderAlreadyPaid, 'ORDER_ALREADY_PAID');
+    .thenError('ORDER_ALREADY_PAID');
 });
 
 // 2. Application: the real handler through the bus, fakes for the ports.

package/dist/e2e/expect-problem.d.ts

@@ -3,11 +3,14 @@ export interface ExpectedProblem {
     readonly status: number;
     /** The stable error code, when the answer must carry this one. */
     readonly code?: string;
+    /** The facts the document must expose under `facts`, by name, as JSON writes them. It may expose others. */
+    readonly facts?: Readonly<Record<string, unknown>>;
 }
 export type ProblemDetails = Readonly<Record<string, unknown>>;
 /**
  * Asserts an RFC 9457 answer: the status, on the response and in the document, the
- * `application/problem+json` content type and the `code` member. Returns the document.
+ * `application/problem+json` content type, the `code` member and, when given, the exposed
+ * `facts`. Returns the document.
  */
 export declare function expectProblem(response: HttpResponse, expected: ExpectedProblem): ProblemDetails;
 //# sourceMappingURL=expect-problem.d.ts.map

package/dist/e2e/expect-problem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expect-problem.d.ts","sourceRoot":"","sources":["../../src/e2e/expect-problem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAI/D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,GAAG,cAAc,CAkB/F"}
+{"version":3,"file":"expect-problem.d.ts","sourceRoot":"","sources":["../../src/e2e/expect-problem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,4GAA4G;IAC5G,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAI/D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,GAAG,cAAc,CAoB/F"}

package/dist/e2e/expect-problem.js

@@ -2,22 +2,29 @@ import { deepStrictEqual } from 'node:assert';
 const PROBLEM_JSON = 'application/problem+json';
 /**
  * Asserts an RFC 9457 answer: the status, on the response and in the document, the
- * `application/problem+json` content type and the `code` member. Returns the document.
+ * `application/problem+json` content type, the `code` member and, when given, the exposed
+ * `facts`. Returns the document.
  */
 export function expectProblem(response, expected) {
     const problem = isRecord(response.body) ? response.body : {};
     const code = (value) => (expected.code === undefined ? {} : { code: value });
+    const exposed = isRecord(problem.facts) ? problem.facts : {};
+    const names = Object.keys(expected.facts ?? {});
     deepStrictEqual({
         status: response.status,
         contentType: mediaTypeOf(response),
-        problem: { status: problem.status, ...code(problem.code) },
+        problem: { status: problem.status, ...code(problem.code), ...facts(names, exposed) },
     }, {
         status: expected.status,
         contentType: PROBLEM_JSON,
-        problem: { status: expected.status, ...code(expected.code) },
+        problem: { status: expected.status, ...code(expected.code), ...facts(names, expected.facts ?? {}) },
     });
     return problem;
 }
+/** The named facts alone, so that the comparison shows the ones that differ and no other. */
+function facts(names, source) {
+    return names.length === 0 ? {} : { facts: Object.fromEntries(names.map((name) => [name, source[name]])) };
+}
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
 }

package/dist/e2e/expect-problem.js.map

@@ -1 +1 @@
-{"version":3,"file":"expect-problem.js","sourceRoot":"","sources":["../../src/e2e/expect-problem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAW9C,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB,EAAE,QAAyB;IAC7E,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE9F,eAAe,CACb;QACE,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC;QAClC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;KAC3D,EACD;QACE,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;KAC7D,CACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,QAAsB;IACzC,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"expect-problem.js","sourceRoot":"","sources":["../../src/e2e/expect-problem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAa9C,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,QAAsB,EAAE,QAAyB;IAC7E,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,IAAI,GAAG,CAAC,KAAc,EAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9F,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAEhD,eAAe,CACb;QACE,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,WAAW,CAAC,QAAQ,CAAC;QAClC,OAAO,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;KACrF,EACD;QACE,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE;KACpG,CACF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6FAA6F;AAC7F,SAAS,KAAK,CAAC,KAAwB,EAAE,MAAyC;IAChF,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5G,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,WAAW,CAAC,QAAsB;IACzC,OAAO,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAC/E,CAAC"}

package/dist/index.d.ts

@@ -14,6 +14,8 @@ export { ExecutionContextBuilder } from './execution/execution-context-builder.j
 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 { expectRefusal } from './refusals/expect-refusal.js';
+export type { ExpectedFacts } from './refusals/expected-facts.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';

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,YAAY,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,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

@@ -11,6 +11,7 @@ export { ExecutionContextBuilder } from './execution/execution-context-builder.j
 export { scoped } from './execution/scoped.js';
 export { SessionBuilder } from './execution/session-builder.js';
 export { createTestBuses } from './harness/create-test-buses.js';
+export { expectRefusal } from './refusals/expect-refusal.js';
 export { InMemoryRepository } from './repositories/in-memory-repository.js';
 export { snapshots } from './repositories/snapshots.js';
 export { expectNoSecret } from './secrecy/expect-no-secret.js';

package/dist/index.js.map

@@ -1 +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"}
+{"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,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,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/refusals/expect-refusal.d.ts

@@ -0,0 +1,13 @@
+import type { ExpectedFacts } from './expected-facts.js';
+/**
+ * Asserts a business refusal by its code, and by its facts when given: on an error that was
+ * caught, on a `Result`, or on an action, which is run. The class of the error is not looked
+ * at. Returns the error; an action that returns a promise gives a promise to await.
+ *
+ *     expectRefusal(() => appointment.cancel(at), 'APPOINTMENT_ENDED', { status: 'cancelled' });
+ *     expectRefusal(Email.create('nope'), 'INVALID_EMAIL');
+ *     await expectRefusal(() => bus.execute(command), 'SLOT_TAKEN');
+ */
+export declare function expectRefusal(subject: () => PromiseLike<unknown>, code: string, facts?: ExpectedFacts): Promise<unknown>;
+export declare function expectRefusal(subject: unknown, code: string, facts?: ExpectedFacts): unknown;
+//# sourceMappingURL=expect-refusal.d.ts.map

package/dist/refusals/expect-refusal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-refusal.d.ts","sourceRoot":"","sources":["../../src/refusals/expect-refusal.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQzD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,WAAW,CAAC,OAAO,CAAC,EACnC,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,aAAa,GACpB,OAAO,CAAC,OAAO,CAAC,CAAC;AACpB,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC"}

package/dist/refusals/expect-refusal.js

@@ -0,0 +1,64 @@
+import { AssertionError } from 'node:assert';
+import { isPromiseLike } from '../scenarios/is-promise-like.js';
+import { show } from '../scenarios/show.js';
+import { factMismatches } from './fact-mismatches.js';
+export function expectRefusal(subject, code, facts = {}) {
+    const attempt = attempted(subject);
+    if (isPromiseLike(attempt)) {
+        return Promise.resolve(attempt).then(() => refusalOf({ refused: false }, code, facts), (error) => refusalOf({ refused: true, error }, code, facts));
+    }
+    return refusalOf(attempt, code, facts);
+}
+function attempted(subject) {
+    if (!isAction(subject)) {
+        return outcomeOf(subject);
+    }
+    try {
+        const answer = subject();
+        return isPromiseLike(answer) ? answer : outcomeOf(answer, { ran: true });
+    }
+    catch (error) {
+        return { refused: true, error };
+    }
+}
+function isAction(subject) {
+    return typeof subject === 'function';
+}
+/** A `Result` says by itself whether it refuses; anything else an action returned is a success. */
+function outcomeOf(value, { ran = false } = {}) {
+    if (typeof value === 'object' && value !== null && 'ok' in value && typeof value.ok === 'boolean') {
+        return value.ok || !('error' in value) ? { refused: false } : { refused: true, error: value.error };
+    }
+    return ran ? { refused: false } : { refused: true, error: value };
+}
+function refusalOf(attempt, code, facts) {
+    if (!attempt.refused) {
+        throw failure(`Expected a refusal with code ${code}, but nothing was refused.`, undefined, code);
+    }
+    const { error } = attempt;
+    const actual = codeOf(error);
+    if (actual !== code) {
+        throw failure(`Expected a refusal with code ${code}, but got ${described(error)}.`, actual, code);
+    }
+    const mismatches = factMismatches(error, facts);
+    if (mismatches.length > 0) {
+        throw failure([`The refusal ${code} does not carry the expected facts.`, ...mismatches].join('\n  '), error, facts);
+    }
+    return error;
+}
+function failure(message, actual, expected) {
+    return new AssertionError({ message, actual, expected, operator: 'expectRefusal' });
+}
+function codeOf(error) {
+    return typeof error === 'object' && error !== null && 'code' in error && typeof error.code === 'string'
+        ? error.code
+        : undefined;
+}
+function described(error) {
+    if (!(error instanceof Error)) {
+        return show(error);
+    }
+    const code = codeOf(error);
+    return `${error.constructor.name}${code === undefined ? '' : ` (code ${code})`}: ${error.message}`;
+}
+//# sourceMappingURL=expect-refusal.js.map

package/dist/refusals/expect-refusal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect-refusal.js","sourceRoot":"","sources":["../../src/refusals/expect-refusal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAuBtD,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,IAAY,EAAE,KAAK,GAAkB,EAAE;IACrF,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAEnC,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAClC,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,EAChD,CAAC,KAAc,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CACrE,CAAC;IACJ,CAAC;IAED,OAAO,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAC,OAAgB;IACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAY,OAAO,EAAE,CAAC;QAElC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,OAAgB;IAChC,OAAO,OAAO,OAAO,KAAK,UAAU,CAAC;AACvC,CAAC;AAED,mGAAmG;AACnG,SAAS,SAAS,CAAC,KAAc,EAAE,EAAE,GAAG,GAAG,KAAK,EAAE,GAAG,EAAE;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAClG,OAAO,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;IACtG,CAAC;IAED,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACpE,CAAC;AAED,SAAS,SAAS,CAAC,OAAgB,EAAE,IAAY,EAAE,KAAoB;IACrE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACrB,MAAM,OAAO,CAAC,gCAAgC,IAAI,4BAA4B,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACnG,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,OAAO,CAAC,gCAAgC,IAAI,aAAa,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACpG,CAAC;IAED,MAAM,UAAU,GAAG,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,CAAC,CAAC,eAAe,IAAI,qCAAqC,EAAE,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACtH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,OAAe,EAAE,MAAe,EAAE,QAAiB;IAClE,OAAO,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,MAAM,CAAC,KAAc;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QACrG,CAAC,CAAC,KAAK,CAAC,IAAI;QACZ,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,CAAC,CAAC,KAAK,YAAY,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3B,OAAO,GAAG,KAAK,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;AACrG,CAAC"}

package/dist/refusals/expected-facts.d.ts

@@ -0,0 +1,3 @@
+/** The facts a refusal must carry, by name. A refusal may carry others. */
+export type ExpectedFacts = Readonly<Record<string, unknown>>;
+//# sourceMappingURL=expected-facts.d.ts.map

package/dist/refusals/expected-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expected-facts.d.ts","sourceRoot":"","sources":["../../src/refusals/expected-facts.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,MAAM,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC"}

package/dist/refusals/expected-facts.js

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

package/dist/refusals/expected-facts.js.map

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

package/dist/refusals/fact-mismatches.d.ts

@@ -0,0 +1,4 @@
+import type { ExpectedFacts } from './expected-facts.js';
+/** One sentence per expected fact the error does not carry with that value. */
+export declare function factMismatches(error: unknown, expected: ExpectedFacts): string[];
+//# sourceMappingURL=fact-mismatches.d.ts.map

package/dist/refusals/fact-mismatches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-mismatches.d.ts","sourceRoot":"","sources":["../../src/refusals/fact-mismatches.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,GAAG,MAAM,EAAE,CAYhF"}

package/dist/refusals/fact-mismatches.js

@@ -0,0 +1,22 @@
+import { isDeepStrictEqual } from 'node:util';
+import { show } from '../scenarios/show.js';
+/** One sentence per expected fact the error does not carry with that value. */
+export function factMismatches(error, expected) {
+    const facts = factsOf(error);
+    return Object.entries(expected).flatMap(([name, value]) => {
+        if (!(name in facts)) {
+            return [`fact ${name}: expected ${show(value)}, the refusal carries no such fact`];
+        }
+        return isDeepStrictEqual(facts[name], value)
+            ? []
+            : [`fact ${name}: expected ${show(value)}, got ${show(facts[name])}`];
+    });
+}
+function factsOf(error) {
+    if (typeof error !== 'object' || error === null || !('facts' in error)) {
+        return {};
+    }
+    const { facts } = error;
+    return typeof facts === 'object' && facts !== null ? { ...facts } : {};
+}
+//# sourceMappingURL=fact-mismatches.js.map

package/dist/refusals/fact-mismatches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fact-mismatches.js","sourceRoot":"","sources":["../../src/refusals/fact-mismatches.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAG5C,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,QAAuB;IACpE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE7B,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACxD,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,IAAI,cAAc,IAAI,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACrF,CAAC;QAED,OAAO,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,CAAC,QAAQ,IAAI,cAAc,IAAI,CAAC,KAAK,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,EAAE,CAAC;QACvE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAExB,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC"}

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

@@ -1,4 +1,5 @@
 import type { AsyncOutcome } from './async-outcome.js';
+import type { ExpectedFacts } from '../refusals/expected-facts.js';
 import type { ErrorClass } from './error-class.js';
 import type { EventMatcher } from './event-matcher.js';
 import type { Recorded } from './recorded.js';
@@ -10,7 +11,7 @@ export declare class DeferredOutcome<A> implements AsyncOutcome<A> {
     thenEvents(expected: readonly EventMatcher[]): this;
     thenEventNames(expected: readonly string[]): this;
     thenNoEvent(): this;
-    thenError(typeOrCode: ErrorClass | string, code?: string): this;
+    thenError(typeOrCode: ErrorClass | string, detail?: string | ExpectedFacts): 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;

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

@@ -1 +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"}
+{"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,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,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,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAEhF;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

@@ -17,8 +17,8 @@ export class DeferredOutcome {
     thenNoEvent() {
         return this.after((outcome) => outcome.thenNoEvent());
     }
-    thenError(typeOrCode, code) {
-        return this.after((outcome) => typeof typeOrCode === 'string' ? outcome.thenError(typeOrCode) : outcome.thenError(typeOrCode, code));
+    thenError(typeOrCode, detail) {
+        return this.after((outcome) => outcome.thenError(typeOrCode, detail));
     }
     thenState(inspectState) {
         return this.after((outcome) => outcome.thenState(inspectState));

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

@@ -1 +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"}
+{"version":3,"file":"deferred-outcome.js","sourceRoot":"","sources":["../../src/scenarios/deferred-outcome.ts"],"names":[],"mappings":"AAIA,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,MAA+B;QACxE,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACxE,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/immediate-outcome.d.ts

@@ -1,3 +1,4 @@
+import type { ExpectedFacts } from '../refusals/expected-facts.js';
 import type { ErrorClass } from './error-class.js';
 import type { EventMatcher } from './event-matcher.js';
 import type { Outcome } from './outcome.js';
@@ -10,7 +11,7 @@ export declare class ImmediateOutcome<A> implements Outcome<A> {
     thenEvents(expected: readonly EventMatcher[]): this;
     thenEventNames(expected: readonly string[]): this;
     thenNoEvent(): this;
-    thenError(typeOrCode: ErrorClass | string, code?: string): this;
+    thenError(typeOrCode: ErrorClass | string, detail?: string | ExpectedFacts): this;
     thenState(inspectState: (aggregate: A) => void): this;
     private thrownInsteadOf;
     private assertDidNotThrow;

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

@@ -1 +1 @@
-{"version":3,"file":"immediate-outcome.d.ts","sourceRoot":"","sources":["../../src/scenarios/immediate-outcome.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,gFAAgF;AAChF,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAIxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,aAAa,CAAS;IAE9B,YAA6B,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAI;IAEtD,UAAU,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CA6BlD;IAED,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAkBhD;IAED,WAAW,IAAI,IAAI,CAclB;IAED,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAwB9D;IAED,SAAS,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAQpD;IAED,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,iBAAiB;CAY1B"}
+{"version":3,"file":"immediate-outcome.d.ts","sourceRoot":"","sources":["../../src/scenarios/immediate-outcome.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAGnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAG9C,gFAAgF;AAChF,qBAAa,gBAAgB,CAAC,CAAC,CAAE,YAAW,OAAO,CAAC,CAAC,CAAC;IAIxC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAFrC,OAAO,CAAC,aAAa,CAAS;IAE9B,YAA6B,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAI;IAEtD,UAAU,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CA6BlD;IAED,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAkBhD;IAED,WAAW,IAAI,IAAI,CAclB;IAED,SAAS,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAyBhF;IAED,SAAS,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAQpD;IAED,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/scenarios/immediate-outcome.js

@@ -1,5 +1,6 @@
 import { AssertionError } from 'node:assert';
 import { isDeepStrictEqual } from 'node:util';
+import { factMismatches } from '../refusals/fact-mismatches.js';
 import { describeEvent } from './describe-event.js';
 import { eventMismatches } from './event-mismatches.js';
 import { show } from './show.js';
@@ -66,9 +67,9 @@ export class ImmediateOutcome {
         }
         return this;
     }
-    thenError(typeOrCode, code) {
+    thenError(typeOrCode, detail) {
         const type = typeof typeOrCode === 'string' ? undefined : typeOrCode;
-        const expectedCode = typeof typeOrCode === 'string' ? typeOrCode : code;
+        const expectedCode = typeof typeOrCode === 'string' ? typeOrCode : codeIn(detail);
         const expected = [type?.name, expectedCode === undefined ? undefined : `code ${expectedCode}`]
             .filter((part) => part !== undefined)
             .join(' with ');
@@ -83,6 +84,7 @@ export class ImmediateOutcome {
                 operator: 'thenError',
             });
         }
+        assertFacts(error, typeof detail === 'object' ? detail : {});
         this.errorAsserted = true;
         return this;
     }
@@ -132,6 +134,20 @@ function describeMatcher(matcher) {
     }
     return typeof matcher === 'function' ? `instance of ${matcher.name}` : show(matcher);
 }
+function codeIn(detail) {
+    return typeof detail === 'string' ? detail : undefined;
+}
+function assertFacts(error, expected) {
+    const mismatches = factMismatches(error, expected);
+    if (mismatches.length > 0) {
+        throw new AssertionError({
+            message: ['The error does not carry the expected facts.', ...section('Difference', mismatches)].join('\n'),
+            actual: error,
+            expected,
+            operator: 'thenError',
+        });
+    }
+}
 function codeOf(error) {
     return typeof error === 'object' && error !== null && 'code' in error && typeof error.code === 'string'
         ? error.code

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

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

package/dist/scenarios/outcome.d.ts

@@ -1,3 +1,4 @@
+import type { ExpectedFacts } from '../refusals/expected-facts.js';
 import type { ErrorClass } from './error-class.js';
 import type { EventMatcher } from './event-matcher.js';
 /** The assertions available once `when` ran. Each returns the outcome, so they chain. */
@@ -9,8 +10,8 @@ export interface Outcome<A> {
     thenNoEvent(): this;
     /** The action threw an instance of `type` (and, when given, with this `code`). */
     thenError(type: ErrorClass, code?: string): this;
-    /** The action threw an error carrying this `code`, whatever its class. */
-    thenError(code: string): this;
+    /** The action threw an error carrying this `code`, whatever its class, and these facts when given. */
+    thenError(code: string, facts?: ExpectedFacts): this;
     /** Inspects the aggregate after the action; `inspect` asserts with the runner's own tools. */
     thenState(inspect: (aggregate: A) => void): this;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/scenarios/outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,yFAAyF;AACzF,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,2CAA2C;IAC3C,UAAU,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAAC;IACpD,gDAAgD;IAChD,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,WAAW,IAAI,IAAI,CAAC;IACpB,kFAAkF;IAClF,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,0EAA0E;IAC1E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,8FAA8F;IAC9F,SAAS,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CAClD"}
+{"version":3,"file":"outcome.d.ts","sourceRoot":"","sources":["../../src/scenarios/outcome.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,yFAAyF;AACzF,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,2CAA2C;IAC3C,UAAU,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,GAAG,IAAI,CAAC;IACpD,gDAAgD;IAChD,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IAClD,WAAW,IAAI,IAAI,CAAC;IACpB,kFAAkF;IAClF,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,sGAAsG;IACtG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACrD,8FAA8F;IAC9F,SAAS,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC;CAClD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ddd-ts-kit/testing",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Readable tests without mocks: test data builders, given/when/then scenarios and contract suites shared by fakes and real adapters.",
   "license": "MIT",
   "repository": {
@@ -46,11 +46,11 @@
     "dist"
   ],
   "dependencies": {
-    "@ddd-ts-kit/kernel": "0.2.0"
+    "@ddd-ts-kit/kernel": "0.3.0"
   },
   "devDependencies": {
-    "@ddd-ts-kit/aspects": "0.2.0",
-    "@ddd-ts-kit/events": "0.2.0",
+    "@ddd-ts-kit/aspects": "0.3.0",
+    "@ddd-ts-kit/events": "0.3.0",
     "@faker-js/faker": "^10.6.0"
   },
   "peerDependencies": {