@trigger.dev/core 3.0.0-beta.7 → 3.0.1

package/dist/esm/v3/apps/backoff.d.ts

@@ -0,0 +1,85 @@
+type ExponentialBackoffType = "NoJitter" | "FullJitter" | "EqualJitter";
+type ExponentialBackoffOptions = {
+    base: number;
+    factor: number;
+    min: number;
+    max: number;
+    maxRetries: number;
+    maxElapsed: number;
+};
+declare class StopRetrying extends Error {
+    constructor(message?: string);
+}
+declare class RetryLimitExceeded extends Error {
+    constructor(message?: string);
+}
+type YieldType<T> = T extends AsyncGenerator<infer Y, any, any> ? Y : never;
+/**
+ * Exponential backoff helper class
+ * - All time units in seconds unless otherwise specified
+ */
+export declare class ExponentialBackoff {
+    #private;
+    constructor(type?: ExponentialBackoffType, opts?: Partial<ExponentialBackoffOptions>);
+    type(type?: ExponentialBackoffType): ExponentialBackoff;
+    base(base?: number): ExponentialBackoff;
+    factor(factor?: number): ExponentialBackoff;
+    min(min?: number): ExponentialBackoff;
+    max(max?: number): ExponentialBackoff;
+    maxRetries(maxRetries?: number): ExponentialBackoff;
+    maxElapsed(maxElapsed?: number): ExponentialBackoff;
+    retries(retries?: number): ExponentialBackoff;
+    retryAsync(maxRetries?: number): AsyncGenerator<{
+        delay: {
+            seconds: number;
+            milliseconds: number;
+        };
+        retry: number;
+    }, void, unknown>;
+    [Symbol.asyncIterator](): AsyncGenerator<{
+        delay: {
+            seconds: number;
+            milliseconds: number;
+        };
+        retry: number;
+    }, void, unknown>;
+    /** Returns the delay for the current retry in seconds. */
+    delay(retries?: number, jitter?: boolean): number;
+    /** Waits with the appropriate delay for the current retry. */
+    wait(retries?: number, jitter?: boolean): Promise<void>;
+    elapsed(retries?: number, jitter?: boolean): {
+        seconds: number;
+        minutes: number;
+        hours: number;
+        days: number;
+        total: number;
+    };
+    reset(): this;
+    next(): number;
+    stop(): void;
+    get state(): {
+        retries: number;
+        type: ExponentialBackoffType;
+        base: number;
+        factor: number;
+        min: number;
+        max: number;
+        maxRetries: number;
+        maxElapsed: number;
+    };
+    execute<T>(callback: (iteratorReturn: YieldType<ReturnType<ExponentialBackoff["retryAsync"]>> & {
+        elapsedMs: number;
+    }) => Promise<T>, { attemptTimeoutMs }?: {
+        attemptTimeoutMs?: number;
+    }): Promise<{
+        success: true;
+        result: T;
+    } | {
+        success: false;
+        error?: unknown;
+        cause: "StopRetrying" | "Timeout" | "MaxRetries";
+    }>;
+    static RetryLimitExceeded: typeof RetryLimitExceeded;
+    static StopRetrying: typeof StopRetrying;
+}
+export {};

package/dist/esm/v3/apps/backoff.js

@@ -0,0 +1,278 @@
+var _a;
+import { setTimeout as timeout } from "node:timers/promises";
+class StopRetrying extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "StopRetrying";
+    }
+}
+class AttemptTimeout extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AttemptTimeout";
+    }
+}
+class RetryLimitExceeded extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "RetryLimitExceeded";
+    }
+}
+/**
+ * Exponential backoff helper class
+ * - All time units in seconds unless otherwise specified
+ */
+export class ExponentialBackoff {
+    #retries = 0;
+    #type;
+    #base;
+    #factor;
+    #min;
+    #max;
+    #maxRetries;
+    #maxElapsed;
+    constructor(type, opts = {}) {
+        this.#type = type ?? "NoJitter";
+        this.#base = opts.base ?? 2;
+        this.#factor = opts.factor ?? 1;
+        this.#min = opts.min ?? -Infinity;
+        this.#max = opts.max ?? Infinity;
+        this.#maxRetries = opts.maxRetries ?? Infinity;
+        this.#maxElapsed = opts.maxElapsed ?? Infinity;
+    }
+    #clone(type, opts = {}) {
+        return new _a(type ?? this.#type, {
+            base: opts.base ?? this.#base,
+            factor: opts.factor ?? this.#factor,
+            min: opts.min ?? this.#min,
+            max: opts.max ?? this.#max,
+            maxRetries: opts.maxRetries ?? this.#maxRetries,
+            maxElapsed: opts.maxElapsed ?? this.#maxElapsed,
+        });
+    }
+    type(type) {
+        return this.#clone(type);
+    }
+    base(base) {
+        return this.#clone(undefined, { base });
+    }
+    factor(factor) {
+        return this.#clone(undefined, { factor });
+    }
+    min(min) {
+        return this.#clone(undefined, { min });
+    }
+    max(max) {
+        return this.#clone(undefined, { max });
+    }
+    maxRetries(maxRetries) {
+        return this.#clone(undefined, { maxRetries });
+    }
+    // TODO: With .execute(), should this also include the time it takes to execute the callback?
+    maxElapsed(maxElapsed) {
+        return this.#clone(undefined, { maxElapsed });
+    }
+    retries(retries) {
+        if (typeof retries !== "undefined") {
+            if (retries > this.#maxRetries) {
+                console.error(`Can't set retries ${retries} higher than maxRetries (${this.#maxRetries}), setting to maxRetries instead.`);
+                this.#retries = this.#maxRetries;
+            }
+            else {
+                this.#retries = retries;
+            }
+        }
+        return this.#clone();
+    }
+    async *retryAsync(maxRetries = this.#maxRetries ?? Infinity) {
+        let elapsed = 0;
+        let retry = 0;
+        while (retry <= maxRetries) {
+            const delay = this.delay(retry);
+            elapsed += delay;
+            if (elapsed > this.#maxElapsed) {
+                break;
+            }
+            yield {
+                delay: {
+                    seconds: delay,
+                    milliseconds: delay * 1000,
+                },
+                retry,
+            };
+            retry++;
+        }
+    }
+    async *[Symbol.asyncIterator]() {
+        yield* this.retryAsync();
+    }
+    /** Returns the delay for the current retry in seconds. */
+    delay(retries = this.#retries, jitter = true) {
+        if (retries > this.#maxRetries) {
+            console.error(`Can't set retries ${retries} higher than maxRetries (${this.#maxRetries}), setting to maxRetries instead.`);
+            retries = this.#maxRetries;
+        }
+        let delay = this.#factor * this.#base ** retries;
+        switch (this.#type) {
+            case "NoJitter": {
+                break;
+            }
+            case "FullJitter": {
+                if (!jitter) {
+                    delay = 0;
+                    break;
+                }
+                delay *= Math.random();
+                break;
+            }
+            case "EqualJitter": {
+                if (!jitter) {
+                    delay *= 0.5;
+                    break;
+                }
+                delay *= 0.5 * (1 + Math.random());
+                break;
+            }
+            default: {
+                throw new Error(`Unknown backoff type: ${this.#type}`);
+            }
+        }
+        // If min/max override the delay, jitter with 20% while respecting min/max
+        if (delay < this.#min) {
+            delay = this.#min + Math.random() * (this.#min * 0.2);
+        }
+        if (delay > this.#max) {
+            delay = this.#max - Math.random() * (this.#max * 0.2);
+        }
+        delay = Math.round(delay);
+        return delay;
+    }
+    /** Waits with the appropriate delay for the current retry. */
+    async wait(retries = this.#retries, jitter = true) {
+        if (retries > this.#maxRetries) {
+            console.error(`Retry limit exceeded: ${retries} > ${this.#maxRetries}`);
+            throw new RetryLimitExceeded();
+        }
+        const delay = this.delay(retries, jitter);
+        return await timeout(delay * 1000);
+    }
+    elapsed(retries = this.#retries, jitter = true) {
+        let elapsed = 0;
+        for (let i = 0; i <= retries; i++) {
+            elapsed += this.delay(i, jitter);
+        }
+        const total = elapsed;
+        let days = 0;
+        if (elapsed > 3600 * 24) {
+            days = Math.floor(elapsed / 3600 / 24);
+            elapsed -= days * 3600 * 24;
+        }
+        let hours = 0;
+        if (elapsed > 3600) {
+            hours = Math.floor(elapsed / 3600);
+            elapsed -= hours * 3600;
+        }
+        let minutes = 0;
+        if (elapsed > 60) {
+            minutes = Math.floor(elapsed / 60);
+            elapsed -= minutes * 60;
+        }
+        const seconds = elapsed;
+        return {
+            seconds,
+            minutes,
+            hours,
+            days,
+            total,
+        };
+    }
+    reset() {
+        this.#retries = 0;
+        return this;
+    }
+    next() {
+        this.#retries++;
+        return this.delay();
+    }
+    stop() {
+        throw new StopRetrying();
+    }
+    get state() {
+        return {
+            retries: this.#retries,
+            type: this.#type,
+            base: this.#base,
+            factor: this.#factor,
+            min: this.#min,
+            max: this.#max,
+            maxRetries: this.#maxRetries,
+            maxElapsed: this.#maxElapsed,
+        };
+    }
+    async execute(callback, { attemptTimeoutMs = 0 } = {}) {
+        let elapsedMs = 0;
+        let finalError = undefined;
+        for await (const { delay, retry } of this) {
+            const start = Date.now();
+            if (retry > 0) {
+                console.log(`Retrying in ${delay.milliseconds}ms`);
+                await timeout(delay.milliseconds);
+            }
+            let attemptTimeout = undefined;
+            try {
+                const result = await new Promise(async (resolve, reject) => {
+                    if (attemptTimeoutMs > 0) {
+                        attemptTimeout = setTimeout(() => {
+                            reject(new AttemptTimeout());
+                        }, attemptTimeoutMs);
+                    }
+                    try {
+                        const callbackResult = await callback({ delay, retry, elapsedMs });
+                        resolve(callbackResult);
+                    }
+                    catch (error) {
+                        reject(error);
+                    }
+                });
+                return {
+                    success: true,
+                    result,
+                };
+            }
+            catch (error) {
+                finalError = error;
+                if (error instanceof StopRetrying) {
+                    return {
+                        success: false,
+                        cause: "StopRetrying",
+                        error: error.message,
+                    };
+                }
+                if (error instanceof AttemptTimeout) {
+                    continue;
+                }
+            }
+            finally {
+                elapsedMs += Date.now() - start;
+                clearTimeout(attemptTimeout);
+            }
+        }
+        if (finalError instanceof AttemptTimeout) {
+            return {
+                success: false,
+                cause: "Timeout",
+            };
+        }
+        else {
+            return {
+                success: false,
+                cause: "MaxRetries",
+                error: finalError,
+            };
+        }
+    }
+    static RetryLimitExceeded = RetryLimitExceeded;
+    static StopRetrying = StopRetrying;
+}
+_a = ExponentialBackoff;
+//# sourceMappingURL=backoff.js.map

package/dist/esm/v3/apps/backoff.js.map

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

package/dist/esm/v3/apps/checkpoints.d.ts

@@ -0,0 +1,8 @@
+export type CheckpointTestResult = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+    error?: unknown;
+};
+export declare function testDockerCheckpoint(): Promise<CheckpointTestResult>;

package/dist/esm/v3/apps/checkpoints.js

@@ -0,0 +1,48 @@
+import { randomUUID } from "node:crypto";
+import { isExecaChildProcess } from "./isExecaChildProcess.js";
+export async function testDockerCheckpoint() {
+    const { $ } = await import("execa");
+    try {
+        // Create a dummy container
+        const container = await $ `docker run -d --rm --name init-dummy-${randomUUID()} docker.io/library/busybox sleep 10`;
+        // Checkpoint it
+        await $ `docker checkpoint create ${container} init-check`;
+    }
+    catch (error) {
+        if (!isExecaChildProcess(error)) {
+            return {
+                ok: false,
+                message: "No checkpoint support: Unknown error.",
+                error,
+            };
+        }
+        if (error.stderr.includes("criu")) {
+            if (error.stderr.includes("executable file not found")) {
+                return {
+                    ok: false,
+                    message: "No checkpoint support: Missing CRIU binary.",
+                };
+            }
+            return {
+                ok: false,
+                message: "No checkpoint support: Unknown CRIU error.",
+                error,
+            };
+        }
+        if (error.stderr.includes("experimental features enabled")) {
+            return {
+                ok: false,
+                message: "No checkpoint support: Please enable docker experimental features.",
+            };
+        }
+        return {
+            ok: false,
+            message: "No checkpoint support: Unknown execa error.",
+            error,
+        };
+    }
+    return {
+        ok: true,
+    };
+}
+//# sourceMappingURL=checkpoints.js.map

package/dist/esm/v3/apps/checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.js","sourceRoot":"","sources":["../../../../src/v3/apps/checkpoints.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAY/D,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,EAAE,CAAC,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;IAEpC,IAAI,CAAC;QACH,2BAA2B;QAC3B,MAAM,SAAS,GACb,MAAM,CAAC,CAAA,wCAAwC,UAAU,EAAE,qCAAqC,CAAC;QAEnG,gBAAgB;QAChB,MAAM,CAAC,CAAA,4BAA4B,SAAS,aAAa,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,uCAAuC;gBAChD,KAAK;aACN,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAClC,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,CAAC;gBACvD,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,OAAO,EAAE,6CAA6C;iBACvD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,4CAA4C;gBACrD,KAAK;aACN,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;YAC3D,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,oEAAoE;aAC9E,CAAC;QACJ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO,EAAE,6CAA6C;YACtD,KAAK;SACN,CAAC;IACJ,CAAC;IAED,OAAO;QACL,EAAE,EAAE,IAAI;KACT,CAAC;AACJ,CAAC"}

package/dist/esm/v3/apps/http.d.ts

@@ -0,0 +1,16 @@
+import { IncomingMessage, RequestListener } from "node:http";
+export declare const getTextBody: (req: IncomingMessage) => Promise<string>;
+export declare class HttpReply {
+    private response;
+    constructor(response: Parameters<RequestListener>[1]);
+    empty(status?: number): import("http").ServerResponse<IncomingMessage> & {
+        req: IncomingMessage;
+    };
+    text(text: string, status?: number, contentType?: string): import("http").ServerResponse<IncomingMessage> & {
+        req: IncomingMessage;
+    };
+    json(value: any, pretty?: boolean): import("http").ServerResponse<IncomingMessage> & {
+        req: IncomingMessage;
+    };
+}
+export declare function getRandomPortNumber(): number;

package/dist/esm/v3/apps/http.js

@@ -0,0 +1,38 @@
+export const getTextBody = (req) => new Promise((resolve) => {
+    let body = "";
+    req.on("readable", () => {
+        const chunk = req.read();
+        if (chunk) {
+            body += chunk;
+        }
+    });
+    req.on("end", () => {
+        resolve(body);
+    });
+});
+export class HttpReply {
+    response;
+    constructor(response) {
+        this.response = response;
+    }
+    empty(status) {
+        return this.response.writeHead(status ?? 200).end();
+    }
+    text(text, status, contentType) {
+        return this.response
+            .writeHead(status ?? 200, { "Content-Type": contentType || "text/plain" })
+            .end(text.endsWith("\n") ? text : `${text}\n`);
+    }
+    json(value, pretty) {
+        return this.text(JSON.stringify(value, undefined, pretty ? 2 : undefined), 200, "application/json");
+    }
+}
+function getRandomInteger(min, max) {
+    const intMin = Math.ceil(min);
+    const intMax = Math.floor(max);
+    return Math.floor(Math.random() * (intMax - intMin + 1)) + intMin;
+}
+export function getRandomPortNumber() {
+    return getRandomInteger(8000, 9999);
+}
+//# sourceMappingURL=http.js.map

package/dist/esm/v3/apps/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/v3/apps/http.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAoB,EAAE,EAAE,CAClD,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;IAC9B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;QACtB,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,IAAI,KAAK,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;IACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,MAAM,OAAO,SAAS;IACA;IAApB,YAAoB,QAAwC;QAAxC,aAAQ,GAAR,QAAQ,CAAgC;IAAG,CAAC;IAEhE,KAAK,CAAC,MAAe;QACnB,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IACtD,CAAC;IAED,IAAI,CAAC,IAAY,EAAE,MAAe,EAAE,WAAoB;QACtD,OAAO,IAAI,CAAC,QAAQ;aACjB,SAAS,CAAC,MAAM,IAAI,GAAG,EAAE,EAAE,cAAc,EAAE,WAAW,IAAI,YAAY,EAAE,CAAC;aACzE,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,KAAU,EAAE,MAAgB;QAC/B,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EACxD,GAAG,EACH,kBAAkB,CACnB,CAAC;IACJ,CAAC;CACF;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,GAAW;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/esm/v3/apps/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./backoff.js";
+export * from "./logger.js";
+export * from "./process.js";
+export * from "./checkpoints.js";
+export * from "./http.js";
+export * from "./provider.js";
+export * from "./isExecaChildProcess.js";

package/dist/esm/v3/apps/index.js

@@ -0,0 +1,8 @@
+export * from "./backoff.js";
+export * from "./logger.js";
+export * from "./process.js";
+export * from "./checkpoints.js";
+export * from "./http.js";
+export * from "./provider.js";
+export * from "./isExecaChildProcess.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/v3/apps/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/apps/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,0BAA0B,CAAC"}

package/dist/esm/v3/apps/isExecaChildProcess.d.ts

@@ -0,0 +1,2 @@
+import type { ExecaChildProcess } from "execa";
+export declare function isExecaChildProcess(maybeExeca: unknown): maybeExeca is Awaited<ExecaChildProcess>;

package/dist/esm/v3/apps/isExecaChildProcess.js

@@ -0,0 +1,4 @@
+export function isExecaChildProcess(maybeExeca) {
+    return typeof maybeExeca === "object" && maybeExeca !== null && "escapedCommand" in maybeExeca;
+}
+//# sourceMappingURL=isExecaChildProcess.js.map

package/dist/esm/v3/apps/isExecaChildProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isExecaChildProcess.js","sourceRoot":"","sources":["../../../../src/v3/apps/isExecaChildProcess.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,mBAAmB,CAAC,UAAmB;IACrD,OAAO,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,gBAAgB,IAAI,UAAU,CAAC;AACjG,CAAC"}

package/dist/esm/v3/apps/logger.d.ts

@@ -0,0 +1,8 @@
+export declare class SimpleLogger {
+    #private;
+    private prefix?;
+    constructor(prefix?: string | undefined);
+    log<TFirstArg>(arg0: TFirstArg, ...argN: any[]): TFirstArg;
+    debug<TFirstArg>(arg0: TFirstArg, ...argN: any[]): TFirstArg;
+    error<TFirstArg>(arg0: TFirstArg, ...argN: any[]): TFirstArg;
+}

package/dist/esm/v3/apps/logger.js

@@ -0,0 +1,29 @@
+export class SimpleLogger {
+    prefix;
+    #debugEnabled = ["1", "true"].includes(process.env.DEBUG ?? "");
+    constructor(prefix) {
+        this.prefix = prefix;
+    }
+    log(arg0, ...argN) {
+        console.log(...this.#getPrefixedArgs(arg0, ...argN));
+        return arg0;
+    }
+    debug(arg0, ...argN) {
+        if (!this.#debugEnabled) {
+            return arg0;
+        }
+        console.debug(...this.#getPrefixedArgs("DEBUG", arg0, ...argN));
+        return arg0;
+    }
+    error(arg0, ...argN) {
+        console.error(...this.#getPrefixedArgs(arg0, ...argN));
+        return arg0;
+    }
+    #getPrefixedArgs(...args) {
+        if (!this.prefix) {
+            return args;
+        }
+        return [this.prefix, ...args];
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/esm/v3/apps/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../src/v3/apps/logger.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAY;IAGH;IAFpB,aAAa,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAEhE,YAAoB,MAAe;QAAf,WAAM,GAAN,MAAM,CAAS;IAAG,CAAC;IAEvC,GAAG,CAAY,IAAe,EAAE,GAAG,IAAW;QAC5C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAErD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAY,IAAe,EAAE,GAAG,IAAW;QAC9C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAEhE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAY,IAAe,EAAE,GAAG,IAAW;QAC9C,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;QAEvD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB,CAAC,GAAG,IAAW;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/esm/v3/apps/process.d.ts

@@ -0,0 +1,2 @@
+export declare const EXIT_CODE_ALREADY_HANDLED = 111;
+export declare const EXIT_CODE_CHILD_NONZERO = 112;

package/dist/esm/v3/apps/process.js

@@ -0,0 +1,3 @@
+export const EXIT_CODE_ALREADY_HANDLED = 111;
+export const EXIT_CODE_CHILD_NONZERO = 112;
+//# sourceMappingURL=process.js.map

package/dist/esm/v3/apps/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../../src/v3/apps/process.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC"}

package/dist/esm/v3/apps/provider.d.ts

@@ -0,0 +1,74 @@
+import { EnvironmentType } from "../schemas/schemas.js";
+import { MachinePreset } from "../schemas/common.js";
+import { ProviderToPlatformMessages, PlatformToProviderMessages } from "../schemas/messages.js";
+import { ZodSocketConnection } from "../zodSocket.js";
+export interface TaskOperationsIndexOptions {
+    shortCode: string;
+    imageRef: string;
+    apiKey: string;
+    apiUrl: string;
+    envId: string;
+    envType: EnvironmentType;
+    orgId: string;
+    projectId: string;
+    deploymentId: string;
+}
+export interface TaskOperationsCreateOptions {
+    image: string;
+    machine: MachinePreset;
+    version: string;
+    nextAttemptNumber?: number;
+    envId: string;
+    envType: EnvironmentType;
+    orgId: string;
+    projectId: string;
+    runId: string;
+}
+export interface TaskOperationsRestoreOptions {
+    imageRef: string;
+    checkpointRef: string;
+    machine: MachinePreset;
+    attemptNumber?: number;
+    envId: string;
+    envType: EnvironmentType;
+    orgId: string;
+    projectId: string;
+    runId: string;
+    checkpointId: string;
+}
+export interface TaskOperationsPrePullDeploymentOptions {
+    shortCode: string;
+    imageRef: string;
+    envId: string;
+    envType: EnvironmentType;
+    orgId: string;
+    projectId: string;
+    deploymentId: string;
+}
+export interface TaskOperations {
+    init: () => Promise<any>;
+    index: (opts: TaskOperationsIndexOptions) => Promise<any>;
+    create: (opts: TaskOperationsCreateOptions) => Promise<any>;
+    restore: (opts: TaskOperationsRestoreOptions) => Promise<any>;
+    delete?: (...args: any[]) => Promise<any>;
+    get?: (...args: any[]) => Promise<any>;
+    prePullDeployment?: (opts: TaskOperationsPrePullDeploymentOptions) => Promise<any>;
+}
+type ProviderShellOptions = {
+    tasks: TaskOperations;
+    type: "docker" | "kubernetes";
+    host?: string;
+    port?: number;
+};
+interface Provider {
+    tasks: TaskOperations;
+}
+export declare class ProviderShell implements Provider {
+    #private;
+    private options;
+    tasks: TaskOperations;
+    platformSocket: ZodSocketConnection<typeof ProviderToPlatformMessages, typeof PlatformToProviderMessages>;
+    constructor(options: ProviderShellOptions);
+    listen(): Promise<void>;
+}
+export {};