ts-workflow-engine-lite 2.1.0

package/dist/src/api/routes/workflows/import.js

@@ -0,0 +1,238 @@
+import { body, param, query, validationResult } from "express-validator";
+import { Logger } from "../../../utils/Logger.js";
+import { sendError, sendSuccess } from "../../response.js";
+import { WorkflowApplicationService } from "../../services/WorkflowApplicationService.js";
+import { getRequestEngine, getRequestStorage, requireRequestEngine, } from "../../utils/requestContext.js";
+import { asyncHandler } from "../../utils/routeHelper.js";
+import { persistImportedWorkflow, schemaValidator, templateRegistry, workflowSchema, } from "./shared.js";
+let _cachedService = null;
+function getService(req) {
+    const storage = getRequestStorage(req) ?? null;
+    if (!_cachedService || storage !== null) {
+        _cachedService = new WorkflowApplicationService(storage);
+    }
+    return _cachedService;
+}
+export function registerImportRoutes(router) {
+    router.post("/import/dsl", body("dsl").isString().notEmpty().withMessage("DSL content is required"), body("name").optional().isString().withMessage("Name must be a string"), body("description")
+        .optional()
+        .isString()
+        .withMessage("Description must be a string"), body("tags").optional().isArray().withMessage("Tags must be an array"), body("overwrite")
+        .optional()
+        .isBoolean()
+        .withMessage("overwrite must be boolean"), asyncHandler(async (req, res) => {
+        const service = getService(req);
+        const { dsl, name, description, tags, overwrite } = req.body;
+        const result = await service.importDsl({
+            dsl,
+            name,
+            description,
+            tags,
+            overwrite,
+        });
+        const engine = getRequestEngine(req);
+        if (engine && typeof engine.register === "function") {
+            await engine.register(result.definition, {
+                version: result.version.toString(),
+                setActive: result.publishedVersion === result.version,
+            });
+        }
+        res.status(201).json({
+            success: true,
+            data: { workflow: result, source: "dsl" },
+            message: "Workflow imported from DSL",
+        });
+    }));
+    router.post("/import/template", body("templateId")
+        .isString()
+        .notEmpty()
+        .withMessage("templateId is required"), body("name").isString().notEmpty().withMessage("Name is required"), body("parameters")
+        .optional()
+        .isObject()
+        .withMessage("parameters must be an object"), body("description")
+        .optional()
+        .isString()
+        .withMessage("Description must be a string"), body("tags").optional().isArray().withMessage("Tags must be an array"), body("overwrite")
+        .optional()
+        .isBoolean()
+        .withMessage("overwrite must be boolean"), async (req, res) => {
+        const errors = validationResult(req);
+        if (!errors.isEmpty()) {
+            return sendError(res, 400, 400, errors.array()[0].msg);
+        }
+        try {
+            const storage = getRequestStorage(req);
+            const engine = getRequestEngine(req);
+            const { templateId, name, parameters, description, tags, overwrite } = req.body;
+            if (!storage) {
+                return sendError(res, 500, 500, "Workflow template import not supported");
+            }
+            const workflowDefinition = templateRegistry.instantiate({
+                templateId,
+                name,
+                parameters: parameters ?? {},
+            });
+            if (description) {
+                workflowDefinition.description = description;
+            }
+            const validation = schemaValidator.validate(workflowDefinition);
+            if (!validation.valid) {
+                return sendError(res, 400, 400, "Workflow definition validation failed", {
+                    errors: validation.errors,
+                    warnings: validation.warnings,
+                });
+            }
+            const storedWorkflow = await persistImportedWorkflow(storage, workflowDefinition, {
+                description: workflowDefinition.description,
+                tags,
+                overwrite,
+            });
+            if (storedWorkflow === "conflict") {
+                return sendError(res, 409, 409, `Workflow with ID ${workflowDefinition.id} already exists`);
+            }
+            if (engine && typeof engine.register === "function") {
+                await engine.register(storedWorkflow.definition, {
+                    version: storedWorkflow.version.toString(),
+                    setActive: storedWorkflow.publishedVersion === storedWorkflow.version,
+                });
+            }
+            return sendSuccess(res, 201, {
+                workflow: storedWorkflow,
+                source: "template",
+                templateId,
+            }, "Workflow imported from template");
+        }
+        catch (error) {
+            Logger.error("api", "workflows", `Error importing workflow from template: ${error?.message}`, error?.stack);
+            return sendError(res, 400, 400, error?.message || "Failed to import workflow from template");
+        }
+    });
+    router.post("/import", body("definition")
+        .isObject()
+        .withMessage("Workflow definition is required"), body("name").optional().isString().withMessage("Name must be a string"), body("description")
+        .optional()
+        .isString()
+        .withMessage("Description must be a string"), body("tags").optional().isArray().withMessage("Tags must be an array"), body("overwrite")
+        .optional()
+        .isBoolean()
+        .withMessage("overwrite must be boolean"), async (req, res) => {
+        const errors = validationResult(req);
+        if (!errors.isEmpty()) {
+            return sendError(res, 400, 400, errors.array()[0].msg);
+        }
+        try {
+            const storage = getRequestStorage(req);
+            const { definition, name, description, tags, overwrite } = req.body;
+            const workflowDefinition = definition;
+            const workflowId = workflowDefinition.id;
+            const workflowName = name ?? workflowDefinition.name;
+            if (!workflowId || !workflowName) {
+                return sendError(res, 400, 400, "Workflow id and name are required");
+            }
+            const validationResult = schemaValidator.validate(workflowDefinition);
+            if (!validationResult.valid) {
+                return sendError(res, 400, 400, "Workflow definition validation failed", {
+                    errors: validationResult.errors,
+                    warnings: validationResult.warnings,
+                });
+            }
+            if (!storage) {
+                return sendError(res, 500, 500, "Workflow import not supported");
+            }
+            const existing = await storage.loadWorkflowWithMetadata(workflowId);
+            const now = Date.now();
+            if (existing && !overwrite) {
+                return sendError(res, 409, 409, `Workflow with ID ${workflowId} already exists`);
+            }
+            const nextVersion = existing ? existing.version + 1 : 1;
+            const storedWorkflow = {
+                id: workflowId,
+                name: workflowName,
+                description: description ?? existing?.description,
+                definition: workflowDefinition,
+                version: nextVersion,
+                publishedVersion: existing?.publishedVersion ?? nextVersion,
+                lockedVersion: existing?.lockedVersion,
+                releasePolicy: existing?.releasePolicy,
+                createdAt: existing?.createdAt ?? now,
+                updatedAt: now,
+                tags: tags ?? existing?.tags,
+            };
+            await storage.saveWorkflowWithMetadata(storedWorkflow);
+            const workflowVersion = {
+                id: storedWorkflow.id,
+                name: storedWorkflow.name,
+                description: storedWorkflow.description,
+                definition: storedWorkflow.definition,
+                version: storedWorkflow.version,
+                createdAt: now,
+                tags: storedWorkflow.tags,
+                metadata: storedWorkflow.definition.metadata,
+            };
+            await storage.saveWorkflowVersion(workflowVersion);
+            const engine = getRequestEngine(req);
+            if (engine && typeof engine.register === "function") {
+                await engine.register(storedWorkflow.definition, {
+                    version: storedWorkflow.version.toString(),
+                    setActive: storedWorkflow.publishedVersion === storedWorkflow.version,
+                });
+            }
+            return sendSuccess(res, 201, storedWorkflow, "Workflow imported");
+        }
+        catch (error) {
+            Logger.error("api", "workflows", `Error importing workflow: ${error?.message}`, error?.stack);
+            return sendError(res, 500, 500, error?.message || "Failed to import workflow");
+        }
+    });
+    router.get("/:id/export", param("id").isString().notEmpty().withMessage("Workflow ID is required"), query("version")
+        .optional()
+        .isInt({ min: 1 })
+        .withMessage("Version must be a positive integer"), async (req, res) => {
+        const errors = validationResult(req);
+        if (!errors.isEmpty()) {
+            return sendError(res, 400, 400, errors.array()[0].msg);
+        }
+        try {
+            const storage = getRequestStorage(req);
+            const workflowId = req.params?.id;
+            const versionValue = req.query?.version;
+            if (storage) {
+                const versionNumber = versionValue
+                    ? Number.parseInt(versionValue, 10)
+                    : undefined;
+                const workflow = versionNumber !== undefined
+                    ? await storage.loadWorkflowVersion(workflowId, versionNumber)
+                    : await storage.loadWorkflowWithMetadata(workflowId);
+                if (!workflow) {
+                    return sendError(res, 404, 404, `Workflow with ID ${workflowId} not found`);
+                }
+                const definition = "definition" in workflow ? workflow.definition : workflow;
+                const resolvedVersion = "version" in workflow ? workflow.version : versionNumber;
+                return sendSuccess(res, 200, {
+                    workflowId,
+                    version: resolvedVersion,
+                    definition,
+                    schema: workflowSchema,
+                }, "Workflow exported");
+            }
+            const engine = requireRequestEngine(req);
+            const workflow = typeof engine.getWorkflow === "function"
+                ? engine.getWorkflow(workflowId, versionValue)
+                : undefined;
+            if (!workflow) {
+                return sendError(res, 404, 404, `Workflow with ID ${workflowId} not found`);
+            }
+            return sendSuccess(res, 200, {
+                workflowId,
+                version: workflow.version,
+                definition: workflow,
+                schema: workflowSchema,
+            }, "Workflow exported");
+        }
+        catch (error) {
+            Logger.error("api", "workflows", `Error exporting workflow ${req.params?.id}: ${error?.message}`, error?.stack);
+            return sendError(res, 500, 500, error?.message || "Failed to export workflow");
+        }
+    });
+}
+//# sourceMappingURL=import.js.map

package/dist/src/api/routes/workflows/import.js.map

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

package/dist/src/api/routes/workflows/index.d.ts

@@ -0,0 +1,3 @@
+import { type Router as ExpressRouter } from "express";
+declare const router: ExpressRouter;
+export default router;

package/dist/src/api/routes/workflows/index.js

@@ -0,0 +1,18 @@
+import { Router } from "express";
+import { registerAnalysisRoutes } from "./analysis.js";
+import { registerCrudRoutes } from "./crud.js";
+import { registerExecutionRoutes } from "./execution.js";
+import { registerGraphRoutes } from "./graph.js";
+import { registerImportRoutes } from "./import.js";
+import { registerVariableRoutes } from "./variables.js";
+import { registerVersioningRoutes } from "./versioning.js";
+const router = Router();
+registerCrudRoutes(router);
+registerImportRoutes(router);
+registerAnalysisRoutes(router);
+registerVersioningRoutes(router);
+registerExecutionRoutes(router);
+registerGraphRoutes(router);
+registerVariableRoutes(router);
+export default router;
+//# sourceMappingURL=index.js.map

package/dist/src/api/routes/workflows/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/api/routes/workflows/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgC,MAAM,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,MAAM,GAAkB,MAAM,EAAE,CAAC;AAGvC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC/B,wBAAwB,CAAC,MAAM,CAAC,CAAC;AACjC,uBAAuB,CAAC,MAAM,CAAC,CAAC;AAChC,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC5B,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/B,eAAe,MAAM,CAAC"}

package/dist/src/api/routes/workflows/shared.d.ts

@@ -0,0 +1,64 @@
+import { SchemaValidator } from "../../../engine/SchemaValidator.js";
+import type { TaskType, WorkflowDefinition } from "../../../model/Workflow.js";
+import type { StorageProvider, StoredWorkflow } from "../../../storage/StorageProvider.js";
+import { templateRegistry } from "../../../templates/index.js";
+import type { requireRequestEngine } from "../../utils/requestContext.js";
+export type WorkflowWithListInstances = {
+    listInstancesByWorkflow?: (workflowId: string) => Promise<unknown[]>;
+};
+export type WorkflowRegistrationEngine = ReturnType<typeof requireRequestEngine> & {
+    register?: (workflow: WorkflowDefinition, options?: {
+        version?: string;
+        setActive?: boolean;
+    }) => Promise<void>;
+    setReleasePolicy?: (workflowId: string, policy: unknown) => void;
+};
+export type WorkflowVersioningEngine = ReturnType<typeof requireRequestEngine> & {
+    listWorkflowVersions?: (workflowId: string) => string[];
+    getActiveWorkflowVersion?: (workflowId: string) => string | undefined;
+    getLockedWorkflowVersion?: (workflowId: string) => string | undefined;
+    getReleasePolicy?: (workflowId: string) => unknown;
+    setActiveWorkflowVersion?: (workflowId: string, version: string) => void;
+    setLockedWorkflowVersion?: (workflowId: string, version: string) => void;
+    clearLockedWorkflowVersion?: (workflowId: string) => void;
+    setReleasePolicy?: (workflowId: string, policy: unknown) => void;
+    startCanaryRelease?: (workflowId: string, version: number, percent: number, rules?: {
+        autoPromote?: boolean;
+        minInstances?: number;
+        maxErrorRate?: number;
+        evaluationWindowMs?: number;
+    }) => Promise<void>;
+    promoteCanary?: (workflowId: string) => Promise<void>;
+    getCanaryStatus?: (workflowId: string) => Promise<unknown>;
+};
+export type WorkflowDryRunEngine = WorkflowRegistrationEngine & {
+    dryRun?: (workflowId: string, context?: Record<string, unknown>, options?: Record<string, unknown>) => Promise<unknown>;
+};
+export declare function toWorkflowDefinition(definition: unknown): WorkflowDefinition;
+export declare const schemaValidator: SchemaValidator;
+export { templateRegistry };
+export declare const workflowSchema: {
+    $id: string;
+};
+export declare const nodeTemplates: {
+    configSchema: Record<string, unknown> | null;
+    ports: import("../../../model/WorkflowGraph.js").GraphEdgeKind[];
+    type: TaskType;
+    label: string;
+    category: "core" | "io" | "control";
+    description: string;
+    example?: Record<string, unknown>;
+}[];
+export declare function persistImportedWorkflow(storage: StorageProvider, workflowDefinition: WorkflowDefinition, options: {
+    description?: string;
+    tags?: string[];
+    overwrite?: boolean;
+}): Promise<StoredWorkflow | "conflict">;
+export declare const sanitizeValue: (value: any) => any;
+export declare const stableStringify: (value: any) => string;
+export declare const getNodeSignature: (node: any) => string;
+export declare const collectTargets: (node: any) => string[];
+export declare const buildGraph: (definition: WorkflowDefinition) => Map<string, Set<string>>;
+export declare const toEdgeSet: (graph: Map<string, Set<string>>) => Set<string>;
+export declare const traverseGraph: (graph: Map<string, Set<string>>, startNodes: string[]) => Set<string>;
+export declare const reverseGraph: (graph: Map<string, Set<string>>) => Map<string, Set<string>>;

package/dist/src/api/routes/workflows/shared.js

@@ -0,0 +1,304 @@
+import { SchemaValidator } from "../../../engine/SchemaValidator.js";
+import { getSupportedEdgeKinds } from "../../../model/WorkflowGraph.js";
+import { getNodeConfigJsonSchema, getWorkflowDefinitionJsonSchema, } from "../../../model/WorkflowSchema.js";
+import { registerBuiltinTemplates, templateRegistry, } from "../../../templates/index.js";
+export function toWorkflowDefinition(definition) {
+    return definition;
+}
+export const schemaValidator = new SchemaValidator();
+schemaValidator.registerNodeType("http");
+schemaValidator.registerNodeType("sql");
+schemaValidator.registerNodeType("queue");
+schemaValidator.registerNodeType("condition");
+schemaValidator.registerNodeType("router");
+schemaValidator.registerNodeType("loop");
+registerBuiltinTemplates(templateRegistry);
+export { templateRegistry };
+export const workflowSchema = {
+    $id: "https://ts-workflow-engine.local/workflow.schema.json",
+    ...getWorkflowDefinitionJsonSchema(),
+};
+const NODE_TYPE_CATALOG = [
+    {
+        type: "action",
+        label: "Action",
+        category: "core",
+        description: "Runs custom application code, registered as a JS function at register() time. Not editable from a form — config has no declarative schema.",
+    },
+    {
+        type: "wait",
+        label: "Wait",
+        category: "core",
+        description: "Pauses the instance for `config.durationMs`, until `config.until` (an absolute ISO timestamp), or the legacy `timeout` field.",
+        example: { durationMs: 5000 },
+    },
+    {
+        type: "event",
+        label: "Event",
+        category: "core",
+        description: "Waits for an external event named `onEvent` to resume.",
+        example: { onEvent: "order.paid" },
+    },
+    {
+        type: "rollback",
+        label: "Rollback",
+        category: "core",
+        description: "Executes compensation logic for a prior node.",
+    },
+    {
+        type: "subworkflow",
+        label: "Subworkflow",
+        category: "core",
+        description: "Starts another registered workflow (subworkflowId) and optionally waits for completion.",
+        example: { subworkflowId: "", waitForCompletion: true },
+    },
+    {
+        type: "http",
+        label: "HTTP Request",
+        category: "io",
+        description: "Calls an external HTTP endpoint.",
+        example: { method: "GET", url: "https://api.example.com/resource" },
+    },
+    {
+        type: "sql",
+        label: "SQL Query",
+        category: "io",
+        description: "Executes a SQL query against a configured connection.",
+        example: { connection: "default", query: "SELECT * FROM table" },
+    },
+    {
+        type: "queue",
+        label: "Queue",
+        category: "io",
+        description: "Publishes to or consumes from a message queue.",
+        example: {
+            operation: "publish",
+            queue: "default",
+            message: { text: "msg" },
+        },
+    },
+    {
+        type: "notification",
+        label: "Notification",
+        category: "io",
+        description: "Sends a notification via Slack/Feishu/DingTalk/email/webhook.",
+        example: { channel: "slack", target: "#alerts", template: "{{message}}" },
+    },
+    {
+        type: "condition",
+        label: "Condition",
+        category: "control",
+        description: "Branches to one of two nodes (trueBranch/falseBranch) based on a boolean expression.",
+        example: { condition: "${context.flag === true}" },
+    },
+    {
+        type: "router",
+        label: "Router",
+        category: "control",
+        description: "Branches to one of several nodes based on ordered route conditions, falling back to defaultTarget.",
+        example: {
+            routes: [{ condition: "${context.type === 'vip'}", target: "" }],
+        },
+    },
+    {
+        type: "loop",
+        label: "Loop",
+        category: "control",
+        description: "Iterates `collection`, executing a `body` node per item.",
+        example: { collection: "${context.items}", itemVariable: "item" },
+    },
+    {
+        type: "approval",
+        label: "Approval",
+        category: "control",
+        description: "Waits for an approve/reject signal before branching (approvedTarget/rejectedTarget).",
+        example: { prompt: "Approve this request?" },
+    },
+    {
+        type: "join",
+        label: "Join",
+        category: "control",
+        description: "Waits for multiple fan-out branches (waitFor) to complete before proceeding — mode 'all' (default) requires every branch, 'any' proceeds once one has.",
+        example: { waitFor: ["branchA", "branchB"], mode: "all" },
+    },
+    {
+        type: "transform",
+        label: "Transform",
+        category: "control",
+        description: "Reshapes prior node outputs into a new output object; each `output` field is an expression, evaluated (not string-interpolated) so numbers/arrays/objects keep their type.",
+        example: { output: { total: "${node1.output.price * node1.output.qty}" } },
+    },
+];
+export const nodeTemplates = NODE_TYPE_CATALOG.map((entry) => ({
+    ...entry,
+    configSchema: getNodeConfigJsonSchema(entry.type),
+    ports: getSupportedEdgeKinds(entry.type),
+}));
+export async function persistImportedWorkflow(storage, workflowDefinition, options) {
+    const existing = await storage.loadWorkflowWithMetadata(workflowDefinition.id);
+    if (existing && !options.overwrite) {
+        return "conflict";
+    }
+    const now = Date.now();
+    const nextVersion = existing ? existing.version + 1 : 1;
+    const storedWorkflow = {
+        id: workflowDefinition.id,
+        name: workflowDefinition.name,
+        description: options.description ?? existing?.description,
+        definition: workflowDefinition,
+        version: nextVersion,
+        publishedVersion: existing?.publishedVersion ?? nextVersion,
+        lockedVersion: existing?.lockedVersion,
+        releasePolicy: existing?.releasePolicy,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now,
+        tags: options.tags ?? existing?.tags,
+    };
+    await storage.saveWorkflowWithMetadata(storedWorkflow);
+    const workflowVersion = {
+        id: storedWorkflow.id,
+        name: storedWorkflow.name,
+        description: storedWorkflow.description,
+        definition: storedWorkflow.definition,
+        version: storedWorkflow.version,
+        createdAt: now,
+        tags: storedWorkflow.tags,
+        metadata: storedWorkflow.definition.metadata,
+    };
+    await storage.saveWorkflowVersion(workflowVersion);
+    return storedWorkflow;
+}
+export const sanitizeValue = (value) => {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value === "function")
+        return undefined;
+    if (Array.isArray(value)) {
+        const items = value
+            .map((item) => sanitizeValue(item))
+            .filter((item) => item !== undefined);
+        return items;
+    }
+    if (typeof value === "object") {
+        const result = {};
+        Object.entries(value).forEach(([key, item]) => {
+            if (typeof item === "function")
+                return;
+            const sanitized = sanitizeValue(item);
+            if (sanitized !== undefined) {
+                result[key] = sanitized;
+            }
+        });
+        return result;
+    }
+    return value;
+};
+export const stableStringify = (value) => {
+    if (value === null || value === undefined)
+        return JSON.stringify(value);
+    if (typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    const entries = Object.entries(value).sort(([a], [b]) => a.localeCompare(b));
+    return `{${entries
+        .map(([key, item]) => `${JSON.stringify(key)}:${stableStringify(item)}`)
+        .join(",")}}`;
+};
+export const getNodeSignature = (node) => {
+    return stableStringify(sanitizeValue(node));
+};
+export const collectTargets = (node) => {
+    const targets = new Set();
+    const addValue = (value) => {
+        if (!value)
+            return;
+        if (Array.isArray(value)) {
+            value.forEach((entry) => {
+                addValue(entry);
+            });
+            return;
+        }
+        if (typeof value === "string") {
+            targets.add(value);
+            return;
+        }
+        if (typeof value === "object" && value.target) {
+            targets.add(value.target);
+        }
+    };
+    addValue(node.next);
+    addValue(node.failureNext);
+    addValue(node.conditionalNext);
+    addValue(node.defaultNext);
+    addValue(node.rollbackTo);
+    addValue(node.onSuccess);
+    addValue(node.onFailure);
+    if (node.config) {
+        addValue(node.config.trueBranch);
+        addValue(node.config.falseBranch);
+        addValue(node.config.defaultTarget);
+        addValue(node.config.body);
+        if (Array.isArray(node.config.routes)) {
+            node.config.routes.forEach((route) => {
+                addValue(route?.target);
+            });
+        }
+    }
+    return Array.from(targets);
+};
+export const buildGraph = (definition) => {
+    const adjacency = new Map();
+    if (!definition?.nodes) {
+        return adjacency;
+    }
+    Object.entries(definition.nodes).forEach(([nodeId, node]) => {
+        const targets = collectTargets(node);
+        adjacency.set(nodeId, new Set(targets));
+    });
+    return adjacency;
+};
+export const toEdgeSet = (graph) => {
+    const edges = new Set();
+    for (const [source, targets] of graph.entries()) {
+        for (const target of targets) {
+            edges.add(`${source}->${target}`);
+        }
+    }
+    return edges;
+};
+export const traverseGraph = (graph, startNodes) => {
+    const visited = new Set();
+    const stack = [...startNodes];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        const next = graph.get(current);
+        if (next) {
+            next.forEach((nodeId) => {
+                if (!visited.has(nodeId)) {
+                    stack.push(nodeId);
+                }
+            });
+        }
+    }
+    return visited;
+};
+export const reverseGraph = (graph) => {
+    const reversed = new Map();
+    for (const [source, targets] of graph.entries()) {
+        if (!reversed.has(source)) {
+            reversed.set(source, new Set());
+        }
+        targets.forEach((target) => {
+            const set = reversed.get(target) || new Set();
+            set.add(source);
+            reversed.set(target, set);
+        });
+    }
+    return reversed;
+};
+//# sourceMappingURL=shared.js.map