ts-workflow-engine-lite 2.1.0

package/dist/src/testing/MutationTester.js.map

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

package/dist/src/testing/TestGenerator.d.ts

@@ -0,0 +1,31 @@
+import type { WorkflowDefinition } from "../model/Workflow.js";
+export interface GeneratedTest {
+    workflowId: string;
+    testType: "happy-path" | "error-path" | "boundary" | "concurrent" | "rollback";
+    description: string;
+    input: Record<string, any>;
+    expectedBehavior: TestAssertion[];
+    code: string;
+}
+export interface TestAssertion {
+    type: "status" | "output" | "error" | "execution_order" | "duration";
+    target: string;
+    expected: any;
+    operator: "equals" | "contains" | "greaterThan" | "lessThan" | "exists";
+}
+export declare class TestGenerator {
+    generateFromWorkflow(workflow: WorkflowDefinition): Promise<GeneratedTest[]>;
+    private generateHappyPathTests;
+    private generateErrorPathTests;
+    private generateBoundaryTests;
+    private generateConcurrencyTests;
+    private traceExecutionPath;
+    private generateSampleInput;
+    private generateFailureInput;
+    private generateHappyPathTestCode;
+    private generateErrorPathTestCode;
+    private generateBoundaryTestCode;
+    private generateConcurrencyTestCode;
+    generateFromFailure(instance: any): Promise<GeneratedTest>;
+    generateMutationTests(workflow: WorkflowDefinition): Promise<GeneratedTest[]>;
+}

package/dist/src/testing/TestGenerator.js

@@ -0,0 +1,345 @@
+import { Logger } from "../utils/Logger.js";
+export class TestGenerator {
+    async generateFromWorkflow(workflow) {
+        const tests = [];
+        tests.push(...this.generateHappyPathTests(workflow));
+        tests.push(...this.generateErrorPathTests(workflow));
+        tests.push(...this.generateBoundaryTests(workflow));
+        tests.push(...this.generateConcurrencyTests(workflow));
+        Logger.info("system", "test-generator", "Generated test cases", {
+            workflowId: workflow.id,
+            totalTests: tests.length,
+            happyPath: tests.filter((t) => t.testType === "happy-path").length,
+            errorPath: tests.filter((t) => t.testType === "error-path").length,
+            boundary: tests.filter((t) => t.testType === "boundary").length,
+            concurrent: tests.filter((t) => t.testType === "concurrent").length,
+        });
+        return tests;
+    }
+    generateHappyPathTests(workflow) {
+        const tests = [];
+        const executionPath = this.traceExecutionPath(workflow);
+        tests.push({
+            workflowId: workflow.id,
+            testType: "happy-path",
+            description: `Execute workflow '${workflow.name}' through the happy path`,
+            input: this.generateSampleInput(workflow),
+            expectedBehavior: [
+                {
+                    type: "status",
+                    target: "instance",
+                    expected: "completed",
+                    operator: "equals",
+                },
+                {
+                    type: "execution_order",
+                    target: "nodes",
+                    expected: executionPath,
+                    operator: "equals",
+                },
+            ],
+            code: this.generateHappyPathTestCode(workflow, executionPath),
+        });
+        return tests;
+    }
+    generateErrorPathTests(workflow) {
+        const tests = [];
+        for (const [nodeId, node] of Object.entries(workflow.nodes)) {
+            if (node.type === "wait" || node.type === "condition")
+                continue;
+            tests.push({
+                workflowId: workflow.id,
+                testType: "error-path",
+                description: `Test error handling when node '${nodeId}' fails`,
+                input: this.generateFailureInput(node),
+                expectedBehavior: [
+                    {
+                        type: "status",
+                        target: `nodes.${nodeId}`,
+                        expected: "failed",
+                        operator: "equals",
+                    },
+                    {
+                        type: "error",
+                        target: `nodes.${nodeId}`,
+                        expected: true,
+                        operator: "exists",
+                    },
+                ],
+                code: this.generateErrorPathTestCode(workflow, nodeId, node),
+            });
+        }
+        return tests;
+    }
+    generateBoundaryTests(workflow) {
+        const tests = [];
+        for (const [nodeId, node] of Object.entries(workflow.nodes)) {
+            if (node.type !== "condition" || !node.config?.condition)
+                continue;
+            const condition = node.config.condition;
+            tests.push({
+                workflowId: workflow.id,
+                testType: "boundary",
+                description: `Test condition node '${nodeId}' boundary values`,
+                input: { conditionValue: 0 },
+                expectedBehavior: [
+                    {
+                        type: "output",
+                        target: `nodes.${nodeId}`,
+                        expected: { result: false },
+                        operator: "contains",
+                    },
+                ],
+                code: this.generateBoundaryTestCode(workflow, nodeId, condition),
+            });
+        }
+        return tests;
+    }
+    generateConcurrencyTests(workflow) {
+        const tests = [];
+        for (const [nodeId, node] of Object.entries(workflow.nodes)) {
+            if (node.next && node.next.length > 1) {
+                tests.push({
+                    workflowId: workflow.id,
+                    testType: "concurrent",
+                    description: `Test parallel execution from node '${nodeId}' to ${node.next.join(", ")}`,
+                    input: this.generateSampleInput(workflow),
+                    expectedBehavior: node.next.map((nextNode) => ({
+                        type: "status",
+                        target: `nodes.${nextNode}`,
+                        expected: "completed",
+                        operator: "equals",
+                    })),
+                    code: this.generateConcurrencyTestCode(workflow, nodeId, node.next),
+                });
+            }
+        }
+        return tests;
+    }
+    traceExecutionPath(workflow) {
+        const path = [];
+        let currentNode = workflow.startNode;
+        const visited = new Set();
+        while (currentNode && !visited.has(currentNode)) {
+            visited.add(currentNode);
+            path.push(currentNode);
+            const node = workflow.nodes[currentNode];
+            if (!node)
+                break;
+            if (node.next && node.next.length > 0) {
+                currentNode = node.next[0];
+            }
+            else if (node.conditionalNext && node.conditionalNext.length > 0) {
+                currentNode = node.conditionalNext[0].target;
+            }
+            else {
+                break;
+            }
+        }
+        return path;
+    }
+    generateSampleInput(workflow) {
+        return {
+            sampleInput: true,
+            workflowId: workflow.id,
+            timestamp: Date.now(),
+        };
+    }
+    generateFailureInput(node) {
+        switch (node.type) {
+            case "http":
+                return { url: "http://invalid-host-that-does-not-exist.local" };
+            case "sql":
+                return { query: "INVALID SQL QUERY" };
+            default:
+                return { invalidInput: true };
+        }
+    }
+    generateHappyPathTestCode(workflow, executionPath) {
+        return `import { describe, it, expect, beforeEach } from "vitest";
+import { bootstrap } from "../bootstrap.js";
+
+describe("Workflow: ${workflow.name}", () => {
+  let engine: any;
+
+  beforeEach(async () => {
+    const ctx = await bootstrap({ skipValidation: true, skipGracefulShutdown: true });
+    engine = ctx.engine;
+  });
+
+  it("should complete the happy path successfully", async () => {
+    const input = ${JSON.stringify(this.generateSampleInput(workflow), null, 2)};
+    const result = await engine.start("${workflow.id}", input);
+
+    expect(result).toBeDefined();
+    expect(result.status).toBe("completed");
+
+    // Verify execution order
+    const executedNodes = result.history.map((h: any) => h.nodeId);
+    ${executionPath.map((node, i) => `expect(executedNodes[${i}]).toBe("${node}");`).join("\n    ")}
+  });
+});`;
+    }
+    generateErrorPathTestCode(workflow, nodeId, node) {
+        return `import { describe, it, expect, beforeEach } from "vitest";
+import { bootstrap } from "../bootstrap.js";
+
+describe("Workflow: ${workflow.name} - Error Path", () => {
+  let engine: any;
+
+  beforeEach(async () => {
+    const ctx = await bootstrap({ skipValidation: true, skipGracefulShutdown: true });
+    engine = ctx.engine;
+  });
+
+  it("should handle failure in node '${nodeId}' (${node.type})", async () => {
+    const input = ${JSON.stringify(this.generateFailureInput(node), null, 2)};
+
+    try {
+      const result = await engine.start("${workflow.id}", input);
+      // If the workflow has error handling, it should complete with error state
+      if (result.status === "failed") {
+        expect(result.error).toBeDefined();
+      }
+    } catch (error) {
+      // Error was thrown - this is expected for nodes without error handling
+      expect(error).toBeDefined();
+    }
+  });
+});`;
+    }
+    generateBoundaryTestCode(workflow, _nodeId, condition) {
+        return `import { describe, it, expect, beforeEach } from "vitest";
+import { bootstrap } from "../bootstrap.js";
+
+describe("Workflow: ${workflow.name} - Boundary Conditions", () => {
+  let engine: any;
+
+  beforeEach(async () => {
+    const ctx = await bootstrap({ skipValidation: true, skipGracefulShutdown: true });
+    engine = ctx.engine;
+  });
+
+  it("should evaluate condition '${condition}' correctly at boundary", async () => {
+    // Test with value that makes condition false
+    const input = { conditionValue: 0 };
+    const result = await engine.start("${workflow.id}", input);
+    expect(result).toBeDefined();
+
+    // Test with value that makes condition true
+    const inputTrue = { conditionValue: 100 };
+    const resultTrue = await engine.start("${workflow.id}", inputTrue);
+    expect(resultTrue).toBeDefined();
+  });
+});`;
+    }
+    generateConcurrencyTestCode(workflow, _nodeId, parallelNodes) {
+        return `import { describe, it, expect, beforeEach } from "vitest";
+import { bootstrap } from "../bootstrap.js";
+
+describe("Workflow: ${workflow.name} - Concurrency", () => {
+  let engine: any;
+
+  beforeEach(async () => {
+    const ctx = await bootstrap({ skipValidation: true, skipGracefulShutdown: true });
+    engine = ctx.engine;
+  });
+
+  it("should execute parallel nodes ${parallelNodes.join(", ")} concurrently", async () => {
+    const input = ${JSON.stringify(this.generateSampleInput(workflow), null, 2)};
+    const result = await engine.start("${workflow.id}", input);
+
+    expect(result).toBeDefined();
+
+    // Verify all parallel branches completed
+    ${parallelNodes.map((node) => `expect(result.nodes?.["${node}"]?.status).toBe("completed");`).join("\n    ")}
+  });
+});`;
+    }
+    async generateFromFailure(instance) {
+        const failedNode = instance.history?.find((h) => h.status === "failed");
+        return {
+            workflowId: instance.workflowId,
+            testType: "error-path",
+            description: `Regression test for failed instance ${instance.instanceId}`,
+            input: instance.context || {},
+            expectedBehavior: [
+                {
+                    type: "status",
+                    target: failedNode?.nodeId || "unknown",
+                    expected: "failed",
+                    operator: "equals",
+                },
+            ],
+            code: `import { describe, it, expect, beforeEach } from "vitest";
+import { bootstrap } from "../bootstrap.js";
+
+describe("Regression: ${instance.workflowId}", () => {
+  let engine: any;
+
+  beforeEach(async () => {
+    const ctx = await bootstrap({ skipValidation: true, skipGracefulShutdown: true });
+    engine = ctx.engine;
+  });
+
+  it("should handle the failure case from instance ${instance.instanceId}", async () => {
+    const input = ${JSON.stringify(instance.context || {}, null, 2)};
+
+    try {
+      const result = await engine.start("${instance.workflowId}", input);
+      // Verify the failure is handled gracefully
+      expect(result).toBeDefined();
+    } catch (error) {
+      expect(error).toBeDefined();
+    }
+  });
+});`,
+        };
+    }
+    async generateMutationTests(workflow) {
+        const tests = [];
+        for (const [nodeId, node] of Object.entries(workflow.nodes)) {
+            tests.push({
+                workflowId: workflow.id,
+                testType: "boundary",
+                description: `Mutation: Remove node '${nodeId}' and verify workflow behavior`,
+                input: {},
+                expectedBehavior: [],
+                code: `import { describe, it, expect } from "vitest";
+
+describe("Mutation: Remove node ${nodeId}", () => {
+  it("should handle missing node gracefully", () => {
+    const workflow = ${JSON.stringify(workflow, null, 2)};
+    delete workflow.nodes["${nodeId}"];
+
+    // The workflow engine should detect the missing node
+    // and either fail validation or handle the error
+    expect(workflow.nodes["${nodeId}"]).toBeUndefined();
+  });
+});`,
+            });
+            if (node.type !== "action") {
+                tests.push({
+                    workflowId: workflow.id,
+                    testType: "boundary",
+                    description: `Mutation: Change node '${nodeId}' type from '${node.type}' to 'action'`,
+                    input: {},
+                    expectedBehavior: [],
+                    code: `import { describe, it, expect } from "vitest";
+
+describe("Mutation: Change node ${nodeId} type", () => {
+  it("should handle type mismatch gracefully", () => {
+    const workflow = ${JSON.stringify(workflow, null, 2)};
+    workflow.nodes["${nodeId}"].type = "action";
+
+    // The workflow engine should detect the type mismatch
+    expect(workflow.nodes["${nodeId}"].type).toBe("action");
+  });
+});`,
+                });
+            }
+        }
+        return tests;
+    }
+}
+//# sourceMappingURL=TestGenerator.js.map

package/dist/src/testing/TestGenerator.js.map

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

package/dist/src/testing/index.d.ts

@@ -0,0 +1,2 @@
+export { type Mutation, type MutationReport, type MutationResult, MutationTester, type MutationType, } from "./MutationTester.js";
+export { type MockNodeHandler, type TestWorkflowInput, type TestWorkflowOptions, type TestWorkflowResult, type TestWorkflowTemplateInput, testWorkflow, type WorkflowFailureSnapshot, } from "./testWorkflow.js";

package/dist/src/testing/index.js

@@ -0,0 +1,3 @@
+export { MutationTester, } from "./MutationTester.js";
+export { testWorkflow, } from "./testWorkflow.js";
+//# sourceMappingURL=index.js.map

package/dist/src/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,cAAc,GAEf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAML,YAAY,GAEb,MAAM,gBAAgB,CAAC"}

package/dist/src/testing/testWorkflow.d.ts

@@ -0,0 +1,51 @@
+import { WorkflowEngine } from "../engine/WorkflowEngine.js";
+import type { WorkflowInstance } from "../model/Instance.js";
+import type { TaskNode, WorkflowDefinition } from "../model/Workflow.js";
+import { MemoryStorage } from "../storage/MemoryStorage.js";
+import type { TemplateInstanceRequest } from "../templates/index.js";
+import { type TemplateRegistry } from "../templates/index.js";
+export type MockNodeHandler = (instance: WorkflowInstance, node: TaskNode) => Promise<unknown> | unknown;
+export interface TestWorkflowOptions {
+    context?: Record<string, unknown>;
+    mockNodes?: Record<string, MockNodeHandler | unknown>;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    templateRegistry?: TemplateRegistry;
+}
+export type TestWorkflowTemplateInput = Omit<TemplateInstanceRequest, "name"> & {
+    name?: string;
+};
+export type TestWorkflowInput = WorkflowDefinition | string | {
+    dsl: string;
+} | {
+    template: TestWorkflowTemplateInput;
+};
+export interface WorkflowFailureSnapshot {
+    instanceId: string;
+    workflowId: string;
+    status: WorkflowInstance["status"];
+    currentNodes: string[];
+    history: Array<{
+        nodeId: string;
+        status: string;
+        error?: string;
+        timestamp: string;
+    }>;
+    outputs: Record<string, unknown>;
+}
+export interface TestWorkflowResult {
+    instanceId: string;
+    instance: WorkflowInstance;
+    outputs: Record<string, unknown>;
+    history: WorkflowInstance["history"];
+    failureSnapshot?: WorkflowFailureSnapshot;
+    storage: MemoryStorage;
+    engine: WorkflowEngine;
+    getOutput: <T = unknown>(nodeId: string) => T | undefined;
+    expectStatus: (status: WorkflowInstance["status"]) => TestWorkflowResult;
+    expectCompleted: () => TestWorkflowResult;
+    expectOutput: <T = unknown>(nodeId: string, expected: T) => TestWorkflowResult;
+    formatFailureSnapshot: () => string;
+    cleanup: () => Promise<void>;
+}
+export declare function testWorkflow(workflowInput: TestWorkflowInput, options?: TestWorkflowOptions): Promise<TestWorkflowResult>;

package/dist/src/testing/testWorkflow.js

@@ -0,0 +1,167 @@
+import { DeadLetterQueue } from "../dlq/index.js";
+import { parseDSL } from "../dsl/DSLParser.js";
+import { WorkflowEngine } from "../engine/WorkflowEngine.js";
+import { EventBus } from "../event/EventBus.js";
+import { CronScheduler } from "../scheduler/CronScheduler.js";
+import { MemoryStorage } from "../storage/MemoryStorage.js";
+import { registerBuiltinTemplates, templateRegistry as sharedTemplateRegistry, } from "../templates/index.js";
+function isTerminalStatus(status) {
+    return ["completed", "failed", "cancelled"].includes(status);
+}
+function applyMocks(workflow, mockNodes) {
+    if (!mockNodes || Object.keys(mockNodes).length === 0) {
+        return workflow;
+    }
+    const nodes = Object.fromEntries(Object.entries(workflow.nodes).map(([nodeId, node]) => {
+        const mock = mockNodes[nodeId];
+        if (mock === undefined) {
+            return [nodeId, node];
+        }
+        const action = async (instance) => {
+            if (typeof mock === "function") {
+                return mock(instance, node);
+            }
+            return mock;
+        };
+        return [
+            nodeId,
+            {
+                ...node,
+                type: "action",
+                action,
+                config: undefined,
+            },
+        ];
+    }));
+    return {
+        ...workflow,
+        nodes,
+    };
+}
+function extractOutputs(instance) {
+    return Object.fromEntries(Object.entries(instance.state?.nodes ?? {}).map(([nodeId, nodeState]) => [
+        nodeId,
+        nodeState.output,
+    ]));
+}
+function normalizeForAssertion(value) {
+    return JSON.stringify(value);
+}
+function createFailureSnapshot(instance) {
+    if (instance.status === "completed") {
+        return undefined;
+    }
+    return {
+        instanceId: instance.instanceId,
+        workflowId: instance.workflowId,
+        status: instance.status,
+        currentNodes: [...instance.currentNodes],
+        history: instance.history.map((entry) => ({
+            nodeId: entry.nodeId,
+            status: entry.status,
+            error: entry.error,
+            timestamp: entry.timestamp instanceof Date
+                ? entry.timestamp.toISOString()
+                : new Date(entry.timestamp).toISOString(),
+        })),
+        outputs: extractOutputs(instance),
+    };
+}
+function formatFailureSnapshot(snapshot) {
+    if (!snapshot) {
+        return "workflow completed successfully";
+    }
+    return JSON.stringify(snapshot, null, 2);
+}
+export async function testWorkflow(workflowInput, options = {}) {
+    const storage = new MemoryStorage();
+    await storage.connect();
+    const eventBus = new EventBus();
+    const scheduler = new CronScheduler(storage);
+    const dlq = new DeadLetterQueue(storage);
+    const engine = new WorkflowEngine(storage, eventBus, scheduler, dlq, {
+        instanceTtlHours: 24,
+        cleanupIntervalMs: 60_000,
+        maxInstances: 100,
+    });
+    await engine.initialize({ resumeRunningInstances: false });
+    const workflow = resolveWorkflowDefinition(workflowInput, options);
+    const mockedWorkflow = applyMocks(workflow, options.mockNodes);
+    await engine.register(mockedWorkflow, { persist: false });
+    const instanceId = await engine.start(mockedWorkflow.id, options.context ?? {});
+    const timeoutMs = options.timeoutMs ?? 5_000;
+    const pollIntervalMs = options.pollIntervalMs ?? 20;
+    const deadline = Date.now() + timeoutMs;
+    let instance = engine.getInstance(instanceId);
+    while (instance &&
+        !isTerminalStatus(instance.status) &&
+        Date.now() < deadline) {
+        await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+        instance = engine.getInstance(instanceId);
+    }
+    if (!instance) {
+        await cleanupResources(engine, scheduler, eventBus, storage);
+        throw new Error(`Workflow instance not found: ${instanceId}`);
+    }
+    if (!isTerminalStatus(instance.status)) {
+        const snapshot = createFailureSnapshot(instance);
+        const report = formatFailureSnapshot(snapshot);
+        await cleanupResources(engine, scheduler, eventBus, storage);
+        throw new Error(`Workflow test timed out after ${timeoutMs}ms\n${report}`);
+    }
+    const failureSnapshot = createFailureSnapshot(instance);
+    const cleanup = async () => {
+        await cleanupResources(engine, scheduler, eventBus, storage);
+    };
+    const result = {
+        instanceId,
+        instance,
+        outputs: extractOutputs(instance),
+        history: instance.history,
+        failureSnapshot,
+        storage,
+        engine,
+        getOutput: (nodeId) => result.outputs[nodeId],
+        expectStatus: (status) => {
+            if (result.instance.status !== status) {
+                throw new Error(`Expected workflow status ${status}, received ${result.instance.status}\n${result.formatFailureSnapshot()}`);
+            }
+            return result;
+        },
+        expectCompleted: () => result.expectStatus("completed"),
+        expectOutput: (nodeId, expected) => {
+            const actual = result.getOutput(nodeId);
+            if (normalizeForAssertion(actual) !== normalizeForAssertion(expected)) {
+                throw new Error(`Unexpected output for node ${nodeId}\nExpected: ${normalizeForAssertion(expected)}\nActual: ${normalizeForAssertion(actual)}\n${result.formatFailureSnapshot()}`);
+            }
+            return result;
+        },
+        formatFailureSnapshot: () => formatFailureSnapshot(result.failureSnapshot),
+        cleanup,
+    };
+    return result;
+}
+function resolveWorkflowDefinition(workflowInput, options) {
+    if (typeof workflowInput === "string") {
+        return parseDSL(workflowInput);
+    }
+    if ("dsl" in workflowInput) {
+        return parseDSL(workflowInput.dsl);
+    }
+    if ("template" in workflowInput) {
+        const registry = options.templateRegistry ?? sharedTemplateRegistry;
+        registerBuiltinTemplates(registry);
+        return registry.instantiate({
+            ...workflowInput.template,
+            name: workflowInput.template.name ?? workflowInput.template.templateId,
+        });
+    }
+    return workflowInput;
+}
+async function cleanupResources(engine, scheduler, eventBus, storage) {
+    engine.destroy();
+    scheduler.stopAll();
+    await eventBus.close();
+    await storage.close();
+}
+//# sourceMappingURL=testWorkflow.js.map

package/dist/src/testing/testWorkflow.js.map

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