@infitx/decision 1.4.2 → 1.4.4

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## [1.4.4](https://github.com/infitx-org/release-cd/compare/decision-v1.4.3...decision-v1.4.4) (2026-03-14)
+
+
+### Bug Fixes
+
+* update build workflow and add allure configuration files ([169bdb8](https://github.com/infitx-org/release-cd/commit/169bdb80a48041b40dcd2a54206c76bd2fe8d900))
+
+## [1.4.3](https://github.com/infitx-org/release-cd/compare/decision-v1.4.2...decision-v1.4.3) (2026-03-02)
+
+
+### Bug Fixes
+
+* publish definitions ([b0534e0](https://github.com/infitx-org/release-cd/commit/b0534e05cf2fa5b9f7baee07c109bb3775dd38cd))
+
 ## [1.4.2](https://github.com/infitx-org/release-cd/compare/decision-v1.4.1...decision-v1.4.2) (2026-02-26)
 
 

package/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Configuration for the decision engine
+ */
+export interface DecisionConfig {
+    /**
+     * Rules configuration - can be an array or object with rule names as keys
+     */
+    rules?: Rule[] | Record<string, RuleDefinition>;
+
+    /**
+     * Additional configuration properties
+     */
+    [key: string]: any;
+}
+
+/**
+ * Rule definition structure
+ */
+export interface RuleDefinition {
+    /**
+     * Optional priority for rule evaluation (higher priority evaluated first)
+     */
+    priority?: number | string;
+
+    /**
+     * Condition pattern that the fact must match
+     */
+    when: any;
+
+    /**
+     * Result to return when condition matches (can be object or function)
+     */
+    then: Record<string, any> | ((fact: any) => Record<string, any>);
+}
+
+/**
+ * Normalized rule structure used internally
+ */
+export interface Rule extends RuleDefinition {
+    /**
+     * Rule identifier
+     */
+    rule: string | number;
+}
+
+/**
+ * Decision result structure
+ */
+export interface Decision {
+    /**
+     * Name/identifier of the rule that matched
+     */
+    rule: string | number;
+
+    /**
+     * Decision key from the 'then' clause
+     */
+    decision: string;
+
+    /**
+     * Additional properties from the 'then' clause value
+     */
+    [key: string]: any;
+}
+
+/**
+ * Decision engine instance
+ */
+export interface DecisionEngine extends DecisionConfig {
+    /**
+     * Normalized array of rules
+     */
+    rules: Rule[];
+
+    /**
+     * Evaluate a fact against configured rules
+     *
+     * @param fact - The fact object to evaluate
+     * @param all - If true, returns all matching rules; if false, returns first match
+     * @returns Array of decisions (empty array if no matches when all=true, null if no match when all=false)
+     *
+     * @example
+     * ```typescript
+     * const engine = decision('./rules.yaml');
+     * const result = engine.decide({ type: 'transfer', amount: 500 });
+     * // Returns: [{ rule: 'approve-small', decision: 'approved', ...}]
+     * ```
+     */
+    decide(fact: any, all?: boolean): Decision[] | null;
+}
+
+/**
+ * Create a decision engine from a configuration file or object
+ *
+ * @param config - Path to YAML config file or configuration object
+ * @returns Decision engine instance with rules and decide function
+ *
+ * @example
+ * ```typescript
+ * // From file
+ * const engine = decision('./rules.yaml');
+ *
+ * // From object
+ * const engine = decision({
+ *   rules: {
+ *     'approve-small': {
+ *       when: { amount: { max: 1000 } },
+ *       then: { approved: true }
+ *     }
+ *   }
+ * });
+ *
+ * const result = engine.decide({ amount: 500 });
+ * ```
+ */
+export default function decision(config: string | DecisionConfig): DecisionEngine;

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@infitx/decision",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "Decision tables engine",
   "main": "index.js",
   "dependencies": {
     "yaml": "^2.8.2",
-    "@infitx/match": "1.5.2"
+    "@infitx/match": "1.5.4"
   },
   "devDependencies": {
     "allure": "^3.2.0",