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

package/dist/commonjs/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/commonjs/v3/apps/backoff.js

@@ -0,0 +1,282 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExponentialBackoff = void 0;
+const promises_1 = require("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
+ */
+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 (0, promises_1.setTimeout)(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 (0, promises_1.setTimeout)(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;
+}
+exports.ExponentialBackoff = ExponentialBackoff;
+_a = ExponentialBackoff;
+//# sourceMappingURL=backoff.js.map

package/dist/commonjs/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/commonjs/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/commonjs/v3/apps/checkpoints.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testDockerCheckpoint = testDockerCheckpoint;
+const node_crypto_1 = require("node:crypto");
+const isExecaChildProcess_js_1 = require("./isExecaChildProcess.js");
+async function testDockerCheckpoint() {
+    const { $ } = await import("execa");
+    try {
+        // Create a dummy container
+        const container = await $ `docker run -d --rm --name init-dummy-${(0, node_crypto_1.randomUUID)()} docker.io/library/busybox sleep 10`;
+        // Checkpoint it
+        await $ `docker checkpoint create ${container} init-check`;
+    }
+    catch (error) {
+        if (!(0, isExecaChildProcess_js_1.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/commonjs/v3/apps/checkpoints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpoints.js","sourceRoot":"","sources":["../../../../src/v3/apps/checkpoints.ts"],"names":[],"mappings":";;AAaA,oDAmDC;AAhED,6CAAyC;AACzC,qEAA+D;AAYxD,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,IAAA,wBAAU,GAAE,qCAAqC,CAAC;QAEnG,gBAAgB;QAChB,MAAM,CAAC,CAAA,4BAA4B,SAAS,aAAa,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,IAAA,4CAAmB,EAAC,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/commonjs/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/commonjs/v3/apps/http.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpReply = exports.getTextBody = void 0;
+exports.getRandomPortNumber = getRandomPortNumber;
+const getTextBody = (req) => new Promise((resolve) => {
+    let body = "";
+    req.on("readable", () => {
+        const chunk = req.read();
+        if (chunk) {
+            body += chunk;
+        }
+    });
+    req.on("end", () => {
+        resolve(body);
+    });
+});
+exports.getTextBody = getTextBody;
+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");
+    }
+}
+exports.HttpReply = HttpReply;
+function getRandomInteger(min, max) {
+    const intMin = Math.ceil(min);
+    const intMax = Math.floor(max);
+    return Math.floor(Math.random() * (intMax - intMin + 1)) + intMin;
+}
+function getRandomPortNumber() {
+    return getRandomInteger(8000, 9999);
+}
+//# sourceMappingURL=http.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/v3/apps/http.ts"],"names":[],"mappings":";;;AA4CA,kDAEC;AA5CM,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;AAZQ,QAAA,WAAW,eAYnB;AAEL,MAAa,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;AApBD,8BAoBC;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,SAAgB,mBAAmB;IACjC,OAAO,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/commonjs/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/commonjs/v3/apps/index.js

@@ -0,0 +1,24 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./backoff.js"), exports);
+__exportStar(require("./logger.js"), exports);
+__exportStar(require("./process.js"), exports);
+__exportStar(require("./checkpoints.js"), exports);
+__exportStar(require("./http.js"), exports);
+__exportStar(require("./provider.js"), exports);
+__exportStar(require("./isExecaChildProcess.js"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/apps/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+CAA6B;AAC7B,8CAA4B;AAC5B,+CAA6B;AAC7B,mDAAiC;AACjC,4CAA0B;AAC1B,gDAA8B;AAC9B,2DAAyC"}

package/dist/commonjs/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/commonjs/v3/apps/isExecaChildProcess.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isExecaChildProcess = isExecaChildProcess;
+function isExecaChildProcess(maybeExeca) {
+    return typeof maybeExeca === "object" && maybeExeca !== null && "escapedCommand" in maybeExeca;
+}
+//# sourceMappingURL=isExecaChildProcess.js.map

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

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

package/dist/commonjs/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/commonjs/v3/apps/logger.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleLogger = void 0;
+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];
+    }
+}
+exports.SimpleLogger = SimpleLogger;
+//# sourceMappingURL=logger.js.map

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

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

package/dist/commonjs/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/commonjs/v3/apps/process.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EXIT_CODE_CHILD_NONZERO = exports.EXIT_CODE_ALREADY_HANDLED = void 0;
+exports.EXIT_CODE_ALREADY_HANDLED = 111;
+exports.EXIT_CODE_CHILD_NONZERO = 112;
+//# sourceMappingURL=process.js.map

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

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