@dudousxd/nestjs-durable-core 0.5.0 → 0.7.0

package/dist/scheduler.js

@@ -1,21 +1,55 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scheduledRunId = scheduledRunId;
+exports.prevCronFireMs = prevCronFireMs;
 exports.runSchedules = runSchedules;
-/** Deterministic run id for a schedule's current time window — stable within that window. */
+/** Deterministic run id for a fixed-interval schedule's current time window. */
 function scheduledRunId(key, everyMs, nowMs) {
     return `sched:${key}:${Math.floor(nowMs / everyMs)}`;
 }
+let cronParser;
+function loadCronParser() {
+    if (cronParser)
+        return cronParser;
+    try {
+        // Lazy + optional: core stays dependency-free; only users who schedule by cron need this.
+        cronParser = require('cron-parser');
+    }
+    catch {
+        throw new Error('cron schedules need the optional peer dependency "cron-parser" — install it (e.g. `npm i cron-parser`).');
+    }
+    return cronParser;
+}
+/**
+ * Epoch ms of the most recent cron fire at or before `nowMs`, evaluated in `timezone` (default UTC).
+ * This is the deterministic "bucket" a cron run is keyed on, so polling repeatedly within an
+ * interval resolves to the same fire time — and thus the same idempotent run id.
+ */
+function prevCronFireMs(expr, nowMs, timezone = 'UTC') {
+    const parser = loadCronParser();
+    // `+1` makes a fire landing exactly on `nowMs` count as "at or before now", not the prior one.
+    const it = parser.parseExpression(expr, { currentDate: new Date(nowMs + 1), tz: timezone });
+    return it.prev().toDate().getTime();
+}
+/** The deterministic, idempotent run id for a schedule at `nowMs` — its current fire window. */
+function scheduleRunIdAt(s, nowMs) {
+    if (s.cron != null)
+        return `sched:${s.key}:${prevCronFireMs(s.cron, nowMs, s.timezone)}`;
+    if (s.everyMs != null)
+        return scheduledRunId(s.key, s.everyMs, nowMs);
+    throw new Error(`schedule "${s.key}" needs either "everyMs" or "cron"`);
+}
 /**
- * Start each schedule's current-window run. The run id is the time bucket and `engine.start` is
- * idempotent, so firing this on an interval — or racing two instances on the same tick — starts
- * **each window exactly once**. Wire it to a `setInterval`, the durable timer poller, or
- * `@nestjs/schedule`. Returns the run ids for the current windows.
+ * Start each schedule's current-window run. The run id is the time bucket (a fixed-interval index,
+ * or the cron fire time) and `engine.start` is idempotent, so firing this on an interval — or
+ * racing two instances on the same tick — starts **each window exactly once**. Wire it to a
+ * `setInterval`, the durable timer poller, or `@nestjs/schedule`. Returns the run ids for the
+ * current windows.
  */
 async function runSchedules(engine, schedules, nowMs) {
     const ids = [];
     for (const s of schedules) {
-        const runId = scheduledRunId(s.key, s.everyMs, nowMs);
+        const runId = scheduleRunIdAt(s, nowMs);
         await engine.start(s.workflow, s.input, runId);
         ids.push(runId);
     }

package/dist/scheduler.js.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":";;AAYA,wCAEC;AAQD,oCAYC;AAvBD,6FAA6F;AAC7F,SAAgB,cAAc,CAAC,GAAW,EAAE,OAAe,EAAE,KAAa;IACxE,OAAO,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;;;GAKG;AACI,KAAK,UAAU,YAAY,CAChC,MAAqC,EACrC,SAAuC,EACvC,KAAa;IAEb,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":";;AAoBA,wCAEC;AAsBD,wCAKC;AAgBD,oCAYC;AA1DD,gFAAgF;AAChF,SAAgB,cAAc,CAAC,GAAW,EAAE,OAAe,EAAE,KAAa;IACxE,OAAO,SAAS,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;AACvD,CAAC;AAGD,IAAI,UAAkC,CAAC;AACvC,SAAS,cAAc;IACrB,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAClC,IAAI,CAAC;QACH,0FAA0F;QAC1F,UAAU,GAAG,OAAO,CAAC,aAAa,CAAe,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,yGAAyG,CAC1G,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAY,EAAE,KAAa,EAAE,QAAQ,GAAG,KAAK;IAC1E,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;IAChC,+FAA+F;IAC/F,MAAM,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC5F,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,gGAAgG;AAChG,SAAS,eAAe,CAAC,CAAoB,EAAE,KAAa;IAC1D,IAAI,CAAC,CAAC,IAAI,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC,CAAC,GAAG,IAAI,cAAc,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;IACzF,IAAI,CAAC,CAAC,OAAO,IAAI,IAAI;QAAE,OAAO,cAAc,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACtE,MAAM,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC,GAAG,oCAAoC,CAAC,CAAC;AAC1E,CAAC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,YAAY,CAChC,MAAqC,EACrC,SAAuC,EACvC,KAAa;IAEb,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,eAAe,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACxC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC/C,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/testing/in-memory-transport.d.ts

@@ -1,10 +1,12 @@
-import type { ControlMessage, Heartbeat, RemoteTask, StepResult, Transport } from '../interfaces';
+import type { ControlMessage, ControlPlane, Heartbeat, RemoteTask, StepResult, Transport } from '../interfaces';
 import { type StepHandler } from '../protocol';
 /**
- * An in-process `Transport` for tests and local development: registered handlers stand in
- * for remote workers, so a whole cross-app workflow runs in a single process.
+ * An in-process `Transport` (and `ControlPlane`) for tests and local development: registered
+ * handlers stand in for remote workers, so a whole cross-app workflow runs in a single process,
+ * and control messages broadcast locally. Pass the same instance as both `transport` and
+ * `controlPlane`.
  */
-export declare class InMemoryTransport implements Transport {
+export declare class InMemoryTransport implements Transport, ControlPlane {
     private readonly handlers;
     private resultHandler?;
     private readonly controlHandlers;

package/dist/testing/in-memory-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-transport.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAClG,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE/D;;;GAGG;AACH,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,aAAa,CAAC,CAAwC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAE5E,sDAAsD;IACtD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAIrC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI9D,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMzD,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;CAGxD"}
+{"version":3,"file":"in-memory-transport.d.ts","sourceRoot":"","sources":["../../src/testing/in-memory-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACV,UAAU,EACV,SAAS,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE/D;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,SAAS,EAAE,YAAY;IAC/D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,aAAa,CAAC,CAAwC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAE5E,sDAAsD;IACtD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,WAAW,GAAG,IAAI;IAIrC,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/C,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI9D,WAAW,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAMzD,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;CAGxD"}

package/dist/testing/in-memory-transport.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.InMemoryTransport = void 0;
 const protocol_1 = require("../protocol");
 /**
- * An in-process `Transport` for tests and local development: registered handlers stand in
- * for remote workers, so a whole cross-app workflow runs in a single process.
+ * An in-process `Transport` (and `ControlPlane`) for tests and local development: registered
+ * handlers stand in for remote workers, so a whole cross-app workflow runs in a single process,
+ * and control messages broadcast locally. Pass the same instance as both `transport` and
+ * `controlPlane`.
  */
 class InMemoryTransport {
     handlers = new Map();

package/dist/testing/in-memory-transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"in-memory-transport.js","sourceRoot":"","sources":["../../src/testing/in-memory-transport.ts"],"names":[],"mappings":";;;AACA,0CAA+D;AAE/D;;;GAGG;AACH,MAAa,iBAAiB;IACX,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IACnD,aAAa,CAAyC;IAC7C,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;IAE5E,sDAAsD;IACtD,MAAM,CAAC,IAAY,EAAE,EAAe;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAgB;QAC7B,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAc,EAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,6FAA6F;QAC7F,wFAAwF;QACxF,2DAA2D;QAC3D,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,QAAQ,CAAC,OAA8C;QACrD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,QAA4C;QACtD,wEAAwE;IAC1E,CAAC;IAED,4FAA4F;IAC5F,8FAA8F;IAC9F,KAAK,CAAC,cAAc,CAAC,GAAmB;QACtC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,SAAS,CAAC,OAAsC;QAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF;AApCD,8CAoCC"}
+{"version":3,"file":"in-memory-transport.js","sourceRoot":"","sources":["../../src/testing/in-memory-transport.ts"],"names":[],"mappings":";;;AAQA,0CAA+D;AAE/D;;;;;GAKG;AACH,MAAa,iBAAiB;IACX,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IACnD,aAAa,CAAyC;IAC7C,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;IAE5E,sDAAsD;IACtD,MAAM,CAAC,IAAY,EAAE,EAAe;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAgB;QAC7B,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,MAAM,IAAA,yBAAc,EAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,6FAA6F;QAC7F,wFAAwF;QACxF,2DAA2D;QAC3D,YAAY,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,QAAQ,CAAC,OAA8C;QACrD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,QAA4C;QACtD,wEAAwE;IAC1E,CAAC;IAED,4FAA4F;IAC5F,8FAA8F;IAC9F,KAAK,CAAC,cAAc,CAAC,GAAmB;QACtC,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,SAAS,CAAC,OAAsC;QAC9C,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF;AApCD,8CAoCC"}

package/dist/transport-pool.d.ts

@@ -0,0 +1,23 @@
+import type { Heartbeat, NamedTransport, RemoteTask, StepResult } from './interfaces';
+/**
+ * An ordered pool of named transports. The engine dispatches on the first and fails over to the
+ * next on a dispatch error; a step can pin one by id. Pure transport plumbing — no run lifecycle —
+ * so it lives apart from the engine.
+ */
+export declare class TransportPool {
+    private readonly transports;
+    constructor(transports: NamedTransport[]);
+    get size(): number;
+    /** Register the engine's result/heartbeat handlers on EVERY transport — a result can come back on
+     *  whichever one delivered the task, so failover stays symmetric. */
+    bind(onResult: (result: StepResult) => Promise<void>, onHeartbeat: (beat: Heartbeat) => Promise<void>): void;
+    /**
+     * Dispatch `task` over the pool: try the preferred (or first) transport, fail over to the next on
+     * a dispatch error, and stamp the task with the id of the transport that accepted it (so a worker
+     * replies on the matching one). Throws if every transport fails.
+     */
+    dispatch(task: Omit<RemoteTask, 'transport'>, preferId?: string): Promise<void>;
+    /** Pinned `preferId` first, then the rest (failover order). */
+    private ordered;
+}
+//# sourceMappingURL=transport-pool.d.ts.map

package/dist/transport-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-pool.d.ts","sourceRoot":"","sources":["../src/transport-pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAEtF;;;;GAIG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,UAAU;gBAAV,UAAU,EAAE,cAAc,EAAE;IAEzD,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;yEACqE;IACrE,IAAI,CACF,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EAC/C,WAAW,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,GAC9C,IAAI;IAOP;;;;OAIG;IACG,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAarF,+DAA+D;IAC/D,OAAO,CAAC,OAAO;CAMhB"}

package/dist/transport-pool.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransportPool = void 0;
+/**
+ * An ordered pool of named transports. The engine dispatches on the first and fails over to the
+ * next on a dispatch error; a step can pin one by id. Pure transport plumbing — no run lifecycle —
+ * so it lives apart from the engine.
+ */
+class TransportPool {
+    transports;
+    constructor(transports) {
+        this.transports = transports;
+    }
+    get size() {
+        return this.transports.length;
+    }
+    /** Register the engine's result/heartbeat handlers on EVERY transport — a result can come back on
+     *  whichever one delivered the task, so failover stays symmetric. */
+    bind(onResult, onHeartbeat) {
+        for (const { transport } of this.transports) {
+            transport.onResult(onResult);
+            transport.onHeartbeat(onHeartbeat);
+        }
+    }
+    /**
+     * Dispatch `task` over the pool: try the preferred (or first) transport, fail over to the next on
+     * a dispatch error, and stamp the task with the id of the transport that accepted it (so a worker
+     * replies on the matching one). Throws if every transport fails.
+     */
+    async dispatch(task, preferId) {
+        let lastErr;
+        for (const { id, transport } of this.ordered(preferId)) {
+            try {
+                await transport.dispatch({ ...task, transport: id });
+                return;
+            }
+            catch (err) {
+                lastErr = err;
+            }
+        }
+        throw lastErr ?? new Error('no transport accepted the dispatch');
+    }
+    /** Pinned `preferId` first, then the rest (failover order). */
+    ordered(preferId) {
+        if (!preferId)
+            return this.transports;
+        const pref = this.transports.filter((t) => t.id === preferId);
+        if (pref.length === 0)
+            throw new Error(`transport "${preferId}" is not registered`);
+        return [...pref, ...this.transports.filter((t) => t.id !== preferId)];
+    }
+}
+exports.TransportPool = TransportPool;
+//# sourceMappingURL=transport-pool.js.map

package/dist/transport-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport-pool.js","sourceRoot":"","sources":["../src/transport-pool.ts"],"names":[],"mappings":";;;AAEA;;;;GAIG;AACH,MAAa,aAAa;IACK;IAA7B,YAA6B,UAA4B;QAA5B,eAAU,GAAV,UAAU,CAAkB;IAAG,CAAC;IAE7D,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;yEACqE;IACrE,IAAI,CACF,QAA+C,EAC/C,WAA+C;QAE/C,KAAK,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YAC5C,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC7B,SAAS,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,IAAmC,EAAE,QAAiB;QACnE,IAAI,OAAgB,CAAC;QACrB,KAAK,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,CAAC;gBACrD,OAAO;YACT,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,GAAG,GAAG,CAAC;YAChB,CAAC;QACH,CAAC;QACD,MAAM,OAAO,IAAI,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACnE,CAAC;IAED,+DAA+D;IACvD,OAAO,CAAC,QAAiB;QAC/B,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,cAAc,QAAQ,qBAAqB,CAAC,CAAC;QACpF,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC;IACxE,CAAC;CACF;AA5CD,sCA4CC"}

package/dist/workflow-ctx.d.ts

@@ -0,0 +1,46 @@
+import type { RemoteStepDef, StateStore, StepError, StepEvent, StepKind, WorkflowCtx } from './interfaces';
+/** A saga undo registered by a completed step, kept with its step name for visibility on failure. */
+export interface Compensation {
+    name: string;
+    fn: () => Promise<void>;
+}
+/** A finished local step the host should checkpoint and announce (completed or failed). */
+export interface StepRecord {
+    runId: string;
+    seq: number;
+    name: string;
+    kind: StepKind;
+    input?: unknown;
+    events?: StepEvent[];
+    attempts: number;
+    enqueuedAt: Date;
+    startedAt: Date;
+    workerGroup?: string;
+}
+/**
+ * The narrow surface {@link createWorkflowCtx} needs from the engine — the seam between the
+ * authoring API (this module) and the orchestrator (the engine owns lifecycle: emitting events,
+ * suspending/resuming runs, dispatching remote steps).
+ */
+export interface CtxHost {
+    readonly store: StateStore;
+    clock(): number;
+    webhookUrl?: (token: string) => string;
+    completeStep(step: StepRecord & {
+        output: unknown;
+    }): Promise<void>;
+    failStep(step: StepRecord & {
+        error: StepError;
+    }): Promise<void>;
+    callRemote<TInput, TOutput>(runId: string, seq: number, step: RemoteStepDef<TInput, TOutput>, input: TInput, queue?: string, transport?: string): Promise<TOutput>;
+    /** Start a child run once, deferred so it can't reentrantly resume a still-running parent. */
+    startChild(workflow: string, input: unknown, id: string): void;
+}
+/**
+ * Build the {@link WorkflowCtx} handed to a workflow body. Every primitive is a closure over the
+ * position counter (the per-run logical position) and the saga `compensations` stack, so `task`/
+ * `child` compose `step`/`waitForSignal` directly. All durability goes through {@link CtxHost}, so
+ * the workflow body stays deterministic.
+ */
+export declare function createWorkflowCtx(host: CtxHost, runId: string, compensations: Compensation[]): WorkflowCtx;
+//# sourceMappingURL=workflow-ctx.d.ts.map

package/dist/workflow-ctx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-ctx.d.ts","sourceRoot":"","sources":["../src/workflow-ctx.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,aAAa,EACb,UAAU,EACV,SAAS,EACT,SAAS,EACT,QAAQ,EAGR,WAAW,EACZ,MAAM,cAAc,CAAC;AAItB,qGAAqG;AACrG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,IAAI,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,KAAK,IAAI,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG;QAAE,KAAK,EAAE,SAAS,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,UAAU,CAAC,MAAM,EAAE,OAAO,EACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,8FAA8F;IAC9F,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAChE;AAcD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,YAAY,EAAE,GAC5B,WAAW,CA2Pb"}

package/dist/workflow-ctx.js

@@ -0,0 +1,260 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkflowCtx = createWorkflowCtx;
+const backoff_1 = require("./backoff");
+const checkpoints_1 = require("./checkpoints");
+const completion_1 = require("./completion");
+const duration_1 = require("./duration");
+const errors_1 = require("./errors");
+const protocol_1 = require("./protocol");
+const step_logger_1 = require("./step-logger");
+/** The per-run logical position counter. `rewind()` gives a position back (see `ctx.patched`). */
+class Position {
+    seq = -1;
+    next() {
+        this.seq += 1;
+        return this.seq;
+    }
+    rewind() {
+        this.seq -= 1;
+    }
+}
+/**
+ * Build the {@link WorkflowCtx} handed to a workflow body. Every primitive is a closure over the
+ * position counter (the per-run logical position) and the saga `compensations` stack, so `task`/
+ * `child` compose `step`/`waitForSignal` directly. All durability goes through {@link CtxHost}, so
+ * the workflow body stays deterministic.
+ */
+function createWorkflowCtx(host, runId, compensations) {
+    const { store } = host;
+    const pos = new Position();
+    const step = async (name, fn, options) => {
+        const current = pos.next();
+        const existing = await store.getCheckpoint(runId, current);
+        if (existing && existing.name !== name) {
+            throw new errors_1.NonDeterminismError(runId, current, name, existing.name);
+        }
+        if (existing && existing.status === 'completed') {
+            // Register the compensation on replay too, so a saga undoes ALL completed steps — even
+            // those done in an earlier (since-suspended) pass — not just the ones run this pass.
+            if (options?.compensate)
+                compensations.push({ name, fn: options.compensate });
+            return existing.output;
+        }
+        const maxAttempts = Math.max(1, options?.retries ?? 1);
+        const startedAt = new Date();
+        for (let attempt = 1;; attempt += 1) {
+            // Events are scoped per attempt — a retry starts a clean log, so the checkpoint reflects
+            // only the attempt that actually completed (or the final failing one).
+            const events = [];
+            try {
+                const output = await fn((0, step_logger_1.createStepLogger)(events, host.clock));
+                await host.completeStep({
+                    runId,
+                    seq: current,
+                    name,
+                    kind: 'local',
+                    output,
+                    events,
+                    attempts: attempt,
+                    enqueuedAt: startedAt,
+                    startedAt,
+                });
+                if (options?.compensate)
+                    compensations.push({ name, fn: options.compensate });
+                return output;
+            }
+            catch (err) {
+                if (err instanceof errors_1.FatalError || attempt >= maxAttempts) {
+                    await host.failStep({
+                        runId,
+                        seq: current,
+                        name,
+                        kind: 'local',
+                        error: {
+                            message: err instanceof Error ? err.message : String(err),
+                            stack: err instanceof Error ? err.stack : undefined,
+                        },
+                        events,
+                        attempts: attempt,
+                        enqueuedAt: startedAt,
+                        startedAt,
+                    });
+                    throw err;
+                }
+                // Wait out the backoff before the next attempt (no-op when backoffMs is unset).
+                const wait = (0, backoff_1.backoffDelay)(attempt, options);
+                if (wait > 0)
+                    await new Promise((resolve) => setTimeout(resolve, wait));
+            }
+        }
+    };
+    const sleep = async (duration) => {
+        const current = pos.next();
+        const now = host.clock();
+        const existing = await store.getCheckpoint(runId, current);
+        if (existing) {
+            // Timer already recorded: resume if due, otherwise re-suspend cheaply.
+            if (now >= (existing.wakeAt ?? 0))
+                return;
+            throw new errors_1.WorkflowSuspended(existing.wakeAt ?? now);
+        }
+        const wakeAt = now + (0, duration_1.parseDuration)(duration);
+        await store.saveCheckpoint((0, checkpoints_1.instantCheckpoint)({ runId, seq: current, name: 'sleep', kind: 'sleep', wakeAt }));
+        throw new errors_1.WorkflowSuspended(wakeAt);
+    };
+    // NOTE (determinism): a bounded wait consumes TWO logical positions (deadline + wait), an
+    // unbounded one consumes ONE. So adding or removing `{ timeoutMs }` on an existing `waitForSignal`
+    // shifts the seq of every later step — treat it as a workflow-version change for in-flight runs.
+    const waitForSignal = async (token, opts) => {
+        if (opts?.timeoutMs == null) {
+            const current = pos.next();
+            const existing = await store.getCheckpoint(runId, current);
+            if (existing && existing.status === 'completed')
+                return existing.output;
+            await store.putSignalWaiter({ token, runId, seq: current });
+            throw new errors_1.WorkflowSuspended();
+        }
+        const timeoutMs = opts.timeoutMs;
+        const deadlineSeq = pos.next();
+        const waitSeq = pos.next();
+        // The deadline is recorded durably as a timer checkpoint so replay knows it; the run also gets a
+        // run-level wakeAt (via WorkflowSuspended) so the timer poller resumes it at the deadline.
+        const recorded = await store.getCheckpoint(runId, deadlineSeq);
+        const deadline = recorded?.wakeAt ?? host.clock() + timeoutMs;
+        if (!recorded) {
+            await store.saveCheckpoint((0, checkpoints_1.instantCheckpoint)({
+                runId,
+                seq: deadlineSeq,
+                name: `timeout:${token}`,
+                kind: 'sleep',
+                wakeAt: deadline,
+            }));
+        }
+        const waited = await store.getCheckpoint(runId, waitSeq);
+        if (waited && waited.status === 'completed')
+            return waited.output;
+        if (host.clock() >= deadline) {
+            await store.takeSignalWaiter(token).catch(() => undefined);
+            throw new errors_1.SignalTimeoutError(token, timeoutMs);
+        }
+        await store.putSignalWaiter({ token, runId, seq: waitSeq });
+        throw new errors_1.WorkflowSuspended(deadline);
+    };
+    // An external task = a checkpointed dispatch + a wait for its async-completion `Completion`
+    // (delivered by engine.completeTask/failTask). The whole "fire at a foreign system, suspend,
+    // resume when it reports back" pattern as one call.
+    const task = async (name, dispatch, options) => {
+        await step(`task:dispatch:${name}`, dispatch, options);
+        return (0, completion_1.unwrapCompletion)(await waitForSignal(`task:${runId}:${name}`), `task "${name}"`);
+    };
+    // Child workflow: start it once, then suspend on a `child:<id>` waiter the child signals on its
+    // terminal state (see engine.notifyParent).
+    const child = async (workflow, input, childId) => {
+        const current = pos.next();
+        const id = childId ?? `${runId}.child.${current}`;
+        const existing = await store.getCheckpoint(runId, current);
+        if (existing && existing.status === 'completed') {
+            return (0, completion_1.unwrapCompletion)(existing.output, `child "${id}"`);
+        }
+        await store.putSignalWaiter({ token: `child:${id}`, runId, seq: current });
+        if (!(await store.getRun(id)))
+            host.startChild(workflow, input, id);
+        throw new errors_1.WorkflowSuspended();
+    };
+    // A breakpoint = a visible `pending` checkpoint + a signal waiter the dashboard resumes via
+    // `engine.continue`. Reuses the signal machinery, so resume overwrites the pending checkpoint
+    // with a completed one and the run replays past it.
+    const breakpoint = async (label) => {
+        const current = pos.next();
+        const existing = await store.getCheckpoint(runId, current);
+        if (existing && existing.status === 'completed')
+            return;
+        if (!existing) {
+            await store.saveCheckpoint((0, checkpoints_1.instantCheckpoint)({
+                runId,
+                seq: current,
+                name: label ? `breakpoint:${label}` : 'breakpoint',
+                kind: 'signal',
+                status: 'pending',
+            }));
+            await store.putSignalWaiter({ token: (0, protocol_1.breakpointToken)(runId, current), runId, seq: current });
+        }
+        throw new errors_1.WorkflowSuspended();
+    };
+    // Guard an in-place change: a fresh run records a `patch:<id>` marker here and takes the new
+    // branch; a run recorded under the OLD code finds a real step at this position instead, so we
+    // rewind the logical position (the marker is transparent to it) and return false — its replay
+    // reads that old step next and follows the old branch. No position shift → no corruption.
+    const patched = async (id) => {
+        const marker = `patch:${id}`;
+        const current = pos.next();
+        const existing = await store.getCheckpoint(runId, current);
+        if (existing) {
+            if (existing.name === marker)
+                return true;
+            if (existing.name.startsWith('patch:')) {
+                throw new errors_1.NonDeterminismError(runId, current, marker, existing.name);
+            }
+            pos.rewind(); // not a marker: an old run's step lives here — give the position back to it
+            return false;
+        }
+        await store.saveCheckpoint((0, checkpoints_1.instantCheckpoint)({ runId, seq: current, name: marker, kind: 'local', output: true }));
+        return true;
+    };
+    // An update point: suspend on a run-scoped `update:<runId>:<name>` token that engine.update
+    // delivers to (after its validator passes). Reuses the signal machinery; run-scoped like task/child.
+    const onUpdate = (name, opts) => waitForSignal(`update:${runId}:${name}`, opts);
+    // A queryable named value: a checkpoint whose `name` is `event:<key>`, so the latest value for a
+    // key is just the highest-seq such checkpoint (read by engine.getEvent). Replay-idempotent.
+    const setEvent = async (key, value) => {
+        const current = pos.next();
+        const name = `event:${key}`;
+        const existing = await store.getCheckpoint(runId, current);
+        if (existing && existing.name !== name) {
+            throw new errors_1.NonDeterminismError(runId, current, name, existing.name);
+        }
+        if (existing && existing.status === 'completed')
+            return; // replay: already published
+        await store.saveCheckpoint((0, checkpoints_1.instantCheckpoint)({ runId, seq: current, name, kind: 'local', output: value }));
+    };
+    // A durable webhook reserves a logical position NOW to mint a stable token, so the url can be
+    // handed to a third party before `wait()` suspends. `wait()` then parks on that same position
+    // until the callback lands as engine.signal(token, body) — single position, replay-safe.
+    const webhook = () => {
+        const current = pos.next();
+        const token = `wh:${runId}:${current}`;
+        const wait = async () => {
+            const existing = await store.getCheckpoint(runId, current);
+            if (existing && existing.status === 'completed')
+                return existing.output;
+            await store.putSignalWaiter({ token, runId, seq: current });
+            throw new errors_1.WorkflowSuspended();
+        };
+        return { token, url: host.webhookUrl?.(token), wait };
+    };
+    // Deterministic non-deterministic sources: each is a checkpointed local step, so the value is
+    // captured on the first run and replayed verbatim (a raw Date.now()/Math.random() inside a
+    // workflow would differ across replays and corrupt the run).
+    const now = () => step('now', async () => host.clock());
+    const random = () => step('random', async () => Math.random());
+    const uuid = () => step('uuid', async () => globalThis.crypto.randomUUID());
+    return {
+        runId,
+        step,
+        sleep,
+        waitForSignal,
+        task,
+        child,
+        breakpoint,
+        webhook,
+        setEvent,
+        onUpdate,
+        patched,
+        now,
+        random,
+        uuid,
+        call: (remote, input, opts) => host.callRemote(runId, pos.next(), remote, input, opts?.queue, opts?.transport),
+    };
+}
+//# sourceMappingURL=workflow-ctx.js.map

package/dist/workflow-ctx.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-durable-core",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Durable workflows for NestJS — core interfaces, engine and deterministic replay",
   "license": "MIT",
   "author": "Davide Carvalho",
@@ -16,10 +16,17 @@
     "dist"
   ],
   "peerDependencies": {
+    "cron-parser": "^4.0.0 || ^5.0.0",
     "reflect-metadata": "^0.2.0",
     "zod": "^3.0.0 || ^4.0.0"
   },
+  "peerDependenciesMeta": {
+    "cron-parser": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "cron-parser": "4.9.0",
     "reflect-metadata": "0.2.2",
     "typescript": "5.9.3",
     "zod": "3.25.76"