@rotorsoft/act 1.33.10 → 1.33.12

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   sleep,
   store,
   validate
-} from "./chunk-OCJXGHN6.js";
+} from "./chunk-YZ2NKMVS.js";
 import {
   ActorSchema,
   CausationEventSchema,
@@ -70,7 +70,7 @@ import {
   pii_fields,
   pii_schemas,
   sensitive
-} from "./chunk-KHFMCJDR.js";
+} from "./chunk-URF33KO3.js";
 
 // src/signals.ts
 process.once("SIGINT", async (arg) => {
@@ -1168,8 +1168,11 @@ var CorrelateCycle = class {
    */
   _raised = 1;
   _lowered = 0;
-  /** Counts releases, so a lease reply that lands after one is dropped. */
-  _releases = 0;
+  /**
+   * Bumped by a release (shutdown) and a restart (restore), so a scan or
+   * lease reply that was out across one writes nothing.
+   */
+  _epoch = 0;
   _init_promise;
   // Bounded by `maxSubscribedStreams`; static records live apart so eviction
   // never drops their +Infinity floor.
@@ -1240,6 +1243,7 @@ var CorrelateCycle = class {
     this._dynamic_subscriptions.clear();
     this._static_subscriptions.clear();
     this._raised++;
+    this._epoch++;
   }
   /** Forget dynamic targets whose rows a full close deleted, so they re-subscribe. */
   forget_subscribed(streams) {
@@ -1259,32 +1263,25 @@ var CorrelateCycle = class {
   /** Scan past the checkpoint, subscribe new targets and raise their work marks. */
   async correlate(query = { after: -1, limit: 10 }, lease = false) {
     await this.init();
-    if (this._raised === this._lowered)
-      return {
-        subscribed: 0,
-        last_id: this._checkpoint,
-        marked: 0,
-        scanned: false
-      };
+    const epoch = this._epoch;
+    const idle = () => ({
+      subscribed: 0,
+      last_id: this._checkpoint,
+      marked: 0,
+      scanned: false
+    });
+    if (this._raised === this._lowered) return idle();
     const raised = this._raised;
     const now = Date.now();
     if (lease && now >= this._lease_until - CORRELATION_LEASE_MS / 2) {
-      const releases = this._releases;
       const { correlating } = await this._cd.subscribe([], void 0, {
         key: this._key,
         by: this._by,
         millis: CORRELATION_LEASE_MS
       });
-      const released = this._releases !== releases;
-      if (!released)
-        this._lease_until = correlating ? now + CORRELATION_LEASE_MS : 0;
-      if (correlating === false || released)
-        return {
-          subscribed: 0,
-          last_id: this._checkpoint,
-          marked: 0,
-          scanned: false
-        };
+      if (this._epoch !== epoch) return idle();
+      this._lease_until = correlating ? now + CORRELATION_LEASE_MS : 0;
+      if (correlating === false) return idle();
     }
     const after = Math.max(this._checkpoint, query.after || -1);
     const correlated = /* @__PURE__ */ new Map();
@@ -1363,6 +1360,7 @@ var CorrelateCycle = class {
       { ...query, after, with_pii: false }
     );
     if (this._declared_lanes.size > 1) await this._recall(correlated);
+    if (this._epoch !== epoch) return idle();
     const streams = [];
     for (const [stream, entry] of correlated) {
       if (entry.upgraded || entry.correlated_at !== void 0)
@@ -1375,14 +1373,13 @@ var CorrelateCycle = class {
         });
     }
     if (streams.length) {
-      const held = lease && this._lease_until > 0;
       const renewed_at = Date.now();
       const { subscribed, correlating } = await this._cd.subscribe(
         streams,
         last_id,
-        held ? { key: this._key, by: this._by, millis: CORRELATION_LEASE_MS } : void 0
+        lease ? { key: this._key, by: this._by, millis: CORRELATION_LEASE_MS } : void 0
       );
-      if (held && correlating !== false)
+      if (lease && correlating !== false)
         this._lease_until = renewed_at + CORRELATION_LEASE_MS;
       const marked = streams.filter(
         (entry) => entry.correlated_at !== void 0
@@ -1445,7 +1442,7 @@ var CorrelateCycle = class {
   async release_correlation() {
     try {
       this._lease_until = 0;
-      this._releases++;
+      this._epoch++;
       await this._cd.subscribe([], void 0, {
         key: this._key,
         by: this._by,
@@ -3202,9 +3199,10 @@ var Act = class {
   }
   _shutdown_promise;
   /**
-   * Per-instance teardown: stops scheduling, gives the cycles in flight up
-   * to `graceMs` to reach their `ack` (an abandoned handler holds its lease
-   * until it expires), then removes listeners and the notify subscription.
+   * Per-instance teardown: stops scheduling, removes the notify
+   * subscription, gives the cycles in flight up to `graceMs` to reach their
+   * `ack` (an abandoned handler holds its lease until it expires), then
+   * hands back the correlation lease and removes listeners.
    * The budget is a ceiling, not a delay.
    *
    * Idempotent: repeated calls return the same promise, with the first
@@ -3888,10 +3886,8 @@ var Act = class {
    * A local change that frees reaction work (a commit, `reset()`,
    * `unblock()`, `restore()`) schedules this on its own unless the app
    * sets `autoSettle: false`. Call it at startup, to run what was pending
-   * before a restart, or with options for the next pass. A pass already
-   * scheduled is never put off: calls before it runs join it (a shorter
-   * `debounceMs` brings it forward), and a call during a running cycle
-   * queues one more pass after it. Runs correlate→drain in a loop until a pass makes no
+   * before a restart, or with options for the next pass; the scheduling
+   * rule is in the event-sourcing docs (§ settle). Runs correlate→drain in a loop until a pass makes no
    * progress — no new subscriptions, no events read, no streams leased —
    * then emits the `"settled"` lifecycle event, so one call fully catches
    * up paginated streams without forcing callers to loop.