@trigger.dev/react-hooks 0.0.0-bun-runtimes-20260909131057

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (89) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +1 -0
  3. package/dist/commonjs/contexts.d.ts +4 -0
  4. package/dist/commonjs/contexts.js +10 -0
  5. package/dist/commonjs/contexts.js.map +1 -0
  6. package/dist/commonjs/hooks/useApiClient.d.ts +47 -0
  7. package/dist/commonjs/hooks/useApiClient.js +57 -0
  8. package/dist/commonjs/hooks/useApiClient.js.map +1 -0
  9. package/dist/commonjs/hooks/useInputStreamSend.d.ts +26 -0
  10. package/dist/commonjs/hooks/useInputStreamSend.js +45 -0
  11. package/dist/commonjs/hooks/useInputStreamSend.js.map +1 -0
  12. package/dist/commonjs/hooks/useRealtime.d.ts +336 -0
  13. package/dist/commonjs/hooks/useRealtime.js +642 -0
  14. package/dist/commonjs/hooks/useRealtime.js.map +1 -0
  15. package/dist/commonjs/hooks/useRun.d.ts +22 -0
  16. package/dist/commonjs/hooks/useRun.js +40 -0
  17. package/dist/commonjs/hooks/useRun.js.map +1 -0
  18. package/dist/commonjs/hooks/useSessionStream.d.ts +131 -0
  19. package/dist/commonjs/hooks/useSessionStream.js +236 -0
  20. package/dist/commonjs/hooks/useSessionStream.js.map +1 -0
  21. package/dist/commonjs/hooks/useSessionStreamChannel.d.ts +86 -0
  22. package/dist/commonjs/hooks/useSessionStreamChannel.js +209 -0
  23. package/dist/commonjs/hooks/useSessionStreamChannel.js.map +1 -0
  24. package/dist/commonjs/hooks/useTaskTrigger.d.ts +107 -0
  25. package/dist/commonjs/hooks/useTaskTrigger.js +139 -0
  26. package/dist/commonjs/hooks/useTaskTrigger.js.map +1 -0
  27. package/dist/commonjs/hooks/useWaitToken.d.ts +35 -0
  28. package/dist/commonjs/hooks/useWaitToken.js +52 -0
  29. package/dist/commonjs/hooks/useWaitToken.js.map +1 -0
  30. package/dist/commonjs/index.d.ts +9 -0
  31. package/dist/commonjs/index.js +26 -0
  32. package/dist/commonjs/index.js.map +1 -0
  33. package/dist/commonjs/package.json +3 -0
  34. package/dist/commonjs/utils/createContextAndHook.d.ts +14 -0
  35. package/dist/commonjs/utils/createContextAndHook.js +38 -0
  36. package/dist/commonjs/utils/createContextAndHook.js.map +1 -0
  37. package/dist/commonjs/utils/throttle.d.ts +6 -0
  38. package/dist/commonjs/utils/throttle.js +50 -0
  39. package/dist/commonjs/utils/throttle.js.map +1 -0
  40. package/dist/commonjs/utils/trigger-swr.d.ts +19 -0
  41. package/dist/commonjs/utils/trigger-swr.js +27 -0
  42. package/dist/commonjs/utils/trigger-swr.js.map +1 -0
  43. package/dist/commonjs/utils/useStableRequestCallback.d.ts +5 -0
  44. package/dist/commonjs/utils/useStableRequestCallback.js +17 -0
  45. package/dist/commonjs/utils/useStableRequestCallback.js.map +1 -0
  46. package/dist/esm/contexts.d.ts +4 -0
  47. package/dist/esm/contexts.js +5 -0
  48. package/dist/esm/contexts.js.map +1 -0
  49. package/dist/esm/hooks/useApiClient.d.ts +47 -0
  50. package/dist/esm/hooks/useApiClient.js +54 -0
  51. package/dist/esm/hooks/useApiClient.js.map +1 -0
  52. package/dist/esm/hooks/useInputStreamSend.d.ts +26 -0
  53. package/dist/esm/hooks/useInputStreamSend.js +39 -0
  54. package/dist/esm/hooks/useInputStreamSend.js.map +1 -0
  55. package/dist/esm/hooks/useRealtime.d.ts +336 -0
  56. package/dist/esm/hooks/useRealtime.js +635 -0
  57. package/dist/esm/hooks/useRealtime.js.map +1 -0
  58. package/dist/esm/hooks/useRun.d.ts +22 -0
  59. package/dist/esm/hooks/useRun.js +37 -0
  60. package/dist/esm/hooks/useRun.js.map +1 -0
  61. package/dist/esm/hooks/useSessionStream.d.ts +131 -0
  62. package/dist/esm/hooks/useSessionStream.js +233 -0
  63. package/dist/esm/hooks/useSessionStream.js.map +1 -0
  64. package/dist/esm/hooks/useSessionStreamChannel.d.ts +86 -0
  65. package/dist/esm/hooks/useSessionStreamChannel.js +206 -0
  66. package/dist/esm/hooks/useSessionStreamChannel.js.map +1 -0
  67. package/dist/esm/hooks/useTaskTrigger.d.ts +107 -0
  68. package/dist/esm/hooks/useTaskTrigger.js +131 -0
  69. package/dist/esm/hooks/useTaskTrigger.js.map +1 -0
  70. package/dist/esm/hooks/useWaitToken.d.ts +35 -0
  71. package/dist/esm/hooks/useWaitToken.js +46 -0
  72. package/dist/esm/hooks/useWaitToken.js.map +1 -0
  73. package/dist/esm/index.d.ts +9 -0
  74. package/dist/esm/index.js +10 -0
  75. package/dist/esm/index.js.map +1 -0
  76. package/dist/esm/package.json +3 -0
  77. package/dist/esm/utils/createContextAndHook.d.ts +14 -0
  78. package/dist/esm/utils/createContextAndHook.js +31 -0
  79. package/dist/esm/utils/createContextAndHook.js.map +1 -0
  80. package/dist/esm/utils/throttle.d.ts +6 -0
  81. package/dist/esm/utils/throttle.js +47 -0
  82. package/dist/esm/utils/throttle.js.map +1 -0
  83. package/dist/esm/utils/trigger-swr.d.ts +19 -0
  84. package/dist/esm/utils/trigger-swr.js +6 -0
  85. package/dist/esm/utils/trigger-swr.js.map +1 -0
  86. package/dist/esm/utils/useStableRequestCallback.d.ts +5 -0
  87. package/dist/esm/utils/useStableRequestCallback.js +14 -0
  88. package/dist/esm/utils/useStableRequestCallback.js.map +1 -0
  89. package/package.json +75 -0
@@ -0,0 +1,209 @@
1
+ "use strict";
2
+ "use client";
3
+ Object.defineProperty(exports, "__esModule", { value: true });
4
+ exports.useSessionStreamChannel = useSessionStreamChannel;
5
+ const react_1 = require("react");
6
+ const throttle_js_1 = require("../utils/throttle.js");
7
+ const trigger_swr_js_1 = require("../utils/trigger-swr.js");
8
+ const useStableRequestCallback_js_1 = require("../utils/useStableRequestCallback.js");
9
+ const useApiClient_js_1 = require("./useApiClient.js");
10
+ /**
11
+ * Read one side of a named Session side channel, with record types inferred
12
+ * from a `defineSessionChannel` declaration passed as the type argument.
13
+ *
14
+ * The channel name is typesafe (`SessionChannelName<TChannel>`) and `records`
15
+ * is typed from the channel's `.out` / `.in` record type. Called without the
16
+ * type argument, the channel name is any string and `records` is `unknown`.
17
+ *
18
+ * Requires a Public Access Token scoped to the session (or to the channel).
19
+ *
20
+ * @example
21
+ * ```tsx
22
+ * import type { screenshotsChannel } from "./shared/channels";
23
+ *
24
+ * const { records } = useSessionStreamChannel<typeof screenshotsChannel>("screenshots", {
25
+ * sessionId,
26
+ * accessToken,
27
+ * io: "out",
28
+ * from: "latest",
29
+ * maxRecords: 1,
30
+ * });
31
+ * ```
32
+ */
33
+ function useSessionStreamChannel(channel, options) {
34
+ const hookId = (0, react_1.useId)();
35
+ const idKey = options.id ?? hookId;
36
+ const io = (options.io ?? "out");
37
+ const sessionId = options.sessionId;
38
+ const channelName = channel;
39
+ const [initialRecordsFallback] = (0, react_1.useState)([]);
40
+ const { data: records, mutate: mutateRecords } = (0, trigger_swr_js_1.useSWR)([idKey, sessionId, channelName, io, "records"], null, { fallbackData: initialRecordsFallback });
41
+ const recordsRef = (0, react_1.useRef)(records ?? []);
42
+ (0, react_1.useEffect)(() => {
43
+ recordsRef.current = records || [];
44
+ }, [records]);
45
+ const { data: lastEventId = undefined, mutate: setLastEventId } = (0, trigger_swr_js_1.useSWR)([idKey, sessionId, channelName, io, "lastEventId"], null);
46
+ const lastEventIdRef = (0, react_1.useRef)(lastEventId);
47
+ const channelIdentityRef = (0, react_1.useRef)(`${idKey}:${sessionId}:${channelName}:${io}`);
48
+ (0, react_1.useEffect)(() => {
49
+ const identity = `${idKey}:${sessionId}:${channelName}:${io}`;
50
+ if (channelIdentityRef.current !== identity) {
51
+ channelIdentityRef.current = identity;
52
+ lastEventIdRef.current = lastEventId;
53
+ }
54
+ }, [idKey, sessionId, channelName, io, lastEventId]);
55
+ const { data: lastControl = undefined, mutate: setLastControl } = (0, trigger_swr_js_1.useSWR)([idKey, sessionId, channelName, io, "lastControl"], null);
56
+ const { data: _isComplete = false, mutate: setIsComplete } = (0, trigger_swr_js_1.useSWR)([idKey, sessionId, channelName, io, "complete"], null);
57
+ const { data: error = undefined, mutate: setError } = (0, trigger_swr_js_1.useSWR)([idKey, sessionId, channelName, io, "error"], null);
58
+ const abortControllerRef = (0, react_1.useRef)(null);
59
+ const stop = (0, react_1.useCallback)(() => {
60
+ if (abortControllerRef.current) {
61
+ abortControllerRef.current.abort();
62
+ abortControllerRef.current = null;
63
+ }
64
+ }, []);
65
+ const onRecordsCallback = options.onRecords;
66
+ const onRecords = (0, react_1.useCallback)((recordsBatch) => {
67
+ if (onRecordsCallback) {
68
+ onRecordsCallback(recordsBatch);
69
+ }
70
+ }, [onRecordsCallback]);
71
+ const onControlCallback = options.onControl;
72
+ const onControl = (0, react_1.useCallback)((event) => {
73
+ if (onControlCallback) {
74
+ onControlCallback(event);
75
+ }
76
+ }, [onControlCallback]);
77
+ const apiClient = (0, useApiClient_js_1.useApiClient)(options);
78
+ const timeoutInSeconds = options.timeoutInSeconds;
79
+ const startEventId = options.lastEventId;
80
+ const throttleInMs = options.throttleInMs;
81
+ const from = options.from;
82
+ const maxRecords = options.maxRecords;
83
+ (0, react_1.useEffect)(() => {
84
+ if (maxRecords != null && maxRecords >= 0) {
85
+ const current = recordsRef.current;
86
+ if (current.length > maxRecords) {
87
+ mutateRecords(current.slice(current.length - maxRecords));
88
+ }
89
+ }
90
+ }, [maxRecords, mutateRecords]);
91
+ const triggerRequest = (0, react_1.useCallback)(async () => {
92
+ let abortController = null;
93
+ try {
94
+ if (!sessionId || !apiClient) {
95
+ return;
96
+ }
97
+ abortController = new AbortController();
98
+ abortControllerRef.current = abortController;
99
+ await processSessionChannelStream(sessionId, io, channelName, apiClient, mutateRecords, recordsRef, setLastEventId, setLastControl, setError, onRecords, onControl, abortControllerRef, timeoutInSeconds, startEventId !== undefined ? String(startEventId) : lastEventIdRef.current, throttleInMs ?? 16, from, maxRecords);
100
+ }
101
+ catch (err) {
102
+ if (err.name === "AbortError") {
103
+ return;
104
+ }
105
+ setError(err);
106
+ }
107
+ finally {
108
+ if (abortControllerRef.current === abortController) {
109
+ abortControllerRef.current = null;
110
+ }
111
+ setIsComplete(true);
112
+ }
113
+ }, [
114
+ sessionId,
115
+ io,
116
+ channelName,
117
+ apiClient,
118
+ mutateRecords,
119
+ setLastEventId,
120
+ setLastControl,
121
+ setError,
122
+ setIsComplete,
123
+ onRecords,
124
+ onControl,
125
+ timeoutInSeconds,
126
+ startEventId,
127
+ throttleInMs,
128
+ from,
129
+ maxRecords,
130
+ ]);
131
+ const requestSubscription = (0, useStableRequestCallback_js_1.useStableRequestCallback)(triggerRequest);
132
+ (0, react_1.useEffect)(() => {
133
+ if (typeof options.enabled === "boolean" && !options.enabled) {
134
+ return;
135
+ }
136
+ if (!sessionId) {
137
+ return;
138
+ }
139
+ requestSubscription().finally(() => { });
140
+ return () => {
141
+ stop();
142
+ };
143
+ }, [sessionId, channelName, io, stop, options.enabled, requestSubscription]);
144
+ return { records: records ?? initialRecordsFallback, lastEventId, lastControl, error, stop };
145
+ }
146
+ async function processSessionChannelStream(sessionIdOrExternalId, io, channel, apiClient, mutateRecordsData, existingRecordsRef, setLastEventId, setLastControl, onError, onRecords, onControl, abortControllerRef, timeoutInSeconds, lastEventId, throttleInMs, from, maxRecords) {
147
+ let lastSeenEventId;
148
+ let publishedEventId;
149
+ let partsBatch = [];
150
+ const publishLastEventId = () => {
151
+ if (lastSeenEventId !== publishedEventId) {
152
+ publishedEventId = lastSeenEventId;
153
+ setLastEventId(lastSeenEventId);
154
+ }
155
+ };
156
+ const flushParts = () => {
157
+ if (partsBatch.length === 0)
158
+ return;
159
+ const batch = partsBatch;
160
+ partsBatch = [];
161
+ onRecords(batch);
162
+ };
163
+ try {
164
+ const stream = await apiClient.subscribeToSessionStream(sessionIdOrExternalId, io, {
165
+ signal: abortControllerRef.current?.signal,
166
+ channel,
167
+ timeoutInSeconds,
168
+ lastEventId,
169
+ from,
170
+ onPart: (part) => {
171
+ lastSeenEventId = part.id;
172
+ partsBatch.push(part);
173
+ },
174
+ onControl: (event) => {
175
+ setLastControl(event);
176
+ onControl(event);
177
+ },
178
+ });
179
+ const recordsQueue = (0, throttle_js_1.createThrottledQueue)(async (newRecords) => {
180
+ const combined = [...existingRecordsRef.current, ...newRecords];
181
+ const bounded = maxRecords != null && maxRecords >= 0 && combined.length > maxRecords
182
+ ? combined.slice(combined.length - maxRecords)
183
+ : combined;
184
+ existingRecordsRef.current = bounded;
185
+ mutateRecordsData(bounded);
186
+ publishLastEventId();
187
+ flushParts();
188
+ }, throttleInMs);
189
+ for await (const record of stream) {
190
+ recordsQueue.add(record);
191
+ }
192
+ await recordsQueue.flush();
193
+ publishLastEventId();
194
+ flushParts();
195
+ }
196
+ catch (err) {
197
+ if (err.name === "AbortError") {
198
+ return;
199
+ }
200
+ if (err instanceof Error) {
201
+ onError(err);
202
+ }
203
+ else {
204
+ onError(new Error(String(err)));
205
+ }
206
+ throw err;
207
+ }
208
+ }
209
+ //# sourceMappingURL=useSessionStreamChannel.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useSessionStreamChannel.js","sourceRoot":"","sources":["../../../src/hooks/useSessionStreamChannel.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,107 @@
1
+ import { type InferRunTypes, type RunHandleFromTypes, type AnyTask, type TaskIdentifier, type TaskPayload, type TriggerOptions, type RealtimeRunSkipColumns } from "@trigger.dev/core/v3";
2
+ import { type UseApiClientOptions } from "./useApiClient.js";
3
+ import { type UseRealtimeRunInstance, type UseRealtimeRunWithStreamsInstance } from "./useRealtime.js";
4
+ /**
5
+ * Base interface for task trigger instances.
6
+ *
7
+ * @template TTask - The type of the task
8
+ */
9
+ export interface TriggerInstance<TTask extends AnyTask> {
10
+ /** Function to submit the task with a payload */
11
+ submit: (payload: TaskPayload<TTask>, options?: TriggerOptions) => void;
12
+ /** Whether the task is currently being submitted */
13
+ isLoading: boolean;
14
+ /** The handle returned after successful task submission */
15
+ handle?: RunHandleFromTypes<InferRunTypes<TTask>>;
16
+ /** Any error that occurred during submission */
17
+ error?: Error;
18
+ }
19
+ export type UseTaskTriggerOptions = UseApiClientOptions;
20
+ /**
21
+ * Hook to trigger a task and manage its initial execution state.
22
+ *
23
+ * @template TTask - The type of the task
24
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
25
+ * @param {UseTaskTriggerOptions} [options] - Configuration options for the task trigger
26
+ * @returns {TriggerInstance<TTask>} An object containing the submit function, loading state, handle, and any errors
27
+ *
28
+ * @example
29
+ * ```ts
30
+ * import type { myTask } from './path/to/task';
31
+ * const { submit, isLoading, handle, error } = useTaskTrigger<typeof myTask>('my-task-id');
32
+ *
33
+ * // Submit the task with payload
34
+ * submit({ foo: 'bar' });
35
+ * ```
36
+ */
37
+ export declare function useTaskTrigger<TTask extends AnyTask>(id: TaskIdentifier<TTask>, options?: UseTaskTriggerOptions): TriggerInstance<TTask>;
38
+ /**
39
+ * Configuration options for task triggers with realtime updates.
40
+ */
41
+ export type UseRealtimeTaskTriggerOptions = UseTaskTriggerOptions & {
42
+ /** Whether the realtime subscription is enabled */
43
+ enabled?: boolean;
44
+ /** Optional throttle time in milliseconds for stream updates */
45
+ experimental_throttleInMs?: number;
46
+ /**
47
+ * Skip columns from the subscription.
48
+ *
49
+ * @default []
50
+ */
51
+ skipColumns?: RealtimeRunSkipColumns;
52
+ };
53
+ export type RealtimeTriggerInstanceWithStreams<TTask extends AnyTask, TStreams extends Record<string, any> = Record<string, any>> = UseRealtimeRunWithStreamsInstance<TTask, TStreams> & {
54
+ submit: (payload: TaskPayload<TTask>, options?: TriggerOptions) => void;
55
+ isLoading: boolean;
56
+ handle?: RunHandleFromTypes<InferRunTypes<TTask>>;
57
+ };
58
+ /**
59
+ * Hook to trigger a task and subscribe to its realtime updates including stream data.
60
+ *
61
+ * @template TTask - The type of the task
62
+ * @template TStreams - The type of the streams data
63
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
64
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
65
+ * @returns {RealtimeTriggerInstanceWithStreams<TTask, TStreams>} An object containing the submit function, loading state,
66
+ * handle, run state, streams data, and error handling
67
+ *
68
+ * @example
69
+ * ```ts
70
+ * import type { myTask } from './path/to/task';
71
+ * const { submit, run, streams, error } = useRealtimeTaskTriggerWithStreams<
72
+ * typeof myTask,
73
+ * { output: string }
74
+ * >('my-task-id');
75
+ *
76
+ * // Submit and monitor the task with streams
77
+ * submit({ foo: 'bar' });
78
+ * ```
79
+ */
80
+ export declare function useRealtimeTaskTriggerWithStreams<TTask extends AnyTask, TStreams extends Record<string, any> = Record<string, any>>(id: TaskIdentifier<TTask>, options?: UseRealtimeTaskTriggerOptions): RealtimeTriggerInstanceWithStreams<TTask, TStreams>;
81
+ export type RealtimeTriggerInstance<TTask extends AnyTask> = UseRealtimeRunInstance<TTask> & {
82
+ submit: (payload: TaskPayload<TTask>, options?: TriggerOptions) => void;
83
+ isLoading: boolean;
84
+ handle?: RunHandleFromTypes<InferRunTypes<TTask>>;
85
+ };
86
+ /**
87
+ * Hook to trigger a task and subscribe to its realtime updates.
88
+ *
89
+ * @template TTask - The type of the task
90
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
91
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
92
+ * @returns {RealtimeTriggerInstance<TTask>} An object containing the submit function, loading state,
93
+ * handle, run state, and error handling
94
+ *
95
+ * @example
96
+ * ```ts
97
+ * import type { myTask } from './path/to/task';
98
+ * const { submit, run, error, stop } = useRealtimeTaskTrigger<typeof myTask>('my-task-id');
99
+ *
100
+ * // Submit and monitor the task
101
+ * submit({ foo: 'bar' });
102
+ *
103
+ * // Stop monitoring when needed
104
+ * stop();
105
+ * ```
106
+ */
107
+ export declare function useRealtimeTaskTrigger<TTask extends AnyTask>(id: TaskIdentifier<TTask>, options?: UseRealtimeTaskTriggerOptions): RealtimeTriggerInstance<TTask>;
@@ -0,0 +1,139 @@
1
+ "use strict";
2
+ "use client";
3
+ var __importDefault = (this && this.__importDefault) || function (mod) {
4
+ return (mod && mod.__esModule) ? mod : { "default": mod };
5
+ };
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.useTaskTrigger = useTaskTrigger;
8
+ exports.useRealtimeTaskTriggerWithStreams = useRealtimeTaskTriggerWithStreams;
9
+ exports.useRealtimeTaskTrigger = useRealtimeTaskTrigger;
10
+ const v3_1 = require("@trigger.dev/core/v3");
11
+ const mutation_1 = __importDefault(require("swr/mutation"));
12
+ const useApiClient_js_1 = require("./useApiClient.js");
13
+ const useRealtime_js_1 = require("./useRealtime.js");
14
+ /**
15
+ * Hook to trigger a task and manage its initial execution state.
16
+ *
17
+ * @template TTask - The type of the task
18
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
19
+ * @param {UseTaskTriggerOptions} [options] - Configuration options for the task trigger
20
+ * @returns {TriggerInstance<TTask>} An object containing the submit function, loading state, handle, and any errors
21
+ *
22
+ * @example
23
+ * ```ts
24
+ * import type { myTask } from './path/to/task';
25
+ * const { submit, isLoading, handle, error } = useTaskTrigger<typeof myTask>('my-task-id');
26
+ *
27
+ * // Submit the task with payload
28
+ * submit({ foo: 'bar' });
29
+ * ```
30
+ */
31
+ function useTaskTrigger(id, options) {
32
+ const apiClient = (0, useApiClient_js_1.useApiClient)(options);
33
+ async function triggerTask(id, { arg: { payload, options }, }) {
34
+ if (!apiClient) {
35
+ throw new Error("Could not trigger task in useTaskTrigger: Missing access token");
36
+ }
37
+ const payloadPacket = await (0, v3_1.stringifyIO)(payload);
38
+ const handle = await apiClient.triggerTask(id, {
39
+ payload: payloadPacket.data,
40
+ options: {
41
+ queue: options?.queue ? { name: options.queue } : undefined,
42
+ concurrencyKey: options?.concurrencyKey,
43
+ payloadType: payloadPacket.dataType,
44
+ idempotencyKey: await (0, v3_1.makeIdempotencyKey)(options?.idempotencyKey),
45
+ delay: options?.delay,
46
+ ttl: options?.ttl,
47
+ tags: options?.tags,
48
+ maxAttempts: options?.maxAttempts,
49
+ metadata: options?.metadata,
50
+ maxDuration: options?.maxDuration,
51
+ lockToVersion: options?.version,
52
+ debounce: options?.debounce,
53
+ },
54
+ });
55
+ return { ...handle, taskIdentifier: id };
56
+ }
57
+ const mutation = (0, mutation_1.default)(id, triggerTask);
58
+ return {
59
+ submit: (payload, options) => {
60
+ // trigger the task with the given payload
61
+ mutation.trigger({ payload, options });
62
+ },
63
+ isLoading: mutation.isMutating,
64
+ handle: mutation.data,
65
+ error: mutation.error,
66
+ };
67
+ }
68
+ /**
69
+ * Hook to trigger a task and subscribe to its realtime updates including stream data.
70
+ *
71
+ * @template TTask - The type of the task
72
+ * @template TStreams - The type of the streams data
73
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
74
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
75
+ * @returns {RealtimeTriggerInstanceWithStreams<TTask, TStreams>} An object containing the submit function, loading state,
76
+ * handle, run state, streams data, and error handling
77
+ *
78
+ * @example
79
+ * ```ts
80
+ * import type { myTask } from './path/to/task';
81
+ * const { submit, run, streams, error } = useRealtimeTaskTriggerWithStreams<
82
+ * typeof myTask,
83
+ * { output: string }
84
+ * >('my-task-id');
85
+ *
86
+ * // Submit and monitor the task with streams
87
+ * submit({ foo: 'bar' });
88
+ * ```
89
+ */
90
+ function useRealtimeTaskTriggerWithStreams(id, options) {
91
+ const triggerInstance = useTaskTrigger(id, options);
92
+ const realtimeInstance = (0, useRealtime_js_1.useRealtimeRunWithStreams)(triggerInstance.handle?.id, {
93
+ ...options,
94
+ id: triggerInstance.handle?.id,
95
+ accessToken: triggerInstance.handle?.publicAccessToken ?? options?.accessToken,
96
+ });
97
+ return {
98
+ ...realtimeInstance,
99
+ ...triggerInstance,
100
+ };
101
+ }
102
+ /**
103
+ * Hook to trigger a task and subscribe to its realtime updates.
104
+ *
105
+ * @template TTask - The type of the task
106
+ * @param {TaskIdentifier<TTask>} id - The identifier of the task to trigger
107
+ * @param {UseRealtimeTaskTriggerOptions} [options] - Configuration options for the task trigger and realtime updates
108
+ * @returns {RealtimeTriggerInstance<TTask>} An object containing the submit function, loading state,
109
+ * handle, run state, and error handling
110
+ *
111
+ * @example
112
+ * ```ts
113
+ * import type { myTask } from './path/to/task';
114
+ * const { submit, run, error, stop } = useRealtimeTaskTrigger<typeof myTask>('my-task-id');
115
+ *
116
+ * // Submit and monitor the task
117
+ * submit({ foo: 'bar' });
118
+ *
119
+ * // Stop monitoring when needed
120
+ * stop();
121
+ * ```
122
+ */
123
+ function useRealtimeTaskTrigger(id, options) {
124
+ const triggerInstance = useTaskTrigger(id, options);
125
+ const realtimeInstance = (0, useRealtime_js_1.useRealtimeRun)(triggerInstance.handle?.id, {
126
+ ...options,
127
+ id: triggerInstance.handle?.id,
128
+ accessToken: triggerInstance.handle?.publicAccessToken ?? options?.accessToken,
129
+ });
130
+ return {
131
+ submit: triggerInstance.submit,
132
+ isLoading: triggerInstance.isLoading,
133
+ handle: triggerInstance.handle,
134
+ run: realtimeInstance.run,
135
+ error: realtimeInstance.error ?? triggerInstance.error,
136
+ stop: realtimeInstance.stop,
137
+ };
138
+ }
139
+ //# sourceMappingURL=useTaskTrigger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useTaskTrigger.js","sourceRoot":"","sources":["../../../src/hooks/useTaskTrigger.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,35 @@
1
+ import type { UseApiClientOptions } from "./useApiClient.js";
2
+ /**
3
+ * Base interface for task trigger instances.
4
+ *
5
+ * @template TOutput - The type of the output
6
+ */
7
+ export interface WaitTokenInstance<TOutput> {
8
+ /** Function to complete the waitpoint with an output */
9
+ complete: (output: TOutput) => void;
10
+ /** Whether the waitpoint is currently being completed */
11
+ isLoading: boolean;
12
+ /** Whether the waitpoint has been completed */
13
+ isCompleted: boolean;
14
+ /** Any error that occurred during completion */
15
+ error?: Error;
16
+ /** Whether the waitpoint is ready to be completed */
17
+ isReady: boolean;
18
+ }
19
+ /**
20
+ * Hook to complete a waitpoint and manage its completion state.
21
+ *
22
+ * @template TOutput - The type of the output
23
+ * @param {string} waitpointId - The identifier of the waitpoint to complete
24
+ * @returns {WaitTokenInstance<TOutput>} An object containing the complete function, loading state, isCompleted, and any errors
25
+ *
26
+ * @example
27
+ * ```ts
28
+ * import type { myTask } from './path/to/task';
29
+ * const { complete, isLoading, isCompleted, error } = useWaitToken('waitpoint-id');
30
+ *
31
+ * // Complete the waitpoint with an output
32
+ * complete({ foo: 'bar' });
33
+ * ```
34
+ */
35
+ export declare function useWaitToken<TOutput>(waitpointId?: string, options?: UseApiClientOptions): WaitTokenInstance<TOutput>;
@@ -0,0 +1,52 @@
1
+ "use strict";
2
+ "use client";
3
+ var __importDefault = (this && this.__importDefault) || function (mod) {
4
+ return (mod && mod.__esModule) ? mod : { "default": mod };
5
+ };
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ exports.useWaitToken = useWaitToken;
8
+ const mutation_1 = __importDefault(require("swr/mutation"));
9
+ const useApiClient_js_1 = require("./useApiClient.js");
10
+ /**
11
+ * Hook to complete a waitpoint and manage its completion state.
12
+ *
13
+ * @template TOutput - The type of the output
14
+ * @param {string} waitpointId - The identifier of the waitpoint to complete
15
+ * @returns {WaitTokenInstance<TOutput>} An object containing the complete function, loading state, isCompleted, and any errors
16
+ *
17
+ * @example
18
+ * ```ts
19
+ * import type { myTask } from './path/to/task';
20
+ * const { complete, isLoading, isCompleted, error } = useWaitToken('waitpoint-id');
21
+ *
22
+ * // Complete the waitpoint with an output
23
+ * complete({ foo: 'bar' });
24
+ * ```
25
+ */
26
+ function useWaitToken(waitpointId, options) {
27
+ const apiClient = (0, useApiClient_js_1.useApiClient)(options);
28
+ async function completeWaitpoint(id, { arg: { output } }) {
29
+ if (!apiClient) {
30
+ throw new Error("Could not complete waitpoint in useWaitToken: Missing access token");
31
+ }
32
+ if (!waitpointId) {
33
+ throw new Error("Could not complete waitpoint in useWaitToken: Missing waitpoint ID");
34
+ }
35
+ const result = await apiClient.completeWaitpointToken(waitpointId, {
36
+ data: output,
37
+ });
38
+ return result;
39
+ }
40
+ const mutation = (0, mutation_1.default)(waitpointId, completeWaitpoint);
41
+ return {
42
+ complete: (output) => {
43
+ // trigger the task with the given payload
44
+ mutation.trigger({ output });
45
+ },
46
+ isLoading: mutation.isMutating,
47
+ isCompleted: !!mutation.data?.success,
48
+ isReady: !!waitpointId,
49
+ error: mutation.error,
50
+ };
51
+ }
52
+ //# sourceMappingURL=useWaitToken.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"useWaitToken.js","sourceRoot":"","sources":["../../../src/hooks/useWaitToken.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;AAEb,4DAA0C;AAE1C,uDAAiD;AAoBjD;;;;;;;;;;;;;;;GAeG;AACH,sBACE,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"}
@@ -0,0 +1,9 @@
1
+ export * from "./contexts.js";
2
+ export * from "./hooks/useApiClient.js";
3
+ export * from "./hooks/useRun.js";
4
+ export * from "./hooks/useRealtime.js";
5
+ export * from "./hooks/useTaskTrigger.js";
6
+ export * from "./hooks/useWaitToken.js";
7
+ export * from "./hooks/useInputStreamSend.js";
8
+ export * from "./hooks/useSessionStream.js";
9
+ export * from "./hooks/useSessionStreamChannel.js";
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
+ for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
+ };
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
+ __exportStar(require("./contexts.js"), exports);
18
+ __exportStar(require("./hooks/useApiClient.js"), exports);
19
+ __exportStar(require("./hooks/useRun.js"), exports);
20
+ __exportStar(require("./hooks/useRealtime.js"), exports);
21
+ __exportStar(require("./hooks/useTaskTrigger.js"), exports);
22
+ __exportStar(require("./hooks/useWaitToken.js"), exports);
23
+ __exportStar(require("./hooks/useInputStreamSend.js"), exports);
24
+ __exportStar(require("./hooks/useSessionStream.js"), exports);
25
+ __exportStar(require("./hooks/useSessionStreamChannel.js"), exports);
26
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
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;AAC9C,8DAA4C;AAC5C,qEAAmD"}
@@ -0,0 +1,3 @@
1
+ {
2
+ "type": "commonjs"
3
+ }
@@ -0,0 +1,14 @@
1
+ import React from "react";
2
+ type Options = {
3
+ assertCtxFn?: (v: unknown, msg: string) => void;
4
+ };
5
+ type ContextOf<T> = React.Context<T | undefined>;
6
+ type UseCtxFn<T> = () => T;
7
+ /**
8
+ * Creates and returns a Context and two hooks that return the context value.
9
+ * The Context type is derived from the type passed in by the user.
10
+ * The first hook returned guarantees that the context exists so the returned value is always CtxValue
11
+ * The second hook makes no guarantees, so the returned value can be CtxValue | undefined
12
+ */
13
+ export declare const createContextAndHook: <CtxVal>(displayName: string, options?: Options) => [ContextOf<CtxVal>, UseCtxFn<CtxVal>, UseCtxFn<CtxVal | Partial<CtxVal>>];
14
+ export {};