ts-workflow-engine-lite 2.1.0

package/dist/src/engine/worker/WorkerProcess.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/engine/worker/WorkerProcess.js

@@ -0,0 +1,76 @@
+import { parentPort, workerData } from "node:worker_threads";
+if (!parentPort) {
+    throw new Error("WorkerProcess must be run as a worker thread");
+}
+const workerId = workerData?.workerId ?? "worker-unknown";
+const executorCache = new Map();
+parentPort.on("message", async (message) => {
+    if (message.type !== "execute") {
+        return;
+    }
+    const executeMessage = message;
+    const startTime = Date.now();
+    try {
+        const executor = await loadExecutor(executeMessage.payload.nodeType);
+        const result = await executor.execute(executeMessage.payload.config, {
+            instanceId: executeMessage.payload.instanceId,
+            workflowId: executeMessage.payload.workflowId,
+            status: "running",
+            context: executeMessage.payload.context,
+            state: executeMessage.payload.state,
+            currentNodes: [executeMessage.payload.nodeId],
+            history: [],
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            version: 0,
+        });
+        parentPort?.postMessage({
+            type: "result",
+            taskId: executeMessage.taskId,
+            payload: {
+                output: result,
+                duration: Date.now() - startTime,
+                workerId,
+            },
+        });
+    }
+    catch (error) {
+        const normalizedError = error instanceof Error ? error : new Error(String(error));
+        parentPort?.postMessage({
+            type: "error",
+            taskId: executeMessage.taskId,
+            payload: {
+                message: normalizedError.message,
+                stack: normalizedError.stack,
+            },
+        });
+    }
+});
+async function loadExecutor(nodeType) {
+    const cached = executorCache.get(nodeType);
+    if (cached) {
+        return cached;
+    }
+    const executor = await importExecutor(nodeType);
+    executorCache.set(nodeType, executor);
+    return executor;
+}
+async function importExecutor(nodeType) {
+    switch (nodeType) {
+        case "http": {
+            const module = await import("../executors/HttpNodeExecutor.js");
+            return module.HttpNodeExecutor;
+        }
+        case "sql": {
+            const module = await import("../executors/SqlNodeExecutor.js");
+            return module.SqlNodeExecutor;
+        }
+        case "queue": {
+            const module = await import("../executors/QueueNodeExecutor.js");
+            return module.QueueNodeExecutor;
+        }
+        default:
+            throw new Error(`No worker executor registered for node type: ${nodeType}`);
+    }
+}
+//# sourceMappingURL=WorkerProcess.js.map

package/dist/src/engine/worker/WorkerProcess.js.map

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

package/dist/src/event/EventBus.d.ts

@@ -0,0 +1,11 @@
+export type EventHandler = (data: unknown) => void | Promise<void>;
+export declare class EventBus {
+    private handlers;
+    on(event: string, handler: EventHandler): void;
+    emit(event: string, data: unknown): void;
+    off(event: string, handler: EventHandler): void;
+    protected dispatchLocal(event: string, data: unknown): void;
+    close(): Promise<void>;
+    listenerCount(): number;
+}
+export declare const eventBus: EventBus;

package/dist/src/event/EventBus.js

@@ -0,0 +1,44 @@
+import { Logger } from "../utils/Logger.js";
+export class EventBus {
+    handlers = {};
+    on(event, handler) {
+        if (!this.handlers[event])
+            this.handlers[event] = [];
+        this.handlers[event].push(handler);
+    }
+    emit(event, data) {
+        this.dispatchLocal(event, data);
+    }
+    off(event, handler) {
+        if (!this.handlers[event])
+            return;
+        this.handlers[event] = this.handlers[event].filter((h) => h !== handler);
+    }
+    dispatchLocal(event, data) {
+        if (this.handlers[event]) {
+            for (const h of this.handlers[event]) {
+                try {
+                    const result = h(data);
+                    if (result && typeof result.catch === "function") {
+                        result.catch((error) => {
+                            Logger.warn("system", "eventbus", `Async event handler error for '${event}'`, {
+                                error: error instanceof Error ? error.message : String(error),
+                            });
+                        });
+                    }
+                }
+                catch (error) {
+                    Logger.warn("system", "eventbus", `Event handler error for '${event}'`, { error: error instanceof Error ? error.message : String(error) });
+                }
+            }
+        }
+    }
+    async close() {
+        this.handlers = {};
+    }
+    listenerCount() {
+        return Object.values(this.handlers).reduce((total, list) => total + list.length, 0);
+    }
+}
+export const eventBus = new EventBus();
+//# sourceMappingURL=EventBus.js.map

package/dist/src/event/EventBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventBus.js","sourceRoot":"","sources":["../../../src/event/EventBus.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAIzC,MAAM,OAAO,QAAQ;IACX,QAAQ,GAAmC,EAAE,CAAC;IAEtD,EAAE,CAAC,KAAa,EAAE,OAAqB;QACrC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACrD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,IAAa;QAC/B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,KAAa,EAAE,OAAqB;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO;QAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC;IAC3E,CAAC;IAMS,aAAa,CAAC,KAAa,EAAE,IAAa;QAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;oBAEvB,IAAI,MAAM,IAAI,OAAQ,MAAwB,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;wBACnE,MAAwB,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;4BACjD,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,UAAU,EACV,kCAAkC,KAAK,GAAG,EAC1C;gCACE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;6BAC9D,CACF,CAAC;wBACJ,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,UAAU,EACV,4BAA4B,KAAK,GAAG,EACpC,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAClE,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IASD,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAGD,aAAa;QACX,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,CACxC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,EACpC,CAAC,CACF,CAAC;IACJ,CAAC;CACF;AAGD,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC"}

package/dist/src/event/EventCoordinator.d.ts

@@ -0,0 +1,26 @@
+import type { EventWaitingState, StorageProvider } from "../storage/StorageProvider.js";
+import type { EventBus } from "./EventBus.js";
+import { type AsyncEventDeduplicator } from "./EventDeduplicator.js";
+export interface WaitForEventOptions {
+    condition?: string;
+    requireInstanceIdMatch?: boolean;
+    timeoutMs?: number;
+    onTimeout?: () => void;
+    onEvent?: (payload: any) => void;
+}
+export declare class EventCoordinator {
+    private eventBus;
+    private storage;
+    private deduplicator;
+    private waitingTrackers;
+    constructor(eventBus: EventBus, storage: StorageProvider, deduplicator?: AsyncEventDeduplicator);
+    waitForEvent(instanceId: string, nodeId: string, eventType: string, options?: WaitForEventOptions): Promise<void>;
+    private subscribeToEvent;
+    private cleanup;
+    cancelWait(instanceId: string, nodeId: string): Promise<void>;
+    handleTimeout(instanceId: string, nodeId: string): Promise<void>;
+    restoreWaitingStates(shouldSkip?: (instanceId: string, nodeId: string) => boolean): Promise<void>;
+    getWaitingStates(): EventWaitingState[];
+    getWaitingState(instanceId: string, nodeId: string): EventWaitingState | undefined;
+    destroy(): void;
+}

package/dist/src/event/EventCoordinator.js

@@ -0,0 +1,205 @@
+import { evaluateCondition } from "../engine/ExpressionEvaluator.js";
+import { recordEventWaitEnd, recordEventWaitStart } from "../metrics/index.js";
+import { Logger } from "../utils/Logger.js";
+import { createDeduplicator, } from "./EventDeduplicator.js";
+export class EventCoordinator {
+    eventBus;
+    storage;
+    deduplicator;
+    waitingTrackers = new Map();
+    constructor(eventBus, storage, deduplicator) {
+        this.eventBus = eventBus;
+        this.storage = storage;
+        this.deduplicator = deduplicator ?? createDeduplicator();
+    }
+    async waitForEvent(instanceId, nodeId, eventType, options = {}) {
+        const { condition, requireInstanceIdMatch, timeoutMs, onTimeout, onEvent } = options;
+        const deadline = timeoutMs ? Date.now() + timeoutMs : undefined;
+        const state = {
+            instanceId,
+            nodeId,
+            eventType,
+            condition,
+            requireInstanceIdMatch,
+            timeoutMs,
+            deadline,
+            createdAt: Date.now(),
+        };
+        await this.storage.saveEventWaitingState(state);
+        Logger.info(instanceId, nodeId, `Event waiting state persisted for event ${eventType}`, { deadline, timeoutMs });
+        const instance = await this.storage.loadInstance(instanceId);
+        if (instance) {
+            recordEventWaitStart(instance.workflowId);
+        }
+        await this.subscribeToEvent(state, onTimeout, onEvent);
+    }
+    async subscribeToEvent(state, onTimeout, onEvent) {
+        const key = `${state.instanceId}:${state.nodeId}`;
+        if (this.waitingTrackers.has(key)) {
+            Logger.warn(state.instanceId, state.nodeId, `Already subscribed to event ${state.eventType}`);
+            return;
+        }
+        let processed = false;
+        const eventHandler = async (data) => {
+            if (processed) {
+                Logger.debug(state.instanceId, state.nodeId, `Event ${state.eventType} already processed, ignoring`);
+                return;
+            }
+            if (state.requireInstanceIdMatch) {
+                if (!data || data.instanceId !== state.instanceId) {
+                    Logger.debug(state.instanceId, state.nodeId, `Event ${state.eventType} instanceId mismatch, ignoring`, {
+                        expected: state.instanceId,
+                        received: data?.instanceId,
+                    });
+                    return;
+                }
+            }
+            if (state.deadline && Date.now() > state.deadline) {
+                Logger.info(state.instanceId, state.nodeId, `Event ${state.eventType} arrived after timeout, ignoring`);
+                return;
+            }
+            if (state.condition) {
+                const instance = await this.storage.loadInstance(state.instanceId);
+                if (!instance) {
+                    Logger.warn(state.instanceId, state.nodeId, `Instance not found while evaluating condition for ${state.eventType}`);
+                    return;
+                }
+                const matched = evaluateCondition(state.condition, {
+                    context: instance.context,
+                    state: instance.state,
+                    event: data,
+                });
+                if (!matched) {
+                    Logger.debug(state.instanceId, state.nodeId, `Event ${state.eventType} condition not matched, ignoring`, { condition: state.condition });
+                    return;
+                }
+            }
+            const claimKey = `wait:${state.instanceId}:${state.nodeId}:${state.eventType}:${state.createdAt}`;
+            if (await this.deduplicator.isDuplicate(claimKey)) {
+                Logger.debug(state.instanceId, state.nodeId, `Event ${state.eventType} already claimed by another node, ignoring`);
+                processed = true;
+                await this.cleanup(state.instanceId, state.nodeId);
+                return;
+            }
+            processed = true;
+            Logger.info(state.instanceId, state.nodeId, `Event ${state.eventType} received and matched`);
+            await this.cleanup(state.instanceId, state.nodeId);
+            if (onEvent) {
+                onEvent(data);
+            }
+        };
+        let timeoutId;
+        if (state.deadline) {
+            const timeoutDelay = state.deadline - Date.now();
+            if (timeoutDelay > 0) {
+                timeoutId = setTimeout(async () => {
+                    if (processed) {
+                        return;
+                    }
+                    processed = true;
+                    Logger.info(state.instanceId, state.nodeId, `Timeout expired for event ${state.eventType}`);
+                    await this.cleanup(state.instanceId, state.nodeId);
+                    if (onTimeout) {
+                        onTimeout();
+                    }
+                }, timeoutDelay);
+            }
+            else {
+                Logger.warn(state.instanceId, state.nodeId, `Deadline already passed for event ${state.eventType}`);
+                processed = true;
+                await this.cleanup(state.instanceId, state.nodeId);
+                if (onTimeout) {
+                    onTimeout();
+                }
+                return;
+            }
+        }
+        const tracker = {
+            state,
+            timeoutId,
+            eventHandler,
+            onTimeout,
+            onEvent,
+        };
+        this.waitingTrackers.set(key, tracker);
+        this.eventBus.on(state.eventType, eventHandler);
+        Logger.debug(state.instanceId, state.nodeId, `Subscribed to event ${state.eventType}`, { deadline: state.deadline });
+    }
+    async cleanup(instanceId, nodeId) {
+        const key = `${instanceId}:${nodeId}`;
+        const tracker = this.waitingTrackers.get(key);
+        if (!tracker) {
+            return;
+        }
+        if (tracker.timeoutId) {
+            clearTimeout(tracker.timeoutId);
+        }
+        if (tracker.eventHandler) {
+            this.eventBus.off(tracker.state.eventType, tracker.eventHandler);
+        }
+        this.waitingTrackers.delete(key);
+        await this.storage.deleteEventWaitingState(instanceId, nodeId);
+        const instance = await this.storage.loadInstance(instanceId);
+        if (instance) {
+            recordEventWaitEnd(instance.workflowId);
+        }
+        Logger.debug(instanceId, nodeId, "Event waiting state cleaned up");
+    }
+    async cancelWait(instanceId, nodeId) {
+        await this.cleanup(instanceId, nodeId);
+        Logger.info(instanceId, nodeId, "Event wait cancelled");
+    }
+    async handleTimeout(instanceId, nodeId) {
+        const key = `${instanceId}:${nodeId}`;
+        const tracker = this.waitingTrackers.get(key);
+        if (!tracker) {
+            Logger.warn(instanceId, nodeId, "No waiting state found for timeout handling");
+            return;
+        }
+        Logger.info(instanceId, nodeId, `Handling timeout for event ${tracker.state.eventType}`);
+        await this.cleanup(instanceId, nodeId);
+        if (tracker.onTimeout) {
+            tracker.onTimeout();
+        }
+    }
+    async restoreWaitingStates(shouldSkip) {
+        Logger.info("system", "event-coordinator", "Restoring event waiting states from storage");
+        const states = await this.storage.loadAllEventWaitingStates();
+        Logger.info("system", "event-coordinator", `Found ${states.length} waiting states to restore`);
+        for (const state of states) {
+            if (shouldSkip?.(state.instanceId, state.nodeId)) {
+                Logger.debug(state.instanceId, state.nodeId, `Skipping waiting-state restore for ${state.eventType} — instance will be resumed directly`);
+                continue;
+            }
+            if (state.deadline && Date.now() > state.deadline) {
+                Logger.info(state.instanceId, state.nodeId, `Deadline already passed for event ${state.eventType}, cleaning up`);
+                await this.storage.deleteEventWaitingState(state.instanceId, state.nodeId);
+                continue;
+            }
+            await this.subscribeToEvent(state);
+            Logger.info(state.instanceId, state.nodeId, `Restored event waiting for ${state.eventType}`);
+        }
+        Logger.info("system", "event-coordinator", `Restored ${states.length} event waiting states`);
+    }
+    getWaitingStates() {
+        return Array.from(this.waitingTrackers.values()).map((tracker) => tracker.state);
+    }
+    getWaitingState(instanceId, nodeId) {
+        const key = `${instanceId}:${nodeId}`;
+        const tracker = this.waitingTrackers.get(key);
+        return tracker?.state;
+    }
+    destroy() {
+        for (const [key, tracker] of this.waitingTrackers) {
+            if (tracker.timeoutId) {
+                clearTimeout(tracker.timeoutId);
+            }
+            if (tracker.eventHandler) {
+                this.eventBus.off(tracker.state.eventType, tracker.eventHandler);
+            }
+            this.waitingTrackers.delete(key);
+        }
+        this.deduplicator.destroy();
+    }
+}
+//# sourceMappingURL=EventCoordinator.js.map

package/dist/src/event/EventCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventCoordinator.js","sourceRoot":"","sources":["../../../src/event/EventCoordinator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAK5E,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAEL,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AA4B7B,MAAM,OAAO,gBAAgB;IACnB,QAAQ,CAAW;IACnB,OAAO,CAAkB;IACzB,YAAY,CAAyB;IACrC,eAAe,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEjE,YACE,QAAkB,EAClB,OAAwB,EACxB,YAAqC;QAErC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,YAAY,IAAI,kBAAkB,EAAE,CAAC;IAC3D,CAAC;IAMD,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,MAAc,EACd,SAAiB,EACjB,UAA+B,EAAE;QAEjC,MAAM,EAAE,SAAS,EAAE,sBAAsB,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,GACxE,OAAO,CAAC;QAGV,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAGhE,MAAM,KAAK,GAAsB;YAC/B,UAAU;YACV,MAAM;YACN,SAAS;YACT,SAAS;YACT,sBAAsB;YACtB,SAAS;YACT,QAAQ;YACR,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAGF,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,CAAC,IAAI,CACT,UAAU,EACV,MAAM,EACN,2CAA2C,SAAS,EAAE,EACtD,EAAE,QAAQ,EAAE,SAAS,EAAE,CACxB,CAAC;QAKF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACb,oBAAoB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC;QAGD,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACzD,CAAC;IAKO,KAAK,CAAC,gBAAgB,CAC5B,KAAwB,EACxB,SAAsB,EACtB,OAAgC;QAEhC,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QAGlD,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,+BAA+B,KAAK,CAAC,SAAS,EAAE,CACjD,CAAC;YACF,OAAO;QACT,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QAGtB,MAAM,YAAY,GAAG,KAAK,EAAE,IAAS,EAAE,EAAE;YAEvC,IAAI,SAAS,EAAE,CAAC;gBACd,MAAM,CAAC,KAAK,CACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,SAAS,KAAK,CAAC,SAAS,8BAA8B,CACvD,CAAC;gBACF,OAAO;YACT,CAAC;YAED,IAAI,KAAK,CAAC,sBAAsB,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK,CAAC,UAAU,EAAE,CAAC;oBAClD,MAAM,CAAC,KAAK,CACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,SAAS,KAAK,CAAC,SAAS,gCAAgC,EACxD;wBACE,QAAQ,EAAE,KAAK,CAAC,UAAU;wBAC1B,QAAQ,EAAE,IAAI,EAAE,UAAU;qBAC3B,CACF,CAAC;oBACF,OAAO;gBACT,CAAC;YACH,CAAC;YAGD,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClD,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,SAAS,KAAK,CAAC,SAAS,kCAAkC,CAC3D,CAAC;gBACF,OAAO;YACT,CAAC;YAED,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBACnE,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,qDAAqD,KAAK,CAAC,SAAS,EAAE,CACvE,CAAC;oBACF,OAAO;gBACT,CAAC;gBAED,MAAM,OAAO,GAAG,iBAAiB,CAAC,KAAK,CAAC,SAAS,EAAE;oBACjD,OAAO,EAAE,QAAQ,CAAC,OAAO;oBACzB,KAAK,EAAE,QAAQ,CAAC,KAAK;oBACrB,KAAK,EAAE,IAAI;iBACZ,CAAC,CAAC;gBAEH,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,CAAC,KAAK,CACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,SAAS,KAAK,CAAC,SAAS,kCAAkC,EAC1D,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAC/B,CAAC;oBACF,OAAO;gBACT,CAAC;YACH,CAAC;YAMD,MAAM,QAAQ,GAAG,QAAQ,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YAClG,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClD,MAAM,CAAC,KAAK,CACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,SAAS,KAAK,CAAC,SAAS,4CAA4C,CACrE,CAAC;gBACF,SAAS,GAAG,IAAI,CAAC;gBACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACnD,OAAO;YACT,CAAC;YAGD,SAAS,GAAG,IAAI,CAAC;YAEjB,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,SAAS,KAAK,CAAC,SAAS,uBAAuB,CAChD,CAAC;YAGF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;YAGnD,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC;QAGF,IAAI,SAAqC,CAAC;QAC1C,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,YAAY,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjD,IAAI,YAAY,GAAG,CAAC,EAAE,CAAC;gBACrB,SAAS,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;oBAEhC,IAAI,SAAS,EAAE,CAAC;wBACd,OAAO;oBACT,CAAC;oBAED,SAAS,GAAG,IAAI,CAAC;oBAEjB,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,6BAA6B,KAAK,CAAC,SAAS,EAAE,CAC/C,CAAC;oBAGF,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;oBAGnD,IAAI,SAAS,EAAE,CAAC;wBACd,SAAS,EAAE,CAAC;oBACd,CAAC;gBACH,CAAC,EAAE,YAAY,CAAC,CAAC;YACnB,CAAC;iBAAM,CAAC;gBAEN,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,qCAAqC,KAAK,CAAC,SAAS,EAAE,CACvD,CAAC;gBACF,SAAS,GAAG,IAAI,CAAC;gBACjB,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACnD,IAAI,SAAS,EAAE,CAAC;oBACd,SAAS,EAAE,CAAC;gBACd,CAAC;gBACD,OAAO;YACT,CAAC;QACH,CAAC;QAGD,MAAM,OAAO,GAAwB;YACnC,KAAK;YACL,SAAS;YACT,YAAY;YACZ,SAAS;YACT,OAAO;SACR,CAAC;QACF,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAGvC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAEhD,MAAM,CAAC,KAAK,CACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,uBAAuB,KAAK,CAAC,SAAS,EAAE,EACxC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAC7B,CAAC;IACJ,CAAC;IAKO,KAAK,CAAC,OAAO,CAAC,UAAkB,EAAE,MAAc;QACtD,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QAGD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAClC,CAAC;QAGD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;QACnE,CAAC;QAGD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAGjC,MAAM,IAAI,CAAC,OAAO,CAAC,uBAAuB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAG/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,QAAQ,EAAE,CAAC;YACb,kBAAkB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,gCAAgC,CAAC,CAAC;IACrE,CAAC;IAKD,KAAK,CAAC,UAAU,CAAC,UAAkB,EAAE,MAAc;QACjD,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC;IAC1D,CAAC;IAKD,KAAK,CAAC,aAAa,CAAC,UAAkB,EAAE,MAAc;QACpD,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,UAAU,EACV,MAAM,EACN,6CAA6C,CAC9C,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CACT,UAAU,EACV,MAAM,EACN,8BAA8B,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,CACxD,CAAC;QAGF,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QAGvC,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,OAAO,CAAC,SAAS,EAAE,CAAC;QACtB,CAAC;IACH,CAAC;IAcD,KAAK,CAAC,oBAAoB,CACxB,UAA4D;QAE5D,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,mBAAmB,EACnB,6CAA6C,CAC9C,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,yBAAyB,EAAE,CAAC;QAE9D,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,mBAAmB,EACnB,SAAS,MAAM,CAAC,MAAM,4BAA4B,CACnD,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,KAAK,CACV,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,sCAAsC,KAAK,CAAC,SAAS,sCAAsC,CAC5F,CAAC;gBACF,SAAS;YACX,CAAC;YAGD,IAAI,KAAK,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAClD,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,qCAAqC,KAAK,CAAC,SAAS,eAAe,CACpE,CAAC;gBACF,MAAM,IAAI,CAAC,OAAO,CAAC,uBAAuB,CACxC,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,CACb,CAAC;gBACF,SAAS;YACX,CAAC;YAKD,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAEnC,MAAM,CAAC,IAAI,CACT,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,MAAM,EACZ,8BAA8B,KAAK,CAAC,SAAS,EAAE,CAChD,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,mBAAmB,EACnB,YAAY,MAAM,CAAC,MAAM,uBAAuB,CACjD,CAAC;IACJ,CAAC;IAKD,gBAAgB;QACd,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAClD,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAC3B,CAAC;IACJ,CAAC;IAKD,eAAe,CACb,UAAkB,EAClB,MAAc;QAEd,MAAM,GAAG,GAAG,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,OAAO,EAAE,KAAK,CAAC;IACxB,CAAC;IAMD,OAAO;QACL,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAClD,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;YACD,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;YACnE,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;IAC9B,CAAC;CACF"}

package/dist/src/event/EventDeduplicator.d.ts

@@ -0,0 +1,31 @@
+export declare class EventDeduplicator {
+    private processedEvents;
+    private readonly ttlMs;
+    private cleanupInterval?;
+    constructor(ttlSeconds?: number);
+    isDuplicate(eventId: string): boolean;
+    markProcessed(eventId: string): void;
+    clearEvent(eventId: string): void;
+    private startCleanup;
+    private cleanup;
+    getStats(): {
+        totalRecords: number;
+        oldestRecordAge: number;
+    };
+    destroy(): void;
+}
+export interface AsyncEventDeduplicator {
+    isDuplicate(eventId: string): Promise<boolean>;
+    clearEvent(eventId: string): Promise<void>;
+    destroy(): void;
+}
+export declare class MemoryAsyncDeduplicator implements AsyncEventDeduplicator {
+    private readonly inner;
+    constructor(ttlSeconds?: number);
+    isDuplicate(eventId: string): Promise<boolean>;
+    clearEvent(eventId: string): Promise<void>;
+    destroy(): void;
+}
+export declare function createDeduplicator(): AsyncEventDeduplicator;
+export declare function getDeduplicator(): EventDeduplicator;
+export declare function setDeduplicator(dedup: EventDeduplicator): void;

package/dist/src/event/EventDeduplicator.js

@@ -0,0 +1,100 @@
+import { parseEnvInt } from "../utils/env.js";
+import { Logger } from "../utils/Logger.js";
+export class EventDeduplicator {
+    processedEvents = new Map();
+    ttlMs;
+    cleanupInterval;
+    constructor(ttlSeconds = 86400) {
+        this.ttlMs = ttlSeconds * 1000;
+        this.startCleanup();
+    }
+    isDuplicate(eventId) {
+        const now = Date.now();
+        const existingTime = this.processedEvents.get(eventId);
+        if (existingTime && now - existingTime < this.ttlMs) {
+            Logger.debug("system", "dedup", `Duplicate event detected: ${eventId}`);
+            return true;
+        }
+        this.processedEvents.set(eventId, now);
+        return false;
+    }
+    markProcessed(eventId) {
+        this.processedEvents.set(eventId, Date.now());
+    }
+    clearEvent(eventId) {
+        this.processedEvents.delete(eventId);
+    }
+    startCleanup() {
+        this.cleanupInterval = setInterval(() => {
+            this.cleanup();
+        }, 3600000);
+        this.cleanupInterval.unref?.();
+    }
+    cleanup() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [eventId, timestamp] of this.processedEvents) {
+            if (now - timestamp > this.ttlMs) {
+                this.processedEvents.delete(eventId);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            Logger.debug("system", "dedup", `Cleaned up ${cleaned} expired event records`);
+        }
+    }
+    getStats() {
+        let oldestAge = 0;
+        const now = Date.now();
+        for (const timestamp of this.processedEvents.values()) {
+            const age = now - timestamp;
+            if (age > oldestAge) {
+                oldestAge = age;
+            }
+        }
+        return {
+            totalRecords: this.processedEvents.size,
+            oldestRecordAge: Math.floor(oldestAge / 1000),
+        };
+    }
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.processedEvents.clear();
+    }
+}
+export class MemoryAsyncDeduplicator {
+    inner;
+    constructor(ttlSeconds) {
+        this.inner = new EventDeduplicator(ttlSeconds ?? getDedupTtlSeconds());
+    }
+    async isDuplicate(eventId) {
+        return this.inner.isDuplicate(eventId);
+    }
+    async clearEvent(eventId) {
+        this.inner.clearEvent(eventId);
+    }
+    destroy() {
+        this.inner.destroy();
+    }
+}
+function getDedupTtlSeconds() {
+    return parseEnvInt(process.env.EVENT_DEDUP_TTL_SECONDS, 86_400, { min: 1 });
+}
+export function createDeduplicator() {
+    return new MemoryAsyncDeduplicator();
+}
+let deduplicatorInstance = null;
+export function getDeduplicator() {
+    if (!deduplicatorInstance) {
+        const ttl = Number.parseInt(process.env.EVENT_DEDUP_TTL_SECONDS || "86400", 10);
+        deduplicatorInstance = new EventDeduplicator(ttl);
+    }
+    return deduplicatorInstance;
+}
+export function setDeduplicator(dedup) {
+    deduplicatorInstance = dedup;
+}
+//# sourceMappingURL=EventDeduplicator.js.map

package/dist/src/event/EventDeduplicator.js.map

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

package/dist/src/event/HookManager.d.ts

@@ -0,0 +1,31 @@
+export type HookEventType = "workflow.started" | "workflow.completed" | "workflow.failed" | "workflow.rollback" | "workflow.cancelled" | "workflow.paused" | "workflow.resumed" | "node.started" | "node.completed" | "node.failed" | "node.retry" | "node.skipped" | "node.waiting";
+export type HookEventName = HookEventType | (string & {});
+export interface HookPayload {
+    event: HookEventName;
+    timestamp: string;
+    workflowId?: string;
+    instanceId?: string;
+    nodeId?: string;
+    status?: string;
+    traceId?: string;
+    data?: Record<string, any>;
+}
+export type HookListener = (payload: HookPayload) => void | Promise<void>;
+export type HookDispatcher = (payload: HookPayload) => void | Promise<void>;
+export interface HookPayloadInput extends Omit<HookPayload, "timestamp"> {
+    timestamp?: string;
+}
+export declare function createHookPayload(payload: HookPayloadInput): HookPayload;
+export declare class HookManager {
+    private listeners;
+    private dispatcher?;
+    on(event: HookEventName | "*", handler: HookListener): () => void;
+    off(event: HookEventName | "*", handler: HookListener): void;
+    setDispatcher(dispatcher?: HookDispatcher): void;
+    emit(payload: HookPayload): Promise<void>;
+}
+export declare const hookManager: HookManager;
+export declare function onHook(event: HookEventName | "*", handler: HookListener): () => void;
+export declare function offHook(event: HookEventName | "*", handler: HookListener): void;
+export declare function emitHook(payload: HookPayload): Promise<void>;
+export declare function setHookDispatcher(dispatcher?: HookDispatcher): void;

package/dist/src/event/HookManager.js

@@ -0,0 +1,88 @@
+import { Logger } from "../utils/Logger.js";
+export function createHookPayload(payload) {
+    return {
+        timestamp: payload.timestamp ?? new Date().toISOString(),
+        ...payload,
+    };
+}
+export class HookManager {
+    listeners = new Map();
+    dispatcher;
+    on(event, handler) {
+        const key = event || "*";
+        const existing = this.listeners.get(key);
+        if (existing) {
+            existing.add(handler);
+        }
+        else {
+            this.listeners.set(key, new Set([handler]));
+        }
+        return () => this.off(event, handler);
+    }
+    off(event, handler) {
+        const key = event || "*";
+        const existing = this.listeners.get(key);
+        if (!existing)
+            return;
+        existing.delete(handler);
+        if (existing.size === 0) {
+            this.listeners.delete(key);
+        }
+    }
+    setDispatcher(dispatcher) {
+        this.dispatcher = dispatcher;
+    }
+    async emit(payload) {
+        const handlers = new Set();
+        const directHandlers = this.listeners.get(payload.event);
+        if (directHandlers) {
+            directHandlers.forEach((handler) => {
+                handlers.add(handler);
+            });
+        }
+        const wildcardHandlers = this.listeners.get("*");
+        if (wildcardHandlers) {
+            wildcardHandlers.forEach((handler) => {
+                handlers.add(handler);
+            });
+        }
+        const tasks = [];
+        if (this.dispatcher) {
+            tasks.push({
+                label: "dispatcher",
+                promise: Promise.resolve(this.dispatcher(payload)),
+            });
+        }
+        handlers.forEach((handler) => {
+            tasks.push({
+                label: "listener",
+                promise: Promise.resolve(handler(payload)),
+            });
+        });
+        if (tasks.length === 0)
+            return;
+        const results = await Promise.allSettled(tasks.map((task) => task.promise));
+        results.forEach((result, index) => {
+            if (result.status === "rejected") {
+                const label = tasks[index]?.label || "listener";
+                Logger.error("hook", "dispatch", `Hook ${label} failed for ${payload.event}`, result.reason instanceof Error
+                    ? result.reason.stack
+                    : String(result.reason));
+            }
+        });
+    }
+}
+export const hookManager = new HookManager();
+export function onHook(event, handler) {
+    return hookManager.on(event, handler);
+}
+export function offHook(event, handler) {
+    hookManager.off(event, handler);
+}
+export function emitHook(payload) {
+    return hookManager.emit(payload);
+}
+export function setHookDispatcher(dispatcher) {
+    hookManager.setDispatcher(dispatcher);
+}
+//# sourceMappingURL=HookManager.js.map