@ddd-ts-kit/testing 0.10.0 → 0.12.0

package/dist/processes/process-outcome.js

@@ -0,0 +1,67 @@
+import { AssertionError } from 'node:assert';
+import { isDeepStrictEqual } from 'node:util';
+import { show } from '../scenarios/show.js';
+import { subsetDifferences } from '../scenarios/subset-differences.js';
+/** What one step of a process decided, asserted without a store, a queue or a bus. Each assertion answers the outcome, to chain. */
+export class ProcessOutcome {
+    decision;
+    constructor(decision) {
+        this.decision = decision;
+    }
+    /** The step ignored what it was given: no state saved, nothing sent. */
+    thenIgnored() {
+        return this.holds(this.decision === undefined, `expected the step to ignore it, it decided ${show(this.decision)}`);
+    }
+    /** Also asserts that the state survives the JSON the runner stores it as: a `Date` or a class instance does not. */
+    thenState(expected) {
+        const state = this.decided().state;
+        const stored = state === undefined ? undefined : JSON.parse(JSON.stringify(state));
+        this.holds(isDeepStrictEqual(stored, state), `the state ${show(state)} is stored as JSON and read back as ${show(stored)}: keep it plain JSON data`);
+        return this.holds(isDeepStrictEqual(state, expected), `expected the state ${show(expected)}, decided ${show(state)}`);
+    }
+    /** Exactly these commands, in order: each by its class or the properties that matter. */
+    thenCommands(expected) {
+        const sent = this.decided().commands ?? [];
+        const lines = [
+            ...(sent.length === expected.length ? [] : [`expected ${expected.length} command(s), decided ${sent.length}`]),
+            ...expected.flatMap((matcher, index) => commandMismatches(sent[index], matcher, `command ${index}`)),
+        ];
+        return this.holds(lines.length === 0, lines.join('\n'));
+    }
+    thenTimeouts(expected) {
+        const armed = this.decided().timeouts ?? [];
+        return this.holds(isDeepStrictEqual(armed, expected), `expected the timeouts ${show(expected)}, decided ${show(armed)}`);
+    }
+    /** The names of the timeouts the step disarms. */
+    thenCancelled(expected) {
+        const cancelled = this.decided().cancel ?? [];
+        return this.holds(isDeepStrictEqual(cancelled, expected), `expected to disarm ${show(expected)}, decided ${show(cancelled)}`);
+    }
+    thenEnded() {
+        return this.holds(this.decided().ended === true, 'expected the process to end, it goes on');
+    }
+    decided() {
+        if (this.decision === undefined) {
+            throw new AssertionError({ message: 'expected a decision, the step ignored what it was given' });
+        }
+        return this.decision;
+    }
+    holds(condition, message) {
+        if (!condition) {
+            throw new AssertionError({ message });
+        }
+        return this;
+    }
+}
+function commandMismatches(command, matcher, where) {
+    if (command === undefined) {
+        return [`${where}: none was decided`];
+    }
+    if (typeof matcher === 'function') {
+        return command instanceof matcher
+            ? []
+            : [`${where}: expected an instance of ${matcher.name}, decided ${show(command)}`];
+    }
+    return subsetDifferences(command, matcher, where);
+}
+//# sourceMappingURL=process-outcome.js.map

package/dist/processes/process-outcome.js.map

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

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

@@ -1 +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"}
+{"version":3,"file":"event-mismatches.d.ts","sourceRoot":"","sources":["../../src/scenarios/event-mismatches.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,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

@@ -1,6 +1,6 @@
-import { isDeepStrictEqual } from 'node:util';
 import { describeEvent } from './describe-event.js';
 import { show } from './show.js';
+import { subsetDifferences } from './subset-differences.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') {
@@ -13,21 +13,4 @@ export function eventMismatches(event, matcher, where) {
     }
     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

@@ -1 +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"}
+{"version":3,"file":"event-mismatches.js","sourceRoot":"","sources":["../../src/scenarios/event-mismatches.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,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"}

package/dist/scenarios/subset-differences.d.ts

@@ -0,0 +1,3 @@
+/** Where `actual` differs from the properties `expected` names, one line each: a plain object of `expected` is a subset. */
+export declare function subsetDifferences(actual: unknown, expected: unknown, path: string): string[];
+//# sourceMappingURL=subset-differences.d.ts.map

package/dist/scenarios/subset-differences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subset-differences.d.ts","sourceRoot":"","sources":["../../src/scenarios/subset-differences.ts"],"names":[],"mappings":"AAGA,4HAA4H;AAC5H,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAW5F"}

package/dist/scenarios/subset-differences.js

@@ -0,0 +1,21 @@
+import { isDeepStrictEqual } from 'node:util';
+import { show } from './show.js';
+/** Where `actual` differs from the properties `expected` names, one line each: a plain object of `expected` is a subset. */
+export 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=subset-differences.js.map

package/dist/scenarios/subset-differences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subset-differences.js","sourceRoot":"","sources":["../../src/scenarios/subset-differences.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,4HAA4H;AAC5H,MAAM,UAAU,iBAAiB,CAAC,MAAe,EAAE,QAAiB,EAAE,IAAY;IAChF,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ddd-ts-kit/testing",
-  "version": "0.10.0",
+  "version": "0.12.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,12 +46,13 @@
     "dist"
   ],
   "dependencies": {
-    "@ddd-ts-kit/kernel": "0.10.0"
+    "@ddd-ts-kit/kernel": "0.12.0"
   },
   "devDependencies": {
-    "@ddd-ts-kit/aspects": "0.10.0",
-    "@ddd-ts-kit/events": "0.10.0",
-    "@faker-js/faker": "^10.6.0"
+    "@ddd-ts-kit/aspects": "0.12.0",
+    "@ddd-ts-kit/events": "0.12.0",
+    "@faker-js/faker": "^10.6.0",
+    "@ddd-ts-kit/scheduling": "0.12.0"
   },
   "peerDependencies": {
     "@faker-js/faker": ">=9.0.0"