@f-o-t/rules-engine 3.0.0 → 3.0.5

package/dist/utils/conditions.d.ts

@@ -0,0 +1,24 @@
+import { type Condition, type ConditionGroup } from "@f-o-t/condition-evaluator";
+/**
+ * Collects all unique field names from a condition tree.
+ * Traverses nested condition groups recursively.
+ */
+export declare const collectConditionFields: (condition: ConditionGroup) => Set<string>;
+/**
+ * Collects all unique operators from a condition tree.
+ * Returns a map of operator to its type (e.g., "equals" -> "string").
+ */
+export declare const collectConditionOperators: (condition: ConditionGroup) => Map<string, Set<string>>;
+/**
+ * Counts the total number of leaf conditions in a condition tree.
+ */
+export declare const countConditions: (condition: Condition | ConditionGroup) => number;
+/**
+ * Calculates the maximum depth of a condition tree.
+ */
+export declare const calculateMaxDepth: (condition: Condition | ConditionGroup, currentDepth?: number) => number;
+/**
+ * Counts the number of condition groups in a condition tree.
+ */
+export declare const countConditionGroups: (condition: Condition | ConditionGroup) => number;
+//# sourceMappingURL=conditions.d.ts.map

package/dist/utils/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../src/utils/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EACJ,KAAK,SAAS,EACd,KAAK,cAAc,EAErB,MAAM,4BAA4B,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAChC,WAAW,cAAc,KACzB,GAAG,CAAC,MAAM,CAeZ,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACnC,WAAW,cAAc,KACzB,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAiBzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,GACzB,WAAW,SAAS,GAAG,cAAc,KACrC,MAQF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC3B,WAAW,SAAS,GAAG,cAAc,EACrC,qBAAgB,KAChB,MAaF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAC9B,WAAW,SAAS,GAAG,cAAc,KACrC,MAYF,CAAC"}

package/dist/utils/hash.d.ts

@@ -0,0 +1,3 @@
+export declare const hashContext: (context: unknown) => string;
+export declare const hashRules: (ruleIds: ReadonlyArray<string>) => string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/utils/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/utils/hash.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,GAAI,SAAS,OAAO,KAAG,MAyB9C,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,SAAS,aAAa,CAAC,MAAM,CAAC,KAAG,MAE1D,CAAC"}

package/dist/utils/id.d.ts

@@ -0,0 +1,2 @@
+export declare const generateId: () => string;
+//# sourceMappingURL=id.d.ts.map

package/dist/utils/id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"id.d.ts","sourceRoot":"","sources":["../../src/utils/id.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU,QAAO,MAK7B,CAAC"}

package/dist/utils/time.d.ts

@@ -0,0 +1,8 @@
+export type TimingResult<T> = {
+    readonly result: T;
+    readonly durationMs: number;
+};
+export declare const measureTime: <T>(fn: () => T) => TimingResult<T>;
+export declare const measureTimeAsync: <T>(fn: () => Promise<T>) => Promise<TimingResult<T>>;
+export declare const withTimeout: <T>(promise: Promise<T>, timeoutMs: number, errorMessage?: string) => Promise<T>;
+//# sourceMappingURL=time.d.ts.map

package/dist/utils/time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAG,YAAY,CAAC,CAAC,CAK1D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAU,CAAC,EACrC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,KACpB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAKzB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,EAC1B,SAAS,OAAO,CAAC,CAAC,CAAC,EACnB,WAAW,MAAM,EACjB,qBAAoC,KACpC,OAAO,CAAC,CAAC,CAgBX,CAAC"}

package/dist/validation/conflicts.d.ts

@@ -0,0 +1,25 @@
+import type { ConsequenceDefinitions, DefaultConsequences } from "../types/consequence";
+import type { Rule } from "../types/rule";
+export type ConflictType = "DUPLICATE_ID" | "DUPLICATE_CONDITIONS" | "OVERLAPPING_CONDITIONS" | "CONTRADICTORY_CONSEQUENCES" | "PRIORITY_COLLISION" | "UNREACHABLE_RULE";
+export type Conflict<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly type: ConflictType;
+    readonly severity: "error" | "warning" | "info";
+    readonly message: string;
+    readonly ruleIds: ReadonlyArray<string>;
+    readonly rules: ReadonlyArray<Rule<TContext, TConsequences>>;
+    readonly details?: Readonly<Record<string, unknown>>;
+};
+export type ConflictDetectionOptions = {
+    readonly checkDuplicateIds?: boolean;
+    readonly checkDuplicateConditions?: boolean;
+    readonly checkOverlappingConditions?: boolean;
+    readonly checkPriorityCollisions?: boolean;
+    readonly checkUnreachableRules?: boolean;
+};
+export declare const detectConflicts: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, options?: ConflictDetectionOptions) => ReadonlyArray<Conflict<TContext, TConsequences>>;
+export declare const hasConflicts: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, options?: ConflictDetectionOptions) => boolean;
+export declare const hasErrors: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, options?: ConflictDetectionOptions) => boolean;
+export declare const getConflictsByType: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(conflicts: ReadonlyArray<Conflict<TContext, TConsequences>>, type: ConflictType) => ReadonlyArray<Conflict<TContext, TConsequences>>;
+export declare const getConflictsBySeverity: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(conflicts: ReadonlyArray<Conflict<TContext, TConsequences>>, severity: "error" | "warning" | "info") => ReadonlyArray<Conflict<TContext, TConsequences>>;
+export declare const formatConflicts: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(conflicts: ReadonlyArray<Conflict<TContext, TConsequences>>) => string;
+//# sourceMappingURL=conflicts.d.ts.map

package/dist/validation/conflicts.d.ts.map

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

package/dist/validation/integrity.d.ts

@@ -0,0 +1,38 @@
+import type { ConsequenceDefinitions, DefaultConsequences } from "../types/consequence";
+import type { Rule, RuleSet } from "../types/rule";
+export type IntegrityIssue = {
+    readonly code: string;
+    readonly message: string;
+    readonly severity: "error" | "warning" | "info";
+    readonly path?: string;
+    readonly ruleId?: string;
+    readonly details?: Readonly<Record<string, unknown>>;
+};
+export type IntegrityCheckResult = {
+    readonly valid: boolean;
+    readonly issues: ReadonlyArray<IntegrityIssue>;
+};
+export type IntegrityCheckOptions = {
+    readonly checkCircularReferences?: boolean;
+    readonly checkOrphanedRuleSets?: boolean;
+    readonly checkMissingReferences?: boolean;
+    readonly checkFieldConsistency?: boolean;
+    readonly requiredFields?: ReadonlyArray<string>;
+    readonly allowedCategories?: ReadonlyArray<string>;
+    readonly allowedTags?: ReadonlyArray<string>;
+};
+export declare const checkIntegrity: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, ruleSets?: ReadonlyArray<RuleSet>, options?: IntegrityCheckOptions) => IntegrityCheckResult;
+export declare const checkRuleFieldCoverage: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>, expectedFields: ReadonlyArray<string>) => {
+    coveredFields: ReadonlyArray<string>;
+    uncoveredFields: ReadonlyArray<string>;
+    extraFields: ReadonlyArray<string>;
+    coveragePercentage: number;
+};
+export declare const getUsedFields: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>) => ReadonlyArray<string>;
+export declare const getUsedOperators: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<Rule<TContext, TConsequences>>) => ReadonlyArray<{
+    field: string;
+    operator: string;
+    type: string;
+}>;
+export declare const formatIntegrityResult: (result: IntegrityCheckResult) => string;
+//# sourceMappingURL=integrity.d.ts.map

package/dist/validation/integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integrity.d.ts","sourceRoot":"","sources":["../../src/validation/integrity.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACT,sBAAsB,EACtB,mBAAmB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;IAChD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACvD,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAChC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACjD,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IACjC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAC1C,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC/C,CAAC;AAqSF,eAAO,MAAM,cAAc,GACxB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,EACnD,WAAU,aAAa,CAAC,OAAO,CAAM,EACrC,UAAS,qBAA0B,KACnC,oBAoBF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAChC,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,EACnD,gBAAgB,aAAa,CAAC,MAAM,CAAC,KACrC;IACA,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACvC,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,kBAAkB,EAAE,MAAM,CAAC;CAyB7B,CAAC;AAEF,eAAO,MAAM,aAAa,GACvB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,KACnD,aAAa,CAAC,MAAM,CAWtB,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC1B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,KACnD,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA4BjE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,QAAQ,oBAAoB,KAAG,MA2BpE,CAAC"}

package/dist/validation/schema.d.ts

@@ -0,0 +1,69 @@
+import { type ConditionGroup } from "@f-o-t/condition-evaluator";
+import { z } from "zod";
+import type { ConsequenceDefinitions, DefaultConsequences } from "../types/consequence";
+import { type Rule } from "../types/rule";
+export declare const ValidationErrorSchema: z.ZodObject<{
+    path: z.ZodString;
+    message: z.ZodString;
+    code: z.ZodString;
+}, z.core.$strip>;
+export type ValidationError = z.infer<typeof ValidationErrorSchema>;
+export declare const ValidationResultSchema: z.ZodObject<{
+    valid: z.ZodBoolean;
+    errors: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        message: z.ZodString;
+        code: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ValidationResult = z.infer<typeof ValidationResultSchema>;
+export declare const ValidationOptionsSchema: z.ZodObject<{
+    validateConditions: z.ZodOptional<z.ZodBoolean>;
+    validateConsequences: z.ZodOptional<z.ZodBoolean>;
+    strictMode: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ValidationOptions = z.infer<typeof ValidationOptionsSchema>;
+export type ResolvedValidationOptions = {
+    validateConditions: boolean;
+    validateConsequences: boolean;
+    strictMode: boolean;
+};
+export declare const validateRule: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rule: unknown, options?: ValidationOptions & {
+    consequenceSchemas?: TConsequences;
+}) => ValidationResult;
+export declare const validateRules: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rules: ReadonlyArray<unknown>, options?: ValidationOptions & {
+    consequenceSchemas?: TConsequences;
+}) => ValidationResult;
+export declare const validateRuleSet: (ruleSet: unknown) => ValidationResult;
+export declare const validateConditions: (conditions: ConditionGroup) => ValidationResult;
+export declare const parseRule: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rule: unknown, options?: ValidationOptions & {
+    consequenceSchemas?: TConsequences;
+}) => Rule<TContext, TConsequences>;
+export declare const safeParseRule: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(rule: unknown, options?: ValidationOptions & {
+    consequenceSchemas?: TConsequences;
+}) => {
+    success: true;
+    data: Rule<TContext, TConsequences>;
+} | {
+    success: false;
+    errors: ReadonlyArray<ValidationError>;
+};
+export declare const createRuleValidator: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(consequenceSchemas: TConsequences, defaultOptions?: ValidationOptions) => {
+    validate: (rule: unknown, options?: ValidationOptions) => {
+        valid: boolean;
+        errors: {
+            path: string;
+            message: string;
+            code: string;
+        }[];
+    };
+    parse: (rule: unknown, options?: ValidationOptions) => Rule<TContext, TConsequences>;
+    safeParse: (rule: unknown, options?: ValidationOptions) => {
+        success: false;
+        errors: ReadonlyArray<ValidationError>;
+    } | {
+        success: true;
+        data: Rule<TContext, TConsequences>;
+    };
+};
+//# sourceMappingURL=schema.d.ts.map

package/dist/validation/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/validation/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAEJ,KAAK,cAAc,EAErB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EACT,sBAAsB,EACtB,mBAAmB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,IAAI,EAA6B,MAAM,eAAe,CAAC;AAMrE,eAAO,MAAM,qBAAqB;;;;iBAIhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,sBAAsB;;;;;;;iBAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,uBAAuB;;;;iBAIlC,CAAC;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAGxE,MAAM,MAAM,yBAAyB,GAAG;IACrC,kBAAkB,EAAE,OAAO,CAAC;IAC5B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,UAAU,EAAE,OAAO,CAAC;CACtB,CAAC;AAsLF,eAAO,MAAM,YAAY,GACtB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,MAAM,OAAO,EACb,UAAS,iBAAiB,GAAG;IAAE,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,KACxE,gBAyCF,CAAC;AAEF,eAAO,MAAM,aAAa,GACvB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,aAAa,CAAC,OAAO,CAAC,EAC7B,UAAS,iBAAiB,GAAG;IAAE,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,KACxE,gBAmBF,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,SAAS,OAAO,KAAG,gBAkBlD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC5B,YAAY,cAAc,KAC1B,gBAGF,CAAC;AAEF,eAAO,MAAM,SAAS,GACnB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,MAAM,OAAO,EACb,UAAS,iBAAiB,GAAG;IAAE,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,KACxE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAQ9B,CAAC;AAEF,eAAO,MAAM,aAAa,GACvB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,MAAM,OAAO,EACb,UAAS,iBAAiB,GAAG;IAAE,kBAAkB,CAAC,EAAE,aAAa,CAAA;CAAO,KAEtE;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAA;CAAE,GACtD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,CAAC,eAAe,CAAC,CAAA;CAM5D,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC7B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,oBAAoB,aAAa,EACjC,iBAAgB,iBAAsB;qBAGlB,OAAO,YAAW,iBAAiB;;;;;;;;kBAMtC,OAAO,YAAW,iBAAiB;sBAM/B,OAAO,YAAW,iBAAiB;iBA5B3C,KAAK;gBAAU,aAAa,CAAC,eAAe,CAAC;;iBAD7C,IAAI;;;CAoCnB,CAAC"}

package/dist/versioning/version-store.d.ts

@@ -0,0 +1,50 @@
+import type { ConsequenceDefinitions, DefaultConsequences } from "../types/consequence";
+import type { Rule } from "../types/rule";
+export type RuleVersion<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly versionId: string;
+    readonly ruleId: string;
+    readonly version: number;
+    readonly rule: Rule<TContext, TConsequences>;
+    readonly createdAt: Date;
+    readonly createdBy?: string;
+    readonly comment?: string;
+    readonly changeType: "create" | "update" | "delete" | "enable" | "disable";
+};
+export type VersionHistory<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly ruleId: string;
+    readonly currentVersion: number;
+    readonly versions: ReadonlyArray<RuleVersion<TContext, TConsequences>>;
+};
+export type VersionStore<TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences> = {
+    readonly histories: ReadonlyMap<string, VersionHistory<TContext, TConsequences>>;
+};
+export declare const createVersionStore: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>() => VersionStore<TContext, TConsequences>;
+export declare const addVersion: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, rule: Rule<TContext, TConsequences>, changeType: RuleVersion<TContext, TConsequences>["changeType"], options?: {
+    createdBy?: string;
+    comment?: string;
+}) => VersionStore<TContext, TConsequences>;
+export declare const getHistory: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, ruleId: string) => VersionHistory<TContext, TConsequences> | undefined;
+export declare const getVersion: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, ruleId: string, version: number) => RuleVersion<TContext, TConsequences> | undefined;
+export declare const getLatestVersion: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, ruleId: string) => RuleVersion<TContext, TConsequences> | undefined;
+export declare const getAllVersions: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, ruleId: string) => ReadonlyArray<RuleVersion<TContext, TConsequences>>;
+export declare const rollbackToVersion: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, ruleId: string, targetVersion: number, options?: {
+    createdBy?: string;
+    comment?: string;
+}) => {
+    store: VersionStore<TContext, TConsequences>;
+    rule: Rule<TContext, TConsequences> | undefined;
+};
+export declare const compareVersions: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, ruleId: string, version1: number, version2: number) => {
+    version1: RuleVersion<TContext, TConsequences> | undefined;
+    version2: RuleVersion<TContext, TConsequences> | undefined;
+    differences: ReadonlyArray<{
+        field: string;
+        oldValue: unknown;
+        newValue: unknown;
+    }>;
+} | null;
+export declare const getVersionsByDateRange: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, startDate: Date, endDate: Date) => ReadonlyArray<RuleVersion<TContext, TConsequences>>;
+export declare const getVersionsByChangeType: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, changeType: RuleVersion<TContext, TConsequences>["changeType"]) => ReadonlyArray<RuleVersion<TContext, TConsequences>>;
+export declare const pruneOldVersions: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(store: VersionStore<TContext, TConsequences>, keepCount: number) => VersionStore<TContext, TConsequences>;
+export declare const formatVersionHistory: <TContext = unknown, TConsequences extends ConsequenceDefinitions = DefaultConsequences>(history: VersionHistory<TContext, TConsequences>) => string;
+//# sourceMappingURL=version-store.d.ts.map

package/dist/versioning/version-store.d.ts.map

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

package/package.json

@@ -1,33 +1,37 @@
 {
-  "name": "@f-o-t/rules-engine",
-  "version": "3.0.0",
-  "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "scripts": {
-    "build": "bun x --bun fot build",
-    "test": "bun x --bun fot test",
-    "lint": "bun x --bun fot lint",
-    "format": "bun x --bun fot format",
-    "typecheck": "bun x --bun fot typecheck"
-  },
-  "dependencies": {
-    "@f-o-t/condition-evaluator": "^2.0.2",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@f-o-t/cli": "^1.0.0",
-    "@f-o-t/config": "^1.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/F-O-T/libraries.git",
-    "directory": "libraries/rules-engine"
-  }
+   "name": "@f-o-t/rules-engine",
+   "version": "3.0.5",
+   "type": "module",
+   "files": [
+      "dist"
+   ],
+   "main": "./dist/index.js",
+   "types": "./dist/index.d.ts",
+   "exports": {
+      ".": {
+         "types": "./dist/index.d.ts",
+         "default": "./dist/index.js"
+      }
+   },
+   "scripts": {
+      "build": "bun x --bun fot build",
+      "test": "bun x --bun fot test",
+      "lint": "bun x --bun fot lint",
+      "format": "bun x --bun fot format",
+      "typecheck": "bun x --bun fot typecheck"
+   },
+   "dependencies": {
+      "@f-o-t/condition-evaluator": "^2.0.2",
+      "zod": "^4.3.6"
+   },
+   "devDependencies": {
+      "@f-o-t/cli": "^1.0.0",
+      "@f-o-t/config": "^1.0.0",
+      "@types/bun": "latest"
+   },
+   "repository": {
+      "type": "git",
+      "url": "https://github.com/F-O-T/libraries.git",
+      "directory": "libraries/rules-engine"
+   }
 }

package/CHANGELOG.md

@@ -1,168 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [3.0.0] - 2026-01-31
-
-### ⚠️ BREAKING CHANGES
-
-- Engine now requires `evaluator` or `operators` configuration
-- `evaluateRule()` function signature changed to accept evaluator parameter
-- `evaluateRules()` function signature changed to accept evaluator parameter
-
-### 🎉 Features
-
-- **Custom operators support**: Use custom operators from any library (e.g., `@f-o-t/money/operators`)
-- **Plugin system integration**: Full integration with `@f-o-t/condition-evaluator` plugin system
-- **Better extensibility**: Easily compose multiple operator sets
-- **Type-safe operators**: Better TypeScript support for custom operator types
-
-### 📚 Documentation
-
-- Added migration guide for v2 → v3
-- Updated README with custom operator examples
-- Added examples for money operators integration
-
-### 🔧 Migration
-
-See [MIGRATION-v3.md](./docs/MIGRATION-v3.md) for detailed migration instructions.
-
-**Quick migration:**
-```typescript
-// Before (v2.x)
-const engine = createEngine({ consequences: MyConsequences });
-
-// After (v3.x)
-const engine = createEngine({
-  consequences: MyConsequences,
-  evaluator: createEvaluator() // Add this
-});
-```
-
----
-
-## [2.0.2] - 2026-01-25
-
-### Changed
-
-- Updated dependencies to latest versions
-
-## [2.0.1] - 2025-12-31
-
-### Changed
-
-- Removed unused imports and dead code
-  - Removed unused `ConditionGroup` type import from index-builder
-  - Removed unused `ConflictResolutionStrategySchema` import from config types
-  - Removed unused `_cacheStats` variable from engine stats
-  - Removed unused `_collectAllConditionIds` helper function from integrity validation
-
-## [2.0.0] - 2025-12-24
-
-### Added
-
-- **Zod Schema-First Types**: All configuration types now built from Zod schemas
-  - `CacheConfigSchema`, `ValidationConfigSchema`, `VersioningConfigSchema`, `LogLevelSchema`
-  - `ConflictResolutionStrategySchema`, `EvaluateOptionsSchema`, `EvaluateConfigSchema`
-  - `RuleStatsSchema`, `CacheStatsSchema`, `EngineStatsSchema`
-  - `ValidationErrorSchema`, `ValidationResultSchema`, `ValidationOptionsSchema`
-- **Hook Error Handling**: New `onHookError` callback for capturing hook errors
-  - Previously hooks failed silently; now errors are reported via callback
-- **Hook Timeout Protection**: New `hookTimeoutMs` config option
-  - Prevents slow hooks from blocking engine execution indefinitely
-  - Timeout errors are reported through `onHookError`
-- **Orphaned Reference Detection**: `ImportResult` now includes `orphanedReferences`
-  - Detects when imported RuleSets reference non-existent rule IDs
-  - New `OrphanedReference` type exported
-- **Shared Conditions Utility**: New internal `src/utils/conditions.ts`
-  - `collectConditionFields()`, `collectConditionOperators()`, `countConditions()`
-  - `calculateMaxDepth()`, `countConditionGroups()`
-- **Config Helper Functions**: New functions replace constants
-  - `getDefaultCacheConfig()`, `getDefaultValidationConfig()`, `getDefaultVersioningConfig()`
-  - `getDefaultLogLevel()`, `getDefaultConflictResolution()`
-  - `parseCacheConfig()`, `parseValidationConfig()`, `parseVersioningConfig()`
-
-### Changed
-
-- **Cache Eviction Performance**: O(n) → O(1) for oldest entry eviction
-  - Now uses ES6 Map insertion order for FIFO eviction
-- **Strict Mode Behavior**: `strictMode: true` now implicitly enables consequence validation
-  - Previously required both `strictMode: true` and `validateConsequences: true`
-
-### Removed
-
-- **BREAKING**: Removed FP utility exports from `src/utils/pipe.ts`
-  - `pipe()`, `compose()`, `identity()`, `always()`, `tap()`
-  - These generic utilities are not domain-specific; use lodash/ramda instead
-- **BREAKING**: Removed `delay()` from `src/utils/time.ts`
-  - Low value utility; use `Bun.sleep()` or inline `new Promise(resolve => setTimeout(resolve, ms))`
-- **BREAKING**: Removed `DEFAULT_*` constant exports
-  - `DEFAULT_CACHE_CONFIG` → use `getDefaultCacheConfig()`
-  - `DEFAULT_VALIDATION_CONFIG` → use `getDefaultValidationConfig()`
-  - `DEFAULT_VERSIONING_CONFIG` → use `getDefaultVersioningConfig()`
-  - `DEFAULT_ENGINE_CONFIG` → removed (use schema defaults)
-- **BREAKING**: Removed internal mutable type exports
-  - `MutableEngineState`, `MutableOptimizerState`, `MutableRuleStats`
-  - These are internal implementation details
-
-### Fixed
-
-- **Silent Hook Errors**: All 11 hook execution functions now report errors via `onHookError`
-- **Redundant Sorting**: Removed unnecessary sort in `evaluate()` (rules already sorted on add/update)
-
-## [1.0.0] - 2025-12-10
-
-### Added
-
-- Initial release of the rules engine library
-- **Engine**: Stateful rule management with `createEngine()`
-  - Add, update, remove, enable/disable rules
-  - Rule sets for grouping related rules
-  - Configurable caching with TTL and max size
-  - Lifecycle hooks (onBeforeEvaluation, onAfterEvaluation, onRuleMatch, onRuleError, onCacheHit)
-  - Conflict resolution strategies: "all", "first-match", "highest-priority"
-- **Fluent Builders**: Chainable APIs for building rules and conditions
-  - `rule()` builder with full configuration options
-  - Shorthand condition helpers: `num()`, `str()`, `bool()`, `date()`, `arr()`
-  - Logical operators: `all()`, `any()`, `and()`, `or()`
-- **Core Evaluation**: Built on `@f-o-t/condition-evaluator`
-  - `evaluateRule()` and `evaluateRules()` functions
-  - Filter rules by tags, category, enabled status
-  - Sort rules by priority, name, created/updated date
-  - Group rules by category, priority, enabled status, or custom function
-- **Validation**: Comprehensive rule validation
-  - Schema validation with Zod
-  - Conflict detection (duplicate IDs, overlapping conditions, priority collisions, unreachable rules)
-  - Integrity checks (negative priority, missing fields, invalid operators)
-- **Simulation**: Test rules without side effects
-  - `simulate()` for single context testing
-  - `batchSimulate()` for multiple contexts
-  - `whatIf()` for comparing rule set changes
-- **Versioning**: Track rule changes with rollback support
-  - Version store with full history
-  - Rollback to any previous version
-  - Prune old versions
-- **Indexing & Optimization**: Fast rule lookups
-  - Build indexes by field, tag, category, priority
-  - Optimization suggestions for rule sets
-- **Analysis**: Rule set analytics
-  - Complexity analysis per rule
-  - Field, operator, and consequence usage statistics
-  - Find most complex rules
-- **Serialization**: Import/export capabilities
-  - JSON export/import with optional ID regeneration
-  - Clone rules
-  - Merge and diff rule sets
-- **Utilities**: Functional programming helpers
-  - `pipe()`, `compose()`, `identity()`, `always()`, `tap()`
-  - `measureTime()`, `measureTimeAsync()`, `withTimeout()`, `delay()`
-  - `generateId()`, `hashContext()`, `hashRules()`
-
-### Changed
-
-- **Internal refactor**: Removed 12 internal barrel files
-  - All imports now use direct file paths instead of barrel re-exports
-  - No public API changes - only internal module structure improvements