n8n-workflow 2.44.1 → 2.45.0

package/dist/cjs/dynamic-credentials-helpers.d.ts

@@ -16,18 +16,27 @@ export declare function runDataAttemptedDynamicCredentials(runData: IRunData | u
  * Summarizes a run's private-credential usage so a sub-execution can report it to its caller.
  * Credentials resolve under the sub-workflow's own context, so the parent would otherwise never
  * flag that its embedded output used a private credential; recurses via the child's task flags.
+ *
+ * Also reports `usedCredentialIds`: every credential the run's workflows reference, private or
+ * not, which credential usability redaction reads.
  */
-export declare function summarizeDynamicCredentialsUsage(executionData: IRunExecutionData | undefined): DynamicCredentialsUsage;
+export declare function summarizeDynamicCredentialsUsage(executionData: IRunExecutionData | undefined, 
+/** The credentials the run's own workflow references. */
+workflowCredentialIds?: readonly string[]): DynamicCredentialsUsage;
+/** The credentials sub-workflows reported onto the run's tasks. */
+export declare function runDataUsedCredentialIds(runData: IRunData | undefined): string[];
 /** The per-node dynamic-credential flags carried on `IWorkflowExecuteAdditionalData`. */
 interface DynamicCredentialsUsageTarget {
     currentNodeUsedDynamicCredentials?: boolean;
     currentNodeAttemptedDynamicCredentials?: boolean;
     dynamicCredentialsResolvedUserId?: string;
+    currentNodeUsedCredentialIds?: string[];
 }
 /**
  * Applies a reported usage summary onto the per-node flags additively (flags only ever get set,
  * matching the other flag writers — the engine resets them per node). Resolved user id is
- * execution-scoped, so a present value wins (matches credential resolution).
+ * execution-scoped, so a present value wins (matches credential resolution). The plain
+ * credential ids are joined with the ones the node already collected.
  */
 export declare function applyDynamicCredentialsUsage(target: DynamicCredentialsUsageTarget, usage: DynamicCredentialsUsage): void;
 /**

package/dist/cjs/dynamic-credentials-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dynamic-credentials-helpers.d.ts","sourceRoot":"","sources":["../../src/dynamic-credentials-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAMpF;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAIzF;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAC/C,aAAa,EAAE,iBAAiB,GAAG,SAAS,GAC1C,uBAAuB,CAiBzB;AAED,yFAAyF;AACzF,UAAU,6BAA6B;IACtC,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,sCAAsC,CAAC,EAAE,OAAO,CAAC;IACjD,gCAAgC,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,6BAA6B,EACrC,KAAK,EAAE,uBAAuB,GAC5B,IAAI,CAUN;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,GAAG,KAAK,CAKjG;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAClD,KAAK,EAAE,OAAO,GACZ,uBAAuB,GAAG,SAAS,CAsBrC"}
+{"version":3,"file":"dynamic-credentials-helpers.d.ts","sourceRoot":"","sources":["../../src/dynamic-credentials-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAEjF;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAMpF;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAIzF;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC/C,aAAa,EAAE,iBAAiB,GAAG,SAAS;AAC5C,yDAAyD;AACzD,qBAAqB,GAAE,SAAS,MAAM,EAAO,GAC3C,uBAAuB,CAqBzB;AAED,mEAAmE;AACnE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,QAAQ,GAAG,SAAS,GAAG,MAAM,EAAE,CAWhF;AAED,yFAAyF;AACzF,UAAU,6BAA6B;IACtC,iCAAiC,CAAC,EAAE,OAAO,CAAC;IAC5C,sCAAsC,CAAC,EAAE,OAAO,CAAC;IACjD,gCAAgC,CAAC,EAAE,MAAM,CAAC;IAC1C,4BAA4B,CAAC,EAAE,MAAM,EAAE,CAAC;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC3C,MAAM,EAAE,6BAA6B,EACrC,KAAK,EAAE,uBAAuB,GAC5B,IAAI,CAeN;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,uBAAuB,GAAG,KAAK,CAKjG;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CAClD,KAAK,EAAE,OAAO,GACZ,uBAAuB,GAAG,SAAS,CA0BrC"}

package/dist/cjs/dynamic-credentials-helpers.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runDataUsedDynamicCredentials = runDataUsedDynamicCredentials;
 exports.runDataAttemptedDynamicCredentials = runDataAttemptedDynamicCredentials;
 exports.summarizeDynamicCredentialsUsage = summarizeDynamicCredentialsUsage;
+exports.runDataUsedCredentialIds = runDataUsedCredentialIds;
 exports.applyDynamicCredentialsUsage = applyDynamicCredentialsUsage;
 exports.attachDynamicCredentialsUsage = attachDynamicCredentialsUsage;
 exports.takeAttachedDynamicCredentialsUsage = takeAttachedDynamicCredentialsUsage;
@@ -29,10 +30,20 @@ function runDataAttemptedDynamicCredentials(runData) {
  * Summarizes a run's private-credential usage so a sub-execution can report it to its caller.
  * Credentials resolve under the sub-workflow's own context, so the parent would otherwise never
  * flag that its embedded output used a private credential; recurses via the child's task flags.
+ *
+ * Also reports `usedCredentialIds`: every credential the run's workflows reference, private or
+ * not, which credential usability redaction reads.
  */
-function summarizeDynamicCredentialsUsage(executionData) {
+function summarizeDynamicCredentialsUsage(executionData, 
+/** The credentials the run's own workflow references. */
+workflowCredentialIds = []) {
     const runData = executionData?.resultData?.runData;
     const usage = {};
+    const usedCredentialIds = new Set(workflowCredentialIds);
+    for (const id of runDataUsedCredentialIds(runData))
+        usedCredentialIds.add(id);
+    if (usedCredentialIds.size > 0)
+        usage.usedCredentialIds = [...usedCredentialIds].sort();
     if (runDataUsedDynamicCredentials(runData)) {
         usage.usedDynamicCredentials = true;
         const resolvedUserId = executionData?.executionData?.runtimeData?.executedByUserId;
@@ -45,10 +56,27 @@ function summarizeDynamicCredentialsUsage(executionData) {
     }
     return usage;
 }
+/** The credentials sub-workflows reported onto the run's tasks. */
+function runDataUsedCredentialIds(runData) {
+    const ids = new Set();
+    for (const tasks of Object.values(runData ?? {})) {
+        for (const task of tasks) {
+            // Persisted run data is not validated, so read the ids only when they are a list.
+            const taskIds = task?.usedCredentialIds;
+            if (!Array.isArray(taskIds))
+                continue;
+            for (const id of taskIds)
+                if (typeof id === 'string')
+                    ids.add(id);
+        }
+    }
+    return [...ids];
+}
 /**
  * Applies a reported usage summary onto the per-node flags additively (flags only ever get set,
  * matching the other flag writers — the engine resets them per node). Resolved user id is
- * execution-scoped, so a present value wins (matches credential resolution).
+ * execution-scoped, so a present value wins (matches credential resolution). The plain
+ * credential ids are joined with the ones the node already collected.
  */
 function applyDynamicCredentialsUsage(target, usage) {
     if (usage.usedDynamicCredentials) {
@@ -60,6 +88,11 @@ function applyDynamicCredentialsUsage(target, usage) {
     if (usage.attemptedDynamicCredentials) {
         target.currentNodeAttemptedDynamicCredentials = true;
     }
+    if (usage.usedCredentialIds?.length) {
+        target.currentNodeUsedCredentialIds = [
+            ...new Set([...(target.currentNodeUsedCredentialIds ?? []), ...usage.usedCredentialIds]),
+        ];
+    }
 }
 /**
  * Rides a usage summary on an error crossing the sub-execution boundary, so a caller that
@@ -97,6 +130,11 @@ function takeAttachedDynamicCredentialsUsage(error) {
         typeof attached.dynamicCredentialsResolvedUserId === 'string') {
         usage.dynamicCredentialsResolvedUserId = attached.dynamicCredentialsResolvedUserId;
     }
+    if ('usedCredentialIds' in attached && Array.isArray(attached.usedCredentialIds)) {
+        const ids = attached.usedCredentialIds.filter((id) => typeof id === 'string');
+        if (ids.length > 0)
+            usage.usedCredentialIds = ids;
+    }
     return Object.keys(usage).length > 0 ? usage : undefined;
 }
 //# sourceMappingURL=dynamic-credentials-helpers.js.map

package/dist/cjs/dynamic-credentials-helpers.js.map

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

package/dist/cjs/execution-context.d.ts

@@ -136,6 +136,10 @@ declare const ExecutionContextSchemaV1: z.ZodObject<{
         manual: z.ZodBoolean;
         source: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"workflow">, z.ZodLiteral<"instance">]>>;
     }, z.core.$strip>]>>;
+    subWorkflowRedaction: z.ZodOptional<z.ZodObject<{
+        production: z.ZodBoolean;
+        manual: z.ZodBoolean;
+    }, z.core.$strip>>;
     executedByUserId: z.ZodOptional<z.ZodString>;
     usesDynamicCredentials: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>;
@@ -172,6 +176,10 @@ export declare const ExecutionContextSchema: z.ZodDiscriminatedUnion<[z.ZodObjec
         manual: z.ZodBoolean;
         source: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"workflow">, z.ZodLiteral<"instance">]>>;
     }, z.core.$strip>]>>;
+    subWorkflowRedaction: z.ZodOptional<z.ZodObject<{
+        production: z.ZodBoolean;
+        manual: z.ZodBoolean;
+    }, z.core.$strip>>;
     executedByUserId: z.ZodOptional<z.ZodString>;
     usesDynamicCredentials: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$strip>]>;

package/dist/cjs/execution-context.d.ts.map

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

package/dist/cjs/execution-context.js

@@ -158,6 +158,15 @@ const ExecutionContextSchemaV1 = v4_1.default.object({
      * regardless of any subsequent changes to the workflow setting.
      */
     redaction: RedactionSettingSchema.optional(),
+    /**
+     * Redaction channels that the sub-workflows of this execution reported to it.
+     * A sub-workflow reports the channels it redacts (and what its own
+     * sub-workflows reported), because the caller keeps a copy of its output.
+     * Kept apart from `redaction`, which stays the snapshot taken at start, so
+     * the read path can tell why an execution is redacted. Readers combine the
+     * two fields, strictest per channel. A channel is never lowered.
+     */
+    subWorkflowRedaction: v4_1.default.object({ production: v4_1.default.boolean(), manual: v4_1.default.boolean() }).optional(),
     /**
      * The n8n user the execution ran as. Stamped at context establishment by
      * deriving the user from the identity carrier with the same identifier that
@@ -197,6 +206,9 @@ function toErrorWorkflowContext(context) {
             parentExecutionId: context.parentExecutionId,
         }),
         ...(context.redaction !== undefined && { redaction: context.redaction }),
+        ...(context.subWorkflowRedaction !== undefined && {
+            subWorkflowRedaction: context.subWorkflowRedaction,
+        }),
         ...(context.executedByUserId !== undefined && {
             executedByUserId: context.executedByUserId,
         }),

package/dist/cjs/execution-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/execution-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../../src/execution-context.ts"],"names":[],"mappings":";;;;;;;AAAA,gDAAyC;AAEzC,mCAAoC;AASpC,MAAM,eAAe,GAAyB,YAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CACzD,YAAC,CAAC,KAAK,CAAC;IACP,YAAC,CAAC,MAAM,EAAE;IACV,YAAC,CAAC,MAAM,EAAE;IACV,YAAC,CAAC,OAAO,EAAE;IACX,YAAC,CAAC,IAAI,EAAE;IACR,YAAC,CAAC,MAAM,CAAC,YAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC;IACrC,YAAC,CAAC,KAAK,CAAC,eAAe,CAAC;CACxB,CAAC,CACF,CAAC;AAEF,MAAM,uBAAuB,GAAG,YAAC,CAAC,MAAM,CAAC;IACxC,OAAO,EAAE,YAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAErB;;;;;;;;;OASG;IACH,SAAS,EAAE,YAAC,CAAC,MAAM,CAAC,YAAC,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC;IAEhD;;OAEG;IACH,QAAQ,EAAE,YAAC,CAAC,MAAM,CAAC,YAAC,CAAC,MAAM,EAAE,EAAE,YAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIU,QAAA,qBAAqB,GAAG,YAAC;KACpC,kBAAkB,CAAC,SAAS,EAAE,CAAC,uBAAuB,CAAC,CAAC;KACxD,IAAI,CAAC;IACL,KAAK,EAAE,kBAAkB;CACzB,CAAC,CAAC;AA4BS,QAAA,wBAAwB,GAAG,YAAC,CAAC,MAAM,CAAC;IAChD,SAAS,EAAE,YAAC,CAAC,KAAK,CAAC,YAAC,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrC,uBAAuB,EAAE,YAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAuC,CAAC;AAEzC,MAAM,yBAAyB,GAAG,YAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,YAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB;;;OAGG;IACH,QAAQ,EAAE,YAAC,CAAC,MAAM,EAAE;IAEpB;;OAEG;IACH,QAAQ,EAAE,YAAC,CAAC,MAAM,CAAC,YAAC,CAAC,MAAM,EAAE,EAAE,YAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACtD,CAAC,CAAC;AAIU,QAAA,uBAAuB,GAAG,YAAC;KACtC,kBAAkB,CAAC,SAAS,EAAE,CAAC,yBAAyB,CAAC,CAAC;KAC1D,IAAI,CAAC;IACL,KAAK,EAAE,oBAAoB;CAC3B,CAAC,CAAC;AAQS,QAAA,uBAAuB,GAAG;IACtC,KAAK;IACL,OAAO;IACP,YAAY;IACZ,UAAU;IACV,QAAQ;IACR,OAAO;IACP,SAAS;IACT,SAAS;IACT,YAAY;IACZ,MAAM;IACN,OAAO;CACE,CAAC;AAEX,MAAM,yBAAyB,GAAG,YAAC,CAAC,IAAI,CAAC,QAAA,uBAAuB,CAAC,CAAC;AAIlE,MAAM,qBAAqB,GAAG,YAAC,CAAC,KAAK,CAAC;IACrC,YAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACjB,YAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAChB,YAAC,CAAC,OAAO,CAAC,YAAY,CAAC;IACvB,YAAC,CAAC,OAAO,CAAC,aAAa,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,wBAAwB,GAAG,YAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,YAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,qBAAqB;CAC7B,CAAC,CAAC;AAIH,MAAM,qBAAqB,GAAG,YAAC,CAAC,KAAK,CAAC,CAAC,YAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,YAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAItF;;;;;;;;;;GAUG;AACH,MAAM,wBAAwB,GAAG,YAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,YAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,UAAU,EAAE,YAAC,CAAC,OAAO,EAAE;IACvB,MAAM,EAAE,YAAC,CAAC,OAAO,EAAE;IACnB,MAAM,EAAE,qBAAqB,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,sBAAsB,GAAG,YAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE;IAC9D,wBAAwB;IACxB,wBAAwB;CACxB,CAAC,CAAC;AAIH,MAAM,wBAAwB,GAAG,YAAC,CAAC,MAAM,CAAC;IACzC,OAAO,EAAE,YAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB;;OAEG;IACH,aAAa,EAAE,YAAC,CAAC,MAAM,EAAE;IAEzB;;OAEG;IACH,MAAM,EAAE,yBAAyB;IAEjC;;OAEG;IACH,WAAW,EAAE,YAAC;SACZ,MAAM,CAAC;QACP,IAAI,EAAE,YAAC,CAAC,MAAM,EAAE;QAChB,IAAI,EAAE,YAAC,CAAC,MAAM,EAAE;KAChB,CAAC;SACD,QAAQ,EAAE;IAEZ;;;OAGG;IACH,iBAAiB,EAAE,YAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAExC;;;;OAIG;IACH,WAAW,EAAE,YAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;QACvC,WAAW,EACV,yLAAyL;KAC1L,CAAC;IAEF;;;;;;OAMG;IACH,eAAe,EAAE,YAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC;QAC3C,WAAW,EACV,0LAA0L;KAC3L,CAAC;IAEF;;;;OAIG;IACH,SAAS,EAAE,sBAAsB,CAAC,QAAQ,EAAE;IAE5C;;;;;;;OAOG;IACH,oBAAoB,EAAE,YAAC,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,YAAC,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,YAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE3F;;;;;;;;;OASG;IACH,gBAAgB,EAAE,YAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEvC;;;;;;;;OAQG;IACH,sBAAsB,EAAE,YAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC9C,CAAC,CAAC;AAIU,QAAA,sBAAsB,GAAG,YAAC;KACrC,kBAAkB,CAAC,SAAS,EAAE,CAAC,wBAAwB,CAAC,CAAC;KACzD,IAAI,CAAC;IACL,KAAK,EAAE,mBAAmB;CAC1B,CAAC,CAAC;AAwBJ,gCACC,OAAsC;IAEtC,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAE/B,OAAO;QACN,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;QAC9E,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS,IAAI;YAC9C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;SAC5C,CAAC;QACF,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QACxE,GAAG,CAAC,OAAO,CAAC,oBAAoB,KAAK,SAAS,IAAI;YACjD,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;SAClD,CAAC;QACF,GAAG,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,IAAI;YAC7C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;SAC1C,CAAC;QACF,GAAG,CAAC,OAAO,CAAC,sBAAsB,KAAK,SAAS,IAAI;YACnD,sBAAsB,EAAE,OAAO,CAAC,sBAAsB;SACtD,CAAC;KACF,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,0BAA0B,GAAG,YAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,YAAC,CAAC,OAAO,CAAC,WAAW,CAAC;IAC9B,QAAQ,EAAE,YAAC,CAAC,MAAM,EAAE;IACpB;;;;OAIG;IACH,OAAO,EAAE,YAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,aAAa,EAAE,YAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,YAAC,CAAC,KAAK,CAAC,YAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC7C,8FAA8F;IAC9F,OAAO,EAAE,YAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAC,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,YAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC3E,CAAC,CAAC;AAEH,sFAAsF;AACtF,MAAM,wBAAwB,GAAG,0BAA0B,CAAC,MAAM,CAAC;IAClE,OAAO,EAAE,YAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,QAAA,wBAAwB;CAC/B,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,4BAA4B,GAAG,0BAA0B,CAAC,MAAM,CAAC;IACtE,OAAO,EAAE,YAAC,CAAC,SAAS,EAAE;IACtB,KAAK,EAAE,QAAA,wBAAwB,CAAC,QAAQ,EAAE;CAC1C,CAAC,CAAC;AAEU,QAAA,sBAAsB,GAAG,YAAC,CAAC,kBAAkB,CAAC,SAAS,EAAE;IACrE,wBAAwB;IACxB,4BAA4B;CAC5B,CAAC,CAAC;AAyDI,MAAM,SAAS,GAAG,CAAoB,KAAsB,EAAE,MAAS,EAAE,EAAE;IACjF,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,IAAI,QAAQ,CAAC;IAClD,IAAI,CAAC;QACJ,MAAM,gBAAgB,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,iBAAS,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9E,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACvD,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;YACvB,MAAM,WAAW,CAAC,KAAK,CAAC;QACzB,CAAC;QACD,wGAAwG;QACxG,OAAO,WAAW,CAAC,IAAI,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,EAAE,EAAE;YACvD,KAAK,EAAE,KAAK;SACZ,CAAC,CAAC;IACJ,CAAC;AACF,CAAC,CAAC;AAfW,QAAA,SAAS,GAAT,SAAS,CAepB;AAEF;;;;GAIG;AACI,MAAM,kBAAkB,GAAG,CAAC,KAAsB,EAAqB,EAAE;IAC/E,wGAAwG;IACxG,OAAO,IAAA,QAAA,SAAS,EAAC,KAAK,EAAE,QAAA,sBAAsB,CAAC,CAAC;AACjD,CAAC,CAAC;AAHW,QAAA,kBAAkB,GAAlB,kBAAkB,CAG7B;AAEF;;;;;;;GAOG;AACI,MAAM,mBAAmB,GAAG,CAAC,KAAsB,EAAsB,EAAE;IACjF,yGAAyG;IACzG,OAAO,IAAA,QAAA,SAAS,EAAC,KAAK,EAAE,QAAA,uBAAuB,CAAC,CAAC;AAClD,CAAC,CAAC;AAHW,QAAA,mBAAmB,GAAnB,mBAAmB,CAG9B;AAEK,MAAM,iBAAiB,GAAG,CAAC,KAAsB,EAAoB,EAAE;IAC7E,uGAAuG;IACvG,OAAO,IAAA,QAAA,SAAS,EAAC,KAAK,EAAE,QAAA,qBAAqB,CAAC,CAAC;AAChD,CAAC,CAAC;AAHW,QAAA,iBAAiB,GAAjB,iBAAiB,CAG5B"}

package/dist/cjs/expression.d.ts

@@ -1,5 +1,37 @@
 import type { ObservabilityProvider } from '@n8n/expression-runtime';
 import type { IDataObject, INodeParameters, IWorkflowDataProxyData, NodeParameterValue } from './interfaces';
+/** What one engine did with one expression. `errorClass` names the failure without its message. */
+export type ExpressionEvaluationOutcome = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    error: unknown;
+    errorClass: string;
+};
+export interface ExpressionShadowContext {
+    /** The expression after `extendSyntax`, as the engines receive it. */
+    expression: string;
+    /** The expression as the user wrote it, without the leading `=`. */
+    source: string;
+    data: IWorkflowDataProxyData;
+    timezone: string;
+}
+/**
+ * Runs a second engine next to the legacy engine to compare the two. The
+ * legacy engine still gives the result: the runner only observes it.
+ */
+export interface ExpressionShadowRunner {
+    /**
+     * Called before the legacy engine evaluates an expression. Returns a callback
+     * for the legacy outcome, or `undefined` to skip this expression.
+     */
+    beforeLegacy(context: ExpressionShadowContext): ((legacy: ExpressionEvaluationOutcome) => void) | undefined;
+}
+export interface ShadowEvaluator {
+    evaluate(expression: string, data: IWorkflowDataProxyData, timezone: string): ExpressionEvaluationOutcome;
+    dispose(): Promise<void>;
+}
 export declare class Expression {
     private readonly timezone;
     private static expressionEngine;
@@ -7,6 +39,7 @@ export declare class Expression {
     private static readonly BROWSER_CALLER;
     private static useSharedCaller;
     private static nativeEvaluation;
+    private static shadowRunner?;
     constructor(timezone: string);
     /**
      * Check if VM evaluator should be used for evaluation.
@@ -47,6 +80,20 @@ export declare class Expression {
         /** Experimental: interpret expressions that fit the native subset in-process. Applies to every engine. */
         nativeEvaluation?: boolean;
     }): Promise<void>;
+    private static buildEvaluator;
+    /**
+     * Start a QuickJS evaluator for a shadow run, next to whatever engine is
+     * active. It has its own bridge and caller, so it never changes what the main
+     * engine does, and it uses the same sandbox hooks, so the comparison is fair.
+     */
+    static createQuickJsShadowEvaluator(options: {
+        bridgeTimeout: number;
+        bridgeMemoryLimit: number;
+        maxCodeCacheSize: number;
+        runtimeBundle?: string;
+    }): Promise<ShadowEvaluator>;
+    /** Install the runner that compares a second engine with legacy, or remove it with `undefined`. */
+    static setShadowRunner(runner: ExpressionShadowRunner | undefined): void;
     /** Returns whether an isolate was newly acquired; `false` means this caller already held one and must not release it. */
     acquireIsolate(): Promise<boolean>;
     releaseIsolate(): Promise<void>;
@@ -92,5 +139,11 @@ export declare class Expression {
     resolveSimpleParameterValue(parameterValue: NodeParameterValue, data: IWorkflowDataProxyData, returnObjectAsString?: boolean): NodeParameterValue | INodeParameters | NodeParameterValue[] | INodeParameters[];
     private finalizeResolvedValue;
     private renderExpression;
+    private static startShadow;
+    /**
+     * Evaluate with the legacy engine. A failure without `thrown` is one the
+     * editor shows as `null`; a shadow run still counts it as an error.
+     */
+    private evaluateLegacy;
 }
 //# sourceMappingURL=expression.d.ts.map

package/dist/cjs/expression.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../src/expression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAe3F,OAAO,KAAK,EACX,WAAW,EACX,eAAe,EACf,sBAAsB,EACtB,kBAAkB,EAClB,MAAM,cAAc,CAAC;AAkMtB,qBAAa,UAAU;IAWV,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAVrC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAyC;IAExE,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAuB;IAElD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAM;IAE5C,OAAO,CAAC,MAAM,CAAC,eAAe,CAAS;IAEvC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAS;IAExC,YAA6B,QAAQ,EAAE,MAAM,EAAI;IAEjD;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAI1B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAKjC;;;;OAIG;IACH,OAAa,oBAAoB,CAAC,OAAO,EAAE;QAC1C,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,CAAC;QACpC,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,CAAC,EAAE,qBAAqB,CAAC;QACtC,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;;;;WAMG;QACH,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,0GAA0G;QAC1G,gBAAgB,CAAC,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEhB;IAED,yHAAyH;IACnH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAGvC;IAEK,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpC;IAEK,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAarD;IAED;;;OAGG;IACH,OAAa,uBAAuB,IAAI,OAAO,CAAC,IAAI,CAAC,CASpD;IAED;;;OAGG;IACH,MAAM,CAAC,uBAAuB,IAAI,QAAQ,GAAG,IAAI,GAAG,SAAS,CAG5D;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAEpE;IAED,mJAAmJ;IACnJ,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEjD;IAED,MAAM,CAAC,uBAAuB,CAAC,IAAI,EAAE,WAAW,QA2J/C;IAED,MAAM,CAAC,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,mCAEvE;IAED;;;;OAIG;IACH,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA+BhD;IAED;;;;;;;OAOG;IACH,2BAA2B,CAC1B,cAAc,EAAE,kBAAkB,EAClC,IAAI,EAAE,sBAAsB,EAC5B,oBAAoB,UAAQ,GAC1B,kBAAkB,GAAG,eAAe,GAAG,kBAAkB,EAAE,GAAG,eAAe,EAAE,CAsFjF;IAED,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,gBAAgB;CAuDxB"}
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../src/expression.ts"],"names":[],"mappings":"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"}

package/dist/cjs/expression.js

@@ -56,6 +56,30 @@ const isTypeError = (error) => error instanceof TypeError || (error instanceof E
     if (isExpressionError(error))
         throw error;
 });
+// Expression code can set `name` to any text, so only these names leave the engine.
+const KNOWN_ERROR_CLASSES = new Set([
+    'Error AggregateError EvalError InternalError RangeError ReferenceError SyntaxError',
+    'TypeError URIError ExpressionError ExpressionExtensionError UserError',
+]
+    .join(' ')
+    .split(' '));
+function errorClassOf(error) {
+    // Timeout and memory errors share the name `ExpressionError`, so classify them first.
+    const runtimeClass = (0, expression_runtime_1.classifyExpressionError)(error);
+    if (runtimeClass !== 'unknown')
+        return runtimeClass;
+    // A minified build renames classes, and n8n errors take their `name` from the
+    // constructor, so check the class before the name. The subclass comes first.
+    if (error instanceof expression_extension_error_1.ExpressionExtensionError)
+        return 'ExpressionExtensionError';
+    if (error instanceof expression_error_1.ExpressionError)
+        return 'ExpressionError';
+    if (error instanceof errors_1.UserError)
+        return 'UserError';
+    if (!(error instanceof Error))
+        return typeof error;
+    return KNOWN_ERROR_CLASSES.has(error.name) ? error.name : 'other';
+}
 /**
  * Map errors from the VM expression evaluator to host-side error types.
  *
@@ -228,6 +252,7 @@ class Expression {
     static BROWSER_CALLER = {};
     static useSharedCaller = false;
     static nativeEvaluation = false;
+    static shadowRunner;
     constructor(timezone) {
         this.timezone = timezone;
     }
@@ -262,31 +287,7 @@ class Expression {
             return;
         this.expressionEngine = options.engine;
         if (!this.vmEvaluator) {
-            // Dynamic import to avoid loading expression-runtime in browser environments
-            const runtime = await import('@n8n/expression-runtime');
-            const createBridge = options.engine === 'quickjs'
-                ? () => new runtime.QuickJsBridge({
-                    timeout: options.bridgeTimeout,
-                    memoryLimit: options.bridgeMemoryLimit,
-                    logger: LoggerProxy,
-                    runtimeBundle: options.runtimeBundle,
-                })
-                : () => new runtime.IsolatedVmBridge({
-                    timeout: options.bridgeTimeout,
-                    memoryLimit: options.bridgeMemoryLimit,
-                    logger: LoggerProxy,
-                    compileCache: options.compileCache,
-                });
-            const evaluator = new runtime.ExpressionEvaluator({
-                createBridge,
-                maxCodeCacheSize: options.maxCodeCacheSize,
-                poolSize: options.poolSize,
-                idleTimeoutMs: options.idleTimeoutMs,
-                lazyAcquire: options.lazyAcquire,
-                hooks: expression_sandboxing_1.expressionSandboxHooks,
-                logger: LoggerProxy,
-                observability: options.observability,
-            });
+            const evaluator = await this.buildEvaluator({ ...options, engine: options.engine });
             // Publish the evaluator only once it is usable. A half-started one
             // would leave `shouldUseVm` reporting the engine as active while no
             // bridge is acquired, so callers could neither retry the start nor
@@ -319,6 +320,73 @@ class Expression {
             }
         }
     }
+    static async buildEvaluator(options) {
+        // Dynamic import to avoid loading expression-runtime in browser environments
+        const runtime = await import('@n8n/expression-runtime');
+        const createBridge = options.engine === 'quickjs'
+            ? () => new runtime.QuickJsBridge({
+                timeout: options.bridgeTimeout,
+                memoryLimit: options.bridgeMemoryLimit,
+                logger: LoggerProxy,
+                runtimeBundle: options.runtimeBundle,
+            })
+            : () => new runtime.IsolatedVmBridge({
+                timeout: options.bridgeTimeout,
+                memoryLimit: options.bridgeMemoryLimit,
+                logger: LoggerProxy,
+                compileCache: options.compileCache,
+            });
+        return new runtime.ExpressionEvaluator({
+            createBridge,
+            maxCodeCacheSize: options.maxCodeCacheSize,
+            poolSize: options.poolSize,
+            idleTimeoutMs: options.idleTimeoutMs,
+            lazyAcquire: options.lazyAcquire,
+            hooks: expression_sandboxing_1.expressionSandboxHooks,
+            logger: LoggerProxy,
+            observability: options.observability,
+        });
+    }
+    /**
+     * Start a QuickJS evaluator for a shadow run, next to whatever engine is
+     * active. It has its own bridge and caller, so it never changes what the main
+     * engine does, and it uses the same sandbox hooks, so the comparison is fair.
+     */
+    static async createQuickJsShadowEvaluator(options) {
+        const evaluator = await this.buildEvaluator({
+            ...options,
+            engine: 'quickjs',
+            poolSize: 1,
+            lazyAcquire: true,
+        });
+        const caller = {};
+        try {
+            await evaluator.initialize();
+            await evaluator.acquire(caller);
+        }
+        catch (error) {
+            await evaluator.dispose().catch(() => { });
+            throw error;
+        }
+        return {
+            evaluate: (expression, data, timezone) => {
+                try {
+                    return { ok: true, value: evaluator.evaluate(expression, data, caller, { timezone }) };
+                }
+                catch (error) {
+                    return { ok: false, error: mapVmError(error), errorClass: errorClassOf(error) };
+                }
+            },
+            dispose: async () => {
+                await evaluator.release(caller);
+                await evaluator.dispose();
+            },
+        };
+    }
+    /** Install the runner that compares a second engine with legacy, or remove it with `undefined`. */
+    static setShadowRunner(runner) {
+        this.shadowRunner = runner;
+    }
     /** Returns whether an isolate was newly acquired; `false` means this caller already held one and must not release it. */
     async acquireIsolate() {
         if (Expression.vmEvaluator)
@@ -637,7 +705,7 @@ class Expression {
         }
         // Execute the expression
         const extendedExpression = (0, expression_extension_1.extendSyntax)(parameterValue);
-        const returnValue = this.renderExpression(extendedExpression, data);
+        const returnValue = this.renderExpression(extendedExpression, data, parameterValue);
         return this.finalizeResolvedValue(returnValue, returnObjectAsString);
     }
     finalizeResolvedValue(returnValue, returnObjectAsString) {
@@ -653,7 +721,7 @@ class Expression {
         // the previous inline code relied on.
         return returnValue;
     }
-    renderExpression(expression, data) {
+    renderExpression(expression, data, source) {
         const evaluator = Expression.vmEvaluator;
         if (evaluator && Expression.isVmEngineSelected()) {
             const caller = Expression.useSharedCaller ? Expression.BROWSER_CALLER : this;
@@ -676,22 +744,61 @@ class Expression {
             throw new errors_1.UnexpectedError(`The ${Expression.expressionEngine} expression engine has not been initialized. Call Expression.initExpressionEngine() during application startup.`);
         }
         // Fall back to current implementation
+        const finishShadow = Expression.startShadow({
+            expression,
+            source,
+            data,
+            timezone: this.timezone,
+        });
+        const legacy = this.evaluateLegacy(expression, data);
+        if (finishShadow) {
+            try {
+                finishShadow(legacy.ok
+                    ? { ok: true, value: legacy.value }
+                    : { ok: false, error: legacy.error, errorClass: errorClassOf(legacy.error) });
+            }
+            catch {
+                // A shadow run only observes: its failure must not reach the user.
+            }
+        }
+        if (legacy.ok)
+            return legacy.value;
+        if (legacy.thrown)
+            throw legacy.thrown;
+        return null;
+    }
+    static startShadow(context) {
+        if (!this.shadowRunner)
+            return undefined;
         try {
-            return (0, expression_evaluator_proxy_1.evaluateExpression)(expression, data);
+            return this.shadowRunner.beforeLegacy(context);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Evaluate with the legacy engine. A failure without `thrown` is one the
+     * editor shows as `null`; a shadow run still counts it as an error.
+     */
+    evaluateLegacy(expression, data) {
+        try {
+            return { ok: true, value: (0, expression_evaluator_proxy_1.evaluateExpression)(expression, data) };
         }
         catch (error) {
             if (isExpressionError(error))
-                throw error;
-            if (isSyntaxError(error))
-                throw new errors_1.UserError('invalid syntax');
+                return { ok: false, error, thrown: error };
+            if (isSyntaxError(error)) {
+                return { ok: false, error, thrown: new errors_1.UserError('invalid syntax') };
+            }
             if (isTypeError(error) && runtime_environment_1.IS_FRONTEND && error.message.endsWith('is not a function')) {
                 const match = error.message.match(/(?<msg>[^.]+is not a function)/);
                 if (!match?.groups?.msg)
-                    return null;
-                throw new errors_1.UserError(match.groups.msg);
+                    return { ok: false, error };
+                return { ok: false, error, thrown: new errors_1.UserError(match.groups.msg) };
             }
+            return { ok: false, error };
         }
-        return null;
     }
 }
 exports.Expression = Expression;