Renamed useBatch to useRealtimeBatch (#1447)

* Renamed useBatch to useRealtimeBatch

* Use the new hook name in the nextjs-realtime ref

Author: ericallam

.changeset/honest-trains-burn.md

@@ -0,0 +1,5 @@
+---
+"@trigger.dev/react-hooks": patch
+---
+
+useBatch renamed to useRealtimeBatch

packages/react-hooks/src/hooks/useRealtimeBatch.ts

@@ -4,7 +4,21 @@ import { AnyTask, InferRunTypes, TaskRunShape } from "@trigger.dev/core/v3";
 import { useEffect, useState } from "react";
 import { useApiClient } from "./useApiClient.js";
 
-export function useBatch<TTask extends AnyTask>(batchId: string) {
+/**
+ * hook to subscribe to realtime updates of a batch of task runs.
+ *
+ * @template TTask - The type of the task.
+ * @param {string} batchId - The unique identifier of the batch to subscribe to.
+ * @returns {{ runs: TaskRunShape<TTask>[], error: Error | null }} An object containing the current state of the runs and any error encountered.
+ *
+ * @example
+ *
+ * ```ts
+ * import type { myTask } from './path/to/task';
+ * const { runs, error } = useRealtimeBatch<typeof myTask>('batch-id-123');
+ * ```
+ */
+export function useRealtimeBatch<TTask extends AnyTask>(batchId: string) {
   const [runShapes, setRunShapes] = useState<TaskRunShape<TTask>[]>([]);
   const [error, setError] = useState<Error | null>(null);
   const apiClient = useApiClient();

references/nextjs-realtime/src/app/batches/[id]/ClientBatchRunDetails.tsx

@@ -1,7 +1,7 @@
 "use client";
 
 import { Card, CardContent } from "@/components/ui/card";
-import { TriggerAuthContext, useBatch } from "@trigger.dev/react-hooks";
+import { TriggerAuthContext, useRealtimeBatch } from "@trigger.dev/react-hooks";
 import type { exampleTask } from "@/trigger/example";
 
 import { Badge } from "@/components/ui/badge";
@@ -117,7 +117,7 @@ export function BackgroundRunsTable({ runs }: { runs: TaskRunShape<typeof exampl
 }
 
 function BatchRunTableWrapper({ batchId }: { batchId: string }) {
-  const { runs, error } = useBatch<typeof exampleTask>(batchId);
+  const { runs, error } = useRealtimeBatch<typeof exampleTask>(batchId);
 
   console.log(runs);