@sebasoft/neuron-js 0.3.0 → 0.5.0

package/dist/esm/interfaces/Element.d.ts

@@ -1,6 +1,22 @@
+/**
+ * Represents the base interface for all elements within the rules engine.
+ * Elements are the building blocks of scripts, pulses, actions, conditions, and parameters.
+ *
+ * @template TOptions - The type of configuration options for this element.
+ */
 export interface ElementInterface<TOptions = any> {
+    /**
+     * Unique identifier for the element instance.
+     */
     id: string;
+    /**
+     * The registered type name of the element.
+     * This type is used by the Registry (Neuron) to look up the correct implementation.
+     */
     type: string;
+    /**
+     * Configuration options specific to this element instance.
+     */
     options: TOptions;
 }
 //# sourceMappingURL=Element.d.ts.map

package/dist/esm/interfaces/Element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Element.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Element.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB,CAAC,QAAQ,GAAG,GAAG;IAC9C,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;CACnB"}
+{"version":3,"file":"Element.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Element.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ,GAAG,GAAG;IAC9C;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,QAAQ,CAAC;CACnB"}

package/dist/esm/interfaces/HookEvents.d.ts

@@ -1,15 +1,31 @@
+/**
+ * Enumeration of all lifecycle events emitted during script execution.
+ * These can be used with a HookEmitter to monitor performance, log data, or handle side effects.
+ */
 export declare enum HookEvents {
+    /** Emitted when the execution of a script starts. */
     ON_SCRIPT_START = "on_script_start",
+    /** Emitted when a specific rule begins evaluation. */
     ON_RULE_START = "on_rule_start",
+    /** Emitted before a condition starts evaluation. */
     ON_CONDITION_START = "pre_condition_start",
+    /** Emitted before an action starts execution. */
     ON_ACTION_START = "pre_action_start",
+    /** Emitted when a script successfully completes all rules. */
     ON_SCRIPT_END = "pre_script_end",
+    /** Emitted when a rule finishes evaluation (regardless of outcome). */
     ON_RULE_END = "on_rule_end",
+    /** Emitted after a condition evaluation completes. */
     ON_CONDITION_END = "pre_condition_end",
+    /** Emitted after an action execution completes. */
     ON_ACTION_END = "pre_action_end",
+    /** Emitted if an unhandled error occurs during script execution. */
     ON_SCRIPT_ERROR = "on_script_error",
+    /** Emitted if an error occurs while evaluating a specific rule. */
     ON_RULE_ERROR = "on_rule_error",
+    /** Emitted if an error occurs during condition evaluation. */
     ON_CONDITION_ERROR = "on_condition_error",
+    /** Emitted if an error occurs during action execution. */
     ON_ACTION_ERROR = "on_action_error"
 }
 //# sourceMappingURL=HookEvents.d.ts.map

package/dist/esm/interfaces/HookEvents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HookEvents.d.ts","sourceRoot":"","sources":["../../../src/interfaces/HookEvents.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,kBAAkB,wBAAwB;IAC1C,eAAe,qBAAqB;IACpC,aAAa,mBAAmB;IAChC,WAAW,gBAAgB;IAC3B,gBAAgB,sBAAsB;IACtC,aAAa,mBAAmB;IAChC,eAAe,oBAAoB;IACnC,aAAa,kBAAkB;IAC/B,kBAAkB,uBAAuB;IACzC,eAAe,oBAAoB;CACpC"}
+{"version":3,"file":"HookEvents.d.ts","sourceRoot":"","sources":["../../../src/interfaces/HookEvents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,UAAU;IACpB,qDAAqD;IACrD,eAAe,oBAAoB;IACnC,sDAAsD;IACtD,aAAa,kBAAkB;IAC/B,oDAAoD;IACpD,kBAAkB,wBAAwB;IAC1C,iDAAiD;IACjD,eAAe,qBAAqB;IACpC,8DAA8D;IAC9D,aAAa,mBAAmB;IAChC,uEAAuE;IACvE,WAAW,gBAAgB;IAC3B,sDAAsD;IACtD,gBAAgB,sBAAsB;IACtC,mDAAmD;IACnD,aAAa,mBAAmB;IAChC,oEAAoE;IACpE,eAAe,oBAAoB;IACnC,mEAAmE;IACnE,aAAa,kBAAkB;IAC/B,8DAA8D;IAC9D,kBAAkB,uBAAuB;IACzC,0DAA0D;IAC1D,eAAe,oBAAoB;CACpC"}

package/dist/esm/interfaces/HookEvents.js

@@ -1,16 +1,32 @@
+/**
+ * Enumeration of all lifecycle events emitted during script execution.
+ * These can be used with a HookEmitter to monitor performance, log data, or handle side effects.
+ */
 export var HookEvents;
 (function (HookEvents) {
+    /** Emitted when the execution of a script starts. */
     HookEvents["ON_SCRIPT_START"] = "on_script_start";
+    /** Emitted when a specific rule begins evaluation. */
     HookEvents["ON_RULE_START"] = "on_rule_start";
+    /** Emitted before a condition starts evaluation. */
     HookEvents["ON_CONDITION_START"] = "pre_condition_start";
+    /** Emitted before an action starts execution. */
     HookEvents["ON_ACTION_START"] = "pre_action_start";
+    /** Emitted when a script successfully completes all rules. */
     HookEvents["ON_SCRIPT_END"] = "pre_script_end";
+    /** Emitted when a rule finishes evaluation (regardless of outcome). */
     HookEvents["ON_RULE_END"] = "on_rule_end";
+    /** Emitted after a condition evaluation completes. */
     HookEvents["ON_CONDITION_END"] = "pre_condition_end";
+    /** Emitted after an action execution completes. */
     HookEvents["ON_ACTION_END"] = "pre_action_end";
+    /** Emitted if an unhandled error occurs during script execution. */
     HookEvents["ON_SCRIPT_ERROR"] = "on_script_error";
+    /** Emitted if an error occurs while evaluating a specific rule. */
     HookEvents["ON_RULE_ERROR"] = "on_rule_error";
+    /** Emitted if an error occurs during condition evaluation. */
     HookEvents["ON_CONDITION_ERROR"] = "on_condition_error";
+    /** Emitted if an error occurs during action execution. */
     HookEvents["ON_ACTION_ERROR"] = "on_action_error";
 })(HookEvents || (HookEvents = {}));
 //# sourceMappingURL=HookEvents.js.map

package/dist/esm/interfaces/HookEvents.js.map

@@ -1 +1 @@
-{"version":3,"file":"HookEvents.js","sourceRoot":"","sources":["../../../src/interfaces/HookEvents.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,UAaX;AAbD,WAAY,UAAU;IACpB,iDAAmC,CAAA;IACnC,6CAA+B,CAAA;IAC/B,wDAA0C,CAAA;IAC1C,kDAAoC,CAAA;IACpC,8CAAgC,CAAA;IAChC,yCAA2B,CAAA;IAC3B,oDAAsC,CAAA;IACtC,8CAAgC,CAAA;IAChC,iDAAmC,CAAA;IACnC,6CAA+B,CAAA;IAC/B,uDAAyC,CAAA;IACzC,iDAAmC,CAAA;AACrC,CAAC,EAbW,UAAU,KAAV,UAAU,QAarB"}
+{"version":3,"file":"HookEvents.js","sourceRoot":"","sources":["../../../src/interfaces/HookEvents.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAN,IAAY,UAyBX;AAzBD,WAAY,UAAU;IACpB,qDAAqD;IACrD,iDAAmC,CAAA;IACnC,sDAAsD;IACtD,6CAA+B,CAAA;IAC/B,oDAAoD;IACpD,wDAA0C,CAAA;IAC1C,iDAAiD;IACjD,kDAAoC,CAAA;IACpC,8DAA8D;IAC9D,8CAAgC,CAAA;IAChC,uEAAuE;IACvE,yCAA2B,CAAA;IAC3B,sDAAsD;IACtD,oDAAsC,CAAA;IACtC,mDAAmD;IACnD,8CAAgC,CAAA;IAChC,oEAAoE;IACpE,iDAAmC,CAAA;IACnC,mEAAmE;IACnE,6CAA+B,CAAA;IAC/B,8DAA8D;IAC9D,uDAAyC,CAAA;IACzC,0DAA0D;IAC1D,iDAAmC,CAAA;AACrC,CAAC,EAzBW,UAAU,KAAV,UAAU,QAyBrB"}

package/dist/esm/interfaces/Parameter.d.ts

@@ -1,7 +1,23 @@
 import type { ElementInterface } from "./Element.js";
+/**
+ * Represents a configurable input value for Actions and Conditions.
+ * Parameters allow for reusable logic templates by decoupling the implementation from the values.
+ *
+ * @template TValue - The primitive or complex type of the parameter's value.
+ * @template TOptions - The type of configuration options for this parameter.
+ */
 export interface ParameterInterface<TValue = any, TOptions = any> extends ElementInterface<TOptions> {
+    /**
+     * The semantic name of the parameter (e.g., "recipient", "threshold").
+     */
     name: string;
+    /**
+     * The actual value assigned to the parameter.
+     */
     value: TValue | null;
+    /**
+     * An optional fallback value if the primary value is missing or null.
+     */
     defaultValue?: TValue;
 }
 //# sourceMappingURL=Parameter.d.ts.map

package/dist/esm/interfaces/Parameter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Parameter.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Parameter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,CAC9D,SAAQ,gBAAgB,CAAC,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}
+{"version":3,"file":"Parameter.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Parameter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB,CAAC,MAAM,GAAG,GAAG,EAAE,QAAQ,GAAG,GAAG,CAC9D,SAAQ,gBAAgB,CAAC,QAAQ,CAAC;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/esm/interfaces/Rule.d.ts

@@ -1,11 +1,34 @@
 import type { ActionInterface } from "./Action.js";
 import type { ConditionInterface } from "./Condition.js";
 import type { ElementInterface } from "./Element.js";
+/**
+ * Configuration options for a Rule.
+ */
 export interface RuleOptions {
+    /**
+     * Whether the rule is disabled and should be skipped.
+     */
     disabled?: boolean;
 }
+/**
+ * Represents a logical unit containing conditions and actions.
+ * A Rule executes its actions only if its conditions evaluate to true.
+ *
+ * - **Empty Conditions**: The rule is considered "Always" and will automatically execute actions.
+ * - **Empty Actions**: The rule will "Do Nothing" (no side effects).
+ *
+ * @template TOptions - The type of configuration options for this rule.
+ */
 export interface RuleInterface<TOptions extends RuleOptions = RuleOptions> extends ElementInterface<TOptions> {
+    /**
+     * List of conditions that must be satisfied for the actions to execute.
+     * If empty, actions are always executed.
+     */
     conditions: ConditionInterface[];
+    /**
+     * List of actions to perform if the conditions are met.
+     * If empty, the rule has no side effects.
+     */
     actions: ActionInterface[];
 }
 //# sourceMappingURL=Rule.d.ts.map

package/dist/esm/interfaces/Rule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Rule.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,CACvE,SAAQ,gBAAgB,CAAC,QAAQ,CAAC;IAClC,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"Rule.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Rule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa,CAAC,QAAQ,SAAS,WAAW,GAAG,WAAW,CACvE,SAAQ,gBAAgB,CAAC,QAAQ,CAAC;IAClC;;;OAGG;IACH,UAAU,EAAE,kBAAkB,EAAE,CAAC;IAEjC;;;OAGG;IACH,OAAO,EAAE,eAAe,EAAE,CAAC;CAC5B"}

package/dist/esm/interfaces/Script.d.ts

@@ -1,6 +1,16 @@
 import type { RuleInterface } from "./Rule.js";
+/**
+ * Represents a complete set of rules to be executed by the engine.
+ * The script is the top-level serializable container for all logic.
+ */
 export interface ScriptInterface {
+    /**
+     * Unique identifier for the script.
+     */
     id: string;
+    /**
+     * The ordered list of rules that comprise the script's logic.
+     */
     rules: RuleInterface[];
 }
 //# sourceMappingURL=Script.d.ts.map

package/dist/esm/interfaces/Script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Script.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB"}
+{"version":3,"file":"Script.d.ts","sourceRoot":"","sources":["../../../src/interfaces/Script.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB"}

package/dist/esm/runtime/ActionRuntime.js

@@ -14,7 +14,7 @@ export class ActionRuntime {
         let currentContext = context;
         let actionsExecuted = 0;
         for (const actionItem of this._actions) {
-            if (actionItem.options.disabled) {
+            if (actionItem.options?.disabled) {
                 continue;
             }
             this._hookEmitter?.(HookEvents.ON_ACTION_START, currentContext);

package/dist/esm/runtime/ActionRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"ActionRuntime.js","sourceRoot":"","sources":["../../../src/runtime/ActionRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,MAAM,OAAO,aAAa;IAEL;IACA;IACA;IAHnB,YACmB,QAA2B,EAC3B,OAAe,EACf,YAA0B;QAF1B,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,YAAO,GAAP,OAAO,CAAQ;QACf,iBAAY,GAAZ,YAAY,CAAc;IAC1C,CAAC;IAEJ,OAAO,CAAC,OAAyB;QAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,cAAc,GAAG,OAAO,CAAC;QAC7B,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;gBAChC,SAAS;YACX,CAAC;YAED,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;YAEhE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,WAAW,CAAC,IAAI,CAAC,iCAAiC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrE,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;gBAChE,OAAO,IAAI,eAAe,CACxB,KAAK,EACL,cAAc,EACd,eAAe,EACf,WAAW,CACZ,CAAC;YACJ,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,UAAU,CACnC,UAAU,CAAC,EAAE,EACb,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,OAAO,EAClB,IAAI,CAAC,OAAO,CACb,CAAC;YAEF,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC5D,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE3C,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,CAAC;gBACjC,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;gBAChE,OAAO,IAAI,eAAe,CACxB,KAAK,EACL,cAAc,EACd,eAAe,EACf,WAAW,CACZ,CAAC;YACJ,CAAC;YAED,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC;YACtC,eAAe,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,EAAE,yBAAyB,CAAC,CAAC;YAC1E,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,eAAe,CACxB,IAAI,EACJ,cAAc,EACd,eAAe,EACf,WAAW,CACZ,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"ActionRuntime.js","sourceRoot":"","sources":["../../../src/runtime/ActionRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,MAAM,OAAO,aAAa;IAEL;IACA;IACA;IAHnB,YACmB,QAA2B,EAC3B,OAAe,EACf,YAA0B;QAF1B,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,YAAO,GAAP,OAAO,CAAQ;QACf,iBAAY,GAAZ,YAAY,CAAc;IAC1C,CAAC;IAEJ,OAAO,CAAC,OAAyB;QAC/B,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,cAAc,GAAG,OAAO,CAAC;QAC7B,IAAI,eAAe,GAAG,CAAC,CAAC;QAExB,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;YAEhE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,WAAW,CAAC,IAAI,CAAC,iCAAiC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrE,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;gBAChE,OAAO,IAAI,eAAe,CACxB,KAAK,EACL,cAAc,EACd,eAAe,EACf,WAAW,CACZ,CAAC;YACJ,CAAC;YAED,MAAM,cAAc,GAAG,IAAI,UAAU,CACnC,UAAU,CAAC,EAAE,EACb,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,OAAO,EAClB,IAAI,CAAC,OAAO,CACb,CAAC;YAEF,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;YAC5D,WAAW,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;YAE3C,IAAI,CAAC,YAAY,CAAC,YAAY,EAAE,EAAE,CAAC;gBACjC,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,eAAe,EAAE,cAAc,CAAC,CAAC;gBAChE,OAAO,IAAI,eAAe,CACxB,KAAK,EACL,cAAc,EACd,eAAe,EACf,WAAW,CACZ,CAAC;YACJ,CAAC;YAED,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC;YACtC,eAAe,EAAE,CAAC;YAClB,WAAW,CAAC,IAAI,CAAC,iBAAiB,UAAU,CAAC,EAAE,yBAAyB,CAAC,CAAC;YAC1E,IAAI,CAAC,YAAY,EAAE,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,eAAe,CACxB,IAAI,EACJ,cAAc,EACd,eAAe,EACf,WAAW,CACZ,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/runtime/ConditionRuntime.js

@@ -17,11 +17,11 @@ export class ConditionRuntime {
         const orGroups = [[]];
         let groupIndex = 0;
         for (const conditionItem of this._conditions) {
-            if (conditionItem.options.disabled) {
+            if (conditionItem.options?.disabled) {
                 continue;
             }
             this._hookEmitter?.(HookEvents.ON_CONDITION_START, context);
-            if (conditionItem.options.orCondition &&
+            if (conditionItem.options?.orCondition &&
                 orGroups[groupIndex].length > 0) {
                 groupIndex++;
                 orGroups[groupIndex] = [];
@@ -39,7 +39,7 @@ export class ConditionRuntime {
                 this._hookEmitter?.(HookEvents.ON_CONDITION_ERROR, context);
                 return new ExecutionResult(false, context, false, messageList);
             }
-            const verdict = conditionItem.options.inverted
+            const verdict = conditionItem.options?.inverted
                 ? !conditionResult.value
                 : !!conditionResult.value;
             orGroups[groupIndex].push(verdict);

package/dist/esm/runtime/ConditionRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConditionRuntime.js","sourceRoot":"","sources":["../../../src/runtime/ConditionRuntime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ConditionRuntime.js","sourceRoot":"","sources":["../../../src/runtime/ConditionRuntime.ts"],"names":[],"mappings":"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"}

package/dist/esm/runtime/RuleRuntime.js

@@ -16,7 +16,7 @@ export class RuleRuntime {
         let currentContext = context;
         let rulesExecuted = 0;
         for (const ruleItem of this._rules) {
-            if (ruleItem.options.disabled) {
+            if (ruleItem.options?.disabled) {
                 continue;
             }
             const RuleCtor = this._neuron.getRule(ruleItem.type);

package/dist/esm/runtime/RuleRuntime.js.map

@@ -1 +1 @@
-{"version":3,"file":"RuleRuntime.js","sourceRoot":"","sources":["../../../src/runtime/RuleRuntime.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"RuleRuntime.js","sourceRoot":"","sources":["../../../src/runtime/RuleRuntime.ts"],"names":[],"mappings":"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"}

package/dist/esm/types/ExecutionContext.d.ts

@@ -1,15 +1,28 @@
+/**
+ * Severity levels for execution messages.
+ */
 export declare enum MessageType {
     DEBUG = "debug",
     INFO = "info",
     WARN = "warn",
     ERROR = "error"
 }
+/**
+ * Represents a log message or audit entry generated during execution.
+ */
 export interface ExecutionMessage {
+    /** The severity level of the message. */
     type: MessageType;
+    /** The descriptive text of the message. */
     text: string;
 }
+/**
+ * The shared state container that travels through the execution engine.
+ */
 export interface ExecutionContext {
+    /** Accumulation of all messages generated during the current script run. */
     messages: ExecutionMessage[];
+    /** The primary data object being processed and mutated by actions. */
     state: Record<string, any>;
 }
 //# sourceMappingURL=ExecutionContext.d.ts.map

package/dist/esm/types/ExecutionContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/ExecutionContext.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B"}
+{"version":3,"file":"ExecutionContext.d.ts","sourceRoot":"","sources":["../../../src/types/ExecutionContext.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,IAAI,EAAE,WAAW,CAAC;IAClB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B"}

package/dist/esm/types/ExecutionContext.js

@@ -1,3 +1,6 @@
+/**
+ * Severity levels for execution messages.
+ */
 export var MessageType;
 (function (MessageType) {
     MessageType["DEBUG"] = "debug";

package/dist/esm/types/ExecutionContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionContext.js","sourceRoot":"","sources":["../../../src/types/ExecutionContext.ts"],"names":[],"mappings":"AAAA,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,8BAAe,CAAA;AACjB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}
+{"version":3,"file":"ExecutionContext.js","sourceRoot":"","sources":["../../../src/types/ExecutionContext.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAN,IAAY,WAKX;AALD,WAAY,WAAW;IACrB,8BAAe,CAAA;IACf,4BAAa,CAAA;IACb,4BAAa,CAAA;IACb,8BAAe,CAAA;AACjB,CAAC,EALW,WAAW,KAAX,WAAW,QAKtB"}

package/dist/esm/types/ExecutionResult.d.ts

@@ -1,10 +1,24 @@
 import type { ExecutionContext } from "./ExecutionContext.js";
+/**
+ * Represents the outcome of an execution unit (Script, Rule, Action, or Condition).
+ *
+ * @template TValue - The type of the value produced by the execution (e.g., number of rules for a Script, boolean for a Condition).
+ */
 export declare class ExecutionResult<TValue = any> {
     readonly success: boolean;
     readonly context: ExecutionContext;
     readonly value: TValue | null;
     readonly messages: string[];
+    /**
+     * @param success - Whether the execution completed without errors.
+     * @param context - The state of the ExecutionContext after the run.
+     * @param value - The primary output of the execution.
+     * @param messages - Any informational or error messages generated.
+     */
     constructor(success: boolean, context: ExecutionContext, value?: TValue | null, messages?: string[]);
+    /**
+     * Helper to check if the execution was successful.
+     */
     isSuccessful(): boolean;
 }
 //# sourceMappingURL=ExecutionResult.d.ts.map

package/dist/esm/types/ExecutionResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionResult.d.ts","sourceRoot":"","sources":["../../../src/types/ExecutionResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,qBAAa,eAAe,CAAC,MAAM,GAAG,GAAG;aAErB,OAAO,EAAE,OAAO;aAChB,OAAO,EAAE,gBAAgB;aACzB,KAAK,EAAE,MAAM,GAAG,IAAI;aACpB,QAAQ,EAAE,MAAM,EAAE;gBAHlB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,EACzB,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,QAAQ,GAAE,MAAM,EAAO;IAGzC,YAAY,IAAI,OAAO;CAGxB"}
+{"version":3,"file":"ExecutionResult.d.ts","sourceRoot":"","sources":["../../../src/types/ExecutionResult.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,eAAe,CAAC,MAAM,GAAG,GAAG;aAQrB,OAAO,EAAE,OAAO;aAChB,OAAO,EAAE,gBAAgB;aACzB,KAAK,EAAE,MAAM,GAAG,IAAI;aACpB,QAAQ,EAAE,MAAM,EAAE;IAVpC;;;;;OAKG;gBAEe,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,gBAAgB,EACzB,KAAK,GAAE,MAAM,GAAG,IAAW,EAC3B,QAAQ,GAAE,MAAM,EAAO;IAGzC;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB"}

package/dist/esm/types/ExecutionResult.js

@@ -1,14 +1,28 @@
+/**
+ * Represents the outcome of an execution unit (Script, Rule, Action, or Condition).
+ *
+ * @template TValue - The type of the value produced by the execution (e.g., number of rules for a Script, boolean for a Condition).
+ */
 export class ExecutionResult {
     success;
     context;
     value;
     messages;
+    /**
+     * @param success - Whether the execution completed without errors.
+     * @param context - The state of the ExecutionContext after the run.
+     * @param value - The primary output of the execution.
+     * @param messages - Any informational or error messages generated.
+     */
     constructor(success, context, value = null, messages = []) {
         this.success = success;
         this.context = context;
         this.value = value;
         this.messages = messages;
     }
+    /**
+     * Helper to check if the execution was successful.
+     */
     isSuccessful() {
         return this.success;
     }

package/dist/esm/types/ExecutionResult.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExecutionResult.js","sourceRoot":"","sources":["../../../src/types/ExecutionResult.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IAER;IACA;IACA;IACA;IAJlB,YACkB,OAAgB,EAChB,OAAyB,EACzB,QAAuB,IAAI,EAC3B,WAAqB,EAAE;QAHvB,YAAO,GAAP,OAAO,CAAS;QAChB,YAAO,GAAP,OAAO,CAAkB;QACzB,UAAK,GAAL,KAAK,CAAsB;QAC3B,aAAQ,GAAR,QAAQ,CAAe;IACtC,CAAC;IAEJ,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}
+{"version":3,"file":"ExecutionResult.js","sourceRoot":"","sources":["../../../src/types/ExecutionResult.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAQR;IACA;IACA;IACA;IAVlB;;;;;OAKG;IACH,YACkB,OAAgB,EAChB,OAAyB,EACzB,QAAuB,IAAI,EAC3B,WAAqB,EAAE;QAHvB,YAAO,GAAP,OAAO,CAAS;QAChB,YAAO,GAAP,OAAO,CAAkB;QACzB,UAAK,GAAL,KAAK,CAAsB;QAC3B,aAAQ,GAAR,QAAQ,CAAe;IACtC,CAAC;IAEJ;;OAEG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;CACF"}

package/dist/esm/types/HookEmitter.d.ts

@@ -1,4 +1,11 @@
 import type { HookEvents } from "../interfaces/HookEvents.js";
 import type { ExecutionContext } from "../types/ExecutionContext.js";
-export type HookEmitter = (event: HookEvents, context: ExecutionContext) => void;
+/**
+ * Functional type for lifecycle hook callbacks.
+ */
+export type HookEmitter = (
+/** The lifecycle event being triggered. */
+event: HookEvents, 
+/** The current state of the execution context. */
+context: ExecutionContext) => void;
 //# sourceMappingURL=HookEmitter.d.ts.map

package/dist/esm/types/HookEmitter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HookEmitter.d.ts","sourceRoot":"","sources":["../../../src/types/HookEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG,CACxB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,gBAAgB,KACtB,IAAI,CAAC"}
+{"version":3,"file":"HookEmitter.d.ts","sourceRoot":"","sources":["../../../src/types/HookEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG;AACxB,2CAA2C;AAC3C,KAAK,EAAE,UAAU;AACjB,kDAAkD;AAClD,OAAO,EAAE,gBAAgB,KACtB,IAAI,CAAC"}

package/examples/README.md

@@ -0,0 +1,24 @@
+# Runnable Examples
+
+These examples are copy-paste friendly Neuron-JS scenarios. Each folder contains a serializable `rules.json`, an `input.json` execution context, an `expected-output.json` contract, and a `run.ts` file that executes and verifies the scenario.
+
+## Available examples
+
+- [Pricing rules](pricing-rules/) — apply a VIP discount when a cart meets a subtotal threshold.
+- [Eligibility check](eligibility-check/) — approve an applicant when a score crosses a threshold.
+- [Workflow routing](workflow-routing/) — route a high-priority support ticket to an escalation lane.
+
+## Run all examples
+
+From the repository root:
+
+```bash
+yarn examples
+```
+
+Or run one example directly after building:
+
+```bash
+yarn build
+node examples/pricing-rules/run.ts
+```

package/examples/eligibility-check/README.md

@@ -0,0 +1,31 @@
+# Eligibility Check Example
+
+Run an eligibility decision from JSON. The rule checks whether an applicant score passes the required threshold, then writes the approved status into the execution context.
+
+## Run
+
+From the repository root:
+
+```bash
+yarn build
+node examples/eligibility-check/run.ts
+```
+
+Expected summary:
+
+```json
+{
+  "ok": true,
+  "rulesExecuted": 1,
+  "eligible": true,
+  "decision": "approved",
+  "messages": ["Eligibility decision: approved"]
+}
+```
+
+## Files
+
+- `rules.json` — the serializable Neuron-JS script.
+- `input.json` — the execution context used by the script.
+- `expected-output.json` — the checked output summary.
+- `run.ts` — registers the example vocabulary, executes the script, and fails if output differs.

package/examples/eligibility-check/expected-output.json

@@ -0,0 +1,7 @@
+{
+  "ok": true,
+  "rulesExecuted": 1,
+  "eligible": true,
+  "decision": "approved",
+  "messages": ["Eligibility decision: approved"]
+}

package/examples/eligibility-check/input.json

@@ -0,0 +1,6 @@
+{
+  "messages": [],
+  "state": {
+    "applicant": { "score": 735, "region": "AR" }
+  }
+}

package/examples/eligibility-check/rules.json

@@ -0,0 +1,32 @@
+{
+  "id": "eligibility-check-demo",
+  "rules": [
+    {
+      "id": "approve-qualified-applicant",
+      "type": "simple_rule",
+      "options": {},
+      "conditions": [
+        {
+          "id": "score-threshold",
+          "type": "compare_two_numbers",
+          "options": {},
+          "params": [
+            { "id": "applicant-score", "name": "op1", "type": "state_number", "value": "applicant.score", "options": {} },
+            { "id": "comparison", "name": "comp", "type": "comparator", "value": ">=", "options": {} },
+            { "id": "required-score", "name": "op2", "type": "simple_number", "value": "700", "options": {} }
+          ]
+        }
+      ],
+      "actions": [
+        {
+          "id": "mark-approved",
+          "type": "set_decision",
+          "options": {},
+          "params": [
+            { "id": "decision-value", "name": "decision", "type": "simple_string", "value": "approved", "options": {} }
+          ]
+        }
+      ]
+    }
+  ]
+}