trigger_system 1.2.0 → 1.2.4

package/dist/sdk/graph/converters.d.ts

@@ -0,0 +1,152 @@
+/**
+ * Graph Converters - Interfaces for data transformation
+ * Provides interfaces for converting between graph data and rule structures
+ */
+import type { SDKGraphNode, SDKGraphEdge, TriggerRule, RuleCondition, Action, ComparisonOperator } from '../../types';
+/**
+ * Data transformation options
+ */
+export interface TransformOptions {
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Strict mode - throw on errors */
+    strict?: boolean;
+}
+/**
+ * Base converter interface for node data transformation
+ */
+export interface INodeConverter<TNodeData, TOutput> {
+    /** Convert node data to output format */
+    convert(nodeData: TNodeData, context: ConverterContext): TOutput;
+    /** Validate the input data */
+    validate?(nodeData: TNodeData): ValidationResult;
+}
+/**
+ * Validation result
+ */
+export interface ValidationResult {
+    valid: boolean;
+    errors?: string[];
+    warnings?: string[];
+}
+/**
+ * Context passed to converters
+ */
+export interface ConverterContext {
+    /** All nodes in the graph */
+    nodes: SDKGraphNode[];
+    /** All edges in the graph */
+    edges: SDKGraphEdge[];
+    /** Current node being processed */
+    currentNode?: SDKGraphNode;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Options for transformation */
+    options?: TransformOptions;
+}
+/**
+ * Condition data from a graph node
+ */
+export interface ConditionNodeData {
+    field?: string;
+    operator?: ComparisonOperator;
+    value?: unknown;
+}
+/**
+ * Action data from a graph node
+ */
+export interface ActionNodeData {
+    type?: string;
+    params?: Record<string, unknown> | string;
+    delay?: number;
+    probability?: number;
+}
+/**
+ * Event data from a graph node
+ */
+export interface EventNodeData {
+    id?: string;
+    name?: string;
+    description?: string;
+    event?: string;
+    priority?: number | string;
+    enabled?: boolean;
+    cooldown?: number | string;
+    tags?: string[];
+}
+/**
+ * Condition group data
+ */
+export interface ConditionGroupData {
+    operator?: 'AND' | 'OR';
+}
+/**
+ * Action group data
+ */
+export interface ActionGroupData {
+    mode?: 'ALL' | 'FIRST' | 'RANDOM';
+}
+/**
+ * DO node data
+ */
+export interface DoNodeData {
+    branchType?: 'do' | 'else';
+}
+/**
+ * Condition converter - converts condition nodes to RuleCondition
+ */
+export declare class ConditionConverter implements INodeConverter<ConditionNodeData, RuleCondition> {
+    convert(nodeData: ConditionNodeData, _context: ConverterContext): RuleCondition;
+    validate(nodeData: ConditionNodeData): ValidationResult;
+}
+/**
+ * Action converter - converts action nodes to Action
+ */
+export declare class ActionConverter implements INodeConverter<ActionNodeData, Action> {
+    convert(nodeData: ActionNodeData, _context: ConverterContext): Action;
+    validate(nodeData: ActionNodeData): ValidationResult;
+}
+/**
+ * Event converter - converts event nodes to TriggerRule metadata
+ */
+export declare class EventConverter implements INodeConverter<EventNodeData, Partial<TriggerRule>> {
+    convert(nodeData: EventNodeData, _context: ConverterContext): Partial<TriggerRule>;
+    validate(nodeData: EventNodeData): ValidationResult;
+}
+/**
+ * Factory for creating converters
+ */
+export declare class ConverterFactory {
+    private conditionConverter;
+    private actionConverter;
+    private eventConverter;
+    /** Get condition converter */
+    getConditionConverter(): ConditionConverter;
+    /** Get action converter */
+    getActionConverter(): ActionConverter;
+    /** Get event converter */
+    getEventConverter(): EventConverter;
+    /** Create converter context */
+    createContext(nodes: SDKGraphNode[], edges: SDKGraphEdge[], currentNode?: SDKGraphNode, options?: TransformOptions): ConverterContext;
+}
+/**
+ * Default converter factory instance
+ */
+export declare const converterFactory: ConverterFactory;
+/**
+ * Convert action params from string to object
+ */
+export declare function parseActionParams(params: Record<string, unknown> | string | undefined): Record<string, unknown>;
+/**
+ * Convert node data to condition
+ */
+export declare function nodeToCondition(node: SDKGraphNode): RuleCondition;
+/**
+ * Convert node data to action
+ */
+export declare function nodeToAction(node: SDKGraphNode): Action;
+/**
+ * Convert node data to event data
+ */
+export declare function nodeToEventData(node: SDKGraphNode): Partial<TriggerRule>;
+//# sourceMappingURL=converters.d.ts.map

package/dist/sdk/graph/converters.d.ts.map

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

package/dist/sdk/graph/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Graph Utilities Index
+ * Re-exports all graph-related utilities for easy importing
+ */
+export { NodeFilter, createNodeFilterConfig, defaultIsEventNode, defaultIsDoNode, isConditionGroup, isActionGroup, getDoBranchType, isElseBranch, isDoBranch, extractEventData, type NodePredicate, type NodeFilterConfig } from './node-filters';
+export { defaultIsCondNode, defaultIsActNode } from './node-filters';
+export * from './traversal';
+export * from './converters';
+export { ConditionResolver, collectConditionsForGroup, resolveCondition, findTerminalConditions, type ConditionResolverContext, type ConditionTransformer, type CollectedConditions, type TerminalActions } from './condition-resolver';
+export { ActionResolver, collectActionsForGroup, resolveAction, categorizeDoNodesByBranch, type ActionResolverContext, type ActionResolverOptions, type ActionTransformer, type CollectedActions, type DoBranches } from './action-resolver';
+export type { GraphResolverContextBase } from './condition-resolver';
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/graph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/graph/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,UAAU,EACV,sBAAsB,EACtB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGrE,cAAc,aAAa,CAAC;AAG5B,cAAc,cAAc,CAAC;AAG7B,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAChB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/sdk/graph/node-filters.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Node Filters - Type checking utilities for graph nodes
+ * Provides centralized node type detection for the graph parser
+ */
+import { BranchType } from '../constants';
+import type { SDKGraphNode, TriggerRule } from '../../types';
+/**
+ * Type predicates for node classification
+ */
+export type NodePredicate = (node: SDKGraphNode) => boolean;
+/**
+ * Configuration for node type detection
+ */
+export interface NodeFilterConfig {
+    /** Custom predicate for event nodes */
+    isEventNode?: NodePredicate;
+    /** Custom predicate for condition nodes */
+    isCondNode?: NodePredicate;
+    /** Custom predicate for action nodes */
+    isActNode?: NodePredicate;
+    /** Custom function to extract event data */
+    extractEventData?: (node: SDKGraphNode) => Partial<TriggerRule>;
+}
+/**
+ * Default event node detector
+ */
+export declare const defaultIsEventNode: NodePredicate;
+/**
+ * Default condition node detector (single condition or condition group)
+ */
+export declare const defaultIsCondNode: NodePredicate;
+/**
+ * Default action node detector (single action, action group, or DO node)
+ */
+export declare const defaultIsActNode: NodePredicate;
+/**
+ * Default DO node detector
+ */
+export declare const defaultIsDoNode: NodePredicate;
+/**
+ * Check if a node is a condition group
+ */
+export declare const isConditionGroup: (node: SDKGraphNode) => boolean;
+/**
+ * Check if a node is an action group
+ */
+export declare const isActionGroup: (node: SDKGraphNode) => boolean;
+/**
+ * Get the branch type for a DO node
+ */
+export declare const getDoBranchType: (node: SDKGraphNode) => BranchType;
+/**
+ * Check if a DO node is an else branch
+ */
+export declare const isElseBranch: (node: SDKGraphNode) => boolean;
+/**
+ * Check if a DO node is a do branch (then path)
+ */
+export declare const isDoBranch: (node: SDKGraphNode) => boolean;
+/**
+ * Default event data extractor
+ */
+export declare function extractEventData(node: SDKGraphNode): Partial<TriggerRule>;
+/**
+ * Create a filter configuration with defaults
+ */
+export declare function createNodeFilterConfig(overrides?: NodeFilterConfig): Required<NodeFilterConfig>;
+/**
+ * NodeFilter class - Fluent interface for node type checking
+ */
+export declare class NodeFilter {
+    private _isEvent;
+    private _isCond;
+    private _isAct;
+    private _extractEvent;
+    constructor(config?: NodeFilterConfig);
+    /** Check if node is an event */
+    isEvent(node: SDKGraphNode): boolean;
+    /** Check if node is a condition (single or group) */
+    isCondition(node: SDKGraphNode): boolean;
+    /** Check if node is an action (single or group or DO) */
+    isAction(node: SDKGraphNode): boolean;
+    /** Check if node is a DO node */
+    isDo(node: SDKGraphNode): boolean;
+    /** Extract event data from node */
+    extractEvent(node: SDKGraphNode): Partial<TriggerRule>;
+    /** Set custom event node predicate */
+    withEventPredicate(predicate: NodePredicate): this;
+    /** Set custom condition node predicate */
+    withConditionPredicate(predicate: NodePredicate): this;
+    /** Set custom action node predicate */
+    withActionPredicate(predicate: NodePredicate): this;
+    /** Set custom event data extractor */
+    withEventExtractor(extractor: (node: SDKGraphNode) => Partial<TriggerRule>): this;
+}
+//# sourceMappingURL=node-filters.d.ts.map

package/dist/sdk/graph/node-filters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-filters.d.ts","sourceRoot":"","sources":["../../../src/sdk/graph/node-filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,UAAU,EAAY,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,wCAAwC;IACxC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;CACjE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,aACN,CAAC;AAE5B;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,aACsC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAC2D,CAAC;AAE3F;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aACN,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,YAAY,KAAG,OACd,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,YAAY,KAAG,OACd,CAAC;AAEtC;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,YAAY,KAAG,UAEpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,YAAY,KAAG,OACP,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,YAAY,KAAG,OACP,CAAC;AAE1C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,CAYzE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,CAAC,EAAE,gBAAgB,GAC3B,QAAQ,CAAC,gBAAgB,CAAC,CAO5B;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAA+C;gBAExD,MAAM,CAAC,EAAE,gBAAgB;IAQrC,gCAAgC;IAChC,OAAO,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAIpC,qDAAqD;IACrD,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAIxC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAIrC,iCAAiC;IACjC,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO;IAIjC,mCAAmC;IACnC,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAItD,sCAAsC;IACtC,kBAAkB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAKlD,0CAA0C;IAC1C,sBAAsB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAKtD,uCAAuC;IACvC,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAKnD,sCAAsC;IACtC,kBAAkB,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;CAIlF"}

package/dist/sdk/graph/traversal.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Graph Traversal Utilities
+ * Provides utilities for traversing and finding nodes in the graph
+ */
+import type { SDKGraphNode, SDKGraphEdge } from '../../types';
+/**
+ * Context for graph traversal operations
+ */
+export interface GraphTraversalContext {
+    nodes: SDKGraphNode[];
+    edges: SDKGraphEdge[];
+}
+/** Type for handle arrays - accepts both mutable and readonly */
+export type HandleArray = readonly string[] | string[];
+/**
+ * Find a node by ID in the context
+ */
+export declare function findNodeById(ctx: GraphTraversalContext, nodeId: string): SDKGraphNode | undefined;
+/**
+ * Find edges matching a specific source node and handle
+ */
+export declare function findEdgesBySource(ctx: GraphTraversalContext, sourceId: string, handles: HandleArray): SDKGraphEdge[];
+/**
+ * Find edges matching a specific target node
+ */
+export declare function findEdgesByTarget(ctx: GraphTraversalContext, targetId: string): SDKGraphEdge[];
+/**
+ * Find all nodes connected from a source node via specific handles
+ */
+export declare function findConnectedNodeIds(ctx: GraphTraversalContext, sourceId: string, handles: HandleArray): string[];
+/**
+ * Find all nodes of a specific type connected from a source node
+ */
+export declare function findConnectedNodes<T extends SDKGraphNode>(ctx: GraphTraversalContext, sourceId: string, handles: HandleArray, typeFilter: (node: SDKGraphNode) => boolean): T[];
+/**
+ * Find nodes directly connected to a source node (any handle)
+ */
+export declare function findDirectSuccessors(ctx: GraphTraversalContext, sourceId: string): SDKGraphNode[];
+/**
+ * Find nodes that connect to a target node
+ */
+export declare function findDirectPredecessors(ctx: GraphTraversalContext, targetId: string): SDKGraphNode[];
+/**
+ * Get all outgoing edges from a node
+ */
+export declare function getOutgoingEdges(ctx: GraphTraversalContext, nodeId: string): SDKGraphEdge[];
+/**
+ * Get all incoming edges to a node
+ */
+export declare function getIncomingEdges(ctx: GraphTraversalContext, nodeId: string): SDKGraphEdge[];
+/**
+ * Get connected edges with optional handle filtering
+ */
+export declare function getConnectedEdges(ctx: GraphTraversalContext, nodeId: string, options?: {
+    direction?: 'outgoing' | 'incoming' | 'both';
+    sourceHandles?: HandleArray;
+    targetHandles?: HandleArray;
+}): SDKGraphEdge[];
+/**
+ * Common handle arrays for graph traversal
+ */
+export declare const HandleFilters: {
+    /** All condition output handles (for chaining conditions) */
+    readonly CONDITION_OUTPUT: readonly ["output", "condition-output"];
+    /** All action output handles */
+    readonly ACTION_OUTPUT: readonly ["action-output", "action-group-output"];
+    /** All DO output handles */
+    readonly DO_OUTPUT: readonly ["do-output", ""];
+    /** Then/else outputs from conditions (for terminal actions) */
+    readonly THEN_ELSE: readonly ["then-output", "else-output"];
+    /** DO condition output for inline conditionals */
+    readonly DO_CONDITION: readonly ["do-condition-output"];
+    /** All condition/thence outputs - includes then-output for condition→action_group */
+    readonly CONDITION_CHAIN: readonly ["output", "condition-output", "then-output", "else-output"];
+    /** Any output handle */
+    readonly ANY: readonly ["output", "condition-output", ""];
+};
+/**
+ * GraphTraversal class - Fluent interface for graph traversal
+ */
+export declare class GraphTraversal {
+    private ctx;
+    constructor(nodes: SDKGraphNode[], edges: SDKGraphEdge[]);
+    /** Find a node by ID */
+    node(id: string): SDKGraphNode | undefined;
+    /** Get outgoing edges from a node */
+    outgoing(nodeId: string): SDKGraphEdge[];
+    /** Get incoming edges to a node */
+    incoming(nodeId: string): SDKGraphEdge[];
+    /** Get connected edges with filtering */
+    connected(nodeId: string, options?: {
+        direction?: 'outgoing' | 'incoming' | 'both';
+        sourceHandles?: string[];
+        targetHandles?: string[];
+    }): SDKGraphEdge[];
+    /** Find connected node IDs by handles */
+    successors(nodeId: string, handles: HandleArray): string[];
+    /** Find connected nodes by type filter */
+    find<T extends SDKGraphNode>(sourceId: string, handles: HandleArray, typeFilter: (node: SDKGraphNode) => boolean): T[];
+    /** Get direct successors (any handle) */
+    directSuccessors(nodeId: string): SDKGraphNode[];
+    /** Get direct predecessors */
+    directPredecessors(nodeId: string): SDKGraphNode[];
+}
+//# sourceMappingURL=traversal.d.ts.map

package/dist/sdk/graph/traversal.d.ts.map

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

package/dist/sdk/graph/types.d.ts

@@ -0,0 +1,28 @@
+import type { TriggerRule, RuleCondition, Action, ActionGroup, SDKGraphNode, SDKGraphEdge } from '../../types';
+import type { OptimizeOptions } from '../builder';
+export interface GraphParserOptions {
+    isEventNode?: (n: SDKGraphNode) => boolean;
+    isCondNode?: (n: SDKGraphNode) => boolean;
+    isActNode?: (n: SDKGraphNode) => boolean;
+    extractEventData?: (n: SDKGraphNode) => Partial<TriggerRule>;
+    resolveCondition?: (id: string, ctx: GraphParserContext) => RuleCondition | null;
+    resolveAction?: (id: string, ctx: GraphParserContext) => Action | ActionGroup | null;
+    /**
+     * Options to control deduplication behavior.
+     * Use this to keep intentional duplicates (for templates) or use uniqueIdField
+     * to differentiate items that should not be merged.
+     */
+    optimizeOptions?: OptimizeOptions;
+}
+export interface GraphParserContext {
+    nodes: SDKGraphNode[];
+    edges: SDKGraphEdge[];
+    visitedConds?: Set<string>;
+    visitedActs?: Set<string>;
+    options: GraphParserOptions;
+    transformers?: {
+        condition?: (cond: RuleCondition, node: SDKGraphNode) => RuleCondition | null;
+        action?: (act: Action | ActionGroup, node: SDKGraphNode) => Action | ActionGroup | null;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sdk/graph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/sdk/graph/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,MAAM,EACN,WAAW,EACX,YAAY,EACZ,YAAY,EACb,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAMlD,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IAC3C,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IAC1C,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC;IACzC,gBAAgB,CAAC,EAAE,CAAC,CAAC,EAAE,YAAY,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7D,gBAAgB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,KAAK,aAAa,GAAG,IAAI,CAAC;IACjF,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,kBAAkB,KAAK,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;IACrF;;;;OAIG;IACH,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,YAAY,CAAC,EAAE;QACb,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,KAAK,aAAa,GAAG,IAAI,CAAC;QAC9E,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,IAAI,EAAE,YAAY,KAAK,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC;KACzF,CAAA;CACF"}

package/dist/sdk/graph-parser.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Graph Parser - Main entry point for parsing graph structures into rules
+ * This module coordinates the conversion of SDKGraphNode/SDKGraphEdge to TriggerRule
+ */
+import { RuleBuilder } from './builder';
+import { BranchType } from './constants';
+import type { TriggerRule, Action, ActionGroup, SDKGraphNode, SDKGraphEdge, InlineConditionalAction } from '../types';
+import { extractEventData } from './graph';
+import type { GraphParserOptions, GraphParserContext } from './graph/types';
+export type { GraphParserOptions, GraphParserContext } from './graph/types';
+export declare function createParserContext(nodes: SDKGraphNode[], edges: SDKGraphEdge[], options?: GraphParserOptions, transformers?: GraphParserContext['transformers']): GraphParserContext;
+export declare const defaultGetDoBranchType: (node: SDKGraphNode) => BranchType;
+export declare const defaultExtractEventData: typeof extractEventData;
+/**
+ * Collect all actions from a DO node, including:
+ * - Direct actions via do-output
+ * - Inline conditionals via do-condition-output
+ * Returns an array of actions that should be executed in order (mode: ALL)
+ */
+export declare function collectDoActions(doNodeId: string, ctx: GraphParserContext, sourceConditionId?: string): (Action | ActionGroup | InlineConditionalAction)[];
+/**
+ * Find the terminal condition(s) in a condition chain (where actions connect).
+ * Returns then/else action IDs.
+ */
+export declare function findTerminalActions(startConditionId: string, ctx: GraphParserContext): {
+    thenActionId?: string;
+    elseActionId?: string;
+};
+export declare function parseGraph(nodes: SDKGraphNode[], edges: SDKGraphEdge[], options?: GraphParserOptions, transformers?: GraphParserContext['transformers']): RuleBuilder;
+/**
+ * Parse a graph with multiple event nodes and return multiple rules.
+ * This allows editing multiple rules in a single editor view.
+ *
+ * Each Event node in the graph becomes a separate TriggerRule.
+ */
+export declare function parseGraphToRules(nodes: SDKGraphNode[], edges: SDKGraphEdge[], options?: GraphParserOptions, transformers?: GraphParserContext['transformers']): {
+    rules: TriggerRule[];
+    errors: string[];
+};
+//# sourceMappingURL=graph-parser.d.ts.map

package/dist/sdk/graph-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-parser.d.ts","sourceRoot":"","sources":["../../src/sdk/graph-parser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAY,UAAU,EAAY,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EACV,WAAW,EAEX,MAAM,EACN,WAAW,EAEX,YAAY,EACZ,YAAY,EACZ,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAML,gBAAgB,EAQjB,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,kBAAkB,EAAC,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE3E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAM5E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,kBAAuB,EAChC,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAChD,kBAAkB,CAgBpB;AAOD,eAAO,MAAM,sBAAsB,oCAAkB,CAAC;AACtD,eAAO,MAAM,uBAAuB,yBAAmB,CAAC;AAiFxD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,kBAAkB,EACvB,iBAAiB,CAAC,EAAE,MAAM,GACzB,CAAC,MAAM,GAAG,WAAW,GAAG,uBAAuB,CAAC,EAAE,CAyBpD;AAKD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,MAAM,EACxB,GAAG,EAAE,kBAAkB,GACtB;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CA2FlD;AAMD,wBAAgB,UAAU,CACxB,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,kBAAuB,EAChC,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAChD,WAAW,CAkRb;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,YAAY,EAAE,EACrB,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,GAAE,kBAAuB,EAChC,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,GAChD;IAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAwD5C"}

package/dist/sdk/index.d.ts

@@ -1,3 +1,6 @@
 export * from "./builder";
 export * from "./exporter";
+export * from "./yaml-parser";
+export * from "./graph-parser";
+export * from "./constants";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/sdk/optimize.d.ts

@@ -0,0 +1,27 @@
+import type { RuleCondition, Action, ActionGroup } from "../types";
+/**
+ * Options for controlling deduplication behavior.
+ */
+export interface OptimizeOptions {
+    /**
+     * Whether to deduplicate conditions/actions.
+     * Default: true (for conditions), false (for actions) - backward compatible
+     * Set to false to keep all duplicates (useful for templates where repetition is intentional)
+     */
+    deduplicate?: boolean;
+    /**
+     * Unique identifier field to use for comparing items.
+     * If provided, items with different IDs are considered different even if other fields match.
+     * This allows intentional duplicates (same content, different IDs) to be preserved.
+     */
+    uniqueIdField?: string;
+}
+/**
+ * Optimize conditions by deduplicating and flattening nested groups.
+ */
+export declare function optimizeCondition(cond: RuleCondition | RuleCondition[], options?: OptimizeOptions): RuleCondition | RuleCondition[] | undefined;
+/**
+ * Optimize actions by deduplicating and flattening nested groups.
+ */
+export declare function optimizeAction(act: Action | ActionGroup | (Action | ActionGroup)[], options?: OptimizeOptions): Action | ActionGroup | (Action | ActionGroup)[] | undefined;
+//# sourceMappingURL=optimize.d.ts.map

package/dist/sdk/optimize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"optimize.d.ts","sourceRoot":"","sources":["../../src/sdk/optimize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEnE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA6BD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,GAAG,aAAa,EAAE,EACrC,OAAO,GAAE,eAAoB,GAC5B,aAAa,GAAG,aAAa,EAAE,GAAG,SAAS,CAqD7C;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,EACpD,OAAO,GAAE,eAAoB,GAC5B,MAAM,GAAG,WAAW,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,GAAG,SAAS,CAwF7D"}

package/dist/sdk/yaml/converter.d.ts

@@ -0,0 +1,81 @@
+/**
+ * YAML to Editor Node/Edge Converter
+ *
+ * This module converts TriggerRule objects to React Flow editor nodes and edges.
+ * It supports all node types including:
+ * - Event nodes
+ * - Condition nodes (including groups)
+ * - Action nodes (including inline conditionals)
+ * - Action groups
+ * - DO nodes (for graph-based representation)
+ */
+import type { TriggerRule, Action, ExecutionMode, InlineConditionalAction } from '../../types';
+import type { EditorNode, EditorEdge, TriggerRuleToNodesResult } from './types';
+/**
+ * Build an Event node from TriggerRule
+ */
+export declare function buildEventNode(rule: TriggerRule, nodeId: string, position: {
+    x: number;
+    y: number;
+}): EditorNode;
+/**
+ * Build a Condition Group node
+ */
+export declare function buildConditionGroupNode(operator: 'AND' | 'OR', nodeId: string, position: {
+    x: number;
+    y: number;
+}): EditorNode;
+/**
+ * Build a single Condition node
+ */
+export declare function buildConditionNode(field: string, operator: string, value: unknown, nodeId: string, position: {
+    x: number;
+    y: number;
+}): EditorNode;
+/**
+ * Build a DO node (for inline conditionals in graph)
+ */
+export declare function buildDoNode(branchType: 'do' | 'else', nodeId: string, position: {
+    x: number;
+    y: number;
+}): EditorNode;
+/**
+ * Build an Action node
+ */
+export declare function buildActionNode(action: Action | InlineConditionalAction, nodeId: string, position: {
+    x: number;
+    y: number;
+}): EditorNode;
+/**
+ * Build an Action Group node
+ */
+export declare function buildActionGroupNode(mode: ExecutionMode, nodeId: string, position: {
+    x: number;
+    y: number;
+}): EditorNode;
+/**
+ * Build an edge between two nodes
+ */
+export declare function buildEdge(source: string, target: string, sourceHandle?: string | null, targetHandle?: string | null, edgeIdGenerator?: () => string): EditorEdge;
+/**
+ * Convert a TriggerRule to editor nodes and edges
+ */
+export declare function triggerRuleToNodes(rule: TriggerRule, options?: {
+    startNodeId?: string;
+    startPosition?: {
+        x: number;
+        y: number;
+    };
+}): TriggerRuleToNodesResult;
+declare const _default: {
+    triggerRuleToNodes: typeof triggerRuleToNodes;
+    buildEventNode: typeof buildEventNode;
+    buildConditionGroupNode: typeof buildConditionGroupNode;
+    buildConditionNode: typeof buildConditionNode;
+    buildDoNode: typeof buildDoNode;
+    buildActionNode: typeof buildActionNode;
+    buildActionGroupNode: typeof buildActionGroupNode;
+    buildEdge: typeof buildEdge;
+};
+export default _default;
+//# sourceMappingURL=converter.d.ts.map

package/dist/sdk/yaml/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../../src/sdk/yaml/converter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACV,WAAW,EAEX,MAAM,EAGN,aAAa,EACb,uBAAuB,EAExB,MAAM,aAAa,CAAC;AAQrB,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EAEV,wBAAwB,EACzB,MAAM,SAAS,CAAC;AAkBjB;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,UAAU,CAgBZ;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,KAAK,GAAG,IAAI,EACtB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,UAAU,CASZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,UAAU,CAWZ;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,IAAI,GAAG,MAAM,EACzB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,UAAU,CASZ;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,GAAG,uBAAuB,EACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,UAAU,CAkEZ;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,UAAU,CASZ;AAMD;;GAEG;AACH,wBAAgB,SAAS,CACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,EAC5B,eAAe,CAAC,EAAE,MAAM,MAAM,GAC7B,UAAU,CAQZ;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrC,GACL,wBAAwB,CA0H1B;;;;;;;;;;;AAsUD,wBASE"}

package/dist/sdk/yaml/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * YAML Parser Module
+ *
+ * This is the main entry point for the modularized YAML parser.
+ * It provides:
+ * - Type definitions (types.ts)
+ * - Utility functions (utils.ts)
+ * - Rule normalization (normalizer.ts)
+ * - Node/edge conversion (converter.ts)
+ *
+ * Re-exports from the main yaml-parser.ts for backward compatibility.
+ */
+import type { TriggerRule } from '../../types';
+import type { YamlParserOptions, YamlParserResult } from './types';
+export type { YamlParserOptions, YamlParserResult, YamlParserError, EditorNodeType, EditorNode, EditorEdge, TriggerRuleToNodesResult, RawCondition, RawAction, RawRule } from './types';
+export type { ComparisonOperator, ExecutionMode } from '../../types';
+export { isObject, isNonEmptyString, isValidNumber, isBoolean, isConditionGroup, isSimpleCondition, isActionGroup, hasConditionalExecution, isSimpleAction, isValidExecutionMode, isValidConditionOperator, isValidComparisonOperator, getActionType, getActionParams, getConditionField, getConditionOperator, getConditionValue, createNodeIdGenerator, createEdgeIdGenerator, createPositionCalculator, ensureArray, normalizeActions, normalizeConditions as normalizeConditionsUtils, generateRuleIdFromFilename, normalizeOperator, requireField, validateFieldType, validateFieldValue } from './utils';
+export { normalizeRule, normalizeConditions, normalizeDoField, normalizeElseField, normalizeAction, normalizeRuleAdvanced, validateRule } from './normalizer';
+export { triggerRuleToNodes, buildEventNode, buildConditionGroupNode, buildConditionNode, buildDoNode, buildActionNode, buildActionGroupNode, buildEdge } from './converter';
+/**
+ * Parse a YAML string into TriggerRule objects
+ */
+export declare function parseYamlRules(yamlContent: string, options?: {
+    autoId?: boolean | string;
+    filename?: string;
+    throwOnError?: boolean;
+    multiDocument?: boolean;
+}): YamlParserResult;
+/**
+ * Parse a single YAML document (not multi-document)
+ * Shorthand for parseYamlRules with multiDocument: false
+ */
+export declare function parseYamlRule(yamlContent: string, options?: Omit<YamlParserOptions, 'multiDocument'>): YamlParserResult;
+/**
+ * Parse YAML and return the first valid rule
+ * Throws if there are errors or no rules
+ */
+export declare function parseYamlRuleStrict(yamlContent: string, options?: Omit<YamlParserOptions, 'throwOnError'>): TriggerRule;
+//# sourceMappingURL=index.d.ts.map

package/dist/sdk/yaml/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sdk/yaml/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAyE,MAAM,aAAa,CAAC;AAItH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAmB,MAAM,SAAS,CAAC;AAMpF,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,wBAAwB,EACxB,YAAY,EACZ,SAAS,EACT,OAAO,EACR,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,cAAc,EACd,oBAAoB,EACpB,wBAAwB,EACxB,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,wBAAwB,EACxB,WAAW,EACX,gBAAgB,EAChB,mBAAmB,IAAI,wBAAwB,EAC/C,0BAA0B,EAC1B,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,aAAa,EACb,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,eAAe,EACf,qBAAqB,EACrB,YAAY,EACb,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,kBAAkB,EAClB,WAAW,EACX,eAAe,EACf,oBAAoB,EACpB,SAAS,EACV,MAAM,aAAa,CAAC;AAMrB;;GAEG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACpB,GACL,gBAAgB,CA2GlB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,eAAe,CAAM,GACrD,gBAAgB,CAElB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,IAAI,CAAC,iBAAiB,EAAE,cAAc,CAAM,GACpD,WAAW,CAQb"}