ts-workflow-engine-lite 2.1.0

package/dist/src/engine/ConcurrencyControl.js

@@ -0,0 +1,181 @@
+import { getAppConfig } from "../config/AppConfig.js";
+import { parseEnvInt } from "../utils/env.js";
+import { Logger } from "../utils/Logger.js";
+import { LockAcquisitionError } from "./errors.js";
+export class ConcurrencyControl {
+    locks = new Map();
+    semaphores = new Map();
+    config;
+    cleanupInterval;
+    constructor(config = {}) {
+        this.config = {
+            maxConcurrentInstances: config.maxConcurrentInstances ?? 100,
+            maxConcurrentNodesPerInstance: config.maxConcurrentNodesPerInstance ?? 10,
+            lockTimeout: config.lockTimeout ?? 30000,
+            retryDelay: config.retryDelay ?? 100,
+            maxRetries: config.maxRetries ?? 50,
+        };
+        this.cleanupInterval = setInterval(() => this.cleanupExpiredLocks(), 10000);
+        this.cleanupInterval.unref?.();
+    }
+    async acquireLock(resourceId, holderId, timeout) {
+        const lockTimeout = timeout ?? this.config.lockTimeout;
+        const now = Date.now();
+        const existingLock = this.locks.get(resourceId);
+        if (existingLock) {
+            if (existingLock.expiresAt > now) {
+                if (existingLock.holder === holderId) {
+                    existingLock.expiresAt = now + lockTimeout;
+                    return true;
+                }
+                return false;
+            }
+        }
+        this.locks.set(resourceId, {
+            holder: holderId,
+            acquiredAt: now,
+            expiresAt: now + lockTimeout,
+        });
+        Logger.debug("system", "lock", `Lock acquired: ${resourceId} by ${holderId}`);
+        return true;
+    }
+    releaseLock(resourceId, holderId) {
+        const lock = this.locks.get(resourceId);
+        if (!lock) {
+            return true;
+        }
+        if (lock.holder !== holderId) {
+            Logger.warn("system", "lock", `Cannot release lock ${resourceId}: held by ${lock.holder}, not ${holderId}`);
+            return false;
+        }
+        this.locks.delete(resourceId);
+        Logger.debug("system", "lock", `Lock released: ${resourceId} by ${holderId}`);
+        return true;
+    }
+    async acquireLockWithRetry(resourceId, holderId, timeout) {
+        for (let i = 0; i < this.config.maxRetries; i++) {
+            if (await this.acquireLock(resourceId, holderId, timeout)) {
+                return true;
+            }
+            await this.delay(this.backoffDelay(i));
+        }
+        Logger.warn("system", "lock", `Failed to acquire lock ${resourceId} after ${this.config.maxRetries} retries`);
+        return false;
+    }
+    async withLock(resourceId, holderId, operation, timeout) {
+        const acquired = await this.acquireLockWithRetry(resourceId, holderId, timeout);
+        if (!acquired) {
+            throw new LockAcquisitionError(resourceId);
+        }
+        try {
+            return await operation();
+        }
+        finally {
+            this.releaseLock(resourceId, holderId);
+        }
+    }
+    acquireSemaphore(name, maxConcurrent) {
+        const current = this.semaphores.get(name) ?? 0;
+        if (current >= maxConcurrent) {
+            return false;
+        }
+        this.semaphores.set(name, current + 1);
+        return true;
+    }
+    releaseSemaphore(name) {
+        const current = this.semaphores.get(name) ?? 0;
+        if (current > 0) {
+            this.semaphores.set(name, current - 1);
+        }
+    }
+    async acquireSemaphoreWithRetry(name, maxConcurrent) {
+        for (let i = 0; i < this.config.maxRetries; i++) {
+            if (this.acquireSemaphore(name, maxConcurrent)) {
+                return true;
+            }
+            await this.delay(this.backoffDelay(i));
+        }
+        return false;
+    }
+    canStartInstance() {
+        const current = this.semaphores.get("instances") ?? 0;
+        return current < this.config.maxConcurrentInstances;
+    }
+    registerInstanceStart() {
+        return this.acquireSemaphore("instances", this.config.maxConcurrentInstances);
+    }
+    registerInstanceComplete() {
+        this.releaseSemaphore("instances");
+    }
+    getConfig() {
+        return this.config;
+    }
+    getStats() {
+        return {
+            activeLocks: this.locks.size,
+            activeInstances: this.semaphores.get("instances") ?? 0,
+            semaphores: Object.fromEntries(this.semaphores),
+        };
+    }
+    cleanupExpiredLocks() {
+        const now = Date.now();
+        let cleaned = 0;
+        for (const [resourceId, lock] of this.locks) {
+            if (lock.expiresAt <= now) {
+                this.locks.delete(resourceId);
+                cleaned++;
+            }
+        }
+        if (cleaned > 0) {
+            Logger.debug("system", "lock", `Cleaned up ${cleaned} expired locks`);
+        }
+    }
+    backoffDelay(attempt) {
+        const base = this.config.retryDelay * 2 ** Math.min(attempt, 6);
+        const capped = Math.min(base, ConcurrencyControl.MAX_RETRY_DELAY_MS);
+        return Math.round(capped * (0.5 + Math.random() * 0.5));
+    }
+    static MAX_RETRY_DELAY_MS = 2000;
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    destroy() {
+        if (this.cleanupInterval) {
+            clearInterval(this.cleanupInterval);
+            this.cleanupInterval = undefined;
+        }
+        this.locks.clear();
+        this.semaphores.clear();
+    }
+}
+let concurrencyControlInstance = null;
+export function getConcurrencyControl() {
+    if (!concurrencyControlInstance) {
+        try {
+            const { resources } = getAppConfig();
+            concurrencyControlInstance = new ConcurrencyControl({
+                maxConcurrentInstances: resources.maxConcurrentInstances,
+                maxConcurrentNodesPerInstance: resources.maxConcurrentNodesPerInstance,
+                lockTimeout: resources.lockTimeoutMs,
+            });
+        }
+        catch {
+            concurrencyControlInstance = new ConcurrencyControl({
+                maxConcurrentInstances: parseEnvInt(process.env.MAX_CONCURRENT_INSTANCES, 100, { min: 1 }),
+                maxConcurrentNodesPerInstance: parseEnvInt(process.env.MAX_CONCURRENT_NODES, 10, { min: 1 }),
+                lockTimeout: parseEnvInt(process.env.LOCK_TIMEOUT_MS, 30000, {
+                    min: 1,
+                }),
+            });
+        }
+    }
+    return concurrencyControlInstance;
+}
+export function destroyConcurrencyControl() {
+    concurrencyControlInstance?.destroy();
+    concurrencyControlInstance = null;
+}
+export function setConcurrencyControl(control) {
+    concurrencyControlInstance = control;
+}
+//# sourceMappingURL=ConcurrencyControl.js.map

package/dist/src/engine/ConcurrencyControl.js.map

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

package/dist/src/engine/ContinueAsNewManager.d.ts

@@ -0,0 +1,18 @@
+export interface ContinueAsNewOptions {
+    workflowId?: string;
+    input?: Record<string, unknown>;
+    searchAttributes?: Record<string, unknown>;
+}
+export interface ContinueAsNewResult {
+    newInstanceId: string;
+    previousInstanceId: string;
+}
+export declare class ContinueAsNewManager {
+    private pendingContinuations;
+    prepareContinueAsNew(instanceId: string, options: ContinueAsNewOptions): ContinueAsNewResult;
+    hasPendingContinuation(instanceId: string): boolean;
+    getContinuation(instanceId: string): ContinueAsNewOptions | undefined;
+    clearContinuation(instanceId: string): void;
+    isActive(instanceId: string): boolean;
+}
+export declare const continueAsNewManager: ContinueAsNewManager;

package/dist/src/engine/ContinueAsNewManager.js

@@ -0,0 +1,29 @@
+import { Logger } from "../utils/Logger.js";
+export class ContinueAsNewManager {
+    pendingContinuations = new Map();
+    prepareContinueAsNew(instanceId, options) {
+        this.pendingContinuations.set(instanceId, options);
+        const newInstanceId = options.workflowId
+            ? `${options.workflowId}-${Date.now()}`
+            : `${instanceId}-continued-${Date.now()}`;
+        Logger.info("system", "continue-as-new", `ContinueAsNew prepared: ${instanceId} -> ${newInstanceId}`);
+        return {
+            newInstanceId,
+            previousInstanceId: instanceId,
+        };
+    }
+    hasPendingContinuation(instanceId) {
+        return this.pendingContinuations.has(instanceId);
+    }
+    getContinuation(instanceId) {
+        return this.pendingContinuations.get(instanceId);
+    }
+    clearContinuation(instanceId) {
+        this.pendingContinuations.delete(instanceId);
+    }
+    isActive(instanceId) {
+        return this.hasPendingContinuation(instanceId);
+    }
+}
+export const continueAsNewManager = new ContinueAsNewManager();
+//# sourceMappingURL=ContinueAsNewManager.js.map

package/dist/src/engine/ContinueAsNewManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContinueAsNewManager.js","sourceRoot":"","sources":["../../../src/engine/ContinueAsNewManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAazC,MAAM,OAAO,oBAAoB;IACvB,oBAAoB,GAAsC,IAAI,GAAG,EAAE,CAAC;IAE5E,oBAAoB,CAClB,UAAkB,EAClB,OAA6B;QAE7B,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAEnD,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU;YACtC,CAAC,CAAC,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YACvC,CAAC,CAAC,GAAG,UAAU,cAAc,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAE5C,MAAM,CAAC,IAAI,CACT,QAAQ,EACR,iBAAiB,EACjB,2BAA2B,UAAU,OAAO,aAAa,EAAE,CAC5D,CAAC;QAEF,OAAO;YACL,aAAa;YACb,kBAAkB,EAAE,UAAU;SAC/B,CAAC;IACJ,CAAC;IAED,sBAAsB,CAAC,UAAkB;QACvC,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,eAAe,CAAC,UAAkB;QAChC,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACnD,CAAC;IAED,iBAAiB,CAAC,UAAkB;QAClC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/C,CAAC;IAGD,QAAQ,CAAC,UAAkB;QACzB,OAAO,IAAI,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}

package/dist/src/engine/DataValidator.d.ts

@@ -0,0 +1,15 @@
+export interface DataValidationIssue {
+    path: string;
+    message: string;
+}
+export interface DataValidationResult {
+    valid: boolean;
+    issues: DataValidationIssue[];
+}
+export type ValidationMode = "strict" | "warn" | "off";
+export declare class DataValidationError extends Error {
+    readonly issues: DataValidationIssue[];
+    constructor(issues: DataValidationIssue[]);
+}
+export declare function getValidationMode(): ValidationMode;
+export declare function validateAgainstSchema(schema: Record<string, any>, data: unknown, basePath?: string): DataValidationResult;

package/dist/src/engine/DataValidator.js

@@ -0,0 +1,121 @@
+export class DataValidationError extends Error {
+    issues;
+    constructor(issues) {
+        super(`Data validation failed: ${issues
+            .map((i) => `${i.path} ${i.message}`)
+            .join("; ")}`);
+        this.issues = issues;
+        this.name = "DataValidationError";
+    }
+}
+export function getValidationMode() {
+    const mode = (process.env.SCHEMA_VALIDATION || "off").toLowerCase();
+    if (mode === "strict" || mode === "warn")
+        return mode;
+    return "off";
+}
+const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function typeOf(value) {
+    if (value === null)
+        return "null";
+    if (Array.isArray(value))
+        return "array";
+    return typeof value;
+}
+function validateValue(schema, value, path, issues) {
+    if (schema.type !== undefined) {
+        const actual = typeOf(value);
+        const expected = Array.isArray(schema.type)
+            ? schema.type
+            : [schema.type];
+        const matches = expected.some((t) => t === "integer"
+            ? actual === "number" && Number.isInteger(value)
+            : actual === t);
+        if (!matches) {
+            issues.push({
+                path,
+                message: `must be of type ${expected.join("|")}, got ${actual}`,
+            });
+            return;
+        }
+    }
+    if (Array.isArray(schema.enum) && !schema.enum.includes(value)) {
+        issues.push({
+            path,
+            message: `must be one of: ${schema.enum.map(String).join(", ")}`,
+        });
+    }
+    if (typeof value === "number") {
+        if (typeof schema.minimum === "number" && value < schema.minimum) {
+            issues.push({ path, message: `must be >= ${schema.minimum}` });
+        }
+        if (typeof schema.maximum === "number" && value > schema.maximum) {
+            issues.push({ path, message: `must be <= ${schema.maximum}` });
+        }
+    }
+    if (typeof value === "string") {
+        if (typeof schema.minLength === "number" &&
+            value.length < schema.minLength) {
+            issues.push({
+                path,
+                message: `length must be >= ${schema.minLength}`,
+            });
+        }
+        if (typeof schema.maxLength === "number" &&
+            value.length > schema.maxLength) {
+            issues.push({
+                path,
+                message: `length must be <= ${schema.maxLength}`,
+            });
+        }
+        if (typeof schema.pattern === "string") {
+            try {
+                if (!new RegExp(schema.pattern).test(value)) {
+                    issues.push({
+                        path,
+                        message: `must match pattern ${schema.pattern}`,
+                    });
+                }
+            }
+            catch {
+                issues.push({
+                    path,
+                    message: `schema has invalid pattern: ${schema.pattern}`,
+                });
+            }
+        }
+        if (schema.format === "email" && !EMAIL_PATTERN.test(value)) {
+            issues.push({ path, message: "must be a valid email address" });
+        }
+    }
+    if (Array.isArray(value) &&
+        schema.items &&
+        typeof schema.items === "object") {
+        value.forEach((item, index) => {
+            validateValue(schema.items, item, `${path}/${index}`, issues);
+        });
+    }
+    if (typeOf(value) === "object" &&
+        (schema.properties || Array.isArray(schema.required))) {
+        const obj = value;
+        const base = path === "/" ? "" : path;
+        for (const field of schema.required ?? []) {
+            if (obj[field] === undefined) {
+                issues.push({ path: `${base}/${field}`, message: "is required" });
+            }
+        }
+        if (schema.properties && typeof schema.properties === "object") {
+            for (const [field, fieldSchema] of Object.entries(schema.properties)) {
+                if (obj[field] !== undefined) {
+                    validateValue(fieldSchema, obj[field], `${base}/${field}`, issues);
+                }
+            }
+        }
+    }
+}
+export function validateAgainstSchema(schema, data, basePath = "/") {
+    const issues = [];
+    validateValue(schema, data, basePath, issues);
+    return { valid: issues.length === 0, issues };
+}
+//# sourceMappingURL=DataValidator.js.map

package/dist/src/engine/DataValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataValidator.js","sourceRoot":"","sources":["../../../src/engine/DataValidator.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAChB;IAA5B,YAA4B,MAA6B;QACvD,KAAK,CACH,2BAA2B,MAAM;aAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;aACpC,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;QALwB,WAAM,GAAN,MAAM,CAAuB;QAMvD,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;IACpE,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAEnD,SAAS,MAAM,CAAC,KAAc;IAC5B,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACzC,OAAO,OAAO,KAAK,CAAC;AACtB,CAAC;AAED,SAAS,aAAa,CACpB,MAA2B,EAC3B,KAAc,EACd,IAAY,EACZ,MAA6B;IAG7B,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAa,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC;YACnD,CAAC,CAAC,MAAM,CAAC,IAAI;YACb,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAClC,CAAC,KAAK,SAAS;YACb,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;YAChD,CAAC,CAAC,MAAM,KAAK,CAAC,CACjB,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,mBAAmB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,MAAM,EAAE;aAChE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;IACH,CAAC;IAGD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,OAAO,EAAE,mBAAmB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACjE,CAAC,CAAC;IACL,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YACjE,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IACE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAC/B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,qBAAqB,MAAM,CAAC,SAAS,EAAE;aACjD,CAAC,CAAC;QACL,CAAC;QACD,IACE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAC/B,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,IAAI;gBACJ,OAAO,EAAE,qBAAqB,MAAM,CAAC,SAAS,EAAE;aACjD,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvC,IAAI,CAAC;gBACH,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC5C,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI;wBACJ,OAAO,EAAE,sBAAsB,MAAM,CAAC,OAAO,EAAE;qBAChD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,OAAO,EAAE,+BAA+B,MAAM,CAAC,OAAO,EAAE;iBACzD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,IACE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,MAAM,CAAC,KAAK;QACZ,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,EAChC,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC5B,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IACE,MAAM,CAAC,KAAK,CAAC,KAAK,QAAQ;QAC1B,CAAC,MAAM,CAAC,UAAU,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EACrD,CAAC;QACD,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtC,KAAK,MAAM,KAAK,IAAK,MAAM,CAAC,QAAqB,IAAI,EAAE,EAAE,CAAC;YACxD,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC;YACpE,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC/D,KAAK,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAC/C,MAAM,CAAC,UAAiD,CACzD,EAAE,CAAC;gBACF,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;oBAC7B,aAAa,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,IAAI,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAKD,MAAM,UAAU,qBAAqB,CACnC,MAA2B,EAC3B,IAAa,EACb,QAAQ,GAAG,GAAG;IAEd,MAAM,MAAM,GAA0B,EAAE,CAAC;IACzC,aAAa,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/src/engine/DryRunExecutor.d.ts

@@ -0,0 +1,48 @@
+import type { WorkflowDefinition } from "../model/Workflow.js";
+export interface DryRunOptions {
+    context: Record<string, unknown>;
+    mockResponses?: Record<string, unknown>;
+    skipNodes?: string[];
+    stopAfterNode?: string;
+    recordExpressions?: boolean;
+}
+export interface DryRunNodeResult {
+    nodeId: string;
+    input?: unknown;
+    output?: unknown;
+    duration: number;
+    mocked: boolean;
+    skipped: boolean;
+}
+export interface ExpressionTraceEntry {
+    expression: string;
+    result: unknown;
+    context: Record<string, unknown>;
+    duration: number;
+}
+export interface DryRunResult {
+    success: boolean;
+    valid: boolean;
+    executionPath: string[];
+    nodeResults: Record<string, DryRunNodeResult>;
+    expressionTrace: ExpressionTraceEntry[];
+    warnings: string[];
+    totalDuration: number;
+    duration: number;
+    simulatedOutputs: Record<string, unknown>;
+    errors: Array<{
+        nodeId: string;
+        error: string;
+    }>;
+}
+export declare class DryRunExecutor {
+    private resolveWorkflow?;
+    constructor(resolveWorkflow?: ((workflowId: string) => WorkflowDefinition | undefined | Promise<WorkflowDefinition | undefined>) | undefined);
+    execute(workflow: WorkflowDefinition, options: DryRunOptions): Promise<DryRunResult>;
+    private walk;
+    private resolveNextNodes;
+    private simulateNode;
+    private buildExpressionContext;
+    private buildSubworkflowContext;
+    private getNestedValue;
+}