ts-workflow-engine-lite 2.1.0

package/dist/src/engine/executors/JoinNodeExecutor.js

@@ -0,0 +1,37 @@
+import { Logger } from "../../utils/Logger.js";
+export async function execute(config, instance) {
+    if (!config?.waitFor ||
+        !Array.isArray(config.waitFor) ||
+        config.waitFor.length === 0) {
+        throw new Error("Join node requires a non-empty config.waitFor array");
+    }
+    const mode = config.mode ?? "all";
+    const nodes = instance.state?.nodes ?? {};
+    const results = {};
+    const missing = [];
+    for (const nodeId of config.waitFor) {
+        const nodeState = nodes[nodeId];
+        if (nodeState && nodeState.output !== undefined) {
+            results[nodeId] = nodeState.output;
+        }
+        else {
+            missing.push(nodeId);
+        }
+    }
+    if (mode === "all" && missing.length > 0) {
+        const message = `Join node is missing output from: ${missing.join(", ")} (waitFor=[${config.waitFor.join(", ")}])`;
+        Logger.error(instance.instanceId, "join-node", message);
+        throw new Error(message);
+    }
+    if (mode === "any" && Object.keys(results).length === 0) {
+        const message = `Join node (mode=any) found no completed branches among: ${config.waitFor.join(", ")}`;
+        Logger.error(instance.instanceId, "join-node", message);
+        throw new Error(message);
+    }
+    Logger.log(instance.instanceId, "join-node", `Join resolved (mode=${mode}): ${Object.keys(results).length}/${config.waitFor.length} branches`, { resolved: Object.keys(results), missing });
+    return { results, missing };
+}
+export const JoinNodeExecutor = {
+    execute,
+};
+//# sourceMappingURL=JoinNodeExecutor.js.map

package/dist/src/engine/executors/JoinNodeExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoinNodeExecutor.js","sourceRoot":"","sources":["../../../../src/engine/executors/JoinNodeExecutor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA4C5C,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAsB,EACtB,QAA0B;IAE1B,IACE,CAAC,MAAM,EAAE,OAAO;QAChB,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9B,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAC3B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC;IAClC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC;IAE1C,MAAM,OAAO,GAA4B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;QAChC,IAAI,SAAS,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChD,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC;QACrC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,KAAK,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,qCAAqC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACnH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,IAAI,IAAI,KAAK,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,OAAO,GAAG,2DAA2D,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACvG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3B,CAAC;IAED,MAAM,CAAC,GAAG,CACR,QAAQ,CAAC,UAAU,EACnB,WAAW,EACX,uBAAuB,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,WAAW,EAChG,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAC5C,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO;CACR,CAAC"}

package/dist/src/engine/executors/LoopNodeExecutor.d.ts

@@ -0,0 +1,20 @@
+import type { WorkflowInstance } from "../../model/Instance.js";
+export interface LoopNodeConfig {
+    collection: string;
+    itemVariable: string;
+    indexVariable?: string;
+    body: string;
+    parallel?: boolean;
+    maxConcurrency?: number;
+}
+export interface LoopNodeOutput {
+    iterations: number;
+    results: any[];
+    duration: number;
+}
+export declare function getBodyNode(config: LoopNodeConfig): string;
+export declare function execute(config: LoopNodeConfig, instance: WorkflowInstance, executeBody: (itemContext: Record<string, any>, index: number) => Promise<any>): Promise<LoopNodeOutput>;
+export declare const LoopNodeExecutor: {
+    execute: typeof execute;
+    getBodyNode: typeof getBodyNode;
+};

package/dist/src/engine/executors/LoopNodeExecutor.js

@@ -0,0 +1,165 @@
+import { parseEnvInt } from "../../utils/env.js";
+import { Logger } from "../../utils/Logger.js";
+import { getConcurrencyControl } from "../ConcurrencyControl.js";
+import { evaluate, interpolateObject } from "../ExpressionEvaluator.js";
+function getMaxLoopIterations() {
+    return parseEnvInt(process.env.MAX_LOOP_ITERATIONS, 10_000, { min: 1 });
+}
+function evaluateCollection(collectionExpr, instance) {
+    const evaluationContext = {
+        ...instance.context,
+        context: instance.context || {},
+        state: instance.state || {},
+    };
+    if (instance.state?.nodes) {
+        for (const [nodeId, nodeState] of Object.entries(instance.state.nodes)) {
+            if (nodeState.output !== undefined) {
+                evaluationContext[nodeId] = nodeState.output;
+            }
+        }
+    }
+    try {
+        const result = evaluate(collectionExpr, evaluationContext);
+        return result;
+    }
+    catch (error) {
+        Logger.error(instance.instanceId, "loop-node", `Error evaluating collection expression: ${collectionExpr}`, error?.stack);
+        throw new Error(`Invalid collection expression: ${error.message}`, {
+            cause: error,
+        });
+    }
+}
+async function executeSequential(collection, config, instance, executeBody) {
+    const results = [];
+    for (let i = 0; i < collection.length; i++) {
+        const item = collection[i];
+        Logger.log(instance.instanceId, "loop-node", `Executing iteration ${i + 1}/${collection.length}`);
+        const itemContext = {
+            [config.itemVariable]: item,
+        };
+        if (config.indexVariable) {
+            itemContext[config.indexVariable] = i;
+        }
+        try {
+            const result = await executeBody(itemContext, i);
+            results.push(result);
+            Logger.log(instance.instanceId, "loop-node", `Iteration ${i + 1}/${collection.length} completed`);
+        }
+        catch (error) {
+            Logger.error(instance.instanceId, "loop-node", `Iteration ${i + 1}/${collection.length} failed: ${error.message}`, error?.stack);
+            throw new Error(`Loop iteration ${i} failed: ${error.message}`, {
+                cause: error,
+            });
+        }
+    }
+    return results;
+}
+async function executeParallel(collection, config, instance, executeBody) {
+    const configuredConcurrency = config.maxConcurrency ??
+        getConcurrencyControl().getConfig().maxConcurrentNodesPerInstance;
+    const maxConcurrency = Number.isFinite(configuredConcurrency) && configuredConcurrency >= 1
+        ? Math.trunc(configuredConcurrency)
+        : collection.length;
+    Logger.log(instance.instanceId, "loop-node", `Executing ${collection.length} iterations in parallel (max concurrency: ${maxConcurrency})`);
+    if (maxConcurrency >= collection.length) {
+        const promises = collection.map(async (item, i) => {
+            const itemContext = {
+                [config.itemVariable]: item,
+            };
+            if (config.indexVariable) {
+                itemContext[config.indexVariable] = i;
+            }
+            try {
+                const result = await executeBody(itemContext, i);
+                Logger.log(instance.instanceId, "loop-node", `Parallel iteration ${i + 1}/${collection.length} completed`);
+                return result;
+            }
+            catch (error) {
+                Logger.error(instance.instanceId, "loop-node", `Parallel iteration ${i + 1}/${collection.length} failed: ${error.message}`, error?.stack);
+                throw new Error(`Loop iteration ${i} failed: ${error.message}`, {
+                    cause: error,
+                });
+            }
+        });
+        return await Promise.all(promises);
+    }
+    const results = Array.from({ length: collection.length });
+    const executing = new Set();
+    let firstError;
+    for (let index = 0; index < collection.length; index++) {
+        if (firstError)
+            break;
+        const itemContext = {
+            [config.itemVariable]: collection[index],
+        };
+        if (config.indexVariable) {
+            itemContext[config.indexVariable] = index;
+        }
+        const promise = executeBody(itemContext, index)
+            .then((result) => {
+            results[index] = result;
+            Logger.log(instance.instanceId, "loop-node", `Parallel iteration ${index + 1}/${collection.length} completed`);
+        })
+            .catch((error) => {
+            Logger.error(instance.instanceId, "loop-node", `Parallel iteration ${index + 1}/${collection.length} failed: ${error.message}`, error?.stack);
+            firstError ??= new Error(`Loop iteration ${index} failed: ${error.message}`, { cause: error });
+        })
+            .finally(() => {
+            executing.delete(promise);
+        });
+        executing.add(promise);
+        if (executing.size >= maxConcurrency) {
+            await Promise.race(executing);
+        }
+    }
+    await Promise.all(executing);
+    if (firstError)
+        throw firstError;
+    return results;
+}
+export function getBodyNode(config) {
+    return config.body;
+}
+export async function execute(config, instance, executeBody) {
+    const startTime = Date.now();
+    const context = {
+        context: instance.context || {},
+        state: instance.state || {},
+    };
+    const evaluatedConfig = interpolateObject(config, context, instance.state);
+    Logger.log(instance.instanceId, "loop-node", `Evaluating collection expression: ${evaluatedConfig.collection}`);
+    try {
+        const collection = evaluateCollection(evaluatedConfig.collection, instance);
+        if (!Array.isArray(collection)) {
+            throw new Error(`Collection expression must return an array, got ${typeof collection} ` +
+                `(expression: ${evaluatedConfig.collection})`);
+        }
+        const maxIterations = getMaxLoopIterations();
+        if (collection.length > maxIterations) {
+            throw new Error(`Loop iteration count ${collection.length} exceeds the limit of ${maxIterations}`);
+        }
+        Logger.log(instance.instanceId, "loop-node", `Starting loop with ${collection.length} iterations (mode: ${evaluatedConfig.parallel ? "parallel" : "sequential"})`);
+        const results = evaluatedConfig.parallel
+            ? await executeParallel(collection, evaluatedConfig, instance, executeBody)
+            : await executeSequential(collection, evaluatedConfig, instance, executeBody);
+        const duration = Date.now() - startTime;
+        Logger.log(instance.instanceId, "loop-node", `Loop completed: ${collection.length} iterations in ${duration}ms`);
+        return {
+            iterations: collection.length,
+            results,
+            duration,
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        Logger.error(instance.instanceId, "loop-node", `Loop execution failed after ${duration}ms: ${error.message}`, error?.stack);
+        throw new Error(`Loop execution failed: ${error.message}`, {
+            cause: error,
+        });
+    }
+}
+export const LoopNodeExecutor = {
+    execute,
+    getBodyNode,
+};
+//# sourceMappingURL=LoopNodeExecutor.js.map

package/dist/src/engine/executors/LoopNodeExecutor.js.map

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

package/dist/src/engine/executors/NotificationNodeExecutor.d.ts

@@ -0,0 +1,8 @@
+import type { WorkflowInstance } from "../../model/Instance.js";
+import type { NotificationNodeConfig } from "../../model/Workflow.js";
+import type { NotificationResult } from "../../notification/NotificationChannel.js";
+import { type NotificationManager } from "../../notification/NotificationManager.js";
+export declare function execute(config: NotificationNodeConfig, instance: WorkflowInstance, manager?: NotificationManager): Promise<NotificationResult>;
+export declare const NotificationNodeExecutor: {
+    execute: typeof execute;
+};

package/dist/src/engine/executors/NotificationNodeExecutor.js

@@ -0,0 +1,33 @@
+import { notificationManager, } from "../../notification/NotificationManager.js";
+import { Logger } from "../../utils/Logger.js";
+function buildTemplateContext(instance) {
+    return {
+        ...instance.context,
+        context: instance.context ?? {},
+        state: instance.state ?? {},
+    };
+}
+export async function execute(config, instance, manager = notificationManager) {
+    const templateContext = buildTemplateContext(instance);
+    const message = manager.renderMessage({
+        target: config.target,
+        subject: config.subject,
+        body: config.template,
+        severity: config.severity,
+        data: config.data,
+    }, templateContext, instance.state);
+    Logger.info(instance.instanceId, "notification", "Sending notification", {
+        channel: config.channel,
+        target: message.target,
+        severity: message.severity ?? "info",
+    });
+    const result = await manager.send(config.channel, message);
+    if (!result.ok) {
+        throw new Error(result.error ?? `Notification channel ${config.channel} send failed`);
+    }
+    return result;
+}
+export const NotificationNodeExecutor = {
+    execute,
+};
+//# sourceMappingURL=NotificationNodeExecutor.js.map

package/dist/src/engine/executors/NotificationNodeExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationNodeExecutor.js","sourceRoot":"","sources":["../../../../src/engine/executors/NotificationNodeExecutor.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,mBAAmB,GACpB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,SAAS,oBAAoB,CAC3B,QAA0B;IAE1B,OAAO;QACL,GAAG,QAAQ,CAAC,OAAO;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO,IAAI,EAAE;QAC/B,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,EAAE;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAA8B,EAC9B,QAA0B,EAC1B,UAA+B,mBAAmB;IAElD,MAAM,eAAe,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CACnC;QACE,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,IAAI,EAAE,MAAM,CAAC,QAAQ;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,EACD,eAAe,EACf,QAAQ,CAAC,KAAK,CACf,CAAC;IAEF,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,cAAc,EAAE,sBAAsB,EAAE;QACvE,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,MAAM;KACrC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,MAAM,CAAC,KAAK,IAAI,wBAAwB,MAAM,CAAC,OAAO,cAAc,CACrE,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,OAAO;CACR,CAAC"}

package/dist/src/engine/executors/QueueNodeExecutor.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowInstance } from "../../model/Instance.js";
+export interface QueueNodeConfig {
+    operation: "publish" | "consume";
+    queue: string;
+    message?: unknown;
+    timeout?: number;
+}
+export interface QueueNodeOutput {
+    messageId?: string;
+    message?: unknown;
+}
+export interface QueueProvider {
+    publish(queue: string, message: unknown): Promise<string>;
+    consume(queue: string, timeout?: number): Promise<unknown>;
+    close?(): Promise<void>;
+}
+export declare function registerQueueProvider(name: string, provider: QueueProvider): void;
+export declare function unregisterQueueProvider(name: string): void;
+export declare function getQueueProvider(name: string): QueueProvider | undefined;
+export declare function execute(config: QueueNodeConfig, instance: WorkflowInstance): Promise<QueueNodeOutput>;
+export declare const QueueNodeExecutor: {
+    execute: typeof execute;
+};

package/dist/src/engine/executors/QueueNodeExecutor.js

@@ -0,0 +1,87 @@
+import { errorMessage, errorStack, Logger } from "../../utils/Logger.js";
+import { interpolateObject } from "../ExpressionEvaluator.js";
+const queueProviders = new Map();
+export function registerQueueProvider(name, provider) {
+    queueProviders.set(name, provider);
+    Logger.info("queue-node", "provider-registered", `Queue provider registered: ${name}`);
+}
+export function unregisterQueueProvider(name) {
+    const provider = queueProviders.get(name);
+    if (provider?.close) {
+        provider.close().catch((error) => {
+            Logger.error("queue-node", "provider-close-error", `Error closing queue provider ${name}`, errorStack(error));
+        });
+    }
+    queueProviders.delete(name);
+    Logger.info("queue-node", "provider-unregistered", `Queue provider unregistered: ${name}`);
+}
+export function getQueueProvider(name) {
+    return queueProviders.get(name);
+}
+async function withTimeout(work, ms, message) {
+    let timeoutId;
+    const timeout = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => reject(new Error(message)), ms);
+    });
+    try {
+        return await Promise.race([work, timeout]);
+    }
+    finally {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+    }
+}
+async function executePublish(provider, queue, message) {
+    return await provider.publish(queue, message);
+}
+async function executeConsume(provider, queue, timeout) {
+    if (!timeout) {
+        return await provider.consume(queue);
+    }
+    return await withTimeout(provider.consume(queue, timeout), timeout, `Queue consume timeout after ${timeout}ms`);
+}
+export async function execute(config, instance) {
+    const startTime = Date.now();
+    const context = {
+        context: instance.context || {},
+        state: instance.state || {},
+    };
+    const evaluatedConfig = interpolateObject(config, context, instance.state);
+    Logger.log(instance.instanceId, "queue-node", `Executing queue ${evaluatedConfig.operation} operation on queue: ${evaluatedConfig.queue}`);
+    try {
+        const provider = queueProviders.get("default");
+        if (!provider) {
+            throw new Error("Queue provider not found. " +
+                `Please register a queue provider using registerQueueProvider('default', provider).`);
+        }
+        let result;
+        if (evaluatedConfig.operation === "publish") {
+            if (evaluatedConfig.message === undefined) {
+                throw new Error("Queue publish operation requires a message");
+            }
+            const messageId = await executePublish(provider, evaluatedConfig.queue, evaluatedConfig.message);
+            result = { messageId };
+            const duration = Date.now() - startTime;
+            Logger.log(instance.instanceId, "queue-node", `Message published to queue ${evaluatedConfig.queue}: ${messageId} in ${duration}ms`);
+        }
+        else if (evaluatedConfig.operation === "consume") {
+            const message = await executeConsume(provider, evaluatedConfig.queue, evaluatedConfig.timeout);
+            result = { message };
+            const duration = Date.now() - startTime;
+            Logger.log(instance.instanceId, "queue-node", `Message consumed from queue ${evaluatedConfig.queue} in ${duration}ms`);
+        }
+        else {
+            throw new Error(`Invalid queue operation: ${evaluatedConfig.operation}. Must be 'publish' or 'consume'.`);
+        }
+        return result;
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        Logger.error(instance.instanceId, "queue-node", `Queue ${config.operation} operation failed after ${duration}ms: ${errorMessage(error)}`, errorStack(error));
+        throw new Error(`Queue ${config.operation} operation failed: ${errorMessage(error)}`, { cause: error });
+    }
+}
+export const QueueNodeExecutor = {
+    execute,
+};
+//# sourceMappingURL=QueueNodeExecutor.js.map

package/dist/src/engine/executors/QueueNodeExecutor.js.map

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

package/dist/src/engine/executors/RouterNodeExecutor.d.ts

@@ -0,0 +1,20 @@
+import type { WorkflowInstance } from "../../model/Instance.js";
+export interface RouterRoute {
+    condition: string;
+    target: string;
+    priority?: number;
+}
+export interface RouterNodeConfig {
+    routes: RouterRoute[];
+    defaultTarget?: string;
+}
+export interface RouterNodeOutput {
+    matchedRoute: number;
+    target: string;
+}
+export declare function getNextNode(output: RouterNodeOutput): string;
+export declare function execute(config: RouterNodeConfig, instance: WorkflowInstance): Promise<RouterNodeOutput>;
+export declare const RouterNodeExecutor: {
+    execute: typeof execute;
+    getNextNode: typeof getNextNode;
+};

package/dist/src/engine/executors/RouterNodeExecutor.js

@@ -0,0 +1,82 @@
+import { errorMessage, errorStack, Logger } from "../../utils/Logger.js";
+import { evaluate, interpolateObject } from "../ExpressionEvaluator.js";
+function evaluateCondition(condition, instance) {
+    const evaluationContext = {
+        ...instance.context,
+        context: instance.context || {},
+        state: instance.state || {},
+    };
+    if (instance.state?.nodes) {
+        for (const [nodeId, nodeState] of Object.entries(instance.state.nodes)) {
+            if (nodeState.output !== undefined) {
+                evaluationContext[nodeId] = nodeState.output;
+            }
+        }
+    }
+    try {
+        const result = evaluate(condition, evaluationContext);
+        return Boolean(result);
+    }
+    catch (error) {
+        Logger.error(instance.instanceId, "router-node", `Error evaluating condition expression: ${condition}`, errorStack(error));
+        throw new Error(`Invalid condition expression: ${errorMessage(error)}`, {
+            cause: error,
+        });
+    }
+}
+export function getNextNode(output) {
+    return output.target;
+}
+export async function execute(config, instance) {
+    const startTime = Date.now();
+    const context = {
+        context: instance.context || {},
+        state: instance.state || {},
+    };
+    const evaluatedConfig = interpolateObject(config, context, instance.state);
+    Logger.log(instance.instanceId, "router-node", `Evaluating ${evaluatedConfig.routes.length} routes`);
+    try {
+        const sortedRoutes = [...evaluatedConfig.routes].sort((a, b) => {
+            const priorityA = a.priority ?? Number.MAX_SAFE_INTEGER;
+            const priorityB = b.priority ?? Number.MAX_SAFE_INTEGER;
+            return priorityA - priorityB;
+        });
+        for (let i = 0; i < sortedRoutes.length; i++) {
+            const route = sortedRoutes[i];
+            const originalIndex = evaluatedConfig.routes.indexOf(route);
+            Logger.log(instance.instanceId, "router-node", `Evaluating route ${i} (priority ${route.priority ?? "default"}): ${route.condition}`);
+            const conditionResult = evaluateCondition(route.condition, instance);
+            if (conditionResult) {
+                const duration = Date.now() - startTime;
+                Logger.log(instance.instanceId, "router-node", `Route ${originalIndex} matched, routing to ${route.target} in ${duration}ms`);
+                return {
+                    matchedRoute: originalIndex,
+                    target: route.target,
+                };
+            }
+        }
+        if (evaluatedConfig.defaultTarget) {
+            const duration = Date.now() - startTime;
+            Logger.log(instance.instanceId, "router-node", `No routes matched, using default target ${evaluatedConfig.defaultTarget} in ${duration}ms`);
+            return {
+                matchedRoute: -1,
+                target: evaluatedConfig.defaultTarget,
+            };
+        }
+        const duration = Date.now() - startTime;
+        Logger.error(instance.instanceId, "router-node", `No routes matched and no default target configured after ${duration}ms`);
+        throw new Error("No routes matched and no default target configured");
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        Logger.error(instance.instanceId, "router-node", `Router evaluation failed after ${duration}ms: ${errorMessage(error)}`, errorStack(error));
+        throw new Error(`Router evaluation failed: ${errorMessage(error)}`, {
+            cause: error,
+        });
+    }
+}
+export const RouterNodeExecutor = {
+    execute,
+    getNextNode,
+};
+//# sourceMappingURL=RouterNodeExecutor.js.map

package/dist/src/engine/executors/RouterNodeExecutor.js.map

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

package/dist/src/engine/executors/SqlNodeExecutor.d.ts

@@ -0,0 +1,27 @@
+import type { WorkflowInstance } from "../../model/Instance.js";
+export interface SqlNodeConfig {
+    connection: string;
+    query: string;
+    parameters?: unknown[];
+    timeout?: number;
+    database?: "postgres" | "mysql" | "sqlite" | "mssql" | "generic";
+}
+export interface SqlNodeOutput {
+    rows: unknown[];
+    rowCount: number;
+    duration: number;
+}
+export interface SqlConnectionPool {
+    query(sql: string, params?: unknown[]): Promise<{
+        rows: unknown[];
+        rowCount: number;
+    }>;
+    close?(): Promise<void>;
+}
+export declare function registerSqlConnectionPool(name: string, pool: SqlConnectionPool): void;
+export declare function unregisterSqlConnectionPool(name: string): void;
+export declare function getSqlConnectionPool(name: string): SqlConnectionPool | undefined;
+export declare function execute(config: SqlNodeConfig, instance: WorkflowInstance): Promise<SqlNodeOutput>;
+export declare const SqlNodeExecutor: {
+    execute: typeof execute;
+};

package/dist/src/engine/executors/SqlNodeExecutor.js

@@ -0,0 +1,74 @@
+import { errorMessage, errorStack, Logger } from "../../utils/Logger.js";
+import { interpolateObject } from "../ExpressionEvaluator.js";
+const connectionPools = new Map();
+export function registerSqlConnectionPool(name, pool) {
+    connectionPools.set(name, pool);
+    Logger.info("sql-node", "pool-registered", `SQL connection pool registered: ${name}`);
+}
+export function unregisterSqlConnectionPool(name) {
+    const pool = connectionPools.get(name);
+    if (pool?.close) {
+        pool.close().catch((error) => {
+            Logger.error("sql-node", "pool-close-error", `Error closing connection pool ${name}`, errorStack(error));
+        });
+    }
+    connectionPools.delete(name);
+    Logger.info("sql-node", "pool-unregistered", `SQL connection pool unregistered: ${name}`);
+}
+export function getSqlConnectionPool(name) {
+    return connectionPools.get(name);
+}
+async function withTimeout(work, ms, message) {
+    let timeoutId;
+    const timeout = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => reject(new Error(message)), ms);
+    });
+    try {
+        return await Promise.race([work, timeout]);
+    }
+    finally {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+    }
+}
+async function executeWithTimeout(pool, query, parameters, timeout) {
+    if (!timeout) {
+        return await pool.query(query, parameters);
+    }
+    return await withTimeout(pool.query(query, parameters), timeout, `SQL query timeout after ${timeout}ms`);
+}
+export async function execute(config, instance) {
+    const startTime = Date.now();
+    const context = {
+        context: instance.context || {},
+        state: instance.state || {},
+    };
+    const evaluatedConfig = interpolateObject(config, context, instance.state);
+    Logger.log(instance.instanceId, "sql-node", `Executing SQL query on connection: ${evaluatedConfig.connection}`);
+    try {
+        const pool = connectionPools.get(evaluatedConfig.connection);
+        if (!pool) {
+            throw new Error(`SQL connection pool not found: ${evaluatedConfig.connection}. ` +
+                "Please register the connection pool using registerSqlConnectionPool().");
+        }
+        const result = await executeWithTimeout(pool, evaluatedConfig.query, evaluatedConfig.parameters, evaluatedConfig.timeout);
+        const duration = Date.now() - startTime;
+        Logger.log(instance.instanceId, "sql-node", `SQL query completed: ${result.rowCount} rows affected/returned in ${duration}ms`);
+        return {
+            rows: result.rows,
+            rowCount: result.rowCount,
+            duration,
+        };
+    }
+    catch (error) {
+        const duration = Date.now() - startTime;
+        Logger.error(instance.instanceId, "sql-node", `SQL query failed after ${duration}ms: ${errorMessage(error)}`, errorStack(error));
+        throw new Error(`SQL query failed: ${errorMessage(error)}`, {
+            cause: error,
+        });
+    }
+}
+export const SqlNodeExecutor = {
+    execute,
+};
+//# sourceMappingURL=SqlNodeExecutor.js.map

package/dist/src/engine/executors/SqlNodeExecutor.js.map

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

package/dist/src/engine/executors/TransformNodeExecutor.d.ts

@@ -0,0 +1,9 @@
+import type { WorkflowInstance } from "../../model/Instance.js";
+export interface TransformNodeConfig {
+    output: Record<string, string>;
+}
+export type TransformNodeOutput = Record<string, unknown>;
+export declare function execute(config: TransformNodeConfig, instance: WorkflowInstance): Promise<TransformNodeOutput>;
+export declare const TransformNodeExecutor: {
+    execute: typeof execute;
+};