@atom8n/n8n-workflow 2.2.0

package/dist/esm/errors/workflow-operation.error.d.ts

@@ -0,0 +1,11 @@
+import type { INode } from '../interfaces';
+import { ExecutionBaseError } from './abstract/execution-base.error';
+/**
+ * Class for instantiating an operational error, e.g. a timeout error.
+ */
+export declare class WorkflowOperationError extends ExecutionBaseError {
+    node: INode | undefined;
+    timestamp: number;
+    constructor(message: string, node?: INode, description?: string);
+}
+//# sourceMappingURL=workflow-operation.error.d.ts.map

package/dist/esm/errors/workflow-operation.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-operation.error.d.ts","sourceRoot":"","sources":["../../../src/errors/workflow-operation.error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,kBAAkB;IAC7D,IAAI,EAAE,KAAK,GAAG,SAAS,CAAC;IAEf,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,MAAM;CAQ/D"}

package/dist/esm/errors/workflow-operation.error.js

@@ -0,0 +1,18 @@
+import { ExecutionBaseError } from './abstract/execution-base.error';
+/**
+ * Class for instantiating an operational error, e.g. a timeout error.
+ */
+export class WorkflowOperationError extends ExecutionBaseError {
+    node;
+    timestamp;
+    constructor(message, node, description) {
+        super(message, { cause: undefined });
+        this.level = 'warning';
+        this.name = this.constructor.name;
+        if (description)
+            this.description = description;
+        this.node = node;
+        this.timestamp = Date.now();
+    }
+}
+//# sourceMappingURL=workflow-operation.error.js.map

package/dist/esm/errors/workflow-operation.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-operation.error.js","sourceRoot":"","sources":["../../../src/errors/workflow-operation.error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,kBAAkB;IAC7D,IAAI,CAAoB;IAEf,SAAS,CAAS;IAE3B,YAAY,OAAe,EAAE,IAAY,EAAE,WAAoB;QAC9D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,WAAW;YAAE,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAChD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,CAAC;CACD"}

package/dist/esm/evaluation-helpers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Evaluation-related utility functions
+ *
+ * This file contains utilities that need to be shared between different packages
+ * to avoid circular dependencies. For example, the evaluation test-runner (in CLI package)
+ * and the Evaluation node (in nodes-base package) both need to know which metrics
+ * require AI model connections, but they can't import from each other directly.
+ *
+ * By placing shared utilities here in the workflow package (which both packages depend on),
+ * we avoid circular dependency issues.
+ */
+/**
+ * Default metric type used in evaluations
+ */
+export declare const DEFAULT_EVALUATION_METRIC = "correctness";
+/**
+ * Determines if a given evaluation metric requires an AI model connection
+ * @param metric The metric name to check
+ * @returns true if the metric requires an AI model connection
+ */
+export declare function metricRequiresModelConnection(metric: string): boolean;
+//# sourceMappingURL=evaluation-helpers.d.ts.map

package/dist/esm/evaluation-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-helpers.d.ts","sourceRoot":"","sources":["../../src/evaluation-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAErE"}

package/dist/esm/evaluation-helpers.js

@@ -0,0 +1,24 @@
+/**
+ * Evaluation-related utility functions
+ *
+ * This file contains utilities that need to be shared between different packages
+ * to avoid circular dependencies. For example, the evaluation test-runner (in CLI package)
+ * and the Evaluation node (in nodes-base package) both need to know which metrics
+ * require AI model connections, but they can't import from each other directly.
+ *
+ * By placing shared utilities here in the workflow package (which both packages depend on),
+ * we avoid circular dependency issues.
+ */
+/**
+ * Default metric type used in evaluations
+ */
+export const DEFAULT_EVALUATION_METRIC = 'correctness';
+/**
+ * Determines if a given evaluation metric requires an AI model connection
+ * @param metric The metric name to check
+ * @returns true if the metric requires an AI model connection
+ */
+export function metricRequiresModelConnection(metric) {
+    return ['correctness', 'helpfulness'].includes(metric);
+}
+//# sourceMappingURL=evaluation-helpers.js.map

package/dist/esm/evaluation-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-helpers.js","sourceRoot":"","sources":["../../src/evaluation-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC;AAEvD;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,MAAc;IAC3D,OAAO,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACxD,CAAC"}

package/dist/esm/execution-context-establishment-hooks.d.ts

@@ -0,0 +1,38 @@
+import z from 'zod/v4';
+declare const ExecutionContextEstablishmentHookParameterSchemaV1: z.ZodObject<{
+    executionsHooksVersion: z.ZodLiteral<1>;
+    contextEstablishmentHooks: z.ZodObject<{
+        hooks: z.ZodArray<z.ZodObject<{
+            hookName: z.ZodString;
+            isAllowedToFail: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ExecutionContextEstablishmentHookParameterV1 = z.output<typeof ExecutionContextEstablishmentHookParameterSchemaV1>;
+export declare const ExecutionContextEstablishmentHookParameterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    executionsHooksVersion: z.ZodLiteral<1>;
+    contextEstablishmentHooks: z.ZodObject<{
+        hooks: z.ZodArray<z.ZodObject<{
+            hookName: z.ZodString;
+            isAllowedToFail: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        }, z.core.$loose>>;
+    }, z.core.$strip>;
+}, z.core.$strip>]>;
+export type ExecutionContextEstablishmentHookParameter = z.output<typeof ExecutionContextEstablishmentHookParameterSchema>;
+/**
+ * Safely parses an execution context establishment hook parameters
+ * @param obj
+ * @returns
+ */
+export declare const toExecutionContextEstablishmentHookParameter: (value: unknown) => z.ZodSafeParseResult<{
+    executionsHooksVersion: 1;
+    contextEstablishmentHooks: {
+        hooks: {
+            [x: string]: unknown;
+            hookName: string;
+            isAllowedToFail: boolean;
+        }[];
+    };
+}> | null;
+export {};
+//# sourceMappingURL=execution-context-establishment-hooks.d.ts.map

package/dist/esm/execution-context-establishment-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-establishment-hooks.d.ts","sourceRoot":"","sources":["../../src/execution-context-establishment-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,QAAA,MAAM,kDAAkD;;;;;;;;iBAYtD,CAAC;AAEH,MAAM,MAAM,4CAA4C,GAAG,CAAC,CAAC,MAAM,CAClE,OAAO,kDAAkD,CACzD,CAAC;AAEF,eAAO,MAAM,gDAAgD;;;;;;;;mBAM1D,CAAC;AAEJ,MAAM,MAAM,0CAA0C,GAAG,CAAC,CAAC,MAAM,CAChE,OAAO,gDAAgD,CACvD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4CAA4C,GAAI,OAAO,OAAO;;;;;;;;;SAS1E,CAAC"}

package/dist/esm/execution-context-establishment-hooks.js

@@ -0,0 +1,35 @@
+import z from 'zod/v4';
+const ExecutionContextEstablishmentHookParameterSchemaV1 = z.object({
+    executionsHooksVersion: z.literal(1),
+    contextEstablishmentHooks: z.object({
+        hooks: z.array(z
+            .object({
+            hookName: z.string(),
+            isAllowedToFail: z.boolean().optional().default(false),
+        })
+            .loose()),
+    }),
+});
+export const ExecutionContextEstablishmentHookParameterSchema = z
+    .discriminatedUnion('executionsHooksVersion', [
+    ExecutionContextEstablishmentHookParameterSchemaV1,
+])
+    .meta({
+    title: 'ExecutionContextEstablishmentHookParameter',
+});
+/**
+ * Safely parses an execution context establishment hook parameters
+ * @param obj
+ * @returns
+ */
+export const toExecutionContextEstablishmentHookParameter = (value) => {
+    if (value === null || value === undefined || typeof value !== 'object') {
+        return null;
+    }
+    // Quick check to avoid unnecessary parsing attempts
+    if (!('executionsHooksVersion' in value)) {
+        return null;
+    }
+    return ExecutionContextEstablishmentHookParameterSchema.safeParse(value);
+};
+//# sourceMappingURL=execution-context-establishment-hooks.js.map

package/dist/esm/execution-context-establishment-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context-establishment-hooks.js","sourceRoot":"","sources":["../../src/execution-context-establishment-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,QAAQ,CAAC;AAEvB,MAAM,kDAAkD,GAAG,CAAC,CAAC,MAAM,CAAC;IACnE,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACpC,yBAAyB,EAAE,CAAC,CAAC,MAAM,CAAC;QACnC,KAAK,EAAE,CAAC,CAAC,KAAK,CACb,CAAC;aACC,MAAM,CAAC;YACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;YACpB,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;SACtD,CAAC;aACD,KAAK,EAAE,CACT;KACD,CAAC;CACF,CAAC,CAAC;AAMH,MAAM,CAAC,MAAM,gDAAgD,GAAG,CAAC;KAC/D,kBAAkB,CAAC,wBAAwB,EAAE;IAC7C,kDAAkD;CAClD,CAAC;KACD,IAAI,CAAC;IACL,KAAK,EAAE,4CAA4C;CACnD,CAAC,CAAC;AAMJ;;;;GAIG;AACH,MAAM,CAAC,MAAM,4CAA4C,GAAG,CAAC,KAAc,EAAE,EAAE;IAC9E,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxE,OAAO,IAAI,CAAC;IACb,CAAC;IACD,oDAAoD;IACpD,IAAI,CAAC,CAAC,wBAAwB,IAAI,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACb,CAAC;IACD,OAAO,gDAAgD,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC1E,CAAC,CAAC"}

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

@@ -0,0 +1,113 @@
+import z, { type ZodType } from 'zod/v4';
+declare const CredentialContextSchemaV1: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    identity: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type ICredentialContextV1 = z.output<typeof CredentialContextSchemaV1>;
+export declare const CredentialContextSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    identity: z.ZodString;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>]>;
+/**
+ * Decrypted structure of credentials field
+ * Never stored in this form - always encrypted in IExecutionContext
+ */
+export type ICredentialContext = z.output<typeof CredentialContextSchema>;
+declare const WorkflowExecuteModeSchema: z.ZodUnion<readonly [z.ZodLiteral<"cli">, z.ZodLiteral<"error">, z.ZodLiteral<"integrated">, z.ZodLiteral<"internal">, z.ZodLiteral<"manual">, z.ZodLiteral<"retry">, z.ZodLiteral<"trigger">, z.ZodLiteral<"webhook">, z.ZodLiteral<"evaluation">, z.ZodLiteral<"chat">]>;
+export type WorkflowExecuteModeValues = z.infer<typeof WorkflowExecuteModeSchema>;
+declare const ExecutionContextSchemaV1: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    establishedAt: z.ZodNumber;
+    source: z.ZodUnion<readonly [z.ZodLiteral<"cli">, z.ZodLiteral<"error">, z.ZodLiteral<"integrated">, z.ZodLiteral<"internal">, z.ZodLiteral<"manual">, z.ZodLiteral<"retry">, z.ZodLiteral<"trigger">, z.ZodLiteral<"webhook">, z.ZodLiteral<"evaluation">, z.ZodLiteral<"chat">]>;
+    triggerNode: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+    parentExecutionId: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type IExecutionContextV1 = z.output<typeof ExecutionContextSchemaV1>;
+export declare const ExecutionContextSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    establishedAt: z.ZodNumber;
+    source: z.ZodUnion<readonly [z.ZodLiteral<"cli">, z.ZodLiteral<"error">, z.ZodLiteral<"integrated">, z.ZodLiteral<"internal">, z.ZodLiteral<"manual">, z.ZodLiteral<"retry">, z.ZodLiteral<"trigger">, z.ZodLiteral<"webhook">, z.ZodLiteral<"evaluation">, z.ZodLiteral<"chat">]>;
+    triggerNode: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        type: z.ZodString;
+    }, z.core.$strip>>;
+    parentExecutionId: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>;
+/**
+ * Execution context carries per-execution metadata throughout workflow lifecycle
+ * Established at execution start and propagated to sub-workflows/error workflows
+ */
+export type IExecutionContext = z.output<typeof ExecutionContextSchema>;
+/**
+ * Runtime representation of execution context with decrypted credential data.
+ *
+ * This type is identical to IExecutionContext except the `credentials` field
+ * contains the decrypted ICredentialContext object instead of an encrypted string.
+ *
+ * **Usage contexts:**
+ * - Hook execution: Hooks work with plaintext context to extract/merge credential data
+ * - Credential resolution: Resolvers need decrypted identity tokens
+ * - Internal processing: Runtime operations that need access to credential context
+ *
+ * **Security notes:**
+ * - Never persist this type to database - use IExecutionContext with encrypted credentials
+ * - Never expose in API responses or logs
+ * - Only exists in-memory during workflow execution
+ * - Should be cleared from memory after use
+ *
+ * **Lifecycle:**
+ * 1. Load IExecutionContext from storage (credentials encrypted)
+ * 2. Decrypt credentials field → PlaintextExecutionContext (runtime only)
+ * 3. Use for hook execution, credential resolution, etc.
+ * 4. Encrypt credentials → IExecutionContext before persistence
+ *
+ * @see IExecutionContext - Persisted form with encrypted credentials
+ * @see ICredentialContext - Decrypted credential structure
+ * @see IExecutionContextUpdate - Partial updates during hook execution
+ *
+ * @example
+ * ```typescript
+ * // During hook execution:
+ * const plaintextContext: PlaintextExecutionContext = {
+ *   ...context,
+ *   credentials: decryptCredentials(context.credentials) // Decrypt for runtime use
+ * };
+ *
+ * // Hook can now access plaintext credential data
+ * const identity = plaintextContext.credentials?.identity;
+ *
+ * // Before storage, re-encrypt:
+ * const storableContext: IExecutionContext = {
+ *   ...plaintextContext,
+ *   credentials: encryptCredentials(plaintextContext.credentials)
+ * };
+ * ```
+ */
+export type PlaintextExecutionContext = Omit<IExecutionContext, 'credentials'> & {
+    credentials?: ICredentialContext;
+};
+export declare const safeParse: <T extends ZodType>(value: string | object, schema: T) => z.core.output<T>;
+/**
+ * Safely parses an execution context from an
+ * @param obj
+ * @returns
+ */
+export declare const toExecutionContext: (value: string | object) => IExecutionContext;
+/**
+ * Safely parses a credential context from either an object or a string to an
+ * ICredentialContext. This can be used to safely parse a decrypted context for
+ * example.
+ * @param value The object or string to be parsed
+ * @returns ICredentialContext
+ * @throws Error in case parsing fails for any reason
+ */
+export declare const toCredentialContext: (value: string | object) => ICredentialContext;
+export {};
+//# sourceMappingURL=execution-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../src/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,EAAE,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAIzC,QAAA,MAAM,yBAAyB;;;;iBAY7B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE9E,eAAO,MAAM,uBAAuB;;;;mBAIjC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE1E,QAAA,MAAM,yBAAyB,4QAW7B,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF,QAAA,MAAM,wBAAwB;;;;;;;;;;iBAqC5B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE5E,eAAO,MAAM,sBAAsB;;;;;;;;;;mBAIhC,CAAC;AAEJ;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,MAAM,yBAAyB,GAAG,IAAI,CAAC,iBAAiB,EAAE,aAAa,CAAC,GAAG;IAChF,WAAW,CAAC,EAAE,kBAAkB,CAAC;CACjC,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,CAAC,SAAS,OAAO,EAAE,OAAO,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,qBAe7E,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,GAAG,MAAM,KAAG,iBAG3D,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,GAAG,MAAM,KAAG,kBAG5D,CAAC"}

package/dist/esm/execution-context.js

@@ -0,0 +1,108 @@
+import z, {} from 'zod/v4';
+import { jsonParse } from './utils';
+const CredentialContextSchemaV1 = z.object({
+    version: z.literal(1),
+    /**
+     * Identity token/value used for credential resolution
+     * Could be JWT, API key, session token, user ID, etc.
+     */
+    identity: z.string(),
+    /**
+     * Optional metadata for credential resolution
+     */
+    metadata: z.record(z.string(), z.unknown()).optional(),
+});
+export const CredentialContextSchema = z
+    .discriminatedUnion('version', [CredentialContextSchemaV1])
+    .meta({
+    title: 'ICredentialContext',
+});
+const WorkflowExecuteModeSchema = z.union([
+    z.literal('cli'),
+    z.literal('error'),
+    z.literal('integrated'),
+    z.literal('internal'),
+    z.literal('manual'),
+    z.literal('retry'),
+    z.literal('trigger'),
+    z.literal('webhook'),
+    z.literal('evaluation'),
+    z.literal('chat'),
+]);
+const ExecutionContextSchemaV1 = z.object({
+    version: z.literal(1),
+    /**
+     * When the context was established (Unix timestamp in milliseconds)
+     */
+    establishedAt: z.number(),
+    /**
+     * The mode in which the workflow is being executed
+     */
+    source: WorkflowExecuteModeSchema,
+    /**
+     * Optional node where execution started
+     */
+    triggerNode: z
+        .object({
+        name: z.string(),
+        type: z.string(),
+    })
+        .optional(),
+    /**
+     * Optional ID of the parent execution, if this is set this
+     * execution context inherited from the mentioned parent execution context.
+     */
+    parentExecutionId: z.string().optional(),
+    /**
+     * Encrypted credential context for dynamic credential resolution
+     * Always encrypted when stored, decrypted on-demand by credential resolver
+     * @see ICredentialContext for decrypted structure
+     */
+    credentials: z.string().optional().meta({
+        description: 'Encrypted credential context for dynamic credential resolution Always encrypted when stored, decrypted on-demand by credential resolver @see ICredentialContext for decrypted structure',
+    }),
+});
+export const ExecutionContextSchema = z
+    .discriminatedUnion('version', [ExecutionContextSchemaV1])
+    .meta({
+    title: 'IExecutionContext',
+});
+export const safeParse = (value, schema) => {
+    const typeName = schema.meta()?.title ?? 'Object';
+    try {
+        const normalizedObject = typeof value === 'string' ? jsonParse(value) : value;
+        const parseResult = schema.safeParse(normalizedObject);
+        if (parseResult.error) {
+            throw parseResult.error;
+        }
+        // here we could implement a mgiration policy for migrating old execution context versions to newer ones
+        return parseResult.data;
+    }
+    catch (error) {
+        throw new Error(`Failed to parse to valid ${typeName}`, {
+            cause: error,
+        });
+    }
+};
+/**
+ * Safely parses an execution context from an
+ * @param obj
+ * @returns
+ */
+export const toExecutionContext = (value) => {
+    // here we could implement a mgiration policy for migrating old execution context versions to newer ones
+    return safeParse(value, ExecutionContextSchema);
+};
+/**
+ * Safely parses a credential context from either an object or a string to an
+ * ICredentialContext. This can be used to safely parse a decrypted context for
+ * example.
+ * @param value The object or string to be parsed
+ * @returns ICredentialContext
+ * @throws Error in case parsing fails for any reason
+ */
+export const toCredentialContext = (value) => {
+    // here we could implement a mgiration policy for migrating old credential context versions to newer ones
+    return safeParse(value, CredentialContextSchema);
+};
+//# sourceMappingURL=execution-context.js.map

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

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

package/dist/esm/execution-status.d.ts

@@ -0,0 +1,3 @@
+export declare const ExecutionStatusList: readonly ["canceled", "crashed", "error", "new", "running", "success", "unknown", "waiting"];
+export type ExecutionStatus = (typeof ExecutionStatusList)[number];
+//# sourceMappingURL=execution-status.d.ts.map

package/dist/esm/execution-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-status.d.ts","sourceRoot":"","sources":["../../src/execution-status.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,8FAStB,CAAC;AAEX,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/esm/execution-status.js

@@ -0,0 +1,11 @@
+export const ExecutionStatusList = [
+    'canceled',
+    'crashed',
+    'error',
+    'new',
+    'running',
+    'success',
+    'unknown',
+    'waiting',
+];
+//# sourceMappingURL=execution-status.js.map

package/dist/esm/execution-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-status.js","sourceRoot":"","sources":["../../src/execution-status.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,UAAU;IACV,SAAS;IACT,OAAO;IACP,KAAK;IACL,SAAS;IACT,SAAS;IACT,SAAS;IACT,SAAS;CACA,CAAC"}

package/dist/esm/expression-evaluator-proxy.d.ts

@@ -0,0 +1,6 @@
+type Evaluator = (expr: string, data: unknown) => string | null | (() => unknown);
+type ErrorHandler = (error: Error) => void;
+export declare const setErrorHandler: (handler: ErrorHandler) => void;
+export declare const evaluateExpression: Evaluator;
+export {};
+//# sourceMappingURL=expression-evaluator-proxy.d.ts.map

package/dist/esm/expression-evaluator-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-evaluator-proxy.d.ts","sourceRoot":"","sources":["../../src/expression-evaluator-proxy.ts"],"names":[],"mappings":"AAQA,KAAK,SAAS,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC;AAClF,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AAS3C,eAAO,MAAM,eAAe,GAAI,SAAS,YAAY,SAEpD,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,SAEhC,CAAC"}

package/dist/esm/expression-evaluator-proxy.js

@@ -0,0 +1,15 @@
+import { Tournament } from '@n8n/tournament';
+import { DollarSignValidator, FunctionThisSanitizer, PrototypeSanitizer, } from './expression-sandboxing';
+const errorHandler = () => { };
+const tournamentEvaluator = new Tournament(errorHandler, undefined, undefined, {
+    before: [FunctionThisSanitizer],
+    after: [PrototypeSanitizer, DollarSignValidator],
+});
+const evaluator = tournamentEvaluator.execute.bind(tournamentEvaluator);
+export const setErrorHandler = (handler) => {
+    tournamentEvaluator.errorHandler = handler;
+};
+export const evaluateExpression = (expr, data) => {
+    return evaluator(expr, data);
+};
+//# sourceMappingURL=expression-evaluator-proxy.js.map

package/dist/esm/expression-evaluator-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-evaluator-proxy.js","sourceRoot":"","sources":["../../src/expression-evaluator-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,OAAO,EACN,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AAKjC,MAAM,YAAY,GAAiB,GAAG,EAAE,GAAE,CAAC,CAAC;AAC5C,MAAM,mBAAmB,GAAG,IAAI,UAAU,CAAC,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE;IAC9E,MAAM,EAAE,CAAC,qBAAqB,CAAC;IAC/B,KAAK,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;CAChD,CAAC,CAAC;AACH,MAAM,SAAS,GAAc,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AAEnF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAqB,EAAE,EAAE;IACxD,mBAAmB,CAAC,YAAY,GAAG,OAAO,CAAC;AAC5C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAc,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IAC3D,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC,CAAC"}

package/dist/esm/expression-sandboxing.d.ts

@@ -0,0 +1,24 @@
+import { type ASTAfterHook, type ASTBeforeHook } from '@n8n/tournament';
+export declare const sanitizerName = "__sanitize";
+export declare const DOLLAR_SIGN_ERROR = "Cannot access \"$\" without calling it as a function";
+/**
+ * Prevents regular functions from binding their `this` to the Node.js global.
+ */
+export declare const FunctionThisSanitizer: ASTBeforeHook;
+/**
+ * Validates that the $ identifier is only used in allowed contexts.
+ * This prevents user errors like `{{ $ }}` which would return the function object itself.
+ *
+ * Allowed contexts:
+ * - As a function call: $()
+ * - As a property name: obj.$ (where $ is a valid property name in JavaScript)
+ *
+ * Disallowed contexts:
+ * - Bare identifier: $
+ * - As object in member expression: $.property
+ * - In expressions: "prefix" + $, [1, 2, $], etc.
+ */
+export declare const DollarSignValidator: ASTAfterHook;
+export declare const PrototypeSanitizer: ASTAfterHook;
+export declare const sanitizer: (value: unknown) => unknown;
+//# sourceMappingURL=expression-sandboxing.d.ts.map

package/dist/esm/expression-sandboxing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expression-sandboxing.d.ts","sourceRoot":"","sources":["../../src/expression-sandboxing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAA8B,MAAM,iBAAiB,CAAC;AAKpG,eAAO,MAAM,aAAa,eAAe,CAAC;AAG1C,eAAO,MAAM,iBAAiB,yDAAuD,CAAC;AA+CtF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,aA0DnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAsDjC,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,YAyChC,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,OAK1C,CAAC"}