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

package/dist/esm/v3/apiClient/encodeTaskIdForPath.js

@@ -0,0 +1,17 @@
+/**
+ * Percent-encode a task id for use as a single URL path segment. `encodeURIComponent` throws a
+ * `URIError` for a string that cannot be represented in a URL (an unpaired UTF-16 surrogate);
+ * rethrow it as a clear, actionable error naming the id instead of a cryptic "URI malformed".
+ */
+export function encodeTaskIdForPath(taskId) {
+    try {
+        return encodeURIComponent(taskId);
+    }
+    catch (error) {
+        if (error instanceof URIError) {
+            throw new Error(`Invalid task id ${JSON.stringify(taskId)}: it contains characters that cannot be encoded into a URL (for example an unpaired surrogate). Rename the task to use valid characters.`);
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=encodeTaskIdForPath.js.map

package/dist/esm/v3/apiClient/encodeTaskIdForPath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encodeTaskIdForPath.js","sourceRoot":"","sources":["../../../../src/v3/apiClient/encodeTaskIdForPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,CAAC,SAAS,CAC/B,MAAM,CACP,0IAA0I,CAC5I,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/esm/v3/apiClient/errors.d.ts

@@ -2,13 +2,15 @@ export type APIHeaders = Record<string, string | null | undefined>;
 export declare class ApiError extends Error {
     readonly status: number | undefined;
     readonly headers: APIHeaders | undefined;
-    readonly error: Object | undefined;
+    readonly error: object | undefined;
+    /** The whole parsed response body, including fields beside `error` like `code` and `reason`. */
+    readonly body: object | undefined;
     readonly code: string | null | undefined;
     readonly param: string | null | undefined;
     readonly type: string | undefined;
-    constructor(status: number | undefined, error: Object | undefined, message: string | undefined, headers: APIHeaders | undefined);
+    constructor(status: number | undefined, error: object | undefined, message: string | undefined, headers: APIHeaders | undefined, body?: object);
     private static makeMessage;
-    static generate(status: number | undefined, errorResponse: Object | undefined, message: string | undefined, headers: APIHeaders | undefined): ApiError;
+    static generate(status: number | undefined, errorResponse: object | undefined, message: string | undefined, headers: APIHeaders | undefined): ApiError;
 }
 export declare class ApiConnectionError extends ApiError {
     readonly status: undefined;
@@ -26,6 +28,11 @@ export declare class AuthenticationError extends ApiError {
 export declare class PermissionDeniedError extends ApiError {
     readonly status: 403;
 }
+/**
+ * True when `error` is a 401/403 from the Trigger API (e.g. expired run-scoped PAT on realtime streams).
+ * Uses structural checks so it works even if multiple copies of `@trigger.dev/core` are bundled (subclass `instanceof` can fail).
+ */
+export declare function isTriggerRealtimeAuthError(error: unknown): boolean;
 export declare class NotFoundError extends ApiError {
     readonly status: 404;
 }
@@ -52,3 +59,28 @@ export declare class ApiSchemaValidationError extends ApiError {
         headers: APIHeaders | undefined;
     });
 }
+/**
+ * Error thrown when a batch stream completes but the batch was not sealed.
+ * This indicates that not all expected items were received by the server.
+ * The client should retry sending all items, or investigate the mismatch.
+ */
+export declare class BatchNotSealedError extends Error {
+    readonly name = "BatchNotSealedError";
+    /** The batch ID that was not sealed */
+    readonly batchId: string;
+    /** Number of items currently enqueued on the server */
+    readonly enqueuedCount: number;
+    /** Number of items expected to complete the batch */
+    readonly expectedCount: number;
+    /** Number of items accepted in this request */
+    readonly itemsAccepted: number;
+    /** Number of items deduplicated in this request */
+    readonly itemsDeduplicated: number;
+    constructor(options: {
+        batchId: string;
+        enqueuedCount: number;
+        expectedCount: number;
+        itemsAccepted: number;
+        itemsDeduplicated: number;
+    });
+}

package/dist/esm/v3/apiClient/errors.js

@@ -2,36 +2,45 @@ export class ApiError extends Error {
     status;
     headers;
     error;
+    /** The whole parsed response body, including fields beside `error` like `code` and `reason`. */
+    body;
     code;
     param;
     type;
-    constructor(status, error, message, headers) {
+    constructor(status, error, message, headers, body) {
         super(`${ApiError.makeMessage(status, error, message)}`);
         this.name = "TriggerApiError";
         this.status = status;
         this.headers = headers;
+        this.body = body;
         const data = error;
+        const fields = typeof data === "object" && data !== null ? data : body;
         this.error = data;
-        this.code = data?.["code"];
-        this.param = data?.["param"];
-        this.type = data?.["type"];
+        this.code = fields?.["code"];
+        this.param = fields?.["param"];
+        this.type = fields?.["type"];
     }
     static makeMessage(status, error, message) {
-        const msg = error?.message
+        const errorMessage = error?.message
             ? typeof error.message === "string"
                 ? error.message
                 : JSON.stringify(error.message)
-            : error
-                ? JSON.stringify(error)
-                : message;
-        if (status && msg) {
-            return `${status} ${msg}`;
+            : typeof error === "string"
+                ? error
+                : error
+                    ? JSON.stringify(error)
+                    : undefined;
+        if (errorMessage) {
+            return errorMessage;
+        }
+        if (status && message) {
+            return `${status} ${message}`;
         }
         if (status) {
             return `${status} status code (no body)`;
         }
-        if (msg) {
-            return msg;
+        if (message) {
+            return message;
         }
         return "(no status code or body)";
     }
@@ -41,30 +50,30 @@ export class ApiError extends Error {
         }
         const error = errorResponse?.["error"];
         if (status === 400) {
-            return new BadRequestError(status, error, message, headers);
+            return new BadRequestError(status, error, message, headers, errorResponse);
         }
         if (status === 401) {
-            return new AuthenticationError(status, error, message, headers);
+            return new AuthenticationError(status, error, message, headers, errorResponse);
         }
         if (status === 403) {
-            return new PermissionDeniedError(status, error, message, headers);
+            return new PermissionDeniedError(status, error, message, headers, errorResponse);
         }
         if (status === 404) {
-            return new NotFoundError(status, error, message, headers);
+            return new NotFoundError(status, error, message, headers, errorResponse);
         }
         if (status === 409) {
-            return new ConflictError(status, error, message, headers);
+            return new ConflictError(status, error, message, headers, errorResponse);
         }
         if (status === 422) {
-            return new UnprocessableEntityError(status, error, message, headers);
+            return new UnprocessableEntityError(status, error, message, headers, errorResponse);
         }
         if (status === 429) {
-            return new RateLimitError(status, error, message, headers);
+            return new RateLimitError(status, error, message, headers, errorResponse);
         }
         if (status >= 500) {
-            return new InternalServerError(status, error, message, headers);
+            return new InternalServerError(status, error, message, headers, errorResponse);
         }
-        return new ApiError(status, error, message, headers);
+        return new ApiError(status, error, message, headers, errorResponse);
     }
 }
 export class ApiConnectionError extends ApiError {
@@ -86,6 +95,17 @@ export class AuthenticationError extends ApiError {
 export class PermissionDeniedError extends ApiError {
     status = 403;
 }
+/**
+ * True when `error` is a 401/403 from the Trigger API (e.g. expired run-scoped PAT on realtime streams).
+ * Uses structural checks so it works even if multiple copies of `@trigger.dev/core` are bundled (subclass `instanceof` can fail).
+ */
+export function isTriggerRealtimeAuthError(error) {
+    if (error === null || typeof error !== "object") {
+        return false;
+    }
+    const e = error;
+    return e.name === "TriggerApiError" && (e.status === 401 || e.status === 403);
+}
 export class NotFoundError extends ApiError {
     status = 404;
 }
@@ -125,6 +145,33 @@ export class ApiSchemaValidationError extends ApiError {
         this.rawBody = rawBody;
     }
 }
+/**
+ * Error thrown when a batch stream completes but the batch was not sealed.
+ * This indicates that not all expected items were received by the server.
+ * The client should retry sending all items, or investigate the mismatch.
+ */
+export class BatchNotSealedError extends Error {
+    name = "BatchNotSealedError";
+    /** The batch ID that was not sealed */
+    batchId;
+    /** Number of items currently enqueued on the server */
+    enqueuedCount;
+    /** Number of items expected to complete the batch */
+    expectedCount;
+    /** Number of items accepted in this request */
+    itemsAccepted;
+    /** Number of items deduplicated in this request */
+    itemsDeduplicated;
+    constructor(options) {
+        const message = `Batch ${options.batchId} was not sealed: received ${options.enqueuedCount} of ${options.expectedCount} expected items (accepted: ${options.itemsAccepted}, deduplicated: ${options.itemsDeduplicated})`;
+        super(message);
+        this.batchId = options.batchId;
+        this.enqueuedCount = options.enqueuedCount;
+        this.expectedCount = options.expectedCount;
+        this.itemsAccepted = options.itemsAccepted;
+        this.itemsDeduplicated = options.itemsDeduplicated;
+    }
+}
 function castToError(err) {
     if (err instanceof Error)
         return err;

package/dist/esm/v3/apiClient/errors.js.map

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

package/dist/esm/v3/apiClient/getBranch.d.ts

@@ -0,0 +1,8 @@
+import type { GitMeta } from "../schemas/index.js";
+export declare function getBranch({ specified, gitMeta, }: {
+    specified?: string;
+    gitMeta?: GitMeta;
+}): string | undefined;
+export declare function getDevBranch({ specified }: {
+    specified?: string;
+}): string | undefined;

package/dist/esm/v3/apiClient/getBranch.js

@@ -0,0 +1,33 @@
+import { getEnvVar } from "../utils/getEnv.js";
+import { isDefaultDevBranch } from "../utils/gitBranch.js";
+export function getBranch({ specified, gitMeta, }) {
+    if (specified) {
+        return specified;
+    }
+    // not specified, so detect our variable from process.env
+    const envVar = getEnvVar("TRIGGER_PREVIEW_BRANCH");
+    if (envVar) {
+        return envVar;
+    }
+    // detect the Vercel preview branch
+    const vercelPreviewBranch = getEnvVar("VERCEL_GIT_COMMIT_REF");
+    if (vercelPreviewBranch) {
+        return vercelPreviewBranch;
+    }
+    // not specified, so detect from git metadata. "HEAD" is a detached checkout, not a branch.
+    if (gitMeta?.commitRef && gitMeta.commitRef !== "HEAD") {
+        return gitMeta.commitRef;
+    }
+    return undefined;
+}
+export function getDevBranch({ specified }) {
+    // For development we don't look at git/Vercel — only the flag and our env var.
+    const branch = specified ?? getEnvVar("TRIGGER_DEV_BRANCH");
+    // No branch and the "default" sentinel both mean the root dev env, which
+    // carries no branch. Collapse to undefined so callers send no branch
+    if (!branch || isDefaultDevBranch(branch)) {
+        return undefined;
+    }
+    return branch;
+}
+//# sourceMappingURL=getBranch.js.map

package/dist/esm/v3/apiClient/getBranch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getBranch.js","sourceRoot":"","sources":["../../../../src/v3/apiClient/getBranch.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,MAAM,UAAU,SAAS,CAAC,EACxB,SAAS,EACT,OAAO,GAIR;IACC,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,yDAAyD;IACzD,MAAM,MAAM,GAAG,SAAS,CAAC,wBAAwB,CAAC,CAAC;IACnD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,mCAAmC;IACnC,MAAM,mBAAmB,GAAG,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAC/D,IAAI,mBAAmB,EAAE,CAAC;QACxB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,2FAA2F;IAC3F,IAAI,OAAO,EAAE,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QACvD,OAAO,OAAO,CAAC,SAAS,CAAC;IAC3B,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAA0B;IAChE,+EAA+E;IAC/E,MAAM,MAAM,GAAG,SAAS,IAAI,SAAS,CAAC,oBAAoB,CAAC,CAAC;IAE5D,yEAAyE;IACzE,qEAAqE;IACrE,IAAI,CAAC,MAAM,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}