@f-o-t/rules-engine 3.0.1 → 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":"AAAA,OAAO,KAAK,EACT,sBAAsB,EACtB,mBAAmB,EACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAG1C,MAAM,MAAM,WAAW,CACpB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC7E,CAAC;AAEF,MAAM,MAAM,cAAc,CACvB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,YAAY,CACrB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,IACjE;IACD,QAAQ,CAAC,SAAS,EAAE,WAAW,CAC5B,MAAM,EACN,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CACzC,CAAC;CACJ,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC5B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,OAChE,YAAY,CAAC,QAAQ,EAAE,aAAa,CAEvC,CAAC;AAEH,eAAO,MAAM,UAAU,GACpB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,MAAM,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,EACnC,YAAY,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,YAAY,CAAC,EAC9D,UAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,KACtD,YAAY,CAAC,QAAQ,EAAE,aAAa,CA8BtC,CAAC;AAEF,eAAO,MAAM,UAAU,GACpB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,QAAQ,MAAM,KACd,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,SAE5C,CAAC;AAEF,eAAO,MAAM,UAAU,GACpB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,QAAQ,MAAM,EACd,SAAS,MAAM,KACf,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,SAIzC,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC1B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,QAAQ,MAAM,KACd,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,SAIzC,CAAC;AAEF,eAAO,MAAM,cAAc,GACxB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,QAAQ,MAAM,KACd,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAGpD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAC3B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,QAAQ,MAAM,EACd,eAAe,MAAM,EACrB,UAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,KACtD;IACA,KAAK,EAAE,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IAC7C,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC;CAkBlD,CAAC;AAEF,eAAO,MAAM,eAAe,GACzB,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,QAAQ,MAAM,EACd,UAAU,MAAM,EAChB,UAAU,MAAM,KAChB;IACA,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC;IAC3D,QAAQ,EAAE,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,GAAG,SAAS,CAAC;IAC3D,WAAW,EAAE,aAAa,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,OAAO,CAAC;QAClB,QAAQ,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACL,GAAG,IA6DH,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAChC,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,WAAW,IAAI,EACf,SAAS,IAAI,KACb,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAcpD,CAAC;AAEF,eAAO,MAAM,uBAAuB,GACjC,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,YAAY,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,YAAY,CAAC,KAC9D,aAAa,CAAC,WAAW,CAAC,QAAQ,EAAE,aAAa,CAAC,CAYpD,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC1B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,OAAO,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,EAC5C,WAAW,MAAM,KACjB,YAAY,CAAC,QAAQ,EAAE,aAAa,CAiBtC,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAC9B,QAAQ,GAAG,OAAO,EAClB,aAAa,SAAS,sBAAsB,GAAG,mBAAmB,EAElE,SAAS,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,KAChD,MAqBF,CAAC"}

package/package.json

@@ -1,36 +1,37 @@
 {
-  "name": "@f-o-t/rules-engine",
-  "version": "3.0.1",
-  "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"
-  },
-  "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"
+   }
 }