@trigger.dev/core 0.0.0-v3-prerelease-20250108142426 → 0.0.0-v4-prerelease-20250917185130

package/dist/commonjs/v3/limits.d.ts

@@ -1,11 +1,11 @@
 import { Attributes } from "@opentelemetry/api";
-export declare const OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT = 256;
-export declare const OTEL_LOG_ATTRIBUTE_COUNT_LIMIT = 256;
-export declare const OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT = 1028;
-export declare const OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_LIMIT = 1028;
-export declare const OTEL_SPAN_EVENT_COUNT_LIMIT = 10;
-export declare const OTEL_LINK_COUNT_LIMIT = 2;
-export declare const OTEL_ATTRIBUTE_PER_LINK_COUNT_LIMIT = 10;
-export declare const OTEL_ATTRIBUTE_PER_EVENT_COUNT_LIMIT = 10;
+export declare const OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT: number;
+export declare const OTEL_LOG_ATTRIBUTE_COUNT_LIMIT: number;
+export declare const OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT: number;
+export declare const OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_LIMIT: number;
+export declare const OTEL_SPAN_EVENT_COUNT_LIMIT: number;
+export declare const OTEL_LINK_COUNT_LIMIT: number;
+export declare const OTEL_ATTRIBUTE_PER_LINK_COUNT_LIMIT: number;
+export declare const OTEL_ATTRIBUTE_PER_EVENT_COUNT_LIMIT: number;
 export declare const OFFLOAD_IO_PACKET_LENGTH_LIMIT: number;
 export declare function imposeAttributeLimits(attributes: Attributes): Attributes;

package/dist/commonjs/v3/limits.js

@@ -2,14 +2,22 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OFFLOAD_IO_PACKET_LENGTH_LIMIT = exports.OTEL_ATTRIBUTE_PER_EVENT_COUNT_LIMIT = exports.OTEL_ATTRIBUTE_PER_LINK_COUNT_LIMIT = exports.OTEL_LINK_COUNT_LIMIT = exports.OTEL_SPAN_EVENT_COUNT_LIMIT = exports.OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_LIMIT = exports.OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT = exports.OTEL_LOG_ATTRIBUTE_COUNT_LIMIT = exports.OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT = void 0;
 exports.imposeAttributeLimits = imposeAttributeLimits;
-exports.OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT = 256;
-exports.OTEL_LOG_ATTRIBUTE_COUNT_LIMIT = 256;
-exports.OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT = 1028;
-exports.OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_LIMIT = 1028;
-exports.OTEL_SPAN_EVENT_COUNT_LIMIT = 10;
-exports.OTEL_LINK_COUNT_LIMIT = 2;
-exports.OTEL_ATTRIBUTE_PER_LINK_COUNT_LIMIT = 10;
-exports.OTEL_ATTRIBUTE_PER_EVENT_COUNT_LIMIT = 10;
+const getEnv_js_1 = require("./utils/getEnv.js");
+function getOtelEnvVarLimit(key, defaultValue) {
+    const value = (0, getEnv_js_1.getEnvVar)(key);
+    if (!value) {
+        return defaultValue;
+    }
+    return parseInt(value, 10);
+}
+exports.OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT", 1024);
+exports.OTEL_LOG_ATTRIBUTE_COUNT_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_LOG_ATTRIBUTE_COUNT_LIMIT", 1024);
+exports.OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT", 131072);
+exports.OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_LOG_ATTRIBUTE_VALUE_LENGTH_LIMIT", 131072);
+exports.OTEL_SPAN_EVENT_COUNT_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_SPAN_EVENT_COUNT_LIMIT", 10);
+exports.OTEL_LINK_COUNT_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_LINK_COUNT_LIMIT", 2);
+exports.OTEL_ATTRIBUTE_PER_LINK_COUNT_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_ATTRIBUTE_PER_LINK_COUNT_LIMIT", 10);
+exports.OTEL_ATTRIBUTE_PER_EVENT_COUNT_LIMIT = getOtelEnvVarLimit("TRIGGER_OTEL_ATTRIBUTE_PER_EVENT_COUNT_LIMIT", 10);
 exports.OFFLOAD_IO_PACKET_LENGTH_LIMIT = 128 * 1024;
 function imposeAttributeLimits(attributes) {
     const newAttributes = {};
@@ -17,9 +25,6 @@ function imposeAttributeLimits(attributes) {
         if (calculateAttributeValueLength(value) > exports.OTEL_SPAN_ATTRIBUTE_VALUE_LENGTH_LIMIT) {
             continue;
         }
-        if (Object.keys(newAttributes).length >= exports.OTEL_SPAN_ATTRIBUTE_COUNT_LIMIT) {
-            break;
-        }
         newAttributes[key] = value;
     }
     return newAttributes;

package/dist/commonjs/v3/limits.js.map

@@ -1 +1 @@
-{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/v3/limits.ts"],"names":[],"mappings":";;;AAYA,sDAgBC;AA1BY,QAAA,+BAA+B,GAAG,GAAG,CAAC;AACtC,QAAA,8BAA8B,GAAG,GAAG,CAAC;AACrC,QAAA,sCAAsC,GAAG,IAAI,CAAC;AAC9C,QAAA,qCAAqC,GAAG,IAAI,CAAC;AAC7C,QAAA,2BAA2B,GAAG,EAAE,CAAC;AACjC,QAAA,qBAAqB,GAAG,CAAC,CAAC;AAC1B,QAAA,mCAAmC,GAAG,EAAE,CAAC;AACzC,QAAA,oCAAoC,GAAG,EAAE,CAAC;AAC1C,QAAA,8BAA8B,GAAG,GAAG,GAAG,IAAI,CAAC;AAEzD,SAAgB,qBAAqB,CAAC,UAAsB;IAC1D,MAAM,aAAa,GAAe,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,6BAA6B,CAAC,KAAK,CAAC,GAAG,8CAAsC,EAAE,CAAC;YAClF,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,IAAI,uCAA+B,EAAE,CAAC;YACzE,MAAM;QACR,CAAC;QAED,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,6BAA6B,CAAC,KAAwC;IAC7E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,6BAA6B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"limits.js","sourceRoot":"","sources":["../../../src/v3/limits.ts"],"names":[],"mappings":";;;AA6CA,sDAYC;AAxDD,iDAA8C;AAE9C,SAAS,kBAAkB,CAAC,GAAW,EAAE,YAAoB;IAC3D,MAAM,KAAK,GAAG,IAAA,qBAAS,EAAC,GAAG,CAAC,CAAC;IAE7B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC7B,CAAC;AAEY,QAAA,+BAA+B,GAAG,kBAAkB,CAC/D,yCAAyC,EACzC,IAAI,CACL,CAAC;AACW,QAAA,8BAA8B,GAAG,kBAAkB,CAC9D,wCAAwC,EACxC,IAAI,CACL,CAAC;AACW,QAAA,sCAAsC,GAAG,kBAAkB,CACtE,gDAAgD,EAChD,MAAM,CACP,CAAC;AACW,QAAA,qCAAqC,GAAG,kBAAkB,CACrE,+CAA+C,EAC/C,MAAM,CACP,CAAC;AACW,QAAA,2BAA2B,GAAG,kBAAkB,CAC3D,qCAAqC,EACrC,EAAE,CACH,CAAC;AACW,QAAA,qBAAqB,GAAG,kBAAkB,CAAC,+BAA+B,EAAE,CAAC,CAAC,CAAC;AAC/E,QAAA,mCAAmC,GAAG,kBAAkB,CACnE,6CAA6C,EAC7C,EAAE,CACH,CAAC;AACW,QAAA,oCAAoC,GAAG,kBAAkB,CACpE,8CAA8C,EAC9C,EAAE,CACH,CAAC;AAEW,QAAA,8BAA8B,GAAG,GAAG,GAAG,IAAI,CAAC;AAEzD,SAAgB,qBAAqB,CAAC,UAAsB;IAC1D,MAAM,aAAa,GAAe,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QACtD,IAAI,6BAA6B,CAAC,KAAK,CAAC,GAAG,8CAAsC,EAAE,CAAC;YAClF,SAAS;QACX,CAAC;QAED,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC7B,CAAC;IAED,OAAO,aAAa,CAAC;AACvB,CAAC;AAED,SAAS,6BAA6B,CAAC,KAAwC;IAC7E,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC1C,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,6BAA6B,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commonjs/v3/links.d.ts

@@ -12,6 +12,17 @@ export declare const links: {
         upgrade: {
             beta: string;
         };
+        troubleshooting: {
+            concurrentWaits: string;
+            stalledExecution: string;
+        };
+        concurrency: {
+            recursiveDeadlock: string;
+            deadlock: string;
+        };
+        gitHubActions: {
+            personalAccessToken: string;
+        };
     };
     site: {
         home: string;

package/dist/commonjs/v3/links.js

@@ -15,6 +15,17 @@ exports.links = {
         upgrade: {
             beta: "https://trigger.dev/docs/upgrading-beta",
         },
+        troubleshooting: {
+            concurrentWaits: "https://trigger.dev/docs/troubleshooting#parallel-waits-are-not-supported",
+            stalledExecution: "https://trigger.dev/docs/troubleshooting#task-run-stalled-executing",
+        },
+        concurrency: {
+            recursiveDeadlock: "https://trigger.dev/docs/queue-concurrency#waiting-for-a-subtask-on-the-same-queue",
+            deadlock: "https://trigger.dev/docs/queue-concurrency#deadlock",
+        },
+        gitHubActions: {
+            personalAccessToken: "https://trigger.dev/docs/github-actions#creating-a-personal-access-token",
+        },
     },
     site: {
         home: "https://trigger.dev",

package/dist/commonjs/v3/links.js.map

@@ -1 +1 @@
-{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/v3/links.ts"],"names":[],"mappings":";;;AAAa,QAAA,KAAK,GAAG;IACnB,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,6CAA6C;YACnD,kBAAkB,EAAE,gEAAgE;YACpF,UAAU,EAAE,wDAAwD;YACpE,MAAM,EAAE,oDAAoD;SAC7D;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,sCAAsC;SAC7C;QACD,OAAO,EAAE;YACP,IAAI,EAAE,yCAAyC;SAChD;KACF;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,6BAA6B;KACvC;CACF,CAAC"}
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/v3/links.ts"],"names":[],"mappings":";;;AAAa,QAAA,KAAK,GAAG;IACnB,IAAI,EAAE;QACJ,MAAM,EAAE;YACN,IAAI,EAAE,6CAA6C;YACnD,kBAAkB,EAAE,gEAAgE;YACpF,UAAU,EAAE,wDAAwD;YACpE,MAAM,EAAE,oDAAoD;SAC7D;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,sCAAsC;SAC7C;QACD,OAAO,EAAE;YACP,IAAI,EAAE,yCAAyC;SAChD;QACD,eAAe,EAAE;YACf,eAAe,EAAE,2EAA2E;YAC5F,gBAAgB,EAAE,qEAAqE;SACxF;QACD,WAAW,EAAE;YACX,iBAAiB,EACf,oFAAoF;YACtF,QAAQ,EAAE,qDAAqD;SAChE;QACD,aAAa,EAAE;YACb,mBAAmB,EACjB,0EAA0E;SAC7E;KACF;IACD,IAAI,EAAE;QACJ,IAAI,EAAE,qBAAqB;QAC3B,OAAO,EAAE,6BAA6B;KACvC;CACF,CAAC"}

package/dist/commonjs/v3/locals/index.d.ts

@@ -0,0 +1,12 @@
+import { LocalsKey, type LocalsManager } from "./types.js";
+export declare class LocalsAPI implements LocalsManager {
+    #private;
+    private static _instance?;
+    private constructor();
+    static getInstance(): LocalsAPI;
+    setGlobalLocalsManager(localsManager: LocalsManager): boolean;
+    disable(): void;
+    createLocal<T>(id: string): LocalsKey<T>;
+    getLocal<T>(key: LocalsKey<T>): T | undefined;
+    setLocal<T>(key: LocalsKey<T>, value: T): void;
+}

package/dist/commonjs/v3/locals/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalsAPI = void 0;
+const API_NAME = "locals";
+const globals_js_1 = require("../utils/globals.js");
+const manager_js_1 = require("./manager.js");
+const NOOP_LOCALS_MANAGER = new manager_js_1.NoopLocalsManager();
+class LocalsAPI {
+    static _instance;
+    constructor() { }
+    static getInstance() {
+        if (!this._instance) {
+            this._instance = new LocalsAPI();
+        }
+        return this._instance;
+    }
+    setGlobalLocalsManager(localsManager) {
+        return (0, globals_js_1.registerGlobal)(API_NAME, localsManager);
+    }
+    disable() {
+        (0, globals_js_1.unregisterGlobal)(API_NAME);
+    }
+    createLocal(id) {
+        return this.#getManager().createLocal(id);
+    }
+    getLocal(key) {
+        return this.#getManager().getLocal(key);
+    }
+    setLocal(key, value) {
+        return this.#getManager().setLocal(key, value);
+    }
+    #getManager() {
+        return (0, globals_js_1.getGlobal)(API_NAME) ?? NOOP_LOCALS_MANAGER;
+    }
+}
+exports.LocalsAPI = LocalsAPI;
+//# sourceMappingURL=index.js.map

package/dist/commonjs/v3/locals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/locals/index.ts"],"names":[],"mappings":";;;AAAA,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAE1B,oDAAkF;AAClF,6CAAiD;AAGjD,MAAM,mBAAmB,GAAG,IAAI,8BAAiB,EAAE,CAAC;AAEpD,MAAa,SAAS;IACZ,MAAM,CAAC,SAAS,CAAa;IAErC,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,sBAAsB,CAAC,aAA4B;QACxD,OAAO,IAAA,2BAAc,EAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjD,CAAC;IAEM,OAAO;QACZ,IAAA,6BAAgB,EAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAEM,WAAW,CAAI,EAAU;QAC9B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAC5C,CAAC;IAEM,QAAQ,CAAI,GAAiB;QAClC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC1C,CAAC;IAEM,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QAC5C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,WAAW;QACT,OAAO,IAAA,sBAAS,EAAC,QAAQ,CAAC,IAAI,mBAAmB,CAAC;IACpD,CAAC;CACF;AApCD,8BAoCC"}

package/dist/commonjs/v3/locals/manager.d.ts

@@ -0,0 +1,13 @@
+import { LocalsKey, LocalsManager } from "./types.js";
+export declare class NoopLocalsManager implements LocalsManager {
+    createLocal<T>(id: string): LocalsKey<T>;
+    getLocal<T>(key: LocalsKey<T>): T | undefined;
+    setLocal<T>(key: LocalsKey<T>, value: T): void;
+}
+export declare class StandardLocalsManager implements LocalsManager {
+    private store;
+    createLocal<T>(id: string): LocalsKey<T>;
+    getLocal<T>(key: LocalsKey<T>): T | undefined;
+    setLocal<T>(key: LocalsKey<T>, value: T): void;
+    reset(): void;
+}

package/dist/commonjs/v3/locals/manager.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StandardLocalsManager = exports.NoopLocalsManager = void 0;
+class NoopLocalsManager {
+    createLocal(id) {
+        return {
+            __type: Symbol(),
+            id,
+        };
+    }
+    getLocal(key) {
+        return undefined;
+    }
+    setLocal(key, value) { }
+}
+exports.NoopLocalsManager = NoopLocalsManager;
+class StandardLocalsManager {
+    store = new Map();
+    createLocal(id) {
+        const key = Symbol.for(id);
+        return {
+            __type: key,
+            id,
+        };
+    }
+    getLocal(key) {
+        return this.store.get(key.__type);
+    }
+    setLocal(key, value) {
+        this.store.set(key.__type, value);
+    }
+    reset() {
+        this.store.clear();
+    }
+}
+exports.StandardLocalsManager = StandardLocalsManager;
+//# sourceMappingURL=manager.js.map

package/dist/commonjs/v3/locals/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../../../src/v3/locals/manager.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;IAC5B,WAAW,CAAI,EAAU;QACvB,OAAO;YACL,MAAM,EAAE,MAAM,EAAE;YAChB,EAAE;SACwB,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ,IAAS,CAAC;CAClD;AAbD,8CAaC;AAED,MAAa,qBAAqB;IACxB,KAAK,GAAyB,IAAI,GAAG,EAAE,CAAC;IAEhD,WAAW,CAAI,EAAU;QACvB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3B,OAAO;YACL,MAAM,EAAE,GAAG;YACX,EAAE;SACwB,CAAC;IAC/B,CAAC;IAED,QAAQ,CAAI,GAAiB;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAkB,CAAC;IACrD,CAAC;IAED,QAAQ,CAAI,GAAiB,EAAE,KAAQ;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF;AAtBD,sDAsBC"}

package/dist/commonjs/v3/locals/types.d.ts

@@ -0,0 +1,14 @@
+declare const __local: unique symbol;
+type BrandLocal<T> = {
+    [__local]: T;
+};
+export type LocalsKey<T> = BrandLocal<T> & {
+    readonly id: string;
+    readonly __type: unique symbol;
+};
+export interface LocalsManager {
+    createLocal<T>(id: string): LocalsKey<T>;
+    getLocal<T>(key: LocalsKey<T>): T | undefined;
+    setLocal<T>(key: LocalsKey<T>, value: T): void;
+}
+export {};

package/dist/commonjs/v3/locals/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/commonjs/v3/locals/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/v3/locals/types.ts"],"names":[],"mappings":""}

package/dist/commonjs/v3/locals-api.d.ts

@@ -0,0 +1,12 @@
+import { LocalsAPI } from "./locals/index.js";
+import type { LocalsKey } from "./locals/types.js";
+/** Entrypoint for runtime API */
+export declare const localsAPI: LocalsAPI;
+export declare const locals: {
+    create<T>(id: string): LocalsKey<T>;
+    get<T>(key: LocalsKey<T>): T | undefined;
+    getOrThrow<T>(key: LocalsKey<T>): T;
+    set<T>(key: LocalsKey<T>, value: T): T;
+};
+export type Locals = typeof locals;
+export type { LocalsKey };

package/dist/commonjs/v3/locals-api.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.locals = exports.localsAPI = void 0;
+// Split module-level variable definition into separate files to allow
+// tree-shaking on each api instance.
+const index_js_1 = require("./locals/index.js");
+/** Entrypoint for runtime API */
+exports.localsAPI = index_js_1.LocalsAPI.getInstance();
+exports.locals = {
+    create(id) {
+        return exports.localsAPI.createLocal(id);
+    },
+    get(key) {
+        return exports.localsAPI.getLocal(key);
+    },
+    getOrThrow(key) {
+        const value = exports.localsAPI.getLocal(key);
+        if (!value) {
+            throw new Error(`Local with id ${key.id} not found`);
+        }
+        return value;
+    },
+    set(key, value) {
+        exports.localsAPI.setLocal(key, value);
+        return value;
+    },
+};
+//# sourceMappingURL=locals-api.js.map

package/dist/commonjs/v3/locals-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"locals-api.js","sourceRoot":"","sources":["../../../src/v3/locals-api.ts"],"names":[],"mappings":";;;AAAA,sEAAsE;AACtE,qCAAqC;AACrC,gDAA8C;AAE9C,iCAAiC;AACpB,QAAA,SAAS,GAAG,oBAAS,CAAC,WAAW,EAAE,CAAC;AAEpC,QAAA,MAAM,GAAG;IACpB,MAAM,CAAI,EAAU;QAClB,OAAO,iBAAS,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,GAAG,CAAI,GAAiB;QACtB,OAAO,iBAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,UAAU,CAAI,GAAiB;QAC7B,MAAM,KAAK,GAAG,iBAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,GAAG,CAAI,GAAiB,EAAE,KAAQ;QAChC,iBAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC;IACf,CAAC;CACF,CAAC"}

package/dist/commonjs/v3/logger/index.d.ts

@@ -1,4 +1,4 @@
-import { TaskLogger } from "./taskLogger.js";
+import { TaskLogger, TraceOptions } from "./taskLogger.js";
 import { Span } from "@opentelemetry/api";
 export declare class LoggerAPI implements TaskLogger {
     #private;
@@ -12,5 +12,6 @@ export declare class LoggerAPI implements TaskLogger {
     info(message: string, metadata?: Record<string, unknown>): void;
     warn(message: string, metadata?: Record<string, unknown>): void;
     error(message: string, metadata?: Record<string, unknown>): void;
-    trace<T>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
+    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: TraceOptions): Promise<T>;
+    startSpan(name: string, options?: TraceOptions): Span;
 }

package/dist/commonjs/v3/logger/index.js

@@ -35,8 +35,11 @@ class LoggerAPI {
     error(message, metadata) {
         this.#getTaskLogger().error(message, metadata);
     }
-    trace(name, fn) {
-        return this.#getTaskLogger().trace(name, fn);
+    trace(name, fn, options) {
+        return this.#getTaskLogger().trace(name, fn, options);
+    }
+    startSpan(name, options) {
+        return this.#getTaskLogger().startSpan(name, options);
     }
     #getTaskLogger() {
         return (0, globals_js_1.getGlobal)(API_NAME) ?? NOOP_TASK_LOGGER;

package/dist/commonjs/v3/logger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/logger/index.ts"],"names":[],"mappings":";;;AAAA,mDAA6D;AAC7D,oDAAkF;AAGlF,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAE1B,MAAM,gBAAgB,GAAG,IAAI,8BAAc,EAAE,CAAC;AAE9C,MAAa,SAAS;IACZ,MAAM,CAAC,SAAS,CAAa;IAErC,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,OAAO;QACZ,IAAA,6BAAgB,EAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAEM,mBAAmB,CAAC,UAAsB;QAC/C,OAAO,IAAA,2BAAc,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,GAAG,CAAC,OAAe,EAAE,QAAkC;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,KAAK,CAAI,IAAY,EAAE,EAA8B;QAC1D,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,cAAc;QACZ,OAAO,IAAA,sBAAS,EAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC;IACjD,CAAC;CACF;AAhDD,8BAgDC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/logger/index.ts"],"names":[],"mappings":";;;AAAA,mDAA2E;AAC3E,oDAAkF;AAGlF,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAE1B,MAAM,gBAAgB,GAAG,IAAI,8BAAc,EAAE,CAAC;AAE9C,MAAa,SAAS;IACZ,MAAM,CAAC,SAAS,CAAa;IAErC,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,OAAO;QACZ,IAAA,6BAAgB,EAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAEM,mBAAmB,CAAC,UAAsB;QAC/C,OAAO,IAAA,2BAAc,EAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,GAAG,CAAC,OAAe,EAAE,QAAkC;QAC5D,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,QAAkC;QAC7D,IAAI,CAAC,cAAc,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,QAAkC;QAC9D,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAEM,KAAK,CACV,IAAY,EACZ,EAA8B,EAC9B,OAAsB;QAEtB,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAEM,SAAS,CAAC,IAAY,EAAE,OAAsB;QACnD,OAAO,IAAI,CAAC,cAAc,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACxD,CAAC;IAED,cAAc;QACZ,OAAO,IAAA,sBAAS,EAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC;IACjD,CAAC;CACF;AAxDD,8BAwDC"}

package/dist/commonjs/v3/logger/taskLogger.d.ts

@@ -1,20 +1,26 @@
 import { Span, SpanOptions } from "@opentelemetry/api";
 import { Logger } from "@opentelemetry/api-logs";
 import { TriggerTracer } from "../tracer.js";
+import { Prettify } from "../types/utils.js";
 export type LogLevel = "none" | "error" | "warn" | "info" | "debug" | "log";
 export declare const logLevels: Array<LogLevel>;
 export type TaskLoggerConfig = {
     logger: Logger;
     tracer: TriggerTracer;
     level: LogLevel;
+    maxAttributeCount?: number;
 };
+export type TraceOptions = Prettify<SpanOptions & {
+    icon?: string;
+}>;
 export interface TaskLogger {
     debug(message: string, properties?: Record<string, unknown>): void;
     log(message: string, properties?: Record<string, unknown>): void;
     info(message: string, properties?: Record<string, unknown>): void;
     warn(message: string, properties?: Record<string, unknown>): void;
     error(message: string, properties?: Record<string, unknown>): void;
-    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: TraceOptions): Promise<T>;
+    startSpan(name: string, options?: TraceOptions): Span;
 }
 export declare class OtelTaskLogger implements TaskLogger {
     #private;
@@ -26,7 +32,8 @@ export declare class OtelTaskLogger implements TaskLogger {
     info(message: string, properties?: Record<string, unknown>): void;
     warn(message: string, properties?: Record<string, unknown>): void;
     error(message: string, properties?: Record<string, unknown>): void;
-    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: SpanOptions): Promise<T>;
+    trace<T>(name: string, fn: (span: Span) => Promise<T>, options?: TraceOptions): Promise<T>;
+    startSpan(name: string, options?: TraceOptions): Span;
 }
 export declare class NoopTaskLogger implements TaskLogger {
     debug(): void;
@@ -35,4 +42,5 @@ export declare class NoopTaskLogger implements TaskLogger {
     warn(): void;
     error(): void;
     trace<T>(name: string, fn: (span: Span) => Promise<T>): Promise<T>;
+    startSpan(): Span;
 }

package/dist/commonjs/v3/logger/taskLogger.js

@@ -40,7 +40,11 @@ class OtelTaskLogger {
         this.#emitLog(message, this.#getTimestampInHrTime(), "error", api_logs_1.SeverityNumber.ERROR, properties);
     }
     #emitLog(message, timestamp, severityText, severityNumber, properties) {
-        let attributes = { ...(0, flattenAttributes_js_1.flattenAttributes)(safeJsonProcess(properties)) };
+        let attributes = {};
+        if (properties) {
+            // Use flattenAttributes directly - it now handles all non-JSON friendly values efficiently
+            attributes = (0, flattenAttributes_js_1.flattenAttributes)(properties, undefined, this._config.maxAttributeCount);
+        }
         const icon = (0, icons_js_1.iconStringForSeverity)(severityNumber);
         if (icon !== undefined) {
             attributes[semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON] = icon;
@@ -54,7 +58,24 @@ class OtelTaskLogger {
         });
     }
     trace(name, fn, options) {
-        return this._config.tracer.startActiveSpan(name, fn, options);
+        const spanOptions = {
+            ...options,
+            attributes: {
+                ...options?.attributes,
+                [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: options?.icon ?? "trace",
+            },
+        };
+        return this._config.tracer.startActiveSpan(name, fn, spanOptions);
+    }
+    startSpan(name, options) {
+        const spanOptions = {
+            ...options,
+            attributes: {
+                ...options?.attributes,
+                ...(options?.icon ? { [semanticInternalAttributes_js_1.SemanticInternalAttributes.STYLE_ICON]: options.icon } : {}),
+            },
+        };
+        return this._config.tracer.startSpan(name, spanOptions);
     }
     #getTimestampInHrTime() {
         return clock_api_js_1.clock.preciseNow();
@@ -70,24 +91,9 @@ class NoopTaskLogger {
     trace(name, fn) {
         return fn({});
     }
-}
-exports.NoopTaskLogger = NoopTaskLogger;
-function safeJsonProcess(value) {
-    try {
-        return JSON.parse(JSON.stringify(value, jsonErrorReplacer));
-    }
-    catch {
-        return value;
+    startSpan() {
+        return {};
     }
 }
-function jsonErrorReplacer(key, value) {
-    if (value instanceof Error) {
-        return {
-            name: value.name,
-            message: value.message,
-            stack: value.stack,
-        };
-    }
-    return value;
-}
+exports.NoopTaskLogger = NoopTaskLogger;
 //# sourceMappingURL=taskLogger.js.map

package/dist/commonjs/v3/logger/taskLogger.js.map

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

package/dist/commonjs/v3/machines/index.d.ts

@@ -0,0 +1,27 @@
+import { MachinePresetResources } from "../schemas/common.js";
+/**
+ * Returns a value to be used for `--max-old-space-size`. It is in MiB.
+ * Setting this correctly means V8 spends more times running Garbage Collection (GC).
+ * It won't eliminate crashes but it will help avoid them.
+ * @param {MachinePresetResources} machine - The machine preset configuration containing memory specifications
+ * @param {number} [overhead=0.2] - The memory overhead factor (0.2 = 20% reserved for system operations)
+ * @returns {number} The calculated max old space size in MiB
+ */
+export declare function maxOldSpaceSizeForMachine(machine: MachinePresetResources, overhead?: number): number;
+/**
+ * Returns a flag to be used for `--max-old-space-size`. It is in MiB.
+ * Setting this correctly means V8 spends more times running Garbage Collection (GC).
+ * It won't eliminate crashes but it will help avoid them.
+ * @param {MachinePresetResources} machine - The machine preset configuration containing memory specifications
+ * @param {number} [overhead=0.2] - The memory overhead factor (0.2 = 20% reserved for system operations)
+ * @returns {string} The calculated max old space size flag
+ */
+export declare function maxOldSpaceSizeFlag(machine: MachinePresetResources, overhead?: number): string;
+/**
+ * Takes the existing NODE_OPTIONS value, removes any existing max-old-space-size flag, and adds a new one.
+ * @param {string | undefined} existingOptions - The existing NODE_OPTIONS value
+ * @param {MachinePresetResources} machine - The machine preset configuration containing memory specifications
+ * @param {number} [overhead=0.2] - The memory overhead factor (0.2 = 20% reserved for system operations)
+ * @returns {string} The updated NODE_OPTIONS value with the new max-old-space-size flag
+ */
+export declare function nodeOptionsWithMaxOldSpaceSize(existingOptions: string | undefined, machine: MachinePresetResources, overhead?: number): string;

package/dist/commonjs/v3/machines/index.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maxOldSpaceSizeForMachine = maxOldSpaceSizeForMachine;
+exports.maxOldSpaceSizeFlag = maxOldSpaceSizeFlag;
+exports.nodeOptionsWithMaxOldSpaceSize = nodeOptionsWithMaxOldSpaceSize;
+/**
+ * Returns a value to be used for `--max-old-space-size`. It is in MiB.
+ * Setting this correctly means V8 spends more times running Garbage Collection (GC).
+ * It won't eliminate crashes but it will help avoid them.
+ * @param {MachinePresetResources} machine - The machine preset configuration containing memory specifications
+ * @param {number} [overhead=0.2] - The memory overhead factor (0.2 = 20% reserved for system operations)
+ * @returns {number} The calculated max old space size in MiB
+ */
+function maxOldSpaceSizeForMachine(machine, overhead = 0.2) {
+    return Math.round(machine.memory * 1_024 * (1 - overhead));
+}
+/**
+ * Returns a flag to be used for `--max-old-space-size`. It is in MiB.
+ * Setting this correctly means V8 spends more times running Garbage Collection (GC).
+ * It won't eliminate crashes but it will help avoid them.
+ * @param {MachinePresetResources} machine - The machine preset configuration containing memory specifications
+ * @param {number} [overhead=0.2] - The memory overhead factor (0.2 = 20% reserved for system operations)
+ * @returns {string} The calculated max old space size flag
+ */
+function maxOldSpaceSizeFlag(machine, overhead = 0.2) {
+    return `--max-old-space-size=${maxOldSpaceSizeForMachine(machine, overhead)}`;
+}
+/**
+ * Takes the existing NODE_OPTIONS value, removes any existing max-old-space-size flag, and adds a new one.
+ * @param {string | undefined} existingOptions - The existing NODE_OPTIONS value
+ * @param {MachinePresetResources} machine - The machine preset configuration containing memory specifications
+ * @param {number} [overhead=0.2] - The memory overhead factor (0.2 = 20% reserved for system operations)
+ * @returns {string} The updated NODE_OPTIONS value with the new max-old-space-size flag
+ */
+function nodeOptionsWithMaxOldSpaceSize(existingOptions, machine, overhead = 0.2) {
+    let options = existingOptions ?? "";
+    //remove existing max-old-space-size flag
+    options = options.replace(/--max-old-space-size=\d+/g, "").trim();
+    //get max-old-space-size flag
+    const flag = maxOldSpaceSizeFlag(machine, overhead);
+    return normalizeCommandLineFlags(options ? `${options} ${flag}` : flag);
+}
+/**
+ * Normalizes spaces in a string of command line flags, ensuring single spaces between flags
+ * @param {string} input - The string to normalize
+ * @returns {string} The normalized string with single spaces between flags
+ */
+function normalizeCommandLineFlags(input) {
+    return input.split(/\s+/).filter(Boolean).join(" ");
+}
+//# sourceMappingURL=index.js.map

package/dist/commonjs/v3/machines/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/machines/index.ts"],"names":[],"mappings":";;AAUA,8DAKC;AAUD,kDAKC;AASD,wEAcC;AAnDD;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CACvC,OAA+B,EAC/B,WAAmB,GAAG;IAEtB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,OAA+B,EAC/B,WAAmB,GAAG;IAEtB,OAAO,wBAAwB,yBAAyB,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;AAChF,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,8BAA8B,CAC5C,eAAmC,EACnC,OAA+B,EAC/B,WAAmB,GAAG;IAEtB,IAAI,OAAO,GAAG,eAAe,IAAI,EAAE,CAAC;IAEpC,yCAAyC;IACzC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAElE,6BAA6B;IAC7B,MAAM,IAAI,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEpD,OAAO,yBAAyB,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAS,yBAAyB,CAAC,KAAa;IAC9C,OAAO,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/dist/commonjs/v3/machines/max-old-space.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/commonjs/v3/machines/max-old-space.test.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("./index.js");
+(0, vitest_1.describe)("nodeOptionsWithMaxOldSpaceSize", () => {
+    const testMachine = {
+        name: "small-2x",
+        memory: 1, // 1GB = 1024 MiB
+        cpu: 1,
+        centsPerMs: 0,
+    };
+    // With default 0.2 overhead, max-old-space-size should be 819 (1024 * 0.8)
+    const expectedFlag = "--max-old-space-size=819";
+    (0, vitest_1.it)("handles undefined NODE_OPTIONS", () => {
+        const result = (0, index_js_1.nodeOptionsWithMaxOldSpaceSize)(undefined, testMachine);
+        (0, vitest_1.expect)(result).toBe(expectedFlag);
+    });
+    (0, vitest_1.it)("handles empty string NODE_OPTIONS", () => {
+        const result = (0, index_js_1.nodeOptionsWithMaxOldSpaceSize)("", testMachine);
+        (0, vitest_1.expect)(result).toBe(expectedFlag);
+    });
+    (0, vitest_1.it)("preserves existing flags while adding max-old-space-size", () => {
+        const result = (0, index_js_1.nodeOptionsWithMaxOldSpaceSize)("--inspect --trace-warnings", testMachine);
+        (0, vitest_1.expect)(result).toBe(`--inspect --trace-warnings ${expectedFlag}`);
+    });
+    (0, vitest_1.it)("replaces existing max-old-space-size flag", () => {
+        const result = (0, index_js_1.nodeOptionsWithMaxOldSpaceSize)("--max-old-space-size=4096 --inspect", testMachine);
+        (0, vitest_1.expect)(result).toBe(`--inspect ${expectedFlag}`);
+    });
+    (0, vitest_1.it)("handles multiple existing max-old-space-size flags", () => {
+        const result = (0, index_js_1.nodeOptionsWithMaxOldSpaceSize)("--max-old-space-size=4096 --inspect --max-old-space-size=8192", testMachine);
+        (0, vitest_1.expect)(result).toBe(`--inspect ${expectedFlag}`);
+    });
+    (0, vitest_1.it)("handles extra spaces between flags", () => {
+        const result = (0, index_js_1.nodeOptionsWithMaxOldSpaceSize)("--inspect    --trace-warnings", testMachine);
+        (0, vitest_1.expect)(result).toBe(`--inspect --trace-warnings ${expectedFlag}`);
+    });
+    (0, vitest_1.it)("uses custom overhead value", () => {
+        const result = (0, index_js_1.nodeOptionsWithMaxOldSpaceSize)("--inspect", testMachine, 0.5);
+        // With 0.5 overhead, max-old-space-size should be 512 (1024 * 0.5)
+        (0, vitest_1.expect)(result).toBe("--inspect --max-old-space-size=512");
+    });
+});
+//# sourceMappingURL=max-old-space.test.js.map

package/dist/commonjs/v3/machines/max-old-space.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"max-old-space.test.js","sourceRoot":"","sources":["../../../../src/v3/machines/max-old-space.test.ts"],"names":[],"mappings":";;AAAA,mCAA8C;AAC9C,yCAA4D;AAG5D,IAAA,iBAAQ,EAAC,gCAAgC,EAAE,GAAG,EAAE;IAC9C,MAAM,WAAW,GAAkB;QACjC,IAAI,EAAE,UAAU;QAChB,MAAM,EAAE,CAAC,EAAE,iBAAiB;QAC5B,GAAG,EAAE,CAAC;QACN,UAAU,EAAE,CAAC;KACd,CAAC;IAEF,2EAA2E;IAC3E,MAAM,YAAY,GAAG,0BAA0B,CAAC;IAEhD,IAAA,WAAE,EAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,IAAA,yCAA8B,EAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtE,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,mCAAmC,EAAE,GAAG,EAAE;QAC3C,MAAM,MAAM,GAAG,IAAA,yCAA8B,EAAC,EAAE,EAAE,WAAW,CAAC,CAAC;QAC/D,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,IAAA,yCAA8B,EAAC,4BAA4B,EAAE,WAAW,CAAC,CAAC;QACzF,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,MAAM,GAAG,IAAA,yCAA8B,EAC3C,qCAAqC,EACrC,WAAW,CACZ,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,YAAY,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,IAAA,yCAA8B,EAC3C,+DAA+D,EAC/D,WAAW,CACZ,CAAC;QACF,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,YAAY,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG,IAAA,yCAA8B,EAAC,+BAA+B,EAAE,WAAW,CAAC,CAAC;QAC5F,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,8BAA8B,YAAY,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,MAAM,GAAG,IAAA,yCAA8B,EAAC,WAAW,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;QAC7E,mEAAmE;QACnE,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}