n8n-workflow 2.42.3 → 2.42.4

package/dist/cjs/nodes-api-version.d.ts

@@ -1,33 +1,24 @@
 import { N8N_NODES_API_VERSION } from '@n8n/constants';
-export { N8N_NODES_API_VERSION };
+import { formatNodesApiLevel, parseNodesApiLevel } from '@n8n/utils/nodes-api-level';
+export { N8N_NODES_API_VERSION, formatNodesApiLevel, parseNodesApiLevel };
 /** Minimal package.json shape needed to check node API compatibility. */
 export interface NodesApiVersionPackageJson {
     n8n?: {
-        /**
-         * Node-authoring API level the package requires. Absent in legacy
-         * packages, which are treated as requiring level 1.
-         */
         n8nNodesApiVersion?: unknown;
     };
 }
 export type NodesApiVersionCheck = {
     compatible: true;
-    /** Effective required API level; 1 for packages without metadata. */
-    version: number;
 } | {
     compatible: false;
-    reason: 'malformed' | 'unsupported';
-    /** The declared value, as read from package.json. */
+    reason: 'malformed';
     declared: unknown;
+} | {
+    compatible: false;
+    reason: 'unsupported';
+    declared: unknown;
+    /** As `<major>.<minor>`, for messages and metadata. */
+    required: string;
 };
-/**
- * Read a community package's declared node-authoring API level and check it
- * against the level this runtime supports (`required <= N8N_NODES_API_VERSION`).
- *
- * Missing `n8n.n8nNodesApiVersion` means a legacy package and resolves to
- * level 1. Malformed values (non-integer, non-positive, non-number) are
- * reported as incompatible — the runtime cannot distinguish an old package
- * from a corrupt or hostile one if both fall back to legacy.
- */
 export declare function checkNodesApiVersion(pkgJson: NodesApiVersionPackageJson): NodesApiVersionCheck;
 //# sourceMappingURL=nodes-api-version.d.ts.map

package/dist/cjs/nodes-api-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes-api-version.d.ts","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IAC1C,GAAG,CAAC,EAAE;QACL;;;WAGG;QACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;CACF;AAED,MAAM,MAAM,oBAAoB,GAC7B;IACA,UAAU,EAAE,IAAI,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACf,GACD;IACA,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;CACjB,CAAC;AAEL;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,0BAA0B,GAAG,oBAAoB,CAgB9F"}
+{"version":3,"file":"nodes-api-version.d.ts","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;AAE1E,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IAC1C,GAAG,CAAC,EAAE;QACL,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;CACF;AAED,MAAM,MAAM,oBAAoB,GAC7B;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,GACpB;IACA,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACjB,GACD;IACA,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAChB,CAAC;AAWL,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,0BAA0B,GAAG,oBAAoB,CAgB9F"}

package/dist/cjs/nodes-api-version.js

@@ -1,29 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.N8N_NODES_API_VERSION = void 0;
+exports.parseNodesApiLevel = exports.formatNodesApiLevel = exports.N8N_NODES_API_VERSION = void 0;
 exports.checkNodesApiVersion = checkNodesApiVersion;
 const constants_1 = require("@n8n/constants");
 Object.defineProperty(exports, "N8N_NODES_API_VERSION", { enumerable: true, get: function () { return constants_1.N8N_NODES_API_VERSION; } });
-/**
- * Read a community package's declared node-authoring API level and check it
- * against the level this runtime supports (`required <= N8N_NODES_API_VERSION`).
- *
- * Missing `n8n.n8nNodesApiVersion` means a legacy package and resolves to
- * level 1. Malformed values (non-integer, non-positive, non-number) are
- * reported as incompatible — the runtime cannot distinguish an old package
- * from a corrupt or hostile one if both fall back to legacy.
- */
+const nodes_api_level_1 = require("@n8n/utils/nodes-api-level");
+Object.defineProperty(exports, "formatNodesApiLevel", { enumerable: true, get: function () { return nodes_api_level_1.formatNodesApiLevel; } });
+Object.defineProperty(exports, "parseNodesApiLevel", { enumerable: true, get: function () { return nodes_api_level_1.parseNodesApiLevel; } });
+function supportedLevel() {
+    const level = (0, nodes_api_level_1.parseNodesApiLevel)(constants_1.N8N_NODES_API_VERSION);
+    if (level === null)
+        throw new Error(`N8N_NODES_API_VERSION is not a level: ${constants_1.N8N_NODES_API_VERSION}`);
+    return level;
+}
+// A missing declaration is a legacy package at level 1. A malformed one is
+// incompatible: the runtime cannot tell an old package from a corrupt one.
 function checkNodesApiVersion(pkgJson) {
     const declared = pkgJson?.n8n?.n8nNodesApiVersion;
-    if (declared === undefined) {
-        return { compatible: true, version: 1 };
-    }
-    if (typeof declared !== 'number' || !Number.isInteger(declared) || declared < 1) {
+    if (declared === undefined)
+        return { compatible: true };
+    const required = (0, nodes_api_level_1.parseNodesApiLevel)(declared);
+    if (required === null)
         return { compatible: false, reason: 'malformed', declared };
-    }
-    if (declared <= constants_1.N8N_NODES_API_VERSION) {
-        return { compatible: true, version: declared };
-    }
-    return { compatible: false, reason: 'unsupported', declared };
+    if (required.compare(supportedLevel()) <= 0)
+        return { compatible: true };
+    return {
+        compatible: false,
+        reason: 'unsupported',
+        declared,
+        required: (0, nodes_api_level_1.formatNodesApiLevel)(required),
+    };
 }
 //# sourceMappingURL=nodes-api-version.js.map

package/dist/cjs/nodes-api-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodes-api-version.js","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":";;;;AAAA,8CAAuD;sGAA9C,iCAAqB;AA4B9B;;;;;;;;GAQG;AACH,8BAAqC,OAAmC;IACvE,MAAM,QAAQ,GAAG,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC;IAElD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,QAAQ,IAAI,iCAAqB,EAAE,CAAC;QACvC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"nodes-api-version.js","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":";;;;AAAA,8CAAuD;sGAA9C,iCAAqB;AAC9B,gEAAqF;oGAA5E,qCAAmB;mGAAE,oCAAkB;AA0BhD,SAAS,cAAc;IACtB,MAAM,KAAK,GAAG,IAAA,oCAAkB,EAAC,iCAAqB,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,IAAI;QACjB,MAAM,IAAI,KAAK,CAAC,yCAAyC,iCAAqB,EAAE,CAAC,CAAC;IACnF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,2EAA2E;AAC3E,2EAA2E;AAC3E,8BAAqC,OAAmC;IACvE,MAAM,QAAQ,GAAG,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC;IAElD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAExD,MAAM,QAAQ,GAAG,IAAA,oCAAkB,EAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAEnF,IAAI,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAEzE,OAAO;QACN,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,aAAa;QACrB,QAAQ;QACR,QAAQ,EAAE,IAAA,qCAAmB,EAAC,QAAQ,CAAC;KACvC,CAAC;AACH,CAAC"}

package/dist/esm/nodes-api-version.d.ts

@@ -1,33 +1,24 @@
 import { N8N_NODES_API_VERSION } from '@n8n/constants';
-export { N8N_NODES_API_VERSION };
+import { formatNodesApiLevel, parseNodesApiLevel } from '@n8n/utils/nodes-api-level';
+export { N8N_NODES_API_VERSION, formatNodesApiLevel, parseNodesApiLevel };
 /** Minimal package.json shape needed to check node API compatibility. */
 export interface NodesApiVersionPackageJson {
     n8n?: {
-        /**
-         * Node-authoring API level the package requires. Absent in legacy
-         * packages, which are treated as requiring level 1.
-         */
         n8nNodesApiVersion?: unknown;
     };
 }
 export type NodesApiVersionCheck = {
     compatible: true;
-    /** Effective required API level; 1 for packages without metadata. */
-    version: number;
 } | {
     compatible: false;
-    reason: 'malformed' | 'unsupported';
-    /** The declared value, as read from package.json. */
+    reason: 'malformed';
     declared: unknown;
+} | {
+    compatible: false;
+    reason: 'unsupported';
+    declared: unknown;
+    /** As `<major>.<minor>`, for messages and metadata. */
+    required: string;
 };
-/**
- * Read a community package's declared node-authoring API level and check it
- * against the level this runtime supports (`required <= N8N_NODES_API_VERSION`).
- *
- * Missing `n8n.n8nNodesApiVersion` means a legacy package and resolves to
- * level 1. Malformed values (non-integer, non-positive, non-number) are
- * reported as incompatible — the runtime cannot distinguish an old package
- * from a corrupt or hostile one if both fall back to legacy.
- */
 export declare function checkNodesApiVersion(pkgJson: NodesApiVersionPackageJson): NodesApiVersionCheck;
 //# sourceMappingURL=nodes-api-version.d.ts.map

package/dist/esm/nodes-api-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nodes-api-version.d.ts","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IAC1C,GAAG,CAAC,EAAE;QACL;;;WAGG;QACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;CACF;AAED,MAAM,MAAM,oBAAoB,GAC7B;IACA,UAAU,EAAE,IAAI,CAAC;IACjB,qEAAqE;IACrE,OAAO,EAAE,MAAM,CAAC;CACf,GACD;IACA,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;CACjB,CAAC;AAEL;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,0BAA0B,GAAG,oBAAoB,CAgB9F"}
+{"version":3,"file":"nodes-api-version.d.ts","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;AAE1E,yEAAyE;AACzE,MAAM,WAAW,0BAA0B;IAC1C,GAAG,CAAC,EAAE;QACL,kBAAkB,CAAC,EAAE,OAAO,CAAC;KAC7B,CAAC;CACF;AAED,MAAM,MAAM,oBAAoB,GAC7B;IAAE,UAAU,EAAE,IAAI,CAAA;CAAE,GACpB;IACA,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACjB,GACD;IACA,UAAU,EAAE,KAAK,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC;CAChB,CAAC;AAWL,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,0BAA0B,GAAG,oBAAoB,CAgB9F"}

package/dist/esm/nodes-api-version.js

@@ -1,25 +1,28 @@
 import { N8N_NODES_API_VERSION } from '@n8n/constants';
-export { N8N_NODES_API_VERSION };
-/**
- * Read a community package's declared node-authoring API level and check it
- * against the level this runtime supports (`required <= N8N_NODES_API_VERSION`).
- *
- * Missing `n8n.n8nNodesApiVersion` means a legacy package and resolves to
- * level 1. Malformed values (non-integer, non-positive, non-number) are
- * reported as incompatible — the runtime cannot distinguish an old package
- * from a corrupt or hostile one if both fall back to legacy.
- */
+import { formatNodesApiLevel, parseNodesApiLevel } from '@n8n/utils/nodes-api-level';
+export { N8N_NODES_API_VERSION, formatNodesApiLevel, parseNodesApiLevel };
+function supportedLevel() {
+    const level = parseNodesApiLevel(N8N_NODES_API_VERSION);
+    if (level === null)
+        throw new Error(`N8N_NODES_API_VERSION is not a level: ${N8N_NODES_API_VERSION}`);
+    return level;
+}
+// A missing declaration is a legacy package at level 1. A malformed one is
+// incompatible: the runtime cannot tell an old package from a corrupt one.
 export function checkNodesApiVersion(pkgJson) {
     const declared = pkgJson?.n8n?.n8nNodesApiVersion;
-    if (declared === undefined) {
-        return { compatible: true, version: 1 };
-    }
-    if (typeof declared !== 'number' || !Number.isInteger(declared) || declared < 1) {
+    if (declared === undefined)
+        return { compatible: true };
+    const required = parseNodesApiLevel(declared);
+    if (required === null)
         return { compatible: false, reason: 'malformed', declared };
-    }
-    if (declared <= N8N_NODES_API_VERSION) {
-        return { compatible: true, version: declared };
-    }
-    return { compatible: false, reason: 'unsupported', declared };
+    if (required.compare(supportedLevel()) <= 0)
+        return { compatible: true };
+    return {
+        compatible: false,
+        reason: 'unsupported',
+        declared,
+        required: formatNodesApiLevel(required),
+    };
 }
 //# sourceMappingURL=nodes-api-version.js.map

package/dist/esm/nodes-api-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"nodes-api-version.js","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,qBAAqB,EAAE,CAAC;AA0BjC;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAmC;IACvE,MAAM,QAAQ,GAAG,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC;IAElD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACjF,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAC7D,CAAC;IAED,IAAI,QAAQ,IAAI,qBAAqB,EAAE,CAAC;QACvC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAChD,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC;AAC/D,CAAC"}
+{"version":3,"file":"nodes-api-version.js","sourceRoot":"","sources":["../../src/nodes-api-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErF,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;AAwB1E,SAAS,cAAc;IACtB,MAAM,KAAK,GAAG,kBAAkB,CAAC,qBAAqB,CAAC,CAAC;IACxD,IAAI,KAAK,KAAK,IAAI;QACjB,MAAM,IAAI,KAAK,CAAC,yCAAyC,qBAAqB,EAAE,CAAC,CAAC;IACnF,OAAO,KAAK,CAAC;AACd,CAAC;AAED,2EAA2E;AAC3E,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAAC,OAAmC;IACvE,MAAM,QAAQ,GAAG,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC;IAElD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAExD,MAAM,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IAEnF,IAAI,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAEzE,OAAO;QACN,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,aAAa;QACrB,QAAQ;QACR,QAAQ,EAAE,mBAAmB,CAAC,QAAQ,CAAC;KACvC,CAAC;AACH,CAAC"}