@trigger.dev/sdk 3.0.0-beta.7 → 3.0.0

package/dist/esm/v3/cache.js

@@ -0,0 +1,58 @@
+import { SemanticInternalAttributes } from "@trigger.dev/core/v3";
+import { tracer } from "./tracer.js";
+export class InMemoryCache {
+    _cache = new Map();
+    get(key) {
+        return this._cache.get(key);
+    }
+    set(key, value) {
+        this._cache.set(key, value);
+        return undefined;
+    }
+    delete(key) {
+        this._cache.delete(key);
+        return undefined;
+    }
+}
+/**
+ * Create a cache function that uses the provided store to cache values. Using InMemoryCache is safe because each task run is isolated.
+ * @param store
+ * @returns
+ */
+export function createCache(store) {
+    return function cache(cacheKey, fn) {
+        return tracer.startActiveSpan("cache", async (span) => {
+            span.setAttribute("cache.key", cacheKey);
+            span.setAttribute(SemanticInternalAttributes.STYLE_ICON, "device-sd-card");
+            const cacheEntry = await store.get(cacheKey);
+            if (cacheEntry) {
+                span.updateName(`cache.hit ${cacheKey}`);
+                return cacheEntry.value;
+            }
+            span.updateName(`cache.miss ${cacheKey}`);
+            const value = await tracer.startActiveSpan("cache.getFreshValue", async (span) => {
+                return await fn();
+            }, {
+                attributes: {
+                    "cache.key": cacheKey,
+                    [SemanticInternalAttributes.STYLE_ICON]: "device-sd-card",
+                },
+            });
+            await tracer.startActiveSpan("cache.set", async (span) => {
+                await store.set(cacheKey, {
+                    value,
+                    metadata: {
+                        createdTime: Date.now(),
+                    },
+                });
+            }, {
+                attributes: {
+                    "cache.key": cacheKey,
+                    [SemanticInternalAttributes.STYLE_ICON]: "device-sd-card",
+                },
+            });
+            return value;
+        });
+    };
+}
+//# sourceMappingURL=cache.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/v3/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA0BrC,MAAM,OAAO,aAAa;IAChB,MAAM,GAAmC,IAAI,GAAG,EAAE,CAAC;IAE3D,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,KAAwB;QACvC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAE5B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAExB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,SAAS,KAAK,CACnB,QAAgB,EAChB,EAAgC;QAEhC,OAAO,MAAM,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YACpD,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACzC,IAAI,CAAC,YAAY,CAAC,0BAA0B,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;YAE3E,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAE7C,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC;gBAEzC,OAAO,UAAU,CAAC,KAAK,CAAC;YAC1B,CAAC;YAED,IAAI,CAAC,UAAU,CAAC,cAAc,QAAQ,EAAE,CAAC,CAAC;YAE1C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,eAAe,CACxC,qBAAqB,EACrB,KAAK,EAAE,IAAI,EAAE,EAAE;gBACb,OAAO,MAAM,EAAE,EAAE,CAAC;YACpB,CAAC,EACD;gBACE,UAAU,EAAE;oBACV,WAAW,EAAE,QAAQ;oBACrB,CAAC,0BAA0B,CAAC,UAAU,CAAC,EAAE,gBAAgB;iBAC1D;aACF,CACF,CAAC;YAEF,MAAM,MAAM,CAAC,eAAe,CAC1B,WAAW,EACX,KAAK,EAAE,IAAI,EAAE,EAAE;gBACb,MAAM,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;oBACxB,KAAK;oBACL,QAAQ,EAAE;wBACR,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE;qBACxB;iBACF,CAAC,CAAC;YACL,CAAC,EACD;gBACE,UAAU,EAAE;oBACV,WAAW,EAAE,QAAQ;oBACrB,CAAC,0BAA0B,CAAC,UAAU,CAAC,EAAE,gBAAgB;iBAC1D;aACF,CACF,CAAC;YAEF,OAAO,KAAK,CAAC;QACf,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { TriggerConfig } from "@trigger.dev/core/v3";
+export type { HandleErrorArgs, HandleErrorFunction, ResolveEnvironmentVariablesFunction, ResolveEnvironmentVariablesParams, ResolveEnvironmentVariablesResult, } from "@trigger.dev/core/v3";
+export declare function defineConfig(config: TriggerConfig): TriggerConfig;
+export type { TriggerConfig };

package/dist/esm/v3/config.js

@@ -0,0 +1,4 @@
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/v3/config.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,YAAY,CAAC,MAAqB;IAChD,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,14 @@
+import type { ApiPromise, ApiRequestOptions, CreateEnvironmentVariableParams, EnvironmentVariableResponseBody, EnvironmentVariableValue, EnvironmentVariables, ImportEnvironmentVariablesParams, UpdateEnvironmentVariableParams } from "@trigger.dev/core/v3";
+export type { CreateEnvironmentVariableParams, ImportEnvironmentVariablesParams };
+export declare function upload(projectRef: string, slug: string, params: ImportEnvironmentVariablesParams, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;
+export declare function upload(params: ImportEnvironmentVariablesParams, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;
+export declare function list(projectRef: string, slug: string, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariables>;
+export declare function list(requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariables>;
+export declare function create(projectRef: string, slug: string, params: CreateEnvironmentVariableParams, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;
+export declare function create(params: CreateEnvironmentVariableParams, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;
+export declare function retrieve(projectRef: string, slug: string, name: string, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableValue>;
+export declare function retrieve(name: string, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableValue>;
+export declare function del(projectRef: string, slug: string, name: string, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;
+export declare function del(name: string, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;
+export declare function update(projectRef: string, slug: string, name: string, params: UpdateEnvironmentVariableParams, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;
+export declare function update(name: string, params: UpdateEnvironmentVariableParams, requestOptions?: ApiRequestOptions): ApiPromise<EnvironmentVariableResponseBody>;

package/dist/esm/v3/envvars.js

@@ -0,0 +1,238 @@
+import { apiClientManager, isRequestOptions, mergeRequestOptions, taskContext, } from "@trigger.dev/core/v3";
+import { apiClientMissingError } from "./shared.js";
+import { tracer } from "./tracer.js";
+export function upload(projectRefOrParams, slugOrRequestOptions, params, requestOptions) {
+    let $projectRef;
+    let $params;
+    let $slug;
+    const $requestOptions = overloadRequestOptions("upload", slugOrRequestOptions, requestOptions);
+    if (taskContext.ctx) {
+        if (typeof projectRefOrParams === "string") {
+            $projectRef = projectRefOrParams;
+            $slug =
+                typeof slugOrRequestOptions === "string"
+                    ? slugOrRequestOptions
+                    : taskContext.ctx.environment.slug;
+            if (!params) {
+                throw new Error("params is required");
+            }
+            $params = params;
+        }
+        else {
+            $params = projectRefOrParams;
+            $projectRef = taskContext.ctx.project.ref;
+            $slug = taskContext.ctx.environment.slug;
+        }
+    }
+    else {
+        if (typeof projectRefOrParams !== "string") {
+            throw new Error("projectRef is required");
+        }
+        if (!slugOrRequestOptions || typeof slugOrRequestOptions !== "string") {
+            throw new Error("slug is required");
+        }
+        if (!params) {
+            throw new Error("params is required");
+        }
+        $projectRef = projectRefOrParams;
+        $slug = slugOrRequestOptions;
+        $params = params;
+    }
+    const apiClient = apiClientManager.client;
+    if (!apiClient) {
+        throw apiClientMissingError();
+    }
+    return apiClient.importEnvVars($projectRef, $slug, $params, $requestOptions);
+}
+export function list(projectRefOrRequestOptions, slug, requestOptions) {
+    const $projectRef = !isRequestOptions(projectRefOrRequestOptions)
+        ? projectRefOrRequestOptions
+        : taskContext.ctx?.project.ref;
+    const $slug = slug ?? taskContext.ctx?.environment.slug;
+    let $requestOptions = isRequestOptions(projectRefOrRequestOptions)
+        ? projectRefOrRequestOptions
+        : requestOptions;
+    if (!$projectRef) {
+        throw new Error("projectRef is required");
+    }
+    if (!$slug) {
+        throw new Error("slug is required");
+    }
+    $requestOptions = mergeRequestOptions({
+        tracer,
+        name: "envvars.list()",
+        icon: "id-badge",
+    }, $requestOptions);
+    const apiClient = apiClientManager.client;
+    if (!apiClient) {
+        throw apiClientMissingError();
+    }
+    return apiClient.listEnvVars($projectRef, $slug, $requestOptions);
+}
+export function create(projectRefOrParams, slugOrRequestOptions, params, requestOptions) {
+    let $projectRef;
+    let $slug;
+    let $params;
+    const $requestOptions = overloadRequestOptions("create", slugOrRequestOptions, requestOptions);
+    if (taskContext.ctx) {
+        if (typeof projectRefOrParams === "string") {
+            $projectRef = projectRefOrParams;
+            $slug =
+                typeof slugOrRequestOptions === "string"
+                    ? slugOrRequestOptions
+                    : taskContext.ctx.environment.slug;
+            if (!params) {
+                throw new Error("params is required");
+            }
+            $params = params;
+        }
+        else {
+            $params = projectRefOrParams;
+            $projectRef = taskContext.ctx.project.ref;
+            $slug = taskContext.ctx.environment.slug;
+        }
+    }
+    else {
+        if (typeof projectRefOrParams !== "string") {
+            throw new Error("projectRef is required");
+        }
+        if (!slugOrRequestOptions || typeof slugOrRequestOptions !== "string") {
+            throw new Error("slug is required");
+        }
+        if (!params) {
+            throw new Error("params is required");
+        }
+        $projectRef = projectRefOrParams;
+        $slug = slugOrRequestOptions;
+        $params = params;
+    }
+    const apiClient = apiClientManager.client;
+    if (!apiClient) {
+        throw apiClientMissingError();
+    }
+    return apiClient.createEnvVar($projectRef, $slug, $params, $requestOptions);
+}
+export function retrieve(projectRefOrName, slugOrRequestOptions, name, requestOptions) {
+    let $projectRef;
+    let $slug;
+    let $name;
+    const $requestOptions = overloadRequestOptions("retrieve", slugOrRequestOptions, requestOptions);
+    if (typeof name === "string") {
+        $projectRef = projectRefOrName;
+        $slug =
+            typeof slugOrRequestOptions === "string"
+                ? slugOrRequestOptions
+                : taskContext.ctx?.environment.slug;
+        $name = name;
+    }
+    else {
+        $projectRef = taskContext.ctx?.project.ref;
+        $slug = taskContext.ctx?.environment.slug;
+        $name = projectRefOrName;
+    }
+    if (!$projectRef) {
+        throw new Error("projectRef is required");
+    }
+    if (!$slug) {
+        throw new Error("slug is required");
+    }
+    const apiClient = apiClientManager.client;
+    if (!apiClient) {
+        throw apiClientMissingError();
+    }
+    return apiClient.retrieveEnvVar($projectRef, $slug, $name, $requestOptions);
+}
+export function del(projectRefOrName, slugOrRequestOptions, name, requestOptions) {
+    let $projectRef;
+    let $slug;
+    let $name;
+    const $requestOptions = overloadRequestOptions("del", slugOrRequestOptions, requestOptions);
+    if (typeof name === "string") {
+        $projectRef = projectRefOrName;
+        $slug =
+            typeof slugOrRequestOptions === "string"
+                ? slugOrRequestOptions
+                : taskContext.ctx?.environment.slug;
+        $name = name;
+    }
+    else {
+        $projectRef = taskContext.ctx?.project.ref;
+        $slug = taskContext.ctx?.environment.slug;
+        $name = projectRefOrName;
+    }
+    if (!$projectRef) {
+        throw new Error("projectRef is required");
+    }
+    if (!$slug) {
+        throw new Error("slug is required");
+    }
+    const apiClient = apiClientManager.client;
+    if (!apiClient) {
+        throw apiClientMissingError();
+    }
+    return apiClient.deleteEnvVar($projectRef, $slug, $name, $requestOptions);
+}
+export function update(projectRefOrName, slugOrParams, nameOrRequestOptions, params, requestOptions) {
+    let $projectRef;
+    let $slug;
+    let $name;
+    let $params;
+    const $requestOptions = overloadRequestOptions("update", nameOrRequestOptions, requestOptions);
+    if (taskContext.ctx) {
+        if (typeof slugOrParams === "string") {
+            $projectRef = slugOrParams;
+            $slug = slugOrParams ?? taskContext.ctx.environment.slug;
+            $name =
+                typeof nameOrRequestOptions === "string"
+                    ? nameOrRequestOptions
+                    : taskContext.ctx.environment.slug;
+            if (!params) {
+                throw new Error("params is required");
+            }
+            $params = params;
+        }
+        else {
+            $params = slugOrParams;
+            $projectRef = taskContext.ctx.project.ref;
+            $slug = taskContext.ctx.environment.slug;
+            $name = projectRefOrName;
+        }
+    }
+    else {
+        if (typeof slugOrParams !== "string") {
+            throw new Error("slug is required");
+        }
+        if (!projectRefOrName) {
+            throw new Error("projectRef is required");
+        }
+        if (!params) {
+            throw new Error("params is required");
+        }
+        $projectRef = projectRefOrName;
+        $slug = slugOrParams;
+        $name = name;
+        $params = params;
+    }
+    const apiClient = apiClientManager.client;
+    if (!apiClient) {
+        throw apiClientMissingError();
+    }
+    return apiClient.updateEnvVar($projectRef, $slug, $name, $params, $requestOptions);
+}
+function overloadRequestOptions(name, slugOrRequestOptions, requestOptions) {
+    if (isRequestOptions(slugOrRequestOptions)) {
+        return mergeRequestOptions({
+            tracer,
+            name: `envvars.${name}()`,
+            icon: "id-badge",
+        }, slugOrRequestOptions);
+    }
+    else {
+        return mergeRequestOptions({
+            tracer,
+            name: `envvars.${name}()`,
+            icon: "id-badge",
+        }, requestOptions);
+    }
+}
+//# sourceMappingURL=envvars.js.map

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

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

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

@@ -0,0 +1,49 @@
+export declare const idempotencyKeys: {
+    create: typeof createIdempotencyKey;
+};
+declare const __brand: unique symbol;
+type Brand<B> = {
+    [__brand]: B;
+};
+type Branded<T, B> = T & Brand<B>;
+export type IdempotencyKey = Branded<string, "IdempotencyKey">;
+export declare function isIdempotencyKey(value: string | string[] | IdempotencyKey): value is IdempotencyKey;
+/**
+ * Creates a deterministic idempotency key based on the provided key material.
+ *
+ * If running inside a task, the task run ID is automatically included in the key material, giving you a unique key per task run.
+ * This ensures that a given child task is only triggered once per task run, even if the parent task is retried.
+ *
+ * @param {string | string[]} key The key material to create the idempotency key from.
+ * @param {object} [options] Additional options.
+ * @param {"run" | "attempt" | "global"} [options.scope="run"] The scope of the idempotency key.
+ *
+ * @returns {Promise<IdempotencyKey>} The idempotency key as a branded string.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { idempotencyKeys, task } from "@trigger.dev/sdk/v3";
+ *
+ * export const myTask = task({
+ *  id: "my-task",
+ *  run: async (payload: any) => {
+ *   const idempotencyKey = await idempotencyKeys.create("my-task-key");
+ *
+ *   // Use the idempotency key when triggering child tasks
+ *   await childTask.triggerAndWait(payload, { idempotencyKey });
+ *  }
+ * });
+ * ```
+ *
+ * You can also use the `scope` parameter to create a key that is unique per task run, task run attempts (retries of the same run), or globally:
+ *
+ * ```typescript
+ *  await idempotencyKeys.create("my-task-key", { scope: "attempt" }); // Creates a key that is unique per task run attempt
+ *  await idempotencyKeys.create("my-task-key", { scope: "global" }); // Skips including the task run ID
+ * ```
+ */
+declare function createIdempotencyKey(key: string | string[], options?: {
+    scope?: "run" | "attempt" | "global";
+}): Promise<IdempotencyKey>;
+export {};

package/dist/esm/v3/idempotencyKeys.js

@@ -0,0 +1,72 @@
+import { taskContext } from "@trigger.dev/core/v3";
+export const idempotencyKeys = {
+    create: createIdempotencyKey,
+};
+export function isIdempotencyKey(value) {
+    // Cannot check the brand at runtime because it doesn't exist (it's a TypeScript-only construct)
+    return typeof value === "string" && value.length === 64;
+}
+/**
+ * Creates a deterministic idempotency key based on the provided key material.
+ *
+ * If running inside a task, the task run ID is automatically included in the key material, giving you a unique key per task run.
+ * This ensures that a given child task is only triggered once per task run, even if the parent task is retried.
+ *
+ * @param {string | string[]} key The key material to create the idempotency key from.
+ * @param {object} [options] Additional options.
+ * @param {"run" | "attempt" | "global"} [options.scope="run"] The scope of the idempotency key.
+ *
+ * @returns {Promise<IdempotencyKey>} The idempotency key as a branded string.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { idempotencyKeys, task } from "@trigger.dev/sdk/v3";
+ *
+ * export const myTask = task({
+ *  id: "my-task",
+ *  run: async (payload: any) => {
+ *   const idempotencyKey = await idempotencyKeys.create("my-task-key");
+ *
+ *   // Use the idempotency key when triggering child tasks
+ *   await childTask.triggerAndWait(payload, { idempotencyKey });
+ *  }
+ * });
+ * ```
+ *
+ * You can also use the `scope` parameter to create a key that is unique per task run, task run attempts (retries of the same run), or globally:
+ *
+ * ```typescript
+ *  await idempotencyKeys.create("my-task-key", { scope: "attempt" }); // Creates a key that is unique per task run attempt
+ *  await idempotencyKeys.create("my-task-key", { scope: "global" }); // Skips including the task run ID
+ * ```
+ */
+async function createIdempotencyKey(key, options) {
+    const idempotencyKey = await generateIdempotencyKey([...(Array.isArray(key) ? key : [key])].concat(injectScope(options?.scope ?? "run")));
+    return idempotencyKey;
+}
+function injectScope(scope) {
+    switch (scope) {
+        case "run": {
+            if (taskContext?.ctx) {
+                return [taskContext.ctx.run.id];
+            }
+            break;
+        }
+        case "attempt": {
+            if (taskContext?.ctx) {
+                return [taskContext.ctx.attempt.id];
+            }
+            break;
+        }
+    }
+    return [];
+}
+async function generateIdempotencyKey(keyMaterial) {
+    const hash = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(keyMaterial.join("-")));
+    // Return a hex string, using cross-runtime compatible methods
+    return Array.from(new Uint8Array(hash))
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+//# sourceMappingURL=idempotencyKeys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"idempotencyKeys.js","sourceRoot":"","sources":["../../../src/v3/idempotencyKeys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,MAAM,EAAE,oBAAoB;CAC7B,CAAC;AAQF,MAAM,UAAU,gBAAgB,CAC9B,KAAyC;IAEzC,gGAAgG;IAChG,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,KAAK,UAAU,oBAAoB,CACjC,GAAsB,EACtB,OAAkD;IAElD,MAAM,cAAc,GAAG,MAAM,sBAAsB,CACjD,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC,CACrF,CAAC;IAEF,OAAO,cAAgC,CAAC;AAC1C,CAAC;AAED,SAAS,WAAW,CAAC,KAAmC;IACtD,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,IAAI,WAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClC,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,WAAW,EAAE,GAAG,EAAE,CAAC;gBACrB,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACtC,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,WAAqB;IACzD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CACrC,SAAS,EACT,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAChD,CAAC;IAEF,8DAA8D;IAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;SACpC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;SACjD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,36 @@
+export * from "./cache.js";
+export * from "./config.js";
+export { retry, type RetryOptions } from "./retry.js";
+export { queue } from "./shared.js";
+export * from "./tasks.js";
+export * from "./wait.js";
+export * from "./usage.js";
+export * from "./idempotencyKeys.js";
+export * from "./tags.js";
+export type { Context };
+import type { Context } from "./shared.js";
+import type { ApiClientConfiguration } from "@trigger.dev/core/v3";
+export type { ApiClientConfiguration };
+export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, logger, type LogLevel, } from "@trigger.dev/core/v3";
+export { runs } from "./runs.js";
+export * as schedules from "./schedules/index.js";
+export * as envvars from "./envvars.js";
+export type { ImportEnvironmentVariablesParams } from "./envvars.js";
+/**
+ * Register the global API client configuration. Alternatively, you can set the `TRIGGER_SECRET_KEY` and `TRIGGER_API_URL` environment variables.
+ * @param options The API client configuration.
+ * @param options.baseURL The base URL of the Trigger API. (default: `https://api.trigger.dev`)
+ * @param options.secretKey The secret key to authenticate with the Trigger API. (default: `process.env.TRIGGER_SECRET_KEY`) This can be found in your Trigger.dev project "API Keys" settings.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { configure } from "@trigger.dev/sdk/v3";
+ *
+ * configure({
+ *  baseURL: "https://api.trigger.dev",
+ *  secretKey: "tr_dev_1234567890"
+ * });
+ * ```
+ */
+export declare function configure(options: ApiClientConfiguration): void;

package/dist/esm/v3/index.js

@@ -0,0 +1,35 @@
+export * from "./cache.js";
+export * from "./config.js";
+export { retry } from "./retry.js";
+export { queue } from "./shared.js";
+export * from "./tasks.js";
+export * from "./wait.js";
+export * from "./usage.js";
+export * from "./idempotencyKeys.js";
+export * from "./tags.js";
+import { apiClientManager } from "@trigger.dev/core/v3";
+export { ApiError, AuthenticationError, BadRequestError, ConflictError, InternalServerError, NotFoundError, PermissionDeniedError, RateLimitError, UnprocessableEntityError, AbortTaskRunError, logger, } from "@trigger.dev/core/v3";
+export { runs } from "./runs.js";
+export * as schedules from "./schedules/index.js";
+export * as envvars from "./envvars.js";
+/**
+ * Register the global API client configuration. Alternatively, you can set the `TRIGGER_SECRET_KEY` and `TRIGGER_API_URL` environment variables.
+ * @param options The API client configuration.
+ * @param options.baseURL The base URL of the Trigger API. (default: `https://api.trigger.dev`)
+ * @param options.secretKey The secret key to authenticate with the Trigger API. (default: `process.env.TRIGGER_SECRET_KEY`) This can be found in your Trigger.dev project "API Keys" settings.
+ *
+ * @example
+ *
+ * ```typescript
+ * import { configure } from "@trigger.dev/sdk/v3";
+ *
+ * configure({
+ *  baseURL: "https://api.trigger.dev",
+ *  secretKey: "tr_dev_1234567890"
+ * });
+ * ```
+ */
+export function configure(options) {
+    apiClientManager.setGlobalAPIClientConfiguration(options);
+}
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/v3/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,EAAqB,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAM1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,iBAAiB,EACjB,MAAM,GAEP,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,OAAO,MAAM,cAAc,CAAC;AAGxC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,OAA+B;IACvD,gBAAgB,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC"}

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

@@ -0,0 +1,15 @@
+import { FetchRetryOptions, RetryOptions } from "@trigger.dev/core/v3";
+export type { RetryOptions };
+declare function onThrow<T>(fn: (options: {
+    attempt: number;
+    maxAttempts: number;
+}) => Promise<T>, options: RetryOptions): Promise<T>;
+export interface RetryFetchRequestInit extends RequestInit {
+    retry?: FetchRetryOptions;
+    timeoutInMs?: number;
+}
+declare function retryFetch(input: RequestInfo | URL, init?: RetryFetchRequestInit | undefined): Promise<Response>;
+export declare const retry: {
+    onThrow: typeof onThrow;
+    fetch: typeof retryFetch;
+};