rule-based-chat 1.0.0-beta.0

package/dist/types/engine/ChatEngine.d.ts.map

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

package/dist/types/engine/ConditionEvaluator.d.ts

@@ -0,0 +1,106 @@
+import { AnswerOption, ConditionEvaluatorFunction, ConversationNode, ConversationState, DisplayConditions } from '../types';
+/**
+ * ConditionEvaluator handles the evaluation of display conditions
+ * for options, messages, and nodes
+ */
+export declare class ConditionEvaluator {
+    private customEvaluators;
+    private enableLogging;
+    constructor(customEvaluators?: Record<string, ConditionEvaluatorFunction>, enableLogging?: boolean);
+    /**
+     * Filter options based on their display conditions
+     * Returns only options that should be displayed
+     */
+    filterOptions(options: AnswerOption[], state: ConversationState): Promise<AnswerOption[]>;
+    /**
+     * Get the appropriate message for a node based on conditions
+     * Returns the conditional message if conditions match, otherwise the default message
+     */
+    getConditionalMessage(node: ConversationNode, state: ConversationState): Promise<string>;
+    /**
+     * Check if a node should be displayed based on its conditions
+     */
+    shouldDisplayNode(node: ConversationNode, state: ConversationState): Promise<boolean>;
+    /**
+     * Evaluate display conditions
+     * Supports single condition, array of conditions (AND), or condition groups
+     */
+    evaluateConditions(conditions: DisplayConditions, state: ConversationState): Promise<boolean>;
+    /**
+     * Evaluate a condition group with AND/OR logic
+     */
+    private evaluateConditionGroup;
+    /**
+     * Evaluate a single display condition
+     */
+    private evaluateSingleCondition;
+    /**
+     * Get the value from the specified source
+     */
+    private getSourceValue;
+    /**
+     * Get value from a previous answer
+     */
+    private getAnswerValue;
+    /**
+     * Get the most recent answer for a given node ID
+     */
+    private getMostRecentAnswer;
+    /**
+     * Get value from conversation context
+     */
+    private getContextValue;
+    /**
+     * Get value from conversation state
+     */
+    private getStateValue;
+    /**
+     * Get value from metadata
+     */
+    private getMetadataValue;
+    /**
+     * Evaluate a custom condition using registered evaluator
+     */
+    private evaluateCustomCondition;
+    /**
+     * Compare two values using the specified operator
+     */
+    private compareValues;
+    /**
+     * Normalize a value for comparison
+     */
+    private normalizeValue;
+    /**
+     * Check if actual contains expected
+     */
+    private checkContains;
+    /**
+     * Compare numeric values
+     */
+    private compareNumeric;
+    /**
+     * Type guard for single condition
+     */
+    private isSingleCondition;
+    /**
+     * Type guard for condition group
+     */
+    private isConditionGroup;
+    /**
+     * Register a custom condition evaluator
+     */
+    registerEvaluator(name: string, evaluator: ConditionEvaluatorFunction): void;
+    /**
+     * Unregister a custom condition evaluator
+     */
+    unregisterEvaluator(name: string): boolean;
+    /**
+     * Get all registered evaluator names
+     */
+    getRegisteredEvaluators(): string[];
+    /**
+     * Internal logging helper
+     */
+    private log;
+}
+//# sourceMappingURL=ConditionEvaluator.d.ts.map

package/dist/types/engine/ConditionEvaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConditionEvaluator.d.ts","sourceRoot":"","sources":["../../../src/engine/ConditionEvaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,0BAA0B,EAAkB,gBAAgB,EACpF,iBAAiB,EAAoB,iBAAiB,EAAc,MAAM,UAAU,CAAC;AAEzF;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,gBAAgB,CAA6C;IACrE,OAAO,CAAC,aAAa,CAAU;gBAG7B,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAM,EACjE,aAAa,GAAE,OAAe;IAMhC;;;OAGG;IACG,aAAa,CACjB,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,YAAY,EAAE,CAAC;IAyB1B;;;OAGG;IACG,qBAAqB,CACzB,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,MAAM,CAAC;IA4BlB;;OAEG;IACG,iBAAiB,CACrB,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC;IASnB;;;OAGG;IACG,kBAAkB,CACtB,UAAU,EAAE,iBAAiB,EAC7B,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,OAAO,CAAC;IAyBnB;;OAEG;YACW,sBAAsB;IAyBpC;;OAEG;YACW,uBAAuB;IA2BrC;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAwBrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;YACW,uBAAuB;IA0BrC;;OAEG;IACH,OAAO,CAAC,aAAa;IAiErB;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,0BAA0B,GAAG,IAAI;IAK5E;;OAEG;IACH,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAQ1C;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE;IAInC;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/types/engine/EventEmitter.d.ts

@@ -0,0 +1,62 @@
+import { ChatEventPayloadMap, ChatEventType, EventHandler, EventHandlers } from '../types';
+/**
+ * EventEmitter handles the hooks/events system for the ChatEngine
+ * Allows subscribing to and emitting events throughout the conversation lifecycle
+ */
+export declare class EventEmitter {
+    private handlers;
+    private enableLogging;
+    constructor(initialHandlers?: EventHandlers, enableLogging?: boolean);
+    /**
+     * Register multiple event handlers from a configuration object
+     */
+    registerHandlers(handlers: EventHandlers): void;
+    /**
+     * Subscribe to an event
+     * @param eventType - The type of event to listen for
+     * @param handler - The function to call when the event is emitted
+     * @returns A function to unsubscribe the handler
+     */
+    on<T extends ChatEventType>(eventType: T, handler: EventHandler<T>): () => void;
+    /**
+     * Subscribe to an event for a single emission only
+     * @param eventType - The type of event to listen for
+     * @param handler - The function to call when the event is emitted
+     * @returns A function to unsubscribe the handler
+     */
+    once<T extends ChatEventType>(eventType: T, handler: EventHandler<T>): () => void;
+    /**
+     * Unsubscribe from an event
+     * @param eventType - The type of event to unsubscribe from
+     * @param handler - The specific handler to remove (if not provided, removes all handlers)
+     */
+    off<T extends ChatEventType>(eventType: T, handler?: EventHandler<T>): void;
+    /**
+     * Emit an event to all registered handlers
+     * @param eventType - The type of event to emit
+     * @param payload - The data to pass to handlers
+     * @returns For onBeforeTransition, returns false if any handler returns false (cancels transition)
+     */
+    emit<T extends ChatEventType>(eventType: T, payload: ChatEventPayloadMap[T]): Promise<boolean>;
+    /**
+     * Check if there are any handlers registered for an event type
+     */
+    hasHandlers(eventType: ChatEventType): boolean;
+    /**
+     * Get the number of handlers registered for an event type
+     */
+    handlerCount(eventType: ChatEventType): number;
+    /**
+     * Get all registered event types
+     */
+    getRegisteredEvents(): ChatEventType[];
+    /**
+     * Remove all handlers for all events
+     */
+    removeAllHandlers(): void;
+    /**
+     * Internal logging helper
+     */
+    private log;
+}
+//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/types/engine/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../../src/engine/EventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEhG;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,aAAa,CAAU;gBAEnB,eAAe,CAAC,EAAE,aAAa,EAAE,aAAa,GAAE,OAAe;IAU3E;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IA6B/C;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,aAAa,EACxB,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI;IAgBb;;;;;OAKG;IACH,IAAI,CAAC,CAAC,SAAS,aAAa,EAC1B,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GACvB,MAAM,IAAI;IASb;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,aAAa,EACzB,SAAS,EAAE,CAAC,EACZ,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GACxB,IAAI;IAuBP;;;;;OAKG;IACG,IAAI,CAAC,CAAC,SAAS,aAAa,EAChC,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IAwCnB;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO;IAK9C;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM;IAI9C;;OAEG;IACH,mBAAmB,IAAI,aAAa,EAAE;IAItC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAKzB;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/types/engine/TemplateEngine.d.ts

@@ -0,0 +1,42 @@
+import { ConversationNode, ConversationState, VariableResolver } from '../types';
+/**
+ * TemplateEngine handles variable substitution in messages
+ * Supports {{variableName}} syntax with built-in and custom resolvers
+ */
+export declare class TemplateEngine {
+    private customResolvers;
+    constructor(customResolvers?: Record<string, VariableResolver>);
+    /**
+     * Process a message template and replace all variables
+     */
+    processTemplate(template: string, state: ConversationState, node: ConversationNode): Promise<string>;
+    /**
+     * Resolve a variable to its value
+     */
+    private resolveVariable;
+    /**
+     * Built-in variable resolvers
+     */
+    private resolveBuiltIn;
+    /**
+     * Get the most recent answer for a given node ID
+     */
+    private getMostRecentAnswer;
+    /**
+     * Get a nested value from an object using dot notation
+     */
+    private getNestedValue;
+    /**
+     * Format a value for display in a message
+     */
+    private formatValue;
+    /**
+     * Register a custom resolver at runtime
+     */
+    registerResolver(name: string, resolver: VariableResolver): void;
+    /**
+     * Check if a message contains template variables
+     */
+    hasVariables(message: string): boolean;
+}
+//# sourceMappingURL=TemplateEngine.d.ts.map

package/dist/types/engine/TemplateEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TemplateEngine.d.ts","sourceRoot":"","sources":["../../../src/engine/TemplateEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAc,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAElG;;;GAGG;AACH,qBAAa,cAAc;IACvB,OAAO,CAAC,eAAe,CAAmC;gBAE9C,eAAe,GAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAM;IAIlE;;OAEG;IACG,eAAe,CACjB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,iBAAiB,EACxB,IAAI,EAAE,gBAAgB,GACvB,OAAO,CAAC,MAAM,CAAC;IAoBlB;;OAEG;YACW,eAAe;IAwB7B;;OAEG;IACH,OAAO,CAAC,cAAc;IA+DtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,cAAc;IA2BtB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIhE;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAGzC"}

package/dist/types/engine/index.d.ts

@@ -0,0 +1,5 @@
+export { ChatEngine } from './ChatEngine';
+export { TemplateEngine } from './TemplateEngine';
+export { EventEmitter } from './EventEmitter';
+export { ConditionEvaluator } from './ConditionEvaluator';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Chatbot Core - A rule-based chatbot engine
+ */
+export { ChatEngine, TemplateEngine, EventEmitter, ConditionEvaluator } from './engine';
+export { ConversationManager } from './conversation';
+export { RuleProcessor } from './rules';
+export { StorageAdapter, MemoryStorage } from './storage';
+export type { AnswerOption, MessageType, ConversationNode, TransitionRule, RuleCondition, ConversationFlow, UserAnswer, ConversationMessage, ConversationState, ProcessingResult, ChatEngineConfig, ValidatorFunction, EvaluatorFunction, MessageProcessor, VariableResolver, ChatEventType, BaseEventPayload, ConversationStartPayload, ConversationEndPayload, BeforeTransitionPayload, AfterTransitionPayload, AnswerRecordedPayload, ValidationErrorPayload, ConversationPausedPayload, ConversationResumedPayload, ConversationResetPayload, ErrorPayload, ChatEventPayloadMap, EventHandler, EventHandlers, ConditionOperator, ConditionSource, DisplayCondition, ConditionGroup, DisplayConditions, ConditionalMessage, ConditionEvaluatorFunction, GotoAction, GotoResult, NodeAction, ConversationNodeActions, IStorageAdapter, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGxF,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGrD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1D,YAAY,EAEV,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAGhB,UAAU,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAGhB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAGhB,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,wBAAwB,EACxB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,aAAa,EAGb,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAG1B,UAAU,EACV,UAAU,EACV,UAAU,EACV,uBAAuB,EAGvB,eAAe,GAChB,MAAM,SAAS,CAAC"}

package/dist/types/rules/RuleProcessor.d.ts

@@ -0,0 +1,118 @@
+import { ConversationFlow, ConversationNode, ConversationState, EvaluatorFunction, RuleCondition, UserAnswer } from '../types';
+/**
+ * RuleProcessor handles the evaluation of transition rules
+ * and determines the next node in the conversation flow
+ *
+ * Supports:
+ * - AND/OR condition logic
+ * - Nested conditions
+ * - Context and state-based conditions
+ * - Custom evaluators
+ */
+export declare class RuleProcessor {
+    private flow;
+    private customEvaluators;
+    private enableLogging;
+    constructor(flow: ConversationFlow, customEvaluators?: Record<string, EvaluatorFunction>, enableLogging?: boolean);
+    /**
+     * Get a node by its ID
+     */
+    getNode(nodeId: string): ConversationNode | null;
+    /**
+     * Get the starting node of the flow
+     */
+    getStartNode(): ConversationNode | null;
+    /**
+     * Check if a node exists in the flow
+     */
+    nodeExists(nodeId: string): boolean;
+    /**
+     * Get all node IDs in the flow
+     */
+    getAllNodeIds(): string[];
+    /**
+     * Determine the next node based on the current node and user's answer
+     */
+    getNextNode(currentNodeId: string, answer: UserAnswer, state: ConversationState): ConversationNode | null;
+    /**
+     * Evaluate if a transition's conditions are met
+     */
+    private evaluateTransition;
+    /**
+     * Evaluate a single condition (supports nested conditions)
+     */
+    evaluateCondition(condition: RuleCondition, answer: UserAnswer, state: ConversationState): boolean;
+    /**
+     * Evaluate nested conditions with AND/OR logic
+     */
+    private evaluateNestedConditions;
+    /**
+     * Evaluate a simple (non-nested) condition
+     */
+    private evaluateSimpleCondition;
+    /**
+     * Extract the value based on field type
+     */
+    private getFieldValue;
+    /**
+     * Get a value from the conversation context (supports dot notation)
+     */
+    private getNestedValue;
+    /**
+     * Get a value from the conversation state
+     */
+    private getStateValue;
+    /**
+     * Compare values using the specified operator
+     */
+    private compareValues;
+    /**
+     * Normalize a value for comparison (lowercase strings)
+     */
+    private normalizeValue;
+    /**
+     * Check if actual contains expected
+     */
+    private checkContains;
+    /**
+     * Compare numeric values
+     */
+    private compareNumeric;
+    /**
+     * Validate that all node references in transitions exist
+     */
+    validateFlow(): {
+        valid: boolean;
+        errors: string[];
+    };
+    /**
+     * Validate conditions recursively
+     */
+    private validateConditions;
+    /**
+     * Get all possible next nodes from a given node (for debugging/visualization)
+     */
+    getPossibleNextNodes(nodeId: string): ConversationNode[];
+    /**
+     * Evaluate a set of conditions without an answer (for node actions)
+     * Uses state and context only
+     */
+    evaluateConditionsWithoutAnswer(conditions: RuleCondition[], state: ConversationState, logic?: 'and' | 'or'): boolean;
+    /**
+     * Register a custom evaluator at runtime
+     */
+    registerEvaluator(name: string, evaluator: EvaluatorFunction): void;
+    /**
+     * Update the conversation flow
+     */
+    setFlow(flow: ConversationFlow): void;
+    /**
+     * Get the current flow
+     */
+    getFlow(): ConversationFlow;
+    /**
+     * Internal logging helper
+     */
+    private log;
+}
+//# sourceMappingURL=RuleProcessor.d.ts.map

package/dist/types/rules/RuleProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuleProcessor.d.ts","sourceRoot":"","sources":["../../../src/rules/RuleProcessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,UAAU,CAAC;AAEpJ;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,gBAAgB,CAAoC;IAC5D,OAAO,CAAC,aAAa,CAAU;gBAG7B,IAAI,EAAE,gBAAgB,EACtB,gBAAgB,GAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAM,EACxD,aAAa,GAAE,OAAe;IAOhC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIhD;;OAEG;IACH,YAAY,IAAI,gBAAgB,GAAG,IAAI;IAIvC;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAInC;;OAEG;IACH,aAAa,IAAI,MAAM,EAAE;IAIzB;;OAEG;IACH,WAAW,CACT,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,iBAAiB,GACvB,gBAAgB,GAAG,IAAI;IAsB1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAyB1B;;OAEG;IACH,iBAAiB,CACf,SAAS,EAAE,aAAa,EACxB,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,iBAAiB,GACvB,OAAO;IAUV;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAkChC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IA4C/B;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAyErB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,YAAY,IAAI;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IA+CpD;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAoB1B;;OAEG;IACH,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,EAAE;IAgBxD;;;OAGG;IACH,+BAA+B,CAC7B,UAAU,EAAE,aAAa,EAAE,EAC3B,KAAK,EAAE,iBAAiB,EACxB,KAAK,GAAE,KAAK,GAAG,IAAY,GAC1B,OAAO;IAkBV;;OAEG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,iBAAiB,GAAG,IAAI;IAInE;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAIrC;;OAEG;IACH,OAAO,IAAI,gBAAgB;IAI3B;;OAEG;IACH,OAAO,CAAC,GAAG;CAKZ"}

package/dist/types/rules/index.d.ts

@@ -0,0 +1,2 @@
+export { RuleProcessor } from './RuleProcessor';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/rules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rules/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/storage/MemoryStorage.d.ts

@@ -0,0 +1,50 @@
+import { ConversationState } from '../types';
+import { StorageAdapter } from './StorageAdapter';
+/**
+ * In-memory storage adapter
+ * Useful for development, testing, and single-instance deployments
+ *
+ * Note: Data is lost when the process restarts
+ */
+export declare class MemoryStorage extends StorageAdapter {
+    private store;
+    private maxSize;
+    /**
+     * Create a new MemoryStorage instance
+     * @param maxSize - Maximum number of conversations to store (0 = unlimited)
+     */
+    constructor(maxSize?: number);
+    /**
+     * Retrieve a conversation state by ID
+     */
+    get(conversationId: string): Promise<ConversationState | null>;
+    /**
+     * Save or update a conversation state
+     */
+    save(state: ConversationState): Promise<void>;
+    /**
+     * Delete a conversation state
+     */
+    delete(conversationId: string): Promise<void>;
+    /**
+     * Check if a conversation exists
+     */
+    exists(conversationId: string): Promise<boolean>;
+    /**
+     * Get the current number of stored conversations
+     */
+    getSize(): number;
+    /**
+     * Clear all stored conversations
+     */
+    clear(): void;
+    /**
+     * Get all conversation IDs (useful for debugging)
+     */
+    getAllIds(): string[];
+    /**
+     * Find the oldest conversation entry based on updatedAt
+     */
+    private findOldestEntry;
+}
+//# sourceMappingURL=MemoryStorage.d.ts.map

package/dist/types/storage/MemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorage.d.ts","sourceRoot":"","sources":["../../../src/storage/MemoryStorage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,OAAO,CAAS;IAExB;;;OAGG;gBACS,OAAO,GAAE,MAAU;IAM/B;;OAEG;IACG,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAWpE;;OAEG;IACG,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnD;;OAEG;IACG,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;OAEG;IACG,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItD;;OAEG;IACH,OAAO,IAAI,MAAM;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;OAEG;IACH,OAAO,CAAC,eAAe;CAcxB"}

package/dist/types/storage/StorageAdapter.d.ts

@@ -0,0 +1,39 @@
+import { ConversationState, IStorageAdapter } from '../types';
+/**
+ * Abstract base class for storage adapters
+ * Extend this class to create custom storage implementations
+ */
+export declare abstract class StorageAdapter implements IStorageAdapter {
+    /**
+     * Retrieve a conversation state by ID
+     * @param conversationId - Unique conversation identifier
+     * @returns The conversation state or null if not found
+     */
+    abstract get(conversationId: string): Promise<ConversationState | null>;
+    /**
+     * Save or update a conversation state
+     * @param state - The conversation state to save
+     */
+    abstract save(state: ConversationState): Promise<void>;
+    /**
+     * Delete a conversation state
+     * @param conversationId - Unique conversation identifier
+     */
+    abstract delete(conversationId: string): Promise<void>;
+    /**
+     * Check if a conversation exists
+     * @param conversationId - Unique conversation identifier
+     * @returns True if the conversation exists
+     */
+    abstract exists(conversationId: string): Promise<boolean>;
+    /**
+     * Helper method to create a deep copy of state
+     * Useful for preventing mutation issues
+     */
+    protected deepCopy<T>(obj: T): T;
+    /**
+     * Helper method to validate conversation state structure
+     */
+    protected validateState(state: ConversationState): boolean;
+}
+//# sourceMappingURL=StorageAdapter.d.ts.map

package/dist/types/storage/StorageAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageAdapter.d.ts","sourceRoot":"","sources":["../../../src/storage/StorageAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEnE;;;GAGG;AACH,8BAAsB,cAAe,YAAW,eAAe;IAC7D;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAEvE;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtD;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAEzD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC;IAIhC;;OAEG;IACH,SAAS,CAAC,aAAa,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;CAY3D"}

package/dist/types/storage/index.d.ts

@@ -0,0 +1,3 @@
+export { StorageAdapter } from './StorageAdapter';
+export { MemoryStorage } from './MemoryStorage';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}