@trigger.dev/react-hooks 0.0.0-chat-prerelease-20260401205942

package/dist/commonjs/hooks/useTaskTrigger.d.ts

@@ -0,0 +1,107 @@
+import { type AnyTask, type TaskIdentifier, type TaskPayload, InferRunTypes, RunHandleFromTypes, type TriggerOptions, type RealtimeRunSkipColumns } from "@trigger.dev/core/v3";
+import { UseApiClientOptions } from "./useApiClient.js";
+import { UseRealtimeRunInstance, UseRealtimeRunWithStreamsInstance } from "./useRealtime.js";
+/**
+ * Base interface for task trigger instances.
+ *
+ * @template TTask - The type of the task
+ */
+export interface TriggerInstance<TTask extends AnyTask> {
+    /** Function to submit the task with a payload */
+    submit: (payload: TaskPayload<TTask>, options?: TriggerOptions) => void;
+    /** Whether the task is currently being submitted */
+    isLoading: boolean;
+    /** The handle returned after successful task submission */
+    handle?: RunHandleFromTypes<InferRunTypes<TTask>>;
+    /** Any error that occurred during submission */
+    error?: Error;
+}
+export type UseTaskTriggerOptions = UseApiClientOptions;
+/**
+ * Hook to trigger a task and manage its initial execution state.
+ *
+ * @template TTask - The type of the task
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
+ * @param {UseTaskTriggerOptions} [options] - Configuration options for the task trigger
+ * @returns {TriggerInstance<TTask>} An object containing the submit function, loading state, handle, and any errors
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { submit, isLoading, handle, error } = useTaskTrigger<typeof myTask>('my-task-id');
+ *
+ * // Submit the task with payload
+ * submit({ foo: 'bar' });
+ * ```
+ */
+export declare function useTaskTrigger<TTask extends AnyTask>(id: TaskIdentifier<TTask>, options?: UseTaskTriggerOptions): TriggerInstance<TTask>;
+/**
+ * Configuration options for task triggers with realtime updates.
+ */
+export type UseRealtimeTaskTriggerOptions = UseTaskTriggerOptions & {
+    /** Whether the realtime subscription is enabled */
+    enabled?: boolean;
+    /** Optional throttle time in milliseconds for stream updates */
+    experimental_throttleInMs?: number;
+    /**
+     * Skip columns from the subscription.
+     *
+     * @default []
+     */
+    skipColumns?: RealtimeRunSkipColumns;
+};
+export type RealtimeTriggerInstanceWithStreams<TTask extends AnyTask, TStreams extends Record<string, any> = Record<string, any>> = UseRealtimeRunWithStreamsInstance<TTask, TStreams> & {
+    submit: (payload: TaskPayload<TTask>, options?: TriggerOptions) => void;
+    isLoading: boolean;
+    handle?: RunHandleFromTypes<InferRunTypes<TTask>>;
+};
+/**
+ * Hook to trigger a task and subscribe to its realtime updates including stream data.
+ *
+ * @template TTask - The type of the task
+ * @template TStreams - The type of the streams data
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
+ * @returns {RealtimeTriggerInstanceWithStreams<TTask, TStreams>} An object containing the submit function, loading state,
+ *          handle, run state, streams data, and error handling
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { submit, run, streams, error } = useRealtimeTaskTriggerWithStreams<
+ *   typeof myTask,
+ *   { output: string }
+ * >('my-task-id');
+ *
+ * // Submit and monitor the task with streams
+ * submit({ foo: 'bar' });
+ * ```
+ */
+export declare function useRealtimeTaskTriggerWithStreams<TTask extends AnyTask, TStreams extends Record<string, any> = Record<string, any>>(id: TaskIdentifier<TTask>, options?: UseRealtimeTaskTriggerOptions): RealtimeTriggerInstanceWithStreams<TTask, TStreams>;
+export type RealtimeTriggerInstance<TTask extends AnyTask> = UseRealtimeRunInstance<TTask> & {
+    submit: (payload: TaskPayload<TTask>, options?: TriggerOptions) => void;
+    isLoading: boolean;
+    handle?: RunHandleFromTypes<InferRunTypes<TTask>>;
+};
+/**
+ * Hook to trigger a task and subscribe to its realtime updates.
+ *
+ * @template TTask - The type of the task
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
+ * @returns {RealtimeTriggerInstance<TTask>} An object containing the submit function, loading state,
+ *          handle, run state, and error handling
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { submit, run, error, stop } = useRealtimeTaskTrigger<typeof myTask>('my-task-id');
+ *
+ * // Submit and monitor the task
+ * submit({ foo: 'bar' });
+ *
+ * // Stop monitoring when needed
+ * stop();
+ * ```
+ */
+export declare function useRealtimeTaskTrigger<TTask extends AnyTask>(id: TaskIdentifier<TTask>, options?: UseRealtimeTaskTriggerOptions): RealtimeTriggerInstance<TTask>;

package/dist/commonjs/hooks/useTaskTrigger.js

@@ -0,0 +1,138 @@
+"use client";
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useTaskTrigger = useTaskTrigger;
+exports.useRealtimeTaskTriggerWithStreams = useRealtimeTaskTriggerWithStreams;
+exports.useRealtimeTaskTrigger = useRealtimeTaskTrigger;
+const v3_1 = require("@trigger.dev/core/v3");
+const mutation_1 = __importDefault(require("swr/mutation"));
+const useApiClient_js_1 = require("./useApiClient.js");
+const useRealtime_js_1 = require("./useRealtime.js");
+/**
+ * Hook to trigger a task and manage its initial execution state.
+ *
+ * @template TTask - The type of the task
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
+ * @param {UseTaskTriggerOptions} [options] - Configuration options for the task trigger
+ * @returns {TriggerInstance<TTask>} An object containing the submit function, loading state, handle, and any errors
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { submit, isLoading, handle, error } = useTaskTrigger<typeof myTask>('my-task-id');
+ *
+ * // Submit the task with payload
+ * submit({ foo: 'bar' });
+ * ```
+ */
+function useTaskTrigger(id, options) {
+    const apiClient = (0, useApiClient_js_1.useApiClient)(options);
+    async function triggerTask(id, { arg: { payload, options }, }) {
+        if (!apiClient) {
+            throw new Error("Could not trigger task in useTaskTrigger: Missing access token");
+        }
+        const payloadPacket = await (0, v3_1.stringifyIO)(payload);
+        const handle = await apiClient.triggerTask(id, {
+            payload: payloadPacket.data,
+            options: {
+                queue: options?.queue ? { name: options.queue } : undefined,
+                concurrencyKey: options?.concurrencyKey,
+                payloadType: payloadPacket.dataType,
+                idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
+                delay: options?.delay,
+                ttl: options?.ttl,
+                tags: options?.tags,
+                maxAttempts: options?.maxAttempts,
+                metadata: options?.metadata,
+                maxDuration: options?.maxDuration,
+                lockToVersion: options?.version,
+            },
+        });
+        return { ...handle, taskIdentifier: id };
+    }
+    const mutation = (0, mutation_1.default)(id, triggerTask);
+    return {
+        submit: (payload, options) => {
+            // trigger the task with the given payload
+            mutation.trigger({ payload, options });
+        },
+        isLoading: mutation.isMutating,
+        handle: mutation.data,
+        error: mutation.error,
+    };
+}
+/**
+ * Hook to trigger a task and subscribe to its realtime updates including stream data.
+ *
+ * @template TTask - The type of the task
+ * @template TStreams - The type of the streams data
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
+ * @returns {RealtimeTriggerInstanceWithStreams<TTask, TStreams>} An object containing the submit function, loading state,
+ *          handle, run state, streams data, and error handling
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { submit, run, streams, error } = useRealtimeTaskTriggerWithStreams<
+ *   typeof myTask,
+ *   { output: string }
+ * >('my-task-id');
+ *
+ * // Submit and monitor the task with streams
+ * submit({ foo: 'bar' });
+ * ```
+ */
+function useRealtimeTaskTriggerWithStreams(id, options) {
+    const triggerInstance = useTaskTrigger(id, options);
+    const realtimeInstance = (0, useRealtime_js_1.useRealtimeRunWithStreams)(triggerInstance.handle?.id, {
+        ...options,
+        id: triggerInstance.handle?.id,
+        accessToken: triggerInstance.handle?.publicAccessToken ?? options?.accessToken,
+    });
+    return {
+        ...realtimeInstance,
+        ...triggerInstance,
+    };
+}
+/**
+ * Hook to trigger a task and subscribe to its realtime updates.
+ *
+ * @template TTask - The type of the task
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
+ * @returns {RealtimeTriggerInstance<TTask>} An object containing the submit function, loading state,
+ *          handle, run state, and error handling
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { submit, run, error, stop } = useRealtimeTaskTrigger<typeof myTask>('my-task-id');
+ *
+ * // Submit and monitor the task
+ * submit({ foo: 'bar' });
+ *
+ * // Stop monitoring when needed
+ * stop();
+ * ```
+ */
+function useRealtimeTaskTrigger(id, options) {
+    const triggerInstance = useTaskTrigger(id, options);
+    const realtimeInstance = (0, useRealtime_js_1.useRealtimeRun)(triggerInstance.handle?.id, {
+        ...options,
+        id: triggerInstance.handle?.id,
+        accessToken: triggerInstance.handle?.publicAccessToken ?? options?.accessToken,
+    });
+    return {
+        submit: triggerInstance.submit,
+        isLoading: triggerInstance.isLoading,
+        handle: triggerInstance.handle,
+        run: realtimeInstance.run,
+        error: realtimeInstance.error ?? triggerInstance.error,
+        stop: realtimeInstance.stop,
+    };
+}
+//# sourceMappingURL=useTaskTrigger.js.map

package/dist/commonjs/hooks/useTaskTrigger.js.map

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

package/dist/commonjs/hooks/useWaitToken.d.ts

@@ -0,0 +1,35 @@
+import { UseApiClientOptions } from "./useApiClient.js";
+/**
+ * Base interface for task trigger instances.
+ *
+ * @template TOutput - The type of the output
+ */
+export interface WaitTokenInstance<TOutput> {
+    /** Function to complete the waitpoint with an output */
+    complete: (output: TOutput) => void;
+    /** Whether the waitpoint is currently being completed */
+    isLoading: boolean;
+    /** Whether the waitpoint has been completed */
+    isCompleted: boolean;
+    /** Any error that occurred during completion */
+    error?: Error;
+    /** Whether the waitpoint is ready to be completed */
+    isReady: boolean;
+}
+/**
+ * Hook to complete a waitpoint and manage its completion state.
+ *
+ * @template TOutput - The type of the output
+ * @param {string} waitpointId - The identifier of the waitpoint to complete
+ * @returns {WaitTokenInstance<TOutput>} An object containing the complete function, loading state, isCompleted, and any errors
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { complete, isLoading, isCompleted, error } = useWaitToken('waitpoint-id');
+ *
+ * // Complete the waitpoint with an output
+ * complete({ foo: 'bar' });
+ * ```
+ */
+export declare function useWaitToken<TOutput>(waitpointId?: string, options?: UseApiClientOptions): WaitTokenInstance<TOutput>;

package/dist/commonjs/hooks/useWaitToken.js

@@ -0,0 +1,52 @@
+"use client";
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useWaitToken = useWaitToken;
+const mutation_1 = __importDefault(require("swr/mutation"));
+const useApiClient_js_1 = require("./useApiClient.js");
+/**
+ * Hook to complete a waitpoint and manage its completion state.
+ *
+ * @template TOutput - The type of the output
+ * @param {string} waitpointId - The identifier of the waitpoint to complete
+ * @returns {WaitTokenInstance<TOutput>} An object containing the complete function, loading state, isCompleted, and any errors
+ *
+ * @example
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { complete, isLoading, isCompleted, error } = useWaitToken('waitpoint-id');
+ *
+ * // Complete the waitpoint with an output
+ * complete({ foo: 'bar' });
+ * ```
+ */
+function useWaitToken(waitpointId, options) {
+    const apiClient = (0, useApiClient_js_1.useApiClient)(options);
+    async function completeWaitpoint(id, { arg: { output } }) {
+        if (!apiClient) {
+            throw new Error("Could not complete waitpoint in useWaitToken: Missing access token");
+        }
+        if (!waitpointId) {
+            throw new Error("Could not complete waitpoint in useWaitToken: Missing waitpoint ID");
+        }
+        const result = await apiClient.completeWaitpointToken(waitpointId, {
+            data: output,
+        });
+        return result;
+    }
+    const mutation = (0, mutation_1.default)(waitpointId, completeWaitpoint);
+    return {
+        complete: (output) => {
+            // trigger the task with the given payload
+            mutation.trigger({ output });
+        },
+        isLoading: mutation.isMutating,
+        isCompleted: !!mutation.data?.success,
+        isReady: !!waitpointId,
+        error: mutation.error,
+    };
+}
+//# sourceMappingURL=useWaitToken.js.map

package/dist/commonjs/hooks/useWaitToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWaitToken.js","sourceRoot":"","sources":["../../../src/hooks/useWaitToken.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;AAuCb,oCAkCC;AAvED,4DAA0C;AAC1C,uDAAsE;AAoBtE;;;;;;;;;;;;;;;GAeG;AACH,SAAgB,YAAY,CAC1B,WAAoB,EACpB,OAA6B;IAE7B,MAAM,SAAS,GAAG,IAAA,8BAAY,EAAC,OAAO,CAAC,CAAC;IAExC,KAAK,UAAU,iBAAiB,CAAC,EAAU,EAAE,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,EAAgC;QAC5F,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QAED,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;QACxF,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,sBAAsB,CAAC,WAAW,EAAE;YACjE,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,QAAQ,GAAG,IAAA,kBAAc,EAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IAEhE,OAAO;QACL,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YACnB,0CAA0C;YAC1C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,SAAS,EAAE,QAAQ,CAAC,UAAU;QAC9B,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO;QACrC,OAAO,EAAE,CAAC,CAAC,WAAW;QACtB,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC;AACJ,CAAC"}

package/dist/commonjs/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./contexts.js";
+export * from "./hooks/useApiClient.js";
+export * from "./hooks/useRun.js";
+export * from "./hooks/useRealtime.js";
+export * from "./hooks/useTaskTrigger.js";
+export * from "./hooks/useWaitToken.js";
+export * from "./hooks/useInputStreamSend.js";

package/dist/commonjs/index.js

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

package/dist/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,0DAAwC;AACxC,oDAAkC;AAClC,yDAAuC;AACvC,4DAA0C;AAC1C,0DAAwC;AACxC,gEAA8C"}

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/commonjs/utils/createContextAndHook.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+export declare function assertContextExists(contextVal: unknown, msgOrCtx: string | React.Context<any>): asserts contextVal;
+type Options = {
+    assertCtxFn?: (v: unknown, msg: string) => void;
+};
+type ContextOf<T> = React.Context<T | undefined>;
+type UseCtxFn<T> = () => T;
+/**
+ * Creates and returns a Context and two hooks that return the context value.
+ * The Context type is derived from the type passed in by the user.
+ * The first hook returned guarantees that the context exists so the returned value is always CtxValue
+ * The second hook makes no guarantees, so the returned value can be CtxValue | undefined
+ */
+export declare const createContextAndHook: <CtxVal>(displayName: string, options?: Options) => [ContextOf<CtxVal>, UseCtxFn<CtxVal>, UseCtxFn<CtxVal | Partial<CtxVal>>];
+export {};

package/dist/commonjs/utils/createContextAndHook.js

@@ -0,0 +1,39 @@
+"use client";
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContextAndHook = void 0;
+exports.assertContextExists = assertContextExists;
+const react_1 = __importDefault(require("react"));
+function assertContextExists(contextVal, msgOrCtx) {
+    if (!contextVal) {
+        throw typeof msgOrCtx === "string"
+            ? new Error(msgOrCtx)
+            : new Error(`${msgOrCtx.displayName} not found`);
+    }
+}
+/**
+ * Creates and returns a Context and two hooks that return the context value.
+ * The Context type is derived from the type passed in by the user.
+ * The first hook returned guarantees that the context exists so the returned value is always CtxValue
+ * The second hook makes no guarantees, so the returned value can be CtxValue | undefined
+ */
+const createContextAndHook = (displayName, options) => {
+    const { assertCtxFn = assertContextExists } = options || {};
+    const Ctx = react_1.default.createContext(undefined);
+    Ctx.displayName = displayName;
+    const useCtx = () => {
+        const ctx = react_1.default.useContext(Ctx);
+        assertCtxFn(ctx, `${displayName} not found`);
+        return ctx;
+    };
+    const useCtxWithoutGuarantee = () => {
+        const ctx = react_1.default.useContext(Ctx);
+        return ctx ? ctx : {};
+    };
+    return [Ctx, useCtx, useCtxWithoutGuarantee];
+};
+exports.createContextAndHook = createContextAndHook;
+//# sourceMappingURL=createContextAndHook.js.map

package/dist/commonjs/utils/createContextAndHook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createContextAndHook.js","sourceRoot":"","sources":["../../../src/utils/createContextAndHook.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;AAGb,kDASC;AAXD,kDAA0B;AAE1B,SAAgB,mBAAmB,CACjC,UAAmB,EACnB,QAAqC;IAErC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,OAAO,QAAQ,KAAK,QAAQ;YAChC,CAAC,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC;YACrB,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,QAAQ,CAAC,WAAW,YAAY,CAAC,CAAC;IACrD,CAAC;AACH,CAAC;AAMD;;;;;GAKG;AACI,MAAM,oBAAoB,GAAG,CAClC,WAAmB,EACnB,OAAiB,EAC0D,EAAE;IAC7E,MAAM,EAAE,WAAW,GAAG,mBAAmB,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC5D,MAAM,GAAG,GAAG,eAAK,CAAC,aAAa,CAAqB,SAAS,CAAC,CAAC;IAC/D,GAAG,CAAC,WAAW,GAAG,WAAW,CAAC;IAE9B,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,MAAM,GAAG,GAAG,eAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClC,WAAW,CAAC,GAAG,EAAE,GAAG,WAAW,YAAY,CAAC,CAAC;QAC7C,OAAO,GAAa,CAAC;IACvB,CAAC,CAAC;IAEF,MAAM,sBAAsB,GAAG,GAAG,EAAE;QAClC,MAAM,GAAG,GAAG,eAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACxB,CAAC,CAAC;IAEF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,sBAAsB,CAAC,CAAC;AAC/C,CAAC,CAAC;AApBW,QAAA,oBAAoB,wBAoB/B"}

package/dist/commonjs/utils/throttle.d.ts

@@ -0,0 +1,6 @@
+export type ThrottledQueue<T> = {
+    add: (item: T) => void;
+    flush: () => Promise<void>;
+    isEmpty: () => boolean;
+};
+export declare function createThrottledQueue<T>(onFlush: (items: T[]) => Promise<void>, throttleInMs?: number): ThrottledQueue<T>;

package/dist/commonjs/utils/throttle.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createThrottledQueue = createThrottledQueue;
+function createThrottledQueue(onFlush, throttleInMs) {
+    let queue = [];
+    let lastFlushTime = 0;
+    let flushPromise = null;
+    const scheduleFlush = async () => {
+        // If no throttle specified or there's already a flush in progress, return
+        if (!throttleInMs) {
+            // Immediately flush when no throttling is specified
+            const itemsToFlush = [...queue];
+            queue = [];
+            await onFlush(itemsToFlush);
+            return;
+        }
+        if (queue.length === 0 || flushPromise)
+            return;
+        const now = Date.now();
+        const timeUntilNextFlush = Math.max(0, lastFlushTime + throttleInMs - now);
+        if (timeUntilNextFlush === 0) {
+            const itemsToFlush = [...queue];
+            queue = [];
+            lastFlushTime = now;
+            flushPromise = onFlush(itemsToFlush).finally(() => {
+                flushPromise = null;
+                // Check if more items accumulated during flush
+                scheduleFlush();
+            });
+        }
+        else {
+            setTimeout(scheduleFlush, timeUntilNextFlush);
+        }
+    };
+    return {
+        add: (item) => {
+            queue.push(item);
+            scheduleFlush();
+        },
+        flush: async () => {
+            if (queue.length === 0)
+                return;
+            const itemsToFlush = [...queue];
+            queue = [];
+            await onFlush(itemsToFlush);
+        },
+        isEmpty: () => queue.length === 0,
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/dist/commonjs/utils/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/utils/throttle.ts"],"names":[],"mappings":";;AAOA,oDAkDC;AAlDD,SAAgB,oBAAoB,CAClC,OAAsC,EACtC,YAAqB;IAErB,IAAI,KAAK,GAAQ,EAAE,CAAC;IACpB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,YAAY,GAAyB,IAAI,CAAC;IAE9C,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE;QAC/B,0EAA0E;QAC1E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,oDAAoD;YACpD,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;YAChC,KAAK,GAAG,EAAE,CAAC;YACX,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,YAAY;YAAE,OAAO;QAE/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,YAAY,GAAG,GAAG,CAAC,CAAC;QAE3E,IAAI,kBAAkB,KAAK,CAAC,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;YAChC,KAAK,GAAG,EAAE,CAAC;YACX,aAAa,GAAG,GAAG,CAAC;YACpB,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE;gBAChD,YAAY,GAAG,IAAI,CAAC;gBACpB,+CAA+C;gBAC/C,aAAa,EAAE,CAAC;YAClB,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACL,GAAG,EAAE,CAAC,IAAO,EAAE,EAAE;YACf,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,aAAa,EAAE,CAAC;QAClB,CAAC;QACD,KAAK,EAAE,KAAK,IAAI,EAAE;YAChB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO;YAC/B,MAAM,YAAY,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;YAChC,KAAK,GAAG,EAAE,CAAC;YACX,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC;QAC9B,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/commonjs/utils/trigger-swr.d.ts

@@ -0,0 +1,19 @@
+import { ApiRequestOptions } from "@trigger.dev/core/v3";
+export * from "swr";
+export { default as useSWR, SWRConfig } from "swr";
+export type CommonTriggerHookOptions = {
+    /**
+     * Poll for updates at the specified interval (in milliseconds). Polling is not recommended for most use-cases. Use the Realtime hooks instead.
+     */
+    refreshInterval?: number;
+    /** Revalidate the data when the browser regains a network connection. */
+    revalidateOnReconnect?: boolean;
+    /** Revalidate the data when the window regains focus. */
+    revalidateOnFocus?: boolean;
+    /** Optional access token for authentication */
+    accessToken?: string;
+    /** Optional base URL for the API endpoints */
+    baseURL?: string;
+    /** Optional additional request configuration */
+    requestOptions?: ApiRequestOptions;
+};

package/dist/commonjs/utils/trigger-swr.js

@@ -0,0 +1,28 @@
+"use client";
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SWRConfig = exports.useSWR = void 0;
+// eslint-disable-next-line import/export
+__exportStar(require("swr"), exports);
+// eslint-disable-next-line import/export
+var swr_1 = require("swr");
+Object.defineProperty(exports, "useSWR", { enumerable: true, get: function () { return __importDefault(swr_1).default; } });
+Object.defineProperty(exports, "SWRConfig", { enumerable: true, get: function () { return swr_1.SWRConfig; } });
+//# sourceMappingURL=trigger-swr.js.map

package/dist/commonjs/utils/trigger-swr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-swr.js","sourceRoot":"","sources":["../../../src/utils/trigger-swr.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;;;;;;;;;;;;;;;;;;;;;AAIb,yCAAyC;AACzC,sCAAoB;AACpB,yCAAyC;AACzC,2BAAmD;AAA1C,8GAAA,OAAO,OAAU;AAAE,gGAAA,SAAS,OAAA"}

package/dist/esm/contexts.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import type { ApiClientConfiguration } from "@trigger.dev/core/v3";
+declare const TriggerAuthContext: React.Context<ApiClientConfiguration | undefined>, useTriggerAuthContext: () => ApiClientConfiguration, useTriggerAuthContextOptional: () => ApiClientConfiguration | Partial<ApiClientConfiguration>;
+export { TriggerAuthContext, useTriggerAuthContext, useTriggerAuthContextOptional };

package/dist/esm/contexts.js

@@ -0,0 +1,5 @@
+"use client";
+import { createContextAndHook } from "./utils/createContextAndHook.js";
+const [TriggerAuthContext, useTriggerAuthContext, useTriggerAuthContextOptional] = createContextAndHook("TriggerAuthContext");
+export { TriggerAuthContext, useTriggerAuthContext, useTriggerAuthContextOptional };
+//# sourceMappingURL=contexts.js.map

package/dist/esm/contexts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contexts.js","sourceRoot":"","sources":["../../src/contexts.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAGb,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAGvE,MAAM,CAAC,kBAAkB,EAAE,qBAAqB,EAAE,6BAA6B,CAAC,GAC9E,oBAAoB,CAAyB,oBAAoB,CAAC,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,CAAC"}

package/dist/esm/hooks/useApiClient.d.ts

@@ -0,0 +1,41 @@
+import { ApiClient, ApiRequestOptions } from "@trigger.dev/core/v3";
+/**
+ * Configuration options for creating an API client instance.
+ */
+export type UseApiClientOptions = {
+    /** Optional access token for authentication */
+    accessToken?: string;
+    /** Optional base URL for the API endpoints */
+    baseURL?: string;
+    /** Optional preview branch name for preview environments */
+    previewBranch?: string;
+    /** Optional additional request configuration */
+    requestOptions?: ApiRequestOptions;
+    /**
+     * Enable or disable the API client instance.
+     *
+     * Set enabled to false if you don't have an accessToken and don't want to throw an error.
+     */
+    enabled?: boolean;
+};
+/**
+ * Hook to create an API client instance using authentication context or provided options.
+ *
+ * @param {UseApiClientOptions} [options] - Configuration options for the API client
+ * @returns {ApiClient} An initialized API client instance
+ * @throws {Error} When no access token is available in either context or options
+ *
+ * @example
+ * ```ts
+ * // Using context authentication
+ * const apiClient = useApiClient();
+ *
+ * // Using custom options
+ * const apiClient = useApiClient({
+ *   accessToken: "your-access-token",
+ *   baseURL: "https://api.my-trigger.com",
+ *   requestOptions: { retry: { maxAttempts: 10 } }
+ * });
+ * ```
+ */
+export declare function useApiClient(options?: UseApiClientOptions): ApiClient | undefined;