n8n-workflow 2.20.1 → 2.21.1

package/dist/esm/utils.d.ts

@@ -66,6 +66,7 @@ export declare function updateDisplayOptions(displayOptions: IDisplayOptions, pr
     hint?: string;
     builderHint?: import("./interfaces").IParameterBuilderHint;
     disabledOptions?: IDisplayOptions;
+    envFeatureFlag?: Uppercase<string>;
     options?: Array<import("./interfaces").INodePropertyOptions | INodeProperties | import("./interfaces").INodePropertyCollection>;
     placeholder?: string;
     isNodeSetting?: boolean;

package/dist/esm/utils.d.ts.map

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

package/dist/esm/workflow-structure-validation.d.ts

@@ -0,0 +1,99 @@
+import { z } from 'zod';
+declare const workflowStructureSchema: z.ZodObject<{
+    nodes: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+        typeVersion: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        name: z.ZodString;
+        type: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+        typeVersion: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        name: z.ZodString;
+        type: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+        typeVersion: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">>, "many">;
+    connections: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodArray<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        node: z.ZodString;
+        type: z.ZodString;
+        index: z.ZodNumber;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        node: z.ZodString;
+        type: z.ZodString;
+        index: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        node: z.ZodString;
+        type: z.ZodString;
+        index: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">>, "many">>>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    nodes: z.objectOutputType<{
+        name: z.ZodString;
+        type: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+        typeVersion: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">[];
+    connections: Record<string, Record<string, (z.objectOutputType<{
+        node: z.ZodString;
+        type: z.ZodString;
+        index: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">[] | null | undefined)[]>>;
+}, {
+    nodes: z.objectInputType<{
+        name: z.ZodString;
+        type: z.ZodString;
+        position: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+        parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        id: z.ZodOptional<z.ZodString>;
+        typeVersion: z.ZodOptional<z.ZodNumber>;
+        disabled: z.ZodOptional<z.ZodBoolean>;
+    }, z.ZodTypeAny, "passthrough">[];
+    connections: Record<string, Record<string, (z.objectInputType<{
+        node: z.ZodString;
+        type: z.ZodString;
+        index: z.ZodNumber;
+    }, z.ZodTypeAny, "passthrough">[] | null | undefined)[]>>;
+}>;
+type WorkflowStructureData = z.infer<typeof workflowStructureSchema>;
+type WorkflowStructureGraphIssueCode = 'duplicate_node_name' | 'unknown_connection_source' | 'unknown_connection_target';
+type WorkflowStructureGraphIssue = {
+    code: WorkflowStructureGraphIssueCode;
+    path: Array<string | number>;
+    message: string;
+};
+export type WorkflowStructureIssue = z.ZodIssue | WorkflowStructureGraphIssue;
+type WorkflowStructureValidationSuccess = {
+    success: true;
+    data: WorkflowStructureData;
+};
+type WorkflowStructureValidationFailure = {
+    success: false;
+    issues: WorkflowStructureIssue[];
+};
+export type WorkflowStructureValidationResult = WorkflowStructureValidationSuccess | WorkflowStructureValidationFailure;
+export declare const formatWorkflowStructureIssuePath: (path: Array<string | number>) => string;
+export declare class WorkflowStructureValidationError extends Error {
+    readonly issues: WorkflowStructureIssue[];
+    name: string;
+    readonly description: string;
+    constructor(issues: WorkflowStructureIssue[]);
+}
+export declare function safeParseWorkflowStructure(input: unknown): WorkflowStructureValidationResult;
+export declare function parseWorkflowStructure(input: unknown): WorkflowStructureData;
+export {};
+//# sourceMappingURL=workflow-structure-validation.d.ts.map

package/dist/esm/workflow-structure-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-structure-validation.d.ts","sourceRoot":"","sources":["../../src/workflow-structure-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA2DxB,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAG3B,CAAC;AAEH,KAAK,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAErE,KAAK,+BAA+B,GACjC,qBAAqB,GACrB,2BAA2B,GAC3B,2BAA2B,CAAC;AAE/B,KAAK,2BAA2B,GAAG;IAClC,IAAI,EAAE,+BAA+B,CAAC;IACtC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,QAAQ,GAAG,2BAA2B,CAAC;AAE9E,KAAK,kCAAkC,GAAG;IACzC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,qBAAqB,CAAC;CAC5B,CAAC;AAEF,KAAK,kCAAkC,GAAG;IACzC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,sBAAsB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAC1C,kCAAkC,GAClC,kCAAkC,CAAC;AAEtC,eAAO,MAAM,gCAAgC,GAAI,MAAM,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,KAAG,MAO/E,CAAC;AAOF,qBAAa,gCAAiC,SAAQ,KAAK;IAK9C,QAAQ,CAAC,MAAM,EAAE,sBAAsB,EAAE;IAJ5C,IAAI,SAAsC;IAEnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAER,MAAM,EAAE,sBAAsB,EAAE;CAIrD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,iCAAiC,CAqE5F;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CAQ5E"}

package/dist/esm/workflow-structure-validation.js

@@ -0,0 +1,145 @@
+import { z } from 'zod';
+/**
+ * Workflow Structure Validation
+ *
+ * Single source of truth for validating workflow **structure** — the minimum
+ * shape that the editor and runtime assume is always present and correctly
+ * formed. Intentionally separate from activation/publish validation
+ * (WorkflowValidationService) which checks semantic correctness (trigger
+ * presence, known node types, credential issues, etc.).
+ *
+ * Lives in n8n-workflow so it can be shared by:
+ *   - Backend: create/update/import reject malformed payloads (400)
+ *   - Frontend: open path warns but still renders; import path blocks
+ *
+ * Validates:
+ *   - Required node fields (name, type, position)
+ *   - Position is a 2-number tuple
+ *   - Connection entries have valid node/type/index
+ *   - No duplicate node names
+ *   - Connection source/target keys reference existing nodes
+ *
+ * Does NOT validate:
+ *   - Whether a node type is installed
+ *   - Node parameter correctness
+ *   - Credential validity
+ *   - Activation readiness
+ *
+ */
+const workflowNodeStructureSchema = z
+    .object({
+    name: z.string().min(1),
+    type: z.string().min(1),
+    position: z.tuple([z.number(), z.number()]),
+    parameters: z.record(z.string(), z.unknown()).optional(),
+    id: z.string().optional(),
+    typeVersion: z.number().optional(),
+    disabled: z.boolean().optional(),
+})
+    .passthrough();
+const connectionEntrySchema = z
+    .object({
+    node: z.string().min(1),
+    type: z.string().min(1),
+    index: z.number().int().min(0),
+})
+    .passthrough();
+// Buckets can be null when a multi-output node has unused output slots.
+// Matches NodeInputConnections type.
+const connectionBucketSchema = z.array(connectionEntrySchema).nullable().optional();
+const workflowConnectionsStructureSchema = z.record(z.string(), z.record(z.string(), z.array(connectionBucketSchema)));
+const workflowStructureSchema = z.object({
+    nodes: z.array(workflowNodeStructureSchema),
+    connections: workflowConnectionsStructureSchema,
+});
+export const formatWorkflowStructureIssuePath = (path) => {
+    if (path.length === 0)
+        return 'workflow';
+    return path.reduce((acc, segment) => {
+        if (typeof segment === 'number')
+            return `${acc}[${segment}]`;
+        return acc ? `${acc}.${segment}` : segment;
+    }, '');
+};
+const formatIssuesDescription = (issues) => issues
+    .map(({ path, message }) => `${formatWorkflowStructureIssuePath(path)}: ${message}`)
+    .join('\n');
+export class WorkflowStructureValidationError extends Error {
+    issues;
+    name = 'WorkflowStructureValidationError';
+    description;
+    constructor(issues) {
+        super('Invalid workflow structure');
+        this.issues = issues;
+        this.description = formatIssuesDescription(issues);
+    }
+}
+export function safeParseWorkflowStructure(input) {
+    const parsed = workflowStructureSchema.safeParse(input);
+    if (!parsed.success) {
+        return {
+            success: false,
+            issues: parsed.error.issues,
+        };
+    }
+    const { nodes, connections } = parsed.data;
+    const issues = [];
+    const nodeNames = new Set();
+    for (const [index, node] of nodes.entries()) {
+        if (nodeNames.has(node.name)) {
+            issues.push({
+                path: ['nodes', index, 'name'],
+                message: `Duplicate node name "${node.name}"`,
+                code: 'duplicate_node_name',
+            });
+            continue;
+        }
+        nodeNames.add(node.name);
+    }
+    for (const sourceNodeName of Object.keys(connections)) {
+        if (!nodeNames.has(sourceNodeName)) {
+            issues.push({
+                path: ['connections', sourceNodeName],
+                message: `Connection source "${sourceNodeName}" does not reference an existing node`,
+                code: 'unknown_connection_source',
+            });
+        }
+        const connectionTypes = connections[sourceNodeName];
+        for (const connectionType of Object.keys(connectionTypes)) {
+            const buckets = connectionTypes[connectionType];
+            for (const [sourceIndex, bucket] of buckets.entries()) {
+                for (const [targetIndex, connection] of (bucket ?? []).entries()) {
+                    if (!nodeNames.has(connection.node)) {
+                        issues.push({
+                            path: [
+                                'connections',
+                                sourceNodeName,
+                                connectionType,
+                                sourceIndex,
+                                targetIndex,
+                                'node',
+                            ],
+                            message: `Connection target "${connection.node}" does not reference an existing node`,
+                            code: 'unknown_connection_target',
+                        });
+                    }
+                }
+            }
+        }
+    }
+    if (issues.length > 0) {
+        return { success: false, issues };
+    }
+    return {
+        success: true,
+        data: parsed.data,
+    };
+}
+export function parseWorkflowStructure(input) {
+    const result = safeParseWorkflowStructure(input);
+    if (!result.success) {
+        throw new WorkflowStructureValidationError(result.issues);
+    }
+    return result.data;
+}
+//# sourceMappingURL=workflow-structure-validation.js.map

package/dist/esm/workflow-structure-validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-workflow",
-  "version": "2.20.1",
+  "version": "2.21.1",
   "description": "Workflow base code of n8n",
   "types": "dist/esm/index.d.ts",
   "module": "dist/esm/index.js",
@@ -34,9 +34,9 @@
     "vitest": "^4.1.1",
     "vitest-mock-extended": "^3.1.0",
     "zod": "3.25.67",
-    "@n8n/config": "2.19.1",
     "@n8n/typescript-config": "1.4.0",
-    "@n8n/vitest-config": "1.10.0"
+    "@n8n/vitest-config": "1.10.0",
+    "@n8n/config": "2.20.0"
   },
   "dependencies": {
     "ast-types": "0.16.1",
@@ -56,8 +56,8 @@
     "xml2js": "0.6.2",
     "jsonrepair": "3.13.2",
     "@n8n/errors": "0.8.0",
-    "@n8n/tournament": "1.1.0",
-    "@n8n/expression-runtime": "0.12.1"
+    "@n8n/expression-runtime": "0.13.1",
+    "@n8n/tournament": "1.1.1"
   },
   "peerDependencies": {
     "zod": ">=3.25.0 <4"