@dudousxd/nestjs-durable-core 0.85.1 → 0.85.2

package/dist/index.d.cts

@@ -7102,7 +7102,11 @@ declare function scheduleRunIdAt(s: ScheduledWorkflow, nowMs: number): string;
  * 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 this call
+ * `setInterval`, the durable timer poller, or `@nestjs/schedule`.
+ *
+ * Pass the SAME `engine` object on every call: which windows already fired, and the jittered fire
+ * time of each deferred window, are remembered per engine object. A fresh wrapper per call would
+ * redraw a deferred window's fire time on every tick, so it might never fire. Returns the run ids this call
  * started: a window that already has a run is not started or returned again, and once this process
  * has seen a window's run exist, later calls in that window skip it without a store read. A
  * jittered window is deferred to a later call, never slept on.

package/dist/index.d.ts

@@ -7102,7 +7102,11 @@ declare function scheduleRunIdAt(s: ScheduledWorkflow, nowMs: number): string;
  * 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 this call
+ * `setInterval`, the durable timer poller, or `@nestjs/schedule`.
+ *
+ * Pass the SAME `engine` object on every call: which windows already fired, and the jittered fire
+ * time of each deferred window, are remembered per engine object. A fresh wrapper per call would
+ * redraw a deferred window's fire time on every tick, so it might never fire. Returns the run ids this call
  * started: a window that already has a run is not started or returned again, and once this process
  * has seen a window's run exist, later calls in that window skip it without a store read. A
  * jittered window is deferred to a later call, never slept on.

package/dist/index.js

@@ -2532,6 +2532,7 @@ async function runSchedules(engine, schedules, nowMs, opts) {
         if (prev && (prev.status === "running" || prev.status === "suspended")) continue;
       }
     }
+    if (!(s.jitter && s.jitter > 0)) jitterFireAt.get(engine)?.delete(s.key);
     const firing = s.jitter && s.jitter > 0 ? jitterDue(engine, s, candidates, nowMs, random) : candidates;
     if (firing.length === 0) continue;
     for (const runId of firing) {