@dudousxd/nestjs-durable-core 0.75.1 → 0.76.0

package/dist/index.cjs

@@ -3861,6 +3861,12 @@ var WorkflowEngine = class {
   updateValidators = /* @__PURE__ */ new Map();
   /** Runs being cancelled WITH saga compensation — see `cancel({ compensate: true })`. */
   cancelRequested = /* @__PURE__ */ new Set();
+  /**
+  * Seqs of the dispatched remote steps a turn suspended on, by run, while that turn executes on
+  * THIS instance — so the turn can re-check them once its lease is released (see
+  * {@link redriveSettledSteps}).
+  */
+  awaitedRemoteSteps = /* @__PURE__ */ new Map();
   /** Flow-control admission backend for remote steps (see {@link registerQueue}). */
   admission;
   /** Runs on THIS instance blocked on admission, by queue — woken early on a freed-slot signal. */
@@ -4335,7 +4341,18 @@ var WorkflowEngine = class {
       createdAt: now,
       updatedAt: now
     };
-    await this.store.createRun(run);
+    try {
+      await this.store.createRun(run);
+    } catch (err) {
+      const winner = await this.store.getRun(runId).catch(() => null);
+      if (!winner) throw err;
+      return {
+        runId,
+        status: winner.status,
+        output: winner.output,
+        error: winner.error
+      };
+    }
     await this.runDispatcher.dispatch(runId);
     if (this.controlPlane) {
       void this.controlPlane.publishControl({
@@ -5264,6 +5281,24 @@ var WorkflowEngine = class {
   * itself. Only re-drives for a group with no waiter left whose checkpoints are all settled, which
   * the next turn is then guaranteed to see — so it cannot loop.
   */
+  /**
+  * Re-drive a run that just suspended on dispatched remote steps which, by now, have a result.
+  *
+  * Same race as {@link redriveSettledChildren}, for `ctx.step`: a result landing while the turn
+  * that dispatched it still holds the lease has its wake dropped by {@link execute}, and the turn
+  * then suspends with nothing left to wake it before the step's redispatch deadline. Called after
+  * the lease is released, so any later result wakes the run itself; it only re-drives for a
+  * checkpoint that is already settled, which the next turn replays past — so it cannot loop.
+  */
+  async redriveSettledSteps(runId, seqs) {
+    for (const seq of seqs) {
+      const cp = await this.store.getCheckpoint(runId, seq);
+      if (cp && (cp.status === "completed" || cp.status === "failed")) {
+        await this.resumeImplicit(runId);
+        return;
+      }
+    }
+  }
   async redriveSettledChildren(runId, fan) {
     if (!this.store.hasSignalWaiter) return;
     for (const wait of fan.waits) {
@@ -6718,6 +6753,9 @@ var WorkflowEngine = class {
     const replay = /* @__PURE__ */ new Map();
     for (const cp of snapshot) replay.set(cp.seq, cp);
     let suspendedOnFan;
+    let suspendedOnSteps = false;
+    const awaitedSteps = /* @__PURE__ */ new Set();
+    this.awaitedRemoteSteps.set(run.id, awaitedSteps);
     const ctx = createWorkflowCtx(this.ctxHostFor(replay, run.namespace), run.id, compensations, run.workflow, registered?.searchAttributesSchema);
     try {
       const output = await runInWorkflowCtx(ctx, () => fn(ctx, run.input));
@@ -6774,6 +6812,7 @@ var WorkflowEngine = class {
           wakeAt: err.wakeAt
         });
         suspendedOnFan = err.fan;
+        suspendedOnSteps = suspended.status === "suspended";
         return suspended;
       }
       if (this.cancelRequested.has(run.id)) {
@@ -6793,10 +6832,16 @@ var WorkflowEngine = class {
         error: error2
       });
     } finally {
+      if (this.awaitedRemoteSteps.get(run.id) === awaitedSteps) {
+        this.awaitedRemoteSteps.delete(run.id);
+      }
       await this.store.releaseRunLock(run.id);
       if (suspendedOnFan) {
         void this.redriveSettledChildren(run.id, suspendedOnFan).catch(() => void 0);
       }
+      if (suspendedOnSteps && awaitedSteps.size > 0) {
+        void this.redriveSettledSteps(run.id, awaitedSteps).catch(() => void 0);
+      }
     }
   }
   /**
@@ -7216,13 +7261,16 @@ var WorkflowEngine = class {
     if (this.pool.size === 0) throw new Error("remote steps require a Transport");
     if (step.timeoutMs) return this.callRemoteInMemory(runId, seq, step, input, transport, group);
     if (existing?.status === "pending") {
+      this.awaitedRemoteSteps.get(runId)?.add(seq);
       if (this.remoteRedispatchMs == null) throw new WorkflowSuspended();
       if (existing.wakeAt == null) {
         const wakeAt = this.clock() + this.remoteRedispatchMs;
-        await this.store.saveCheckpoint({
+        if (!await this.savePendingCheckpoint({
           ...existing,
           wakeAt
-        });
+        })) {
+          return this.callRemote(runId, seq, step, input, queue, transport, void 0, admission, routing);
+        }
         throw new WorkflowSuspended(wakeAt);
       }
       if (this.clock() < existing.wakeAt) throw new WorkflowSuspended(existing.wakeAt);
@@ -7235,7 +7283,7 @@ var WorkflowEngine = class {
       const reAttempt = existing.attempts + 1;
       const nextDeadline = this.clock() + this.remoteRedispatchMs;
       const reEnqueuedAt = /* @__PURE__ */ new Date();
-      await this.store.saveCheckpoint({
+      const claimed = await this.savePendingCheckpoint({
         ...existing,
         attempts: reAttempt,
         wakeAt: nextDeadline,
@@ -7249,6 +7297,9 @@ var WorkflowEngine = class {
           lostStepEvent(this.clock(), reAttempt, "redispatched")
         ]
       });
+      if (!claimed) {
+        return this.callRemote(runId, seq, step, input, queue, transport, void 0, admission, routing);
+      }
       await this.dispatchRemoteTask({
         runId,
         seq,
@@ -7336,8 +7387,15 @@ var WorkflowEngine = class {
       name: step.name,
       kind: "remote"
     });
+    this.awaitedRemoteSteps.get(runId)?.add(seq);
     throw new WorkflowSuspended();
   }
+  /** {@link StateStore.saveCheckpointIfPending}, or a plain save on a store without it. */
+  async savePendingCheckpoint(checkpoint) {
+    if (this.store.saveCheckpointIfPending) return this.store.saveCheckpointIfPending(checkpoint);
+    await this.store.saveCheckpoint(checkpoint);
+    return true;
+  }
   /** Enqueue a remote step task to its worker group via the transport pool. Shared by the initial
   *  dispatch, the opt-in self-heal re-dispatch (see `remoteRedispatchMs`), and the explicit
   *  {@link redispatchPending}. Carries the current trace/context so a re-dispatch is traceable. */
@@ -7368,7 +7426,7 @@ var WorkflowEngine = class {
     if (run && (run.status === "cancelled" || run.status === "completed")) return;
     const finishedAt = /* @__PURE__ */ new Date();
     const startedAt = result.startedAt ? new Date(result.startedAt) : cp.startedAt;
-    await this.store.saveCheckpoint({
+    const claimed = await this.savePendingCheckpoint({
       ...cp,
       status: result.status,
       output: result.status === "completed" ? result.output : cp.output,
@@ -7377,6 +7435,7 @@ var WorkflowEngine = class {
       startedAt,
       finishedAt
     });
+    if (!claimed) return;
     this.emit({
       type: result.status === "completed" ? "step.completed" : "step.failed",
       runId: result.runId,
@@ -7769,6 +7828,9 @@ var CodecStateStore = class {
   /** Forwarded verbatim (deletes touch no payload). Bound only when the inner store has it, so the
   *  engine's per-run fallback still kicks in through the wrapper. */
   deleteRuns;
+  /** Encodes like {@link saveCheckpoint}. Bound only when the inner store has it, so the engine's
+  *  plain-save fallback still kicks in through the wrapper. */
+  saveCheckpointIfPending;
   /** Forwarded verbatim — retention selects by status/updatedAt/scope, never by payload. Bound only
   *  when the inner store prunes, so the retention poller still sees (and warns about) its absence. */
   pruneTerminalRuns;
@@ -7796,6 +7858,8 @@ var CodecStateStore = class {
     if (inner.tryAdmitSingleton) this.tryAdmitSingleton = inner.tryAdmitSingleton.bind(inner);
     const deleteRuns = inner.deleteRuns;
     if (deleteRuns) this.deleteRuns = (ids) => deleteRuns.call(inner, ids);
+    const saveIfPending = inner.saveCheckpointIfPending;
+    if (saveIfPending) this.saveCheckpointIfPending = (cp) => saveIfPending.call(inner, this.encCp(cp));
     const prune = inner.pruneTerminalRuns;
     if (prune) this.pruneTerminalRuns = (policy, now, limit) => prune.call(inner, policy, now, limit);
     const count = inner.countRuns;
@@ -8359,6 +8423,14 @@ var InMemoryStateStore = class {
       ...checkpoint
     });
   }
+  async saveCheckpointIfPending(checkpoint) {
+    const key = this.key(checkpoint.runId, checkpoint.seq);
+    if (this.checkpoints.get(key)?.status !== "pending") return false;
+    this.checkpoints.set(key, {
+      ...checkpoint
+    });
+    return true;
+  }
   async listIncompleteRuns(namespace) {
     return [
       ...this.runs.values()