trigger_system 1.0.0 → 1.0.2

package/dist/core/base-engine.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Base Engine Interface - Define la interfaz común para todos los motores
+ * Platform-agnostic y extensible
+ */
+import type { TriggerRule, TriggerContext, TriggerResult, RuleEngineConfig } from "../types";
+export type EngineActionHandler = (params: any, context: TriggerContext) => Promise<any> | any;
+/**
+ * Interfaz base que deben implementar todos los motores
+ */
+export interface ITriggerEngine {
+    readonly rules: TriggerRule[];
+    processEvent(context: TriggerContext): Promise<TriggerResult[]>;
+    processEvent(eventType: string, data?: Record<string, any>, globals?: Record<string, any>): Promise<TriggerResult[]>;
+    registerAction(type: string, handler: EngineActionHandler): void;
+    updateRules(newRules: TriggerRule[]): void;
+    getRules(): TriggerRule[];
+    readonly config?: RuleEngineConfig;
+}
+//# sourceMappingURL=base-engine.d.ts.map

package/dist/core/base-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-engine.d.ts","sourceRoot":"","sources":["../../src/core/base-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,aAAa,EAIb,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAE/F;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC;IAG9B,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAChE,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAGrH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAGjE,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;IAC3C,QAAQ,IAAI,WAAW,EAAE,CAAC;IAG1B,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;CACpC"}

package/dist/core/expression-engine.d.ts

@@ -22,7 +22,7 @@ export declare class ExpressionEngine {
      * Obtiene un valor anidado de un objeto usando notación de puntos
      * Ejemplo: getNestedValue("data.user.profile.name", context)
      */
-    static getNestedValue(path: string, context: TriggerContext): any;
+    static getNestedValue(path: string, context: TriggerContext): Record<string, any> | undefined;
     /**
      * Ejecuta una expresión matemática específica (como "1 + 2")
      */

package/dist/core/expression-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expression-engine.d.ts","sourceRoot":"","sources":["../../src/core/expression-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,qBAAa,gBAAgB;IAC3B;;;OAGG;IAEH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,GAAG;IAoBjE;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAoBrE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAUrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA2BjC;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,GAAG;IAcjE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;CA+CzE"}
+{"version":3,"file":"expression-engine.d.ts","sourceRoot":"","sources":["../../src/core/expression-engine.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,qBAAa,gBAAgB;IAC3B;;;OAGG;IAEH,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,GAAG;IAoBjE;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;IAoBrE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAUrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA2BjC;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc;IAc3D;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM;CA+CzE"}

package/dist/core/index.d.ts

@@ -2,9 +2,14 @@ export * from "./expression-engine";
 export * from "./event-queue";
 export * from "./persistence";
 export * from "./persistence-browser";
+export type { ITriggerEngine, EngineActionHandler } from "./base-engine";
+export { TriggerEngine } from "./trigger-engine";
+export { RuleEngine } from "./rule-engine-new";
 export * from "./action-registry";
 export * from "./context-adapter";
+export * from "./state-manager";
+export { TriggerEngine as Engine } from "./trigger-engine";
+export { RuleEngine as AdvancedRuleEngine } from "./rule-engine-new";
 export * from "./rule-engine";
 export * from "./engine";
-export * from "./state-manager";
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAE9B,cAAc,uBAAuB,CAAC;AAGtC,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAGhC,OAAO,EAAE,aAAa,IAAI,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,UAAU,IAAI,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGrE,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC"}

package/dist/core/rule-engine-new.d.ts

@@ -0,0 +1,51 @@
+/**
+ * RuleEngine - Extensión de TriggerEngine con características avanzadas
+ * Agrega observabilidad, estado persistente, y ActionRegistry integrado
+ */
+import type { TriggerContext, TriggerResult, RuleEngineConfig } from "../types";
+import { TriggerEngine } from "./trigger-engine";
+export declare class RuleEngine extends TriggerEngine {
+    private actionRegistry;
+    private stateManager;
+    constructor(config: RuleEngineConfig);
+    /**
+     * Procesa un evento con contexto completo (sobrescribe el método padre)
+     * Agrega observabilidad y manejo de estado
+     */
+    processEvent(context: TriggerContext): Promise<TriggerResult[]>;
+    /**
+     * Método convenience para procesar eventos simples
+     * Usa el método renombrado del padre
+     */
+    processEventSimple(eventType: string, data?: Record<string, any>, globals?: Record<string, any>): Promise<TriggerResult[]>;
+    /**
+     * Ejecuta acciones usando el ActionRegistry
+     */
+    private executeRuleActionsWithRegistry;
+    /**
+     * Ejecuta una acción individual usando el ActionRegistry
+     */
+    private executeSingleActionWithRegistry;
+    /**
+     * Actualiza el tiempo de última ejecución de una regla
+     */
+    private updateLastExecution;
+    /**
+     * Sobrescribe getStateContext para usar StateManager
+     */
+    protected getStateContext(): Record<string, any>;
+    /**
+     * Sobrescribe shouldEvaluateAll para usar la configuración
+     */
+    protected shouldEvaluateAll(): boolean;
+    /**
+     * Sobrescribe executeRuleActions para usar el registry
+     */
+    protected executeRuleActions(actionConfig: any, context: TriggerContext): Promise<TriggerResult['executedActions']>;
+    /**
+     * Sobrescribe executeSingleAction para usar el registry
+     */
+    protected executeSingleAction(action: any, context: TriggerContext): Promise<TriggerResult['executedActions'][0]>;
+}
+export { RuleEngine as AdvancedEngine };
+//# sourceMappingURL=rule-engine-new.d.ts.map

package/dist/core/rule-engine-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-engine-new.d.ts","sourceRoot":"","sources":["../../src/core/rule-engine-new.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAEV,cAAc,EACd,aAAa,EACb,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAKjD,qBAAa,UAAW,SAAQ,aAAa;IAC3C,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;gBAEvB,MAAM,EAAE,gBAAgB;IASpC;;;OAGG;IACY,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAmE9E;;;OAGG;IACY,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWjJ;;OAEG;YACW,8BAA8B;IA2C5C;;OAEG;YACW,+BAA+B;IAsD7C;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAK3B;;OAEG;cACgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIzD;;OAEG;cACgB,iBAAiB,IAAI,OAAO;IAI/C;;OAEG;cACsB,kBAAkB,CACzC,YAAY,EAAE,GAAG,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAI5C;;OAEG;cACsB,mBAAmB,CAC1C,MAAM,EAAE,GAAG,EACX,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;CAGhD;AAGD,OAAO,EAAE,UAAU,IAAI,cAAc,EAAE,CAAC"}

package/dist/core/trigger-engine.d.ts

@@ -0,0 +1,83 @@
+/**
+ * TriggerEngine - Motor base platform-agnostic
+ * Proporciona funcionalidad básica de procesamiento de reglas
+ * Puede ser extendido para agregar características adicionales
+ */
+import type { TriggerRule, TriggerContext, TriggerResult, Action, ActionGroup, RuleCondition, RuleEngineConfig } from "../types";
+export type EngineActionHandler = (params: any, context: TriggerContext) => Promise<any> | any;
+export declare class TriggerEngine {
+    protected _rules: TriggerRule[];
+    protected actionHandlers: Map<string, EngineActionHandler>;
+    protected lastExecution: Map<string, number>;
+    protected _config?: RuleEngineConfig;
+    /**
+     * Constructor base - puede recibir reglas directamente o config
+     */
+    constructor(rulesOrConfig?: TriggerRule[] | RuleEngineConfig);
+    /**
+     * Ordena reglas por prioridad (mayor primero)
+     */
+    protected sortRules(): void;
+    /**
+     * Registra un handler para un tipo de acción específico
+     */
+    registerAction(type: string, handler: EngineActionHandler): void;
+    /**
+     * Procesa un evento con contexto completo
+     */
+    processEvent(context: TriggerContext): Promise<TriggerResult[]>;
+    /**
+     * Método convenience para procesar eventos simples
+     * Renombrado para evitar conflicto con processEvent(context)
+     */
+    processEventSimple(eventType: string, data?: Record<string, any>, globals?: Record<string, any>): Promise<TriggerResult[]>;
+    /**
+     * Actualiza las reglas del motor
+     */
+    updateRules(newRules: TriggerRule[]): void;
+    /**
+     * Obtiene todas las reglas actuales
+     */
+    getRules(): TriggerRule[];
+    /**
+     * Verifica si una regla está en cooldown
+     */
+    protected checkCooldown(ruleId: string, cooldown: number): boolean;
+    /**
+     * Determina si se deben evaluar todas las reglas o solo la primera coincidente
+     */
+    protected shouldEvaluateAll(): boolean;
+    /**
+     * Obtiene el contexto de estado (puede ser sobrescrito por subclases)
+     */
+    protected getStateContext?(): Record<string, any>;
+    /**
+     * Evalúa condiciones de una regla
+     */
+    protected evaluateConditions(condition: RuleCondition | RuleCondition[] | undefined, context: TriggerContext): boolean;
+    /**
+     * Evalúa una condición individual
+     */
+    protected evaluateSingleCondition(cond: RuleCondition, context: TriggerContext): boolean;
+    /**
+     * Ejecuta las acciones de una regla
+     */
+    protected executeRuleActions(actionConfig: Action | Action[] | ActionGroup, context: TriggerContext): Promise<TriggerResult['executedActions']>;
+    /**
+     * Ejecuta una acción individual
+     */
+    protected executeSingleAction(action: Action, context: TriggerContext): Promise<TriggerResult['executedActions'][0]>;
+    /**
+     * Interpola parámetros con variables del contexto
+     */
+    protected interpolateParams(params: Record<string, any>, context: TriggerContext): Record<string, any>;
+    /**
+     * Interpolación recursiva para objetos anidados
+     */
+    protected interpolateDeep(obj: any, context: TriggerContext): any;
+    get rules(): TriggerRule[];
+    get config(): RuleEngineConfig | undefined;
+    set rules(newRules: TriggerRule[]);
+}
+export type { TriggerEngine as BaseEngine };
+//# sourceMappingURL=trigger-engine.d.ts.map

package/dist/core/trigger-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-engine.d.ts","sourceRoot":"","sources":["../../src/core/trigger-engine.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,MAAM,EACN,WAAW,EACX,aAAa,EAGb,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAMlB,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAE/F,qBAAa,aAAa;IACxB,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,CAAM;IACrC,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAa;IACvE,SAAS,CAAC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IACzD,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAErC;;OAEG;gBACS,aAAa,GAAE,WAAW,EAAE,GAAG,gBAAqB;IAYhE;;OAEG;IACH,SAAS,CAAC,SAAS,IAAI,IAAI;IAI3B;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAIhE;;OAEG;IACG,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAoCrE;;;OAGG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAAE,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAWxI;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAK1C;;OAEG;IACH,QAAQ,IAAI,WAAW,EAAE;IAIzB;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMlE;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,OAAO;IAItC;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAIjD;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAC1B,SAAS,EAAE,aAAa,GAAG,aAAa,EAAE,GAAG,SAAS,EACtD,OAAO,EAAE,cAAc,GACtB,OAAO;IAUV;;OAEG;IACH,SAAS,CAAC,uBAAuB,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO;IAwBxF;;OAEG;cACa,kBAAkB,CAChC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,WAAW,EAC7C,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAoD5C;;OAEG;cACa,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IAsD/C;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IActG;;OAEG;IACH,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,cAAc,GAAG,GAAG;IAYjE,IAAI,KAAK,IAAI,WAAW,EAAE,CAEzB;IAED,IAAI,MAAM,IAAI,gBAAgB,GAAG,SAAS,CAEzC;IAGD,IAAI,KAAK,CAAC,QAAQ,EAAE,WAAW,EAAE,EAGhC;CACF;AAGD,YAAY,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}