@statedelta-actions/rules 0.3.0 → 0.5.1

package/CHANGELOG.md

@@ -0,0 +1,89 @@
+# @statedelta-actions/rules
+
+## 0.5.1
+
+### Patch Changes
+
+- 26c579a: Polish published package metadata and READMEs
+  - `@statedelta-actions/core` now ships a README (was missing on npm).
+  - `@statedelta-actions/analyzer` README: fixed pervasive missing accents.
+  - `graph` and `events` READMEs: titles are now the package name (`# @statedelta-actions/graph` / `# @statedelta-actions/events`) instead of a conceptual name.
+  - All packages: added `keywords`, `homepage`, `bugs`; package.json keys reordered to a canonical layout.
+  - All packages: `CHANGELOG.md` added to `files` so it ships to npm; a `LICENSE` (MIT) file is included in the repo root and in each package.
+
+- Updated dependencies [26c579a]
+- Updated dependencies [a3a818b]
+  - @statedelta-actions/core@0.5.1
+  - @statedelta-actions/actions@0.6.0
+
+## 0.5.0
+
+### Minor Changes
+
+- f8c2b4a: Fail-fast register errors, controlled `action-not-found`, atomic registration, and events async/interactive modes
+  - **actions** — A missing handler for a directive type now throws at register
+    time (was a collected error) — fail-fast for typos and forgotten handlers.
+    Invoking an unknown action id returns `aborted: true, abortedBy:
+"action-not-found"` instead of a soft failure. `isActionAsync` is exposed on
+    the engine ref handed to handlers (symmetric with `isActionInteractive`).
+  - **rules** — `register()` is atomic: it builds a staging set, delegates to the
+    ActionEngine, then indexes locally only on success. Structural errors from the
+    ActionEngine propagate as a throw with no local state mutated.
+  - **events** — `register()`/`defineEvents()` are atomic the same way.
+    Async detection is now per-listener transitive via the ActionEngine mini-graph,
+    so hybrid engines keep `processEvents`/`processEventsAsync` viable for
+    listeners whose subtree is fully sync. New `processEventsInteractive()` returns
+    a drainable iterator (sync or async generator) — pauses from `type:"pause"` or
+    an interactive handler flow via `yield*` up to the consumer; halt scoping is
+    preserved (a pause stops the listeners of that event, following events
+    continue). New `isInteractive` getter.
+  - **core** — `ActionEngineRef` gains an optional `isActionAsync?` accessor.
+  - **sdk** — re-exports the new event types/surface; barrel deps moved to
+    `dependencies` (`workspace:^`).
+
+### Patch Changes
+
+- Updated dependencies [f8c2b4a]
+  - @statedelta-actions/actions@0.5.0
+  - @statedelta-actions/core@0.5.0
+
+## 0.3.0
+
+### Minor Changes
+
+- Split types em definitions + engine em cada package; novo subpath sdk/definitions
+  - core: RegisterWarning movido pra core/types/engine.ts (tipo shared entre packages)
+  - actions: types.ts → types/definitions.ts + types/engine.ts
+  - rules: types.ts → types/definitions.ts + types/engine.ts
+  - events: types.ts → types/definitions.ts + types/engine.ts
+  - sdk: novo subpath ./definitions com re-export de definition types puros (zero runtime)
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @statedelta-actions/core@0.3.0
+  - @statedelta-actions/actions@0.3.0
+
+## 0.2.0
+
+### Minor Changes
+
+- Sync all packages to 0.2.0 (match SDK version)
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @statedelta-actions/core@0.2.0
+  - @statedelta-actions/actions@0.2.0
+
+## 0.3.0
+
+### Minor Changes
+
+- Sync all packages to 0.2.0 (match SDK version)
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @statedelta-actions/core@0.3.0
+  - @statedelta-actions/actions@0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anderson D. Rosa
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -22,15 +22,16 @@
 11. [JIT Compilation](#jit-compilation)
 12. [Batch Operations](#batch-operations)
 13. [Async Support](#async-support)
-14. [Error Handling](#error-handling)
-15. [HALT_HANDLER](#halt_handler)
-16. [createInvokerMiddleware](#createinvokermiddleware)
-17. [Full API Reference](#full-api-reference)
-18. [Use Case: RPG Combat Tick](#use-case-rpg-combat-tick)
-19. [Use Case: E-commerce Order Pipeline](#use-case-e-commerce-order-pipeline)
-20. [Use Case: Deployment Approval Workflow](#use-case-deployment-approval-workflow)
-21. [Performance Spectrum](#performance-spectrum)
-22. [Internal Design Notes](#internal-design-notes)
+14. [Modo Interactive](#modo-interactive)
+15. [Error Handling](#error-handling)
+16. [HALT_HANDLER](#halt_handler)
+17. [createInvokerMiddleware](#createinvokermiddleware)
+18. [Full API Reference](#full-api-reference)
+19. [Use Case: RPG Combat Tick](#use-case-rpg-combat-tick)
+20. [Use Case: E-commerce Order Pipeline](#use-case-e-commerce-order-pipeline)
+21. [Use Case: Deployment Approval Workflow](#use-case-deployment-approval-workflow)
+22. [Performance Spectrum](#performance-spectrum)
+23. [Internal Design Notes](#internal-design-notes)
 
 
 ---
@@ -75,6 +76,8 @@ Middleware enriches the `params` envelope (execution scope), not the domain `ctx
 
 The engine never throws to the consumer during `evaluate()`. All runtime errors are collected in `RuleEvaluationResult.errors`. The only exception is a programmer error: calling `evaluate()` when `isAsync === true`.
 
+`register()` is different — structural errors at boot time (missing handler for a directive type) throw an `Error` and abort the registration atomically. See [Registration](#registration).
+
 ### Feature not used = zero overhead
 
 When hooks are not registered, hook code is never executed — not as dead branches, but as absent code paths. The JIT compiler conditionally emits code only for features that are actually configured. Zero middleware means no middleware variables, no pipeline calls, no params allocation.
@@ -289,12 +292,21 @@ const result = ruleEngine.register([rule1, rule2, ...]);
 
 ### Registration pipeline
 
-1. **Validate** each rule (id, priority, when, then/rules)
-2. **Normalize** to hidden action: `rule:{id}`
-3. **Collect sub-rules** recursively with dot-separated IDs
-4. **Index** in internal registries (`_rules` sorted by priority desc)
-5. **Register** hidden actions in ActionEngine
-6. **Return** merged result
+Three phases. Local registries are only mutated after the ActionEngine accepts every hidden action — `register()` is atomic.
+
+1. **Build** — validate each rule (id, priority, when, then/rules), collect sub-rules recursively, build hidden action definitions (`rule:{id}` for top-level, dot-separated for sub-rules). Soft validation errors (duplicate id, missing required field) accumulate in `errors[]`. No local indexing yet.
+2. **Delegate to ActionEngine** — `actionEngine.register(hiddenActions)`. Structural errors propagate as throw (handler missing for a directive type). Soft errors from the ActionEngine are mapped back to rule ids and added to `errors[]`.
+3. **Index** — only reached when phase 2 returns. Insert each rule into `_ruleRegistry` and `_rules` (sorted by priority desc), refresh per-rule `isAsync`/`isInteractive` flags from the mini-graph.
+
+### Throw vs collected errors
+
+| Error | Behavior |
+|-------|----------|
+| Missing handler for a directive type in `then` (any depth, including sub-rules and `catch`) | **Throws `Error`** in `register()`. No local state mutated. Consumer wraps in try/catch if needed. |
+| Duplicate rule id, missing `when`, missing `then`/`rules`, invalid priority | Collected in `errors[]`. Other valid rules in the same call still register. |
+| `validate()` from a handler returns invalid or throws | Collected in `errors[]`. |
+
+The throw path is reserved for boot-time structural errors that cannot become valid at runtime — typos, forgotten handler registration, refactor leftovers. Soft errors are domain-level and worth surveying.
 
 ### RuleRegisterResult
 
@@ -686,13 +698,31 @@ const result = engine.endBatch();
 
 ## Async Support
 
-### Detection
+### Detection (per-rule transitivo)
 
 ```typescript
-const isAsync = ruleHookAnalysis.hasAnyAsync || actionEngine.isAsync;
+const isAsync = ruleHookAnalysis.hasAnyAsync || hasAnyAsyncRuleTransitive;
 ```
 
-Computed once at construction. Immutable. If any rule hook is async, or if the ActionEngine has async directive hooks, `isAsync === true`.
+Refrescado em `register()` / `unregister()` / `endBatch()` consultando o **mini-graph interno do ActionEngine** (ADR-026 do actions). Cada `StoredRule` cacheia `isAsync`/`isInteractive` per-rule (refletindo `actionEngine.isActionAsync(rule.actionId)`).
+
+**Diferença importante:** antes era `actionEngine.isAsync` (global). Agora é per-rule transitivo. Engine híbrido (handler async + handler sync) com rules **100% sync na sub-árvore** permite `evaluate()` regular — só rules transitivamente async forçam `evaluateAsync()`.
+
+```typescript
+// Engine híbrido — handler async existe, mas action `log` (usada em syncRule) é sync
+const engine = createActionEngine({
+  handlers: { log, fetchAsync: { async: true, async execute() {...} } },
+});
+const rules = createRuleEngine({ actionEngine: engine });
+
+rules.register([
+  { id: "syncRule", priority: 1, when: () => true, then: [{ type: "log", message: "x" }] },
+]);
+
+engine.isAsync;             // true (engine global async — fetchAsync existe)
+rules.isAsync;              // false (rule específica é sync transitivamente)
+rules.evaluate(ctx);        // ✅ funciona — não força evaluateAsync
+```
 
 ### Usage
 
@@ -722,15 +752,141 @@ const ruleEngine = createRuleEngine({
   },
 });
 
+
 // Must use evaluateAsync
 const result = await ruleEngine.evaluateAsync(ctx);
 ```
 
 ---
 
+## Modo Interactive
+
+Permite **pausar avaliação de rules** e aguardar input externo via generators — espelhamento do modo interactive do ActionEngine. Ortogonal a sync/async.
+
+**Habilitação:** ActionEngine precisa estar em modo interactive (`createActionEngine({ ..., interactive: {} })`). Rules detecta automaticamente quando alguma rule registrada tem ação transitivamente interactive.
+
+### Detection per-rule
+
+`StoredRule.isInteractive` cacheia o resultado de `engine.isActionInteractive(rule.actionId)`. Refrescado em register/unregister/endBatch.
+
+```typescript
+rules.isInteractive;              // true se qualquer rule é interactive transitivamente
+rules.evaluate(ctx);              // throws "use evaluateInteractive"
+rules.evaluateAsync(ctx);         // idem
+rules.evaluateInteractive(ctx);   // ✅ retorna iterator
+```
+
+### evaluateInteractive
+
+Retorna `InteractiveRuleSession` (sync) ou `AsyncInteractiveRuleSession` (async, quando `rules.isAsync`). Drenagem via `next(value)`:
+
+> Handlers são primitivas Lego (ADR-028 do actions). Use `input` (genérico) com payload domain-specific. **Nunca crie `askUser`, `confirmEmail`, etc** — viola o princípio canonical.
+
+```typescript
+const engine = createActionEngine({
+  handlers: {
+    // Primitiva canonical: yield + schema + retry interno
+    input: { interactive: true, *execute(d) {
+      const ans = yield { kind: "input", payload: d.payload, schema: d.schema };
+      return { ok: true, data: ans };
+    } },
+    log: { execute: (d, f) => { f.ctx.out.push(d.message); return { ok: true }; } },
+  },
+  interactive: {},
+});
+
+const rules = createRuleEngine({ actionEngine: engine });
+rules.register([
+  { id: "wizard", priority: 1, when: () => true, then: [
+    { type: "log", message: "before" },
+    { type: "pause", message: "Confirmar?", as: "ack" },
+    { type: "input", payload: { kind: "text", label: "Nome" }, as: "name" },
+    { type: "log", resolve: (_c, s) => ({ message: `${s.name} (${s.ack})` }) },
+  ] },
+]);
+
+const ctx = { out: [] };
+const session = rules.evaluateInteractive(ctx);
+
+session.next();              // → { source: "pause", payload: { message: "Confirmar?" } }
+                             //   ctx.out: ["before"]
+session.next("yes");         // → { kind: "input", payload: { kind: "text", label: "Nome" } }
+session.next("Anderson");    // → { done: true, value: RuleEvaluationResult }
+                             //   matched: ["wizard"]
+                             //   ctx.out: ["before", "Anderson (yes)"]
+```
+
+### Mistura sync + interactive (priority order)
+
+Rules sync e interactive coexistem na mesma evaluation, respeitando priority. Rules sync rodam direto (sem yield); rules interactive pausam.
+
+```typescript
+rules.register([
+  { id: "first", priority: 10, when: () => true, then: [{ type: "log", message: "first" }] },
+  { id: "wizard", priority: 5, when: () => true, then: [
+    { type: "pause", message: "?" },
+  ] },
+  { id: "last", priority: 1, when: () => true, then: [{ type: "log", message: "last" }] },
+]);
+
+const session = rules.evaluateInteractive(ctx);
+session.next();        // first roda direto, wizard pausa
+                       // ctx.out: ["first"]
+session.next("ok");    // wizard completa, last roda
+                       // ctx.out: ["first", "last"]
+```
+
+### Async generator (engine async + rule interactive)
+
+Quando alguma rule é async transitivamente E alguma é interactive, `evaluateInteractive` retorna `AsyncInteractiveRuleSession`. Drenagem via `await session.next()`:
+
+```typescript
+rules.register([
+  { id: "loadData", priority: 10, when: () => true, then: [
+    { type: "fetchAsync", as: "v" },
+    { type: "log", resolve: (_c, s) => ({ message: `loaded ${s.v}` }) },
+  ] },
+  { id: "getName", priority: 5, when: () => true, then: [
+    { type: "input", payload: { kind: "text", label: "Nome" }, as: "name" },
+  ] },
+]);
+
+const session = rules.evaluateInteractive(ctx);  // AsyncIterator
+
+await session.next();          // loadData rodou (fetch async), getName yieldou
+await session.next("Anderson"); // matched: ["loadData", "getName"]
+```
+
+### Compilação JIT generator
+
+Em `mode: "jit"`, `evaluateInteractive` usa **JIT generator compilado** (Fase R6 — `buildInteractiveRuleExecutor`). 4 wrappers possíveis:
+
+| `isAsync` | `isInteractive` | Wrapper |
+|-----------|-----------------|---------|
+| false | false | `function ()` (path original — `evaluate`) |
+| true | false | `async function ()` (`evaluateAsync`) |
+| false | true | `function* ()` (`evaluateInteractive` sync) |
+| true | true | `async function* ()` (`evaluateInteractive` async) |
+
+JIT emit branch per-rule no loop:
+
+```javascript
+if (stored.isInteractive) {
+  ir = yield* ae.invokeInteractive(stored.actionId, params);
+} else if (stored.isAsync) {
+  ir = await ae.invokeAsync(stored.actionId, params);
+} else {
+  ir = ae.invoke(stored.actionId, params);
+}
+```
+
+Decisão **per-rule em runtime**, baseada nas flags cached em `StoredRule.isAsync`/`isInteractive`. Em `mode: "interpret"` ou `"auto"` (antes do threshold), usa interpreter generator (mesmo behavior, sem unrolled performance).
+
+---
+
 ## Error Handling
 
-The engine **never throws** during evaluation. All errors are collected:
+The engine **never throws** during evaluation. All runtime errors are collected:
 
 | Error source | Behavior |
 |-------------|----------|
@@ -740,9 +896,12 @@ The engine **never throws** during evaluation. All errors are collected:
 | `onRulesComplete` throws | Silenced |
 | Middleware throws | Error collected, invoke skipped, next rule |
 | ActionEngine invoke errors | Directive errors accumulated in counters |
+| Hidden action id missing at invoke time | Pipeline aborts with `abortedBy: "action-not-found"`, `success: false` |
 | Sub-rule `when()` throws | Error collected, sub-rule skipped |
 | `maxSubRuleDepth` exceeded | Error collected, sub-tree skipped (no abort) |
 
+`register()` follows different rules — see [Registration](#registration). Structural errors at boot (missing handler) throw fail-fast.
+
 ### Inspecting errors
 
 ```typescript

package/dist/index.cjs

@@ -1,5 +1,9 @@
-'use strict';var core=require('@statedelta-actions/core');function M(r,t,e,i,o,h,b,s,u){if(s>=u)return o.push({ruleIndex:h,error:`maxSubRuleDepth (${u}) exceeded`}),i.errors++,false;for(let c=0;c<r.length;c++){let a=r[c];if(a.definition.when){let d;try{d=a.definition.when(t);}catch(g){o.push({ruleIndex:h,error:String(g)}),i.errors++;continue}if(!d)continue}if(a.actionId){let d=e.invoke(a.actionId,b);if(i.directivesApplied+=d.appliedCount,i.directivesSkipped+=d.skippedCount,i.errors+=d.errors.length,d.aborted)return  true}if(a.subRules&&a.subRules.length>0&&M(a.subRules,t,e,i,o,h,b,s+1,u))return  true}return  false}async function $(r,t,e,i,o,h,b,s,u){if(s>=u)return o.push({ruleIndex:h,error:`maxSubRuleDepth (${u}) exceeded`}),i.errors++,false;for(let c=0;c<r.length;c++){let a=r[c];if(a.definition.when){let d;try{d=a.definition.when(t);}catch(g){o.push({ruleIndex:h,error:String(g)}),i.errors++;continue}if(!d)continue}if(a.actionId){let d=await e.invokeAsync(a.actionId,b);if(i.directivesApplied+=d.appliedCount,i.directivesSkipped+=d.skippedCount,i.errors+=d.errors.length,d.aborted)return  true}if(a.subRules&&a.subRules.length>0&&await $(a.subRules,t,e,i,o,h,b,s+1,u))return  true}return  false}function V(){return r=>({$invoker:{ruleId:r.id,priority:r.priority,tags:r.tags??[]}})}function D(r,t,e,i){let o=i?Object.assign({},i):{};for(let h of r)Object.assign(o,h(t,e,o));return o}function L(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function H(r,t,e,i,o,h,b,s,u,c){return {success:r,aborted:t,abortedBy:e,matched:i,skipped:o,notMatched:h,errors:b,processedCount:s,totalCount:u,counters:c}}function W(r,t){let e=r.filledNames.has("beforeRule"),i=r.filledNames.has("afterRule"),o=r.filledNames.has("onRulesComplete"),h=e||i;return function(s,u,c,a,d){let g=s.length,m=[],n=[],A=[],v=[],p=L(),T=a.length>0,C=true,x=false,_,y=g;c.setContext(u);let k=h?{ctx:u,counters:p}:void 0;for(let f=0;f<g;f++){let R=s[f],E=R.definition.id;if(p.rulesEvaluated++,e)try{let l=d.beforeRule(R.definition,k);if(l==="skip"){n.push(E),p.rulesSkipped++;continue}if(l==="abort"){C=!1,x=!0,_="beforeRule",y=f+1;break}}catch(l){v.push({ruleIndex:f,error:`beforeRule: ${l}`}),p.errors++;}let w;try{w=R.definition.when(u);}catch(l){v.push({ruleIndex:f,error:String(l)}),A.push(E),p.errors++;continue}if(!w){A.push(E);continue}m.push(E),p.rulesMatched++;let S;if(T)try{S=D(a,R.definition,u);}catch(l){v.push({ruleIndex:f,error:`Middleware: ${l}`}),p.errors++;continue}if(R.actionId){let l=c.invoke(R.actionId,S);if(p.directivesApplied+=l.appliedCount,p.directivesSkipped+=l.skippedCount,p.errors+=l.errors.length,i)try{if(d.afterRule(R.definition,l,k)==="abort"){C=!1,x=!0,_="afterRule",y=f+1;break}}catch{}if(l.aborted){C=l.abortedBy==="halt",x=true,_=l.abortedBy,y=f+1;break}}if(R.subRules&&R.subRules.length>0&&M(R.subRules,u,c,p,v,f,S,0,t)){C=false,x=true,_="sub-rule",y=f+1;break}}let I=H(C,x,_,m,n,A,v,y,g,p);if(o)try{d.onRulesComplete(I);}catch{}return I}}function J(r,t){let e=r.filledNames.has("beforeRule"),i=r.filledNames.has("afterRule"),o=r.filledNames.has("onRulesComplete"),h=e||i;return async function(s,u,c,a,d){let g=s.length,m=[],n=[],A=[],v=[],p=L(),T=a.length>0,C=true,x=false,_,y=g;c.setContext(u);let k=h?{ctx:u,counters:p}:void 0;for(let f=0;f<g;f++){let R=s[f],E=R.definition.id;if(p.rulesEvaluated++,e)try{let l=await d.beforeRule(R.definition,k);if(l==="skip"){n.push(E),p.rulesSkipped++;continue}if(l==="abort"){C=!1,x=!0,_="beforeRule",y=f+1;break}}catch(l){v.push({ruleIndex:f,error:`beforeRule: ${l}`}),p.errors++;}let w;try{w=R.definition.when(u);}catch(l){v.push({ruleIndex:f,error:String(l)}),A.push(E),p.errors++;continue}if(!w){A.push(E);continue}m.push(E),p.rulesMatched++;let S;if(T)try{S=D(a,R.definition,u);}catch(l){v.push({ruleIndex:f,error:`Middleware: ${l}`}),p.errors++;continue}if(R.actionId){let l=await c.invokeAsync(R.actionId,S);if(p.directivesApplied+=l.appliedCount,p.directivesSkipped+=l.skippedCount,p.errors+=l.errors.length,i)try{if(await d.afterRule(R.definition,l,k)==="abort"){C=!1,x=!0,_="afterRule",y=f+1;break}}catch{}if(l.aborted){C=l.abortedBy==="halt",x=true,_=l.abortedBy,y=f+1;break}}if(R.subRules&&R.subRules.length>0&&await $(R.subRules,u,c,p,v,f,S,0,t)){C=false,x=true,_="sub-rule",y=f+1;break}}let I=H(C,x,_,m,n,A,v,y,g,p);if(o)try{await d.onRulesComplete(I);}catch{}return I}}function O(r,t,e){return t?J(r,e):W(r,e)}function B(r,t,e,i,o,h,b){r.push(`{const _er={success:${t},aborted:true,abortedBy:${e},matched,skipped,notMatched,errors,processedCount:${i},totalCount:${o},counters};`),h&&r.push(`try{${b}_hookOnComplete(_er);}catch(_e){}`),r.push("return _er;}");}function j(r,t,e,i){let{filledNames:o,asyncNames:h}=r,b=y=>o.has(y),s=y=>h.has(y)?"await ":"",u=b("beforeRule"),c=b("afterRule"),a=b("onRulesComplete"),d=s("beforeRule"),g=s("afterRule"),m=s("onRulesComplete"),n=[];n.push("const len=rules.length;"),n.push("const matched=[];const skipped=[];const notMatched=[];"),n.push("const errors=[];"),n.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),n.push("ae.setContext(ctx);"),(u||c)&&n.push("const evalCtx={ctx,counters};"),u&&n.push("const _hookBefore=hooks.beforeRule;"),c&&n.push("const _hookAfter=hooks.afterRule;"),a&&n.push("const _hookOnComplete=hooks.onRulesComplete;"),n.push("for(let i=0;i<len;i++){"),n.push("const stored=rules[i];"),n.push("const _rid=stored.definition.id;"),n.push("counters.rulesEvaluated++;"),u&&(n.push("try{"),n.push(`const _bd=${d}_hookBefore(stored.definition,evalCtx);`),n.push('if(_bd==="skip"){skipped.push(_rid);counters.rulesSkipped++;continue;}'),n.push('if(_bd==="abort")'),B(n,"false",'"beforeRule"',"i+1","len",a,m),n.push('}catch(_e){errors.push({ruleIndex:i,error:"beforeRule: "+_e});counters.errors++;}')),n.push("let ev;"),n.push("try{ev=stored.definition.when(ctx);}catch(_e){errors.push({ruleIndex:i,error:String(_e)});notMatched.push(_rid);counters.errors++;continue;}"),n.push("if(!ev){notMatched.push(_rid);continue;}"),n.push("matched.push(_rid);counters.rulesMatched++;"),t&&(n.push("let params;"),n.push('try{params=$.runMw(mw,stored.definition,ctx);}catch(_e){errors.push({ruleIndex:i,error:"Middleware: "+_e});counters.errors++;continue;}'));let A=t?",params":"",v=e?`await ae.invokeAsync(stored.actionId${A})`:`ae.invoke(stored.actionId${A})`;n.push("if(stored.actionId){"),n.push(`const ir=${v};`),n.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),c&&(n.push("try{"),n.push(`const _ad=${g}_hookAfter(stored.definition,ir,evalCtx);`),n.push('if(_ad==="abort")'),B(n,"false",'"afterRule"',"i+1","len",a,m),n.push("}catch(_e){}")),n.push("if(ir.aborted)"),B(n,'ir.abortedBy==="halt"',"ir.abortedBy","i+1","len",a,m),n.push("}");let p=t?"params":"undefined";n.push("if(stored.subRules&&stored.subRules.length>0){"),n.push(`if(${e?"await ":""}$.evalSub(stored.subRules,ctx,ae,counters,errors,i,${p},0,$.maxDepth))`),B(n,"false",'"sub-rule"',"i+1","len",a,m),n.push("}"),n.push("}"),n.push("const _r={success:true,aborted:false,abortedBy:undefined,matched,skipped,notMatched,errors,processedCount:len,totalCount:len,counters};"),a&&n.push(`try{${m}_hookOnComplete(_r);}catch(_e){}`),n.push("return _r;");let T=n.join(`
-`),C=e?"async ":"",x=new Function("rules","ctx","ae","mw","hooks","$",`"use strict";
-return(${C}()=>{
-${T}
-})();`),_={maxDepth:i};return _.evalSub=e?$:M,t&&(_.runMw=D),function(k,I,f,R,E){return x(k,I,f,R,E,_)}}function P(r){if(!r.id||typeof r.id!="string")return {ruleId:r.id??"(missing)",code:"INVALID_RULE",message:"rule must have a string id"};if(typeof r.priority!="number")return {ruleId:r.id,code:"INVALID_RULE",message:"rule must have a numeric priority"};if(typeof r.when!="function")return {ruleId:r.id,code:"INVALID_RULE",message:"rule must have a when function"};let t=Array.isArray(r.then)&&r.then.length>0,e=Array.isArray(r.rules)&&r.rules.length>0;return !t&&!e?{ruleId:r.id,code:"INVALID_RULE",message:"rule must have then or sub-rules (or both)"}:null}function U(r,t){let e=`${t}.${r.id??"(missing)"}`;if(!r.id||typeof r.id!="string")return {ruleId:e,code:"INVALID_RULE",message:"sub-rule must have a string id"};let i=Array.isArray(r.then)&&r.then.length>0,o=Array.isArray(r.rules)&&r.rules.length>0;return !i&&!o?{ruleId:e,code:"INVALID_RULE",message:"sub-rule must have then or sub-rules (or both)"}:null}var N=()=>{},F=class{_actionEngine;_middleware;_ruleHooks;_isAsync;_maxSubRuleDepth;_requestedMode;_ruleHookAnalysis;_ruleEvaluator;_mode;_maybeAutoPromote;_ruleRegistry=new Map;_rules=[];_batch=null;constructor(t){if(this._actionEngine=t.actionEngine,this._middleware=t.middleware??[],this._ruleHooks=t.ruleHooks??{},this._maxSubRuleDepth=t.maxSubRuleDepth??10,this._requestedMode=t.mode??"auto",this._ruleHookAnalysis=core.analyzeSlots(this._ruleHooks,core.RULE_SLOT_NAMES),this._isAsync=this._ruleHookAnalysis.hasAnyAsync||this._actionEngine.isAsync,this._requestedMode==="jit")this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=N;else if(this._ruleEvaluator=O(this._ruleHookAnalysis,this._isAsync,this._maxSubRuleDepth),this._mode="interpret",this._requestedMode==="auto"){let e=0,i=t.autoJitThreshold??8;this._maybeAutoPromote=()=>{++e>=i&&this._promote();};}else this._maybeAutoPromote=N;}get actionEngine(){return this._actionEngine}get isAsync(){return this._isAsync}get compilationMode(){return this._mode}get size(){return this._rules.length}has(t){return this._ruleRegistry.has(t)}register(t){let e=[],i=[],o=[];for(let s of t){let u=P(s);if(u){i.push(u);continue}if(this._ruleRegistry.has(s.id)){i.push({ruleId:s.id,code:"DUPLICATE_ID",message:`rule "${s.id}" is already registered`});continue}let c=`rule:${s.id}`,a=Array.isArray(s.then)&&s.then.length>0,d=a?c:"",g=Array.isArray(s.rules)&&s.rules.length>0?this._collectSubRules(c,s.rules,i,o):void 0,m={definition:s,actionId:d,priority:s.priority,subRules:g?.length?g:void 0};if(this._ruleRegistry.set(s.id,m),Q(this._rules,m),a){let n=["rule"];s.tags&&n.push(...s.tags),o.push({id:d,tags:n,directives:s.then,declarations:s.declarations});}e.push(s.id);}let h=[];if(o.length>0){let s=this._actionEngine.register(o);for(let u of s.errors){let c=this._actionIdToRuleId(u.actionId);i.push({ruleId:c??u.actionId,code:u.code??"ACTION_ERROR",message:u.error});}h=s.warnings;}let b={registered:e,errors:i,warnings:h};return this._batch&&(this._batch.registered.push(...e),this._batch.errors.push(...i),this._batch.warnings.push(...h)),b}unregister(t){let e=this._ruleRegistry.get(t);return e?(this._ruleRegistry.delete(t),X(this._rules,e),e.actionId&&this._actionEngine.unregister(e.actionId),e.subRules&&this._unregisterSubRules(e.subRules),true):false}beginBatch(){this._batch||(this._batch={depth:0,registered:[],errors:[],warnings:[]}),this._batch.depth++,this._actionEngine.beginBatch();}endBatch(){if(!this._batch||this._batch.depth<=0)throw new Error("endBatch() called without matching beginBatch()");this._batch.depth--;let t=this._actionEngine.endBatch();if(this._batch.depth>0)return {registered:[],errors:[],warnings:[]};let e=this._batch;for(let o of t.errors){let h=this._actionIdToRuleId(o.actionId);e.errors.push({ruleId:h??o.actionId,code:o.code??"ACTION_ERROR",message:o.error});}e.warnings.push(...t.warnings);let i={registered:e.registered,errors:e.errors,warnings:e.warnings};return this._batch=null,i}batch(t){this.beginBatch();try{return t(this),this.endBatch()}catch(e){try{this.endBatch();}catch{}throw e}}evaluate(t){if(this._isAsync)throw new Error("Cannot call evaluate() with async hooks. Use evaluateAsync() instead.");let e=this._ruleEvaluator(this._rules,t,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),e}async evaluateAsync(t){let e=await this._ruleEvaluator(this._rules,t,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),e}compile(){this._requestedMode!=="interpret"&&this._mode!=="jit"&&this._promote();}_collectSubRules(t,e,i,o){let h=[],b=this._actionIdToRuleId(t);for(let s of e){let u=U(s,b);if(u){i.push(u);continue}let c=`${t}.${s.id}`,a=`${b}.${s.id}`,d=Array.isArray(s.then)&&s.then.length>0,g=Array.isArray(s.rules)&&s.rules.length>0?this._collectSubRules(c,s.rules,i,o):void 0,m={definition:s,actionId:d?c:"",subRules:g?.length?g:void 0};if(d){let n=["rule"];s.tags&&n.push(...s.tags),o.push({id:c,tags:n,directives:s.then,declarations:s.declarations});}this._ruleRegistry.set(a,m),h.push(m);}return h}_unregisterSubRules(t){for(let e of t){if(e.actionId){let i=this._actionIdToRuleId(e.actionId);i&&this._ruleRegistry.delete(i),this._actionEngine.unregister(e.actionId);}e.subRules&&this._unregisterSubRules(e.subRules);}}_actionIdToRuleId(t){return t.startsWith("rule:")?t.slice(5):null}_promote(){this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=N;}_buildJitRule(){return j(this._ruleHookAnalysis,this._middleware.length>0,this._isAsync,this._maxSubRuleDepth)}};function K(r){return new F(r)}function Q(r,t){let e=0,i=r.length;for(;e<i;){let o=e+i>>>1;r[o].priority>=t.priority?e=o+1:i=o;}r.splice(e,0,t);}function X(r,t){let e=r.indexOf(t);return e===-1?false:(r.splice(e,1),true)}var Y={analyze:()=>({capabilities:["halt"],dependencies:[]}),execute:()=>({ok:true,halt:true})};exports.HALT_HANDLER=Y;exports.createInvokerMiddleware=V;exports.createRuleEngine=K;
+'use strict';var core=require('@statedelta-actions/core');function B(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l=t.invoke(s.actionId,b);if(o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&B(s.subRules,r,t,o,c,d,b,R+1,a))return  true}return  false}async function F(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l=await t.invokeAsync(s.actionId,b);if(o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&await F(s.subRules,r,t,o,c,d,b,R+1,a))return  true}return  false}function Q(){return n=>({$invoker:{ruleId:n.id,priority:n.priority,tags:n.tags??[]}})}function $(n,r,t,o){let c=o?Object.assign({},o):{};for(let d of n)Object.assign(c,d(r,t,c));return c}function q(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function U(n,r,t,o,c,d,b,R,a,u){return {success:n,aborted:r,abortedBy:t,matched:o,skipped:c,notMatched:d,errors:b,processedCount:R,totalCount:a,counters:u}}function X(n,r){let t=n.filledNames.has("beforeRule"),o=n.filledNames.has("afterRule"),c=n.filledNames.has("onRulesComplete"),d=t||o;return function(R,a,u,s,l){let v=R.length,_=[],e=[],A=[],y=[],h=q(),S=s.length>0,I=true,C=false,g,m=v;u.setContext(a);let E=d?{ctx:a,counters:h}:void 0;for(let f=0;f<v;f++){let p=R[f],k=p.definition.id;if(h.rulesEvaluated++,t)try{let i=l.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(a);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(s,p.definition,a);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i=u.invoke(p.actionId,x);if(h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,o)try{if(l.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&B(p.subRules,a,u,h,y,f,x,0,r)){I=false,C=true,g="sub-rule",m=f+1;break}}let w=U(I,C,g,_,e,A,y,m,v,h);if(c)try{l.onRulesComplete(w);}catch{}return w}}function Y(n,r){let t=n.filledNames.has("beforeRule"),o=n.filledNames.has("afterRule"),c=n.filledNames.has("onRulesComplete"),d=t||o;return async function(R,a,u,s,l){let v=R.length,_=[],e=[],A=[],y=[],h=q(),S=s.length>0,I=true,C=false,g,m=v;u.setContext(a);let E=d?{ctx:a,counters:h}:void 0;for(let f=0;f<v;f++){let p=R[f],k=p.definition.id;if(h.rulesEvaluated++,t)try{let i=await l.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(a);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(s,p.definition,a);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i=await u.invokeAsync(p.actionId,x);if(h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,o)try{if(await l.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&await F(p.subRules,a,u,h,y,f,x,0,r)){I=false,C=true,g="sub-rule",m=f+1;break}}let w=U(I,C,g,_,e,A,y,m,v,h);if(c)try{await l.onRulesComplete(w);}catch{}return w}}function O(n,r,t){return r?Y(n,t):X(n,t)}function G(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function V(n,r,t,o,c,d,b,R,a,u){return {success:n,aborted:r,abortedBy:t,matched:o,skipped:c,notMatched:d,errors:b,processedCount:R,totalCount:a,counters:u}}function Z(n){let r=n.filledNames.has("beforeRule"),t=n.filledNames.has("afterRule"),o=n.filledNames.has("onRulesComplete"),c=r||t;return function*(b,R,a,u,s,l){let v=b.length,_=[],e=[],A=[],y=[],h=G(),S=u.length>0,I=true,C=false,g,m=v;a.setContext(R);let E=c?{ctx:R,counters:h}:void 0;for(let f=0;f<v;f++){let p=b[f],k=p.definition.id;if(h.rulesEvaluated++,r)try{let i=s.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(R);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(u,p.definition,R);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i;if(p.isInteractive?i=yield*a.invokeInteractive(p.actionId,x):i=a.invoke(p.actionId,x),h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,t)try{if(s.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&(yield*D(p.subRules,R,a,h,y,f,x,0,l))){I=false,C=true,g="sub-rule",m=f+1;break}}let w=V(I,C,g,_,e,A,y,m,v,h);if(o)try{s.onRulesComplete(w);}catch{}return w}}function ee(n){let r=n.filledNames.has("beforeRule"),t=n.filledNames.has("afterRule"),o=n.filledNames.has("onRulesComplete"),c=r||t;return async function*(b,R,a,u,s,l){let v=b.length,_=[],e=[],A=[],y=[],h=G(),S=u.length>0,I=true,C=false,g,m=v;a.setContext(R);let E=c?{ctx:R,counters:h}:void 0;for(let f=0;f<v;f++){let p=b[f],k=p.definition.id;if(h.rulesEvaluated++,r)try{let i=await s.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(R);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(u,p.definition,R);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i;if(p.isInteractive?i=yield*a.invokeInteractive(p.actionId,x):p.isAsync?i=await a.invokeAsync(p.actionId,x):i=a.invoke(p.actionId,x),h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,t)try{if(await s.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&(yield*N(p.subRules,R,a,h,y,f,x,0,l))){I=false,C=true,g="sub-rule",m=f+1;break}}let w=V(I,C,g,_,e,A,y,m,v,h);if(o)try{await s.onRulesComplete(w);}catch{}return w}}function*D(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l;if(s.isInteractive?l=yield*t.invokeInteractive(s.actionId,b):l=t.invoke(s.actionId,b),o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&(yield*D(s.subRules,r,t,o,c,d,b,R+1,a)))return  true}return  false}async function*N(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l;if(s.isInteractive?l=yield*t.invokeInteractive(s.actionId,b):s.isAsync?l=await t.invokeAsync(s.actionId,b):l=t.invoke(s.actionId,b),o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&(yield*N(s.subRules,r,t,o,c,d,b,R+1,a)))return  true}return  false}function W(n,r){return r?ee(n):Z(n)}function M(n,r,t,o,c,d,b){n.push(`{const _er={success:${r},aborted:true,abortedBy:${t},matched,skipped,notMatched,errors,processedCount:${o},totalCount:${c},counters};`),d&&n.push(`try{${b}_hookOnComplete(_er);}catch(_e){}`),n.push("return _er;}");}function J(n,r,t,o){let{filledNames:c,asyncNames:d}=n,b=m=>c.has(m),R=m=>d.has(m)?"await ":"",a=b("beforeRule"),u=b("afterRule"),s=b("onRulesComplete"),l=R("beforeRule"),v=R("afterRule"),_=R("onRulesComplete"),e=[];e.push("const len=rules.length;"),e.push("const matched=[];const skipped=[];const notMatched=[];"),e.push("const errors=[];"),e.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),e.push("ae.setContext(ctx);"),(a||u)&&e.push("const evalCtx={ctx,counters};"),a&&e.push("const _hookBefore=hooks.beforeRule;"),u&&e.push("const _hookAfter=hooks.afterRule;"),s&&e.push("const _hookOnComplete=hooks.onRulesComplete;"),e.push("for(let i=0;i<len;i++){"),e.push("const stored=rules[i];"),e.push("const _rid=stored.definition.id;"),e.push("counters.rulesEvaluated++;"),a&&(e.push("try{"),e.push(`const _bd=${l}_hookBefore(stored.definition,evalCtx);`),e.push('if(_bd==="skip"){skipped.push(_rid);counters.rulesSkipped++;continue;}'),e.push('if(_bd==="abort")'),M(e,"false",'"beforeRule"',"i+1","len",s,_),e.push('}catch(_e){errors.push({ruleIndex:i,error:"beforeRule: "+_e});counters.errors++;}')),e.push("let ev;"),e.push("try{ev=stored.definition.when(ctx);}catch(_e){errors.push({ruleIndex:i,error:String(_e)});notMatched.push(_rid);counters.errors++;continue;}"),e.push("if(!ev){notMatched.push(_rid);continue;}"),e.push("matched.push(_rid);counters.rulesMatched++;"),r&&(e.push("let params;"),e.push('try{params=$.runMw(mw,stored.definition,ctx);}catch(_e){errors.push({ruleIndex:i,error:"Middleware: "+_e});counters.errors++;continue;}'));let A=r?",params":"",y=t?`await ae.invokeAsync(stored.actionId${A})`:`ae.invoke(stored.actionId${A})`;e.push("if(stored.actionId){"),e.push(`const ir=${y};`),e.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),u&&(e.push("try{"),e.push(`const _ad=${v}_hookAfter(stored.definition,ir,evalCtx);`),e.push('if(_ad==="abort")'),M(e,"false",'"afterRule"',"i+1","len",s,_),e.push("}catch(_e){}")),e.push("if(ir.aborted)"),M(e,'ir.abortedBy==="halt"',"ir.abortedBy","i+1","len",s,_),e.push("}");let h=r?"params":"undefined";e.push("if(stored.subRules&&stored.subRules.length>0){"),e.push(`if(${t?"await ":""}$.evalSub(stored.subRules,ctx,ae,counters,errors,i,${h},0,$.maxDepth))`),M(e,"false",'"sub-rule"',"i+1","len",s,_),e.push("}"),e.push("}"),e.push("const _r={success:true,aborted:false,abortedBy:undefined,matched,skipped,notMatched,errors,processedCount:len,totalCount:len,counters};"),s&&e.push(`try{${_}_hookOnComplete(_r);}catch(_e){}`),e.push("return _r;");let S=e.join(`
+`),I=t?"async ":"",C=new Function("rules","ctx","ae","mw","hooks","$",`"use strict";
+return(${I}()=>{
+${S}
+})();`),g={maxDepth:o};return g.evalSub=t?F:B,r&&(g.runMw=$),function(E,w,f,p,k){return C(E,w,f,p,k,g)}}function P(n,r,t,o){let{filledNames:c,asyncNames:d}=n,b=g=>c.has(g),R=g=>d.has(g)?"await ":"",a=b("beforeRule"),u=b("afterRule"),s=b("onRulesComplete"),l=R("beforeRule"),v=R("afterRule"),_=R("onRulesComplete"),e=[];e.push("const len=rules.length;"),e.push("const matched=[];const skipped=[];const notMatched=[];"),e.push("const errors=[];"),e.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),e.push("ae.setContext(ctx);"),(a||u)&&e.push("const evalCtx={ctx,counters};"),a&&e.push("const _hookBefore=hooks.beforeRule;"),u&&e.push("const _hookAfter=hooks.afterRule;"),s&&e.push("const _hookOnComplete=hooks.onRulesComplete;"),e.push("for(let i=0;i<len;i++){"),e.push("const stored=rules[i];"),e.push("const _rid=stored.definition.id;"),e.push("counters.rulesEvaluated++;"),a&&(e.push("try{"),e.push(`const _bd=${l}_hookBefore(stored.definition,evalCtx);`),e.push('if(_bd==="skip"){skipped.push(_rid);counters.rulesSkipped++;continue;}'),e.push('if(_bd==="abort")'),M(e,"false",'"beforeRule"',"i+1","len",s,_),e.push('}catch(_e){errors.push({ruleIndex:i,error:"beforeRule: "+_e});counters.errors++;}')),e.push("let ev;"),e.push("try{ev=stored.definition.when(ctx);}catch(_e){errors.push({ruleIndex:i,error:String(_e)});notMatched.push(_rid);counters.errors++;continue;}"),e.push("if(!ev){notMatched.push(_rid);continue;}"),e.push("matched.push(_rid);counters.rulesMatched++;"),r&&(e.push("let params;"),e.push('try{params=$.runMw(mw,stored.definition,ctx);}catch(_e){errors.push({ruleIndex:i,error:"Middleware: "+_e});counters.errors++;continue;}'));let A=r?",params":"";e.push("if(stored.actionId){"),e.push("let ir;"),e.push("if(stored.isInteractive){"),e.push(`ir=yield* ae.invokeInteractive(stored.actionId${A});`),e.push("}else "),t?(e.push("if(stored.isAsync){"),e.push(`ir=await ae.invokeAsync(stored.actionId${A});`),e.push("}else{")):e.push("{"),e.push(`ir=ae.invoke(stored.actionId${A});`),e.push("}"),e.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),u&&(e.push("try{"),e.push(`const _ad=${v}_hookAfter(stored.definition,ir,evalCtx);`),e.push('if(_ad==="abort")'),M(e,"false",'"afterRule"',"i+1","len",s,_),e.push("}catch(_e){}")),e.push("if(ir.aborted)"),M(e,'ir.abortedBy==="halt"',"ir.abortedBy","i+1","len",s,_),e.push("}");let y=r?"params":"undefined";e.push("if(stored.subRules&&stored.subRules.length>0){"),e.push(`if(yield* $.evalSubInt(stored.subRules,ctx,ae,counters,errors,i,${y},0,$.maxDepth))`),M(e,"false",'"sub-rule"',"i+1","len",s,_),e.push("}"),e.push("}"),e.push("const _r={success:true,aborted:false,abortedBy:undefined,matched,skipped,notMatched,errors,processedCount:len,totalCount:len,counters};"),s&&e.push(`try{${_}_hookOnComplete(_r);}catch(_e){}`),e.push("return _r;");let h=e.join(`
+`),S=t?"async function*()":"function*()",I=new Function("rules","ctx","ae","mw","hooks","$",`"use strict";
+return(${S}{
+${h}
+})();`),C={maxDepth:o};return C.evalSubInt=t?N:D,r&&(C.runMw=$),function(m,E,w,f,p){return I(m,E,w,f,p,C)}}function z(n){if(!n.id||typeof n.id!="string")return {ruleId:n.id??"(missing)",code:"INVALID_RULE",message:"rule must have a string id"};if(typeof n.priority!="number")return {ruleId:n.id,code:"INVALID_RULE",message:"rule must have a numeric priority"};if(typeof n.when!="function")return {ruleId:n.id,code:"INVALID_RULE",message:"rule must have a when function"};let r=Array.isArray(n.then)&&n.then.length>0,t=Array.isArray(n.rules)&&n.rules.length>0;return !r&&!t?{ruleId:n.id,code:"INVALID_RULE",message:"rule must have then or sub-rules (or both)"}:null}function K(n,r){let t=`${r}.${n.id??"(missing)"}`;if(!n.id||typeof n.id!="string")return {ruleId:t,code:"INVALID_RULE",message:"sub-rule must have a string id"};let o=Array.isArray(n.then)&&n.then.length>0,c=Array.isArray(n.rules)&&n.rules.length>0;return !o&&!c?{ruleId:t,code:"INVALID_RULE",message:"sub-rule must have then or sub-rules (or both)"}:null}var L=()=>{},j=class{_actionEngine;_middleware;_ruleHooks;_maxSubRuleDepth;_requestedMode;_ruleHookAnalysis;_hasAnyInteractiveRule=false;_isAsync;_ruleEvaluator;_mode;_maybeAutoPromote;_interactiveEvaluator=null;_interactiveEvaluatorIsAsync=false;_ruleRegistry=new Map;_rules=[];_batch=null;constructor(r){if(this._actionEngine=r.actionEngine,this._middleware=r.middleware??[],this._ruleHooks=r.ruleHooks??{},this._maxSubRuleDepth=r.maxSubRuleDepth??10,this._requestedMode=r.mode??"auto",this._ruleHookAnalysis=core.analyzeSlots(this._ruleHooks,core.RULE_SLOT_NAMES),this._isAsync=this._ruleHookAnalysis.hasAnyAsync,this._requestedMode==="jit")this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=L;else if(this._ruleEvaluator=O(this._ruleHookAnalysis,this._isAsync,this._maxSubRuleDepth),this._mode="interpret",this._requestedMode==="auto"){let t=0,o=r.autoJitThreshold??8;this._maybeAutoPromote=()=>{++t>=o&&this._promote();};}else this._maybeAutoPromote=L;}get actionEngine(){return this._actionEngine}get isAsync(){return this._isAsync}get isInteractive(){return this._hasAnyInteractiveRule}get compilationMode(){return this._mode}get size(){return this._rules.length}has(r){return this._ruleRegistry.has(r)}register(r){let t=[],o=[],c=[],d=[];for(let u of r){let s=z(u);if(s){t.push(s);continue}if(this._ruleRegistry.has(u.id)||c.some(y=>y.id===u.id)){t.push({ruleId:u.id,code:"DUPLICATE_ID",message:`rule "${u.id}" is already registered`});continue}let l=`rule:${u.id}`,v=Array.isArray(u.then)&&u.then.length>0,_=v?l:"",e=Array.isArray(u.rules)&&u.rules.length>0?this._collectSubRules(l,u.rules,t,o,d):void 0,A={definition:u,actionId:_,priority:u.priority,subRules:e?.length?e:void 0,isAsync:false,isInteractive:false};if(v){let y=["rule"];u.tags&&y.push(...u.tags),o.push({id:_,tags:y,directives:u.then,declarations:u.declarations});}c.push({id:u.id,stored:A});}let b=[];if(o.length>0){let u=this._actionEngine.register(o);for(let s of u.errors){let l=this._actionIdToRuleId(s.actionId);t.push({ruleId:l??s.actionId,code:s.code??"ACTION_ERROR",message:s.error});}b=u.warnings;}let R=[];for(let{id:u,stored:s}of c)this._ruleRegistry.set(u,s),se(this._rules,s),R.push(u);for(let{qualifiedId:u,stored:s}of d)this._ruleRegistry.set(u,s);let a={registered:R,errors:t,warnings:b};return this._batch?(this._batch.registered.push(...R),this._batch.errors.push(...t),this._batch.warnings.push(...b)):R.length>0&&this._refreshRuleFlags(),a}unregister(r){let t=this._ruleRegistry.get(r);return t?(this._ruleRegistry.delete(r),ie(this._rules,t),t.actionId&&this._actionEngine.unregister(t.actionId),t.subRules&&this._unregisterSubRules(t.subRules),this._refreshRuleFlags(),true):false}beginBatch(){this._batch||(this._batch={depth:0,registered:[],errors:[],warnings:[]}),this._batch.depth++,this._actionEngine.beginBatch();}endBatch(){if(!this._batch||this._batch.depth<=0)throw new Error("endBatch() called without matching beginBatch()");this._batch.depth--;let r=this._actionEngine.endBatch();if(this._batch.depth>0)return {registered:[],errors:[],warnings:[]};let t=this._batch;for(let c of r.errors){let d=this._actionIdToRuleId(c.actionId);t.errors.push({ruleId:d??c.actionId,code:c.code??"ACTION_ERROR",message:c.error});}t.warnings.push(...r.warnings);let o={registered:t.registered,errors:t.errors,warnings:t.warnings};return this._batch=null,this._refreshRuleFlags(),o}batch(r){this.beginBatch();try{return r(this),this.endBatch()}catch(t){try{this.endBatch();}catch{}throw t}}evaluate(r){if(this._hasAnyInteractiveRule)throw new Error("Cannot call evaluate() \u2014 at least one rule is interactive (transitively). Use evaluateInteractive() instead.");if(this._isAsync)throw new Error("Cannot call evaluate() with async hooks or async rules. Use evaluateAsync() instead.");let t=this._ruleEvaluator(this._rules,r,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),t}async evaluateAsync(r){if(this._hasAnyInteractiveRule)throw new Error("Cannot call evaluateAsync() \u2014 at least one rule is interactive (transitively). Use evaluateInteractive() instead.");let t=await this._ruleEvaluator(this._rules,r,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),t}evaluateInteractive(r){if(!this._hasAnyInteractiveRule)throw new Error("Cannot call evaluateInteractive() \u2014 no registered rule is interactive (transitively). Use evaluate() or evaluateAsync() instead.");return (this._interactiveEvaluator===null||this._interactiveEvaluatorIsAsync!==this._isAsync)&&(this._interactiveEvaluator=this._mode==="jit"?P(this._ruleHookAnalysis,this._middleware.length>0,this._isAsync,this._maxSubRuleDepth):W(this._ruleHookAnalysis,this._isAsync),this._interactiveEvaluatorIsAsync=this._isAsync),this._interactiveEvaluator(this._rules,r,this._actionEngine,this._middleware,this._ruleHooks,this._maxSubRuleDepth)}compile(){this._requestedMode!=="interpret"&&this._mode!=="jit"&&this._promote();}_collectSubRules(r,t,o,c,d){let b=[],R=this._actionIdToRuleId(r);for(let a of t){let u=K(a,R);if(u){o.push(u);continue}let s=`${r}.${a.id}`,l=`${R}.${a.id}`,v=Array.isArray(a.then)&&a.then.length>0,_=Array.isArray(a.rules)&&a.rules.length>0?this._collectSubRules(s,a.rules,o,c,d):void 0,e={definition:a,actionId:v?s:"",subRules:_?.length?_:void 0,isAsync:false,isInteractive:false};if(v){let A=["rule"];a.tags&&A.push(...a.tags),c.push({id:s,tags:A,directives:a.then,declarations:a.declarations});}d.push({qualifiedId:l,stored:e}),b.push(e);}return b}_unregisterSubRules(r){for(let t of r){if(t.actionId){let o=this._actionIdToRuleId(t.actionId);o&&this._ruleRegistry.delete(o),this._actionEngine.unregister(t.actionId);}t.subRules&&this._unregisterSubRules(t.subRules);}}_actionIdToRuleId(r){return r.startsWith("rule:")?r.slice(5):null}_refreshRuleFlags(){let r=false,t=false,o=d=>{if(d.actionId?(d.isAsync=this._actionEngine.isActionAsync(d.actionId)??false,d.isInteractive=this._actionEngine.isActionInteractive(d.actionId)??false,d.isAsync&&(r=true),d.isInteractive&&(t=true)):(d.isAsync=false,d.isInteractive=false),d.subRules)for(let b of d.subRules)o(b);};for(let d of this._rules)o(d);this._hasAnyInteractiveRule=t;let c=this._ruleHookAnalysis.hasAnyAsync||r;c!==this._isAsync?(this._isAsync=c,this._rebuildEvaluator()):this._isAsync=c;}_rebuildEvaluator(){this._mode==="jit"?this._ruleEvaluator=this._buildJitRule():this._ruleEvaluator=O(this._ruleHookAnalysis,this._isAsync,this._maxSubRuleDepth);}_promote(){this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=L;}_buildJitRule(){return J(this._ruleHookAnalysis,this._middleware.length>0,this._isAsync,this._maxSubRuleDepth)}};function ne(n){return new j(n)}function se(n,r){let t=0,o=n.length;for(;t<o;){let c=t+o>>>1;n[c].priority>=r.priority?t=c+1:o=c;}n.splice(t,0,r);}function ie(n,r){let t=n.indexOf(r);return t===-1?false:(n.splice(t,1),true)}var oe={analyze:()=>({capabilities:["halt"],dependencies:[]}),execute:()=>({ok:true,halt:true})};exports.HALT_HANDLER=oe;exports.createInvokerMiddleware=Q;exports.createRuleEngine=ne;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Directive, RegisterWarning, RuleError, FrameCounters, HookFn, DirectiveResult } from '@statedelta-actions/core';
+import { Directive, RuleError, FrameCounters, RegisterWarning, HookFn, DirectiveResult } from '@statedelta-actions/core';
 import { IActionEngine } from '@statedelta-actions/actions';
 
 interface SubRuleDefinition<TCtx = unknown> {
@@ -69,11 +69,37 @@ interface RuleEngineConfig<TCtx = unknown> {
     /** Threshold de evaluate() calls para auto-promote em modo "auto". Default: 8. */
     autoJitThreshold?: number;
 }
+/**
+ * Sessão de avaliação de rules em modo interactive — retornada por
+ * `evaluateInteractive(ctx)`. Drena via `next()` igual a `InteractiveSession`
+ * do actions, mas o `done.value` final é `RuleEvaluationResult`.
+ */
+interface InteractiveRuleSession extends Iterator<unknown, RuleEvaluationResult, unknown> {
+    next(value?: unknown): IteratorResult<unknown, RuleEvaluationResult>;
+    return(): IteratorResult<unknown, RuleEvaluationResult>;
+    throw(err?: unknown): IteratorResult<unknown, RuleEvaluationResult>;
+    [Symbol.iterator](): InteractiveRuleSession;
+}
+interface AsyncInteractiveRuleSession extends AsyncIterator<unknown, RuleEvaluationResult, unknown> {
+    next(value?: unknown): Promise<IteratorResult<unknown, RuleEvaluationResult>>;
+    return(): Promise<IteratorResult<unknown, RuleEvaluationResult>>;
+    throw(err?: unknown): Promise<IteratorResult<unknown, RuleEvaluationResult>>;
+    [Symbol.asyncIterator](): AsyncInteractiveRuleSession;
+}
 interface IRuleEngine<TCtx = unknown> {
     register(rules: readonly RuleDefinition<TCtx>[]): RuleRegisterResult;
     unregister(id: string): boolean;
     evaluate(ctx: TCtx): RuleEvaluationResult;
     evaluateAsync(ctx: TCtx): Promise<RuleEvaluationResult>;
+    /**
+     * Avalia rules em modo interactive — retorna iterator drenável.
+     * Lança se nenhuma rule registrada é interactive transitivamente, ou se
+     * actionEngine não tem `interactive` configurado.
+     *
+     * Variante async (AsyncInteractiveRuleSession) é retornada quando alguma
+     * rule é async transitivamente OU algum hook é async.
+     */
+    evaluateInteractive(ctx: TCtx): InteractiveRuleSession | AsyncInteractiveRuleSession;
     beginBatch(): void;
     endBatch(): RuleRegisterResult;
     /** Executa fn dentro de um batch, com endBatch() garantido (inclusive em throw). */
@@ -84,6 +110,8 @@ interface IRuleEngine<TCtx = unknown> {
     has(id: string): boolean;
     readonly actionEngine: IActionEngine<TCtx>;
     readonly isAsync: boolean;
+    /** Alguma rule registrada é interactive transitivamente? Cached. */
+    readonly isInteractive: boolean;
     readonly compilationMode: "interpret" | "jit";
     /** Número de rules top-level registradas. */
     readonly size: number;
@@ -115,4 +143,4 @@ declare const HALT_HANDLER: {
 
 declare function createInvokerMiddleware<TCtx>(): RuleMiddleware<TCtx>;
 
-export { HALT_HANDLER, type IRuleEngine, type RuleDefinition, type RuleEngineConfig, type RuleEvaluationContext, type RuleEvaluationResult, type RuleHooks, type RuleMiddleware, type RuleRegisterError, type RuleRegisterResult, type SubRuleDefinition, createInvokerMiddleware, createRuleEngine };
+export { type AsyncInteractiveRuleSession, HALT_HANDLER, type IRuleEngine, type InteractiveRuleSession, type RuleDefinition, type RuleEngineConfig, type RuleEvaluationContext, type RuleEvaluationResult, type RuleHooks, type RuleMiddleware, type RuleRegisterError, type RuleRegisterResult, type SubRuleDefinition, createInvokerMiddleware, createRuleEngine };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Directive, RegisterWarning, RuleError, FrameCounters, HookFn, DirectiveResult } from '@statedelta-actions/core';
+import { Directive, RuleError, FrameCounters, RegisterWarning, HookFn, DirectiveResult } from '@statedelta-actions/core';
 import { IActionEngine } from '@statedelta-actions/actions';
 
 interface SubRuleDefinition<TCtx = unknown> {
@@ -69,11 +69,37 @@ interface RuleEngineConfig<TCtx = unknown> {
     /** Threshold de evaluate() calls para auto-promote em modo "auto". Default: 8. */
     autoJitThreshold?: number;
 }
+/**
+ * Sessão de avaliação de rules em modo interactive — retornada por
+ * `evaluateInteractive(ctx)`. Drena via `next()` igual a `InteractiveSession`
+ * do actions, mas o `done.value` final é `RuleEvaluationResult`.
+ */
+interface InteractiveRuleSession extends Iterator<unknown, RuleEvaluationResult, unknown> {
+    next(value?: unknown): IteratorResult<unknown, RuleEvaluationResult>;
+    return(): IteratorResult<unknown, RuleEvaluationResult>;
+    throw(err?: unknown): IteratorResult<unknown, RuleEvaluationResult>;
+    [Symbol.iterator](): InteractiveRuleSession;
+}
+interface AsyncInteractiveRuleSession extends AsyncIterator<unknown, RuleEvaluationResult, unknown> {
+    next(value?: unknown): Promise<IteratorResult<unknown, RuleEvaluationResult>>;
+    return(): Promise<IteratorResult<unknown, RuleEvaluationResult>>;
+    throw(err?: unknown): Promise<IteratorResult<unknown, RuleEvaluationResult>>;
+    [Symbol.asyncIterator](): AsyncInteractiveRuleSession;
+}
 interface IRuleEngine<TCtx = unknown> {
     register(rules: readonly RuleDefinition<TCtx>[]): RuleRegisterResult;
     unregister(id: string): boolean;
     evaluate(ctx: TCtx): RuleEvaluationResult;
     evaluateAsync(ctx: TCtx): Promise<RuleEvaluationResult>;
+    /**
+     * Avalia rules em modo interactive — retorna iterator drenável.
+     * Lança se nenhuma rule registrada é interactive transitivamente, ou se
+     * actionEngine não tem `interactive` configurado.
+     *
+     * Variante async (AsyncInteractiveRuleSession) é retornada quando alguma
+     * rule é async transitivamente OU algum hook é async.
+     */
+    evaluateInteractive(ctx: TCtx): InteractiveRuleSession | AsyncInteractiveRuleSession;
     beginBatch(): void;
     endBatch(): RuleRegisterResult;
     /** Executa fn dentro de um batch, com endBatch() garantido (inclusive em throw). */
@@ -84,6 +110,8 @@ interface IRuleEngine<TCtx = unknown> {
     has(id: string): boolean;
     readonly actionEngine: IActionEngine<TCtx>;
     readonly isAsync: boolean;
+    /** Alguma rule registrada é interactive transitivamente? Cached. */
+    readonly isInteractive: boolean;
     readonly compilationMode: "interpret" | "jit";
     /** Número de rules top-level registradas. */
     readonly size: number;
@@ -115,4 +143,4 @@ declare const HALT_HANDLER: {
 
 declare function createInvokerMiddleware<TCtx>(): RuleMiddleware<TCtx>;
 
-export { HALT_HANDLER, type IRuleEngine, type RuleDefinition, type RuleEngineConfig, type RuleEvaluationContext, type RuleEvaluationResult, type RuleHooks, type RuleMiddleware, type RuleRegisterError, type RuleRegisterResult, type SubRuleDefinition, createInvokerMiddleware, createRuleEngine };
+export { type AsyncInteractiveRuleSession, HALT_HANDLER, type IRuleEngine, type InteractiveRuleSession, type RuleDefinition, type RuleEngineConfig, type RuleEvaluationContext, type RuleEvaluationResult, type RuleHooks, type RuleMiddleware, type RuleRegisterError, type RuleRegisterResult, type SubRuleDefinition, createInvokerMiddleware, createRuleEngine };

package/dist/index.js

@@ -1,5 +1,9 @@
-import {analyzeSlots,RULE_SLOT_NAMES}from'@statedelta-actions/core';function M(r,t,e,i,o,h,b,s,u){if(s>=u)return o.push({ruleIndex:h,error:`maxSubRuleDepth (${u}) exceeded`}),i.errors++,false;for(let c=0;c<r.length;c++){let a=r[c];if(a.definition.when){let d;try{d=a.definition.when(t);}catch(g){o.push({ruleIndex:h,error:String(g)}),i.errors++;continue}if(!d)continue}if(a.actionId){let d=e.invoke(a.actionId,b);if(i.directivesApplied+=d.appliedCount,i.directivesSkipped+=d.skippedCount,i.errors+=d.errors.length,d.aborted)return  true}if(a.subRules&&a.subRules.length>0&&M(a.subRules,t,e,i,o,h,b,s+1,u))return  true}return  false}async function $(r,t,e,i,o,h,b,s,u){if(s>=u)return o.push({ruleIndex:h,error:`maxSubRuleDepth (${u}) exceeded`}),i.errors++,false;for(let c=0;c<r.length;c++){let a=r[c];if(a.definition.when){let d;try{d=a.definition.when(t);}catch(g){o.push({ruleIndex:h,error:String(g)}),i.errors++;continue}if(!d)continue}if(a.actionId){let d=await e.invokeAsync(a.actionId,b);if(i.directivesApplied+=d.appliedCount,i.directivesSkipped+=d.skippedCount,i.errors+=d.errors.length,d.aborted)return  true}if(a.subRules&&a.subRules.length>0&&await $(a.subRules,t,e,i,o,h,b,s+1,u))return  true}return  false}function V(){return r=>({$invoker:{ruleId:r.id,priority:r.priority,tags:r.tags??[]}})}function D(r,t,e,i){let o=i?Object.assign({},i):{};for(let h of r)Object.assign(o,h(t,e,o));return o}function L(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function H(r,t,e,i,o,h,b,s,u,c){return {success:r,aborted:t,abortedBy:e,matched:i,skipped:o,notMatched:h,errors:b,processedCount:s,totalCount:u,counters:c}}function W(r,t){let e=r.filledNames.has("beforeRule"),i=r.filledNames.has("afterRule"),o=r.filledNames.has("onRulesComplete"),h=e||i;return function(s,u,c,a,d){let g=s.length,m=[],n=[],A=[],v=[],p=L(),T=a.length>0,C=true,x=false,_,y=g;c.setContext(u);let k=h?{ctx:u,counters:p}:void 0;for(let f=0;f<g;f++){let R=s[f],E=R.definition.id;if(p.rulesEvaluated++,e)try{let l=d.beforeRule(R.definition,k);if(l==="skip"){n.push(E),p.rulesSkipped++;continue}if(l==="abort"){C=!1,x=!0,_="beforeRule",y=f+1;break}}catch(l){v.push({ruleIndex:f,error:`beforeRule: ${l}`}),p.errors++;}let w;try{w=R.definition.when(u);}catch(l){v.push({ruleIndex:f,error:String(l)}),A.push(E),p.errors++;continue}if(!w){A.push(E);continue}m.push(E),p.rulesMatched++;let S;if(T)try{S=D(a,R.definition,u);}catch(l){v.push({ruleIndex:f,error:`Middleware: ${l}`}),p.errors++;continue}if(R.actionId){let l=c.invoke(R.actionId,S);if(p.directivesApplied+=l.appliedCount,p.directivesSkipped+=l.skippedCount,p.errors+=l.errors.length,i)try{if(d.afterRule(R.definition,l,k)==="abort"){C=!1,x=!0,_="afterRule",y=f+1;break}}catch{}if(l.aborted){C=l.abortedBy==="halt",x=true,_=l.abortedBy,y=f+1;break}}if(R.subRules&&R.subRules.length>0&&M(R.subRules,u,c,p,v,f,S,0,t)){C=false,x=true,_="sub-rule",y=f+1;break}}let I=H(C,x,_,m,n,A,v,y,g,p);if(o)try{d.onRulesComplete(I);}catch{}return I}}function J(r,t){let e=r.filledNames.has("beforeRule"),i=r.filledNames.has("afterRule"),o=r.filledNames.has("onRulesComplete"),h=e||i;return async function(s,u,c,a,d){let g=s.length,m=[],n=[],A=[],v=[],p=L(),T=a.length>0,C=true,x=false,_,y=g;c.setContext(u);let k=h?{ctx:u,counters:p}:void 0;for(let f=0;f<g;f++){let R=s[f],E=R.definition.id;if(p.rulesEvaluated++,e)try{let l=await d.beforeRule(R.definition,k);if(l==="skip"){n.push(E),p.rulesSkipped++;continue}if(l==="abort"){C=!1,x=!0,_="beforeRule",y=f+1;break}}catch(l){v.push({ruleIndex:f,error:`beforeRule: ${l}`}),p.errors++;}let w;try{w=R.definition.when(u);}catch(l){v.push({ruleIndex:f,error:String(l)}),A.push(E),p.errors++;continue}if(!w){A.push(E);continue}m.push(E),p.rulesMatched++;let S;if(T)try{S=D(a,R.definition,u);}catch(l){v.push({ruleIndex:f,error:`Middleware: ${l}`}),p.errors++;continue}if(R.actionId){let l=await c.invokeAsync(R.actionId,S);if(p.directivesApplied+=l.appliedCount,p.directivesSkipped+=l.skippedCount,p.errors+=l.errors.length,i)try{if(await d.afterRule(R.definition,l,k)==="abort"){C=!1,x=!0,_="afterRule",y=f+1;break}}catch{}if(l.aborted){C=l.abortedBy==="halt",x=true,_=l.abortedBy,y=f+1;break}}if(R.subRules&&R.subRules.length>0&&await $(R.subRules,u,c,p,v,f,S,0,t)){C=false,x=true,_="sub-rule",y=f+1;break}}let I=H(C,x,_,m,n,A,v,y,g,p);if(o)try{await d.onRulesComplete(I);}catch{}return I}}function O(r,t,e){return t?J(r,e):W(r,e)}function B(r,t,e,i,o,h,b){r.push(`{const _er={success:${t},aborted:true,abortedBy:${e},matched,skipped,notMatched,errors,processedCount:${i},totalCount:${o},counters};`),h&&r.push(`try{${b}_hookOnComplete(_er);}catch(_e){}`),r.push("return _er;}");}function j(r,t,e,i){let{filledNames:o,asyncNames:h}=r,b=y=>o.has(y),s=y=>h.has(y)?"await ":"",u=b("beforeRule"),c=b("afterRule"),a=b("onRulesComplete"),d=s("beforeRule"),g=s("afterRule"),m=s("onRulesComplete"),n=[];n.push("const len=rules.length;"),n.push("const matched=[];const skipped=[];const notMatched=[];"),n.push("const errors=[];"),n.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),n.push("ae.setContext(ctx);"),(u||c)&&n.push("const evalCtx={ctx,counters};"),u&&n.push("const _hookBefore=hooks.beforeRule;"),c&&n.push("const _hookAfter=hooks.afterRule;"),a&&n.push("const _hookOnComplete=hooks.onRulesComplete;"),n.push("for(let i=0;i<len;i++){"),n.push("const stored=rules[i];"),n.push("const _rid=stored.definition.id;"),n.push("counters.rulesEvaluated++;"),u&&(n.push("try{"),n.push(`const _bd=${d}_hookBefore(stored.definition,evalCtx);`),n.push('if(_bd==="skip"){skipped.push(_rid);counters.rulesSkipped++;continue;}'),n.push('if(_bd==="abort")'),B(n,"false",'"beforeRule"',"i+1","len",a,m),n.push('}catch(_e){errors.push({ruleIndex:i,error:"beforeRule: "+_e});counters.errors++;}')),n.push("let ev;"),n.push("try{ev=stored.definition.when(ctx);}catch(_e){errors.push({ruleIndex:i,error:String(_e)});notMatched.push(_rid);counters.errors++;continue;}"),n.push("if(!ev){notMatched.push(_rid);continue;}"),n.push("matched.push(_rid);counters.rulesMatched++;"),t&&(n.push("let params;"),n.push('try{params=$.runMw(mw,stored.definition,ctx);}catch(_e){errors.push({ruleIndex:i,error:"Middleware: "+_e});counters.errors++;continue;}'));let A=t?",params":"",v=e?`await ae.invokeAsync(stored.actionId${A})`:`ae.invoke(stored.actionId${A})`;n.push("if(stored.actionId){"),n.push(`const ir=${v};`),n.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),c&&(n.push("try{"),n.push(`const _ad=${g}_hookAfter(stored.definition,ir,evalCtx);`),n.push('if(_ad==="abort")'),B(n,"false",'"afterRule"',"i+1","len",a,m),n.push("}catch(_e){}")),n.push("if(ir.aborted)"),B(n,'ir.abortedBy==="halt"',"ir.abortedBy","i+1","len",a,m),n.push("}");let p=t?"params":"undefined";n.push("if(stored.subRules&&stored.subRules.length>0){"),n.push(`if(${e?"await ":""}$.evalSub(stored.subRules,ctx,ae,counters,errors,i,${p},0,$.maxDepth))`),B(n,"false",'"sub-rule"',"i+1","len",a,m),n.push("}"),n.push("}"),n.push("const _r={success:true,aborted:false,abortedBy:undefined,matched,skipped,notMatched,errors,processedCount:len,totalCount:len,counters};"),a&&n.push(`try{${m}_hookOnComplete(_r);}catch(_e){}`),n.push("return _r;");let T=n.join(`
-`),C=e?"async ":"",x=new Function("rules","ctx","ae","mw","hooks","$",`"use strict";
-return(${C}()=>{
-${T}
-})();`),_={maxDepth:i};return _.evalSub=e?$:M,t&&(_.runMw=D),function(k,I,f,R,E){return x(k,I,f,R,E,_)}}function P(r){if(!r.id||typeof r.id!="string")return {ruleId:r.id??"(missing)",code:"INVALID_RULE",message:"rule must have a string id"};if(typeof r.priority!="number")return {ruleId:r.id,code:"INVALID_RULE",message:"rule must have a numeric priority"};if(typeof r.when!="function")return {ruleId:r.id,code:"INVALID_RULE",message:"rule must have a when function"};let t=Array.isArray(r.then)&&r.then.length>0,e=Array.isArray(r.rules)&&r.rules.length>0;return !t&&!e?{ruleId:r.id,code:"INVALID_RULE",message:"rule must have then or sub-rules (or both)"}:null}function U(r,t){let e=`${t}.${r.id??"(missing)"}`;if(!r.id||typeof r.id!="string")return {ruleId:e,code:"INVALID_RULE",message:"sub-rule must have a string id"};let i=Array.isArray(r.then)&&r.then.length>0,o=Array.isArray(r.rules)&&r.rules.length>0;return !i&&!o?{ruleId:e,code:"INVALID_RULE",message:"sub-rule must have then or sub-rules (or both)"}:null}var N=()=>{},F=class{_actionEngine;_middleware;_ruleHooks;_isAsync;_maxSubRuleDepth;_requestedMode;_ruleHookAnalysis;_ruleEvaluator;_mode;_maybeAutoPromote;_ruleRegistry=new Map;_rules=[];_batch=null;constructor(t){if(this._actionEngine=t.actionEngine,this._middleware=t.middleware??[],this._ruleHooks=t.ruleHooks??{},this._maxSubRuleDepth=t.maxSubRuleDepth??10,this._requestedMode=t.mode??"auto",this._ruleHookAnalysis=analyzeSlots(this._ruleHooks,RULE_SLOT_NAMES),this._isAsync=this._ruleHookAnalysis.hasAnyAsync||this._actionEngine.isAsync,this._requestedMode==="jit")this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=N;else if(this._ruleEvaluator=O(this._ruleHookAnalysis,this._isAsync,this._maxSubRuleDepth),this._mode="interpret",this._requestedMode==="auto"){let e=0,i=t.autoJitThreshold??8;this._maybeAutoPromote=()=>{++e>=i&&this._promote();};}else this._maybeAutoPromote=N;}get actionEngine(){return this._actionEngine}get isAsync(){return this._isAsync}get compilationMode(){return this._mode}get size(){return this._rules.length}has(t){return this._ruleRegistry.has(t)}register(t){let e=[],i=[],o=[];for(let s of t){let u=P(s);if(u){i.push(u);continue}if(this._ruleRegistry.has(s.id)){i.push({ruleId:s.id,code:"DUPLICATE_ID",message:`rule "${s.id}" is already registered`});continue}let c=`rule:${s.id}`,a=Array.isArray(s.then)&&s.then.length>0,d=a?c:"",g=Array.isArray(s.rules)&&s.rules.length>0?this._collectSubRules(c,s.rules,i,o):void 0,m={definition:s,actionId:d,priority:s.priority,subRules:g?.length?g:void 0};if(this._ruleRegistry.set(s.id,m),Q(this._rules,m),a){let n=["rule"];s.tags&&n.push(...s.tags),o.push({id:d,tags:n,directives:s.then,declarations:s.declarations});}e.push(s.id);}let h=[];if(o.length>0){let s=this._actionEngine.register(o);for(let u of s.errors){let c=this._actionIdToRuleId(u.actionId);i.push({ruleId:c??u.actionId,code:u.code??"ACTION_ERROR",message:u.error});}h=s.warnings;}let b={registered:e,errors:i,warnings:h};return this._batch&&(this._batch.registered.push(...e),this._batch.errors.push(...i),this._batch.warnings.push(...h)),b}unregister(t){let e=this._ruleRegistry.get(t);return e?(this._ruleRegistry.delete(t),X(this._rules,e),e.actionId&&this._actionEngine.unregister(e.actionId),e.subRules&&this._unregisterSubRules(e.subRules),true):false}beginBatch(){this._batch||(this._batch={depth:0,registered:[],errors:[],warnings:[]}),this._batch.depth++,this._actionEngine.beginBatch();}endBatch(){if(!this._batch||this._batch.depth<=0)throw new Error("endBatch() called without matching beginBatch()");this._batch.depth--;let t=this._actionEngine.endBatch();if(this._batch.depth>0)return {registered:[],errors:[],warnings:[]};let e=this._batch;for(let o of t.errors){let h=this._actionIdToRuleId(o.actionId);e.errors.push({ruleId:h??o.actionId,code:o.code??"ACTION_ERROR",message:o.error});}e.warnings.push(...t.warnings);let i={registered:e.registered,errors:e.errors,warnings:e.warnings};return this._batch=null,i}batch(t){this.beginBatch();try{return t(this),this.endBatch()}catch(e){try{this.endBatch();}catch{}throw e}}evaluate(t){if(this._isAsync)throw new Error("Cannot call evaluate() with async hooks. Use evaluateAsync() instead.");let e=this._ruleEvaluator(this._rules,t,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),e}async evaluateAsync(t){let e=await this._ruleEvaluator(this._rules,t,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),e}compile(){this._requestedMode!=="interpret"&&this._mode!=="jit"&&this._promote();}_collectSubRules(t,e,i,o){let h=[],b=this._actionIdToRuleId(t);for(let s of e){let u=U(s,b);if(u){i.push(u);continue}let c=`${t}.${s.id}`,a=`${b}.${s.id}`,d=Array.isArray(s.then)&&s.then.length>0,g=Array.isArray(s.rules)&&s.rules.length>0?this._collectSubRules(c,s.rules,i,o):void 0,m={definition:s,actionId:d?c:"",subRules:g?.length?g:void 0};if(d){let n=["rule"];s.tags&&n.push(...s.tags),o.push({id:c,tags:n,directives:s.then,declarations:s.declarations});}this._ruleRegistry.set(a,m),h.push(m);}return h}_unregisterSubRules(t){for(let e of t){if(e.actionId){let i=this._actionIdToRuleId(e.actionId);i&&this._ruleRegistry.delete(i),this._actionEngine.unregister(e.actionId);}e.subRules&&this._unregisterSubRules(e.subRules);}}_actionIdToRuleId(t){return t.startsWith("rule:")?t.slice(5):null}_promote(){this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=N;}_buildJitRule(){return j(this._ruleHookAnalysis,this._middleware.length>0,this._isAsync,this._maxSubRuleDepth)}};function K(r){return new F(r)}function Q(r,t){let e=0,i=r.length;for(;e<i;){let o=e+i>>>1;r[o].priority>=t.priority?e=o+1:i=o;}r.splice(e,0,t);}function X(r,t){let e=r.indexOf(t);return e===-1?false:(r.splice(e,1),true)}var Y={analyze:()=>({capabilities:["halt"],dependencies:[]}),execute:()=>({ok:true,halt:true})};export{Y as HALT_HANDLER,V as createInvokerMiddleware,K as createRuleEngine};
+import {analyzeSlots,RULE_SLOT_NAMES}from'@statedelta-actions/core';function B(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l=t.invoke(s.actionId,b);if(o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&B(s.subRules,r,t,o,c,d,b,R+1,a))return  true}return  false}async function F(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l=await t.invokeAsync(s.actionId,b);if(o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&await F(s.subRules,r,t,o,c,d,b,R+1,a))return  true}return  false}function Q(){return n=>({$invoker:{ruleId:n.id,priority:n.priority,tags:n.tags??[]}})}function $(n,r,t,o){let c=o?Object.assign({},o):{};for(let d of n)Object.assign(c,d(r,t,c));return c}function q(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function U(n,r,t,o,c,d,b,R,a,u){return {success:n,aborted:r,abortedBy:t,matched:o,skipped:c,notMatched:d,errors:b,processedCount:R,totalCount:a,counters:u}}function X(n,r){let t=n.filledNames.has("beforeRule"),o=n.filledNames.has("afterRule"),c=n.filledNames.has("onRulesComplete"),d=t||o;return function(R,a,u,s,l){let v=R.length,_=[],e=[],A=[],y=[],h=q(),S=s.length>0,I=true,C=false,g,m=v;u.setContext(a);let E=d?{ctx:a,counters:h}:void 0;for(let f=0;f<v;f++){let p=R[f],k=p.definition.id;if(h.rulesEvaluated++,t)try{let i=l.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(a);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(s,p.definition,a);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i=u.invoke(p.actionId,x);if(h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,o)try{if(l.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&B(p.subRules,a,u,h,y,f,x,0,r)){I=false,C=true,g="sub-rule",m=f+1;break}}let w=U(I,C,g,_,e,A,y,m,v,h);if(c)try{l.onRulesComplete(w);}catch{}return w}}function Y(n,r){let t=n.filledNames.has("beforeRule"),o=n.filledNames.has("afterRule"),c=n.filledNames.has("onRulesComplete"),d=t||o;return async function(R,a,u,s,l){let v=R.length,_=[],e=[],A=[],y=[],h=q(),S=s.length>0,I=true,C=false,g,m=v;u.setContext(a);let E=d?{ctx:a,counters:h}:void 0;for(let f=0;f<v;f++){let p=R[f],k=p.definition.id;if(h.rulesEvaluated++,t)try{let i=await l.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(a);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(s,p.definition,a);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i=await u.invokeAsync(p.actionId,x);if(h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,o)try{if(await l.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&await F(p.subRules,a,u,h,y,f,x,0,r)){I=false,C=true,g="sub-rule",m=f+1;break}}let w=U(I,C,g,_,e,A,y,m,v,h);if(c)try{await l.onRulesComplete(w);}catch{}return w}}function O(n,r,t){return r?Y(n,t):X(n,t)}function G(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function V(n,r,t,o,c,d,b,R,a,u){return {success:n,aborted:r,abortedBy:t,matched:o,skipped:c,notMatched:d,errors:b,processedCount:R,totalCount:a,counters:u}}function Z(n){let r=n.filledNames.has("beforeRule"),t=n.filledNames.has("afterRule"),o=n.filledNames.has("onRulesComplete"),c=r||t;return function*(b,R,a,u,s,l){let v=b.length,_=[],e=[],A=[],y=[],h=G(),S=u.length>0,I=true,C=false,g,m=v;a.setContext(R);let E=c?{ctx:R,counters:h}:void 0;for(let f=0;f<v;f++){let p=b[f],k=p.definition.id;if(h.rulesEvaluated++,r)try{let i=s.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(R);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(u,p.definition,R);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i;if(p.isInteractive?i=yield*a.invokeInteractive(p.actionId,x):i=a.invoke(p.actionId,x),h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,t)try{if(s.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&(yield*D(p.subRules,R,a,h,y,f,x,0,l))){I=false,C=true,g="sub-rule",m=f+1;break}}let w=V(I,C,g,_,e,A,y,m,v,h);if(o)try{s.onRulesComplete(w);}catch{}return w}}function ee(n){let r=n.filledNames.has("beforeRule"),t=n.filledNames.has("afterRule"),o=n.filledNames.has("onRulesComplete"),c=r||t;return async function*(b,R,a,u,s,l){let v=b.length,_=[],e=[],A=[],y=[],h=G(),S=u.length>0,I=true,C=false,g,m=v;a.setContext(R);let E=c?{ctx:R,counters:h}:void 0;for(let f=0;f<v;f++){let p=b[f],k=p.definition.id;if(h.rulesEvaluated++,r)try{let i=await s.beforeRule(p.definition,E);if(i==="skip"){e.push(k),h.rulesSkipped++;continue}if(i==="abort"){I=!1,C=!0,g="beforeRule",m=f+1;break}}catch(i){y.push({ruleIndex:f,error:`beforeRule: ${i}`}),h.errors++;}let T;try{T=p.definition.when(R);}catch(i){y.push({ruleIndex:f,error:String(i)}),A.push(k),h.errors++;continue}if(!T){A.push(k);continue}_.push(k),h.rulesMatched++;let x;if(S)try{x=$(u,p.definition,R);}catch(i){y.push({ruleIndex:f,error:`Middleware: ${i}`}),h.errors++;continue}if(p.actionId){let i;if(p.isInteractive?i=yield*a.invokeInteractive(p.actionId,x):p.isAsync?i=await a.invokeAsync(p.actionId,x):i=a.invoke(p.actionId,x),h.directivesApplied+=i.appliedCount,h.directivesSkipped+=i.skippedCount,h.errors+=i.errors.length,t)try{if(await s.afterRule(p.definition,i,E)==="abort"){I=!1,C=!0,g="afterRule",m=f+1;break}}catch{}if(i.aborted){I=i.abortedBy==="halt",C=true,g=i.abortedBy,m=f+1;break}}if(p.subRules&&p.subRules.length>0&&(yield*N(p.subRules,R,a,h,y,f,x,0,l))){I=false,C=true,g="sub-rule",m=f+1;break}}let w=V(I,C,g,_,e,A,y,m,v,h);if(o)try{await s.onRulesComplete(w);}catch{}return w}}function*D(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l;if(s.isInteractive?l=yield*t.invokeInteractive(s.actionId,b):l=t.invoke(s.actionId,b),o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&(yield*D(s.subRules,r,t,o,c,d,b,R+1,a)))return  true}return  false}async function*N(n,r,t,o,c,d,b,R,a){if(R>=a)return c.push({ruleIndex:d,error:`maxSubRuleDepth (${a}) exceeded`}),o.errors++,false;for(let u=0;u<n.length;u++){let s=n[u];if(s.definition.when){let l;try{l=s.definition.when(r);}catch(v){c.push({ruleIndex:d,error:String(v)}),o.errors++;continue}if(!l)continue}if(s.actionId){let l;if(s.isInteractive?l=yield*t.invokeInteractive(s.actionId,b):s.isAsync?l=await t.invokeAsync(s.actionId,b):l=t.invoke(s.actionId,b),o.directivesApplied+=l.appliedCount,o.directivesSkipped+=l.skippedCount,o.errors+=l.errors.length,l.aborted)return  true}if(s.subRules&&s.subRules.length>0&&(yield*N(s.subRules,r,t,o,c,d,b,R+1,a)))return  true}return  false}function W(n,r){return r?ee(n):Z(n)}function M(n,r,t,o,c,d,b){n.push(`{const _er={success:${r},aborted:true,abortedBy:${t},matched,skipped,notMatched,errors,processedCount:${o},totalCount:${c},counters};`),d&&n.push(`try{${b}_hookOnComplete(_er);}catch(_e){}`),n.push("return _er;}");}function J(n,r,t,o){let{filledNames:c,asyncNames:d}=n,b=m=>c.has(m),R=m=>d.has(m)?"await ":"",a=b("beforeRule"),u=b("afterRule"),s=b("onRulesComplete"),l=R("beforeRule"),v=R("afterRule"),_=R("onRulesComplete"),e=[];e.push("const len=rules.length;"),e.push("const matched=[];const skipped=[];const notMatched=[];"),e.push("const errors=[];"),e.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),e.push("ae.setContext(ctx);"),(a||u)&&e.push("const evalCtx={ctx,counters};"),a&&e.push("const _hookBefore=hooks.beforeRule;"),u&&e.push("const _hookAfter=hooks.afterRule;"),s&&e.push("const _hookOnComplete=hooks.onRulesComplete;"),e.push("for(let i=0;i<len;i++){"),e.push("const stored=rules[i];"),e.push("const _rid=stored.definition.id;"),e.push("counters.rulesEvaluated++;"),a&&(e.push("try{"),e.push(`const _bd=${l}_hookBefore(stored.definition,evalCtx);`),e.push('if(_bd==="skip"){skipped.push(_rid);counters.rulesSkipped++;continue;}'),e.push('if(_bd==="abort")'),M(e,"false",'"beforeRule"',"i+1","len",s,_),e.push('}catch(_e){errors.push({ruleIndex:i,error:"beforeRule: "+_e});counters.errors++;}')),e.push("let ev;"),e.push("try{ev=stored.definition.when(ctx);}catch(_e){errors.push({ruleIndex:i,error:String(_e)});notMatched.push(_rid);counters.errors++;continue;}"),e.push("if(!ev){notMatched.push(_rid);continue;}"),e.push("matched.push(_rid);counters.rulesMatched++;"),r&&(e.push("let params;"),e.push('try{params=$.runMw(mw,stored.definition,ctx);}catch(_e){errors.push({ruleIndex:i,error:"Middleware: "+_e});counters.errors++;continue;}'));let A=r?",params":"",y=t?`await ae.invokeAsync(stored.actionId${A})`:`ae.invoke(stored.actionId${A})`;e.push("if(stored.actionId){"),e.push(`const ir=${y};`),e.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),u&&(e.push("try{"),e.push(`const _ad=${v}_hookAfter(stored.definition,ir,evalCtx);`),e.push('if(_ad==="abort")'),M(e,"false",'"afterRule"',"i+1","len",s,_),e.push("}catch(_e){}")),e.push("if(ir.aborted)"),M(e,'ir.abortedBy==="halt"',"ir.abortedBy","i+1","len",s,_),e.push("}");let h=r?"params":"undefined";e.push("if(stored.subRules&&stored.subRules.length>0){"),e.push(`if(${t?"await ":""}$.evalSub(stored.subRules,ctx,ae,counters,errors,i,${h},0,$.maxDepth))`),M(e,"false",'"sub-rule"',"i+1","len",s,_),e.push("}"),e.push("}"),e.push("const _r={success:true,aborted:false,abortedBy:undefined,matched,skipped,notMatched,errors,processedCount:len,totalCount:len,counters};"),s&&e.push(`try{${_}_hookOnComplete(_r);}catch(_e){}`),e.push("return _r;");let S=e.join(`
+`),I=t?"async ":"",C=new Function("rules","ctx","ae","mw","hooks","$",`"use strict";
+return(${I}()=>{
+${S}
+})();`),g={maxDepth:o};return g.evalSub=t?F:B,r&&(g.runMw=$),function(E,w,f,p,k){return C(E,w,f,p,k,g)}}function P(n,r,t,o){let{filledNames:c,asyncNames:d}=n,b=g=>c.has(g),R=g=>d.has(g)?"await ":"",a=b("beforeRule"),u=b("afterRule"),s=b("onRulesComplete"),l=R("beforeRule"),v=R("afterRule"),_=R("onRulesComplete"),e=[];e.push("const len=rules.length;"),e.push("const matched=[];const skipped=[];const notMatched=[];"),e.push("const errors=[];"),e.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),e.push("ae.setContext(ctx);"),(a||u)&&e.push("const evalCtx={ctx,counters};"),a&&e.push("const _hookBefore=hooks.beforeRule;"),u&&e.push("const _hookAfter=hooks.afterRule;"),s&&e.push("const _hookOnComplete=hooks.onRulesComplete;"),e.push("for(let i=0;i<len;i++){"),e.push("const stored=rules[i];"),e.push("const _rid=stored.definition.id;"),e.push("counters.rulesEvaluated++;"),a&&(e.push("try{"),e.push(`const _bd=${l}_hookBefore(stored.definition,evalCtx);`),e.push('if(_bd==="skip"){skipped.push(_rid);counters.rulesSkipped++;continue;}'),e.push('if(_bd==="abort")'),M(e,"false",'"beforeRule"',"i+1","len",s,_),e.push('}catch(_e){errors.push({ruleIndex:i,error:"beforeRule: "+_e});counters.errors++;}')),e.push("let ev;"),e.push("try{ev=stored.definition.when(ctx);}catch(_e){errors.push({ruleIndex:i,error:String(_e)});notMatched.push(_rid);counters.errors++;continue;}"),e.push("if(!ev){notMatched.push(_rid);continue;}"),e.push("matched.push(_rid);counters.rulesMatched++;"),r&&(e.push("let params;"),e.push('try{params=$.runMw(mw,stored.definition,ctx);}catch(_e){errors.push({ruleIndex:i,error:"Middleware: "+_e});counters.errors++;continue;}'));let A=r?",params":"";e.push("if(stored.actionId){"),e.push("let ir;"),e.push("if(stored.isInteractive){"),e.push(`ir=yield* ae.invokeInteractive(stored.actionId${A});`),e.push("}else "),t?(e.push("if(stored.isAsync){"),e.push(`ir=await ae.invokeAsync(stored.actionId${A});`),e.push("}else{")):e.push("{"),e.push(`ir=ae.invoke(stored.actionId${A});`),e.push("}"),e.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),u&&(e.push("try{"),e.push(`const _ad=${v}_hookAfter(stored.definition,ir,evalCtx);`),e.push('if(_ad==="abort")'),M(e,"false",'"afterRule"',"i+1","len",s,_),e.push("}catch(_e){}")),e.push("if(ir.aborted)"),M(e,'ir.abortedBy==="halt"',"ir.abortedBy","i+1","len",s,_),e.push("}");let y=r?"params":"undefined";e.push("if(stored.subRules&&stored.subRules.length>0){"),e.push(`if(yield* $.evalSubInt(stored.subRules,ctx,ae,counters,errors,i,${y},0,$.maxDepth))`),M(e,"false",'"sub-rule"',"i+1","len",s,_),e.push("}"),e.push("}"),e.push("const _r={success:true,aborted:false,abortedBy:undefined,matched,skipped,notMatched,errors,processedCount:len,totalCount:len,counters};"),s&&e.push(`try{${_}_hookOnComplete(_r);}catch(_e){}`),e.push("return _r;");let h=e.join(`
+`),S=t?"async function*()":"function*()",I=new Function("rules","ctx","ae","mw","hooks","$",`"use strict";
+return(${S}{
+${h}
+})();`),C={maxDepth:o};return C.evalSubInt=t?N:D,r&&(C.runMw=$),function(m,E,w,f,p){return I(m,E,w,f,p,C)}}function z(n){if(!n.id||typeof n.id!="string")return {ruleId:n.id??"(missing)",code:"INVALID_RULE",message:"rule must have a string id"};if(typeof n.priority!="number")return {ruleId:n.id,code:"INVALID_RULE",message:"rule must have a numeric priority"};if(typeof n.when!="function")return {ruleId:n.id,code:"INVALID_RULE",message:"rule must have a when function"};let r=Array.isArray(n.then)&&n.then.length>0,t=Array.isArray(n.rules)&&n.rules.length>0;return !r&&!t?{ruleId:n.id,code:"INVALID_RULE",message:"rule must have then or sub-rules (or both)"}:null}function K(n,r){let t=`${r}.${n.id??"(missing)"}`;if(!n.id||typeof n.id!="string")return {ruleId:t,code:"INVALID_RULE",message:"sub-rule must have a string id"};let o=Array.isArray(n.then)&&n.then.length>0,c=Array.isArray(n.rules)&&n.rules.length>0;return !o&&!c?{ruleId:t,code:"INVALID_RULE",message:"sub-rule must have then or sub-rules (or both)"}:null}var L=()=>{},j=class{_actionEngine;_middleware;_ruleHooks;_maxSubRuleDepth;_requestedMode;_ruleHookAnalysis;_hasAnyInteractiveRule=false;_isAsync;_ruleEvaluator;_mode;_maybeAutoPromote;_interactiveEvaluator=null;_interactiveEvaluatorIsAsync=false;_ruleRegistry=new Map;_rules=[];_batch=null;constructor(r){if(this._actionEngine=r.actionEngine,this._middleware=r.middleware??[],this._ruleHooks=r.ruleHooks??{},this._maxSubRuleDepth=r.maxSubRuleDepth??10,this._requestedMode=r.mode??"auto",this._ruleHookAnalysis=analyzeSlots(this._ruleHooks,RULE_SLOT_NAMES),this._isAsync=this._ruleHookAnalysis.hasAnyAsync,this._requestedMode==="jit")this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=L;else if(this._ruleEvaluator=O(this._ruleHookAnalysis,this._isAsync,this._maxSubRuleDepth),this._mode="interpret",this._requestedMode==="auto"){let t=0,o=r.autoJitThreshold??8;this._maybeAutoPromote=()=>{++t>=o&&this._promote();};}else this._maybeAutoPromote=L;}get actionEngine(){return this._actionEngine}get isAsync(){return this._isAsync}get isInteractive(){return this._hasAnyInteractiveRule}get compilationMode(){return this._mode}get size(){return this._rules.length}has(r){return this._ruleRegistry.has(r)}register(r){let t=[],o=[],c=[],d=[];for(let u of r){let s=z(u);if(s){t.push(s);continue}if(this._ruleRegistry.has(u.id)||c.some(y=>y.id===u.id)){t.push({ruleId:u.id,code:"DUPLICATE_ID",message:`rule "${u.id}" is already registered`});continue}let l=`rule:${u.id}`,v=Array.isArray(u.then)&&u.then.length>0,_=v?l:"",e=Array.isArray(u.rules)&&u.rules.length>0?this._collectSubRules(l,u.rules,t,o,d):void 0,A={definition:u,actionId:_,priority:u.priority,subRules:e?.length?e:void 0,isAsync:false,isInteractive:false};if(v){let y=["rule"];u.tags&&y.push(...u.tags),o.push({id:_,tags:y,directives:u.then,declarations:u.declarations});}c.push({id:u.id,stored:A});}let b=[];if(o.length>0){let u=this._actionEngine.register(o);for(let s of u.errors){let l=this._actionIdToRuleId(s.actionId);t.push({ruleId:l??s.actionId,code:s.code??"ACTION_ERROR",message:s.error});}b=u.warnings;}let R=[];for(let{id:u,stored:s}of c)this._ruleRegistry.set(u,s),se(this._rules,s),R.push(u);for(let{qualifiedId:u,stored:s}of d)this._ruleRegistry.set(u,s);let a={registered:R,errors:t,warnings:b};return this._batch?(this._batch.registered.push(...R),this._batch.errors.push(...t),this._batch.warnings.push(...b)):R.length>0&&this._refreshRuleFlags(),a}unregister(r){let t=this._ruleRegistry.get(r);return t?(this._ruleRegistry.delete(r),ie(this._rules,t),t.actionId&&this._actionEngine.unregister(t.actionId),t.subRules&&this._unregisterSubRules(t.subRules),this._refreshRuleFlags(),true):false}beginBatch(){this._batch||(this._batch={depth:0,registered:[],errors:[],warnings:[]}),this._batch.depth++,this._actionEngine.beginBatch();}endBatch(){if(!this._batch||this._batch.depth<=0)throw new Error("endBatch() called without matching beginBatch()");this._batch.depth--;let r=this._actionEngine.endBatch();if(this._batch.depth>0)return {registered:[],errors:[],warnings:[]};let t=this._batch;for(let c of r.errors){let d=this._actionIdToRuleId(c.actionId);t.errors.push({ruleId:d??c.actionId,code:c.code??"ACTION_ERROR",message:c.error});}t.warnings.push(...r.warnings);let o={registered:t.registered,errors:t.errors,warnings:t.warnings};return this._batch=null,this._refreshRuleFlags(),o}batch(r){this.beginBatch();try{return r(this),this.endBatch()}catch(t){try{this.endBatch();}catch{}throw t}}evaluate(r){if(this._hasAnyInteractiveRule)throw new Error("Cannot call evaluate() \u2014 at least one rule is interactive (transitively). Use evaluateInteractive() instead.");if(this._isAsync)throw new Error("Cannot call evaluate() with async hooks or async rules. Use evaluateAsync() instead.");let t=this._ruleEvaluator(this._rules,r,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),t}async evaluateAsync(r){if(this._hasAnyInteractiveRule)throw new Error("Cannot call evaluateAsync() \u2014 at least one rule is interactive (transitively). Use evaluateInteractive() instead.");let t=await this._ruleEvaluator(this._rules,r,this._actionEngine,this._middleware,this._ruleHooks);return this._maybeAutoPromote(),t}evaluateInteractive(r){if(!this._hasAnyInteractiveRule)throw new Error("Cannot call evaluateInteractive() \u2014 no registered rule is interactive (transitively). Use evaluate() or evaluateAsync() instead.");return (this._interactiveEvaluator===null||this._interactiveEvaluatorIsAsync!==this._isAsync)&&(this._interactiveEvaluator=this._mode==="jit"?P(this._ruleHookAnalysis,this._middleware.length>0,this._isAsync,this._maxSubRuleDepth):W(this._ruleHookAnalysis,this._isAsync),this._interactiveEvaluatorIsAsync=this._isAsync),this._interactiveEvaluator(this._rules,r,this._actionEngine,this._middleware,this._ruleHooks,this._maxSubRuleDepth)}compile(){this._requestedMode!=="interpret"&&this._mode!=="jit"&&this._promote();}_collectSubRules(r,t,o,c,d){let b=[],R=this._actionIdToRuleId(r);for(let a of t){let u=K(a,R);if(u){o.push(u);continue}let s=`${r}.${a.id}`,l=`${R}.${a.id}`,v=Array.isArray(a.then)&&a.then.length>0,_=Array.isArray(a.rules)&&a.rules.length>0?this._collectSubRules(s,a.rules,o,c,d):void 0,e={definition:a,actionId:v?s:"",subRules:_?.length?_:void 0,isAsync:false,isInteractive:false};if(v){let A=["rule"];a.tags&&A.push(...a.tags),c.push({id:s,tags:A,directives:a.then,declarations:a.declarations});}d.push({qualifiedId:l,stored:e}),b.push(e);}return b}_unregisterSubRules(r){for(let t of r){if(t.actionId){let o=this._actionIdToRuleId(t.actionId);o&&this._ruleRegistry.delete(o),this._actionEngine.unregister(t.actionId);}t.subRules&&this._unregisterSubRules(t.subRules);}}_actionIdToRuleId(r){return r.startsWith("rule:")?r.slice(5):null}_refreshRuleFlags(){let r=false,t=false,o=d=>{if(d.actionId?(d.isAsync=this._actionEngine.isActionAsync(d.actionId)??false,d.isInteractive=this._actionEngine.isActionInteractive(d.actionId)??false,d.isAsync&&(r=true),d.isInteractive&&(t=true)):(d.isAsync=false,d.isInteractive=false),d.subRules)for(let b of d.subRules)o(b);};for(let d of this._rules)o(d);this._hasAnyInteractiveRule=t;let c=this._ruleHookAnalysis.hasAnyAsync||r;c!==this._isAsync?(this._isAsync=c,this._rebuildEvaluator()):this._isAsync=c;}_rebuildEvaluator(){this._mode==="jit"?this._ruleEvaluator=this._buildJitRule():this._ruleEvaluator=O(this._ruleHookAnalysis,this._isAsync,this._maxSubRuleDepth);}_promote(){this._ruleEvaluator=this._buildJitRule(),this._mode="jit",this._maybeAutoPromote=L;}_buildJitRule(){return J(this._ruleHookAnalysis,this._middleware.length>0,this._isAsync,this._maxSubRuleDepth)}};function ne(n){return new j(n)}function se(n,r){let t=0,o=n.length;for(;t<o;){let c=t+o>>>1;n[c].priority>=r.priority?t=c+1:o=c;}n.splice(t,0,r);}function ie(n,r){let t=n.indexOf(r);return t===-1?false:(n.splice(t,1),true)}var oe={analyze:()=>({capabilities:["halt"],dependencies:[]}),execute:()=>({ok:true,halt:true})};export{oe as HALT_HANDLER,Q as createInvokerMiddleware,ne as createRuleEngine};

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@statedelta-actions/rules",
-  "version": "0.3.0",
+  "version": "0.5.1",
   "description": "Rule evaluation engine with JIT-optimized sequential evaluation and sub-rules",
+  "keywords": [
+    "statedelta",
+    "rule-engine",
+    "jit",
+    "conditional-evaluation",
+    "sub-rules"
+  ],
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -15,11 +22,12 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "dependencies": {
-    "@statedelta-actions/core": "0.3.0",
-    "@statedelta-actions/actions": "0.3.0"
+    "@statedelta-actions/actions": "0.6.0",
+    "@statedelta-actions/core": "0.5.1"
   },
   "devDependencies": {
     "apex-store": "0.4.0"
@@ -31,6 +39,10 @@
     "url": "https://github.com/andersondrosa/statedelta-actions.git",
     "directory": "packages/rules"
   },
+  "homepage": "https://github.com/andersondrosa/statedelta-actions/tree/main/packages/rules#readme",
+  "bugs": {
+    "url": "https://github.com/andersondrosa/statedelta-actions/issues"
+  },
   "sideEffects": false,
   "engines": {
     "node": ">=18"