@trigger.dev/core 0.0.0-python-preview-20250226140121 → 0.0.0-rc-4-8-0-20261021151928

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

@@ -1,8 +1,19 @@
 import { ApiClient } from "../apiClient/index.js";
 import { getGlobal, registerGlobal, unregisterGlobal } from "../utils/globals.js";
 import { getEnvVar } from "../utils/getEnv.js";
+import { isDefaultDevBranch } from "../utils/gitBranch.js";
+import { sdkScope } from "../sdkScope/index.js";
 const API_NAME = "api-client";
-export class ApiClientMissingError extends Error {
+/**
+ * Read the dev-side branch carrier env var, collapsing the `"default"` sentinel
+ * to `undefined` so it never leaks into the `x-trigger-branch` header (the
+ * sentinel refers to the root dev env, which carries no branch).
+ */
+function getDevBranchEnvVar() {
+    const value = getEnvVar("TRIGGER_DEV_BRANCH");
+    return value && !isDefaultDevBranch(value) ? value : undefined;
+}
+class ApiClientMissingError extends Error {
     constructor(message) {
         super(message);
         this.name = "ApiClientMissingError";
@@ -21,38 +32,107 @@ export class APIClientManagerAPI {
         unregisterGlobal(API_NAME);
     }
     get baseURL() {
+        const scoped = sdkScope.getStore();
+        if (scoped) {
+            return scoped.apiClientConfig.baseURL ?? "https://api.trigger.dev";
+        }
         const config = this.#getConfig();
         return config?.baseURL ?? getEnvVar("TRIGGER_API_URL") ?? "https://api.trigger.dev";
     }
     get accessToken() {
+        const scoped = sdkScope.getStore();
+        if (scoped) {
+            return scoped.apiClientConfig.accessToken ?? scoped.apiClientConfig.secretKey;
+        }
         const config = this.#getConfig();
         return (config?.secretKey ??
             config?.accessToken ??
             getEnvVar("TRIGGER_SECRET_KEY") ??
             getEnvVar("TRIGGER_ACCESS_TOKEN"));
     }
+    get branchName() {
+        const scoped = sdkScope.getStore();
+        if (scoped) {
+            // previewBranch carries the branch for any branchable env (preview or dev) —
+            // they share the x-trigger-branch header. resolveApiClientConfig folds in the
+            // dev-side TRIGGER_DEV_BRANCH carrier when building the scoped config.
+            const value = scoped.apiClientConfig.previewBranch;
+            return value ? value : undefined;
+        }
+        const config = this.#getConfig();
+        const value = config?.previewBranch ??
+            getEnvVar("TRIGGER_PREVIEW_BRANCH") ??
+            getEnvVar("VERCEL_GIT_COMMIT_REF") ??
+            // Dev branches share the x-trigger-branch header; TRIGGER_DEV_BRANCH is the
+            // dev-side carrier. Never read the "default" sentinel.
+            getDevBranchEnvVar() ??
+            undefined;
+        return value ? value : undefined;
+    }
+    get externalDeploymentId() {
+        const scoped = sdkScope.getStore();
+        if (scoped) {
+            return scoped.apiClientConfig.externalDeploymentId;
+        }
+        return this.#getConfig()?.externalDeploymentId;
+    }
+    resolveApiClientConfig(partial = {}) {
+        return {
+            baseURL: partial.baseURL ?? getEnvVar("TRIGGER_API_URL"),
+            accessToken: partial.accessToken ??
+                partial.secretKey ??
+                getEnvVar("TRIGGER_SECRET_KEY") ??
+                getEnvVar("TRIGGER_ACCESS_TOKEN"),
+            secretKey: partial.secretKey,
+            refreshAccessToken: partial.refreshAccessToken,
+            previewBranch: partial.previewBranch ??
+                getEnvVar("TRIGGER_PREVIEW_BRANCH") ??
+                getEnvVar("VERCEL_GIT_COMMIT_REF") ??
+                getDevBranchEnvVar(),
+            externalDeploymentId: partial.externalDeploymentId,
+            requestOptions: partial.requestOptions,
+            future: partial.future,
+        };
+    }
     get client() {
         if (!this.baseURL || !this.accessToken) {
             return undefined;
         }
-        return new ApiClient(this.baseURL, this.accessToken);
+        const scoped = sdkScope.getStore();
+        const source = scoped?.apiClientConfig ?? this.#getConfig();
+        const requestOptions = source?.requestOptions;
+        const futureFlags = source?.future;
+        return new ApiClient(this.baseURL, this.accessToken, this.branchName, requestOptions, futureFlags, source?.refreshAccessToken);
     }
-    clientOrThrow() {
-        if (!this.baseURL || !this.accessToken) {
+    clientOrThrow(config) {
+        const baseURL = config?.baseURL ?? this.baseURL;
+        const accessToken = config?.accessToken ?? config?.secretKey ?? this.accessToken;
+        if (!baseURL || !accessToken) {
             throw new ApiClientMissingError(this.apiClientMissingError());
         }
-        return new ApiClient(this.baseURL, this.accessToken);
+        const branchName = config?.previewBranch ?? this.branchName;
+        const scoped = sdkScope.getStore();
+        const source = scoped?.apiClientConfig ?? this.#getConfig();
+        const requestOptions = config?.requestOptions ?? source?.requestOptions;
+        const futureFlags = config?.future ?? source?.future;
+        return new ApiClient(baseURL, accessToken, branchName, requestOptions, futureFlags, config?.refreshAccessToken ?? source?.refreshAccessToken);
     }
     runWithConfig(config, fn) {
-        const originalConfig = this.#getConfig();
-        const $config = { ...originalConfig, ...config };
-        registerGlobal(API_NAME, $config, true);
+        const current = sdkScope.getStore()?.apiClientConfig ?? this.#getConfig();
+        const merged = this.resolveApiClientConfig({ ...current, ...config });
+        if (sdkScope.hasStorage()) {
+            return sdkScope.withScope({ apiClientConfig: merged, inheritContext: true }, fn);
+        }
+        // No ALS available (browser, edge, workers). Fall back to in-place
+        // mutation — same as pre-existing behavior, not concurrency-safe.
+        const original = this.#getConfig();
+        registerGlobal(API_NAME, merged, true);
         return fn().finally(() => {
-            registerGlobal(API_NAME, originalConfig, true);
+            registerGlobal(API_NAME, original, true);
         });
     }
     setGlobalAPIClientConfiguration(config) {
-        return registerGlobal(API_NAME, config);
+        return registerGlobal(API_NAME, config, true);
     }
     #getConfig() {
         return getGlobal(API_NAME);

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/apiClientManager/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,MAAM,QAAQ,GAAG,YAAY,CAAC;AAE9B,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAC,SAAS,CAAuB;IAE/C,gBAAuB,CAAC;IAEjB,MAAM,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,SAAS,GAAG,IAAI,mBAAmB,EAAE,CAAC;QAC7C,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAEM,OAAO;QACZ,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO;QACT,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,MAAM,EAAE,OAAO,IAAI,SAAS,CAAC,iBAAiB,CAAC,IAAI,yBAAyB,CAAC;IACtF,CAAC;IAED,IAAI,WAAW;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACjC,OAAO,CACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,WAAW;YACnB,SAAS,CAAC,oBAAoB,CAAC;YAC/B,SAAS,CAAC,sBAAsB,CAAC,CAClC,CAAC;IACJ,CAAC;IAED,IAAI,MAAM;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,aAAa;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACvC,MAAM,IAAI,qBAAqB,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,aAAa,CACX,MAA8B,EAC9B,EAAK;QAEL,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QACjD,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAExC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;YACvB,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,IAAI,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,+BAA+B,CAAC,MAA8B;QACnE,OAAO,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,UAAU;QACR,OAAO,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,qBAAqB;QACnB,MAAM,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;QAClC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;QAC1C,IAAI,CAAC,UAAU,IAAI,CAAC,cAAc,EAAE,CAAC;YACnC,OAAO,mJAAmJ,CAAC;QAC7J,CAAC;aAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,OAAO,2HAA2H,CAAC;QACrI,CAAC;aAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YAC3B,OAAO,8HAA8H,CAAC;QACxI,CAAC;QAED,OAAO,eAAe,CAAC;IACzB,CAAC;CACF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/apiClientManager/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/v3/apiClientManager/types.d.ts

@@ -1,4 +1,4 @@
-import { type ApiRequestOptions } from "../apiClient/index.js";
+import type { ApiClientFutureFlags, ApiRequestOptions } from "../apiClient/index.js";
 export type ApiClientConfiguration = {
     baseURL?: string;
     /**
@@ -9,5 +9,22 @@ export type ApiClientConfiguration = {
      * The access token to authenticate with the Trigger API.
      */
     accessToken?: string;
+    /**
+     * Mints a fresh access token. Called when a realtime stream subscription is
+     * rejected with a 401/403, so a long-lived subscription can survive the
+     * expiry of the token it started with.
+     */
+    refreshAccessToken?: () => Promise<string>;
+    /**
+     * The preview branch name (for preview environments)
+     */
+    previewBranch?: string;
+    /**
+     * Pin every run triggered through this client to the deployment deployed under this
+     * external id. An explicit `externalDeploymentId` on an individual trigger wins over it;
+     * it in turn wins over `TRIGGER_EXTERNAL_DEPLOYMENT_ID` and platform discovery.
+     */
+    externalDeploymentId?: string;
     requestOptions?: ApiRequestOptions;
+    future?: ApiClientFutureFlags;
 };

package/dist/esm/v3/apiKeys.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns whether a key has the additional environment API key format.
+ *
+ * This is only a routing hint. It must never be used as a security boundary;
+ * servers authenticate additional keys by resolving their stored hash.
+ */
+export declare function isAdditionalApiKey(key: string): boolean;

package/dist/esm/v3/apiKeys.js

@@ -0,0 +1,11 @@
+const ADDITIONAL_API_KEY_PATTERN = /^tr_(dev|stg|prod|preview)_sk_[0-9a-zA-Z]{24}$/;
+/**
+ * Returns whether a key has the additional environment API key format.
+ *
+ * This is only a routing hint. It must never be used as a security boundary;
+ * servers authenticate additional keys by resolving their stored hash.
+ */
+export function isAdditionalApiKey(key) {
+    return ADDITIONAL_API_KEY_PATTERN.test(key);
+}
+//# sourceMappingURL=apiKeys.js.map

package/dist/esm/v3/apiKeys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeys.js","sourceRoot":"","sources":["../../../src/v3/apiKeys.ts"],"names":[],"mappings":"AAAA,MAAM,0BAA0B,GAAG,gDAAgD,CAAC;AAEpF;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,0BAA0B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC"}

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

@@ -220,19 +220,13 @@ export class ExponentialBackoff {
             }
             let attemptTimeout = undefined;
             try {
-                const result = await new Promise(async (resolve, reject) => {
+                const result = await new Promise((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);
-                    }
+                    callback({ delay, retry, elapsedMs }).then(resolve, reject);
                 });
                 return {
                     success: true,

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

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

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

@@ -0,0 +1,31 @@
+import { SimpleStructuredLogger } from "../utils/structuredLogger.js";
+import { type Output, type Result } from "tinyexec";
+export declare class ExecResult {
+    pid?: number;
+    exitCode?: number;
+    aborted: boolean;
+    killed: boolean;
+    constructor(result: Result);
+}
+export interface ExecOptions {
+    logger?: SimpleStructuredLogger;
+    abortSignal?: AbortSignal;
+    logOutput?: boolean;
+    trimArgs?: boolean;
+    neverThrow?: boolean;
+}
+export declare function redactArgsForLogging(args?: string[]): string[] | undefined;
+export declare class Exec {
+    private logger;
+    private abortSignal;
+    private logOutput;
+    private trimArgs;
+    private neverThrow;
+    constructor(opts: ExecOptions);
+    x(command: string, args?: string[], opts?: {
+        neverThrow?: boolean;
+        ignoreAbort?: boolean;
+    }): Promise<Output>;
+    static Result: typeof ExecResult;
+}
+export { type Output };

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

@@ -0,0 +1,110 @@
+import { SimpleStructuredLogger } from "../utils/structuredLogger.js";
+import { x } from "tinyexec";
+export class ExecResult {
+    pid;
+    exitCode;
+    aborted;
+    killed;
+    constructor(result) {
+        this.pid = result.pid;
+        this.exitCode = result.exitCode;
+        this.aborted = result.aborted;
+        this.killed = result.killed;
+    }
+}
+// Long-form flags whose value carries a credential - the following arg (or inline
+// `--flag=value`) is replaced before args are logged so it never reaches log sinks.
+const REDACTED_FLAGS = new Set([
+    "--password",
+    "--token",
+    "--secret",
+    "--access-token",
+    "--registry-token",
+    "--registry-password",
+    "--api-key",
+]);
+export function redactArgsForLogging(args) {
+    if (!args) {
+        return args;
+    }
+    return args.map((arg, index) => {
+        const previous = index > 0 ? args[index - 1]?.trim() : undefined;
+        if (previous && REDACTED_FLAGS.has(previous)) {
+            return "[redacted]";
+        }
+        const equalsIndex = arg.indexOf("=");
+        if (equalsIndex > 0 && REDACTED_FLAGS.has(arg.slice(0, equalsIndex).trim())) {
+            return `${arg.slice(0, equalsIndex)}=[redacted]`;
+        }
+        return arg;
+    });
+}
+export class Exec {
+    logger;
+    abortSignal;
+    logOutput;
+    trimArgs;
+    neverThrow;
+    constructor(opts) {
+        this.logger = opts.logger ?? new SimpleStructuredLogger("exec");
+        this.abortSignal = opts.abortSignal;
+        this.logOutput = opts.logOutput ?? true;
+        this.trimArgs = opts.trimArgs ?? true;
+        this.neverThrow = opts.neverThrow ?? false;
+    }
+    async x(command, args, opts) {
+        const argsTrimmed = this.trimArgs ? args?.map((arg) => arg.trim()) : args;
+        const argsForLogging = redactArgsForLogging(args);
+        const argsTrimmedForLogging = redactArgsForLogging(argsTrimmed);
+        const commandWithFirstArg = `${command}${argsTrimmedForLogging?.length ? ` ${argsTrimmedForLogging[0]}` : ""}`;
+        this.logger.debug(`exec: ${commandWithFirstArg}`, {
+            command,
+            args: argsForLogging,
+            argsTrimmed: argsTrimmedForLogging,
+        });
+        const result = x(command, argsTrimmed, {
+            signal: opts?.ignoreAbort ? undefined : this.abortSignal,
+            // We don't use this as it doesn't cover killed and aborted processes
+            // throwOnError: true,
+        });
+        const output = await result;
+        const metadata = {
+            command,
+            argsRaw: argsForLogging,
+            argsTrimmed: argsTrimmedForLogging,
+            globalOpts: {
+                trimArgs: this.trimArgs,
+                neverThrow: this.neverThrow,
+                hasAbortSignal: !!this.abortSignal,
+            },
+            localOpts: opts,
+            stdout: output.stdout,
+            stderr: output.stderr,
+            pid: result.pid,
+            exitCode: result.exitCode,
+            aborted: result.aborted,
+            killed: result.killed,
+        };
+        if (this.logOutput) {
+            this.logger.debug(`output: ${commandWithFirstArg}`, metadata);
+        }
+        if (this.neverThrow || opts?.neverThrow) {
+            return output;
+        }
+        if (result.aborted) {
+            this.logger.error(`aborted: ${commandWithFirstArg}`, metadata);
+            throw new ExecResult(result);
+        }
+        if (result.killed) {
+            this.logger.error(`killed: ${commandWithFirstArg}`, metadata);
+            throw new ExecResult(result);
+        }
+        if (result.exitCode !== 0) {
+            this.logger.error(`non-zero exit: ${commandWithFirstArg}`, metadata);
+            throw new ExecResult(result);
+        }
+        return output;
+    }
+    static Result = ExecResult;
+}
+//# sourceMappingURL=exec.js.map

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

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

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

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

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

@@ -1,30 +1,53 @@
-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 async function getJsonBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = "";
+        req.on("data", (chunk) => {
+            body += chunk.toString();
+        });
+        req.on("end", () => {
+            resolve(safeJsonParse(body));
+        });
     });
-});
+}
+function safeJsonParse(text) {
+    if (!text) {
+        return null;
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        console.error("Failed to parse JSON", { error, text });
+        return null;
+    }
+}
 export class HttpReply {
     response;
     constructor(response) {
         this.response = response;
     }
     empty(status) {
+        if (this.hasReplied) {
+            return;
+        }
         return this.response.writeHead(status ?? 200).end();
     }
     text(text, status, contentType) {
+        if (this.hasReplied) {
+            return;
+        }
         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");
+    json(value, pretty, status) {
+        if (this.hasReplied) {
+            return;
+        }
+        return this.text(JSON.stringify(value, undefined, pretty ? 2 : undefined), status ?? 200, "application/json");
+    }
+    get hasReplied() {
+        return this.response.headersSent;
     }
 }
 function getRandomInteger(min, max) {

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

@@ -1 +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"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/v3/apps/http.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAoB;IACpD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,EAAE,CAAC;QAEd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACvB,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,CAAC,CAAC,CAAC;QAEH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACjB,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,OAAO,SAAS;IACA,QAAQ;IAA5B,YAAoB,QAAwC;wBAAxC,QAAQ;IAAmC,CAAC;IAEhE,KAAK,CAAC,MAAe;QACnB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,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,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,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,EAAE,MAAe;QAChD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CACd,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,EACxD,MAAM,IAAI,GAAG,EACb,kBAAkB,CACnB,CAAC;IACJ,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;IACnC,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

@@ -1,9 +1,3 @@
 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";
-export * from "./friendlyId.js";
-export * from "./duration.js";
+export * from "./exec.js";

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

@@ -1,10 +1,4 @@
 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";
-export * from "./friendlyId.js";
-export * from "./duration.js";
+export * from "./exec.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +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;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/v3/apps/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC"}

package/dist/esm/v3/auth/environment.d.ts

@@ -0,0 +1,63 @@
+export type RuntimeEnvironmentType = "PRODUCTION" | "STAGING" | "DEVELOPMENT" | "PREVIEW";
+export type RunEngineVersion = "V1" | "V2";
+type DecimalLike = {
+    toNumber(): number;
+};
+export type AuthenticatedEnvironment = {
+    id: string;
+    slug: string;
+    type: RuntimeEnvironmentType;
+    apiKey: string;
+    organizationId: string;
+    projectId: string;
+    orgMemberId: string | null;
+    parentEnvironmentId: string | null;
+    branchName: string | null;
+    archivedAt: Date | null;
+    paused: boolean;
+    shortcode: string;
+    maximumConcurrencyLimit: number;
+    concurrencyLimitBurstFactor: number | DecimalLike;
+    builtInEnvironmentVariableOverrides: unknown;
+    createdAt: Date;
+    updatedAt: Date;
+    project: {
+        id: string;
+        slug: string;
+        name: string;
+        externalRef: string;
+        engine: RunEngineVersion;
+        deletedAt: Date | null;
+        defaultWorkerGroupId: string | null;
+        organizationId: string;
+        builderProjectId: string | null;
+        defaultRuntime?: string | null;
+    };
+    organization: {
+        id: string;
+        slug: string;
+        title: string;
+        streamBasinName: string | null;
+        maximumConcurrencyLimit: number | null;
+        runsEnabled: boolean;
+        maximumDevQueueSize: number | null;
+        maximumDeployedQueueSize: number | null;
+        featureFlags: unknown;
+        apiRateLimiterConfig: unknown;
+        batchRateLimitConfig: unknown;
+        batchQueueConcurrencyConfig: unknown;
+    };
+    orgMember?: {
+        userId: string;
+        user?: {
+            id: string;
+            displayName: string | null;
+            name: string | null;
+        };
+    } | null;
+    parentEnvironment?: {
+        id: string;
+        apiKey: string;
+    } | null;
+};
+export {};