@atom8n/n8n-workflow 2.2.0

package/dist/esm/workflow-checksum.js

@@ -0,0 +1,69 @@
+import jsSHA from 'jssha';
+import { isObject } from './utils';
+const CHECKSUM_FIELDS = [
+    'name',
+    'description',
+    'nodes',
+    'connections',
+    'settings',
+    'meta',
+    'pinData',
+    'isArchived',
+    'activeVersionId',
+];
+/**
+ * Recursively sorts object keys alphabetically for consistent serialization.
+ * Arrays keep their order; their elements are normalized recursively.
+ */
+function sortObjectKeys(value) {
+    if (value === null || typeof value !== 'object')
+        return value;
+    if (Array.isArray(value)) {
+        return value.map((element) => sortObjectKeys(element));
+    }
+    if (isObject(value)) {
+        const sortedKeys = Object.keys(value).sort();
+        const sortedObject = {};
+        for (const key of sortedKeys) {
+            sortedObject[key] = sortObjectKeys(value[key]);
+        }
+        return sortedObject;
+    }
+    return value;
+}
+/**
+ * Calculates SHA-256 checksum of workflow content fields for conflict detection.
+ * Excludes: id, versionId, timestamps, staticData, relations.
+ *
+ * Uses WebCrypto when available (e.g. browser in secure context), and falls back to a pure-JS SHA-256
+ * implementation to also work in environments where WebCrypto is unavailable (e.g. HTTP/insecure contexts).
+ */
+export async function calculateWorkflowChecksum(workflow) {
+    const checksumPayload = {};
+    for (const field of CHECKSUM_FIELDS) {
+        const value = workflow[field];
+        if (value !== undefined) {
+            checksumPayload[field] = value;
+        }
+    }
+    const normalizedPayload = sortObjectKeys(checksumPayload);
+    const serializedPayload = JSON.stringify(normalizedPayload);
+    const subtle = globalThis.crypto?.subtle;
+    if (subtle) {
+        const data = new TextEncoder().encode(serializedPayload);
+        const hashBuffer = await subtle.digest('SHA-256', data);
+        return arrayBufferToHex(hashBuffer);
+    }
+    const shaObj = new jsSHA('SHA-256', 'TEXT', { encoding: 'UTF8' });
+    shaObj.update(serializedPayload);
+    return shaObj.getHash('HEX').toLowerCase();
+}
+function arrayBufferToHex(arrayBuffer) {
+    const bytes = new Uint8Array(arrayBuffer);
+    let hexString = '';
+    for (let index = 0; index < bytes.length; index++) {
+        hexString += bytes[index].toString(16).padStart(2, '0');
+    }
+    return hexString;
+}
+//# sourceMappingURL=workflow-checksum.js.map

package/dist/esm/workflow-checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-checksum.js","sourceRoot":"","sources":["../../src/workflow-checksum.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAkBnC,MAAM,eAAe,GAAG;IACvB,MAAM;IACN,aAAa;IACb,OAAO;IACP,aAAa;IACb,UAAU;IACV,MAAM;IACN,SAAS;IACT,YAAY;IACZ,iBAAiB;CACwC,CAAC;AAE3D;;;GAGG;AACH,SAAS,cAAc,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAE7C,MAAM,YAAY,GAA4B,EAAE,CAAC;QACjD,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC9B,YAAY,CAAC,GAAG,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,YAAY,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,QAA0B;IACzE,MAAM,eAAe,GAA4B,EAAE,CAAC;IAEpD,KAAK,MAAM,KAAK,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,eAAe,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;QAChC,CAAC;IACF,CAAC;IAED,MAAM,iBAAiB,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IAE5D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC;IACzC,IAAI,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACxD,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IAClE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5C,CAAC;AAED,SAAS,gBAAgB,CAAC,WAAwB;IACjD,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,SAAS,GAAG,EAAE,CAAC;IAEnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACnD,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/esm/workflow-data-proxy-env-provider.d.ts

@@ -0,0 +1,25 @@
+export type EnvProviderState = {
+    isProcessAvailable: boolean;
+    isEnvAccessBlocked: boolean;
+    env: Record<string, string>;
+};
+/**
+ * Captures a snapshot of the environment variables and configuration
+ * that can be used to initialize an environment provider.
+ */
+export declare function createEnvProviderState(): EnvProviderState;
+/**
+ * Creates a proxy that provides access to the environment variables
+ * in the `WorkflowDataProxy`. Use the `createEnvProviderState` to
+ * create the default state object that is needed for the proxy,
+ * unless you need something specific.
+ *
+ * @example
+ * createEnvProvider(
+ *   runIndex,
+ *   itemIndex,
+ *   createEnvProviderState(),
+ * )
+ */
+export declare function createEnvProvider(runIndex: number, itemIndex: number, providerState: EnvProviderState): Record<string, string>;
+//# sourceMappingURL=workflow-data-proxy-env-provider.d.ts.map

package/dist/esm/workflow-data-proxy-env-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-data-proxy-env-provider.d.ts","sourceRoot":"","sources":["../../src/workflow-data-proxy-env-provider.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,gBAAgB,GAAG;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAazD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,gBAAgB,GAC7B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8BxB"}

package/dist/esm/workflow-data-proxy-env-provider.js

@@ -0,0 +1,56 @@
+import { ExpressionError } from './errors/expression.error';
+/**
+ * Captures a snapshot of the environment variables and configuration
+ * that can be used to initialize an environment provider.
+ */
+export function createEnvProviderState() {
+    const isProcessAvailable = typeof process !== 'undefined';
+    const isEnvAccessBlocked = isProcessAvailable
+        ? process.env.N8N_BLOCK_ENV_ACCESS_IN_NODE !== 'false'
+        : false;
+    const env = !isProcessAvailable || isEnvAccessBlocked ? {} : process.env;
+    return {
+        isProcessAvailable,
+        isEnvAccessBlocked,
+        env,
+    };
+}
+/**
+ * Creates a proxy that provides access to the environment variables
+ * in the `WorkflowDataProxy`. Use the `createEnvProviderState` to
+ * create the default state object that is needed for the proxy,
+ * unless you need something specific.
+ *
+ * @example
+ * createEnvProvider(
+ *   runIndex,
+ *   itemIndex,
+ *   createEnvProviderState(),
+ * )
+ */
+export function createEnvProvider(runIndex, itemIndex, providerState) {
+    return new Proxy({}, {
+        has() {
+            return true;
+        },
+        get(_, name) {
+            if (name === 'isProxy')
+                return true;
+            if (!providerState.isProcessAvailable) {
+                throw new ExpressionError('not accessible via UI, please run node', {
+                    runIndex,
+                    itemIndex,
+                });
+            }
+            if (providerState.isEnvAccessBlocked) {
+                throw new ExpressionError('access to env vars denied', {
+                    causeDetailed: 'If you need access please contact the administrator to remove the environment variable ‘N8N_BLOCK_ENV_ACCESS_IN_NODE‘',
+                    runIndex,
+                    itemIndex,
+                });
+            }
+            return providerState.env[name.toString()];
+        },
+    });
+}
+//# sourceMappingURL=workflow-data-proxy-env-provider.js.map

package/dist/esm/workflow-data-proxy-env-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-data-proxy-env-provider.js","sourceRoot":"","sources":["../../src/workflow-data-proxy-env-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAQ5D;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACrC,MAAM,kBAAkB,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC;IAC1D,MAAM,kBAAkB,GAAG,kBAAkB;QAC5C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,KAAK,OAAO;QACtD,CAAC,CAAC,KAAK,CAAC;IACT,MAAM,GAAG,GACR,CAAC,kBAAkB,IAAI,kBAAkB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAE,OAAO,CAAC,GAA8B,CAAC;IAE1F,OAAO;QACN,kBAAkB;QAClB,kBAAkB;QAClB,GAAG;KACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,iBAAiB,CAChC,QAAgB,EAChB,SAAiB,EACjB,aAA+B;IAE/B,OAAO,IAAI,KAAK,CACf,EAAE,EACF;QACC,GAAG;YACF,OAAO,IAAI,CAAC;QACb,CAAC;QAED,GAAG,CAAC,CAAC,EAAE,IAAI;YACV,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YAEpC,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,CAAC;gBACvC,MAAM,IAAI,eAAe,CAAC,wCAAwC,EAAE;oBACnE,QAAQ;oBACR,SAAS;iBACT,CAAC,CAAC;YACJ,CAAC;YACD,IAAI,aAAa,CAAC,kBAAkB,EAAE,CAAC;gBACtC,MAAM,IAAI,eAAe,CAAC,2BAA2B,EAAE;oBACtD,aAAa,EACZ,uHAAuH;oBACxH,QAAQ;oBACR,SAAS;iBACT,CAAC,CAAC;YACJ,CAAC;YAED,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3C,CAAC;KACD,CACD,CAAC;AACH,CAAC"}

package/dist/esm/workflow-data-proxy-helpers.d.ts

@@ -0,0 +1,3 @@
+import type { INodeExecutionData, Workflow, WorkflowExecuteMode } from '.';
+export declare function getPinDataIfManualExecution(workflow: Workflow, nodeName: string, mode: WorkflowExecuteMode): INodeExecutionData[] | undefined;
+//# sourceMappingURL=workflow-data-proxy-helpers.d.ts.map

package/dist/esm/workflow-data-proxy-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-data-proxy-helpers.d.ts","sourceRoot":"","sources":["../../src/workflow-data-proxy-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,GAAG,CAAC;AAE3E,wBAAgB,2BAA2B,CAC1C,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,GACvB,kBAAkB,EAAE,GAAG,SAAS,CAKlC"}

package/dist/esm/workflow-data-proxy-helpers.js

@@ -0,0 +1,7 @@
+export function getPinDataIfManualExecution(workflow, nodeName, mode) {
+    if (mode !== 'manual') {
+        return undefined;
+    }
+    return workflow.getPinDataOfNode(nodeName);
+}
+//# sourceMappingURL=workflow-data-proxy-helpers.js.map

package/dist/esm/workflow-data-proxy-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-data-proxy-helpers.js","sourceRoot":"","sources":["../../src/workflow-data-proxy-helpers.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,2BAA2B,CAC1C,QAAkB,EAClB,QAAgB,EAChB,IAAyB;IAEzB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/dist/esm/workflow-data-proxy.d.ts

@@ -0,0 +1,81 @@
+import type { IDataObject, IExecuteData, INodeExecutionData, INodeParameters, IWorkflowDataProxyAdditionalKeys, IWorkflowDataProxyData, WorkflowExecuteMode } from './interfaces';
+import type { IRunExecutionData } from './run-execution-data/run-execution-data';
+import type { Workflow } from './workflow';
+import type { EnvProviderState } from './workflow-data-proxy-env-provider';
+export declare class WorkflowDataProxy {
+    private workflow;
+    private runIndex;
+    private itemIndex;
+    private activeNodeName;
+    private siblingParameters;
+    private mode;
+    private additionalKeys;
+    private executeData?;
+    private defaultReturnRunIndex;
+    private selfData;
+    private contextNodeName;
+    private envProviderState?;
+    private runExecutionData;
+    private connectionInputData;
+    private timezone;
+    constructor(workflow: Workflow, runExecutionData: IRunExecutionData | null, runIndex: number, itemIndex: number, activeNodeName: string, connectionInputData: INodeExecutionData[], siblingParameters: INodeParameters, mode: WorkflowExecuteMode, additionalKeys: IWorkflowDataProxyAdditionalKeys, executeData?: IExecuteData | undefined, defaultReturnRunIndex?: number, selfData?: IDataObject, contextNodeName?: string, envProviderState?: EnvProviderState | undefined);
+    /**
+     * Returns a proxy which allows to query context data of a given node
+     *
+     * @private
+     * @param {string} nodeName The name of the node to get the context from
+     */
+    private nodeContextGetter;
+    private selfGetter;
+    private buildAgentToolInfo;
+    private agentInfo;
+    /**
+     * Returns a proxy which allows to query parameter data of a given node
+     *
+     * @private
+     * @param {string} nodeName The name of the node to query data from
+     * @param {boolean} [resolveValue=true] If the expression value should get resolved
+     */
+    private nodeParameterGetter;
+    private getNodeExecutionOrPinnedData;
+    /**
+     * Returns the node ExecutionData
+     *
+     * @private
+     * @param {string} nodeName The name of the node query data from
+     * @param {boolean} [shortSyntax=false] If short syntax got used
+     * @param {number} [outputIndex] The index of the output, if not given the first one gets used
+     * @param {number} [runIndex] The index of the run, if not given the current one does get used
+     */
+    private getNodeExecutionData;
+    /**
+     * Returns a proxy which allows to query data of a given node
+     *
+     * @private
+     * @param {string} nodeName The name of the node query data from
+     * @param {boolean} [shortSyntax=false] If short syntax got used
+     * @param {boolean} [throwOnMissingExecutionData=true] If an error should get thrown if no execution data is available
+     */
+    private nodeDataGetter;
+    private prevNodeGetter;
+    /**
+     * Returns a proxy to query data from the workflow
+     *
+     * @private
+     */
+    private workflowGetter;
+    /**
+     * Returns a proxy to query data of all nodes
+     *
+     * @private
+     */
+    private nodeGetter;
+    /**
+     * Returns the data proxy object which allows to query data from current run
+     *
+     */
+    getDataProxy(opts?: {
+        throwOnMissingExecutionData: boolean;
+    }): IWorkflowDataProxyData;
+}
+//# sourceMappingURL=workflow-data-proxy.d.ts.map

package/dist/esm/workflow-data-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-data-proxy.d.ts","sourceRoot":"","sources":["../../src/workflow-data-proxy.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACX,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,eAAe,EAIf,gCAAgC,EAChC,sBAAsB,EAEtB,mBAAmB,EAGnB,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAGjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAmB3E,qBAAa,iBAAiB;IAS5B,OAAO,CAAC,QAAQ;IAEhB,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,cAAc;IAEtB,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,WAAW,CAAC;IACpB,OAAO,CAAC,qBAAqB;IAC7B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,eAAe;IACvB,OAAO,CAAC,gBAAgB,CAAC;IArB1B,OAAO,CAAC,gBAAgB,CAA2B;IAEnD,OAAO,CAAC,mBAAmB,CAAuB;IAElD,OAAO,CAAC,QAAQ,CAAS;gBAIhB,QAAQ,EAAE,QAAQ,EAC1B,gBAAgB,EAAE,iBAAiB,GAAG,IAAI,EAClC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EAC9B,mBAAmB,EAAE,kBAAkB,EAAE,EACjC,iBAAiB,EAAE,eAAe,EAClC,IAAI,EAAE,mBAAmB,EACzB,cAAc,EAAE,gCAAgC,EAChD,WAAW,CAAC,EAAE,YAAY,YAAA,EAC1B,qBAAqB,SAAK,EAC1B,QAAQ,GAAE,WAAgB,EAC1B,eAAe,GAAE,MAAuB,EACxC,gBAAgB,CAAC,EAAE,gBAAgB,YAAA;IAgB5C;;;;;OAKG;IACH,OAAO,CAAC,iBAAiB;IAiDzB,OAAO,CAAC,UAAU;IAoBlB,OAAO,CAAC,kBAAkB;IAsD1B,OAAO,CAAC,SAAS;IA6BjB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAiF3B,OAAO,CAAC,4BAA4B;IAuBpC;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IA6G5B;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAuHtB,OAAO,CAAC,cAAc;IA2CtB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAwCtB;;;;OAIG;IACH,OAAO,CAAC,UAAU;IA0BlB;;;OAGG;IACH,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,2BAA2B,EAAE,OAAO,CAAA;KAAE,GAAG,sBAAsB;CAqwBrF"}