@n8n/engine 0.16.0 → 0.17.0

package/dist/graph/loops.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveLoops = deriveLoops;
+exports.validateLoops = validateLoops;
+const common_1 = require("../common");
+const graph_validation_error_1 = require("./graph-validation.error");
+function deriveLoops(graph) {
+    const backEdgeTargets = [...new Set(graph.edges.filter((e) => e.isBackEdge).map((e) => e.to))];
+    if (backEdgeTargets.length === 0)
+        return [];
+    const sccByNode = computeSccMembership(graph, graph.edges);
+    return backEdgeTargets.map((batchNodeId) => {
+        const memberIds = sccByNode.get(batchNodeId) ?? new Set([batchNodeId]);
+        return {
+            batchNodeId,
+            memberIds,
+            backEdges: graph.edges.filter((e) => e.isBackEdge && e.to === batchNodeId),
+            entryEdges: graph.edges.filter((e) => !e.isBackEdge && e.to === batchNodeId && !memberIds.has(e.from)),
+            exitEdges: graph.edges.filter((e) => !e.isBackEdge && memberIds.has(e.from) && !memberIds.has(e.to)),
+        };
+    });
+}
+function computeSccMembership(graph, edges) {
+    const outgoing = new Map();
+    for (const edge of edges) {
+        const list = outgoing.get(edge.from);
+        if (list)
+            list.push(edge);
+        else
+            outgoing.set(edge.from, [edge]);
+    }
+    const indexById = new Map();
+    const lowlinkById = new Map();
+    const stack = [];
+    const onStack = new Set();
+    const membership = new Map();
+    let nextIndex = 0;
+    const connect = (nodeId) => {
+        indexById.set(nodeId, nextIndex);
+        lowlinkById.set(nodeId, nextIndex);
+        nextIndex += 1;
+        stack.push(nodeId);
+        onStack.add(nodeId);
+        for (const edge of outgoing.get(nodeId) ?? []) {
+            if (!indexById.has(edge.to)) {
+                connect(edge.to);
+                lowlinkById.set(nodeId, Math.min(lowlinkById.get(nodeId), lowlinkById.get(edge.to)));
+            }
+            else if (onStack.has(edge.to)) {
+                lowlinkById.set(nodeId, Math.min(lowlinkById.get(nodeId), indexById.get(edge.to)));
+            }
+        }
+        if (lowlinkById.get(nodeId) === indexById.get(nodeId)) {
+            const members = new Set();
+            let member;
+            do {
+                member = stack.pop();
+                onStack.delete(member);
+                members.add(member);
+            } while (member !== nodeId);
+            for (const id of members)
+                membership.set(id, members);
+        }
+    };
+    for (const node of graph.nodes) {
+        if (!indexById.has(node.id))
+            connect(node.id);
+    }
+    return membership;
+}
+function isCyclic(members, edges) {
+    if (members.size > 1)
+        return true;
+    const [only] = members;
+    return edges.some((edge) => edge.from === only && edge.to === only);
+}
+function validateLoops(graph) {
+    const namesById = new Map(graph.nodes.map((node) => [node.id, node.name]));
+    const name = (id) => namesById.get(id) ?? id;
+    const seenNodeIds = new Set();
+    for (const node of graph.nodes) {
+        if (seenNodeIds.has(node.id)) {
+            throw new graph_validation_error_1.GraphValidationError(`Two nodes share the id ${node.id}`);
+        }
+        seenNodeIds.add(node.id);
+    }
+    for (const edge of graph.edges) {
+        for (const endpoint of [edge.from, edge.to]) {
+            if (!namesById.has(endpoint)) {
+                throw new graph_validation_error_1.GraphValidationError(`Edge ${name(edge.from)} -> ${name(edge.to)} references ${endpoint}, which is not a node in the graph`);
+            }
+        }
+    }
+    const forwardEdges = graph.edges.filter((edge) => !edge.isBackEdge);
+    for (const members of new Set(computeSccMembership(graph, forwardEdges).values())) {
+        if (isCyclic(members, forwardEdges)) {
+            throw new graph_validation_error_1.GraphValidationError(`Nodes ${[...members].map(name).join(', ')} form a cycle with no back-edge to close it, so none of them can ever become runnable`);
+        }
+    }
+    const batchNodeIds = new Set(graph.nodes.filter((node) => node.type === 'batch').map((node) => node.id));
+    const loops = deriveLoops(graph);
+    const loopsByBatchNode = new Map(loops.map((loop) => [loop.batchNodeId, loop]));
+    for (const batchNodeId of batchNodeIds) {
+        if (!loopsByBatchNode.has(batchNodeId)) {
+            throw new graph_validation_error_1.GraphValidationError(`Batch node ${name(batchNodeId)} has no back-edge returning to it, so its loop could never advance`);
+        }
+    }
+    for (const loop of loops) {
+        const { batchNodeId, memberIds, backEdges } = loop;
+        if (!batchNodeIds.has(batchNodeId)) {
+            throw new graph_validation_error_1.GraphValidationError(`Node ${name(batchNodeId)} has a back-edge returning to it but is not a batch node`);
+        }
+        for (const memberId of memberIds) {
+            if (memberId !== batchNodeId && batchNodeIds.has(memberId)) {
+                throw new common_1.UnimplementedError(`Batch node ${name(memberId)} sits inside the loop of ${name(batchNodeId)}; nested loops are not supported yet`);
+            }
+        }
+        for (const edge of backEdges) {
+            if (edge.inputIndex !== 0) {
+                throw new graph_validation_error_1.GraphValidationError(`Back-edge ${name(edge.from)} -> ${name(edge.to)} feeds input slot ${edge.inputIndex}; returns feed the batch node's slot 0`);
+            }
+            if (!memberIds.has(edge.from)) {
+                throw new graph_validation_error_1.GraphValidationError(`Back-edge ${name(edge.from)} -> ${name(edge.to)} returns from outside the loop`);
+            }
+        }
+        if (backEdges.length > 1) {
+            throw new common_1.UnimplementedError(`Batch node ${name(batchNodeId)} has ${backEdges.length} back-edges; multiple returns converge on one input slot, which is not supported yet`);
+        }
+        for (const edge of graph.edges) {
+            if (edge.to === batchNodeId && !edge.isBackEdge && edge.inputIndex !== 0) {
+                throw new graph_validation_error_1.GraphValidationError(`Edge ${name(edge.from)} -> ${name(edge.to)} feeds input slot ${edge.inputIndex} of a batch node, which has only slot 0`);
+            }
+            if (edge.from === batchNodeId && edge.outputIndex !== 0 && edge.outputIndex !== 1) {
+                throw new graph_validation_error_1.GraphValidationError(`Edge ${name(edge.from)} -> ${name(edge.to)} leaves output slot ${edge.outputIndex} of a batch node, which has only done (0) and loop (1)`);
+            }
+        }
+        if (loop.entryEdges.length > 1) {
+            throw new common_1.UnimplementedError(`Batch node ${name(batchNodeId)} has ${loop.entryEdges.length} entry edges; converging entries on its input slot is not supported yet`);
+        }
+        for (const edge of loop.exitEdges) {
+            if (edge.from !== batchNodeId) {
+                throw new common_1.UnimplementedError(`Edge ${name(edge.from)} -> ${name(edge.to)} leaves the loop of ${name(batchNodeId)} mid-body; dangling body branches are not supported yet`);
+            }
+            if (edge.outputIndex !== 0) {
+                throw new graph_validation_error_1.GraphValidationError(`Edge ${name(edge.from)} -> ${name(edge.to)} leaves the loop from the loop slot; only the done slot (0) exits`);
+            }
+        }
+        for (const edge of graph.edges) {
+            if (edge.from === batchNodeId && edge.outputIndex === 0 && memberIds.has(edge.to)) {
+                throw new graph_validation_error_1.GraphValidationError(`Done slot of ${name(batchNodeId)} feeds ${name(edge.to)}, a member of its own loop; a node cannot run both per iteration and after the loop`);
+            }
+            if (!edge.isBackEdge &&
+                memberIds.has(edge.to) &&
+                edge.to !== batchNodeId &&
+                !memberIds.has(edge.from)) {
+                throw new graph_validation_error_1.GraphValidationError(`Edge ${name(edge.from)} -> ${name(edge.to)} enters the loop of ${name(batchNodeId)} mid-body; the batch node is the only way in`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=loops.js.map

package/dist/graph/loops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loops.js","sourceRoot":"","sources":["../../src/graph/loops.ts"],"names":[],"mappings":";;;;AAAA,sCAA+C;AAC/C,qEAAgE;AAkBhE,qBAA4B,KAAoB;IAC/C,MAAM,eAAe,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/F,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAE5C,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAE3D,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE;QAC1C,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QACvE,OAAO;YACN,WAAW;YACX,SAAS;YACT,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,KAAK,WAAW,CAAC;YAC1E,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAC7B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,KAAK,WAAW,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CACtE;YACD,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAC5B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CACrE;SACD,CAAC;IACH,CAAC,CAAC,CAAC;AACJ,CAAC;AAMD,SAAS,oBAAoB,CAAC,KAAoB,EAAE,KAAkB;IACrE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACrB,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAuB,CAAC;IAClD,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,OAAO,GAAG,CAAC,MAAc,EAAQ,EAAE;QACxC,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACjC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACnC,SAAS,IAAI,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEpB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACjB,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAE,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,CAAC,CAAC;YACxF,CAAC;iBAAM,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACjC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAE,EAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAE,CAAC,CAAC,CAAC;YACtF,CAAC;QACF,CAAC;QAED,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACvD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;YAClC,IAAI,MAAc,CAAC;YACnB,GAAG,CAAC;gBACH,MAAM,GAAG,KAAK,CAAC,GAAG,EAAG,CAAC;gBACtB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACvB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACrB,CAAC,QAAQ,MAAM,KAAK,MAAM,EAAE;YAC5B,KAAK,MAAM,EAAE,IAAI,OAAO;gBAAE,UAAU,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QACvD,CAAC;IACF,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,OAAO,UAAU,CAAC;AACnB,CAAC;AAED,SAAS,QAAQ,CAAC,OAAoB,EAAE,KAAkB;IACzD,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;IACvB,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;AACrE,CAAC;AAkBD,uBAA8B,KAAoB;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;IAKrD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,6CAAoB,CAAC,0BAA0B,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;YAC7C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,QAAQ,oCAAoC,CACtG,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAGD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpE,KAAK,MAAM,OAAO,IAAI,IAAI,GAAG,CAAC,oBAAoB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACnF,IAAI,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,6CAAoB,CAC7B,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,uFAAuF,CACjI,CAAC;QACH,CAAC;IACF,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,GAAG,CAC3B,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAC1E,CAAC;IACF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAIhF,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACxC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,6CAAoB,CAC7B,cAAc,IAAI,CAAC,WAAW,CAAC,oEAAoE,CACnG,CAAC;QACH,CAAC;IACF,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAInD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACpC,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,WAAW,CAAC,0DAA0D,CACnF,CAAC;QACH,CAAC;QAID,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YAClC,IAAI,QAAQ,KAAK,WAAW,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5D,MAAM,IAAI,2BAAkB,CAC3B,cAAc,IAAI,CAAC,QAAQ,CAAC,4BAA4B,IAAI,CAAC,WAAW,CAAC,sCAAsC,CAC/G,CAAC;YACH,CAAC;QACF,CAAC;QAGD,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,6CAAoB,CAC7B,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,qBAAqB,IAAI,CAAC,UAAU,wCAAwC,CAC5H,CAAC;YACH,CAAC;YACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC/B,MAAM,IAAI,6CAAoB,CAC7B,aAAa,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,gCAAgC,CAChF,CAAC;YACH,CAAC;QACF,CAAC;QAGD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,2BAAkB,CAC3B,cAAc,IAAI,CAAC,WAAW,CAAC,QAAQ,SAAS,CAAC,MAAM,sFAAsF,CAC7I,CAAC;QACH,CAAC;QAID,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,IAAI,CAAC,EAAE,KAAK,WAAW,IAAI,CAAC,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAC1E,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,qBAAqB,IAAI,CAAC,UAAU,yCAAyC,CACxH,CAAC;YACH,CAAC;YACD,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;gBACnF,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAuB,IAAI,CAAC,WAAW,wDAAwD,CAC1I,CAAC;YACH,CAAC;QACF,CAAC;QAID,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,2BAAkB,CAC3B,cAAc,IAAI,CAAC,WAAW,CAAC,QAAQ,IAAI,CAAC,UAAU,CAAC,MAAM,yEAAyE,CACtI,CAAC;QACH,CAAC;QAGD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBAC/B,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAuB,IAAI,CAAC,WAAW,CAAC,yDAAyD,CAC5I,CAAC;YACH,CAAC;YACD,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,mEAAmE,CAC9G,CAAC;YACH,CAAC;QACF,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAGhC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;gBACnF,MAAM,IAAI,6CAAoB,CAC7B,gBAAgB,IAAI,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,qFAAqF,CAC7I,CAAC;YACH,CAAC;YAED,IACC,CAAC,IAAI,CAAC,UAAU;gBAChB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,EAAE,KAAK,WAAW;gBACvB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EACxB,CAAC;gBACF,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,uBAAuB,IAAI,CAAC,WAAW,CAAC,8CAA8C,CACjI,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/graph/validate-executable-graph.d.ts

@@ -1,5 +1,3 @@
 import type { WorkflowGraph } from './workflow-graph';
-export declare class GraphValidationError extends Error {
-    constructor(message: string);
-}
+export declare const MAX_SLOT_INDEX = 100;
 export declare function validateExecutableGraph(graph: WorkflowGraph): void;

package/dist/graph/validate-executable-graph.js

@@ -1,24 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphValidationError = void 0;
+exports.MAX_SLOT_INDEX = void 0;
 exports.validateExecutableGraph = validateExecutableGraph;
 const common_1 = require("../common");
+const graph_validation_error_1 = require("./graph-validation.error");
 const workflow_graph_queries_1 = require("./workflow-graph-queries");
-const MAX_SLOT_INDEX = 100;
-class GraphValidationError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'GraphValidationError';
-    }
-}
-exports.GraphValidationError = GraphValidationError;
+exports.MAX_SLOT_INDEX = 100;
 function validateExecutableGraph(graph) {
     const triggers = graph.nodes.filter((node) => node.type === 'trigger');
     if (triggers.length === 0) {
-        throw new GraphValidationError('Graph has no trigger node to start from');
+        throw new graph_validation_error_1.GraphValidationError('Graph has no trigger node to start from');
     }
     if (triggers.length > 1) {
-        throw new GraphValidationError('Graph must have exactly one trigger node');
+        throw new graph_validation_error_1.GraphValidationError('Graph must have exactly one trigger node');
     }
     if (graph.edges.some((edge) => edge.isBackEdge)) {
         throw new common_1.UnimplementedError('Graphs with back-edges (loops) are not supported yet');
@@ -27,16 +21,16 @@ function validateExecutableGraph(graph) {
     const reachable = new Set([trigger.id, ...(0, workflow_graph_queries_1.getDescendantNodeIds)(graph, trigger.id)]);
     for (const edge of graph.edges) {
         if (reachable.has(edge.to) && !reachable.has(edge.from)) {
-            throw new GraphValidationError(`Edge ${edge.from} → ${edge.to} feeds a node the trigger reaches from one it cannot reach, so ${edge.to} would wait on ${edge.from} forever`);
+            throw new graph_validation_error_1.GraphValidationError(`Edge ${edge.from} -> ${edge.to} feeds a node the trigger reaches from one it cannot reach, so ${edge.to} would wait on ${edge.from} forever`);
         }
     }
     for (const edge of graph.edges) {
         for (const index of [edge.outputIndex, edge.inputIndex]) {
             if (!Number.isInteger(index) || index < 0) {
-                throw new GraphValidationError(`Edge ${edge.from} → ${edge.to} has slot index ${index}; slot indices are non-negative integers`);
+                throw new graph_validation_error_1.GraphValidationError(`Edge ${edge.from} -> ${edge.to} has slot index ${index}; slot indices are non-negative integers`);
             }
-            if (index > MAX_SLOT_INDEX) {
-                throw new GraphValidationError(`Edge ${edge.from} → ${edge.to} has slot index ${index}; slot indices above ${MAX_SLOT_INDEX} are not supported yet`);
+            if (index > exports.MAX_SLOT_INDEX) {
+                throw new graph_validation_error_1.GraphValidationError(`Edge ${edge.from} -> ${edge.to} has slot index ${index}; slot indices above ${exports.MAX_SLOT_INDEX} are not supported yet`);
             }
         }
     }

package/dist/graph/validate-executable-graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"validate-executable-graph.js","sourceRoot":"","sources":["../../src/graph/validate-executable-graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"validate-executable-graph.js","sourceRoot":"","sources":["../../src/graph/validate-executable-graph.ts"],"names":[],"mappings":";;;;AAAA,sCAA+C;AAC/C,qEAAgE;AAEhE,qEAAgE;AAEnD,QAAA,cAAc,GAAG,GAAG,CAAC;AAUlC,iCAAwC,KAAoB;IAC3D,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACvE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,6CAAoB,CAAC,yCAAyC,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,6CAAoB,CAAC,0CAA0C,CAAC,CAAC;IAC5E,CAAC;IAID,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,2BAAkB,CAAC,sDAAsD,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,GAAG,IAAA,6CAAoB,EAAC,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACpF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,kEAAkE,IAAI,CAAC,EAAE,kBAAkB,IAAI,CAAC,IAAI,UAAU,CAC7I,CAAC;QACH,CAAC;IACF,CAAC;IAID,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC3C,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,mBAAmB,KAAK,0CAA0C,CACjG,CAAC;YACH,CAAC;YACD,IAAI,KAAK,GAAG,QAAA,cAAc,EAAE,CAAC;gBAC5B,MAAM,IAAI,6CAAoB,CAC7B,QAAQ,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,mBAAmB,KAAK,wBAAwB,QAAA,cAAc,wBAAwB,CACrH,CAAC;YACH,CAAC;QACF,CAAC;IACF,CAAC;IAID,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,2BAAkB,CAC3B,QAAQ,IAAI,CAAC,EAAE,2CAA2C,IAAI,CAAC,UAAU,wDAAwD,CACjI,CAAC;QACH,CAAC;QACD,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;AACF,CAAC"}

package/dist/index.d.ts

@@ -1,12 +1,15 @@
-export { createEngineServer } from './server';
-export type { EngineServerDeps } from './server';
+export { createEngineRuntime } from './runtime';
+export type { EngineRuntime, EngineRuntimeOptions } from './runtime';
+export { InvalidIdentityTokenError, mintIdentityToken, SharedSecretIdentityVerifier, } from './auth';
+export type { AuthenticatedCaller, IdentityVerifier } from './auth';
+export type { EngineErrorResponse } from './server';
 export type { JsonObject, JsonValue } from './common';
 export type { GraphEdge, GraphNode, StepConfig, StepType, WorkflowGraph, } from './graph';
 export type { ExternalDependencies, IStepExecutor, StepExecutionContext, StepExecutionRequest, StepExecutionResult, } from './dependencies';
 export { AllowAllAdmittance, AdmittanceRejectedError } from './admittance';
 export type { AdmittanceDecision, AdmittanceRequest, AdmittanceService, } from './admittance';
-export { InMemoryWorkQueue } from './queue';
 export type { ExecutionEnqueuedEvent, OrchestrationMessage, StepSettledEvent, StepMessage, StepReadyEvent, WorkQueue, } from './queue';
-export { ExecutionNotFoundError, ExecutionStartHandler, OrchestrationWorker, StartExecutionService, StepNotFoundError, StepReadyHandler, StepSettledHandler, StepWorker, } from './execution';
-export type { ExecutionMode, ExecutionRecord, ExecutionStatus, ExecutionStore, NewExecutionRecord, NewStepRecord, StartExecutionRequest, StartExecutionResult, StepError, StepRecord, StepSlots, StepStatus, StepStore, } from './execution';
-export { createDataSource, createStores, WorkflowExecution, WorkflowStepExecution, } from './database';
+export { ExecutionNotFoundError, StepNotFoundError } from './execution';
+export type { ExecutionMode, ExecutionRecord, ExecutionStatus, ExecutionStore, NewExecutionRecord, NewStepRecord, StartExecutionRequest, StartExecutionResult, StepError, StepKey, StepKeyId, StepRecord, StepSlots, StepStatus, StepStore, TriggerOutputs, } from './execution';
+export { createDataSource, WorkflowExecution, WorkflowStepExecution } from './database';
+export type { EngineStores } from './database';

package/dist/index.js

@@ -1,25 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowStepExecution = exports.WorkflowExecution = exports.createStores = exports.createDataSource = exports.StepWorker = exports.StepSettledHandler = exports.StepReadyHandler = exports.StepNotFoundError = exports.StartExecutionService = exports.OrchestrationWorker = exports.ExecutionStartHandler = exports.ExecutionNotFoundError = exports.InMemoryWorkQueue = exports.AdmittanceRejectedError = exports.AllowAllAdmittance = exports.createEngineServer = void 0;
-var server_1 = require("./server");
-Object.defineProperty(exports, "createEngineServer", { enumerable: true, get: function () { return server_1.createEngineServer; } });
+exports.WorkflowStepExecution = exports.WorkflowExecution = exports.createDataSource = exports.StepNotFoundError = exports.ExecutionNotFoundError = exports.AdmittanceRejectedError = exports.AllowAllAdmittance = exports.SharedSecretIdentityVerifier = exports.mintIdentityToken = exports.InvalidIdentityTokenError = exports.createEngineRuntime = void 0;
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "createEngineRuntime", { enumerable: true, get: function () { return runtime_1.createEngineRuntime; } });
+var auth_1 = require("./auth");
+Object.defineProperty(exports, "InvalidIdentityTokenError", { enumerable: true, get: function () { return auth_1.InvalidIdentityTokenError; } });
+Object.defineProperty(exports, "mintIdentityToken", { enumerable: true, get: function () { return auth_1.mintIdentityToken; } });
+Object.defineProperty(exports, "SharedSecretIdentityVerifier", { enumerable: true, get: function () { return auth_1.SharedSecretIdentityVerifier; } });
 var admittance_1 = require("./admittance");
 Object.defineProperty(exports, "AllowAllAdmittance", { enumerable: true, get: function () { return admittance_1.AllowAllAdmittance; } });
 Object.defineProperty(exports, "AdmittanceRejectedError", { enumerable: true, get: function () { return admittance_1.AdmittanceRejectedError; } });
-var queue_1 = require("./queue");
-Object.defineProperty(exports, "InMemoryWorkQueue", { enumerable: true, get: function () { return queue_1.InMemoryWorkQueue; } });
 var execution_1 = require("./execution");
 Object.defineProperty(exports, "ExecutionNotFoundError", { enumerable: true, get: function () { return execution_1.ExecutionNotFoundError; } });
-Object.defineProperty(exports, "ExecutionStartHandler", { enumerable: true, get: function () { return execution_1.ExecutionStartHandler; } });
-Object.defineProperty(exports, "OrchestrationWorker", { enumerable: true, get: function () { return execution_1.OrchestrationWorker; } });
-Object.defineProperty(exports, "StartExecutionService", { enumerable: true, get: function () { return execution_1.StartExecutionService; } });
 Object.defineProperty(exports, "StepNotFoundError", { enumerable: true, get: function () { return execution_1.StepNotFoundError; } });
-Object.defineProperty(exports, "StepReadyHandler", { enumerable: true, get: function () { return execution_1.StepReadyHandler; } });
-Object.defineProperty(exports, "StepSettledHandler", { enumerable: true, get: function () { return execution_1.StepSettledHandler; } });
-Object.defineProperty(exports, "StepWorker", { enumerable: true, get: function () { return execution_1.StepWorker; } });
 var database_1 = require("./database");
 Object.defineProperty(exports, "createDataSource", { enumerable: true, get: function () { return database_1.createDataSource; } });
-Object.defineProperty(exports, "createStores", { enumerable: true, get: function () { return database_1.createStores; } });
 Object.defineProperty(exports, "WorkflowExecution", { enumerable: true, get: function () { return database_1.WorkflowExecution; } });
 Object.defineProperty(exports, "WorkflowStepExecution", { enumerable: true, get: function () { return database_1.WorkflowStepExecution; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAA8C;AAArC,4GAAA,kBAAkB,OAAA;AAqB3B,2CAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAOpD,iCAA4C;AAAnC,0GAAA,iBAAiB,OAAA;AAU1B,yCASqB;AARpB,mHAAA,sBAAsB,OAAA;AACtB,kHAAA,qBAAqB,OAAA;AACrB,gHAAA,mBAAmB,OAAA;AACnB,kHAAA,qBAAqB,OAAA;AACrB,8GAAA,iBAAiB,OAAA;AACjB,6GAAA,gBAAgB,OAAA;AAChB,+GAAA,kBAAkB,OAAA;AAClB,uGAAA,UAAU,OAAA;AAkBX,uCAKoB;AAJnB,4GAAA,gBAAgB,OAAA;AAChB,wGAAA,YAAY,OAAA;AACZ,6GAAA,iBAAiB,OAAA;AACjB,iHAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,qCAAgD;AAAvC,8GAAA,mBAAmB,OAAA;AAG5B,+BAIgB;AAHf,iHAAA,yBAAyB,OAAA;AACzB,yGAAA,iBAAiB,OAAA;AACjB,oHAAA,4BAA4B,OAAA;AAwB7B,2CAA2E;AAAlE,gHAAA,kBAAkB,OAAA;AAAE,qHAAA,uBAAuB,OAAA;AAgBpD,yCAAwE;AAA/D,mHAAA,sBAAsB,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAoBlD,uCAAwF;AAA/E,4GAAA,gBAAgB,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,iHAAA,qBAAqB,OAAA"}

package/dist/runtime/create-engine-runtime.d.ts

@@ -0,0 +1,18 @@
+import type { DataSource } from '@n8n/typeorm';
+import type { Application } from 'express';
+import type { AdmittanceService } from '../admittance';
+import type { IdentityVerifier } from '../auth/identity.types';
+import type { EngineStores } from '../database';
+import type { ExternalDependencies } from '../dependencies';
+export interface EngineRuntimeOptions {
+    dataSource: DataSource;
+    admittance: AdmittanceService;
+    identityVerifier: IdentityVerifier;
+    externalDependencies?: (stores: EngineStores) => ExternalDependencies;
+}
+export interface EngineRuntime {
+    app: Application;
+    start(): void;
+    stop(): Promise<void>;
+}
+export declare function createEngineRuntime({ dataSource, admittance, identityVerifier, externalDependencies, }: EngineRuntimeOptions): EngineRuntime;

package/dist/runtime/create-engine-runtime.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngineRuntime = createEngineRuntime;
+const database_1 = require("../database");
+const execution_1 = require("../execution");
+const queue_1 = require("../queue");
+const server_1 = require("../server");
+function createEngineRuntime({ dataSource, admittance, identityVerifier, externalDependencies, }) {
+    const orchestrationQueue = new queue_1.InMemoryWorkQueue();
+    const stepQueue = new queue_1.InMemoryWorkQueue();
+    const { executionStore, stepStore } = (0, database_1.createStores)(dataSource);
+    const orchestrationWorker = new execution_1.OrchestrationWorker(orchestrationQueue, new execution_1.ExecutionStartHandler(executionStore, stepStore, orchestrationQueue), new execution_1.StepSettledHandler(executionStore, stepStore, stepQueue, orchestrationQueue));
+    const stepWorker = new execution_1.StepWorker(stepQueue, new execution_1.StepReadyHandler(executionStore, stepStore, orchestrationQueue, externalDependencies?.({ executionStore, stepStore }) ?? {}));
+    const { app } = (0, server_1.createEngineServer)(new execution_1.StartExecutionService(admittance, executionStore, orchestrationQueue), identityVerifier);
+    return {
+        app,
+        start: () => {
+            orchestrationWorker.start();
+            stepWorker.start();
+        },
+        stop: async () => {
+            await Promise.all([orchestrationWorker.stop(), stepWorker.stop()]);
+        },
+    };
+}
+//# sourceMappingURL=create-engine-runtime.js.map

package/dist/runtime/create-engine-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-engine-runtime.js","sourceRoot":"","sources":["../../src/runtime/create-engine-runtime.ts"],"names":[],"mappings":";;;AAKA,0CAA2C;AAG3C,4CAOsB;AACtB,oCAA6C;AAE7C,sCAA+C;AAsC/C,6BAAoC,EACnC,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,oBAAoB,GACE;IACtB,MAAM,kBAAkB,GAAG,IAAI,yBAAiB,EAAwB,CAAC;IACzE,MAAM,SAAS,GAAG,IAAI,yBAAiB,EAAe,CAAC;IACvD,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,GAAG,IAAA,uBAAY,EAAC,UAAU,CAAC,CAAC;IAE/D,MAAM,mBAAmB,GAAG,IAAI,+BAAmB,CAClD,kBAAkB,EAClB,IAAI,iCAAqB,CAAC,cAAc,EAAE,SAAS,EAAE,kBAAkB,CAAC,EACxE,IAAI,8BAAkB,CAAC,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAChF,CAAC;IACF,MAAM,UAAU,GAAG,IAAI,sBAAU,CAChC,SAAS,EACT,IAAI,4BAAgB,CACnB,cAAc,EACd,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EAAE,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC,IAAI,EAAE,CAC3D,CACD,CAAC;IAEF,MAAM,EAAE,GAAG,EAAE,GAAG,IAAA,2BAAkB,EACjC,IAAI,iCAAqB,CAAC,UAAU,EAAE,cAAc,EAAE,kBAAkB,CAAC,EACzE,gBAAgB,CAChB,CAAC;IAEF,OAAO;QACN,GAAG;QAEH,KAAK,EAAE,GAAG,EAAE;YACX,mBAAmB,CAAC,KAAK,EAAE,CAAC;YAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;QACpB,CAAC;QAED,IAAI,EAAE,KAAK,IAAI,EAAE;YAIhB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACpE,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,2 @@
+export { createEngineRuntime } from './create-engine-runtime';
+export type { EngineRuntime, EngineRuntimeOptions } from './create-engine-runtime';

package/dist/runtime/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEngineRuntime = void 0;
+var create_engine_runtime_1 = require("./create-engine-runtime");
+Object.defineProperty(exports, "createEngineRuntime", { enumerable: true, get: function () { return create_engine_runtime_1.createEngineRuntime; } });
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":";;;AAAA,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA"}

package/dist/serve.js

@@ -3,36 +3,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const config_1 = require("@n8n/config");
 const di_1 = require("@n8n/di");
 const admittance_1 = require("./admittance");
+const auth_1 = require("./auth");
 const database_1 = require("./database");
-const execution_1 = require("./execution");
-const queue_1 = require("./queue");
-const server_1 = require("./server");
+const runtime_1 = require("./runtime");
 async function main() {
     const config = di_1.Container.get(config_1.EngineConfig);
-    let dataSource;
-    if (config.databaseUrl) {
-        dataSource = (0, database_1.createDataSource)(config.databaseUrl);
-        await dataSource.initialize();
-        await dataSource.runMigrations();
+    if (!config.databaseUrl) {
+        throw new Error('engine: N8N_ENGINE_DATABASE_URL is not set');
     }
-    else {
-        console.warn('engine: N8N_ENGINE_DATABASE_URL not set; running in healthcheck-only mode (workflow execution endpoints disabled)');
+    if (!config.authSecret) {
+        throw new Error('engine: N8N_ENGINE_AUTH_SECRET is not set');
     }
-    const orchestrationQueue = new queue_1.InMemoryWorkQueue();
-    const stepQueue = new queue_1.InMemoryWorkQueue();
-    let orchestrationWorker;
-    let stepWorker;
-    if (dataSource) {
-        const { executionStore, stepStore } = (0, database_1.createStores)(dataSource);
-        orchestrationWorker = new execution_1.OrchestrationWorker(orchestrationQueue, new execution_1.ExecutionStartHandler(executionStore, stepStore, orchestrationQueue), new execution_1.StepSettledHandler(executionStore, stepStore, stepQueue, orchestrationQueue));
-        stepWorker = new execution_1.StepWorker(stepQueue, new execution_1.StepReadyHandler(executionStore, stepStore, orchestrationQueue, {}));
-        orchestrationWorker.start();
-        stepWorker.start();
-    }
-    const { app } = (0, server_1.createEngineServer)(dataSource
-        ? { dataSource, admittance: new admittance_1.AllowAllAdmittance(), workQueue: orchestrationQueue }
-        : undefined);
-    const server = app.listen(config.port, config.host, () => {
+    const dataSource = (0, database_1.createDataSource)(config.databaseUrl);
+    await dataSource.initialize();
+    await dataSource.runMigrations();
+    const runtime = (0, runtime_1.createEngineRuntime)({
+        dataSource,
+        admittance: new admittance_1.AllowAllAdmittance(),
+        identityVerifier: new auth_1.SharedSecretIdentityVerifier(config.authSecret),
+    });
+    runtime.start();
+    const server = runtime.app.listen(config.port, config.host, () => {
         console.log(`engine: listening on http://${config.host}:${config.port}`);
     });
     let shuttingDown = false;
@@ -44,11 +35,8 @@ async function main() {
         await new Promise((resolve, reject) => {
             server.close((error) => (error ? reject(error) : resolve()));
         });
-        if (orchestrationWorker)
-            await orchestrationWorker.stop();
-        if (stepWorker)
-            await stepWorker.stop();
-        if (dataSource?.isInitialized)
+        await runtime.stop();
+        if (dataSource.isInitialized)
             await dataSource.destroy();
         process.exit(0);
     };

package/dist/serve.js.map

@@ -1 +1 @@
-{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../src/serve.ts"],"names":[],"mappings":";;AAAA,wCAA2C;AAC3C,gCAAoC;AAEpC,6CAAkD;AAClD,iCAAsD;AACtD,yCAA8C;AAC9C,uCAAgD;AAEhD,KAAK,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,cAAS,CAAC,GAAG,CAAC,qBAAY,CAAC,CAAC;IAI3C,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,UAAU,GAAG,IAAA,2BAAgB,EAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACxD,MAAM,UAAU,CAAC,UAAU,EAAE,CAAC;IAC9B,MAAM,UAAU,CAAC,aAAa,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAG,IAAA,6BAAmB,EAAC;QACnC,UAAU;QACV,UAAU,EAAE,IAAI,+BAAkB,EAAE;QACpC,gBAAgB,EAAE,IAAI,mCAA4B,CAAC,MAAM,CAAC,UAAU,CAAC;KACrE,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,EAAE,CAAC;IAEhB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;QAChE,OAAO,CAAC,GAAG,CAAC,+BAA+B,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,KAAK,EAAE,MAAc,EAAiB,EAAE;QACxD,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,iBAAiB,CAAC,CAAC;QACzD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,IAAI,UAAU,CAAC,aAAa;YAAE,MAAM,UAAU,CAAC,OAAO,EAAE,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAQ,EAAE;QACzC,QAAQ,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzC,OAAO,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC/B,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;IAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/server/create-engine-server.d.ts

@@ -1,12 +1,6 @@
-import type { DataSource } from '@n8n/typeorm';
 import { type Application } from 'express';
-import type { AdmittanceService } from '../admittance';
-import type { OrchestrationMessage, WorkQueue } from '../queue';
-export interface EngineServerDeps {
-    dataSource: DataSource;
-    admittance: AdmittanceService;
-    workQueue: WorkQueue<OrchestrationMessage>;
-}
-export declare function createEngineServer(deps?: EngineServerDeps): {
+import type { IdentityVerifier } from '../auth/identity.types';
+import type { StartExecutionService } from '../execution/start-execution.service';
+export declare function createEngineServer(startExecution: StartExecutionService, identityVerifier: IdentityVerifier): {
     app: Application;
 };

package/dist/server/create-engine-server.js

@@ -5,20 +5,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEngineServer = createEngineServer;
 const express_1 = __importDefault(require("express"));
-const database_1 = require("../database");
-const start_execution_service_1 = require("../execution/start-execution.service");
+const authenticate_1 = require("../auth/authenticate");
 const workflow_executions_1 = require("./routes/workflow-executions");
-function createEngineServer(deps) {
+function createEngineServer(startExecution, identityVerifier) {
     const app = (0, express_1.default)();
-    app.use(express_1.default.json());
     app.get('/healthz', (_req, res) => {
         res.status(200).json({ status: 'ok' });
     });
-    if (deps) {
-        const executionStore = new database_1.TypeOrmExecutionStore(deps.dataSource.getRepository(database_1.WorkflowExecution));
-        const startExecution = new start_execution_service_1.StartExecutionService(deps.admittance, executionStore, deps.workQueue);
-        app.use('/api/workflow-executions', (0, workflow_executions_1.createWorkflowExecutionsRouter)(startExecution));
-    }
+    app.use('/api', (0, authenticate_1.createAuthenticationMiddleware)(identityVerifier));
+    app.use('/api', express_1.default.json());
+    app.use('/api/workflow-executions', (0, workflow_executions_1.createWorkflowExecutionsRouter)(startExecution));
     return { app };
 }
 //# sourceMappingURL=create-engine-server.js.map

package/dist/server/create-engine-server.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-engine-server.js","sourceRoot":"","sources":["../../src/server/create-engine-server.ts"],"names":[],"mappings":";;;;;;AACA,sDAAoD;AAGpD,0CAAuE;AACvE,kFAA6E;AAE7E,sEAA8E;AAa9E,4BAAmC,IAAuB;IACzD,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;IACtB,GAAG,CAAC,GAAG,CAAC,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAExB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,IAAI,EAAE,CAAC;QACV,MAAM,cAAc,GAAG,IAAI,gCAAqB,CAC/C,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,4BAAiB,CAAC,CAChD,CAAC;QACF,MAAM,cAAc,GAAG,IAAI,+CAAqB,CAC/C,IAAI,CAAC,UAAU,EACf,cAAc,EACd,IAAI,CAAC,SAAS,CACd,CAAC;QACF,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAA,oDAA8B,EAAC,cAAc,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,CAAC;AAChB,CAAC"}
+{"version":3,"file":"create-engine-server.js","sourceRoot":"","sources":["../../src/server/create-engine-server.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAoD;AAEpD,uDAAsE;AAGtE,sEAA8E;AAG9E,4BACC,cAAqC,EACrC,gBAAkC;IAElC,MAAM,GAAG,GAAG,IAAA,iBAAO,GAAE,CAAC;IAGtB,GAAG,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACjC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAGH,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,IAAA,6CAA8B,EAAC,gBAAgB,CAAC,CAAC,CAAC;IAClE,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,iBAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,GAAG,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAA,oDAA8B,EAAC,cAAc,CAAC,CAAC,CAAC;IAEpF,OAAO,EAAE,GAAG,EAAE,CAAC;AAChB,CAAC"}

package/dist/server/error-response.d.ts

@@ -0,0 +1,7 @@
+import type { Response } from 'express';
+export interface EngineErrorResponse {
+    error: string;
+    reason?: string;
+    details?: unknown;
+}
+export declare function fail(res: Response, status: number, body: EngineErrorResponse): void;

package/dist/server/error-response.js

@@ -0,0 +1,12 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fail = fail;
+const node_assert_1 = __importDefault(require("node:assert"));
+function fail(res, status, body) {
+    (0, node_assert_1.default)(status >= 400, `fail() sends error responses only, but got status ${status}`);
+    res.status(status).json(body);
+}
+//# sourceMappingURL=error-response.js.map

package/dist/server/error-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-response.js","sourceRoot":"","sources":["../../src/server/error-response.ts"],"names":[],"mappings":";;;;;;AACA,8DAAiC;AAiBjC,cAAqB,GAAa,EAAE,MAAc,EAAE,IAAyB;IAC5E,IAAA,qBAAM,EAAC,MAAM,IAAI,GAAG,EAAE,qDAAqD,MAAM,EAAE,CAAC,CAAC;IACrF,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC"}

package/dist/server/index.d.ts

@@ -1,2 +1,3 @@
 export { createEngineServer } from './create-engine-server';
-export type { EngineServerDeps } from './create-engine-server';
+export { fail } from './error-response';
+export type { EngineErrorResponse } from './error-response';

package/dist/server/index.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createEngineServer = void 0;
+exports.fail = exports.createEngineServer = void 0;
 var create_engine_server_1 = require("./create-engine-server");
 Object.defineProperty(exports, "createEngineServer", { enumerable: true, get: function () { return create_engine_server_1.createEngineServer; } });
+var error_response_1 = require("./error-response");
+Object.defineProperty(exports, "fail", { enumerable: true, get: function () { return error_response_1.fail; } });
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;AAAA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";;;AAAA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,mDAAwC;AAA/B,sGAAA,IAAI,OAAA"}