@rotorsoft/act 1.33.19 → 1.34.0

package/dist/index.js

@@ -40,7 +40,7 @@ import {
   sleep,
   store,
   validate
-} from "./chunk-5Z53Y7SG.js";
+} from "./chunk-5F2TQ4PT.js";
 import {
   ActorSchema,
   CausationEventSchema,
@@ -70,7 +70,7 @@ import {
   pii_fields,
   pii_schemas,
   sensitive
-} from "./chunk-HEHGZHHA.js";
+} from "./chunk-BKCNU6FF.js";
 
 // src/signals.ts
 process.once("SIGINT", async (arg) => {
@@ -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 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) {
@@ -2343,15 +2356,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(
@@ -2854,9 +2866,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 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) {
@@ -3906,8 +3917,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 — 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.
    *
@@ -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
@@ -5008,6 +5020,11 @@ function action_builder(state2) {
       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;