ts-workflow-engine-lite 2.1.0

package/dist/src/dsl/DSLParser.js

@@ -0,0 +1,252 @@
+const WORKFLOW_KEYS = new Set([
+    "id",
+    "name",
+    "version",
+    "description",
+    "startNode",
+    "cron",
+    "triggerEvents",
+]);
+const NODE_KEYS = new Set([
+    "type",
+    "config",
+    "next",
+    "failureNext",
+    "conditionalNext",
+    "defaultNext",
+    "retryPolicy",
+    "maxRetries",
+]);
+export class DSLParseError extends Error {
+    line;
+    column;
+    constructor(message, line, column) {
+        super(`${message} at ${line}:${column}`);
+        this.name = "DSLParseError";
+        this.line = line;
+        this.column = column;
+    }
+}
+export function parseDSL(input) {
+    const parsedLines = parseLines(input);
+    const workflow = {
+        nodes: [],
+    };
+    let currentNode;
+    for (const line of parsedLines) {
+        if (line.indent === 0) {
+            if (WORKFLOW_KEYS.has(line.key)) {
+                applyWorkflowProperty(workflow, line);
+                currentNode = undefined;
+                continue;
+            }
+            if (line.value.length > 0) {
+                throw new DSLParseError(`Unknown top-level property or invalid node declaration '${line.key}'`, line.lineNumber, 1);
+            }
+            currentNode = { id: line.key };
+            workflow.nodes?.push(currentNode);
+            continue;
+        }
+        if (line.indent !== 2) {
+            throw new DSLParseError("Only two-space indentation is supported for node properties", line.lineNumber, line.indent + 1);
+        }
+        if (!currentNode) {
+            throw new DSLParseError(`Node property '${line.key}' must follow a node declaration`, line.lineNumber, line.indent + 1);
+        }
+        applyNodeProperty(currentNode, line);
+    }
+    return convertToWorkflowDefinition(validateWorkflow(workflow));
+}
+function parseLines(input) {
+    return input
+        .split("\n")
+        .map((rawLine, index) => ({ rawLine, lineNumber: index + 1 }))
+        .filter(({ rawLine }) => {
+        const trimmed = rawLine.trim();
+        return trimmed.length > 0 && !trimmed.startsWith("#");
+    })
+        .map(({ rawLine, lineNumber }) => {
+        const indent = rawLine.search(/\S/);
+        const trimmed = rawLine.trim();
+        const separatorIndex = trimmed.indexOf(":");
+        if (separatorIndex < 0) {
+            throw new DSLParseError("Expected key-value pair separated by ':'", lineNumber, indent + 1);
+        }
+        return {
+            lineNumber,
+            indent,
+            key: trimmed.slice(0, separatorIndex).trim(),
+            value: trimmed.slice(separatorIndex + 1).trim(),
+        };
+    });
+}
+function applyWorkflowProperty(workflow, line) {
+    switch (line.key) {
+        case "id":
+            workflow.id = parseScalar(line.value);
+            break;
+        case "name":
+            workflow.name = parseScalar(line.value);
+            break;
+        case "version":
+            workflow.version = parseScalar(line.value);
+            break;
+        case "description":
+            workflow.description = parseScalar(line.value);
+            break;
+        case "startNode":
+            workflow.startNode = parseScalar(line.value);
+            break;
+        case "cron":
+            workflow.cron = parseScalar(line.value);
+            break;
+        case "triggerEvents":
+            workflow.triggerEvents = parseStringArray(line.value, line);
+            break;
+        default:
+            throw new DSLParseError(`Unsupported workflow property '${line.key}'`, line.lineNumber, line.indent + 1);
+    }
+}
+function applyNodeProperty(node, line) {
+    if (!NODE_KEYS.has(line.key)) {
+        throw new DSLParseError(`Unsupported node property '${line.key}'`, line.lineNumber, line.indent + 1);
+    }
+    switch (line.key) {
+        case "type":
+            node.type = parseScalar(line.value);
+            break;
+        case "config":
+            node.config = parseJsonObject(line.value, line);
+            break;
+        case "next":
+            node.next = parseStringArray(line.value, line);
+            break;
+        case "failureNext":
+            node.failureNext = parseStringArray(line.value, line);
+            break;
+        case "conditionalNext":
+            node.conditionalNext = parseJsonArray(line.value, line);
+            break;
+        case "defaultNext":
+            node.defaultNext = parseScalar(line.value);
+            break;
+        case "retryPolicy":
+            node.retryPolicy = parseJsonObject(line.value, line);
+            break;
+        case "maxRetries":
+            node.retryPolicy = {
+                ...node.retryPolicy,
+                maxRetries: parseNumber(line.value, line),
+            };
+            break;
+    }
+}
+function validateWorkflow(workflow) {
+    if (!workflow.id) {
+        throw new DSLParseError("Workflow id is required", 1, 1);
+    }
+    if (!workflow.name) {
+        throw new DSLParseError("Workflow name is required", 1, 1);
+    }
+    if (!workflow.startNode) {
+        throw new DSLParseError("Workflow startNode is required", 1, 1);
+    }
+    if (!workflow.nodes || workflow.nodes.length === 0) {
+        throw new DSLParseError("Workflow must define at least one node", 1, 1);
+    }
+    const nodeIds = new Set();
+    for (const node of workflow.nodes) {
+        if (!node.id) {
+            throw new DSLParseError("Node id is required", 1, 1);
+        }
+        if (!node.type) {
+            throw new DSLParseError(`Node '${node.id}' type is required`, 1, 1);
+        }
+        if (nodeIds.has(node.id)) {
+            throw new DSLParseError(`Duplicate node id '${node.id}'`, 1, 1);
+        }
+        nodeIds.add(node.id);
+    }
+    if (!nodeIds.has(workflow.startNode)) {
+        throw new DSLParseError(`startNode '${workflow.startNode}' does not match any node`, 1, 1);
+    }
+    return workflow;
+}
+function convertToWorkflowDefinition(dsl) {
+    const nodes = {};
+    for (const node of dsl.nodes) {
+        nodes[node.id] = {
+            id: node.id,
+            type: node.type,
+            config: node.config,
+            next: node.next,
+            failureNext: node.failureNext,
+            conditionalNext: node.conditionalNext,
+            defaultNext: node.defaultNext,
+            retryPolicy: mapRetryPolicy(node.retryPolicy),
+            maxRetries: node.retryPolicy?.maxRetries,
+        };
+    }
+    return {
+        id: dsl.id,
+        name: dsl.name,
+        version: dsl.version,
+        description: dsl.description,
+        startNode: dsl.startNode,
+        nodes,
+        cron: dsl.cron,
+        triggerEvents: dsl.triggerEvents,
+    };
+}
+function parseScalar(value) {
+    return value.replace(/^["']|["']$/g, "");
+}
+function parseStringArray(value, line) {
+    if (value.startsWith("[") && value.endsWith("]")) {
+        return parseJsonArray(value, line);
+    }
+    return [parseScalar(value)];
+}
+function parseJsonObject(value, line) {
+    const parsed = parseJson(value, line);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new DSLParseError(`Expected object value for '${line.key}'`, line.lineNumber, line.indent + 1);
+    }
+    return parsed;
+}
+function parseJsonArray(value, line) {
+    const parsed = parseJson(value, line);
+    if (!Array.isArray(parsed)) {
+        throw new DSLParseError(`Expected array value for '${line.key}'`, line.lineNumber, line.indent + 1);
+    }
+    return parsed;
+}
+function parseJson(value, line) {
+    try {
+        return JSON.parse(value);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new DSLParseError(`Invalid JSON value for '${line.key}': ${message}`, line.lineNumber, line.indent + 1);
+    }
+}
+function parseNumber(value, line) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new DSLParseError(`Expected numeric value for '${line.key}'`, line.lineNumber, line.indent + 1);
+    }
+    return parsed;
+}
+function mapRetryPolicy(retryPolicy) {
+    if (!retryPolicy) {
+        return undefined;
+    }
+    return {
+        maximumAttempts: retryPolicy.maximumAttempts ?? retryPolicy.maxRetries,
+        initialInterval: retryPolicy.initialInterval ?? retryPolicy.backoffMs,
+        backoffCoefficient: retryPolicy.backoffCoefficient ?? retryPolicy.backoffMultiplier,
+        maximumInterval: retryPolicy.maximumInterval,
+        nonRetryableErrors: retryPolicy.nonRetryableErrors,
+    };
+}
+//# sourceMappingURL=DSLParser.js.map

package/dist/src/dsl/DSLParser.js.map

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

package/dist/src/dsl/WorkflowDSL.d.ts

@@ -0,0 +1,40 @@
+export interface DSLWorkflow {
+    id: string;
+    name: string;
+    version?: string;
+    description?: string;
+    nodes: DSLNode[];
+    startNode: string;
+    triggers?: DSLTrigger[];
+}
+export interface DSLNode {
+    id: string;
+    type: string;
+    config?: Record<string, unknown>;
+    next?: string[];
+    failureNext?: string[];
+    conditionalNext?: DSLConditionalBranch[];
+    defaultNext?: string;
+    retryPolicy?: DSLRetryPolicy;
+}
+export interface DSLConditionalBranch {
+    condition: string;
+    target: string;
+}
+export interface DSLRetryPolicy {
+    maxRetries?: number;
+    backoffMs?: number;
+    backoffMultiplier?: number;
+    maximumAttempts?: number;
+    initialInterval?: number;
+    backoffCoefficient?: number;
+    maximumInterval?: number;
+    nonRetryableErrors?: string[];
+}
+export interface DSLTrigger {
+    type: "event" | "cron" | "signal";
+    config: Record<string, unknown>;
+}
+export type DSLValue = string | number | boolean | null | DSLValue[] | {
+    [key: string]: DSLValue;
+};

package/dist/src/dsl/WorkflowDSL.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=WorkflowDSL.js.map

package/dist/src/dsl/WorkflowDSL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowDSL.js","sourceRoot":"","sources":["../../../src/dsl/WorkflowDSL.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,39 @@
+import type { CanaryMetrics, PromotionRules, StorageProvider } from "../storage/StorageProvider.js";
+export interface CanaryStatus {
+    publishedVersion: number;
+    canaryVersion?: number;
+    canaryPercent?: number;
+    canaryStartedAt?: number;
+    canaryMetrics?: CanaryMetrics;
+}
+export interface PromotionEvaluation {
+    shouldPromote: boolean;
+    reason: string;
+}
+export declare class CanaryReleaseManager {
+    private storage;
+    private engine?;
+    private evaluationTimer?;
+    constructor(storage: StorageProvider, engine?: {
+        setActiveWorkflowVersion?: (workflowId: string, version: string) => void;
+        setReleasePolicy?: (workflowId: string, policy: {
+            type: "stable";
+        } | {
+            type: "canary";
+            baselineVersion: string;
+            canaryVersion: string;
+            canaryPercent: number;
+        }) => void;
+    } | undefined);
+    startCanaryRelease(workflowId: string, version: number, percent: number, rules?: PromotionRules): Promise<void>;
+    promoteCanary(workflowId: string): Promise<void>;
+    rollbackCanary(workflowId: string): Promise<void>;
+    getCanaryStatus(workflowId: string): Promise<CanaryStatus>;
+    evaluatePromotion(workflowId: string): Promise<PromotionEvaluation>;
+    startEvaluationLoop(intervalMs?: number): void;
+    stopEvaluationLoop(): void;
+    private evaluateActiveCanaries;
+    private requireWorkflow;
+    private collectMetrics;
+    private loadInstancesForWorkflow;
+}

package/dist/src/engine/CanaryReleaseManager.js

@@ -0,0 +1,192 @@
+import { parseEnvInt } from "../utils/env.js";
+import { Logger } from "../utils/Logger.js";
+const DEFAULT_RULES = {
+    minInstances: 100,
+    maxErrorRate: 0.05,
+    evaluationWindowMs: 60 * 60 * 1000,
+};
+export class CanaryReleaseManager {
+    storage;
+    engine;
+    evaluationTimer;
+    constructor(storage, engine) {
+        this.storage = storage;
+        this.engine = engine;
+    }
+    async startCanaryRelease(workflowId, version, percent, rules) {
+        const workflow = await this.requireWorkflow(workflowId);
+        const publishedVersion = workflow.publishedVersion ?? workflow.version;
+        const updated = {
+            ...workflow,
+            canaryVersion: version,
+            canaryPercent: percent,
+            canaryStartedAt: Date.now(),
+            promotionRules: {
+                autoPromote: rules?.autoPromote ?? false,
+                minInstances: rules?.minInstances ?? DEFAULT_RULES.minInstances,
+                maxErrorRate: rules?.maxErrorRate ?? DEFAULT_RULES.maxErrorRate,
+                evaluationWindowMs: rules?.evaluationWindowMs ?? DEFAULT_RULES.evaluationWindowMs,
+            },
+            releasePolicy: {
+                type: "canary",
+                baselineVersion: publishedVersion,
+                canaryVersion: version,
+                canaryPercent: percent,
+            },
+            updatedAt: Date.now(),
+        };
+        await this.storage.saveWorkflowWithMetadata(updated);
+        this.engine?.setReleasePolicy?.(workflowId, {
+            type: "canary",
+            baselineVersion: String(publishedVersion),
+            canaryVersion: String(version),
+            canaryPercent: percent,
+        });
+    }
+    async promoteCanary(workflowId) {
+        const workflow = await this.requireWorkflow(workflowId);
+        if (!workflow.canaryVersion) {
+            throw new Error(`Workflow ${workflowId} has no active canary release`);
+        }
+        const updated = {
+            ...workflow,
+            publishedVersion: workflow.canaryVersion,
+            releasePolicy: { type: "stable" },
+            canaryVersion: undefined,
+            canaryPercent: undefined,
+            canaryStartedAt: undefined,
+            promotionRules: undefined,
+            updatedAt: Date.now(),
+        };
+        await this.storage.saveWorkflowWithMetadata(updated);
+        this.engine?.setActiveWorkflowVersion?.(workflowId, String(updated.publishedVersion));
+        this.engine?.setReleasePolicy?.(workflowId, { type: "stable" });
+    }
+    async rollbackCanary(workflowId) {
+        const workflow = await this.requireWorkflow(workflowId);
+        const updated = {
+            ...workflow,
+            releasePolicy: { type: "stable" },
+            canaryVersion: undefined,
+            canaryPercent: undefined,
+            canaryStartedAt: undefined,
+            promotionRules: undefined,
+            updatedAt: Date.now(),
+        };
+        await this.storage.saveWorkflowWithMetadata(updated);
+        if (updated.publishedVersion !== undefined) {
+            this.engine?.setActiveWorkflowVersion?.(workflowId, String(updated.publishedVersion));
+        }
+        this.engine?.setReleasePolicy?.(workflowId, { type: "stable" });
+    }
+    async getCanaryStatus(workflowId) {
+        const workflow = await this.requireWorkflow(workflowId);
+        return {
+            publishedVersion: workflow.publishedVersion ?? workflow.version,
+            canaryVersion: workflow.canaryVersion,
+            canaryPercent: workflow.canaryPercent,
+            canaryStartedAt: workflow.canaryStartedAt,
+            canaryMetrics: workflow.canaryVersion
+                ? await this.collectMetrics(workflowId, workflow)
+                : undefined,
+        };
+    }
+    async evaluatePromotion(workflowId) {
+        const workflow = await this.requireWorkflow(workflowId);
+        if (!workflow.canaryVersion || !workflow.canaryStartedAt) {
+            return { shouldPromote: false, reason: "No active canary release" };
+        }
+        const rules = {
+            autoPromote: workflow.promotionRules?.autoPromote ?? false,
+            minInstances: workflow.promotionRules?.minInstances ?? DEFAULT_RULES.minInstances,
+            maxErrorRate: workflow.promotionRules?.maxErrorRate ?? DEFAULT_RULES.maxErrorRate,
+            evaluationWindowMs: workflow.promotionRules?.evaluationWindowMs ??
+                DEFAULT_RULES.evaluationWindowMs,
+        };
+        const metrics = await this.collectMetrics(workflowId, workflow);
+        const elapsed = Date.now() - workflow.canaryStartedAt;
+        if (metrics.totalInstances < rules.minInstances) {
+            if (elapsed > rules.evaluationWindowMs) {
+                if (rules.autoPromote) {
+                    await this.rollbackCanary(workflowId);
+                }
+                return { shouldPromote: false, reason: "Evaluation window expired" };
+            }
+            return { shouldPromote: false, reason: "Not enough canary instances" };
+        }
+        if (metrics.errorRate > rules.maxErrorRate) {
+            if (rules.autoPromote) {
+                await this.rollbackCanary(workflowId);
+            }
+            return { shouldPromote: false, reason: "Error rate too high" };
+        }
+        if (elapsed < rules.evaluationWindowMs) {
+            return { shouldPromote: false, reason: "Evaluation window not reached" };
+        }
+        if (rules.autoPromote) {
+            await this.promoteCanary(workflowId);
+        }
+        return { shouldPromote: true, reason: "Canary metrics satisfied" };
+    }
+    startEvaluationLoop(intervalMs = parseEnvInt(process.env.CANARY_EVAL_INTERVAL_MS, 60000, {
+        min: 1000,
+    })) {
+        if (this.evaluationTimer)
+            return;
+        this.evaluationTimer = setInterval(() => {
+            void this.evaluateActiveCanaries();
+        }, intervalMs);
+    }
+    stopEvaluationLoop() {
+        if (this.evaluationTimer) {
+            clearInterval(this.evaluationTimer);
+            this.evaluationTimer = undefined;
+        }
+    }
+    async evaluateActiveCanaries() {
+        const workflows = await this.storage.listWorkflowsWithMetadata();
+        for (const workflow of workflows) {
+            if (!workflow.canaryVersion)
+                continue;
+            try {
+                await this.evaluatePromotion(workflow.id);
+            }
+            catch (error) {
+                Logger.error("system", "canary", `Failed to evaluate canary for ${workflow.id}`, error instanceof Error ? error.stack : String(error));
+            }
+        }
+    }
+    async requireWorkflow(workflowId) {
+        const workflow = await this.storage.loadWorkflowWithMetadata(workflowId);
+        if (!workflow) {
+            throw new Error(`Workflow ${workflowId} not found`);
+        }
+        return workflow;
+    }
+    async collectMetrics(workflowId, workflow) {
+        const startedAt = workflow.canaryStartedAt ?? 0;
+        const instances = await this.loadInstancesForWorkflow(workflowId);
+        const canaryInstances = instances.filter((instance) => instance.workflowVersion === String(workflow.canaryVersion) &&
+            instance.createdAt.getTime() >= startedAt);
+        const failures = canaryInstances.filter((instance) => instance.status === "failed").length;
+        const totalDurationMs = canaryInstances.reduce((sum, instance) => {
+            return (sum + (instance.updatedAt.getTime() - instance.createdAt.getTime()));
+        }, 0);
+        return {
+            totalInstances: canaryInstances.length,
+            errorRate: canaryInstances.length === 0 ? 0 : failures / canaryInstances.length,
+            avgDurationMs: canaryInstances.length === 0
+                ? 0
+                : totalDurationMs / canaryInstances.length,
+        };
+    }
+    async loadInstancesForWorkflow(workflowId) {
+        const result = await this.storage.queryInstances({
+            workflowId,
+            page: 1,
+            pageSize: 10000,
+        });
+        return result.instances;
+    }
+}
+//# sourceMappingURL=CanaryReleaseManager.js.map

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

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

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

@@ -0,0 +1,38 @@
+export interface ConcurrencyConfig {
+    maxConcurrentInstances?: number;
+    maxConcurrentNodesPerInstance?: number;
+    lockTimeout?: number;
+    retryDelay?: number;
+    maxRetries?: number;
+}
+export declare class ConcurrencyControl {
+    private locks;
+    private semaphores;
+    private config;
+    private cleanupInterval?;
+    constructor(config?: ConcurrencyConfig);
+    acquireLock(resourceId: string, holderId: string, timeout?: number): Promise<boolean>;
+    releaseLock(resourceId: string, holderId: string): boolean;
+    acquireLockWithRetry(resourceId: string, holderId: string, timeout?: number): Promise<boolean>;
+    withLock<T>(resourceId: string, holderId: string, operation: () => Promise<T>, timeout?: number): Promise<T>;
+    acquireSemaphore(name: string, maxConcurrent: number): boolean;
+    releaseSemaphore(name: string): void;
+    acquireSemaphoreWithRetry(name: string, maxConcurrent: number): Promise<boolean>;
+    canStartInstance(): boolean;
+    registerInstanceStart(): boolean;
+    registerInstanceComplete(): void;
+    getConfig(): Readonly<Required<ConcurrencyConfig>>;
+    getStats(): {
+        activeLocks: number;
+        activeInstances: number;
+        semaphores: Record<string, number>;
+    };
+    private cleanupExpiredLocks;
+    private backoffDelay;
+    private static readonly MAX_RETRY_DELAY_MS;
+    private delay;
+    destroy(): void;
+}
+export declare function getConcurrencyControl(): ConcurrencyControl;
+export declare function destroyConcurrencyControl(): void;
+export declare function setConcurrencyControl(control: ConcurrencyControl): void;