feat(react): add useEventStream hook for consuming PerstackEvent streams

Add a new useEventStream hook that provides automatic connection management
for PerstackEvent streams. The hook is API-agnostic and accepts an
EventSourceFactory function, allowing it to work with any backend.

Features:
- Automatic connection lifecycle management
- Event processing through useRun hook internally
- Connection state tracking (isConnected, error)
- Proper cleanup on unmount or when disabled
- AbortSignal support for stream cancellation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: FL4TLiN3

.changeset/add-use-event-stream.md

@@ -0,0 +1,14 @@
+---
+"@perstack/react": patch
+---
+
+feat(react): add useEventStream hook for consuming PerstackEvent streams
+
+Added a new `useEventStream` hook that provides automatic connection management for PerstackEvent streams. The hook is API-agnostic and accepts an `EventSourceFactory` function, allowing it to work with any backend that provides PerstackEvent streams.
+
+Features:
+- Automatic connection lifecycle management (connect/disconnect based on `enabled` flag)
+- Event processing through `useRun` hook internally
+- Connection state tracking (`isConnected`, `error`)
+- Proper cleanup on unmount or when disabled
+- AbortSignal support for stream cancellation

packages/react/src/hooks/index.ts

@@ -1,2 +1,9 @@
+export {
+  type EventSourceFactory,
+  type EventStreamOptions,
+  type EventStreamState,
+  type UseEventStreamOptions,
+  useEventStream,
+} from "./use-event-stream.js"
 export { type ActivityProcessState, type RunResult, useRun } from "./use-run.js"
 export { type RuntimeResult, useRuntime } from "./use-runtime.js"