@rotorsoft/act 1.33.18 → 1.33.20

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   sleep,
   store,
   validate
-} from "./chunk-3OTABSIB.js";
+} from "./chunk-5Z53Y7SG.js";
 import {
   ActorSchema,
   CausationEventSchema,
@@ -70,7 +70,7 @@ import {
   pii_fields,
   pii_schemas,
   sensitive
-} from "./chunk-SD7SW47Z.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
       });
@@ -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,
@@ -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
         });
@@ -2345,15 +2343,14 @@ async function run_drain_cycle(deps, cycle) {
       return handle({ ...lease, at }, payloads);
     })
   );
-  const blocked = await ops.block(
-    handled.filter(({ block: block2 }) => block2).map(({ lease, error }) => ({ ...lease, error }))
-  );
+  const to_block = handled.filter(({ block: block2 }) => block2).map(({ lease, error }) => ({ ...lease, error }));
+  const blocked = to_block.length ? await ops.block(to_block) : [];
   if (blocked.length) deps.on_blocked(blocked);
   const submitted = handled.flatMap((h, i) => {
     const advance = h.handled > 0 ? h.acked_at : leased[i].at;
     return h.defer !== void 0 ? { ...h.lease, at: advance, due: h.defer, retry: -1 } : h.next_attempt_at !== void 0 ? { ...h.lease, at: advance, due: h.next_attempt_at } : h.handled > 0 || !h.error ? { ...h.lease, at: h.acked_at } : [];
   });
-  const acked = await ops.ack(submitted);
+  const acked = submitted.length ? await ops.ack(submitted) : [];
   const expected = submitted.filter((l) => l.due === void 0).length;
   if (acked.length < expected)
     log().warn(
@@ -2856,9 +2853,8 @@ var SettleLoop = class {
    * `debounceMs` brings it forward), and a call during a running cycle
    * 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
+   * caller's. The cycle runs correlate→drain passes until one makes no
+   * progress (see {@link SettleOptions.maxPasses}), then emits the
    * `"settled"` lifecycle event via {@link SettleDeps.on_settled}.
    */
   schedule(options) {
@@ -3737,8 +3733,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
@@ -3908,8 +3904,8 @@ var Act = class {
    * `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; 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 —
+   * rule is in the event-sourcing docs (§ settle). Runs correlate→drain
+   * passes until one makes no progress (see {@link SettleOptions.maxPasses}),
    * then emits the `"settled"` lifecycle event, so one call fully catches
    * up paginated streams without forcing callers to loop.
    *