@n8n/expression-runtime 0.29.1 → 0.31.0

package/dist/cjs/runtime/transfer.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Framing for values that cross the runtime boundary.
+ *
+ * Results cross by structured clone, which does not carry the prototype of a
+ * class instance. A type the host must get back as a real instance goes across
+ * as a structured-cloneable marker object instead: a plain object naming its
+ * type under `__n8nType`, which the host reads and rebuilds from.
+ *
+ * This module knows the framing and nothing about any single type. The encoders
+ * and the decoders live next to the type they carry, such as `luxon-transfer`.
+ *
+ * User data can hold the same keys. The escape wrapper below lets the host tell
+ * a marker from user data that looks like one.
+ */
+/** Names the type a marker carries, and marks the object as one of ours. */
+export declare const TRANSFER_TYPE_KEY = "__n8nType";
+/** Marks a wrapper whose payload is user data, not a marker. */
+export declare const TRANSFER_ESCAPED_KEY = "__n8nEscaped";
+/** Marks an escaped payload the host must return without any walk. */
+export declare const TRANSFER_OPAQUE_KEY = "__n8nOpaque";
+/** Holds the payload of an escaped wrapper. */
+export declare const TRANSFER_VALUE_KEY = "__value";
+/**
+ * Keys that make an object look like our framing.
+ *
+ * An object with one of these own keys is escaped, so the host reads it as
+ * data. The opaque flag is in the set for the same reason. If it were not, user
+ * data that holds it would make the host return an object without a walk.
+ *
+ * One type key covers every marker, so a new type does not grow this set.
+ */
+export declare const TRANSFER_FRAMING_KEYS: readonly string[];
+export interface TransferSentinel {
+    [TRANSFER_TYPE_KEY]: string;
+}
+export interface EscapedTransferValue {
+    [TRANSFER_ESCAPED_KEY]: true;
+    [TRANSFER_OPAQUE_KEY]?: true;
+    [TRANSFER_VALUE_KEY]: unknown;
+}
+/**
+ * Rebuild a real instance from a marker.
+ *
+ * Only the guest walk writes the type key, and it escapes any user object that
+ * carries one, so a decoder only ever sees a type its own encoder wrote.
+ */
+export type SentinelDecoder = (sentinel: TransferSentinel) => unknown;
+/** Give back a sentinel for a value the decoder owns, or nothing for any other. */
+export type SentinelEncoder = (value: object) => TransferSentinel | undefined;
+/** The type a marker names, or nothing when the value is not a marker. */
+export declare function transferTypeOf(value: unknown): string | undefined;
+export declare function isTransferSentinel(value: unknown): value is TransferSentinel;
+export declare function isEscapedTransferValue(value: unknown): value is EscapedTransferValue;
+/**
+ * An escaped wrapper whose payload must be returned as data without any
+ * further inspection for markers.
+ */
+export declare function isOpaqueTransferValue(value: unknown): boolean;
+/** Type guard: plain object with Object.prototype or null prototype. */
+export declare function isPlainObject(value: object): value is Record<string, unknown>;
+/** Types that structured clone copies with the prototype intact. */
+export declare function isStructuredCloneBuiltin(value: object): boolean;
+/**
+ * Rebuild instances from the markers `__prepareForTransfer` emits.
+ *
+ * Walks the same shapes that function walks: a top-level value, arrays, and
+ * plain objects. Other structured-cloneable types are returned untouched.
+ * A payload marked opaque is returned as data, without any inspection.
+ * Objects already visited are reused, so a graph that repeats or contains
+ * itself is walked once.
+ *
+ * A value that holds no marker is given back as it is. The walk copies every
+ * plain object and array it enters, and most results carry no marker at all,
+ * so the copy would double what an expression allocates for nothing.
+ */
+export declare function unwrapTransferSentinels(value: unknown, decode: SentinelDecoder): unknown;
+//# sourceMappingURL=transfer.d.ts.map

package/dist/cjs/runtime/transfer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfer.d.ts","sourceRoot":"","sources":["../../../src/runtime/transfer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C,gEAAgE;AAChE,eAAO,MAAM,oBAAoB,iBAAiB,CAAC;AAEnD,sEAAsE;AACtE,eAAO,MAAM,mBAAmB,gBAAgB,CAAC;AAEjD,+CAA+C;AAC/C,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAIlD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAChC,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACpC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IAC7B,CAAC,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAC;IAC7B,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,gBAAgB,KAAK,OAAO,CAAC;AAEtE,mFAAmF;AACnF,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,GAAG,SAAS,CAAC;AAO9E,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGjE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,oBAAoB,CAEpF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG7E;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAW/D;AAyED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAGxF"}

package/dist/cjs/runtime/transfer.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Framing for values that cross the runtime boundary.
+ *
+ * Results cross by structured clone, which does not carry the prototype of a
+ * class instance. A type the host must get back as a real instance goes across
+ * as a structured-cloneable marker object instead: a plain object naming its
+ * type under `__n8nType`, which the host reads and rebuilds from.
+ *
+ * This module knows the framing and nothing about any single type. The encoders
+ * and the decoders live next to the type they carry, such as `luxon-transfer`.
+ *
+ * User data can hold the same keys. The escape wrapper below lets the host tell
+ * a marker from user data that looks like one.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRANSFER_FRAMING_KEYS = exports.TRANSFER_VALUE_KEY = exports.TRANSFER_OPAQUE_KEY = exports.TRANSFER_ESCAPED_KEY = exports.TRANSFER_TYPE_KEY = void 0;
+exports.transferTypeOf = transferTypeOf;
+exports.isTransferSentinel = isTransferSentinel;
+exports.isEscapedTransferValue = isEscapedTransferValue;
+exports.isOpaqueTransferValue = isOpaqueTransferValue;
+exports.isPlainObject = isPlainObject;
+exports.isStructuredCloneBuiltin = isStructuredCloneBuiltin;
+exports.unwrapTransferSentinels = unwrapTransferSentinels;
+/** Names the type a marker carries, and marks the object as one of ours. */
+exports.TRANSFER_TYPE_KEY = '__n8nType';
+/** Marks a wrapper whose payload is user data, not a marker. */
+exports.TRANSFER_ESCAPED_KEY = '__n8nEscaped';
+/** Marks an escaped payload the host must return without any walk. */
+exports.TRANSFER_OPAQUE_KEY = '__n8nOpaque';
+/** Holds the payload of an escaped wrapper. */
+exports.TRANSFER_VALUE_KEY = '__value';
+/**
+ * Keys that make an object look like our framing.
+ *
+ * An object with one of these own keys is escaped, so the host reads it as
+ * data. The opaque flag is in the set for the same reason. If it were not, user
+ * data that holds it would make the host return an object without a walk.
+ *
+ * One type key covers every marker, so a new type does not grow this set.
+ */
+exports.TRANSFER_FRAMING_KEYS = [
+    exports.TRANSFER_TYPE_KEY,
+    exports.TRANSFER_ESCAPED_KEY,
+    exports.TRANSFER_OPAQUE_KEY,
+];
+function readKey(value, key) {
+    if (typeof value !== 'object' || value === null)
+        return undefined;
+    return Reflect.get(value, key);
+}
+/** The type a marker names, or nothing when the value is not a marker. */
+function transferTypeOf(value) {
+    const type = readKey(value, exports.TRANSFER_TYPE_KEY);
+    return typeof type === 'string' ? type : undefined;
+}
+function isTransferSentinel(value) {
+    return transferTypeOf(value) !== undefined;
+}
+function isEscapedTransferValue(value) {
+    return readKey(value, exports.TRANSFER_ESCAPED_KEY) === true;
+}
+/**
+ * An escaped wrapper whose payload must be returned as data without any
+ * further inspection for markers.
+ */
+function isOpaqueTransferValue(value) {
+    return readKey(value, exports.TRANSFER_OPAQUE_KEY) === true;
+}
+/** Type guard: plain object with Object.prototype or null prototype. */
+function isPlainObject(value) {
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/** Types that structured clone copies with the prototype intact. */
+function isStructuredCloneBuiltin(value) {
+    return (value instanceof Date ||
+        value instanceof RegExp ||
+        value instanceof Map ||
+        value instanceof Set ||
+        value instanceof Error ||
+        value instanceof Promise ||
+        value instanceof ArrayBuffer ||
+        ArrayBuffer.isView(value));
+}
+function unwrapPlainObject(value, decode, seen) {
+    const result = {};
+    // Record the result before the walk. A value that refers to itself then
+    // resolves to the same object.
+    seen.set(value, result);
+    for (const key of Object.keys(value)) {
+        result[key] = unwrapValue(value[key], decode, seen);
+    }
+    return result;
+}
+function unwrapValue(value, decode, seen) {
+    if (value === null || value === undefined)
+        return value;
+    if (typeof value !== 'object')
+        return value;
+    if (seen.has(value))
+        return seen.get(value);
+    if (Array.isArray(value)) {
+        const result = new Array(value.length);
+        seen.set(value, result);
+        // `forEach` steps over the holes of a sparse array, which keeps it sparse.
+        value.forEach((item, index) => {
+            result[index] = unwrapValue(item, decode, seen);
+        });
+        return result;
+    }
+    if (!isPlainObject(value))
+        return value;
+    if (isTransferSentinel(value))
+        return decode(value);
+    if (isEscapedTransferValue(value)) {
+        const inner = value[exports.TRANSFER_VALUE_KEY];
+        // An opaque payload is a value the guest could not walk, so nothing in it
+        // is our framing. Give it back as it is. A walked payload only had its own
+        // keys collide, so the walk goes on below and rebuilds markers deeper in.
+        if (isOpaqueTransferValue(value))
+            return inner;
+        if (typeof inner !== 'object' || inner === null)
+            return inner;
+        // An array payload is walked as an array. Its own entries carry no framing,
+        // so reading it as a marker is never right.
+        if (Array.isArray(inner))
+            return unwrapValue(inner, decode, seen);
+        if (!isPlainObject(inner))
+            return inner;
+        return unwrapPlainObject(inner, decode, seen);
+    }
+    return unwrapPlainObject(value, decode, seen);
+}
+/**
+ * Say whether a value holds anything the walk would rebuild.
+ *
+ * Reads the same shapes the walk reads and builds nothing, so a result with no
+ * marker in it costs a read and no memory. `for...in` over a plain object and
+ * an index loop over an array both avoid the key array `Object.keys` returns.
+ */
+function holdsSentinel(value, seen) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    if (seen.has(value))
+        return false;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        for (let index = 0; index < value.length; index++) {
+            if (holdsSentinel(value[index], seen))
+                return true;
+        }
+        return false;
+    }
+    if (!isPlainObject(value))
+        return false;
+    if (isTransferSentinel(value) || isEscapedTransferValue(value))
+        return true;
+    for (const key in value) {
+        if (holdsSentinel(value[key], seen))
+            return true;
+    }
+    return false;
+}
+/**
+ * Rebuild instances from the markers `__prepareForTransfer` emits.
+ *
+ * Walks the same shapes that function walks: a top-level value, arrays, and
+ * plain objects. Other structured-cloneable types are returned untouched.
+ * A payload marked opaque is returned as data, without any inspection.
+ * Objects already visited are reused, so a graph that repeats or contains
+ * itself is walked once.
+ *
+ * A value that holds no marker is given back as it is. The walk copies every
+ * plain object and array it enters, and most results carry no marker at all,
+ * so the copy would double what an expression allocates for nothing.
+ */
+function unwrapTransferSentinels(value, decode) {
+    if (!holdsSentinel(value, new Set()))
+        return value;
+    return unwrapValue(value, decode, new Map());
+}
+//# sourceMappingURL=transfer.js.map

package/dist/cjs/runtime/transfer.js.map

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

package/dist/cjs/types/bridge.d.ts

@@ -14,6 +14,17 @@ export interface RuntimeBridge {
      * Must be called before any execute() calls.
      */
     initialize(): Promise<void>;
+    /**
+     * Synchronous variant of initialize(), for creating a bridge on demand
+     * from inside the synchronous evaluate() path (lazy acquisition with an
+     * exhausted pool). Optional: a bridge whose setup is inherently async can
+     * omit it, but then it can only enter service through pool warmup.
+     *
+     * May require one-time async preparation to have happened earlier in the
+     * process (e.g. QuickJS's WASM module load); implementations must throw a
+     * clear error when that preparation is missing.
+     */
+    initializeSync?(): void;
     /**
      * Execute JavaScript code in the isolated context.
      *
@@ -65,6 +76,11 @@ export interface BridgeConfig {
     timeout?: number;
     /** Optional logger. Falls back to no-op if not provided. */
     logger?: Logger;
+    /**
+     * Reuse V8 compile cache for the runtime bundle. isolated-vm only.
+     * Default: false
+     */
+    compileCache?: boolean;
 }
 /** Default values for BridgeConfig. Bridge implementations should use this as their baseline. */
 export declare const DEFAULT_BRIDGE_CONFIG: Required<BridgeConfig>;

package/dist/cjs/types/bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/types/bridge.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IAE7E;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AASD,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAIxD,CAAC;AAEF,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/types/bridge.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC7B;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;;;;;;OASG;IACH,cAAc,CAAC,IAAI,IAAI,CAAC;IAExB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC;IAE7E;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,UAAU,IAAI,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACtB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACjE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACvB;AASD,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,YAAY,CAKxD,CAAC;AAEF,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB"}

package/dist/cjs/types/bridge.js

@@ -18,5 +18,6 @@ exports.DEFAULT_BRIDGE_CONFIG = {
     memoryLimit: 128,
     timeout: 5000,
     logger: NO_OP_LOGGER,
+    compileCache: false,
 };
 //# sourceMappingURL=bridge.js.map

package/dist/cjs/types/bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/types/bridge.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,uDAAuD;AACvD,EAAE;AACF,8DAA8D;AAC9D,+EAA+E;AAC/E,+EAA+E;;;AA+E/E,MAAM,YAAY,GAAW;IAC5B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CACf,CAAC;AAEF,iGAAiG;AACpF,QAAA,qBAAqB,GAA2B;IAC5D,WAAW,EAAE,GAAG;IAChB,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,YAAY;CACpB,CAAC"}
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../../../src/types/bridge.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,uDAAuD;AACvD,EAAE;AACF,8DAA8D;AAC9D,+EAA+E;AAC/E,+EAA+E;;;AAiG/E,MAAM,YAAY,GAAW;IAC5B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;IACf,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;IACd,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;CACf,CAAC;AAEF,iGAAiG;AACpF,QAAA,qBAAqB,GAA2B;IAC5D,WAAW,EAAE,GAAG;IAChB,OAAO,EAAE,IAAI;IACb,MAAM,EAAE,YAAY;IACpB,YAAY,EAAE,KAAK;CACnB,CAAC"}

package/dist/cjs/types/evaluator.d.ts

@@ -32,6 +32,15 @@ export interface EvaluatorConfig {
     poolSize?: number;
     /** If set, scale the pool to 0 warm bridges after this many ms with no isolate acquire. */
     idleTimeoutMs?: number;
+    /**
+     * Lazy acquisition mode (prototype): acquire() only opens a scope for the
+     * caller; the bridge is created synchronously on the first evaluate() that
+     * actually needs the engine. Callers whose expressions never reach the
+     * engine (e.g. handled by a host-side fast path) never consume a bridge.
+     * On pool exhaustion the bridge is cold-started synchronously via
+     * RuntimeBridge.initializeSync().
+     */
+    lazyAcquire?: boolean;
     /** Optional logger. Passed through to pool. Falls back to no-op. */
     logger?: Logger;
 }

package/dist/cjs/types/evaluator.d.ts.map

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

package/dist/cjs/types/evaluator.js.map

@@ -1 +1 @@
-{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../src/types/evaluator.ts"],"names":[],"mappings":";;;AA+UA,+EAA+E;AAC/E,uDAAuD;AACvD,EAAE;AACF,0DAA0D;AAC1D,wDAAwD;AACxD,+EAA+E;AAE/E;;GAEG;AACH,qBAA6B,SAAQ,KAAK;IAGjC,OAAO;IAFf,YACC,OAAe,EACR,OAKN;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;uBAPR,OAAO;QAQd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;;AAED;;GAEG;AACH,sBAA8B,SAAQ,eAAe;CAAG;;AACxD,kBAA0B,SAAQ,eAAe;CAAG;;AACpD,4BAAoC,SAAQ,eAAe;CAAG;;AAC9D,iBAAyB,SAAQ,eAAe;CAAG"}
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../src/types/evaluator.ts"],"names":[],"mappings":";;;AAyVA,+EAA+E;AAC/E,uDAAuD;AACvD,EAAE;AACF,0DAA0D;AAC1D,wDAAwD;AACxD,+EAA+E;AAE/E;;GAEG;AACH,qBAA6B,SAAQ,KAAK;IAGjC,OAAO;IAFf,YACC,OAAe,EACR,OAKN;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;uBAPR,OAAO;QAQd,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;;AAED;;GAEG;AACH,sBAA8B,SAAQ,eAAe;CAAG;;AACxD,kBAA0B,SAAQ,eAAe;CAAG;;AACpD,4BAAoC,SAAQ,eAAe;CAAG;;AAC9D,iBAAyB,SAAQ,eAAe;CAAG"}

package/dist/esm/bridge/host-functions.d.ts

@@ -0,0 +1,74 @@
+import type { WorkflowData } from '../types';
+import type { ErrorSentinel } from '../runtime/lazy-proxy';
+/** Check if a value is an error sentinel returned by serializeError. */
+export declare function isErrorSentinel(value: unknown): value is ErrorSentinel;
+/**
+ * Serialize an error into a transferable metadata object.
+ *
+ * Host-side callbacks (getValueAtPath, etc.) catch errors and return this
+ * sentinel instead of letting the error cross the boundary (which strips
+ * custom class identity and properties). The guest-side proxy detects
+ * __isError and throws the sentinel; the host reconstructs a real Error
+ * after it round-trips back (see reconstructError).
+ */
+export declare function serializeError(err: unknown): ErrorSentinel;
+/**
+ * Reconstruct an error from a serialized error sentinel.
+ *
+ * Restores the name, stack, and custom properties that would otherwise be
+ * lost crossing the guest boundary.
+ */
+export declare function reconstructError(data: ErrorSentinel): Error;
+/**
+ * Navigate the data object by path and return metadata or a primitive value.
+ *
+ * Used by createDeepLazyProxy when accessing properties. Returns metadata
+ * markers for arrays and objects, or the primitive value directly.
+ *
+ * Special-case: paths starting with ['$item', index] call data.$item(index)
+ * to get the sub-proxy for that item, then continue navigating the rest;
+ * likewise ['$', nodeName] calls data.$(nodeName).
+ *
+ * Function-typed values are returned as `undefined` — every callable on
+ * the host data surface (`$('Foo').first()`, `$items()`, `$fromAI()`,
+ * `$evaluateExpression()`, `$getPairedItem()`) is wired guest-side via
+ * the typed-RPC dispatcher (`callHost`). No expression form should
+ * reach a function through this path (invariant:
+ * __tests__/host-fn-shadowing.test.ts).
+ */
+export declare function getValueAtPath(data: WorkflowData, pathArr: string[]): unknown;
+/**
+ * Get an array element at an index, navigating to the array by path first
+ * (same `$`/`$item` special-casing as getValueAtPath).
+ *
+ * Used by the array proxy when accessing numeric indices.
+ */
+export declare function getArrayElement(data: WorkflowData, pathArr: string[], index: number): unknown;
+/**
+ * Host-side dispatcher for the typed-RPC `callHost` channel.
+ *
+ * The guest sends one envelope per typed RPC invocation:
+ *   `callHost({ type: 'getNodeFirst', nodeName, branchIndex?, runIndex? })`
+ *
+ * Inputs cross a trust boundary, so the dispatcher parses every envelope
+ * with the host-side zod schema (`bridgeMessageSchema`) before any
+ * dispatch happens. Anything that deviates from the declared shape —
+ * unknown `type`, missing required fields, extra unexpected fields,
+ * wrong field types — fails the parse and throws; the calling bridge
+ * catches and returns an error sentinel to the guest.
+ *
+ * After parsing, `switch (msg.type)` dispatches with a fully narrowed
+ * message type. The operation set is exactly the cases in this switch;
+ * the `type` field selects a static branch in source, not a property
+ * lookup on a runtime object. Each case reads a fixed literal property
+ * name off the host-side data proxy — the guest cannot influence which
+ * property is dereferenced.
+ *
+ * Return-value note: cases must return plain, structured-clone-able,
+ * JSON-shaped data. Each bridge marshals the result across its own
+ * boundary (structured clone for isolated-vm, sentinel-wrapped JSON
+ * round-trip for QuickJS), so engine objects or other non-cloneable
+ * values must not be returned.
+ */
+export declare function dispatchHostCall(rawMsg: unknown, data: WorkflowData): unknown;
+//# sourceMappingURL=host-functions.d.ts.map

package/dist/esm/bridge/host-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-functions.d.ts","sourceRoot":"","sources":["../../../src/bridge/host-functions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAc3D,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAMtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAc1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,KAAK,CAa3D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CA0D7E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAmE7F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CA2G7E"}