@trigger.dev/sdk 3.3.1 → 3.3.3

package/dist/commonjs/v3/auth.d.ts

@@ -20,9 +20,13 @@ export declare function configure(options: ApiClientConfiguration): void;
 export declare const auth: {
     configure: typeof configure;
     createPublicToken: typeof createPublicToken;
+    createTriggerPublicToken: typeof createTriggerPublicToken;
+    createBatchTriggerPublicToken: typeof createBatchTriggerPublicToken;
     withAuth: typeof withAuth;
+    withPublicToken: typeof withPublicToken;
+    withTriggerPublicToken: typeof withTriggerPublicToken;
+    withBatchTriggerPublicToken: typeof withBatchTriggerPublicToken;
 };
-type PublicTokenPermissionAction = "read" | "write";
 type PublicTokenPermissionProperties = {
     /**
      * Grant access to specific tasks
@@ -42,7 +46,23 @@ type PublicTokenPermissionProperties = {
     batch?: string | string[];
 };
 export type PublicTokenPermissions = {
-    [key in PublicTokenPermissionAction]?: PublicTokenPermissionProperties;
+    read?: PublicTokenPermissionProperties;
+    /**
+     * @deprecated use trigger instead
+     */
+    write?: PublicTokenPermissionProperties;
+    /**
+     * Use auth.createTriggerPublicToken
+     */
+    trigger?: {
+        tasks: string | string[];
+    };
+    /**
+     * Use auth.createBatchTriggerPublicToken
+     */
+    batchTrigger?: {
+        tasks: string | string[];
+    };
 };
 export type CreatePublicTokenOptions = {
     /**
@@ -92,6 +112,111 @@ export type CreatePublicTokenOptions = {
  * ```
  */
 declare function createPublicToken(options?: CreatePublicTokenOptions): Promise<string>;
+/**
+ * Executes a function with a public token, providing temporary access permissions.
+ *
+ * @param options - Options for creating the public token.
+ * @param fn - The asynchronous function to be executed with the public token.
+ */
+declare function withPublicToken(options: CreatePublicTokenOptions, fn: () => Promise<void>): Promise<void>;
+export type CreateTriggerTokenOptions = {
+    /**
+     * The expiration time for the token. This can be a number representing the time in milliseconds, a `Date` object, or a string.
+     *
+     * @example
+     *
+     * ```typescript
+     * expirationTime: "1h"
+     * ```
+     */
+    expirationTime?: number | Date | string;
+    /**
+     * Whether the token can be used multiple times. By default trigger tokens are one-time use.
+     * @default false
+     */
+    multipleUse?: boolean;
+};
+/**
+ * Creates a one-time use token to trigger a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ * Create a one-time use public token that allows triggering a specific task:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+declare function createTriggerPublicToken(task: string | string[], options?: CreateTriggerTokenOptions): Promise<string>;
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+declare function withTriggerPublicToken(task: string | string[], options: CreateTriggerTokenOptions | undefined, fn: () => Promise<void>): Promise<void>;
+/**
+ * Creates a one-time use token to batch trigger a specific task or tasks.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+declare function createBatchTriggerPublicToken(task: string | string[], options?: CreateTriggerTokenOptions): Promise<string>;
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+declare function withBatchTriggerPublicToken(task: string | string[], options: CreateTriggerTokenOptions | undefined, fn: () => Promise<void>): Promise<void>;
 /**
  * Executes a provided asynchronous function with a specified API client configuration.
  *

package/dist/commonjs/v3/auth.js

@@ -27,7 +27,12 @@ function configure(options) {
 exports.auth = {
     configure,
     createPublicToken,
+    createTriggerPublicToken,
+    createBatchTriggerPublicToken,
     withAuth,
+    withPublicToken,
+    withTriggerPublicToken,
+    withBatchTriggerPublicToken,
 };
 /**
  * Creates a public token using the provided options.
@@ -62,6 +67,135 @@ async function createPublicToken(options) {
         expirationTime: options?.expirationTime,
     });
 }
+/**
+ * Executes a function with a public token, providing temporary access permissions.
+ *
+ * @param options - Options for creating the public token.
+ * @param fn - The asynchronous function to be executed with the public token.
+ */
+async function withPublicToken(options, fn) {
+    const token = await createPublicToken(options);
+    await withAuth({ accessToken: token }, fn);
+}
+/**
+ * Creates a one-time use token to trigger a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ * Create a one-time use public token that allows triggering a specific task:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+async function createTriggerPublicToken(task, options) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const claims = await apiClient.generateJWTClaims();
+    return await (0, v3_2.generateJWT)({
+        secretKey: apiClient.accessToken,
+        payload: {
+            ...claims,
+            otu: typeof options?.multipleUse === "boolean" ? !options.multipleUse : true,
+            scopes: flattenScopes({
+                trigger: {
+                    tasks: task,
+                },
+            }),
+        },
+        expirationTime: options?.expirationTime,
+    });
+}
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+async function withTriggerPublicToken(task, options = {}, fn) {
+    const token = await createTriggerPublicToken(task, options);
+    await withAuth({ accessToken: token }, fn);
+}
+/**
+ * Creates a one-time use token to batch trigger a specific task or tasks.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+async function createBatchTriggerPublicToken(task, options) {
+    const apiClient = v3_1.apiClientManager.clientOrThrow();
+    const claims = await apiClient.generateJWTClaims();
+    return await (0, v3_2.generateJWT)({
+        secretKey: apiClient.accessToken,
+        payload: {
+            ...claims,
+            otu: typeof options?.multipleUse === "boolean" ? !options.multipleUse : true,
+            scopes: flattenScopes({
+                batchTrigger: {
+                    tasks: task,
+                },
+            }),
+        },
+        expirationTime: options?.expirationTime,
+    });
+}
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+async function withBatchTriggerPublicToken(task, options = {}, fn) {
+    const token = await createBatchTriggerPublicToken(task, options);
+    await withAuth({ accessToken: token }, fn);
+}
 /**
  * Executes a provided asynchronous function with a specified API client configuration.
  *

package/dist/commonjs/v3/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/v3/auth.ts"],"names":[],"mappings":";;;AAoBA,8BAEC;AAtBD,6CAAqF;AACrF,6CAA2E;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,SAAS,CAAC,OAA+B;IACvD,qBAAgB,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAEY,QAAA,IAAI,GAAG;IAClB,SAAS;IACT,iBAAiB;IACjB,QAAQ;CACT,CAAC;AA0DF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAAkC;IACjE,MAAM,SAAS,GAAG,qBAAgB,CAAC,aAAa,EAAE,CAAC;IAEnD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAEnD,OAAO,MAAM,IAAA,gBAAoB,EAAC;QAChC,SAAS,EAAE,SAAS,CAAC,WAAW;QAChC,OAAO,EAAE;YACP,GAAG,MAAM;YACT,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;SACpE;QACD,cAAc,EAAE,OAAO,EAAE,cAAc;KACxC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,QAAQ,CACrB,MAA8B,EAC9B,EAAK;IAEL,OAAO,qBAAgB,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,aAAa,CAAC,WAAmC;IACxD,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,EAAE,CAAC;gBAClD,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC1C,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;4BACzB,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;wBAC7D,CAAC;oBACH,CAAC;yBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBACrC,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;oBAC9D,CAAC;yBAAM,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC;wBAC/C,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/v3/auth.ts"],"names":[],"mappings":"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"}

package/dist/commonjs/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = "3.3.1";
+exports.VERSION = "3.3.3";
 //# sourceMappingURL=version.js.map

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

@@ -20,9 +20,13 @@ export declare function configure(options: ApiClientConfiguration): void;
 export declare const auth: {
     configure: typeof configure;
     createPublicToken: typeof createPublicToken;
+    createTriggerPublicToken: typeof createTriggerPublicToken;
+    createBatchTriggerPublicToken: typeof createBatchTriggerPublicToken;
     withAuth: typeof withAuth;
+    withPublicToken: typeof withPublicToken;
+    withTriggerPublicToken: typeof withTriggerPublicToken;
+    withBatchTriggerPublicToken: typeof withBatchTriggerPublicToken;
 };
-type PublicTokenPermissionAction = "read" | "write";
 type PublicTokenPermissionProperties = {
     /**
      * Grant access to specific tasks
@@ -42,7 +46,23 @@ type PublicTokenPermissionProperties = {
     batch?: string | string[];
 };
 export type PublicTokenPermissions = {
-    [key in PublicTokenPermissionAction]?: PublicTokenPermissionProperties;
+    read?: PublicTokenPermissionProperties;
+    /**
+     * @deprecated use trigger instead
+     */
+    write?: PublicTokenPermissionProperties;
+    /**
+     * Use auth.createTriggerPublicToken
+     */
+    trigger?: {
+        tasks: string | string[];
+    };
+    /**
+     * Use auth.createBatchTriggerPublicToken
+     */
+    batchTrigger?: {
+        tasks: string | string[];
+    };
 };
 export type CreatePublicTokenOptions = {
     /**
@@ -92,6 +112,111 @@ export type CreatePublicTokenOptions = {
  * ```
  */
 declare function createPublicToken(options?: CreatePublicTokenOptions): Promise<string>;
+/**
+ * Executes a function with a public token, providing temporary access permissions.
+ *
+ * @param options - Options for creating the public token.
+ * @param fn - The asynchronous function to be executed with the public token.
+ */
+declare function withPublicToken(options: CreatePublicTokenOptions, fn: () => Promise<void>): Promise<void>;
+export type CreateTriggerTokenOptions = {
+    /**
+     * The expiration time for the token. This can be a number representing the time in milliseconds, a `Date` object, or a string.
+     *
+     * @example
+     *
+     * ```typescript
+     * expirationTime: "1h"
+     * ```
+     */
+    expirationTime?: number | Date | string;
+    /**
+     * Whether the token can be used multiple times. By default trigger tokens are one-time use.
+     * @default false
+     */
+    multipleUse?: boolean;
+};
+/**
+ * Creates a one-time use token to trigger a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ * Create a one-time use public token that allows triggering a specific task:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+declare function createTriggerPublicToken(task: string | string[], options?: CreateTriggerTokenOptions): Promise<string>;
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+declare function withTriggerPublicToken(task: string | string[], options: CreateTriggerTokenOptions | undefined, fn: () => Promise<void>): Promise<void>;
+/**
+ * Creates a one-time use token to batch trigger a specific task or tasks.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+declare function createBatchTriggerPublicToken(task: string | string[], options?: CreateTriggerTokenOptions): Promise<string>;
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+declare function withBatchTriggerPublicToken(task: string | string[], options: CreateTriggerTokenOptions | undefined, fn: () => Promise<void>): Promise<void>;
 /**
  * Executes a provided asynchronous function with a specified API client configuration.
  *

package/dist/esm/v3/auth.js

@@ -23,7 +23,12 @@ export function configure(options) {
 export const auth = {
     configure,
     createPublicToken,
+    createTriggerPublicToken,
+    createBatchTriggerPublicToken,
     withAuth,
+    withPublicToken,
+    withTriggerPublicToken,
+    withBatchTriggerPublicToken,
 };
 /**
  * Creates a public token using the provided options.
@@ -58,6 +63,135 @@ async function createPublicToken(options) {
         expirationTime: options?.expirationTime,
     });
 }
+/**
+ * Executes a function with a public token, providing temporary access permissions.
+ *
+ * @param options - Options for creating the public token.
+ * @param fn - The asynchronous function to be executed with the public token.
+ */
+async function withPublicToken(options, fn) {
+    const token = await createPublicToken(options);
+    await withAuth({ accessToken: token }, fn);
+}
+/**
+ * Creates a one-time use token to trigger a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ * Create a one-time use public token that allows triggering a specific task:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+async function createTriggerPublicToken(task, options) {
+    const apiClient = apiClientManager.clientOrThrow();
+    const claims = await apiClient.generateJWTClaims();
+    return await internal_generateJWT({
+        secretKey: apiClient.accessToken,
+        payload: {
+            ...claims,
+            otu: typeof options?.multipleUse === "boolean" ? !options.multipleUse : true,
+            scopes: flattenScopes({
+                trigger: {
+                    tasks: task,
+                },
+            }),
+        },
+        expirationTime: options?.expirationTime,
+    });
+}
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+async function withTriggerPublicToken(task, options = {}, fn) {
+    const token = await createTriggerPublicToken(task, options);
+    await withAuth({ accessToken: token }, fn);
+}
+/**
+ * Creates a one-time use token to batch trigger a specific task or tasks.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @returns A promise that resolves to a string representing the generated one-time use token.
+ *
+ * @example
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task");
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering multiple tasks:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken(["task1", "task2"]);
+ * ```
+ *
+ * @example You can also create a one-time use token that allows batch triggering a task with a specific expiration time:
+ *
+ * ```ts
+ * import { auth } from "@trigger.dev/sdk/v3";
+ *
+ * const token = await auth.createBatchTriggerPublicToken("my-task", { expirationTime: "1h" });
+ * ```
+ */
+async function createBatchTriggerPublicToken(task, options) {
+    const apiClient = apiClientManager.clientOrThrow();
+    const claims = await apiClient.generateJWTClaims();
+    return await internal_generateJWT({
+        secretKey: apiClient.accessToken,
+        payload: {
+            ...claims,
+            otu: typeof options?.multipleUse === "boolean" ? !options.multipleUse : true,
+            scopes: flattenScopes({
+                batchTrigger: {
+                    tasks: task,
+                },
+            }),
+        },
+        expirationTime: options?.expirationTime,
+    });
+}
+/**
+ * Executes a function with a one-time use token that allows triggering a specific task.
+ *
+ * @param task - The task ID or an array of task IDs that the token should allow triggering.
+ * @param options - Options for creating the one-time use token.
+ * @param fn - The asynchronous function to be executed with the one-time use token.
+ */
+async function withBatchTriggerPublicToken(task, options = {}, fn) {
+    const token = await createBatchTriggerPublicToken(task, options);
+    await withAuth({ accessToken: token }, fn);
+}
 /**
  * Executes a provided asynchronous function with a specified API client configuration.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/v3/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,WAAW,IAAI,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,SAAS,CAAC,OAA+B;IACvD,gBAAgB,CAAC,+BAA+B,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,SAAS;IACT,iBAAiB;IACjB,QAAQ;CACT,CAAC;AA0DF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,KAAK,UAAU,iBAAiB,CAAC,OAAkC;IACjE,MAAM,SAAS,GAAG,gBAAgB,CAAC,aAAa,EAAE,CAAC;IAEnD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAE,CAAC;IAEnD,OAAO,MAAM,oBAAoB,CAAC;QAChC,SAAS,EAAE,SAAS,CAAC,WAAW;QAChC,OAAO,EAAE;YACP,GAAG,MAAM;YACT,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;SACpE;QACD,cAAc,EAAE,OAAO,EAAE,cAAc;KACxC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,KAAK,UAAU,QAAQ,CACrB,MAA8B,EAC9B,EAAK;IAEL,OAAO,gBAAgB,CAAC,aAAa,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,aAAa,CAAC,WAAmC;IACxD,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAE1C,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC;YACf,IAAI,OAAO,UAAU,KAAK,SAAS,IAAI,UAAU,EAAE,CAAC;gBAClD,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpC,CAAC;iBAAM,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC1C,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;wBACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;4BACzB,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC,CAAC;wBAC7D,CAAC;oBACH,CAAC;yBAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;wBACrC,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC,CAAC;oBAC9D,CAAC;yBAAM,IAAI,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,EAAE,CAAC;wBAC/C,oBAAoB,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,QAAQ,EAAE,CAAC,CAAC;oBACrD,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,oBAAoB,CAAC;AAC9B,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../src/v3/auth.ts"],"names":[],"mappings":"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"}

package/dist/esm/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "3.3.1";
+export const VERSION = "3.3.3";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trigger.dev/sdk",
-  "version": "3.3.1",
+  "version": "3.3.3",
   "description": "trigger.dev Node.JS SDK",
   "license": "MIT",
   "publishConfig": {
@@ -40,7 +40,7 @@
     "@opentelemetry/api": "1.9.0",
     "@opentelemetry/api-logs": "0.52.1",
     "@opentelemetry/semantic-conventions": "1.25.1",
-    "@trigger.dev/core": "3.3.1",
+    "@trigger.dev/core": "3.3.3",
     "chalk": "^5.2.0",
     "cronstrue": "^2.21.0",
     "debug": "^4.3.4",