@rotorsoft/act 1.33.19 → 1.34.0

package/dist/index.cjs

@@ -40,7 +40,7 @@
 
 
 
-var _chunkGEUBNZ3Bcjs = require('./chunk-GEUBNZ3B.cjs');
+var _chunkBTLM7SW4cjs = require('./chunk-BTLM7SW4.cjs');
 
 
 
@@ -70,24 +70,24 @@ var _chunkGEUBNZ3Bcjs = require('./chunk-GEUBNZ3B.cjs');
 
 
 
-var _chunkDVYTKZD5cjs = require('./chunk-DVYTKZD5.cjs');
+var _chunkRF5MV72Kcjs = require('./chunk-RF5MV72K.cjs');
 
 // src/signals.ts
 process.once("SIGINT", async (arg) => {
-  _chunkGEUBNZ3Bcjs.log.call(void 0, ).info(arg, "SIGINT");
-  await _chunkGEUBNZ3Bcjs.disposeAndExit.call(void 0, "EXIT");
+  _chunkBTLM7SW4cjs.log.call(void 0, ).info(arg, "SIGINT");
+  await _chunkBTLM7SW4cjs.disposeAndExit.call(void 0, "EXIT");
 });
 process.once("SIGTERM", async (arg) => {
-  _chunkGEUBNZ3Bcjs.log.call(void 0, ).info(arg, "SIGTERM");
-  await _chunkGEUBNZ3Bcjs.disposeAndExit.call(void 0, "EXIT");
+  _chunkBTLM7SW4cjs.log.call(void 0, ).info(arg, "SIGTERM");
+  await _chunkBTLM7SW4cjs.disposeAndExit.call(void 0, "EXIT");
 });
 process.once("uncaughtException", async (arg) => {
-  _chunkGEUBNZ3Bcjs.log.call(void 0, ).error(arg, "Uncaught Exception");
-  await _chunkGEUBNZ3Bcjs.disposeAndExit.call(void 0, "ERROR");
+  _chunkBTLM7SW4cjs.log.call(void 0, ).error(arg, "Uncaught Exception");
+  await _chunkBTLM7SW4cjs.disposeAndExit.call(void 0, "ERROR");
 });
 process.once("unhandledRejection", async (arg) => {
-  _chunkGEUBNZ3Bcjs.log.call(void 0, ).error(arg, "Unhandled Rejection");
-  await _chunkGEUBNZ3Bcjs.disposeAndExit.call(void 0, "ERROR");
+  _chunkBTLM7SW4cjs.log.call(void 0, ).error(arg, "Unhandled Rejection");
+  await _chunkBTLM7SW4cjs.disposeAndExit.call(void 0, "ERROR");
 });
 
 // src/act.ts
@@ -195,7 +195,7 @@ async function* audit(deps, categories, options = {}) {
   if (need_stats) {
     const stats = await deps.store().query_stats(
       {},
-      { count: true, names: true, exclude: [_chunkDVYTKZD5cjs.SNAP_EVENT] }
+      { count: true, names: true, exclude: [_chunkRF5MV72Kcjs.SNAP_EVENT] }
     );
     for (const [stream, s] of stats) {
       for (const p of passes) _optionalChain([p, 'access', _4 => _4.on_stat, 'optionalCall', _5 => _5(stream, s)]);
@@ -277,7 +277,7 @@ var make_schema_pass = (deps) => {
         return;
       }
       const schema = state2.events[name];
-      const sensitive2 = _chunkDVYTKZD5cjs.pii_fields.call(void 0, schema);
+      const sensitive2 = _chunkRF5MV72Kcjs.pii_fields.call(void 0, schema);
       let parse_schema = schema;
       if (sensitive2.length > 0) {
         const omitter = schema.omit;
@@ -411,7 +411,7 @@ var make_restart_candidate_pass = (deps, options) => {
           {
             stream,
             stream_exact: true,
-            names: [_chunkDVYTKZD5cjs.SNAP_EVENT],
+            names: [_chunkRF5MV72Kcjs.SNAP_EVENT],
             with_snaps: true
           }
         );
@@ -840,7 +840,7 @@ async function run_close_cycle(targets, deps) {
     deps,
     () => run_full_closes(full, target_map, deps, skipped)
   );
-  const retired = [...truncated.entries()].filter(([, r]) => r.committed.name === _chunkDVYTKZD5cjs.TOMBSTONE_EVENT).map(([stream]) => stream);
+  const retired = [...truncated.entries()].filter(([, r]) => r.committed.name === _chunkRF5MV72Kcjs.TOMBSTONE_EVENT).map(([stream]) => stream);
   if (retired.length) _optionalChain([deps, 'access', _42 => _42.forget_subscribed, 'optionalCall', _43 => _43(retired)]);
   for (const [stream, entry] of windowed_result) truncated.set(stream, entry);
   return { truncated, skipped };
@@ -922,7 +922,7 @@ async function run_windowed_closes(windowed, deps, skipped) {
       if (!await windowed_prune_pending(t.stream, t.before, max_id))
         return void 0;
       if (t.archive) await t.archive();
-      const result = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).truncate([
+      const result = await _chunkBTLM7SW4cjs.store.call(void 0, ).truncate([
         { stream: t.stream, before: t.before, max_id }
       ]);
       return result.get(t.stream);
@@ -935,10 +935,10 @@ async function run_windowed_closes(windowed, deps, skipped) {
 async function windowed_prune_pending(stream, before, max_id) {
   let boundary_id;
   let min_id;
-  await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query(
+  await _chunkBTLM7SW4cjs.store.call(void 0, ).query(
     (event) => {
       if (min_id === void 0 || event.id < min_id) min_id = event.id;
-      if (event.name === _chunkDVYTKZD5cjs.SNAP_EVENT && event.created < before && (max_id === void 0 || event.id <= max_id) && (boundary_id === void 0 || event.id > boundary_id))
+      if (event.name === _chunkRF5MV72Kcjs.SNAP_EVENT && event.created < before && (max_id === void 0 || event.id <= max_id) && (boundary_id === void 0 || event.id > boundary_id))
         boundary_id = event.id;
     },
     { stream, stream_exact: true, with_snaps: true, after: -1 }
@@ -949,7 +949,7 @@ async function probe_min_watermarks(streams, page_size, checkpoint) {
   const min_at = /* @__PURE__ */ new Map();
   const matches = source_matcher();
   await walk_streams(
-    _chunkGEUBNZ3Bcjs.store.call(void 0, ),
+    _chunkBTLM7SW4cjs.store.call(void 0, ),
     (position) => {
       const pending = position.correlated_at === void 0 || position.at < position.correlated_at;
       const cap = pending ? position.at : Math.max(position.at, checkpoint);
@@ -977,17 +977,17 @@ function source_matcher() {
   };
 }
 async function scan_stream_heads(streams) {
-  const stats = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query_stats(streams, {
-    exclude: [_chunkDVYTKZD5cjs.SNAP_EVENT]
+  const stats = await _chunkBTLM7SW4cjs.store.call(void 0, ).query_stats(streams, {
+    exclude: [_chunkRF5MV72Kcjs.SNAP_EVENT]
   });
-  const domain_heads = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query_stats(streams, {
-    exclude: [_chunkDVYTKZD5cjs.SNAP_EVENT, _chunkDVYTKZD5cjs.TOMBSTONE_EVENT]
+  const domain_heads = await _chunkBTLM7SW4cjs.store.call(void 0, ).query_stats(streams, {
+    exclude: [_chunkRF5MV72Kcjs.SNAP_EVENT, _chunkRF5MV72Kcjs.TOMBSTONE_EVENT]
   });
-  const true_heads = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query_stats(streams, {});
+  const true_heads = await _chunkBTLM7SW4cjs.store.call(void 0, ).query_stats(streams, {});
   const out = /* @__PURE__ */ new Map();
   for (const [stream, { head }] of domain_heads) {
     const marker_head = _optionalChain([stats, 'access', _45 => _45.get, 'call', _46 => _46(stream), 'optionalAccess', _47 => _47.head]);
-    const interrupted = _optionalChain([marker_head, 'optionalAccess', _48 => _48.name]) === _chunkDVYTKZD5cjs.TOMBSTONE_EVENT;
+    const interrupted = _optionalChain([marker_head, 'optionalAccess', _48 => _48.name]) === _chunkRF5MV72Kcjs.TOMBSTONE_EVENT;
     out.set(stream, {
       max_id: head.id,
       version: true_heads.get(stream).head.version,
@@ -1011,7 +1011,7 @@ async function partition_by_safety(stream_info, reactive, skipped, page_size, ca
   const matches = source_matcher();
   const targets = [...stream_info.keys()];
   await walk_streams(
-    _chunkGEUBNZ3Bcjs.store.call(void 0, ),
+    _chunkBTLM7SW4cjs.store.call(void 0, ),
     (position) => {
       const has_work = position.correlated_at !== void 0 && position.at < position.correlated_at;
       if (!has_work) return;
@@ -1077,7 +1077,7 @@ async function run_archive_callbacks(guarded, target_map) {
   }
 }
 async function heads_still_guarded(guarded, guard_events, skipped) {
-  const heads = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query_stats(guarded, {});
+  const heads = await _chunkBTLM7SW4cjs.store.call(void 0, ).query_stats(guarded, {});
   return guarded.filter((stream) => {
     if (_optionalChain([heads, 'access', _55 => _55.get, 'call', _56 => _56(stream), 'optionalAccess', _57 => _57.head, 'access', _58 => _58.id]) === guard_events.get(stream).id)
       return true;
@@ -1095,18 +1095,18 @@ async function truncate_and_warm_cache(guarded, seed_states, guard_events, corre
       meta: {
         correlation,
         causation: {
-          event: { id: guard.id, name: _chunkDVYTKZD5cjs.TOMBSTONE_EVENT, stream: guard.stream }
+          event: { id: guard.id, name: _chunkRF5MV72Kcjs.TOMBSTONE_EVENT, stream: guard.stream }
         }
       }
     };
   });
-  const truncated = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).truncate(trunc_targets);
+  const truncated = await _chunkBTLM7SW4cjs.store.call(void 0, ).truncate(trunc_targets);
   await Promise.all(
     guarded.map(async (stream) => {
       const entry = truncated.get(stream);
       const state2 = seed_states.get(stream);
       if (state2 && entry) {
-        await _chunkGEUBNZ3Bcjs.cache.call(void 0, ).set(stream, {
+        await _chunkBTLM7SW4cjs.cache.call(void 0, ).set(stream, {
           stream,
           state: state2,
           version: entry.committed.version,
@@ -1115,7 +1115,7 @@ async function truncate_and_warm_cache(guarded, seed_states, guard_events, corre
           snaps: 1
         });
       } else {
-        await _chunkGEUBNZ3Bcjs.cache.call(void 0, ).invalidate(stream);
+        await _chunkBTLM7SW4cjs.cache.call(void 0, ).invalidate(stream);
       }
     })
   );
@@ -1129,7 +1129,7 @@ var _crypto = require('crypto');
 function report_once(seen, key, message) {
   if (seen.has(key)) return;
   seen.add(key);
-  _chunkGEUBNZ3Bcjs.log.call(void 0, ).error(new Error(message));
+  _chunkBTLM7SW4cjs.log.call(void 0, ).error(new Error(message));
 }
 
 // src/internal/correlate-cycle.ts
@@ -1180,7 +1180,7 @@ var CorrelateCycle = (_class3 = class {
   // never lets a resolution re-lane them.
   
   __init11() {this._static_subscriptions = /* @__PURE__ */ new Map()}
-  __init12() {this._patterns = new (0, _chunkGEUBNZ3Bcjs.LruMap)(PATTERN_CACHE_SIZE)}
+  __init12() {this._patterns = new (0, _chunkBTLM7SW4cjs.LruMap)(PATTERN_CACHE_SIZE)}
   
   
   
@@ -1198,7 +1198,7 @@ var CorrelateCycle = (_class3 = class {
     on_init
   }) {;_class3.prototype.__init3.call(this);_class3.prototype.__init4.call(this);_class3.prototype.__init5.call(this);_class3.prototype.__init6.call(this);_class3.prototype.__init7.call(this);_class3.prototype.__init8.call(this);_class3.prototype.__init9.call(this);_class3.prototype.__init10.call(this);_class3.prototype.__init11.call(this);_class3.prototype.__init12.call(this);_class3.prototype.__init13.call(this);
     this._key = shard ? `${registry_key(registry.events)}:${[...shard].sort().join(",")}` : registry_key(registry.events);
-    this._dynamic_subscriptions = new (0, _chunkGEUBNZ3Bcjs.LruMap)(max_subscribed_streams);
+    this._dynamic_subscriptions = new (0, _chunkBTLM7SW4cjs.LruMap)(max_subscribed_streams);
     this._registry = registry;
     this._declared_lanes = declared_lanes;
     this._static_targets = static_targets;
@@ -1256,7 +1256,7 @@ var CorrelateCycle = (_class3 = class {
   /** Would the target's own `fetch` (filtered by `source`) return this event? */
   _in_fetch_window(source, stream) {
     if (source === void 0 || source === stream) return true;
-    if (_chunkGEUBNZ3Bcjs.is_literal_source.call(void 0, source)) return false;
+    if (_chunkBTLM7SW4cjs.is_literal_source.call(void 0, source)) return false;
     let pattern = this._patterns.get(source);
     if (!pattern) {
       pattern = new RegExp(source);
@@ -1299,7 +1299,7 @@ var CorrelateCycle = (_class3 = class {
     const correlated = /* @__PURE__ */ new Map();
     let last_id = after;
     let stopped = false;
-    const found = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query(
+    const found = await _chunkBTLM7SW4cjs.store.call(void 0, ).query(
       (event) => {
         if (stopped) return;
         const register = this._registry.events[event.name];
@@ -1344,9 +1344,9 @@ var CorrelateCycle = (_class3 = class {
               correlated_at: void 0
             };
             const seen_in_scan = correlated.has(resolved.target);
-            const held_lane = _nullishCoalesce((seen_in_scan ? entry.lane : _optionalChain([recorded, 'optionalAccess', _61 => _61.lane])), () => ( _chunkDVYTKZD5cjs.DEFAULT_LANE));
+            const held_lane = _nullishCoalesce((seen_in_scan ? entry.lane : _optionalChain([recorded, 'optionalAccess', _61 => _61.lane])), () => ( _chunkRF5MV72Kcjs.DEFAULT_LANE));
             const held_priority = seen_in_scan ? entry.priority : _optionalChain([recorded, 'optionalAccess', _62 => _62.priority]);
-            const resolved_lane = _nullishCoalesce(lane, () => ( _chunkDVYTKZD5cjs.DEFAULT_LANE));
+            const resolved_lane = _nullishCoalesce(lane, () => ( _chunkRF5MV72Kcjs.DEFAULT_LANE));
             if (held_priority === priority && held_lane !== resolved_lane)
               report_lane_conflict(
                 this._reported,
@@ -1422,7 +1422,7 @@ var CorrelateCycle = (_class3 = class {
     await Promise.all(
       missed.map(async ([stream, entry]) => {
         let row;
-        await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query_streams(
+        await _chunkBTLM7SW4cjs.store.call(void 0, ).query_streams(
           (position) => {
             row = position;
           },
@@ -1434,8 +1434,8 @@ var CorrelateCycle = (_class3 = class {
           lane: row.lane
         });
         if (entry.priority > row.priority) return;
-        const held_lane = _nullishCoalesce(row.lane, () => ( _chunkDVYTKZD5cjs.DEFAULT_LANE));
-        const resolved_lane = _nullishCoalesce(entry.lane, () => ( _chunkDVYTKZD5cjs.DEFAULT_LANE));
+        const held_lane = _nullishCoalesce(row.lane, () => ( _chunkRF5MV72Kcjs.DEFAULT_LANE));
+        const resolved_lane = _nullishCoalesce(entry.lane, () => ( _chunkRF5MV72Kcjs.DEFAULT_LANE));
         if (entry.priority === row.priority && held_lane !== resolved_lane)
           report_lane_conflict(
             this._reported,
@@ -1461,7 +1461,7 @@ var CorrelateCycle = (_class3 = class {
         millis: 0
       });
     } catch (error) {
-      _chunkGEUBNZ3Bcjs.log.call(void 0, ).warn(
+      _chunkBTLM7SW4cjs.log.call(void 0, ).warn(
         `Could not hand back the correlation lease during shutdown; it expires on its own within ${CORRELATION_LEASE_MS}ms and correlation resumes normally after that. On a single-writer store this usually means another connection holds the database. Cause: ${String(error)}`
       );
     }
@@ -1614,14 +1614,14 @@ function compute_lag_lead_ratio(handled, lagging, leading) {
 }
 
 // src/internal/drain-ops.ts
-var claim = (lagging, leading, by, millis, lane) => _chunkGEUBNZ3Bcjs.store.call(void 0, ).claim(lagging, leading, by, millis, lane);
+var claim = (lagging, leading, by, millis, lane) => _chunkBTLM7SW4cjs.store.call(void 0, ).claim(lagging, leading, by, millis, lane);
 async function fetch(leased, eventLimit) {
   return Promise.all(
     leased.map(async ({ stream, source, at, lagging }) => {
       const events = [];
-      const stream_exact = source !== void 0 && _chunkGEUBNZ3Bcjs.is_literal_source.call(void 0, source) ? true : void 0;
+      const stream_exact = source !== void 0 && _chunkBTLM7SW4cjs.is_literal_source.call(void 0, source) ? true : void 0;
       try {
-        await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query((e) => events.push(e), {
+        await _chunkBTLM7SW4cjs.store.call(void 0, ).query((e) => events.push(e), {
           stream: source,
           stream_exact,
           after: at,
@@ -1641,30 +1641,30 @@ async function fetch(leased, eventLimit) {
     })
   );
 }
-var ack = (leases) => _chunkGEUBNZ3Bcjs.store.call(void 0, ).ack(leases);
-var block = (leases) => _chunkGEUBNZ3Bcjs.store.call(void 0, ).block(leases);
-var subscribe = (streams, correlated_at, correlator) => _chunkGEUBNZ3Bcjs.store.call(void 0, ).subscribe(streams, correlated_at, correlator);
+var ack = (leases) => _chunkBTLM7SW4cjs.store.call(void 0, ).ack(leases);
+var block = (leases) => _chunkBTLM7SW4cjs.store.call(void 0, ).block(leases);
+var subscribe = (streams, correlated_at, correlator) => _chunkBTLM7SW4cjs.store.call(void 0, ).subscribe(streams, correlated_at, correlator);
 
 // src/internal/event-sourcing.ts
 var _actpatch = require('@rotorsoft/act-patch');
 var bare_patch = (_me, state2, partial) => _actpatch.patch.call(void 0, state2, partial);
 var validating_patch = (me, state2, partial, event) => {
   const next = _actpatch.patch.call(void 0, state2, partial);
-  return _chunkGEUBNZ3Bcjs.validate.call(void 0, 
+  return _chunkBTLM7SW4cjs.validate.call(void 0, 
     `${me.name}.${String(event.name)}#${event.id}`,
     next,
     me.state
   );
 };
 var DEFAULT_BATCH = 500;
-var cache_put = (stream, entry) => _chunkGEUBNZ3Bcjs.cache.call(void 0, ).set(stream, entry).catch(
-  (err) => _chunkGEUBNZ3Bcjs.log.call(void 0, ).warn(
+var cache_put = (stream, entry) => _chunkBTLM7SW4cjs.cache.call(void 0, ).set(stream, entry).catch(
+  (err) => _chunkBTLM7SW4cjs.log.call(void 0, ).warn(
     err,
     "cache set skipped; the next load re-folds from the store"
   )
 );
-var cache_drop = (stream) => _chunkGEUBNZ3Bcjs.cache.call(void 0, ).invalidate(stream).catch(
-  (err) => _chunkGEUBNZ3Bcjs.log.call(void 0, ).warn(
+var cache_drop = (stream) => _chunkBTLM7SW4cjs.cache.call(void 0, ).invalidate(stream).catch(
+  (err) => _chunkBTLM7SW4cjs.log.call(void 0, ).warn(
     err,
     "cache invalidate skipped; a stale checkpoint re-folds from its event_id"
   )
@@ -1672,9 +1672,9 @@ var cache_drop = (stream) => _chunkGEUBNZ3Bcjs.cache.call(void 0, ).invalidate(s
 async function snap(snapshot) {
   const { id, stream, name, meta, version } = snapshot.event;
   try {
-    const [committed] = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).commit(
+    const [committed] = await _chunkBTLM7SW4cjs.store.call(void 0, ).commit(
       stream,
-      [{ name: _chunkDVYTKZD5cjs.SNAP_EVENT, data: snapshot.state }],
+      [{ name: _chunkRF5MV72Kcjs.SNAP_EVENT, data: snapshot.state }],
       {
         correlation: meta.correlation,
         causation: { event: { id, name, stream } }
@@ -1685,22 +1685,22 @@ async function snap(snapshot) {
     return committed;
   } catch (error) {
     const reason = error instanceof Error ? error.message : String(error);
-    _chunkGEUBNZ3Bcjs.log.call(void 0, ).warn(
+    _chunkBTLM7SW4cjs.log.call(void 0, ).warn(
       `Snapshot write failed on stream "${stream}": ${reason} \u2014 cold starts will replay full history until snapshots succeed.`
     );
   }
 }
 async function tombstone(stream, expectedVersion, correlation) {
   try {
-    const [committed] = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).commit(
+    const [committed] = await _chunkBTLM7SW4cjs.store.call(void 0, ).commit(
       stream,
-      [{ name: _chunkDVYTKZD5cjs.TOMBSTONE_EVENT, data: {} }],
+      [{ name: _chunkRF5MV72Kcjs.TOMBSTONE_EVENT, data: {} }],
       { correlation, causation: {} },
       expectedVersion
     );
     return committed;
   } catch (error) {
-    if (error instanceof _chunkDVYTKZD5cjs.ConcurrencyError) return void 0;
+    if (error instanceof _chunkRF5MV72Kcjs.ConcurrencyError) return void 0;
     throw error;
   }
 }
@@ -1730,9 +1730,9 @@ async function scan(source, opts = {}, callback) {
   if (drop_closed_streams) {
     await source.query(
       (e) => {
-        if (e.name === _chunkDVYTKZD5cjs.TOMBSTONE_EVENT) closed_streams.add(e.stream);
+        if (e.name === _chunkRF5MV72Kcjs.TOMBSTONE_EVENT) closed_streams.add(e.stream);
       },
-      { names: [_chunkDVYTKZD5cjs.TOMBSTONE_EVENT] }
+      { names: [_chunkRF5MV72Kcjs.TOMBSTONE_EVENT] }
     );
   }
   let max_id;
@@ -1754,11 +1754,11 @@ async function scan(source, opts = {}, callback) {
         if (!is_valid(event))
           throw new Error(`Invalid event at index ${processed}`);
         if (on_progress) on_progress({ processed, id: event.id, max_id });
-        if (drop_snapshots && event.name === _chunkDVYTKZD5cjs.SNAP_EVENT) {
+        if (drop_snapshots && event.name === _chunkRF5MV72Kcjs.SNAP_EVENT) {
           dropped_snaps++;
           return;
         }
-        if (closed_streams.has(event.stream) && event.name !== _chunkDVYTKZD5cjs.TOMBSTONE_EVENT) {
+        if (closed_streams.has(event.stream) && event.name !== _chunkRF5MV72Kcjs.TOMBSTONE_EVENT) {
           dropped_closed++;
           return;
         }
@@ -1825,17 +1825,17 @@ async function scan(source, opts = {}, callback) {
 async function load(me, target, callback, patch_fn = bare_patch) {
   const { stream, actor, asOf } = target;
   const time_travel = !!asOf && Object.values(asOf).some((v) => v !== void 0);
-  const cached = time_travel ? void 0 : await _chunkGEUBNZ3Bcjs.cache.call(void 0, ).get(stream);
+  const cached = time_travel ? void 0 : await _chunkBTLM7SW4cjs.cache.call(void 0, ).get(stream);
   const cache_hit = !!cached;
   let state2 = _nullishCoalesce(_optionalChain([cached, 'optionalAccess', _72 => _72.state]), () => ( (me.init ? me.init() : {})));
   let patches = _nullishCoalesce(_optionalChain([cached, 'optionalAccess', _73 => _73.patches]), () => ( 0));
   let snaps = _nullishCoalesce(_optionalChain([cached, 'optionalAccess', _74 => _74.snaps]), () => ( 0));
   let replayed = 0;
   let event;
-  await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query(
+  await _chunkBTLM7SW4cjs.store.call(void 0, ).query(
     (raw) => {
       event = me.view(raw, actor);
-      if (event.name === _chunkDVYTKZD5cjs.SNAP_EVENT) {
+      if (event.name === _chunkRF5MV72Kcjs.SNAP_EVENT) {
         state2 = event.data;
         snaps++;
         patches = 0;
@@ -1844,8 +1844,8 @@ async function load(me, target, callback, patch_fn = bare_patch) {
         state2 = patch_fn(me, state2, me.patch[event.name](event, state2), event);
         patches++;
         replayed++;
-      } else if (event.name !== _chunkDVYTKZD5cjs.TOMBSTONE_EVENT) {
-        _chunkGEUBNZ3Bcjs.log.call(void 0, ).warn(
+      } else if (event.name !== _chunkRF5MV72Kcjs.TOMBSTONE_EVENT) {
+        _chunkBTLM7SW4cjs.log.call(void 0, ).warn(
           `Skipping unknown event "${String(event.name)}" on stream "${stream}" (id=${event.id}) \u2014 no reducer in state "${me.name}"`
         );
       }
@@ -1869,7 +1869,7 @@ async function load(me, target, callback, patch_fn = bare_patch) {
       ...cached ? { after: cached.event_id, with_snaps: true } : { ...time_travel ? {} : { with_snaps: true }, ...asOf }
     }
   );
-  const head_is_tombstone = _optionalChain([event, 'optionalAccess', _76 => _76.name]) === _chunkDVYTKZD5cjs.TOMBSTONE_EVENT;
+  const head_is_tombstone = _optionalChain([event, 'optionalAccess', _76 => _76.name]) === _chunkRF5MV72Kcjs.TOMBSTONE_EVENT;
   if (replayed > 0 && !time_travel && event && !me.pii_aware && !head_is_tombstone) {
     await cache_put(stream, {
       stream,
@@ -1897,7 +1897,7 @@ async function action(me, action2, target, payload, options, patch_fn = bare_pat
   if (!stream) throw new Error("Missing target stream");
   const reactingTo = _optionalChain([options, 'optionalAccess', _81 => _81.reactingTo]);
   const correlator = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _82 => _82.correlator]), () => ( default_correlator));
-  const validated = _chunkGEUBNZ3Bcjs.validate.call(void 0, action2, payload, me.actions[action2]);
+  const validated = _chunkBTLM7SW4cjs.validate.call(void 0, action2, payload, me.actions[action2]);
   const opts = _optionalChain([me, 'access', _83 => _83.options, 'optionalAccess', _84 => _84[action2]]);
   const max_retries = _nullishCoalesce(_optionalChain([opts, 'optionalAccess', _85 => _85.maxRetries]), () => ( 0));
   for (let attempt = 0; ; attempt++) {
@@ -1908,14 +1908,14 @@ async function action(me, action2, target, payload, options, patch_fn = bare_pat
         void 0,
         patch_fn
       );
-      if (_optionalChain([snapshot, 'access', _86 => _86.event, 'optionalAccess', _87 => _87.name]) === _chunkDVYTKZD5cjs.TOMBSTONE_EVENT)
-        throw new (0, _chunkDVYTKZD5cjs.StreamClosedError)(stream);
+      if (_optionalChain([snapshot, 'access', _86 => _86.event, 'optionalAccess', _87 => _87.name]) === _chunkRF5MV72Kcjs.TOMBSTONE_EVENT)
+        throw new (0, _chunkRF5MV72Kcjs.StreamClosedError)(stream);
       const expected = _nullishCoalesce(expectedVersion, () => ( (snapshot.version >= 0 ? snapshot.version : void 0)));
       if (me.given) {
         const invariants = me.given[action2] || [];
         invariants.forEach(({ valid: valid2, description }) => {
           if (!valid2(snapshot.state, actor))
-            throw new (0, _chunkDVYTKZD5cjs.InvariantError)(
+            throw new (0, _chunkRF5MV72Kcjs.InvariantError)(
               action2,
               validated,
               target,
@@ -1924,6 +1924,19 @@ async function action(me, action2, target, payload, options, patch_fn = bare_pat
             );
         });
       }
+      if (me.requires) {
+        const preconditions = me.requires[action2] || [];
+        for (const { holds, description } of preconditions)
+          if (!holds(validated, snapshot.state, actor))
+            throw new (0, _chunkRF5MV72Kcjs.InvariantError)(
+              action2,
+              validated,
+              target,
+              snapshot,
+              description,
+              "precondition"
+            );
+      }
       const result = me.on[action2](validated, snapshot, target);
       if (!result) return [snapshot];
       if (Array.isArray(result) && result.length === 0) {
@@ -1932,7 +1945,7 @@ async function action(me, action2, target, payload, options, patch_fn = bare_pat
       const tuples = Array.isArray(result[0]) ? result : [result];
       const valid = tuples.map(([name, data]) => ({
         name,
-        data: _chunkGEUBNZ3Bcjs.validate.call(void 0, name, data, me.events[name])
+        data: _chunkBTLM7SW4cjs.validate.call(void 0, name, data, me.events[name])
       }));
       const emitted = valid.map((e) => me.message(e));
       const meta = {
@@ -1957,7 +1970,7 @@ async function action(me, action2, target, payload, options, patch_fn = bare_pat
       };
       let committed;
       try {
-        committed = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).commit(
+        committed = await _chunkBTLM7SW4cjs.store.call(void 0, ).commit(
           stream,
           emitted,
           meta,
@@ -1966,7 +1979,7 @@ async function action(me, action2, target, payload, options, patch_fn = bare_pat
           reactingTo ? expectedVersion : expected
         );
       } catch (error) {
-        if (error instanceof _chunkDVYTKZD5cjs.ConcurrencyError) void cache_drop(stream);
+        if (error instanceof _chunkRF5MV72Kcjs.ConcurrencyError) void cache_drop(stream);
         throw error;
       }
       let { state: state2, patches } = snapshot;
@@ -2005,19 +2018,19 @@ async function action(me, action2, target, payload, options, patch_fn = bare_pat
       }
       return snapshots;
     } catch (error) {
-      if (!(error instanceof _chunkDVYTKZD5cjs.ConcurrencyError)) throw error;
+      if (!(error instanceof _chunkRF5MV72Kcjs.ConcurrencyError)) throw error;
       if (expectedVersion !== void 0) throw error;
       if (attempt >= max_retries) throw error;
       if (_optionalChain([opts, 'optionalAccess', _94 => _94.backoff])) {
         const delay_ms = compute_backoff_delay(attempt, opts.backoff);
-        if (delay_ms > 0) await _chunkGEUBNZ3Bcjs.sleep.call(void 0, delay_ms);
+        if (delay_ms > 0) await _chunkBTLM7SW4cjs.sleep.call(void 0, delay_ms);
       }
     }
   }
 }
 
 // src/internal/tracing.ts
-var PRETTY = _chunkGEUBNZ3Bcjs.config.call(void 0, ).env !== "production";
+var PRETTY = _chunkBTLM7SW4cjs.config.call(void 0, ).env !== "production";
 var C_BLUE = "\x1B[38;5;39m";
 var C_ORANGE = "\x1B[38;5;208m";
 var C_GREEN = "\x1B[38;5;42m";
@@ -2203,7 +2216,7 @@ function budget_exhausted(lease, options, store_failing) {
   if (store_failing || !_optionalChain([options, 'optionalAccess', _104 => _104.blockOnError]) || lease.retry <= options.maxRetries)
     return void 0;
   const error = `Blocking ${lease.stream} after ${lease.retry} claims with no acknowledged progress \u2014 the retry budget (${options.maxRetries}) was spent without the handler ever reporting an error. That means every attempt lost its lease before it could ack: move the reaction to a lane whose leaseMillis covers the handler, then unblock the stream.`;
-  _chunkGEUBNZ3Bcjs.log.call(void 0, ).error(error);
+  _chunkBTLM7SW4cjs.log.call(void 0, ).error(error);
   return { lease, handled: 0, acked_at: lease.at, error, block: true };
 }
 function fetch_failure_policy(registry) {
@@ -2219,13 +2232,13 @@ function fetch_failure_policy(registry) {
 function finalize(lease, handled, at, error, options, logger, failed_at) {
   if (!error) return { lease, handled, acked_at: at };
   logger.error(error);
-  const non_retryable = error instanceof _chunkDVYTKZD5cjs.NonRetryableError;
+  const non_retryable = error instanceof _chunkRF5MV72Kcjs.NonRetryableError;
   const block2 = options.blockOnError && (non_retryable || lease.retry >= options.maxRetries);
   if (block2)
     logger.error(
       non_retryable ? `Blocking ${lease.stream} on non-retryable error.` : `Blocking ${lease.stream} after ${lease.retry} retries.`
     );
-  const next_attempt_at = block2 ? void 0 : Date.now() + compute_backoff_delay(lease.retry, _nullishCoalesce(options.backoff, () => ( _chunkGEUBNZ3Bcjs.DEFAULT_BACKOFF)));
+  const next_attempt_at = block2 ? void 0 : Date.now() + compute_backoff_delay(lease.retry, _nullishCoalesce(options.backoff, () => ( _chunkBTLM7SW4cjs.DEFAULT_BACKOFF)));
   return {
     lease,
     handled,
@@ -2343,18 +2356,17 @@ 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)
-    _chunkGEUBNZ3Bcjs.log.call(void 0, ).warn(
+    _chunkBTLM7SW4cjs.log.call(void 0, ).warn(
       `drain: ${expected - acked.length} of ${expected} acks were dropped \u2014 the lease was taken by another worker mid-handler. That work will be redelivered (at-least-once), but persistent drops mean leaseMillis is too short for this handler.`
     );
   const closeable = handled.filter((h) => h.close !== void 0).map((h) => h.close);
@@ -2454,9 +2466,9 @@ var DrainController = (_class5 = class {
     if (!this.armed || this._stopped || this._inflight)
       return EMPTY_DRAIN;
     const d = _nullishCoalesce(this._deps.defaults, () => ( {}));
-    const streamLimit = _nullishCoalesce(_nullishCoalesce(d.streamLimit, () => ( options.streamLimit)), () => ( _chunkGEUBNZ3Bcjs.DEFAULT_STREAM_LIMIT));
-    const eventLimit = _nullishCoalesce(options.eventLimit, () => ( _chunkGEUBNZ3Bcjs.DEFAULT_EVENT_LIMIT));
-    const leaseMillis = _nullishCoalesce(_nullishCoalesce(d.leaseMillis, () => ( options.leaseMillis)), () => ( _chunkGEUBNZ3Bcjs.DEFAULT_LEASE_MILLIS));
+    const streamLimit = _nullishCoalesce(_nullishCoalesce(d.streamLimit, () => ( options.streamLimit)), () => ( _chunkBTLM7SW4cjs.DEFAULT_STREAM_LIMIT));
+    const eventLimit = _nullishCoalesce(options.eventLimit, () => ( _chunkBTLM7SW4cjs.DEFAULT_EVENT_LIMIT));
+    const leaseMillis = _nullishCoalesce(_nullishCoalesce(d.leaseMillis, () => ( options.leaseMillis)), () => ( _chunkBTLM7SW4cjs.DEFAULT_LEASE_MILLIS));
     if (this._deps.breaker.state(Date.now()) === "open")
       return EMPTY_DRAIN;
     const pass = this._pass(streamLimit, eventLimit, leaseMillis).finally(
@@ -2531,7 +2543,7 @@ function pii_gate(event, fields, predicate, actor) {
   const { pii, ...rest } = event;
   if (pii == null) {
     const shredded = { ...data };
-    for (const f of fields) shredded[f] = _chunkDVYTKZD5cjs.SHREDDED;
+    for (const f of fields) shredded[f] = _chunkRF5MV72Kcjs.SHREDDED;
     return { ...rest, data: shredded };
   }
   const allowed = !!actor && !!predicate && predicate(event, actor);
@@ -2542,7 +2554,7 @@ function pii_gate(event, fields, predicate, actor) {
     };
   }
   const redacted = { ...data };
-  for (const f of fields) redacted[f] = _chunkDVYTKZD5cjs.REDACTED;
+  for (const f of fields) redacted[f] = _chunkRF5MV72Kcjs.REDACTED;
   return { ...rest, data: redacted };
 }
 var IDENTITY_GATE = (event) => event;
@@ -2679,7 +2691,7 @@ function make_deferred(handler, schedule) {
   const call = handler;
   const deferred = async (event, stream, app) => {
     const when = typeof schedule === "function" ? schedule(event) : schedule;
-    if (Date.now() < resolve_defer_at(when, event)) throw new (0, _chunkDVYTKZD5cjs.DeferSignal)(when);
+    if (Date.now() < resolve_defer_at(when, event)) throw new (0, _chunkRF5MV72Kcjs.DeferSignal)(when);
     return call(event, stream, app);
   };
   Object.defineProperty(deferred, "name", { value: handler.name });
@@ -2748,7 +2760,7 @@ function build_handle(deps) {
           handled++;
         }
       } catch (error) {
-        if (error instanceof _chunkDVYTKZD5cjs.DeferSignal) {
+        if (error instanceof _chunkRF5MV72Kcjs.DeferSignal) {
           let defer;
           try {
             defer = resolve_defer_at(error.when, event);
@@ -2854,9 +2866,8 @@ var SettleLoop = (_class6 = 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 a pass makes no progress (it read no events and leased no
-   * streams) 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) {
@@ -3015,7 +3026,7 @@ var Act = (_class7 = class {
   /** Lanes to arm per event; `"all"` when a dynamic resolver hides the lane. */
   
   
-  __init27() {this._logger = _chunkGEUBNZ3Bcjs.log.call(void 0, )}
+  __init27() {this._logger = _chunkBTLM7SW4cjs.log.call(void 0, )}
   /** This Act's ports: its own bag, or the singleton adapters. */
   
   /** Runs a body so internal `store()`/`cache()` calls resolve to `_ports`. */
@@ -3037,9 +3048,9 @@ var Act = (_class7 = class {
     this._lanes = lanes;
     this._declared_lanes = ["default", ...lanes.map((l) => l.name)];
     validate_only_lanes(options, lanes);
-    this._ports = _nullishCoalesce(options.scoped, () => ( _chunkGEUBNZ3Bcjs.default_scope.call(void 0, )));
+    this._ports = _nullishCoalesce(options.scoped, () => ( _chunkBTLM7SW4cjs.default_scope.call(void 0, )));
     const ports = this._ports;
-    this._scoped = _chunkGEUBNZ3Bcjs.make_run_scoped.call(void 0, {
+    this._scoped = _chunkBTLM7SW4cjs.make_run_scoped.call(void 0, {
       // Getters, not a spread: the singletons resolve lazily, so a later
       // `store(...)` / `cache(...)` still takes effect.
       get store() {
@@ -3049,14 +3060,14 @@ var Act = (_class7 = class {
         return ports.cache;
       },
       // Parsed per build, so a bad window throws on every build.
-      autoclose_window: _chunkGEUBNZ3Bcjs.resolveAutocloseConfig.call(void 0, options).autocloseWindow
+      autoclose_window: _chunkBTLM7SW4cjs.resolveAutocloseConfig.call(void 0, options).autocloseWindow
     });
     this._correlator = _nullishCoalesce(options.correlator, () => ( default_correlator));
     this._es = build_es(this._logger, this._correlator, patch_fn);
     this._cd = build_drain(this._logger);
     const handle = build_handle({
       logger: this._logger,
-      reaction_scope: _chunkGEUBNZ3Bcjs.make_reaction_scope.call(void 0, {
+      reaction_scope: _chunkBTLM7SW4cjs.make_reaction_scope.call(void 0, {
         do: this.do.bind(this),
         load: this.load.bind(this),
         query: this.query.bind(this),
@@ -3086,12 +3097,12 @@ var Act = (_class7 = class {
       this._ports.store,
       options.listen !== false
     );
-    _chunkGEUBNZ3Bcjs.register_weak_disposer.call(void 0, new WeakRef(this), (self) => self.shutdown());
+    _chunkBTLM7SW4cjs.register_weak_disposer.call(void 0, new WeakRef(this), (self) => self.shutdown());
   }
   /** Shared by drain, settle and autoclose; bad knobs throw at build. */
   _build_breaker(options) {
     return new CircuitBreaker(
-      _chunkGEUBNZ3Bcjs.resolveCircuitBreakerConfig.call(void 0, options.circuitBreaker),
+      _chunkBTLM7SW4cjs.resolveCircuitBreakerConfig.call(void 0, options.circuitBreaker),
       {
         on_error: (error, circuit) => this._emit_error(error, circuit),
         // When the cooldown elapses, settle once: its scan or claim is the
@@ -3125,7 +3136,7 @@ var Act = (_class7 = class {
           try {
             await this._run_close(targets);
           } catch (error) {
-            if (error instanceof _chunkDVYTKZD5cjs.StoreError) throw error;
+            if (error instanceof _chunkRF5MV72Kcjs.StoreError) throw error;
             this._logger.error(
               error,
               `Reaction-requested close of ${targets.map((t) => `"${t.stream}"`).join(", ")} failed and was not retried; close it with app.close(...) once the cause is fixed.`
@@ -3160,7 +3171,7 @@ var Act = (_class7 = class {
   /** Audit deps, built after the controllers so the lane set is final. */
   _build_audit_deps() {
     return {
-      store: _chunkGEUBNZ3Bcjs.store,
+      store: _chunkBTLM7SW4cjs.store,
       event_to_state: this._event_to_state,
       // Declared lanes, not this process's controllers: a lane another
       // worker drains is not `unknown-lane`.
@@ -3173,7 +3184,7 @@ var Act = (_class7 = class {
       registry: this.registry,
       static_targets: classification.static_targets,
       cd: this._cd,
-      max_subscribed_streams: _nullishCoalesce(options.maxSubscribedStreams, () => ( _chunkDVYTKZD5cjs.DEFAULT_MAX_SUBSCRIBED_STREAMS)),
+      max_subscribed_streams: _nullishCoalesce(options.maxSubscribedStreams, () => ( _chunkRF5MV72Kcjs.DEFAULT_MAX_SUBSCRIBED_STREAMS)),
       // Declared lanes (not active ones): a lane another process claims is
       // still a valid destination.
       declared_lanes: new Set(this._declared_lanes),
@@ -3189,7 +3200,7 @@ var Act = (_class7 = class {
   /** Cold start: an idle deferred stream still fires on time after a restart. */
   async _seed_persisted_defers() {
     const now = Date.now();
-    await walk_streams(_chunkGEUBNZ3Bcjs.store.call(void 0, ), (pos) => {
+    await walk_streams(_chunkBTLM7SW4cjs.store.call(void 0, ), (pos) => {
       if (pos.deferred_at === void 0 || pos.deferred_at <= now) return;
       const controller = this._drain_controllers.get(_nullishCoalesce(pos.lane, () => ( "default")));
       _optionalChain([controller, 'optionalAccess', _124 => _124.seed_defer, 'call', _125 => _125(pos.stream, pos.deferred_at)]);
@@ -3208,7 +3219,7 @@ var Act = (_class7 = class {
         on_settled: (drain) => this.emit("settled", drain),
         breaker: this._breaker
       },
-      _nullishCoalesce(options.settleDebounceMs, () => ( _chunkDVYTKZD5cjs.DEFAULT_SETTLE_DEBOUNCE_MS))
+      _nullishCoalesce(options.settleDebounceMs, () => ( _chunkRF5MV72Kcjs.DEFAULT_SETTLE_DEBOUNCE_MS))
     );
   }
   
@@ -3228,7 +3239,7 @@ var Act = (_class7 = class {
    */
   shutdown(options) {
     if (!this._shutdown_promise) {
-      _chunkGEUBNZ3Bcjs.resolveShutdownConfig.call(void 0, options);
+      _chunkBTLM7SW4cjs.resolveShutdownConfig.call(void 0, options);
       this._shutdown_promise = (async () => {
         this.stop_correlations();
         this._settle.stop(true);
@@ -3248,10 +3259,10 @@ var Act = (_class7 = class {
    * default for none or 0, and for a running settle), capped.
    */
   _derive_grace_ms(running, settling) {
-    let max = settling ? _chunkGEUBNZ3Bcjs.DEFAULT_LEASE_MILLIS : 0;
+    let max = settling ? _chunkBTLM7SW4cjs.DEFAULT_LEASE_MILLIS : 0;
     for (const c of running)
-      max = Math.max(max, c.lease_millis || _chunkGEUBNZ3Bcjs.DEFAULT_LEASE_MILLIS);
-    return Math.min(max, _chunkGEUBNZ3Bcjs.MAX_SHUTDOWN_GRACE_MS);
+      max = Math.max(max, c.lease_millis || _chunkBTLM7SW4cjs.DEFAULT_LEASE_MILLIS);
+    return Math.min(max, _chunkBTLM7SW4cjs.MAX_SHUTDOWN_GRACE_MS);
   }
   async _await_inflight(grace_ms) {
     const running = [...this._drain_controllers.values()].filter(
@@ -3332,7 +3343,7 @@ var Act = (_class7 = class {
    * @see {@link ValidationError}, {@link InvariantError}, {@link ConcurrencyError}
    */
   async do(action2, target, payload, options) {
-    const reacting_to = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _127 => _127.reactingTo]), () => ( _chunkGEUBNZ3Bcjs.current_reacting.call(void 0, )));
+    const reacting_to = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _127 => _127.reactingTo]), () => ( _chunkBTLM7SW4cjs.current_reacting.call(void 0, )));
     const do_options = reacting_to === _optionalChain([options, 'optionalAccess', _128 => _128.reactingTo]) ? options : { ...options, reactingTo: reacting_to };
     return this._scoped(async () => {
       const snapshots = await this._es.action(
@@ -3393,7 +3404,7 @@ var Act = (_class7 = class {
     return this._scoped(async () => {
       let first;
       let last;
-      const count = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query((e) => {
+      const count = await _chunkBTLM7SW4cjs.store.call(void 0, ).query((e) => {
         const gated = this.registry.query_gate(e.name)(e);
         if (!first) first = gated;
         last = gated;
@@ -3423,7 +3434,7 @@ var Act = (_class7 = class {
   async query_array(query) {
     return this._scoped(async () => {
       const events = [];
-      await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query((e) => {
+      await _chunkBTLM7SW4cjs.store.call(void 0, ).query((e) => {
         events.push(this.registry.query_gate(e.name)(e));
       }, query);
       return events;
@@ -3443,14 +3454,14 @@ var Act = (_class7 = class {
    */
   async forget(stream) {
     return this._scoped(async () => {
-      const s = _chunkGEUBNZ3Bcjs.store.call(void 0, );
+      const s = _chunkBTLM7SW4cjs.store.call(void 0, );
       if (!s.forget_pii) {
         throw new Error(
           `Store does not implement forget_pii \u2014 adapter cannot comply with sensitive-data erasure. Use an adapter that declares pii_isolation: true (e.g. @rotorsoft/act on the in-memory store).`
         );
       }
       const eventCount = await s.forget_pii(stream);
-      await _chunkGEUBNZ3Bcjs.cache.call(void 0, ).invalidate(stream);
+      await _chunkBTLM7SW4cjs.cache.call(void 0, ).invalidate(stream);
       if (eventCount > 0) {
         this.emit("forgotten", { stream, at: /* @__PURE__ */ new Date(), eventCount });
       }
@@ -3484,7 +3495,7 @@ var Act = (_class7 = class {
    * @see {@link correlate} for dynamic stream discovery
    */
   async drain(options = {}) {
-    _chunkGEUBNZ3Bcjs.resolveDrainConfig.call(void 0, options);
+    _chunkBTLM7SW4cjs.resolveDrainConfig.call(void 0, options);
     if (!this._drain)
       return { fetched: [], leased: [], acked: [], blocked: [] };
     return this._scoped(() => this._drain_all(options));
@@ -3664,7 +3675,7 @@ var Act = (_class7 = class {
    */
   async reset(input) {
     return this._scoped(async () => {
-      const count = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).reset(input);
+      const count = await _chunkBTLM7SW4cjs.store.call(void 0, ).reset(input);
       for (const handler of this._batch_handlers.values())
         _optionalChain([handler, 'access', _135 => _135[FOLD_RESET], 'optionalCall', _136 => _136()]);
       if (count > 0) {
@@ -3700,7 +3711,7 @@ var Act = (_class7 = class {
    */
   async unblock(input) {
     return this._scoped(async () => {
-      const count = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).unblock(input);
+      const count = await _chunkBTLM7SW4cjs.store.call(void 0, ).unblock(input);
       if (count > 0) {
         this._wake();
       }
@@ -3755,7 +3766,7 @@ var Act = (_class7 = class {
         return { ...partial, duration_ms: Date.now() - started };
       }
       const target = _nullishCoalesce(sink, () => ( (() => {
-        const s = _chunkGEUBNZ3Bcjs.store.call(void 0, );
+        const s = _chunkBTLM7SW4cjs.store.call(void 0, );
         if (!s.restore) throw new Error("adapter has no restore capability");
         return s;
       })()));
@@ -3801,7 +3812,7 @@ var Act = (_class7 = class {
   async blocked_streams(options) {
     return this._scoped(async () => {
       const positions = [];
-      await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query_streams(
+      await _chunkBTLM7SW4cjs.store.call(void 0, ).query_streams(
         (p) => {
           positions.push(p);
         },
@@ -3853,7 +3864,7 @@ var Act = (_class7 = class {
    * @see {@link Store.prioritize} for the underlying primitive
    */
   async prioritize(filter, priority) {
-    return this._scoped(() => _chunkGEUBNZ3Bcjs.store.call(void 0, ).prioritize(filter, priority));
+    return this._scoped(() => _chunkBTLM7SW4cjs.store.call(void 0, ).prioritize(filter, priority));
   }
   /** Shared by `close()` and reaction-requested closes. */
   async _run_close(targets) {
@@ -3906,8 +3917,8 @@ var Act = (_class7 = 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 — it read no events and leased no streams —
+   * 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.
    *
@@ -3933,7 +3944,7 @@ var Act = (_class7 = class {
    * @see {@link correlate} for manual correlation
    */
   settle(options) {
-    _chunkGEUBNZ3Bcjs.resolveSettleConfig.call(void 0, _nullishCoalesce(options, () => ( {})));
+    _chunkBTLM7SW4cjs.resolveSettleConfig.call(void 0, _nullishCoalesce(options, () => ( {})));
     this._schedule(options);
   }
 }, _class7);
@@ -4089,16 +4100,16 @@ function synthesize_autoclose_reactions(registry, states, read_window) {
       }),
       // Never block on autoclose: a transient query/store error should retry,
       // not quarantine the synthetic stream.
-      options: { blockOnError: false, maxRetries: _chunkGEUBNZ3Bcjs.DEFAULT_MAX_RETRIES },
+      options: { blockOnError: false, maxRetries: _chunkBTLM7SW4cjs.DEFAULT_MAX_RETRIES },
       handler: async (event) => {
         const aggregate = event.stream;
         const window = read_window();
         if (!in_autoclose_window(window, /* @__PURE__ */ new Date()))
-          throw new (0, _chunkDVYTKZD5cjs.DeferSignal)({ at: next_window_open(window, /* @__PURE__ */ new Date()) });
-        const stats = await _chunkGEUBNZ3Bcjs.store.call(void 0, ).query_stats([aggregate], {
+          throw new (0, _chunkRF5MV72Kcjs.DeferSignal)({ at: next_window_open(window, /* @__PURE__ */ new Date()) });
+        const stats = await _chunkBTLM7SW4cjs.store.call(void 0, ).query_stats([aggregate], {
           count: true,
           tail: keep_days !== void 0 ? true : void 0,
-          exclude: [_chunkDVYTKZD5cjs.TOMBSTONE_EVENT, _chunkDVYTKZD5cjs.SNAP_EVENT]
+          exclude: [_chunkRF5MV72Kcjs.TOMBSTONE_EVENT, _chunkRF5MV72Kcjs.SNAP_EVENT]
         });
         const entry = stats.get(aggregate);
         if (!entry) return;
@@ -4129,7 +4140,7 @@ function synthesize_autoclose_reactions(registry, states, read_window) {
           dues.push(days_after(entry.tail.created, keep_days));
         const future = dues.map((d) => d.getTime()).filter((t) => t > Date.now());
         if (future.length)
-          throw new (0, _chunkDVYTKZD5cjs.DeferSignal)({ at: new Date(Math.min(...future)) });
+          throw new (0, _chunkRF5MV72Kcjs.DeferSignal)({ at: new Date(Math.min(...future)) });
       }
     };
     const key = `__autoclose_${st.name}`;
@@ -4241,6 +4252,7 @@ function merge_into_existing(state2, existing, states, actions, events) {
     patch: merged_patch,
     on: { ...existing.on, ...state2.on },
     given: { ...existing.given, ...state2.given },
+    requires: { ...existing.requires, ...state2.requires },
     snap: pick_declared(existing.snap, state2.snap, "snap strategy", state2.name),
     // Per-action retry policy is keyed by action name, so the two partials'
     // maps combine. Left `undefined` when neither declared one, so the
@@ -4333,9 +4345,9 @@ var _this_ = ({ stream }) => ({
 
 // src/builders/builder-utils.ts
 function register_lane(config2, lanes) {
-  _chunkGEUBNZ3Bcjs.resolveLaneConfig.call(void 0, config2);
-  if (config2.name === _chunkDVYTKZD5cjs.DEFAULT_LANE)
-    throw new Error(`Lane "${_chunkDVYTKZD5cjs.DEFAULT_LANE}" is reserved`);
+  _chunkBTLM7SW4cjs.resolveLaneConfig.call(void 0, config2);
+  if (config2.name === _chunkRF5MV72Kcjs.DEFAULT_LANE)
+    throw new Error(`Lane "${_chunkRF5MV72Kcjs.DEFAULT_LANE}" is reserved`);
   const existing = lanes.find((l) => l.name === config2.name);
   if (!existing) return void lanes.push(config2);
   if (existing.leaseMillis !== config2.leaseMillis || existing.streamLimit !== config2.streamLimit || existing.cycleMs !== config2.cycleMs)
@@ -4377,9 +4389,9 @@ function reaction_on(event, events, builder) {
         // Validate the whole bag at the declaration site so a bad
         // `maxRetries`/`backoff`/`blockOnError` throws ZodError at build,
         // not a NaN gate on the first retry.
-        options: _chunkGEUBNZ3Bcjs.resolveReactionConfig.call(void 0, {
-          blockOnError: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _151 => _151.blockOnError]), () => ( _chunkGEUBNZ3Bcjs.DEFAULT_BLOCK_ON_ERROR)),
-          maxRetries: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _152 => _152.maxRetries]), () => ( _chunkGEUBNZ3Bcjs.DEFAULT_MAX_RETRIES)),
+        options: _chunkBTLM7SW4cjs.resolveReactionConfig.call(void 0, {
+          blockOnError: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _151 => _151.blockOnError]), () => ( _chunkBTLM7SW4cjs.DEFAULT_BLOCK_ON_ERROR)),
+          maxRetries: _nullishCoalesce(_optionalChain([options, 'optionalAccess', _152 => _152.maxRetries]), () => ( _chunkBTLM7SW4cjs.DEFAULT_MAX_RETRIES)),
           backoff: _optionalChain([options, 'optionalAccess', _153 => _153.backoff])
         })
       };
@@ -4464,7 +4476,7 @@ function date_reviver_schema(schema) {
 
 // src/builders/event-builder.ts
 function event_tags(schema) {
-  const pii = _chunkDVYTKZD5cjs.pii_schemas.call(void 0, schema);
+  const pii = _chunkRF5MV72Kcjs.pii_schemas.call(void 0, schema);
   const pii_dates = {};
   for (const [key, field] of Object.entries(pii)) {
     const dates = date_reviver_schema(field);
@@ -4501,7 +4513,7 @@ function make_event_reader(tags, disclosure, predicate = null) {
   });
 }
 function build_events(registry, states, lanes, owners) {
-  const declared = /* @__PURE__ */ new Set([_chunkDVYTKZD5cjs.DEFAULT_LANE, ...lanes.map((l) => l.name)]);
+  const declared = /* @__PURE__ */ new Set([_chunkRF5MV72Kcjs.DEFAULT_LANE, ...lanes.map((l) => l.name)]);
   const lane_errors = [];
   const tags = /* @__PURE__ */ new Map();
   const sensitive2 = /* @__PURE__ */ new Map();
@@ -4565,7 +4577,7 @@ function build_events(registry, states, lanes, owners) {
       if (reader) readers.set(event_name, reader);
     }
     const snap2 = make_event_reader(event_tags(state2.state), "redact", null);
-    if (snap2) readers.set(_chunkDVYTKZD5cjs.SNAP_EVENT, snap2);
+    if (snap2) readers.set(_chunkRF5MV72Kcjs.SNAP_EVENT, snap2);
     if (readers.size === 0) continue;
     state2.view = (event, actor) => (_nullishCoalesce(readers.get(event.name), () => ( IDENTITY_GATE)))(event, actor);
   }
@@ -4681,7 +4693,7 @@ function act() {
       const list = deprecation_summary.map(
         (d) => `"${d.deprecated}" (current: "${d.current}", state: "${d.state_name}")`
       ).join(", ");
-      _chunkGEUBNZ3Bcjs.log.call(void 0, ).info(
+      _chunkBTLM7SW4cjs.log.call(void 0, ).info(
         `Act registered ${deprecation_summary.length} deprecated event(s): ${list}. These are legacy versions kept for the read path. Consider truncating closed streams via app.close() when feasible to reduce historical event load. See docs/docs/architecture/event-schema-evolution.md.`
       );
     }
@@ -4723,7 +4735,7 @@ function act() {
       return reaction_on(event, registry.events, builder);
     },
     build: (options) => {
-      _chunkGEUBNZ3Bcjs.resolveActConfig.call(void 0, options);
+      _chunkBTLM7SW4cjs.resolveActConfig.call(void 0, options);
       const patch_fn = _optionalChain([options, 'optionalAccess', _165 => _165.validateFoldedState]) === true ? validating_patch : bare_patch;
       if (!_built) {
         for (const proj of pending_projections) add_projection(proj);
@@ -4775,7 +4787,7 @@ function act() {
         synthesize_autoclose_reactions(
           registry,
           states,
-          _chunkGEUBNZ3Bcjs.current_autoclose_window
+          _chunkBTLM7SW4cjs.current_autoclose_window
         );
         Object.freeze(registry.actions);
         Object.freeze(registry.events);
@@ -4824,8 +4836,8 @@ function _projection(target) {
               handler,
               resolver: _nullishCoalesce(default_resolver, () => ( _this_)),
               options: {
-                blockOnError: _chunkGEUBNZ3Bcjs.DEFAULT_BLOCK_ON_ERROR,
-                maxRetries: _chunkGEUBNZ3Bcjs.DEFAULT_MAX_RETRIES
+                blockOnError: _chunkBTLM7SW4cjs.DEFAULT_BLOCK_ON_ERROR,
+                maxRetries: _chunkBTLM7SW4cjs.DEFAULT_MAX_RETRIES
               }
             }),
             widened
@@ -4866,7 +4878,7 @@ function _projection(target) {
             throw new Error(
               `Projection "${target}" .of() partials must share one state name \u2014 got "${name}" and "${partial.name}"`
             );
-        const config2 = _chunkGEUBNZ3Bcjs.resolveFoldConfig.call(void 0, options);
+        const config2 = _chunkBTLM7SW4cjs.resolveFoldConfig.call(void 0, options);
         const fold_events = {};
         for (const partial of partials)
           for (const [event_name, schema] of Object.entries(partial.events)) {
@@ -4884,8 +4896,8 @@ function _projection(target) {
                     handler: noop,
                     resolver: { target },
                     options: {
-                      blockOnError: _chunkGEUBNZ3Bcjs.DEFAULT_BLOCK_ON_ERROR,
-                      maxRetries: _chunkGEUBNZ3Bcjs.DEFAULT_MAX_RETRIES
+                      blockOnError: _chunkBTLM7SW4cjs.DEFAULT_BLOCK_ON_ERROR,
+                      maxRetries: _chunkBTLM7SW4cjs.DEFAULT_MAX_RETRIES
                     }
                   }
                 ]
@@ -5001,13 +5013,18 @@ function action_builder(state2) {
         throw new Error(`Duplicate action "${action2}"`);
       internal.actions[action2] = schema;
       if (options) {
-        _chunkGEUBNZ3Bcjs.resolveActionConfig.call(void 0, options);
+        _chunkBTLM7SW4cjs.resolveActionConfig.call(void 0, options);
         internal.options ??= {};
         internal.options[action2] = options;
       }
       function given(rules) {
         internal.given ??= {};
         internal.given[action2] = rules;
+        return { requires, emit };
+      }
+      function requires(rules) {
+        internal.requires ??= {};
+        internal.requires[action2] = rules;
         return { emit };
       }
       function emit(handler) {
@@ -5025,7 +5042,7 @@ function action_builder(state2) {
         }
         return builder;
       }
-      return { given, emit };
+      return { given, requires, emit };
     },
     snap(snap2) {
       internal.snap = snap2;
@@ -5290,5 +5307,5 @@ function write_line(writer, line) {
 
 
 
-exports.Act = Act; exports.ActorSchema = _chunkDVYTKZD5cjs.ActorSchema; exports.CausationEventSchema = _chunkDVYTKZD5cjs.CausationEventSchema; exports.CommittedMetaSchema = _chunkDVYTKZD5cjs.CommittedMetaSchema; exports.ConcurrencyError = _chunkDVYTKZD5cjs.ConcurrencyError; exports.ConsoleLogger = _chunkGEUBNZ3Bcjs.ConsoleLogger; exports.CsvFile = CsvFile; exports.DEFAULT_LANE = _chunkDVYTKZD5cjs.DEFAULT_LANE; exports.DEFAULT_MAX_SUBSCRIBED_STREAMS = _chunkDVYTKZD5cjs.DEFAULT_MAX_SUBSCRIBED_STREAMS; exports.DEFAULT_SETTLE_DEBOUNCE_MS = _chunkDVYTKZD5cjs.DEFAULT_SETTLE_DEBOUNCE_MS; exports.DeferSignal = _chunkDVYTKZD5cjs.DeferSignal; exports.Environments = _chunkDVYTKZD5cjs.Environments; exports.Errors = _chunkDVYTKZD5cjs.Errors; exports.EventMetaSchema = _chunkDVYTKZD5cjs.EventMetaSchema; exports.ExitCodes = _chunkDVYTKZD5cjs.ExitCodes; exports.InMemoryCache = _chunkGEUBNZ3Bcjs.InMemoryCache; exports.InMemoryStore = _chunkGEUBNZ3Bcjs.InMemoryStore; exports.InvariantError = _chunkDVYTKZD5cjs.InvariantError; exports.LogLevels = _chunkDVYTKZD5cjs.LogLevels; exports.NonRetryableError = _chunkDVYTKZD5cjs.NonRetryableError; exports.PackageSchema = _chunkGEUBNZ3Bcjs.PackageSchema; exports.QuerySchema = _chunkDVYTKZD5cjs.QuerySchema; exports.REDACTED = _chunkDVYTKZD5cjs.REDACTED; exports.SHREDDED = _chunkDVYTKZD5cjs.SHREDDED; exports.SNAP_EVENT = _chunkDVYTKZD5cjs.SNAP_EVENT; exports.StoreError = _chunkDVYTKZD5cjs.StoreError; exports.StreamClosedError = _chunkDVYTKZD5cjs.StreamClosedError; exports.TOMBSTONE_EVENT = _chunkDVYTKZD5cjs.TOMBSTONE_EVENT; exports.TargetSchema = _chunkDVYTKZD5cjs.TargetSchema; exports.ValidationError = _chunkDVYTKZD5cjs.ValidationError; exports.ZodEmpty = _chunkDVYTKZD5cjs.ZodEmpty; exports.act = act; exports.cache = _chunkGEUBNZ3Bcjs.cache; exports.config = _chunkGEUBNZ3Bcjs.config; exports.dateReviver = _chunkGEUBNZ3Bcjs.dateReviver; exports.default_scope = _chunkGEUBNZ3Bcjs.default_scope; exports.dispose = _chunkGEUBNZ3Bcjs.dispose; exports.disposeAndExit = _chunkGEUBNZ3Bcjs.disposeAndExit; exports.extend = _chunkGEUBNZ3Bcjs.extend; exports.is_literal_source = _chunkGEUBNZ3Bcjs.is_literal_source; exports.log = _chunkGEUBNZ3Bcjs.log; exports.pii_fields = _chunkDVYTKZD5cjs.pii_fields; exports.port = _chunkGEUBNZ3Bcjs.port; exports.projection = projection; exports.resolveAutocloseConfig = _chunkGEUBNZ3Bcjs.resolveAutocloseConfig2; exports.sensitive = _chunkDVYTKZD5cjs.sensitive; exports.sleep = _chunkGEUBNZ3Bcjs.sleep; exports.slice = slice; exports.state = state; exports.store = _chunkGEUBNZ3Bcjs.store; exports.validate = _chunkGEUBNZ3Bcjs.validate;
+exports.Act = Act; exports.ActorSchema = _chunkRF5MV72Kcjs.ActorSchema; exports.CausationEventSchema = _chunkRF5MV72Kcjs.CausationEventSchema; exports.CommittedMetaSchema = _chunkRF5MV72Kcjs.CommittedMetaSchema; exports.ConcurrencyError = _chunkRF5MV72Kcjs.ConcurrencyError; exports.ConsoleLogger = _chunkBTLM7SW4cjs.ConsoleLogger; exports.CsvFile = CsvFile; exports.DEFAULT_LANE = _chunkRF5MV72Kcjs.DEFAULT_LANE; exports.DEFAULT_MAX_SUBSCRIBED_STREAMS = _chunkRF5MV72Kcjs.DEFAULT_MAX_SUBSCRIBED_STREAMS; exports.DEFAULT_SETTLE_DEBOUNCE_MS = _chunkRF5MV72Kcjs.DEFAULT_SETTLE_DEBOUNCE_MS; exports.DeferSignal = _chunkRF5MV72Kcjs.DeferSignal; exports.Environments = _chunkRF5MV72Kcjs.Environments; exports.Errors = _chunkRF5MV72Kcjs.Errors; exports.EventMetaSchema = _chunkRF5MV72Kcjs.EventMetaSchema; exports.ExitCodes = _chunkRF5MV72Kcjs.ExitCodes; exports.InMemoryCache = _chunkBTLM7SW4cjs.InMemoryCache; exports.InMemoryStore = _chunkBTLM7SW4cjs.InMemoryStore; exports.InvariantError = _chunkRF5MV72Kcjs.InvariantError; exports.LogLevels = _chunkRF5MV72Kcjs.LogLevels; exports.NonRetryableError = _chunkRF5MV72Kcjs.NonRetryableError; exports.PackageSchema = _chunkBTLM7SW4cjs.PackageSchema; exports.QuerySchema = _chunkRF5MV72Kcjs.QuerySchema; exports.REDACTED = _chunkRF5MV72Kcjs.REDACTED; exports.SHREDDED = _chunkRF5MV72Kcjs.SHREDDED; exports.SNAP_EVENT = _chunkRF5MV72Kcjs.SNAP_EVENT; exports.StoreError = _chunkRF5MV72Kcjs.StoreError; exports.StreamClosedError = _chunkRF5MV72Kcjs.StreamClosedError; exports.TOMBSTONE_EVENT = _chunkRF5MV72Kcjs.TOMBSTONE_EVENT; exports.TargetSchema = _chunkRF5MV72Kcjs.TargetSchema; exports.ValidationError = _chunkRF5MV72Kcjs.ValidationError; exports.ZodEmpty = _chunkRF5MV72Kcjs.ZodEmpty; exports.act = act; exports.cache = _chunkBTLM7SW4cjs.cache; exports.config = _chunkBTLM7SW4cjs.config; exports.dateReviver = _chunkBTLM7SW4cjs.dateReviver; exports.default_scope = _chunkBTLM7SW4cjs.default_scope; exports.dispose = _chunkBTLM7SW4cjs.dispose; exports.disposeAndExit = _chunkBTLM7SW4cjs.disposeAndExit; exports.extend = _chunkBTLM7SW4cjs.extend; exports.is_literal_source = _chunkBTLM7SW4cjs.is_literal_source; exports.log = _chunkBTLM7SW4cjs.log; exports.pii_fields = _chunkRF5MV72Kcjs.pii_fields; exports.port = _chunkBTLM7SW4cjs.port; exports.projection = projection; exports.resolveAutocloseConfig = _chunkBTLM7SW4cjs.resolveAutocloseConfig2; exports.sensitive = _chunkRF5MV72Kcjs.sensitive; exports.sleep = _chunkBTLM7SW4cjs.sleep; exports.slice = slice; exports.state = state; exports.store = _chunkBTLM7SW4cjs.store; exports.validate = _chunkBTLM7SW4cjs.validate;
 //# sourceMappingURL=index.cjs.map