@statedelta-actions/events 0.1.0

package/README.md

@@ -0,0 +1,251 @@
+# EventProcessor — Eventos como Actions Deferidas
+
+> **Módulo:** `events/`
+> **Escopo:** Dispatcher de listeners sobre o ActionEngine. Listeners reagem a eventos nomeados, executando diretivas via hidden actions.
+> **Dependências:** `core/` (tipos, slot analysis), `actions/` (IActionEngine). Zero dependência de `rules/`.
+>
+> Para arquitetura interna, pipelines e fluxos, ver [`docs/ARCHITECTURE.md`](./docs/ARCHITECTURE.md).
+> Para decisões arquiteturais, ver [`docs/DECISIONS.md`](./docs/DECISIONS.md).
+
+---
+
+## O que é
+
+O `EventProcessor` é um dispatcher de listeners sobre o ActionEngine. Quando o consumer emite `{ event: "save" }`, o processor resolve quais listeners escutam "save", monta params, e delega a execução pro ActionEngine via `invoke()`.
+
+**Evento = action deferida.** A única diferença entre action e evento é **quando** executa. A infraestrutura é idêntica — registro, params, directives, invoke. O EventProcessor não executa diretivas ele mesmo.
+
+**Listeners viram hidden actions.** Cada listener registrado cria uma action `event:{id}` no ActionEngine. Isso significa que listeners coexistem no mesmo grafo com actions diretas e rules (`rule:{id}`). O analyzer valida tudo junto — ciclos, capabilities, composition control.
+
+**Sem condição, sem cascade.** Listeners não têm `when()` (match por nome, não por expressão) nem sub-rules (dispatch direto, sem recursão). Chegou evento, matched, executa.
+
+**Halt é scoped ao evento.** Halt em um listener para apenas os listeners daquele evento. O próximo evento na fila continua normalmente.
+
+---
+
+## EventListenerDefinition — O que o consumer fornece
+
+```typescript
+interface EventListenerDefinition<TCtx> {
+  readonly id: string;
+  readonly priority: number;
+  readonly on: string | string[];
+  readonly then: readonly Directive<TCtx>[];
+  readonly tags?: readonly string[];
+  readonly declarations?: Record<string, unknown>;
+  readonly metadata?: Record<string, unknown>;
+}
+```
+
+| Campo | Semântica |
+|-------|-----------|
+| `id` | Identificador único do listener |
+| `priority` | Ordem de execução (desc — maior executa primeiro) |
+| `on` | Evento(s) que o listener escuta. String ou array |
+| `then` | Diretivas executadas quando matched |
+| `tags` | Tags extras (além de `"event"` que é injetado automaticamente) |
+| `declarations` | Contratos públicos passados pro grafo (trust boundaries) |
+| `metadata` | Dados opacos armazenados na definition |
+
+---
+
+## API
+
+### Construction
+
+```typescript
+import { createEventProcessor } from "@statedelta-actions/events";
+
+const ep = createEventProcessor({
+  actionEngine,                // IActionEngine — obrigatório
+  eventHooks: { ... },         // EventHooks — opcional
+  middleware: [ ... ],         // EventMiddleware[] — opcional
+  mode: "auto",               // "interpret" | "jit" | "auto" (default: "auto")
+  autoJitThreshold: 8,        // Chamadas antes de auto-promote (default: 8)
+});
+```
+
+### Registration
+
+```typescript
+// Registrar listeners
+const result = ep.register([
+  {
+    id: "on-save",
+    priority: 100,
+    on: "save",
+    then: [{ type: "state", target: "hp", value: 10 }],
+  },
+  {
+    id: "on-damage",
+    priority: 200,
+    on: ["damage", "combat"],   // multi-event
+    then: [{ type: "state", target: "shield", value: -1 }],
+  },
+]);
+
+// result: { registered: string[], errors: EventRegisterError[], warnings: RegisterWarning[] }
+
+// Remover listener
+ep.unregister("on-save");  // true se existia, false se não
+```
+
+### Processing
+
+```typescript
+// Sync (throws se isAsync = true)
+const result = ep.processEvents(
+  [{ event: "save" }, { event: "damage", data: { amount: 10 } }],
+  ctx,
+);
+
+// Async (sempre funciona)
+const result = await ep.processEventsAsync(
+  [{ event: "save" }],
+  ctx,
+);
+```
+
+### Batch
+
+```typescript
+ep.beginBatch();
+ep.register(listeners1);
+ep.register(listeners2);
+const result = ep.endBatch();
+// Suporta nesting — inner endBatch é no-op, outer processa tudo
+```
+
+### Compilation
+
+```typescript
+// Força promoção pra JIT (no-op se já em JIT ou mode = "interpret")
+ep.compile();
+
+// Consultar modo atual
+ep.compilationMode;  // "interpret" | "jit"
+ep.isAsync;          // true se hooks ou actionEngine são async
+```
+
+---
+
+## Hooks — EventHooks
+
+```typescript
+interface EventHooks<TCtx> {
+  beforeEvent?: (listener, evalCtx) => "skip" | "abort" | void;
+  afterEvent?:  (listener, result, evalCtx) => "abort" | void;
+  onEventsComplete?: (result) => void;
+}
+```
+
+| Hook | Quando | Retornos |
+|------|--------|----------|
+| `beforeEvent` | Antes de cada listener | `"skip"` pula listener, `"abort"` para evento |
+| `afterEvent` | Após invoke de cada listener | `"abort"` para evento |
+| `onEventsComplete` | Após processar todos os eventos | fire-and-forget |
+
+Hooks ausentes não têm custo — nem no interpreter nem no JIT.
+
+### Exemplo: disable via hook
+
+```typescript
+const disabled = new Set<string>();
+
+const ep = createEventProcessor({
+  actionEngine,
+  eventHooks: {
+    beforeEvent: (listener) => {
+      if (disabled.has(listener.id)) return "skip";
+    },
+  },
+});
+
+disabled.add("on-save");   // "disable"
+disabled.delete("on-save"); // "enable"
+```
+
+---
+
+## Middleware
+
+```typescript
+type EventMiddleware<TCtx> = (
+  listener: EventListenerDefinition<TCtx>,
+  ctx: TCtx,
+  params: Record<string, unknown>,
+) => Record<string, unknown>;
+```
+
+Middleware é pipeline de **enriquecimento de dados**. Não afeta fluxo de controle (sem "skip", sem "abort"). Cada middleware recebe e retorna params.
+
+```typescript
+const ep = createEventProcessor({
+  actionEngine,
+  middleware: [
+    (listener, ctx, params) => ({
+      ...params,
+      timestamp: Date.now(),
+      source: listener.id,
+    }),
+  ],
+});
+```
+
+Sem middleware, `$event` chega direto no scope da action. Com middleware, `$event` entra como base e o middleware enriquece.
+
+---
+
+## $event Injection
+
+Todo listener recebe automaticamente no scope:
+
+```typescript
+{ $event: { type: "save", data: eventData } }
+```
+
+Acessível dentro de handlers via `frame.scope.$event`.
+
+---
+
+## Results
+
+```typescript
+interface EventProcessingResult {
+  readonly eventResults: readonly SingleEventResult[];
+  readonly unprocessedEvents: readonly string[];   // eventos sem listeners
+  readonly errors: readonly RuleError[];
+  readonly counters: FrameCounters;
+  readonly totalEvents: number;
+  readonly processedEvents: number;
+}
+
+interface SingleEventResult {
+  readonly event: string;
+  readonly matched: readonly number[];
+  readonly skipped: readonly number[];
+  readonly notMatched: readonly number[];
+  readonly errors: readonly RuleError[];
+  readonly halted: boolean;
+  readonly haltedBy?: string;
+  readonly counters: FrameCounters;
+}
+
+interface EventRegisterResult {
+  readonly registered: readonly string[];
+  readonly errors: readonly EventRegisterError[];
+  readonly warnings: readonly RegisterWarning[];
+}
+```
+
+---
+
+## Compilation — 3 Modos
+
+| Modo | Comportamento |
+|------|--------------|
+| `"interpret"` | Interpreter sempre. Sem promoção |
+| `"jit"` | JIT imediato no constructor |
+| `"auto"` (default) | Interpreter inicial. Promove pra JIT após `autoJitThreshold` chamadas |
+
+O JIT gera código equivalente ao interpreter via `new Function()`, eliminando branches de hooks/middleware ausentes em compile-time. O consumer não precisa se preocupar — `"auto"` é o default e promove transparentemente.

package/dist/index.cjs

@@ -0,0 +1,5 @@
+'use strict';var core=require('@statedelta-actions/core');function L(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function O(e,s){e.rulesEvaluated+=s.rulesEvaluated,e.rulesMatched+=s.rulesMatched,e.rulesSkipped+=s.rulesSkipped,e.directivesApplied+=s.directivesApplied,e.directivesSkipped+=s.directivesSkipped,e.subRunsCreated+=s.subRunsCreated,e.errors+=s.errors;}function M(e,s,r,i){let o=i?Object.assign({},i):{};for(let d of e)Object.assign(o,d(s,r,o));return o}function q(e){let s=e.filledNames.has("beforeEvent"),r=e.filledNames.has("afterEvent"),i=e.filledNames.has("onEventsComplete");return function(d,g,n,a,u,m){let _=[],b=[],t=[],l=L(),h=u.length>0;a.setContext(n);for(let p of g){let y=d.get(p.event);if(!y||y.length===0){b.push(p.event);continue}let x=[],R=[],S=[],C=[],c=L(),k=false,T,D={ctx:n,counters:c,event:p.event},N={$event:{type:p.event,data:p.data}};for(let v=0;v<y.length;v++){let I=y[v];if(c.rulesEvaluated++,s)try{let f=m.beforeEvent(I.definition,D);if(f==="skip"){R.push(v),c.rulesSkipped++;continue}if(f==="abort")break}catch(f){C.push({ruleIndex:v,error:`beforeEvent: ${f}`}),c.errors++;}x.push(v),c.rulesMatched++;let w;if(h)try{w=M(u,I.definition,n,N);}catch(f){C.push({ruleIndex:v,error:`Middleware: ${f}`}),c.errors++;continue}else w=N;let E=a.invoke(I.actionId,w);if(c.directivesApplied+=E.appliedCount,c.directivesSkipped+=E.skippedCount,c.errors+=E.errors.length,r)try{if(m.afterEvent(I.definition,E,D)==="abort")break}catch{}if(E.aborted){k=true,T=E.abortedBy;break}}t.push(...C),O(l,c),_.push({event:p.event,matched:x,skipped:R,notMatched:S,errors:C,halted:k,haltedBy:T,counters:c});}let A={eventResults:_,unprocessedEvents:b,errors:t,counters:l,totalEvents:g.length,processedEvents:_.length};if(i)try{m.onEventsComplete(A);}catch{}return A}}function Q(e){let s=e.filledNames.has("beforeEvent"),r=e.filledNames.has("afterEvent"),i=e.filledNames.has("onEventsComplete");return async function(d,g,n,a,u,m){let _=[],b=[],t=[],l=L(),h=u.length>0;a.setContext(n);for(let p of g){let y=d.get(p.event);if(!y||y.length===0){b.push(p.event);continue}let x=[],R=[],S=[],C=[],c=L(),k=false,T,D={ctx:n,counters:c,event:p.event},N={$event:{type:p.event,data:p.data}};for(let v=0;v<y.length;v++){let I=y[v];if(c.rulesEvaluated++,s)try{let f=await m.beforeEvent(I.definition,D);if(f==="skip"){R.push(v),c.rulesSkipped++;continue}if(f==="abort")break}catch(f){C.push({ruleIndex:v,error:`beforeEvent: ${f}`}),c.errors++;}x.push(v),c.rulesMatched++;let w;if(h)try{w=M(u,I.definition,n,N);}catch(f){C.push({ruleIndex:v,error:`Middleware: ${f}`}),c.errors++;continue}else w=N;let E=await a.invokeAsync(I.actionId,w);if(c.directivesApplied+=E.appliedCount,c.directivesSkipped+=E.skippedCount,c.errors+=E.errors.length,r)try{if(await m.afterEvent(I.definition,E,D)==="abort")break}catch{}if(E.aborted){k=true,T=E.abortedBy;break}}t.push(...C),O(l,c),_.push({event:p.event,matched:x,skipped:R,notMatched:S,errors:C,halted:k,haltedBy:T,counters:c});}let A={eventResults:_,unprocessedEvents:b,errors:t,counters:l,totalEvents:g.length,processedEvents:_.length};if(i)try{await m.onEventsComplete(A);}catch{}return A}}function B(e,s){return s?Q(e):q(e)}function F(e,s,r){let{filledNames:i,asyncNames:o}=e,d=R=>i.has(R),g=R=>o.has(R)?"await ":"",n=d("beforeEvent"),a=d("afterEvent"),u=d("onEventsComplete"),m=g("beforeEvent"),_=g("afterEvent"),b=g("onEventsComplete"),t=[];t.push("const eventResults=[];"),t.push("const unprocessedEvents=[];"),t.push("const aggErrors=[];"),t.push("const aggCounters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),t.push("ae.setContext(ctx);"),u&&t.push("const _hookOnComplete=hooks.onEventsComplete;"),t.push("for(let _ei=0;_ei<events.length;_ei++){"),t.push("const ev=events[_ei];"),t.push("const _evListeners=listenerIndex.get(ev.event);"),t.push("if(!_evListeners||_evListeners.length===0){unprocessedEvents.push(ev.event);continue;}"),t.push("const matched=[];const skipped=[];const notMatched=[];"),t.push("const errors=[];"),t.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),t.push("let halted=false;let haltedBy;"),(n||a)&&t.push("const evalCtx={ctx,counters,event:ev.event};"),n&&t.push("const _hookBefore=hooks.beforeEvent;"),a&&t.push("const _hookAfter=hooks.afterEvent;"),t.push("const _ep={$event:{type:ev.event,data:ev.data}};"),t.push("for(let _ri=0;_ri<_evListeners.length;_ri++){"),t.push("const stored=_evListeners[_ri];"),t.push("counters.rulesEvaluated++;"),n&&(t.push("try{"),t.push(`const _bd=${m}_hookBefore(stored.definition,evalCtx);`),t.push('if(_bd==="skip"){skipped.push(_ri);counters.rulesSkipped++;continue;}'),t.push('if(_bd==="abort"){break;}'),t.push('}catch(_e){errors.push({ruleIndex:_ri,error:"beforeEvent: "+_e});counters.errors++;}')),t.push("matched.push(_ri);counters.rulesMatched++;"),s&&(t.push("let params;"),t.push('try{params=$.runMw(mw,stored.definition,ctx,_ep);}catch(_e){errors.push({ruleIndex:_ri,error:"Middleware: "+_e});counters.errors++;continue;}'));let l=s?"params":"_ep",h=r?`await ae.invokeAsync(stored.actionId,${l})`:`ae.invoke(stored.actionId,${l})`;t.push(`const ir=${h};`),t.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),a&&(t.push("try{"),t.push(`const _ad=${_}_hookAfter(stored.definition,ir,evalCtx);`),t.push('if(_ad==="abort"){break;}'),t.push("}catch(_e){}")),t.push("if(ir.aborted){halted=true;haltedBy=ir.abortedBy;break;}"),t.push("}"),t.push("aggCounters.rulesEvaluated+=counters.rulesEvaluated;"),t.push("aggCounters.rulesMatched+=counters.rulesMatched;"),t.push("aggCounters.rulesSkipped+=counters.rulesSkipped;"),t.push("aggCounters.directivesApplied+=counters.directivesApplied;"),t.push("aggCounters.directivesSkipped+=counters.directivesSkipped;"),t.push("aggCounters.subRunsCreated+=counters.subRunsCreated;"),t.push("aggCounters.errors+=counters.errors;"),t.push("for(let _k=0;_k<errors.length;_k++)aggErrors.push(errors[_k]);"),t.push("eventResults.push({event:ev.event,matched,skipped,notMatched,errors,halted,haltedBy,counters});"),t.push("}"),t.push("const _r={eventResults,unprocessedEvents,errors:aggErrors,counters:aggCounters,totalEvents:events.length,processedEvents:eventResults.length};"),u&&t.push(`try{${b}_hookOnComplete(_r);}catch(_e){}`),t.push("return _r;");let A=t.join(`
+`),p=r?"async ":"",y=new Function("listenerIndex","events","ctx","ae","mw","hooks","$",`"use strict";
+return(${p}()=>{
+${A}
+})();`),x={};return s&&(x.runMw=M),function(S,C,c,k,T,D){return y(S,C,c,k,T,D,x)}}function V(e){return !e.event||typeof e.event!="string"?{event:e.event??"(missing)",code:"INVALID_DEFINITION",message:"event definition must have a non-empty string event name"}:e.tags!==void 0&&!Array.isArray(e.tags)?{event:e.event,code:"INVALID_DEFINITION",message:"event definition tags must be an array of strings"}:e.tier!==void 0&&typeof e.tier!="number"?{event:e.event,code:"INVALID_DEFINITION",message:"event definition tier must be a number"}:null}function j(e){if(!e.id||typeof e.id!="string")return {listenerId:e.id??"(missing)",code:"INVALID_LISTENER",message:"listener must have a string id"};if(typeof e.priority!="number")return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener must have a numeric priority"};if(typeof e.on=="string"){if(!e.on)return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener.on must be a non-empty string or string[]"}}else if(Array.isArray(e.on)){if(e.on.length===0||e.on.some(s=>typeof s!="string"||!s))return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener.on must be a non-empty string or string[] of non-empty strings"}}else return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener.on must be a string or string[]"};return !Array.isArray(e.then)||e.then.length===0?{listenerId:e.id,code:"INVALID_LISTENER",message:"listener must have a non-empty then array"}:null}function H(e,s){let r=0,i=e.length;for(;r<i;){let o=r+i>>>1;e[o].priority>=s.priority?r=o+1:i=o;}e.splice(r,0,s);}function W(e,s){let r=e.indexOf(s);return r===-1?false:(e.splice(r,1),true)}var P=()=>{},$=class{_actionEngine;_middleware;_eventHooks;_isAsync;_requestedMode;_hookAnalysis;_dispatcher;_mode;_maybeAutoPromote;_eventDefinitions=new Map;_listenerRegistry=new Map;_listenerIndex=new Map;_batch=null;constructor(s){if(this._actionEngine=s.actionEngine,this._middleware=s.middleware??[],this._eventHooks=s.eventHooks??{},this._requestedMode=s.mode??"auto",this._hookAnalysis=core.analyzeSlots(this._eventHooks,core.EVENT_SLOT_NAMES),this._isAsync=this._hookAnalysis.hasAnyAsync||this._actionEngine.isAsync,this._requestedMode==="jit")this._dispatcher=this._buildJit(),this._mode="jit",this._maybeAutoPromote=P;else if(this._dispatcher=B(this._hookAnalysis,this._isAsync),this._mode="interpret",this._requestedMode==="auto"){let r=0,i=s.autoJitThreshold??8;this._maybeAutoPromote=()=>{++r>=i&&this._promote();};}else this._maybeAutoPromote=P;}get actionEngine(){return this._actionEngine}get isAsync(){return this._isAsync}get compilationMode(){return this._mode}get eventDefinitions(){return this._eventDefinitions}getEventDefinition(s){return this._eventDefinitions.get(s)}defineEvents(s){let r=[],i=[],o=[];for(let n of s){let a=V(n);if(a){i.push(a);continue}if(this._eventDefinitions.has(n.event)){i.push({event:n.event,code:"DUPLICATE_EVENT",message:`event definition "${n.event}" is already registered`});continue}this._eventDefinitions.set(n.event,n);let u=["eventdef"];n.tags&&u.push(...n.tags),o.push({id:`eventdef:${n.event}`,directives:[],tags:u,declarations:n.declarations,tier:n.tier,metadata:{...n.schema!==void 0&&{schema:n.schema},...n.description!==void 0&&{description:n.description}}}),r.push(n.event);}let d=[];if(o.length>0){let n=this._actionEngine.register(o);for(let a of n.errors){let u=this._actionIdToEventName(a.actionId);i.push({event:u??a.actionId,code:a.code??"ACTION_ERROR",message:a.error});}d=n.warnings;}let g={defined:r,errors:i,warnings:d};return this._batch&&(this._batch.definedEvents.push(...r),this._batch.defineErrors.push(...i),this._batch.warnings.push(...d)),g}register(s){let r=[],i=[],o=[],d=[];for(let n of s){let a=j(n);if(a){i.push(a);continue}if(this._listenerRegistry.has(n.id)){i.push({listenerId:n.id,code:"DUPLICATE_ID",message:`listener "${n.id}" is already registered`});continue}let u=typeof n.on=="string"?[n.on]:n.on,m=false;for(let l of u){let h=this._eventDefinitions.get(l);if(!h){o.push({actionId:`event:${n.id}`,code:"NO_EVENT_DEFINITION",message:`listener "${n.id}" listens to "${l}" but no event definition is registered for it`});continue}h.tier!==void 0&&n.declarations?.tier!==void 0&&n.declarations.tier<h.tier&&(i.push({listenerId:n.id,code:"TIER_VIOLATION",message:`listener "${n.id}" declares tier ${n.declarations.tier} but event "${l}" requires tier >= ${h.tier}`}),m=true);}if(m)continue;let _=`event:${n.id}`,b={definition:n,actionId:_,priority:n.priority};this._listenerRegistry.set(n.id,b);for(let l of u){let h=this._listenerIndex.get(l);h||(h=[],this._listenerIndex.set(l,h)),H(h,b);}let t=["event"];n.tags&&t.push(...n.tags),d.push({id:_,tags:t,directives:n.then,declarations:n.declarations}),r.push(n.id);}if(d.length>0){let n=this._actionEngine.register(d);for(let a of n.errors){let u=this._actionIdToListenerId(a.actionId);i.push({listenerId:u??a.actionId,code:a.code??"ACTION_ERROR",message:a.error});}o.push(...n.warnings);}let g={registered:r,errors:i,warnings:o};return this._batch&&(this._batch.registered.push(...r),this._batch.errors.push(...i),this._batch.warnings.push(...o)),g}unregister(s){let r=this._listenerRegistry.get(s);if(!r)return  false;this._listenerRegistry.delete(s);let i=typeof r.definition.on=="string"?[r.definition.on]:r.definition.on;for(let o of i){let d=this._listenerIndex.get(o);d&&(W(d,r),d.length===0&&this._listenerIndex.delete(o));}return this._actionEngine.unregister(r.actionId),true}processEvents(s,r){if(this._isAsync)throw new Error("Cannot call processEvents() with async hooks. Use processEventsAsync() instead.");let i=this._dispatcher(this._listenerIndex,s,r,this._actionEngine,this._middleware,this._eventHooks);return this._maybeAutoPromote(),i}async processEventsAsync(s,r){let i=await this._dispatcher(this._listenerIndex,s,r,this._actionEngine,this._middleware,this._eventHooks);return this._maybeAutoPromote(),i}beginBatch(){this._batch||(this._batch={depth:0,registered:[],errors:[],warnings:[],definedEvents:[],defineErrors:[]}),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 s=this._actionEngine.endBatch();if(this._batch.depth>0)return {registered:[],errors:[],warnings:[]};let r=this._batch;for(let o of s.errors){let d=this._actionIdToListenerId(o.actionId);r.errors.push({listenerId:d??o.actionId,code:o.code??"ACTION_ERROR",message:o.error});}r.warnings.push(...s.warnings);let i={registered:r.registered,errors:r.errors,warnings:r.warnings};return this._batch=null,i}compile(){this._requestedMode!=="interpret"&&this._mode!=="jit"&&this._promote();}_promote(){this._dispatcher=this._buildJit(),this._mode="jit",this._maybeAutoPromote=P;}_buildJit(){return F(this._hookAnalysis,this._middleware.length>0,this._isAsync)}_actionIdToListenerId(s){return s.startsWith("event:")?s.slice(6):null}_actionIdToEventName(s){return s.startsWith("eventdef:")?s.slice(9):null}};function z(e){return new $(e)}function re(e="event"){return s=>{let r=s[e],i=typeof r=="string"&&r?[`eventdef:${r}`]:[];return {capabilities:["emit"],dependencies:i}}}exports.createEmitAnalyzer=re;exports.createEventProcessor=z;

package/dist/index.d.cts

@@ -0,0 +1,128 @@
+import { HookFn, Directive, FrameCounters, DirectiveResult, RuleError } from '@statedelta-actions/core';
+import { RegisterWarning, IActionEngine, HandlerAnalysis } from '@statedelta-actions/actions';
+
+interface EventDefinition {
+    /** Nome do evento. Chave única no registry. */
+    readonly event: string;
+    /** Schema do payload (shape dos dados que emit envia e listeners recebem). */
+    readonly schema?: Record<string, unknown>;
+    /** Tags para categorização e composition control. */
+    readonly tags?: readonly string[];
+    /** Tier do evento (validação hierárquica). */
+    readonly tier?: number;
+    /** Declarations (trust boundary — o que dependents veem). */
+    readonly declarations?: Record<string, unknown>;
+    /** Descrição humana. */
+    readonly description?: string;
+}
+interface EventDefineError {
+    readonly event: string;
+    readonly code: string;
+    readonly message: string;
+}
+interface EventDefineResult {
+    readonly defined: readonly string[];
+    readonly errors: readonly EventDefineError[];
+    readonly warnings: readonly RegisterWarning[];
+}
+interface EventListenerDefinition<TCtx = unknown> {
+    readonly id: string;
+    readonly priority: number;
+    readonly on: string | string[];
+    readonly then: readonly Directive<TCtx>[];
+    readonly tags?: readonly string[];
+    readonly declarations?: Record<string, unknown>;
+    readonly metadata?: Record<string, unknown>;
+}
+interface EventProcessingContext<TCtx = unknown> {
+    readonly ctx: TCtx;
+    readonly counters: FrameCounters;
+    readonly event: string;
+}
+interface SingleEventResult {
+    readonly event: string;
+    readonly matched: readonly number[];
+    readonly skipped: readonly number[];
+    readonly notMatched: readonly number[];
+    readonly errors: readonly RuleError[];
+    readonly halted: boolean;
+    readonly haltedBy?: string;
+    readonly counters: FrameCounters;
+}
+interface EventProcessingResult {
+    readonly eventResults: readonly SingleEventResult[];
+    readonly unprocessedEvents: readonly string[];
+    readonly errors: readonly RuleError[];
+    readonly counters: FrameCounters;
+    readonly totalEvents: number;
+    readonly processedEvents: number;
+}
+interface EventHooks<TCtx = unknown> {
+    beforeEvent?: HookFn<[
+        listener: EventListenerDefinition<TCtx>,
+        evalCtx: EventProcessingContext<TCtx>
+    ], "skip" | "abort" | void>;
+    afterEvent?: HookFn<[
+        listener: EventListenerDefinition<TCtx>,
+        result: DirectiveResult,
+        evalCtx: EventProcessingContext<TCtx>
+    ], "abort" | void>;
+    onEventsComplete?: HookFn<[result: EventProcessingResult], void>;
+}
+interface QueuedEvent {
+    readonly event: string;
+    readonly data?: unknown;
+}
+interface EventRegisterError {
+    readonly listenerId: string;
+    readonly code: string;
+    readonly message: string;
+}
+interface EventRegisterResult {
+    readonly registered: readonly string[];
+    readonly errors: readonly EventRegisterError[];
+    readonly warnings: readonly RegisterWarning[];
+}
+type EventMiddleware<TCtx = unknown> = (listener: EventListenerDefinition<TCtx>, ctx: TCtx, params: Record<string, unknown>) => Record<string, unknown>;
+interface EventProcessorConfig<TCtx = unknown> {
+    actionEngine: IActionEngine<TCtx>;
+    middleware?: readonly EventMiddleware<TCtx>[];
+    eventHooks?: EventHooks<TCtx>;
+    mode?: "interpret" | "jit" | "auto";
+    autoJitThreshold?: number;
+}
+interface IEventProcessor<TCtx = unknown> {
+    defineEvents(definitions: readonly EventDefinition[]): EventDefineResult;
+    getEventDefinition(event: string): EventDefinition | undefined;
+    readonly eventDefinitions: ReadonlyMap<string, EventDefinition>;
+    register(listeners: readonly EventListenerDefinition<TCtx>[]): EventRegisterResult;
+    unregister(id: string): boolean;
+    processEvents(events: readonly QueuedEvent[], ctx: TCtx): EventProcessingResult;
+    processEventsAsync(events: readonly QueuedEvent[], ctx: TCtx): Promise<EventProcessingResult>;
+    beginBatch(): void;
+    endBatch(): EventRegisterResult;
+    compile(): void;
+    readonly actionEngine: IActionEngine<TCtx>;
+    readonly isAsync: boolean;
+    readonly compilationMode: "interpret" | "jit";
+}
+
+declare function createEventProcessor<TCtx>(config: EventProcessorConfig<TCtx>): IEventProcessor<TCtx>;
+
+/**
+ * Cria uma função `analyze()` para o handler `emit`.
+ * Retorna capabilities: ["emit"] e dependency para `eventdef:{event}`.
+ *
+ * Uso no consumer:
+ * ```ts
+ * const handlers = {
+ *   emit: {
+ *     execute: (d, frame) => { ... },
+ *     analyze: createEmitAnalyzer(),
+ *   },
+ * };
+ * ```
+ */
+declare function createEmitAnalyzer(eventField?: string): (directive: Directive) => HandlerAnalysis;
+
+export { type EventDefineError, type EventDefineResult, type EventDefinition, type EventHooks, type EventListenerDefinition, type EventMiddleware, type EventProcessingContext, type EventProcessingResult, type EventProcessorConfig, type EventRegisterError, type EventRegisterResult, type IEventProcessor, type QueuedEvent, type SingleEventResult, createEmitAnalyzer, createEventProcessor };

package/dist/index.d.ts

@@ -0,0 +1,128 @@
+import { HookFn, Directive, FrameCounters, DirectiveResult, RuleError } from '@statedelta-actions/core';
+import { RegisterWarning, IActionEngine, HandlerAnalysis } from '@statedelta-actions/actions';
+
+interface EventDefinition {
+    /** Nome do evento. Chave única no registry. */
+    readonly event: string;
+    /** Schema do payload (shape dos dados que emit envia e listeners recebem). */
+    readonly schema?: Record<string, unknown>;
+    /** Tags para categorização e composition control. */
+    readonly tags?: readonly string[];
+    /** Tier do evento (validação hierárquica). */
+    readonly tier?: number;
+    /** Declarations (trust boundary — o que dependents veem). */
+    readonly declarations?: Record<string, unknown>;
+    /** Descrição humana. */
+    readonly description?: string;
+}
+interface EventDefineError {
+    readonly event: string;
+    readonly code: string;
+    readonly message: string;
+}
+interface EventDefineResult {
+    readonly defined: readonly string[];
+    readonly errors: readonly EventDefineError[];
+    readonly warnings: readonly RegisterWarning[];
+}
+interface EventListenerDefinition<TCtx = unknown> {
+    readonly id: string;
+    readonly priority: number;
+    readonly on: string | string[];
+    readonly then: readonly Directive<TCtx>[];
+    readonly tags?: readonly string[];
+    readonly declarations?: Record<string, unknown>;
+    readonly metadata?: Record<string, unknown>;
+}
+interface EventProcessingContext<TCtx = unknown> {
+    readonly ctx: TCtx;
+    readonly counters: FrameCounters;
+    readonly event: string;
+}
+interface SingleEventResult {
+    readonly event: string;
+    readonly matched: readonly number[];
+    readonly skipped: readonly number[];
+    readonly notMatched: readonly number[];
+    readonly errors: readonly RuleError[];
+    readonly halted: boolean;
+    readonly haltedBy?: string;
+    readonly counters: FrameCounters;
+}
+interface EventProcessingResult {
+    readonly eventResults: readonly SingleEventResult[];
+    readonly unprocessedEvents: readonly string[];
+    readonly errors: readonly RuleError[];
+    readonly counters: FrameCounters;
+    readonly totalEvents: number;
+    readonly processedEvents: number;
+}
+interface EventHooks<TCtx = unknown> {
+    beforeEvent?: HookFn<[
+        listener: EventListenerDefinition<TCtx>,
+        evalCtx: EventProcessingContext<TCtx>
+    ], "skip" | "abort" | void>;
+    afterEvent?: HookFn<[
+        listener: EventListenerDefinition<TCtx>,
+        result: DirectiveResult,
+        evalCtx: EventProcessingContext<TCtx>
+    ], "abort" | void>;
+    onEventsComplete?: HookFn<[result: EventProcessingResult], void>;
+}
+interface QueuedEvent {
+    readonly event: string;
+    readonly data?: unknown;
+}
+interface EventRegisterError {
+    readonly listenerId: string;
+    readonly code: string;
+    readonly message: string;
+}
+interface EventRegisterResult {
+    readonly registered: readonly string[];
+    readonly errors: readonly EventRegisterError[];
+    readonly warnings: readonly RegisterWarning[];
+}
+type EventMiddleware<TCtx = unknown> = (listener: EventListenerDefinition<TCtx>, ctx: TCtx, params: Record<string, unknown>) => Record<string, unknown>;
+interface EventProcessorConfig<TCtx = unknown> {
+    actionEngine: IActionEngine<TCtx>;
+    middleware?: readonly EventMiddleware<TCtx>[];
+    eventHooks?: EventHooks<TCtx>;
+    mode?: "interpret" | "jit" | "auto";
+    autoJitThreshold?: number;
+}
+interface IEventProcessor<TCtx = unknown> {
+    defineEvents(definitions: readonly EventDefinition[]): EventDefineResult;
+    getEventDefinition(event: string): EventDefinition | undefined;
+    readonly eventDefinitions: ReadonlyMap<string, EventDefinition>;
+    register(listeners: readonly EventListenerDefinition<TCtx>[]): EventRegisterResult;
+    unregister(id: string): boolean;
+    processEvents(events: readonly QueuedEvent[], ctx: TCtx): EventProcessingResult;
+    processEventsAsync(events: readonly QueuedEvent[], ctx: TCtx): Promise<EventProcessingResult>;
+    beginBatch(): void;
+    endBatch(): EventRegisterResult;
+    compile(): void;
+    readonly actionEngine: IActionEngine<TCtx>;
+    readonly isAsync: boolean;
+    readonly compilationMode: "interpret" | "jit";
+}
+
+declare function createEventProcessor<TCtx>(config: EventProcessorConfig<TCtx>): IEventProcessor<TCtx>;
+
+/**
+ * Cria uma função `analyze()` para o handler `emit`.
+ * Retorna capabilities: ["emit"] e dependency para `eventdef:{event}`.
+ *
+ * Uso no consumer:
+ * ```ts
+ * const handlers = {
+ *   emit: {
+ *     execute: (d, frame) => { ... },
+ *     analyze: createEmitAnalyzer(),
+ *   },
+ * };
+ * ```
+ */
+declare function createEmitAnalyzer(eventField?: string): (directive: Directive) => HandlerAnalysis;
+
+export { type EventDefineError, type EventDefineResult, type EventDefinition, type EventHooks, type EventListenerDefinition, type EventMiddleware, type EventProcessingContext, type EventProcessingResult, type EventProcessorConfig, type EventRegisterError, type EventRegisterResult, type IEventProcessor, type QueuedEvent, type SingleEventResult, createEmitAnalyzer, createEventProcessor };

package/dist/index.js

@@ -0,0 +1,5 @@
+import {analyzeSlots,EVENT_SLOT_NAMES}from'@statedelta-actions/core';function L(){return {rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0}}function O(e,s){e.rulesEvaluated+=s.rulesEvaluated,e.rulesMatched+=s.rulesMatched,e.rulesSkipped+=s.rulesSkipped,e.directivesApplied+=s.directivesApplied,e.directivesSkipped+=s.directivesSkipped,e.subRunsCreated+=s.subRunsCreated,e.errors+=s.errors;}function M(e,s,r,i){let o=i?Object.assign({},i):{};for(let d of e)Object.assign(o,d(s,r,o));return o}function q(e){let s=e.filledNames.has("beforeEvent"),r=e.filledNames.has("afterEvent"),i=e.filledNames.has("onEventsComplete");return function(d,g,n,a,u,m){let _=[],b=[],t=[],l=L(),h=u.length>0;a.setContext(n);for(let p of g){let y=d.get(p.event);if(!y||y.length===0){b.push(p.event);continue}let x=[],R=[],S=[],C=[],c=L(),k=false,T,D={ctx:n,counters:c,event:p.event},N={$event:{type:p.event,data:p.data}};for(let v=0;v<y.length;v++){let I=y[v];if(c.rulesEvaluated++,s)try{let f=m.beforeEvent(I.definition,D);if(f==="skip"){R.push(v),c.rulesSkipped++;continue}if(f==="abort")break}catch(f){C.push({ruleIndex:v,error:`beforeEvent: ${f}`}),c.errors++;}x.push(v),c.rulesMatched++;let w;if(h)try{w=M(u,I.definition,n,N);}catch(f){C.push({ruleIndex:v,error:`Middleware: ${f}`}),c.errors++;continue}else w=N;let E=a.invoke(I.actionId,w);if(c.directivesApplied+=E.appliedCount,c.directivesSkipped+=E.skippedCount,c.errors+=E.errors.length,r)try{if(m.afterEvent(I.definition,E,D)==="abort")break}catch{}if(E.aborted){k=true,T=E.abortedBy;break}}t.push(...C),O(l,c),_.push({event:p.event,matched:x,skipped:R,notMatched:S,errors:C,halted:k,haltedBy:T,counters:c});}let A={eventResults:_,unprocessedEvents:b,errors:t,counters:l,totalEvents:g.length,processedEvents:_.length};if(i)try{m.onEventsComplete(A);}catch{}return A}}function Q(e){let s=e.filledNames.has("beforeEvent"),r=e.filledNames.has("afterEvent"),i=e.filledNames.has("onEventsComplete");return async function(d,g,n,a,u,m){let _=[],b=[],t=[],l=L(),h=u.length>0;a.setContext(n);for(let p of g){let y=d.get(p.event);if(!y||y.length===0){b.push(p.event);continue}let x=[],R=[],S=[],C=[],c=L(),k=false,T,D={ctx:n,counters:c,event:p.event},N={$event:{type:p.event,data:p.data}};for(let v=0;v<y.length;v++){let I=y[v];if(c.rulesEvaluated++,s)try{let f=await m.beforeEvent(I.definition,D);if(f==="skip"){R.push(v),c.rulesSkipped++;continue}if(f==="abort")break}catch(f){C.push({ruleIndex:v,error:`beforeEvent: ${f}`}),c.errors++;}x.push(v),c.rulesMatched++;let w;if(h)try{w=M(u,I.definition,n,N);}catch(f){C.push({ruleIndex:v,error:`Middleware: ${f}`}),c.errors++;continue}else w=N;let E=await a.invokeAsync(I.actionId,w);if(c.directivesApplied+=E.appliedCount,c.directivesSkipped+=E.skippedCount,c.errors+=E.errors.length,r)try{if(await m.afterEvent(I.definition,E,D)==="abort")break}catch{}if(E.aborted){k=true,T=E.abortedBy;break}}t.push(...C),O(l,c),_.push({event:p.event,matched:x,skipped:R,notMatched:S,errors:C,halted:k,haltedBy:T,counters:c});}let A={eventResults:_,unprocessedEvents:b,errors:t,counters:l,totalEvents:g.length,processedEvents:_.length};if(i)try{await m.onEventsComplete(A);}catch{}return A}}function B(e,s){return s?Q(e):q(e)}function F(e,s,r){let{filledNames:i,asyncNames:o}=e,d=R=>i.has(R),g=R=>o.has(R)?"await ":"",n=d("beforeEvent"),a=d("afterEvent"),u=d("onEventsComplete"),m=g("beforeEvent"),_=g("afterEvent"),b=g("onEventsComplete"),t=[];t.push("const eventResults=[];"),t.push("const unprocessedEvents=[];"),t.push("const aggErrors=[];"),t.push("const aggCounters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),t.push("ae.setContext(ctx);"),u&&t.push("const _hookOnComplete=hooks.onEventsComplete;"),t.push("for(let _ei=0;_ei<events.length;_ei++){"),t.push("const ev=events[_ei];"),t.push("const _evListeners=listenerIndex.get(ev.event);"),t.push("if(!_evListeners||_evListeners.length===0){unprocessedEvents.push(ev.event);continue;}"),t.push("const matched=[];const skipped=[];const notMatched=[];"),t.push("const errors=[];"),t.push("const counters={rulesEvaluated:0,rulesMatched:0,rulesSkipped:0,directivesApplied:0,directivesSkipped:0,subRunsCreated:0,errors:0};"),t.push("let halted=false;let haltedBy;"),(n||a)&&t.push("const evalCtx={ctx,counters,event:ev.event};"),n&&t.push("const _hookBefore=hooks.beforeEvent;"),a&&t.push("const _hookAfter=hooks.afterEvent;"),t.push("const _ep={$event:{type:ev.event,data:ev.data}};"),t.push("for(let _ri=0;_ri<_evListeners.length;_ri++){"),t.push("const stored=_evListeners[_ri];"),t.push("counters.rulesEvaluated++;"),n&&(t.push("try{"),t.push(`const _bd=${m}_hookBefore(stored.definition,evalCtx);`),t.push('if(_bd==="skip"){skipped.push(_ri);counters.rulesSkipped++;continue;}'),t.push('if(_bd==="abort"){break;}'),t.push('}catch(_e){errors.push({ruleIndex:_ri,error:"beforeEvent: "+_e});counters.errors++;}')),t.push("matched.push(_ri);counters.rulesMatched++;"),s&&(t.push("let params;"),t.push('try{params=$.runMw(mw,stored.definition,ctx,_ep);}catch(_e){errors.push({ruleIndex:_ri,error:"Middleware: "+_e});counters.errors++;continue;}'));let l=s?"params":"_ep",h=r?`await ae.invokeAsync(stored.actionId,${l})`:`ae.invoke(stored.actionId,${l})`;t.push(`const ir=${h};`),t.push("counters.directivesApplied+=ir.appliedCount;counters.directivesSkipped+=ir.skippedCount;counters.errors+=ir.errors.length;"),a&&(t.push("try{"),t.push(`const _ad=${_}_hookAfter(stored.definition,ir,evalCtx);`),t.push('if(_ad==="abort"){break;}'),t.push("}catch(_e){}")),t.push("if(ir.aborted){halted=true;haltedBy=ir.abortedBy;break;}"),t.push("}"),t.push("aggCounters.rulesEvaluated+=counters.rulesEvaluated;"),t.push("aggCounters.rulesMatched+=counters.rulesMatched;"),t.push("aggCounters.rulesSkipped+=counters.rulesSkipped;"),t.push("aggCounters.directivesApplied+=counters.directivesApplied;"),t.push("aggCounters.directivesSkipped+=counters.directivesSkipped;"),t.push("aggCounters.subRunsCreated+=counters.subRunsCreated;"),t.push("aggCounters.errors+=counters.errors;"),t.push("for(let _k=0;_k<errors.length;_k++)aggErrors.push(errors[_k]);"),t.push("eventResults.push({event:ev.event,matched,skipped,notMatched,errors,halted,haltedBy,counters});"),t.push("}"),t.push("const _r={eventResults,unprocessedEvents,errors:aggErrors,counters:aggCounters,totalEvents:events.length,processedEvents:eventResults.length};"),u&&t.push(`try{${b}_hookOnComplete(_r);}catch(_e){}`),t.push("return _r;");let A=t.join(`
+`),p=r?"async ":"",y=new Function("listenerIndex","events","ctx","ae","mw","hooks","$",`"use strict";
+return(${p}()=>{
+${A}
+})();`),x={};return s&&(x.runMw=M),function(S,C,c,k,T,D){return y(S,C,c,k,T,D,x)}}function V(e){return !e.event||typeof e.event!="string"?{event:e.event??"(missing)",code:"INVALID_DEFINITION",message:"event definition must have a non-empty string event name"}:e.tags!==void 0&&!Array.isArray(e.tags)?{event:e.event,code:"INVALID_DEFINITION",message:"event definition tags must be an array of strings"}:e.tier!==void 0&&typeof e.tier!="number"?{event:e.event,code:"INVALID_DEFINITION",message:"event definition tier must be a number"}:null}function j(e){if(!e.id||typeof e.id!="string")return {listenerId:e.id??"(missing)",code:"INVALID_LISTENER",message:"listener must have a string id"};if(typeof e.priority!="number")return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener must have a numeric priority"};if(typeof e.on=="string"){if(!e.on)return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener.on must be a non-empty string or string[]"}}else if(Array.isArray(e.on)){if(e.on.length===0||e.on.some(s=>typeof s!="string"||!s))return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener.on must be a non-empty string or string[] of non-empty strings"}}else return {listenerId:e.id,code:"INVALID_LISTENER",message:"listener.on must be a string or string[]"};return !Array.isArray(e.then)||e.then.length===0?{listenerId:e.id,code:"INVALID_LISTENER",message:"listener must have a non-empty then array"}:null}function H(e,s){let r=0,i=e.length;for(;r<i;){let o=r+i>>>1;e[o].priority>=s.priority?r=o+1:i=o;}e.splice(r,0,s);}function W(e,s){let r=e.indexOf(s);return r===-1?false:(e.splice(r,1),true)}var P=()=>{},$=class{_actionEngine;_middleware;_eventHooks;_isAsync;_requestedMode;_hookAnalysis;_dispatcher;_mode;_maybeAutoPromote;_eventDefinitions=new Map;_listenerRegistry=new Map;_listenerIndex=new Map;_batch=null;constructor(s){if(this._actionEngine=s.actionEngine,this._middleware=s.middleware??[],this._eventHooks=s.eventHooks??{},this._requestedMode=s.mode??"auto",this._hookAnalysis=analyzeSlots(this._eventHooks,EVENT_SLOT_NAMES),this._isAsync=this._hookAnalysis.hasAnyAsync||this._actionEngine.isAsync,this._requestedMode==="jit")this._dispatcher=this._buildJit(),this._mode="jit",this._maybeAutoPromote=P;else if(this._dispatcher=B(this._hookAnalysis,this._isAsync),this._mode="interpret",this._requestedMode==="auto"){let r=0,i=s.autoJitThreshold??8;this._maybeAutoPromote=()=>{++r>=i&&this._promote();};}else this._maybeAutoPromote=P;}get actionEngine(){return this._actionEngine}get isAsync(){return this._isAsync}get compilationMode(){return this._mode}get eventDefinitions(){return this._eventDefinitions}getEventDefinition(s){return this._eventDefinitions.get(s)}defineEvents(s){let r=[],i=[],o=[];for(let n of s){let a=V(n);if(a){i.push(a);continue}if(this._eventDefinitions.has(n.event)){i.push({event:n.event,code:"DUPLICATE_EVENT",message:`event definition "${n.event}" is already registered`});continue}this._eventDefinitions.set(n.event,n);let u=["eventdef"];n.tags&&u.push(...n.tags),o.push({id:`eventdef:${n.event}`,directives:[],tags:u,declarations:n.declarations,tier:n.tier,metadata:{...n.schema!==void 0&&{schema:n.schema},...n.description!==void 0&&{description:n.description}}}),r.push(n.event);}let d=[];if(o.length>0){let n=this._actionEngine.register(o);for(let a of n.errors){let u=this._actionIdToEventName(a.actionId);i.push({event:u??a.actionId,code:a.code??"ACTION_ERROR",message:a.error});}d=n.warnings;}let g={defined:r,errors:i,warnings:d};return this._batch&&(this._batch.definedEvents.push(...r),this._batch.defineErrors.push(...i),this._batch.warnings.push(...d)),g}register(s){let r=[],i=[],o=[],d=[];for(let n of s){let a=j(n);if(a){i.push(a);continue}if(this._listenerRegistry.has(n.id)){i.push({listenerId:n.id,code:"DUPLICATE_ID",message:`listener "${n.id}" is already registered`});continue}let u=typeof n.on=="string"?[n.on]:n.on,m=false;for(let l of u){let h=this._eventDefinitions.get(l);if(!h){o.push({actionId:`event:${n.id}`,code:"NO_EVENT_DEFINITION",message:`listener "${n.id}" listens to "${l}" but no event definition is registered for it`});continue}h.tier!==void 0&&n.declarations?.tier!==void 0&&n.declarations.tier<h.tier&&(i.push({listenerId:n.id,code:"TIER_VIOLATION",message:`listener "${n.id}" declares tier ${n.declarations.tier} but event "${l}" requires tier >= ${h.tier}`}),m=true);}if(m)continue;let _=`event:${n.id}`,b={definition:n,actionId:_,priority:n.priority};this._listenerRegistry.set(n.id,b);for(let l of u){let h=this._listenerIndex.get(l);h||(h=[],this._listenerIndex.set(l,h)),H(h,b);}let t=["event"];n.tags&&t.push(...n.tags),d.push({id:_,tags:t,directives:n.then,declarations:n.declarations}),r.push(n.id);}if(d.length>0){let n=this._actionEngine.register(d);for(let a of n.errors){let u=this._actionIdToListenerId(a.actionId);i.push({listenerId:u??a.actionId,code:a.code??"ACTION_ERROR",message:a.error});}o.push(...n.warnings);}let g={registered:r,errors:i,warnings:o};return this._batch&&(this._batch.registered.push(...r),this._batch.errors.push(...i),this._batch.warnings.push(...o)),g}unregister(s){let r=this._listenerRegistry.get(s);if(!r)return  false;this._listenerRegistry.delete(s);let i=typeof r.definition.on=="string"?[r.definition.on]:r.definition.on;for(let o of i){let d=this._listenerIndex.get(o);d&&(W(d,r),d.length===0&&this._listenerIndex.delete(o));}return this._actionEngine.unregister(r.actionId),true}processEvents(s,r){if(this._isAsync)throw new Error("Cannot call processEvents() with async hooks. Use processEventsAsync() instead.");let i=this._dispatcher(this._listenerIndex,s,r,this._actionEngine,this._middleware,this._eventHooks);return this._maybeAutoPromote(),i}async processEventsAsync(s,r){let i=await this._dispatcher(this._listenerIndex,s,r,this._actionEngine,this._middleware,this._eventHooks);return this._maybeAutoPromote(),i}beginBatch(){this._batch||(this._batch={depth:0,registered:[],errors:[],warnings:[],definedEvents:[],defineErrors:[]}),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 s=this._actionEngine.endBatch();if(this._batch.depth>0)return {registered:[],errors:[],warnings:[]};let r=this._batch;for(let o of s.errors){let d=this._actionIdToListenerId(o.actionId);r.errors.push({listenerId:d??o.actionId,code:o.code??"ACTION_ERROR",message:o.error});}r.warnings.push(...s.warnings);let i={registered:r.registered,errors:r.errors,warnings:r.warnings};return this._batch=null,i}compile(){this._requestedMode!=="interpret"&&this._mode!=="jit"&&this._promote();}_promote(){this._dispatcher=this._buildJit(),this._mode="jit",this._maybeAutoPromote=P;}_buildJit(){return F(this._hookAnalysis,this._middleware.length>0,this._isAsync)}_actionIdToListenerId(s){return s.startsWith("event:")?s.slice(6):null}_actionIdToEventName(s){return s.startsWith("eventdef:")?s.slice(9):null}};function z(e){return new $(e)}function re(e="event"){return s=>{let r=s[e],i=typeof r=="string"&&r?[`eventdef:${r}`]:[];return {capabilities:["emit"],dependencies:i}}}export{re as createEmitAnalyzer,z as createEventProcessor};

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@statedelta-actions/events",
+  "version": "0.1.0",
+  "description": "Event processing engine with listener dispatch and JIT optimization",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@statedelta-actions/core": "0.1.0",
+    "@statedelta-actions/actions": "0.1.0"
+  },
+  "devDependencies": {
+    "@statedelta-actions/analyzer": "0.1.0",
+    "@statedelta-actions/graph": "0.1.0"
+  },
+  "author": "Anderson D. Rosa <andersondrosa@outlook.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/andersondrosa/statedelta-actions.git",
+    "directory": "packages/events"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}