@coji/durably-react 0.6.0

package/dist/index.js

@@ -0,0 +1,464 @@
+// src/context.tsx
+import { Suspense, createContext, use, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var DurablyContext = createContext(null);
+function DurablyProviderInner({
+  durably: durablyOrPromise,
+  children
+}) {
+  const durably = durablyOrPromise instanceof Promise ? use(durablyOrPromise) : durablyOrPromise;
+  return /* @__PURE__ */ jsx(DurablyContext.Provider, { value: { durably }, children });
+}
+function DurablyProvider({
+  durably,
+  fallback,
+  children
+}) {
+  const inner = /* @__PURE__ */ jsx(DurablyProviderInner, { durably, children });
+  if (fallback !== void 0) {
+    return /* @__PURE__ */ jsx(Suspense, { fallback, children: inner });
+  }
+  return inner;
+}
+function useDurably() {
+  const context = useContext(DurablyContext);
+  if (!context) {
+    throw new Error("useDurably must be used within a DurablyProvider");
+  }
+  return context;
+}
+
+// src/hooks/use-job.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+function useJob(jobDefinition, options) {
+  const { durably } = useDurably();
+  const [status, setStatus] = useState(null);
+  const [output, setOutput] = useState(null);
+  const [error, setError] = useState(null);
+  const [logs, setLogs] = useState([]);
+  const [progress, setProgress] = useState(null);
+  const [currentRunId, setCurrentRunId] = useState(
+    options?.initialRunId ?? null
+  );
+  const jobHandleRef = useRef(null);
+  const currentRunIdRef = useRef(currentRunId);
+  currentRunIdRef.current = currentRunId;
+  useEffect(() => {
+    if (!durably) return;
+    const d = durably.register({
+      _job: jobDefinition
+    });
+    const jobHandle = d.jobs._job;
+    jobHandleRef.current = jobHandle;
+    const unsubscribes = [];
+    unsubscribes.push(
+      durably.on("run:start", (event) => {
+        if (event.jobName !== jobDefinition.name) return;
+        if (options?.followLatest === false) {
+          if (event.runId !== currentRunIdRef.current) return;
+          setStatus("running");
+          return;
+        }
+        setCurrentRunId(event.runId);
+        currentRunIdRef.current = event.runId;
+        setStatus("running");
+        setOutput(null);
+        setError(null);
+        setLogs([]);
+        setProgress(null);
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:complete", (event) => {
+        if (event.runId !== currentRunIdRef.current) return;
+        setStatus("completed");
+        setOutput(event.output);
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:fail", (event) => {
+        if (event.runId !== currentRunIdRef.current) return;
+        setStatus("failed");
+        setError(event.error);
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:progress", (event) => {
+        if (event.runId !== currentRunIdRef.current) return;
+        setProgress(event.progress);
+      })
+    );
+    unsubscribes.push(
+      durably.on("log:write", (event) => {
+        if (event.runId !== currentRunIdRef.current) return;
+        setLogs((prev) => [
+          ...prev,
+          {
+            id: crypto.randomUUID(),
+            runId: event.runId,
+            stepName: event.stepName,
+            level: event.level,
+            message: event.message,
+            data: event.data,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          }
+        ]);
+      })
+    );
+    if (options?.initialRunId && currentRunIdRef.current) {
+      jobHandle.getRun(currentRunIdRef.current).then((run) => {
+        if (run) {
+          setStatus(run.status);
+          if (run.status === "completed" && run.output) {
+            setOutput(run.output);
+          }
+          if (run.status === "failed" && run.error) {
+            setError(run.error);
+          }
+        }
+      });
+    }
+    if (options?.autoResume !== false && !options?.initialRunId) {
+      ;
+      (async () => {
+        const runningRuns = await jobHandle.getRuns({ status: "running" });
+        if (runningRuns.length > 0) {
+          const run = runningRuns[0];
+          setCurrentRunId(run.id);
+          currentRunIdRef.current = run.id;
+          setStatus(run.status);
+          return;
+        }
+        const pendingRuns = await jobHandle.getRuns({ status: "pending" });
+        if (pendingRuns.length > 0) {
+          const run = pendingRuns[0];
+          setCurrentRunId(run.id);
+          currentRunIdRef.current = run.id;
+          setStatus(run.status);
+        }
+      })();
+    }
+    return () => {
+      for (const unsubscribe of unsubscribes) {
+        unsubscribe();
+      }
+    };
+  }, [
+    durably,
+    jobDefinition,
+    options?.initialRunId,
+    options?.autoResume,
+    options?.followLatest
+  ]);
+  useEffect(() => {
+    if (!durably || !currentRunId) return;
+    const jobHandle = jobHandleRef.current;
+    if (jobHandle && options?.initialRunId) {
+      jobHandle.getRun(currentRunId).then((run) => {
+        if (run) {
+          setStatus(run.status);
+          if (run.status === "completed" && run.output) {
+            setOutput(run.output);
+          }
+          if (run.status === "failed" && run.error) {
+            setError(run.error);
+          }
+        }
+      });
+    }
+  }, [durably, currentRunId, options?.initialRunId]);
+  const trigger = useCallback(
+    async (input) => {
+      const jobHandle = jobHandleRef.current;
+      if (!jobHandle) {
+        throw new Error("Job not ready");
+      }
+      setOutput(null);
+      setError(null);
+      setLogs([]);
+      setProgress(null);
+      const run = await jobHandle.trigger(input);
+      setCurrentRunId(run.id);
+      currentRunIdRef.current = run.id;
+      setStatus("pending");
+      return { runId: run.id };
+    },
+    []
+  );
+  const triggerAndWait = useCallback(
+    async (input) => {
+      const jobHandle = jobHandleRef.current;
+      if (!jobHandle || !durably) {
+        throw new Error("Job not ready");
+      }
+      setOutput(null);
+      setError(null);
+      setLogs([]);
+      setProgress(null);
+      const run = await jobHandle.trigger(input);
+      setCurrentRunId(run.id);
+      currentRunIdRef.current = run.id;
+      setStatus("pending");
+      return new Promise((resolve, reject) => {
+        const checkCompletion = async () => {
+          const updatedRun = await jobHandle.getRun(run.id);
+          if (!updatedRun) {
+            reject(new Error("Run not found"));
+            return;
+          }
+          if (updatedRun.status === "completed") {
+            resolve({ runId: run.id, output: updatedRun.output });
+          } else if (updatedRun.status === "failed") {
+            reject(new Error(updatedRun.error ?? "Job failed"));
+          } else if (updatedRun.status === "cancelled") {
+            reject(new Error("Job cancelled"));
+          } else {
+            setTimeout(checkCompletion, 50);
+          }
+        };
+        checkCompletion();
+      });
+    },
+    [durably]
+  );
+  const reset = useCallback(() => {
+    setStatus(null);
+    setOutput(null);
+    setError(null);
+    setLogs([]);
+    setProgress(null);
+    setCurrentRunId(null);
+  }, []);
+  return {
+    trigger,
+    triggerAndWait,
+    status,
+    output,
+    error,
+    logs,
+    progress,
+    isRunning: status === "running",
+    isPending: status === "pending",
+    isCompleted: status === "completed",
+    isFailed: status === "failed",
+    isCancelled: status === "cancelled",
+    currentRunId,
+    reset
+  };
+}
+
+// src/hooks/use-run-subscription.ts
+import { useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
+function useRunSubscription(durably, runId, options) {
+  const [status, setStatus] = useState2(null);
+  const [output, setOutput] = useState2(null);
+  const [error, setError] = useState2(null);
+  const [logs, setLogs] = useState2([]);
+  const [progress, setProgress] = useState2(null);
+  const runIdRef = useRef2(runId);
+  runIdRef.current = runId;
+  const maxLogs = options?.maxLogs ?? 0;
+  useEffect2(() => {
+    if (!durably || !runId) return;
+    const unsubscribes = [];
+    unsubscribes.push(
+      durably.on("run:start", (event) => {
+        if (event.runId !== runIdRef.current) return;
+        setStatus("running");
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:complete", (event) => {
+        if (event.runId !== runIdRef.current) return;
+        setStatus("completed");
+        setOutput(event.output);
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:fail", (event) => {
+        if (event.runId !== runIdRef.current) return;
+        setStatus("failed");
+        setError(event.error);
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:cancel", (event) => {
+        if (event.runId !== runIdRef.current) return;
+        setStatus("cancelled");
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:retry", (event) => {
+        if (event.runId !== runIdRef.current) return;
+        setStatus("pending");
+        setError(null);
+      })
+    );
+    unsubscribes.push(
+      durably.on("run:progress", (event) => {
+        if (event.runId !== runIdRef.current) return;
+        setProgress(event.progress);
+      })
+    );
+    unsubscribes.push(
+      durably.on("log:write", (event) => {
+        if (event.runId !== runIdRef.current) return;
+        setLogs((prev) => {
+          const newLog = {
+            id: crypto.randomUUID(),
+            runId: event.runId,
+            stepName: event.stepName,
+            level: event.level,
+            message: event.message,
+            data: event.data,
+            timestamp: (/* @__PURE__ */ new Date()).toISOString()
+          };
+          const newLogs = [...prev, newLog];
+          if (maxLogs > 0 && newLogs.length > maxLogs) {
+            return newLogs.slice(-maxLogs);
+          }
+          return newLogs;
+        });
+      })
+    );
+    return () => {
+      for (const unsubscribe of unsubscribes) {
+        unsubscribe();
+      }
+    };
+  }, [durably, runId, maxLogs]);
+  const clearLogs = () => {
+    setLogs([]);
+  };
+  const reset = () => {
+    setStatus(null);
+    setOutput(null);
+    setError(null);
+    setLogs([]);
+    setProgress(null);
+  };
+  return {
+    status,
+    output,
+    error,
+    logs,
+    progress,
+    clearLogs,
+    reset
+  };
+}
+
+// src/hooks/use-job-logs.ts
+function useJobLogs(options) {
+  const { durably } = useDurably();
+  const { runId, maxLogs } = options;
+  const subscription = useRunSubscription(durably, runId, { maxLogs });
+  return {
+    logs: subscription.logs,
+    clearLogs: subscription.clearLogs
+  };
+}
+
+// src/hooks/use-job-run.ts
+import { useEffect as useEffect3, useRef as useRef3 } from "react";
+function useJobRun(options) {
+  const { durably } = useDurably();
+  const { runId } = options;
+  const subscription = useRunSubscription(durably, runId);
+  const fetchedRef = useRef3(/* @__PURE__ */ new Set());
+  useEffect3(() => {
+    if (!durably || !runId || fetchedRef.current.has(runId)) return;
+    fetchedRef.current.add(runId);
+  }, [durably, runId]);
+  return {
+    status: subscription.status,
+    output: subscription.output,
+    error: subscription.error,
+    logs: subscription.logs,
+    progress: subscription.progress,
+    isRunning: subscription.status === "running",
+    isPending: subscription.status === "pending",
+    isCompleted: subscription.status === "completed",
+    isFailed: subscription.status === "failed",
+    isCancelled: subscription.status === "cancelled"
+  };
+}
+
+// src/hooks/use-runs.ts
+import { useCallback as useCallback2, useEffect as useEffect4, useState as useState3 } from "react";
+function useRuns(options) {
+  const { durably } = useDurably();
+  const pageSize = options?.pageSize ?? 10;
+  const realtime = options?.realtime ?? true;
+  const [runs, setRuns] = useState3([]);
+  const [page, setPage] = useState3(0);
+  const [hasMore, setHasMore] = useState3(false);
+  const [isLoading, setIsLoading] = useState3(false);
+  const refresh = useCallback2(async () => {
+    if (!durably) return;
+    setIsLoading(true);
+    try {
+      const data = await durably.getRuns({
+        jobName: options?.jobName,
+        status: options?.status,
+        limit: pageSize + 1,
+        offset: page * pageSize
+      });
+      setHasMore(data.length > pageSize);
+      setRuns(data.slice(0, pageSize));
+    } finally {
+      setIsLoading(false);
+    }
+  }, [durably, options?.jobName, options?.status, pageSize, page]);
+  useEffect4(() => {
+    if (!durably) return;
+    refresh();
+    if (!realtime) return;
+    const unsubscribes = [
+      durably.on("run:trigger", refresh),
+      durably.on("run:start", refresh),
+      durably.on("run:complete", refresh),
+      durably.on("run:fail", refresh),
+      durably.on("run:cancel", refresh),
+      durably.on("run:retry", refresh),
+      durably.on("run:progress", refresh),
+      durably.on("step:start", refresh),
+      durably.on("step:complete", refresh)
+    ];
+    return () => {
+      for (const unsubscribe of unsubscribes) {
+        unsubscribe();
+      }
+    };
+  }, [durably, refresh, realtime]);
+  const nextPage = useCallback2(() => {
+    if (hasMore) {
+      setPage((p) => p + 1);
+    }
+  }, [hasMore]);
+  const prevPage = useCallback2(() => {
+    setPage((p) => Math.max(0, p - 1));
+  }, []);
+  const goToPage = useCallback2((newPage) => {
+    setPage(Math.max(0, newPage));
+  }, []);
+  return {
+    runs,
+    page,
+    hasMore,
+    isLoading,
+    nextPage,
+    prevPage,
+    goToPage,
+    refresh
+  };
+}
+export {
+  DurablyProvider,
+  useDurably,
+  useJob,
+  useJobLogs,
+  useJobRun,
+  useRuns
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.tsx","../src/hooks/use-job.ts","../src/hooks/use-run-subscription.ts","../src/hooks/use-job-logs.ts","../src/hooks/use-job-run.ts","../src/hooks/use-runs.ts"],"sourcesContent":["import type { Durably } from '@coji/durably'\nimport { Suspense, createContext, use, useContext, type ReactNode } from 'react'\n\ninterface DurablyContextValue {\n  durably: Durably\n}\n\nconst DurablyContext = createContext<DurablyContextValue | null>(null)\n\nexport interface DurablyProviderProps {\n  /**\n   * Durably instance or Promise that resolves to one.\n   * The instance should already be initialized via `await durably.init()`.\n   *\n   * When passing a Promise, wrap the provider with Suspense or use the fallback prop.\n   *\n   * @example\n   * // With Suspense (recommended)\n   * <Suspense fallback={<Loading />}>\n   *   <DurablyProvider durably={durablyPromise}>\n   *     <App />\n   *   </DurablyProvider>\n   * </Suspense>\n   *\n   * @example\n   * // With fallback prop\n   * <DurablyProvider durably={durablyPromise} fallback={<Loading />}>\n   *   <App />\n   * </DurablyProvider>\n   */\n  durably: Durably | Promise<Durably>\n  /**\n   * Fallback to show while waiting for the Durably Promise to resolve.\n   * This wraps the provider content in a Suspense boundary automatically.\n   */\n  fallback?: ReactNode\n  children: ReactNode\n}\n\n/**\n * Internal component that uses the `use()` hook to resolve the Promise\n */\nfunction DurablyProviderInner({\n  durably: durablyOrPromise,\n  children,\n}: Omit<DurablyProviderProps, 'fallback'>) {\n  const durably =\n    durablyOrPromise instanceof Promise\n      ? use(durablyOrPromise)\n      : durablyOrPromise\n\n  return (\n    <DurablyContext.Provider value={{ durably }}>\n      {children}\n    </DurablyContext.Provider>\n  )\n}\n\nexport function DurablyProvider({\n  durably,\n  fallback,\n  children,\n}: DurablyProviderProps) {\n  const inner = (\n    <DurablyProviderInner durably={durably}>{children}</DurablyProviderInner>\n  )\n\n  if (fallback !== undefined) {\n    return <Suspense fallback={fallback}>{inner}</Suspense>\n  }\n\n  return inner\n}\n\nexport function useDurably(): DurablyContextValue {\n  const context = useContext(DurablyContext)\n  if (!context) {\n    throw new Error('useDurably must be used within a DurablyProvider')\n  }\n  return context\n}\n","import type { JobDefinition, JobHandle } from '@coji/durably'\nimport { useCallback, useEffect, useRef, useState } from 'react'\nimport { useDurably } from '../context'\nimport type { LogEntry, Progress, RunStatus } from '../types'\n\nexport interface UseJobOptions {\n  /**\n   * Initial Run ID to subscribe to (for reconnection scenarios)\n   */\n  initialRunId?: string\n  /**\n   * Automatically resume tracking any pending or running job on initialization.\n   * If a pending or running run exists for this job, the hook will subscribe to it.\n   * @default true\n   */\n  autoResume?: boolean\n  /**\n   * Automatically switch to tracking the latest running job when a new run starts.\n   * When true, the hook will update to track any new run for this job as soon as it starts running.\n   * When false, the hook will only track the run that was triggered or explicitly set.\n   * @default true\n   */\n  followLatest?: boolean\n}\n\nexport interface UseJobResult<TInput, TOutput> {\n  /**\n   * Trigger the job with the given input\n   */\n  trigger: (input: TInput) => Promise<{ runId: string }>\n  /**\n   * Trigger and wait for completion\n   */\n  triggerAndWait: (input: TInput) => Promise<{ runId: string; output: TOutput }>\n  /**\n   * Current run status\n   */\n  status: RunStatus | null\n  /**\n   * Output from completed run\n   */\n  output: TOutput | null\n  /**\n   * Error message from failed run\n   */\n  error: string | null\n  /**\n   * Logs collected during execution\n   */\n  logs: LogEntry[]\n  /**\n   * Current progress\n   */\n  progress: Progress | null\n  /**\n   * Whether a run is currently running\n   */\n  isRunning: boolean\n  /**\n   * Whether a run is pending\n   */\n  isPending: boolean\n  /**\n   * Whether the run completed successfully\n   */\n  isCompleted: boolean\n  /**\n   * Whether the run failed\n   */\n  isFailed: boolean\n  /**\n   * Whether the run was cancelled\n   */\n  isCancelled: boolean\n  /**\n   * Current run ID\n   */\n  currentRunId: string | null\n  /**\n   * Reset all state\n   */\n  reset: () => void\n}\n\nexport function useJob<\n  TName extends string,\n  TInput extends Record<string, unknown>,\n  // biome-ignore lint/suspicious/noConfusingVoidType: TOutput can be void for jobs without return value\n  TOutput extends Record<string, unknown> | void,\n>(\n  jobDefinition: JobDefinition<TName, TInput, TOutput>,\n  options?: UseJobOptions,\n): UseJobResult<TInput, TOutput> {\n  const { durably } = useDurably()\n\n  const [status, setStatus] = useState<RunStatus | null>(null)\n  const [output, setOutput] = useState<TOutput | null>(null)\n  const [error, setError] = useState<string | null>(null)\n  const [logs, setLogs] = useState<LogEntry[]>([])\n  const [progress, setProgress] = useState<Progress | null>(null)\n  const [currentRunId, setCurrentRunId] = useState<string | null>(\n    options?.initialRunId ?? null,\n  )\n\n  const jobHandleRef = useRef<JobHandle<TName, TInput, TOutput> | null>(null)\n  // Use ref to track the latest runId for event filtering\n  const currentRunIdRef = useRef<string | null>(currentRunId)\n  currentRunIdRef.current = currentRunId\n\n  // Register job and set up event listeners\n  useEffect(() => {\n    if (!durably) return\n\n    // Register the job (use fixed key for simpler type handling)\n    const d = durably.register({\n      _job: jobDefinition,\n    })\n    const jobHandle = d.jobs._job\n    jobHandleRef.current = jobHandle\n\n    // Subscribe to each event type separately\n    const unsubscribes: (() => void)[] = []\n\n    unsubscribes.push(\n      durably.on('run:start', (event) => {\n        // Check if this is a run for our job\n        if (event.jobName !== jobDefinition.name) return\n\n        // If followLatest is disabled, only update if this is our current run\n        if (options?.followLatest === false) {\n          if (event.runId !== currentRunIdRef.current) return\n          setStatus('running')\n          return\n        }\n\n        // Switch to tracking the running job (followLatest: true, default)\n        setCurrentRunId(event.runId)\n        currentRunIdRef.current = event.runId\n        setStatus('running')\n        // Reset output/error when switching to a new run\n        setOutput(null)\n        setError(null)\n        setLogs([])\n        setProgress(null)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:complete', (event) => {\n        if (event.runId !== currentRunIdRef.current) return\n        setStatus('completed')\n        setOutput(event.output as TOutput)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:fail', (event) => {\n        if (event.runId !== currentRunIdRef.current) return\n        setStatus('failed')\n        setError(event.error)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:progress', (event) => {\n        if (event.runId !== currentRunIdRef.current) return\n        setProgress(event.progress)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('log:write', (event) => {\n        if (event.runId !== currentRunIdRef.current) return\n        setLogs((prev) => [\n          ...prev,\n          {\n            id: crypto.randomUUID(),\n            runId: event.runId,\n            stepName: event.stepName,\n            level: event.level,\n            message: event.message,\n            data: event.data,\n            timestamp: new Date().toISOString(),\n          },\n        ])\n      }),\n    )\n\n    // If we have an initialRunId, fetch its current state\n    if (options?.initialRunId && currentRunIdRef.current) {\n      jobHandle.getRun(currentRunIdRef.current).then((run) => {\n        if (run) {\n          setStatus(run.status as RunStatus)\n          if (run.status === 'completed' && run.output) {\n            setOutput(run.output as TOutput)\n          }\n          if (run.status === 'failed' && run.error) {\n            setError(run.error)\n          }\n        }\n      })\n    }\n\n    // Auto-resume: find any pending or running runs for this job (default: true)\n    if (options?.autoResume !== false && !options?.initialRunId) {\n      ;(async () => {\n        // First check for running runs\n        const runningRuns = await jobHandle.getRuns({ status: 'running' })\n        if (runningRuns.length > 0) {\n          const run = runningRuns[0]\n          setCurrentRunId(run.id)\n          currentRunIdRef.current = run.id\n          setStatus(run.status as RunStatus)\n          return\n        }\n\n        // Then check for pending runs\n        const pendingRuns = await jobHandle.getRuns({ status: 'pending' })\n        if (pendingRuns.length > 0) {\n          const run = pendingRuns[0]\n          setCurrentRunId(run.id)\n          currentRunIdRef.current = run.id\n          setStatus(run.status as RunStatus)\n        }\n      })()\n    }\n\n    return () => {\n      for (const unsubscribe of unsubscribes) {\n        unsubscribe()\n      }\n    }\n  }, [\n    durably,\n    jobDefinition,\n    options?.initialRunId,\n    options?.autoResume,\n    options?.followLatest,\n  ])\n\n  // Update state when currentRunId changes (for initialRunId scenario)\n  useEffect(() => {\n    if (!durably || !currentRunId) return\n\n    const jobHandle = jobHandleRef.current\n    if (jobHandle && options?.initialRunId) {\n      jobHandle.getRun(currentRunId).then((run) => {\n        if (run) {\n          setStatus(run.status as RunStatus)\n          if (run.status === 'completed' && run.output) {\n            setOutput(run.output as TOutput)\n          }\n          if (run.status === 'failed' && run.error) {\n            setError(run.error)\n          }\n        }\n      })\n    }\n  }, [durably, currentRunId, options?.initialRunId])\n\n  const trigger = useCallback(\n    async (input: TInput): Promise<{ runId: string }> => {\n      const jobHandle = jobHandleRef.current\n      if (!jobHandle) {\n        throw new Error('Job not ready')\n      }\n\n      // Reset state\n      setOutput(null)\n      setError(null)\n      setLogs([])\n      setProgress(null)\n\n      const run = await jobHandle.trigger(input)\n      setCurrentRunId(run.id)\n      currentRunIdRef.current = run.id\n      setStatus('pending')\n\n      return { runId: run.id }\n    },\n    [],\n  )\n\n  const triggerAndWait = useCallback(\n    async (input: TInput): Promise<{ runId: string; output: TOutput }> => {\n      const jobHandle = jobHandleRef.current\n      if (!jobHandle || !durably) {\n        throw new Error('Job not ready')\n      }\n\n      // Reset state\n      setOutput(null)\n      setError(null)\n      setLogs([])\n      setProgress(null)\n\n      const run = await jobHandle.trigger(input)\n      setCurrentRunId(run.id)\n      currentRunIdRef.current = run.id\n      setStatus('pending')\n\n      // Wait for completion\n      return new Promise((resolve, reject) => {\n        const checkCompletion = async () => {\n          const updatedRun = await jobHandle.getRun(run.id)\n          if (!updatedRun) {\n            reject(new Error('Run not found'))\n            return\n          }\n\n          if (updatedRun.status === 'completed') {\n            resolve({ runId: run.id, output: updatedRun.output as TOutput })\n          } else if (updatedRun.status === 'failed') {\n            reject(new Error(updatedRun.error ?? 'Job failed'))\n          } else if (updatedRun.status === 'cancelled') {\n            reject(new Error('Job cancelled'))\n          } else {\n            // Still running, check again\n            setTimeout(checkCompletion, 50)\n          }\n        }\n        checkCompletion()\n      })\n    },\n    [durably],\n  )\n\n  const reset = useCallback(() => {\n    setStatus(null)\n    setOutput(null)\n    setError(null)\n    setLogs([])\n    setProgress(null)\n    setCurrentRunId(null)\n  }, [])\n\n  return {\n    trigger,\n    triggerAndWait,\n    status,\n    output,\n    error,\n    logs,\n    progress,\n    isRunning: status === 'running',\n    isPending: status === 'pending',\n    isCompleted: status === 'completed',\n    isFailed: status === 'failed',\n    isCancelled: status === 'cancelled',\n    currentRunId,\n    reset,\n  }\n}\n","import type { Durably } from '@coji/durably'\nimport { useEffect, useRef, useState } from 'react'\nimport type { LogEntry, Progress, RunStatus } from '../types'\n\nexport interface RunSubscriptionState<TOutput = unknown> {\n  status: RunStatus | null\n  output: TOutput | null\n  error: string | null\n  logs: LogEntry[]\n  progress: Progress | null\n}\n\nexport interface UseRunSubscriptionOptions {\n  /**\n   * Maximum number of logs to keep (0 = unlimited)\n   */\n  maxLogs?: number\n}\n\nexport interface UseRunSubscriptionResult<\n  TOutput = unknown,\n> extends RunSubscriptionState<TOutput> {\n  /**\n   * Clear all logs\n   */\n  clearLogs: () => void\n  /**\n   * Reset all state\n   */\n  reset: () => void\n}\n\n/**\n * Internal hook for subscribing to run events.\n * Shared by useJob, useJobRun, and useJobLogs.\n */\nexport function useRunSubscription<TOutput = unknown>(\n  durably: Durably | null,\n  runId: string | null,\n  options?: UseRunSubscriptionOptions,\n): UseRunSubscriptionResult<TOutput> {\n  const [status, setStatus] = useState<RunStatus | null>(null)\n  const [output, setOutput] = useState<TOutput | null>(null)\n  const [error, setError] = useState<string | null>(null)\n  const [logs, setLogs] = useState<LogEntry[]>([])\n  const [progress, setProgress] = useState<Progress | null>(null)\n\n  // Use ref to track the latest runId for event filtering\n  const runIdRef = useRef<string | null>(runId)\n  runIdRef.current = runId\n\n  const maxLogs = options?.maxLogs ?? 0\n\n  // Subscribe to events\n  useEffect(() => {\n    if (!durably || !runId) return\n\n    const unsubscribes: (() => void)[] = []\n\n    unsubscribes.push(\n      durably.on('run:start', (event) => {\n        if (event.runId !== runIdRef.current) return\n        setStatus('running')\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:complete', (event) => {\n        if (event.runId !== runIdRef.current) return\n        setStatus('completed')\n        setOutput(event.output as TOutput)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:fail', (event) => {\n        if (event.runId !== runIdRef.current) return\n        setStatus('failed')\n        setError(event.error)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:cancel', (event) => {\n        if (event.runId !== runIdRef.current) return\n        setStatus('cancelled')\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:retry', (event) => {\n        if (event.runId !== runIdRef.current) return\n        setStatus('pending')\n        setError(null)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('run:progress', (event) => {\n        if (event.runId !== runIdRef.current) return\n        setProgress(event.progress)\n      }),\n    )\n\n    unsubscribes.push(\n      durably.on('log:write', (event) => {\n        if (event.runId !== runIdRef.current) return\n        setLogs((prev) => {\n          const newLog: LogEntry = {\n            id: crypto.randomUUID(),\n            runId: event.runId,\n            stepName: event.stepName,\n            level: event.level,\n            message: event.message,\n            data: event.data,\n            timestamp: new Date().toISOString(),\n          }\n          const newLogs = [...prev, newLog]\n          // Apply maxLogs limit if set\n          if (maxLogs > 0 && newLogs.length > maxLogs) {\n            return newLogs.slice(-maxLogs)\n          }\n          return newLogs\n        })\n      }),\n    )\n\n    return () => {\n      for (const unsubscribe of unsubscribes) {\n        unsubscribe()\n      }\n    }\n  }, [durably, runId, maxLogs])\n\n  const clearLogs = () => {\n    setLogs([])\n  }\n\n  const reset = () => {\n    setStatus(null)\n    setOutput(null)\n    setError(null)\n    setLogs([])\n    setProgress(null)\n  }\n\n  return {\n    status,\n    output,\n    error,\n    logs,\n    progress,\n    clearLogs,\n    reset,\n  }\n}\n","import { useDurably } from '../context'\nimport type { LogEntry } from '../types'\nimport { useRunSubscription } from './use-run-subscription'\n\nexport interface UseJobLogsOptions {\n  /**\n   * The run ID to subscribe to logs for\n   */\n  runId: string | null\n  /**\n   * Maximum number of logs to keep (default: unlimited)\n   */\n  maxLogs?: number\n}\n\nexport interface UseJobLogsResult {\n  /**\n   * Logs collected during execution\n   */\n  logs: LogEntry[]\n  /**\n   * Clear all logs\n   */\n  clearLogs: () => void\n}\n\n/**\n * Hook for subscribing to logs from a run.\n * Use this when you only need logs, not full run status.\n */\nexport function useJobLogs(options: UseJobLogsOptions): UseJobLogsResult {\n  const { durably } = useDurably()\n  const { runId, maxLogs } = options\n\n  const subscription = useRunSubscription(durably, runId, { maxLogs })\n\n  return {\n    logs: subscription.logs,\n    clearLogs: subscription.clearLogs,\n  }\n}\n","import { useEffect, useRef } from 'react'\nimport { useDurably } from '../context'\nimport type { LogEntry, Progress, RunStatus } from '../types'\nimport { useRunSubscription } from './use-run-subscription'\n\nexport interface UseJobRunOptions {\n  /**\n   * The run ID to subscribe to\n   */\n  runId: string | null\n}\n\nexport interface UseJobRunResult<TOutput = unknown> {\n  /**\n   * Current run status\n   */\n  status: RunStatus | null\n  /**\n   * Output from completed run\n   */\n  output: TOutput | null\n  /**\n   * Error message from failed run\n   */\n  error: string | null\n  /**\n   * Logs collected during execution\n   */\n  logs: LogEntry[]\n  /**\n   * Current progress\n   */\n  progress: Progress | null\n  /**\n   * Whether a run is currently running\n   */\n  isRunning: boolean\n  /**\n   * Whether a run is pending\n   */\n  isPending: boolean\n  /**\n   * Whether the run completed successfully\n   */\n  isCompleted: boolean\n  /**\n   * Whether the run failed\n   */\n  isFailed: boolean\n  /**\n   * Whether the run was cancelled\n   */\n  isCancelled: boolean\n}\n\n/**\n * Hook for subscribing to an existing run by ID.\n * Use this when you have a runId and want to track its status.\n */\nexport function useJobRun<TOutput = unknown>(\n  options: UseJobRunOptions,\n): UseJobRunResult<TOutput> {\n  const { durably } = useDurably()\n  const { runId } = options\n\n  const subscription = useRunSubscription<TOutput>(durably, runId)\n\n  // Fetch initial state when runId changes\n  const fetchedRef = useRef<Set<string>>(new Set())\n\n  useEffect(() => {\n    if (!durably || !runId || fetchedRef.current.has(runId)) return\n\n    // Mark as fetched to avoid duplicate fetches\n    fetchedRef.current.add(runId)\n\n    // Try to fetch current run state\n    // Note: We need to use internal APIs or polling here\n    // For now, we rely on event-based updates\n  }, [durably, runId])\n\n  return {\n    status: subscription.status,\n    output: subscription.output,\n    error: subscription.error,\n    logs: subscription.logs,\n    progress: subscription.progress,\n    isRunning: subscription.status === 'running',\n    isPending: subscription.status === 'pending',\n    isCompleted: subscription.status === 'completed',\n    isFailed: subscription.status === 'failed',\n    isCancelled: subscription.status === 'cancelled',\n  }\n}\n","import type { Run } from '@coji/durably'\nimport { useCallback, useEffect, useState } from 'react'\nimport { useDurably } from '../context'\n\nexport interface UseRunsOptions {\n  /**\n   * Filter by job name\n   */\n  jobName?: string\n  /**\n   * Filter by status\n   */\n  status?: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled'\n  /**\n   * Number of runs per page\n   * @default 10\n   */\n  pageSize?: number\n  /**\n   * Subscribe to real-time updates\n   * @default true\n   */\n  realtime?: boolean\n}\n\nexport interface UseRunsResult {\n  /**\n   * List of runs for the current page\n   */\n  runs: Run[]\n  /**\n   * Current page (0-indexed)\n   */\n  page: number\n  /**\n   * Whether there are more pages\n   */\n  hasMore: boolean\n  /**\n   * Whether data is being loaded\n   */\n  isLoading: boolean\n  /**\n   * Go to the next page\n   */\n  nextPage: () => void\n  /**\n   * Go to the previous page\n   */\n  prevPage: () => void\n  /**\n   * Go to a specific page\n   */\n  goToPage: (page: number) => void\n  /**\n   * Refresh the current page\n   */\n  refresh: () => Promise<void>\n}\n\n/**\n * Hook for listing runs with pagination and real-time updates.\n *\n * @example\n * ```tsx\n * function Dashboard() {\n *   const { runs, page, hasMore, nextPage, prevPage, isLoading } = useRuns({\n *     pageSize: 20,\n *   })\n *\n *   return (\n *     <div>\n *       {runs.map(run => (\n *         <div key={run.id}>{run.jobName}: {run.status}</div>\n *       ))}\n *       <button onClick={prevPage} disabled={page === 0}>Prev</button>\n *       <button onClick={nextPage} disabled={!hasMore}>Next</button>\n *     </div>\n *   )\n * }\n * ```\n */\nexport function useRuns(options?: UseRunsOptions): UseRunsResult {\n  const { durably } = useDurably()\n  const pageSize = options?.pageSize ?? 10\n  const realtime = options?.realtime ?? true\n\n  const [runs, setRuns] = useState<Run[]>([])\n  const [page, setPage] = useState(0)\n  const [hasMore, setHasMore] = useState(false)\n  const [isLoading, setIsLoading] = useState(false)\n\n  const refresh = useCallback(async () => {\n    if (!durably) return\n\n    setIsLoading(true)\n    try {\n      const data = await durably.getRuns({\n        jobName: options?.jobName,\n        status: options?.status,\n        limit: pageSize + 1,\n        offset: page * pageSize,\n      })\n      setHasMore(data.length > pageSize)\n      setRuns(data.slice(0, pageSize))\n    } finally {\n      setIsLoading(false)\n    }\n  }, [durably, options?.jobName, options?.status, pageSize, page])\n\n  // Initial fetch and subscribe to events\n  useEffect(() => {\n    if (!durably) return\n\n    refresh()\n\n    if (!realtime) return\n\n    const unsubscribes = [\n      durably.on('run:trigger', refresh),\n      durably.on('run:start', refresh),\n      durably.on('run:complete', refresh),\n      durably.on('run:fail', refresh),\n      durably.on('run:cancel', refresh),\n      durably.on('run:retry', refresh),\n      durably.on('run:progress', refresh),\n      durably.on('step:start', refresh),\n      durably.on('step:complete', refresh),\n    ]\n\n    return () => {\n      for (const unsubscribe of unsubscribes) {\n        unsubscribe()\n      }\n    }\n  }, [durably, refresh, realtime])\n\n  const nextPage = useCallback(() => {\n    if (hasMore) {\n      setPage((p) => p + 1)\n    }\n  }, [hasMore])\n\n  const prevPage = useCallback(() => {\n    setPage((p) => Math.max(0, p - 1))\n  }, [])\n\n  const goToPage = useCallback((newPage: number) => {\n    setPage(Math.max(0, newPage))\n  }, [])\n\n  return {\n    runs,\n    page,\n    hasMore,\n    isLoading,\n    nextPage,\n    prevPage,\n    goToPage,\n    refresh,\n  }\n}\n"],"mappings":"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","names":["useEffect","useRef","useState","useEffect","useRef","useRef","useEffect","useCallback","useEffect","useState","useState","useCallback","useEffect"]}

package/dist/types-BDUvsa8u.d.ts

@@ -0,0 +1,67 @@
+type RunStatus = 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
+interface Progress {
+    current: number;
+    total?: number;
+    message?: string;
+}
+interface LogEntry {
+    id: string;
+    runId: string;
+    stepName: string | null;
+    level: 'info' | 'warn' | 'error';
+    message: string;
+    data: unknown;
+    timestamp: string;
+}
+type DurablyEvent = {
+    type: 'run:start';
+    runId: string;
+    jobName: string;
+    payload: unknown;
+} | {
+    type: 'run:complete';
+    runId: string;
+    jobName: string;
+    output: unknown;
+    duration: number;
+} | {
+    type: 'run:fail';
+    runId: string;
+    jobName: string;
+    error: string;
+} | {
+    type: 'run:cancel';
+    runId: string;
+    jobName: string;
+} | {
+    type: 'run:retry';
+    runId: string;
+    jobName: string;
+} | {
+    type: 'run:progress';
+    runId: string;
+    jobName: string;
+    progress: Progress;
+} | {
+    type: 'step:start';
+    runId: string;
+    jobName: string;
+    stepName: string;
+    stepIndex: number;
+} | {
+    type: 'step:complete';
+    runId: string;
+    jobName: string;
+    stepName: string;
+    stepIndex: number;
+    output: unknown;
+} | {
+    type: 'log:write';
+    runId: string;
+    jobName: string;
+    level: 'info' | 'warn' | 'error';
+    message: string;
+    data: unknown;
+};
+
+export type { DurablyEvent as D, LogEntry as L, Progress as P, RunStatus as R };

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@coji/durably-react",
+  "version": "0.6.0",
+  "description": "React bindings for Durably - step-oriented resumable batch execution",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "react",
+    "hooks",
+    "durably",
+    "batch",
+    "job",
+    "queue",
+    "workflow",
+    "durable"
+  ],
+  "author": "coji",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/coji/durably.git"
+  },
+  "bugs": {
+    "url": "https://github.com/coji/durably/issues"
+  },
+  "homepage": "https://github.com/coji/durably#readme",
+  "peerDependencies": {
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@coji/durably": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.10",
+    "@testing-library/react": "^16.3.1",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.2",
+    "@vitest/browser": "^4.0.16",
+    "@vitest/browser-playwright": "4.0.16",
+    "kysely": "^0.28.9",
+    "playwright": "^1.57.0",
+    "prettier": "^3.7.4",
+    "prettier-plugin-organize-imports": "^4.3.0",
+    "react": "^19.2.3",
+    "react-dom": "^19.2.3",
+    "sqlocal": "^0.16.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.16",
+    "zod": "^4.3.4",
+    "@coji/durably": "0.6.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "pnpm test:react",
+    "test:react": "vitest run --config vitest.config.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "format": "prettier --experimental-cli --check .",
+    "format:fix": "prettier --experimental-cli --write ."
+  }
+}