@rotorsoft/act 1.33.20 → 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) {
@@ -4239,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
@@ -5006,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) {
@@ -5023,7 +5042,7 @@ function action_builder(state2) {
         }
         return builder;
       }
-      return { given, emit };
+      return { given, requires, emit };
     },
     snap(snap2) {
       internal.snap = snap2;