@dudousxd/nestjs-durable-testing 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './assertions';
 export * from './harness';
+export * from './replay';
 export * from './steps';
 export * from './transport-conformance';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -16,6 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./assertions"), exports);
 __exportStar(require("./harness"), exports);
+__exportStar(require("./replay"), exports);
 __exportStar(require("./steps"), exports);
 __exportStar(require("./transport-conformance"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B;AAC1B,0CAAwB;AACxB,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,0DAAwC"}

package/dist/replay.d.ts

@@ -0,0 +1,22 @@
+import { type StepCheckpoint, WorkflowEngine, type WorkflowRun } from '@dudousxd/nestjs-durable-core';
+export interface RunHistory {
+    run: WorkflowRun;
+    checkpoints: StepCheckpoint[];
+}
+/**
+ * Replay a recorded run's history against the CURRENT workflow code and throw if they diverged.
+ *
+ * Capture a real (ideally in-flight or representative) run from production —
+ * `{ run: await store.getRun(id), checkpoints: await store.listCheckpoints(id) }` — commit it as a
+ * fixture, and assert here in CI. If a code change renamed/reordered/removed a step at a position the
+ * history already recorded, the engine raises a `NonDeterminismError` on replay and this rethrows it,
+ * catching the break *before* it reaches an in-flight run on deploy (the moment you'd otherwise
+ * silently replay the wrong checkpoint into the wrong step). Register the workflow exactly as the app
+ * does:
+ *
+ * ```ts
+ * await assertReplayable((engine) => engine.register('pipeline', '1', pipeline.run), fixture);
+ * ```
+ */
+export declare function assertReplayable(register: (engine: WorkflowEngine) => void, history: RunHistory): Promise<void>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,cAAc,EACd,KAAK,WAAW,EACjB,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,WAAW,CAAC;IACjB,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,EAC1C,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/replay.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertReplayable = assertReplayable;
+const nestjs_durable_core_1 = require("@dudousxd/nestjs-durable-core");
+/**
+ * Replay a recorded run's history against the CURRENT workflow code and throw if they diverged.
+ *
+ * Capture a real (ideally in-flight or representative) run from production —
+ * `{ run: await store.getRun(id), checkpoints: await store.listCheckpoints(id) }` — commit it as a
+ * fixture, and assert here in CI. If a code change renamed/reordered/removed a step at a position the
+ * history already recorded, the engine raises a `NonDeterminismError` on replay and this rethrows it,
+ * catching the break *before* it reaches an in-flight run on deploy (the moment you'd otherwise
+ * silently replay the wrong checkpoint into the wrong step). Register the workflow exactly as the app
+ * does:
+ *
+ * ```ts
+ * await assertReplayable((engine) => engine.register('pipeline', '1', pipeline.run), fixture);
+ * ```
+ */
+async function assertReplayable(register, history) {
+    const store = new nestjs_durable_core_1.InMemoryStateStore();
+    // Seed as a suspended run with no lock so resume() replays the body against the recorded
+    // checkpoints — no transport is wired, so nothing new is dispatched.
+    await store.createRun({
+        ...history.run,
+        status: 'suspended',
+        lockedBy: undefined,
+        lockedUntil: undefined,
+    });
+    for (const cp of history.checkpoints)
+        await store.saveCheckpoint(cp);
+    const engine = new nestjs_durable_core_1.WorkflowEngine({ store });
+    register(engine);
+    const result = await engine.resume(history.run.id);
+    if (result.status === 'failed' && result.error?.message?.startsWith('non-determinism')) {
+        const err = new Error(result.error.message);
+        err.name = 'NonDeterminismError';
+        throw err;
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/replay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.js","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":";;AA2BA,4CAuBC;AAlDD,uEAKuC;AAOvC;;;;;;;;;;;;;;GAcG;AACI,KAAK,UAAU,gBAAgB,CACpC,QAA0C,EAC1C,OAAmB;IAEnB,MAAM,KAAK,GAAG,IAAI,wCAAkB,EAAE,CAAC;IACvC,yFAAyF;IACzF,qEAAqE;IACrE,MAAM,KAAK,CAAC,SAAS,CAAC;QACpB,GAAG,OAAO,CAAC,GAAG;QACd,MAAM,EAAE,WAAW;QACnB,QAAQ,EAAE,SAAS;QACnB,WAAW,EAAE,SAAS;KACvB,CAAC,CAAC;IACH,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,WAAW;QAAE,MAAM,KAAK,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;IAErE,MAAM,MAAM,GAAG,IAAI,oCAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC7C,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACvF,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5C,GAAG,CAAC,IAAI,GAAG,qBAAqB,CAAC;QACjC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-durable-testing",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Testing utilities for nestjs-durable — a test engine harness, crash/flaky-step injection, and replay assertions",
   "license": "MIT",
   "author": "Davide Carvalho",
@@ -20,7 +20,7 @@
   },
   "devDependencies": {
     "typescript": "5.9.3",
-    "@dudousxd/nestjs-durable-core": "^0.2.0"
+    "@dudousxd/nestjs-durable-core": "^0.4.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",