@baipeng139/72flow-nodejs 1.0.0

package/dist/index.d.cts

@@ -0,0 +1,270 @@
+/**
+ * 节点状态枚举
+ */
+declare enum NodeStatus {
+    PENDING = "PENDING",
+    RUNNING = "RUNNING",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    SKIPPED = "SKIPPED",
+    CANCELLED = "CANCELLED"
+}
+/**
+ * 节点类型枚举
+ */
+declare enum NodeType {
+    START = "START",
+    END = "END",
+    SCRIPT = "SCRIPT",
+    DECISION = "DECISION",
+    CONDITION = "CONDITION",
+    PARALLEL = "PARALLEL",
+    LOOP = "LOOP",
+    API = "API",
+    SUBFLOW = "SUBFLOW",
+    LLM = "LLM",
+    BUSINESS = "BUSINESS"
+}
+/**
+ * 边定义
+ */
+interface EdgeDef {
+    id: string;
+    name?: string;
+    from: string;
+    to: string;
+    condition?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * 节点配置定义
+ */
+interface NodeConfigDef {
+    script?: string;
+    api?: {
+        url: string;
+        method: string;
+        headers?: Record<string, string>;
+        body?: string;
+    };
+    loop?: {
+        condition?: string;
+        items?: string;
+        endNodeId?: string;
+    };
+    inputSchema?: Record<string, any>;
+    outputSchema?: Record<string, any>;
+    error?: {
+        mode: 'throw' | 'fail' | string;
+    };
+    [key: string]: any;
+}
+/**
+ * 节点定义
+ */
+interface NodeDef {
+    id: string;
+    type: string | NodeType;
+    name?: string;
+    code?: string;
+    config?: NodeConfigDef;
+    metadata?: Record<string, any>;
+}
+/**
+ * 流程定义
+ */
+interface FlowDefinition {
+    id: string;
+    name: string;
+    version: string;
+    nodes: NodeDef[];
+    edges: EdgeDef[];
+    metadata?: Record<string, any>;
+    convergeMap?: Record<string, string>;
+    loopBodyPaths?: Record<string, string[]>;
+}
+/**
+ * 节点执行结果
+ */
+interface NodeResult {
+    success: boolean;
+    data?: any;
+    message?: string;
+    code?: string;
+}
+/**
+ * 流程执行结果
+ */
+interface FlowResult {
+    executionId: string;
+    status: NodeStatus;
+    output?: any;
+    error?: string;
+    duration: number;
+    startTime: number;
+    endTime?: number;
+    variables: Record<string, any>;
+    traces: any[];
+}
+
+interface ExecutionTrace {
+    nodeId: string;
+    /** 节点业务编码（如 DECISION_abc），用于 UI 图标和 nodeMap 查询 */
+    code?: string;
+    status: NodeStatus;
+    startTime: number;
+    endTime?: number;
+    /** 耗时毫秒 */
+    duration?: number;
+    /** 耗时纳秒（与 Java 后端格式对齐，供 ExecutionResultModal 使用）*/
+    durationNs?: number;
+    data?: any;
+    error?: string;
+}
+declare class FlowContext {
+    private executionId;
+    private definition;
+    private variables;
+    private status;
+    private startTime;
+    private endTime?;
+    private nodeMap;
+    private outgoingMap;
+    private incomingMap;
+    private completedNodes;
+    private executingNodes;
+    private skippedNodes;
+    private nodeOutputs;
+    private convergeStates;
+    private traces;
+    constructor(executionId: string, definition: FlowDefinition, variables: Record<string, any>);
+    /** 构造时预建索引，所有后续查询均为 O(1) */
+    private buildIndex;
+    getExecutionId(): string;
+    getDefinition(): FlowDefinition;
+    getVariables(): {
+        [x: string]: any;
+    };
+    getStatus(): NodeStatus;
+    getStartTime(): number;
+    getEndTime(): number | undefined;
+    getDuration(): number;
+    getNodes(): NodeDef[];
+    getNode(id: string): NodeDef | undefined;
+    getOutgoing(nodeId: string): EdgeDef[];
+    getIncoming(nodeId: string): EdgeDef[];
+    getCompletedNodes(): Set<string>;
+    getSkippedNodes(): Set<string>;
+    getExecutingNodes(): Set<string>;
+    getNodeOutputs(): {
+        [x: string]: any;
+    };
+    getTraces(): ExecutionTrace[];
+    setStatus(status: NodeStatus): void;
+    /** 设置单个变量（供 LoopExecutor 写入 item/index 等迭代变量） */
+    setVariable(key: string, value: any): void;
+    skipNode(nodeId: string): void;
+    /** 注册并行汇聚点，expected = 分支数 */
+    registerConvergence(nodeId: string, expected: number): void;
+    arePrerequisitesMet(nodeId: string): boolean;
+    private isEffectivelySkipped;
+    tryExecute(nodeId: string): boolean;
+    complete(nodeId: string, output: any, startTime: number): void;
+    fail(nodeId: string, error: Error | string, startTime: number): void;
+    /** 并行汇聚：返回 true 代表当前节点所有分支已全部到达 */
+    tryConverge(nodeId: string, fromNodeId: string): boolean;
+    /** 获取 LOOP_START 节点的循环体路径（来自解析器预计算的 loopBodyPaths） */
+    getLoopBodyPath(loopStartNodeId: string): string[];
+}
+
+type EventHandler = (...args: any[]) => void;
+declare class SimpleEmitter {
+    private handlers;
+    on(event: string, handler: EventHandler): this;
+    once(event: string, handler: EventHandler): this;
+    off(event: string, handler: EventHandler): this;
+    emit(event: string, ...args: any[]): this;
+}
+declare class FlowEngine extends SimpleEmitter {
+    private activeContexts;
+    constructor();
+    execute(definition: FlowDefinition, variables?: Record<string, any>): Promise<FlowResult>;
+    private scheduleNode;
+    private runNode;
+    /**
+     * 触发下游节点。有汇聚时，等所有【非跳过】入边到达后才 schedule。
+     */
+    private triggerDownstream;
+    private handleFailure;
+    private buildResult;
+}
+
+interface NodeExecutor {
+    execute(node: NodeDef, context: FlowContext): Promise<NodeResult>;
+}
+declare class NodeExecutorFactory {
+    static execute(node: NodeDef, context: FlowContext): Promise<NodeResult>;
+}
+
+interface X6Node {
+    id: string;
+    shape: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    data?: {
+        meta?: Record<string, any>;
+        config?: Record<string, any>;
+    };
+}
+interface X6Edge {
+    id?: string;
+    source: string | {
+        cell: string;
+        port?: string;
+    };
+    target: string | {
+        cell: string;
+        port?: string;
+    };
+    data?: {
+        config?: {
+            branchResult?: string;
+            [k: string]: any;
+        };
+        priority?: number;
+    };
+}
+interface X6Graph {
+    nodes: X6Node[];
+    edges: X6Edge[];
+}
+declare class X6Parser {
+    /**
+     * 将前端 X6 序列化的 JSON 解析为引擎可执行的 FlowDefinition
+     */
+    parse(x6Json: X6Graph | string): FlowDefinition;
+    private parseNodes;
+    private normalizeConfig;
+    private normalizeApiField;
+    private parseEdges;
+    private extractCellId;
+    private computeConvergeMap;
+    /** BFS 找所有分支的第一个公共后继节点 */
+    private findConvergeNode;
+    private computeLoopBodyPaths;
+    private computeSingleLoopPath;
+    private buildOutgoingMap;
+}
+/** 便捷函数：直接解析 X6 JSON → FlowDefinition */
+declare function parseX6(x6Json: X6Graph | string): FlowDefinition;
+
+declare function createLogger(tag: string): {
+    debug: (msg: string, ...args: any[]) => void;
+    info: (msg: string, ...args: any[]) => void;
+    warn: (msg: string, ...args: any[]) => void;
+    error: (msg: string, ...args: any[]) => void;
+};
+
+export { type EdgeDef, type ExecutionTrace, FlowContext, type FlowDefinition, FlowEngine, type FlowResult, type NodeConfigDef, type NodeDef, type NodeExecutor, NodeExecutorFactory, type NodeResult, NodeStatus, NodeType, X6Parser, createLogger, parseX6 };

package/dist/index.d.ts

@@ -0,0 +1,270 @@
+/**
+ * 节点状态枚举
+ */
+declare enum NodeStatus {
+    PENDING = "PENDING",
+    RUNNING = "RUNNING",
+    COMPLETED = "COMPLETED",
+    FAILED = "FAILED",
+    SKIPPED = "SKIPPED",
+    CANCELLED = "CANCELLED"
+}
+/**
+ * 节点类型枚举
+ */
+declare enum NodeType {
+    START = "START",
+    END = "END",
+    SCRIPT = "SCRIPT",
+    DECISION = "DECISION",
+    CONDITION = "CONDITION",
+    PARALLEL = "PARALLEL",
+    LOOP = "LOOP",
+    API = "API",
+    SUBFLOW = "SUBFLOW",
+    LLM = "LLM",
+    BUSINESS = "BUSINESS"
+}
+/**
+ * 边定义
+ */
+interface EdgeDef {
+    id: string;
+    name?: string;
+    from: string;
+    to: string;
+    condition?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * 节点配置定义
+ */
+interface NodeConfigDef {
+    script?: string;
+    api?: {
+        url: string;
+        method: string;
+        headers?: Record<string, string>;
+        body?: string;
+    };
+    loop?: {
+        condition?: string;
+        items?: string;
+        endNodeId?: string;
+    };
+    inputSchema?: Record<string, any>;
+    outputSchema?: Record<string, any>;
+    error?: {
+        mode: 'throw' | 'fail' | string;
+    };
+    [key: string]: any;
+}
+/**
+ * 节点定义
+ */
+interface NodeDef {
+    id: string;
+    type: string | NodeType;
+    name?: string;
+    code?: string;
+    config?: NodeConfigDef;
+    metadata?: Record<string, any>;
+}
+/**
+ * 流程定义
+ */
+interface FlowDefinition {
+    id: string;
+    name: string;
+    version: string;
+    nodes: NodeDef[];
+    edges: EdgeDef[];
+    metadata?: Record<string, any>;
+    convergeMap?: Record<string, string>;
+    loopBodyPaths?: Record<string, string[]>;
+}
+/**
+ * 节点执行结果
+ */
+interface NodeResult {
+    success: boolean;
+    data?: any;
+    message?: string;
+    code?: string;
+}
+/**
+ * 流程执行结果
+ */
+interface FlowResult {
+    executionId: string;
+    status: NodeStatus;
+    output?: any;
+    error?: string;
+    duration: number;
+    startTime: number;
+    endTime?: number;
+    variables: Record<string, any>;
+    traces: any[];
+}
+
+interface ExecutionTrace {
+    nodeId: string;
+    /** 节点业务编码（如 DECISION_abc），用于 UI 图标和 nodeMap 查询 */
+    code?: string;
+    status: NodeStatus;
+    startTime: number;
+    endTime?: number;
+    /** 耗时毫秒 */
+    duration?: number;
+    /** 耗时纳秒（与 Java 后端格式对齐，供 ExecutionResultModal 使用）*/
+    durationNs?: number;
+    data?: any;
+    error?: string;
+}
+declare class FlowContext {
+    private executionId;
+    private definition;
+    private variables;
+    private status;
+    private startTime;
+    private endTime?;
+    private nodeMap;
+    private outgoingMap;
+    private incomingMap;
+    private completedNodes;
+    private executingNodes;
+    private skippedNodes;
+    private nodeOutputs;
+    private convergeStates;
+    private traces;
+    constructor(executionId: string, definition: FlowDefinition, variables: Record<string, any>);
+    /** 构造时预建索引，所有后续查询均为 O(1) */
+    private buildIndex;
+    getExecutionId(): string;
+    getDefinition(): FlowDefinition;
+    getVariables(): {
+        [x: string]: any;
+    };
+    getStatus(): NodeStatus;
+    getStartTime(): number;
+    getEndTime(): number | undefined;
+    getDuration(): number;
+    getNodes(): NodeDef[];
+    getNode(id: string): NodeDef | undefined;
+    getOutgoing(nodeId: string): EdgeDef[];
+    getIncoming(nodeId: string): EdgeDef[];
+    getCompletedNodes(): Set<string>;
+    getSkippedNodes(): Set<string>;
+    getExecutingNodes(): Set<string>;
+    getNodeOutputs(): {
+        [x: string]: any;
+    };
+    getTraces(): ExecutionTrace[];
+    setStatus(status: NodeStatus): void;
+    /** 设置单个变量（供 LoopExecutor 写入 item/index 等迭代变量） */
+    setVariable(key: string, value: any): void;
+    skipNode(nodeId: string): void;
+    /** 注册并行汇聚点，expected = 分支数 */
+    registerConvergence(nodeId: string, expected: number): void;
+    arePrerequisitesMet(nodeId: string): boolean;
+    private isEffectivelySkipped;
+    tryExecute(nodeId: string): boolean;
+    complete(nodeId: string, output: any, startTime: number): void;
+    fail(nodeId: string, error: Error | string, startTime: number): void;
+    /** 并行汇聚：返回 true 代表当前节点所有分支已全部到达 */
+    tryConverge(nodeId: string, fromNodeId: string): boolean;
+    /** 获取 LOOP_START 节点的循环体路径（来自解析器预计算的 loopBodyPaths） */
+    getLoopBodyPath(loopStartNodeId: string): string[];
+}
+
+type EventHandler = (...args: any[]) => void;
+declare class SimpleEmitter {
+    private handlers;
+    on(event: string, handler: EventHandler): this;
+    once(event: string, handler: EventHandler): this;
+    off(event: string, handler: EventHandler): this;
+    emit(event: string, ...args: any[]): this;
+}
+declare class FlowEngine extends SimpleEmitter {
+    private activeContexts;
+    constructor();
+    execute(definition: FlowDefinition, variables?: Record<string, any>): Promise<FlowResult>;
+    private scheduleNode;
+    private runNode;
+    /**
+     * 触发下游节点。有汇聚时，等所有【非跳过】入边到达后才 schedule。
+     */
+    private triggerDownstream;
+    private handleFailure;
+    private buildResult;
+}
+
+interface NodeExecutor {
+    execute(node: NodeDef, context: FlowContext): Promise<NodeResult>;
+}
+declare class NodeExecutorFactory {
+    static execute(node: NodeDef, context: FlowContext): Promise<NodeResult>;
+}
+
+interface X6Node {
+    id: string;
+    shape: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+    data?: {
+        meta?: Record<string, any>;
+        config?: Record<string, any>;
+    };
+}
+interface X6Edge {
+    id?: string;
+    source: string | {
+        cell: string;
+        port?: string;
+    };
+    target: string | {
+        cell: string;
+        port?: string;
+    };
+    data?: {
+        config?: {
+            branchResult?: string;
+            [k: string]: any;
+        };
+        priority?: number;
+    };
+}
+interface X6Graph {
+    nodes: X6Node[];
+    edges: X6Edge[];
+}
+declare class X6Parser {
+    /**
+     * 将前端 X6 序列化的 JSON 解析为引擎可执行的 FlowDefinition
+     */
+    parse(x6Json: X6Graph | string): FlowDefinition;
+    private parseNodes;
+    private normalizeConfig;
+    private normalizeApiField;
+    private parseEdges;
+    private extractCellId;
+    private computeConvergeMap;
+    /** BFS 找所有分支的第一个公共后继节点 */
+    private findConvergeNode;
+    private computeLoopBodyPaths;
+    private computeSingleLoopPath;
+    private buildOutgoingMap;
+}
+/** 便捷函数：直接解析 X6 JSON → FlowDefinition */
+declare function parseX6(x6Json: X6Graph | string): FlowDefinition;
+
+declare function createLogger(tag: string): {
+    debug: (msg: string, ...args: any[]) => void;
+    info: (msg: string, ...args: any[]) => void;
+    warn: (msg: string, ...args: any[]) => void;
+    error: (msg: string, ...args: any[]) => void;
+};
+
+export { type EdgeDef, type ExecutionTrace, FlowContext, type FlowDefinition, FlowEngine, type FlowResult, type NodeConfigDef, type NodeDef, type NodeExecutor, NodeExecutorFactory, type NodeResult, NodeStatus, NodeType, X6Parser, createLogger, parseX6 };