@rotorsoft/act 1.33.17 → 1.33.19

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   sleep,
   store,
   validate
-} from "./chunk-5KTVG7IM.js";
+} from "./chunk-5Z53Y7SG.js";
 import {
   ActorSchema,
   CausationEventSchema,
@@ -70,7 +70,7 @@ import {
   pii_fields,
   pii_schemas,
   sensitive
-} from "./chunk-CAL4XEVN.js";
+} from "./chunk-HEHGZHHA.js";
 
 // src/signals.ts
 process.once("SIGINT", async (arg) => {
@@ -1177,7 +1177,7 @@ var CorrelateCycle = class {
   _restoring = false;
   _init_promise;
   // Bounded by `maxSubscribedStreams`; static records live apart so eviction
-  // never drops their +Infinity floor.
+  // never lets a resolution re-lane them.
   _dynamic_subscriptions;
   _static_subscriptions = /* @__PURE__ */ new Map();
   _patterns = new LruMap(PATTERN_CACHE_SIZE);
@@ -1226,7 +1226,6 @@ var CorrelateCycle = class {
     this._checkpoint = correlated_at >= 0 ? correlated_at : Math.max(-1, watermark - COLD_START_BACK_SCAN);
     for (const { stream, priority = 0, lane } of this._static_targets) {
       this._static_subscriptions.set(stream, {
-        floor: Number.POSITIVE_INFINITY,
         priority,
         lane
       });
@@ -1296,7 +1295,7 @@ var CorrelateCycle = class {
       this._lease_until = correlating ? now + CORRELATION_LEASE_MS : 0;
       if (correlating === false) return idle();
     }
-    const after = Math.max(this._checkpoint, query.after || -1);
+    const after = this._checkpoint;
     const correlated = /* @__PURE__ */ new Map();
     let last_id = after;
     let stopped = false;
@@ -1330,9 +1329,10 @@ var CorrelateCycle = class {
               );
               lane = void 0;
             }
-            const recorded = this._static_subscriptions.get(resolved.target) ?? this._dynamic_subscriptions.get(resolved.target);
+            const fixed = this._static_subscriptions.get(resolved.target);
+            const recorded = fixed ?? this._dynamic_subscriptions.get(resolved.target);
             const priority = resolved.priority ?? 0;
-            const upgraded = !recorded || priority > recorded.floor;
+            const upgraded = !recorded || !fixed && priority > recorded.priority;
             const carried = upgraded ? { priority, lane } : { priority: recorded.priority, lane: recorded.lane };
             const entry = correlated.get(resolved.target) || {
               source: resolved.source,
@@ -1370,7 +1370,7 @@ var CorrelateCycle = class {
       },
       // Resolvers see `pii: null`: correlate runs actor-less, and one
       // undecryptable row would otherwise stop every stream's reactions.
-      { ...query, after, with_pii: false }
+      { after, limit: query.limit, with_pii: false }
     );
     if (this._declared_lanes.size > 1) await this._recall(correlated);
     const read = last_id > after;
@@ -1402,7 +1402,6 @@ var CorrelateCycle = class {
       for (const { stream, priority, lane } of streams) {
         if (correlated.get(stream)?.upgraded)
           this._dynamic_subscriptions.set(stream, {
-            floor: priority,
             priority,
             lane
           });
@@ -1431,7 +1430,6 @@ var CorrelateCycle = class {
         );
         if (!row) return;
         this._dynamic_subscriptions.set(stream, {
-          floor: row.priority,
           priority: row.priority,
           lane: row.lane
         });
@@ -2857,8 +2855,8 @@ var SettleLoop = class {
    * queues one more pass after it. Callers pass options, which the next
    * pass uses; internal wake-ups pass none, so they never discard a
    * caller's. The cycle runs correlate→drain in a
-   * loop until no progress is made (no new subscriptions, no events read,
-   * no streams leased) or `maxPasses` is reached, then emits the
+   * loop until a pass makes no progress (it read no events and leased no
+   * streams) or `maxPasses` is reached, then emits the
    * `"settled"` lifecycle event via {@link SettleDeps.on_settled}.
    */
   schedule(options) {
@@ -2879,8 +2877,7 @@ var SettleLoop = class {
       this._timer = void 0;
       const {
         debounceMs: _,
-        // Every pass scans from correlation's own checkpoint.
-        correlate: { after: _after, ...correlate_query } = {},
+        correlate: correlate_query = {},
         maxPasses = Infinity,
         ...drain_options
       } = this._next ?? {};
@@ -2893,7 +2890,7 @@ var SettleLoop = class {
           if (scanned) this._deps.breaker.passed();
           const drain = await this._deps.drain(drain_options);
           passes.push(drain);
-          const made_progress = drain.leased.length > 0 || scanned && (pass.subscribed > 0 || pass.read);
+          const made_progress = drain.leased.length > 0 || scanned && pass.read;
           if (!made_progress) break;
         }
         if (passes.length) this._deps.on_settled(merge_drains(passes));
@@ -3552,8 +3549,9 @@ var Act = class {
    * target streams their reactions resolve to (static or computed from
    * the event), and marks their work so the next drain can claim it.
    *
-   * @param query - Scan filter — see {@link Query} for fields (typically
-   *   `{ limit: <count> }`; the scan starts at the checkpoint)
+   * @param query - Only `limit` is used: the most events the pass reads
+   *   (default 10). The scan always starts at the correlation checkpoint,
+   *   which every reaction shares, so filters and `after` are ignored.
    * @returns The number of newly subscribed streams and the last scanned event id
    *
    * @example Manual correlation
@@ -3563,7 +3561,7 @@ var Act = class {
    *
    * @see {@link start_correlations} for automatic periodic correlation
    */
-  async correlate(query = { after: -1, limit: 10 }) {
+  async correlate(query = { limit: 10 }) {
     const pass = await this._correlate_pass(query);
     return {
       subscribed: pass.kind === "scanned" ? pass.subscribed : 0,
@@ -3575,8 +3573,7 @@ var Act = class {
     if (!this._drain) return { kind: "idle", last_id: -1 };
     return this._scoped(async () => {
       const pass = await this._correlate.correlate(query, lease);
-      if (pass.kind === "scanned" && (pass.subscribed > 0 || pass.marked > 0))
-        this._arm_all();
+      if (pass.kind === "scanned" && pass.marked > 0) this._arm_all();
       return pass;
     });
   }
@@ -3738,8 +3735,8 @@ var Act = class {
    *   `__snapshot__` events (counted in the result); `on_progress`
    *   fires once per event.
    * @param sink - Where the events land. Defaults to this Act's store.
-   * @returns {@link ScanResult} with `kept`, `duration_ms`, and
-   *   `dropped` per-category counters.
+   * @returns The {@link ScanResult}: what was kept, migrated and dropped,
+   *   and how long it took.
    *
    * @example Restore a CSV backup into the connected store
    * ```typescript
@@ -3910,7 +3907,7 @@ var Act = class {
    * sets `autoSettle: false`. Call it at startup, to run what was pending
    * 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 —
+   * progress — it read no events and leased no streams —
    * then emits the `"settled"` lifecycle event, so one call fully catches
    * up paginated streams without forcing callers to loop.
    *