@lunora/react 1.0.0-alpha.26 → 1.0.0-alpha.27

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { ReactNode, ReactElement } from 'react';
-import { LunoraClient, OptimisticUpdate, User, FunctionReference, ClientQueryRef, ConnectionStatus, ReturnOf, ArgsOf, MutatorHandle, Preloaded } from '@lunora/client';
-export { type ArgsOf, type ClientQueryRef, type FunctionReference, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';
+import { LunoraClient, OptimisticUpdate, User, FunctionReference, ClientQueryRef, ConnectionStatus, ArgsOf, ReturnOf, HttpStreamRef, HttpStreamArgsOf, HttpStreamChunkOf, MutatorHandle, Preloaded } from '@lunora/client';
+export { type ArgsOf, type ClientQueryRef, type FunctionReference, type HttpStreamArgsOf, type HttpStreamChunkOf, type HttpStreamRef, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';
 import { QueryClient } from '@tanstack/react-query';
 export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-D4okOpO8.mjs";
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -679,6 +679,65 @@ declare const useFlag: <T extends FlagValue>(key: string, defaultValue: T, conte
 * changes between renders.
 */
 declare const useFlags: <T extends Record<string, FlagValue>>(flags: T, context?: FlagContext) => T;
+/** The lifecycle of a stream the hook is observing. */
+type UseStreamStatus = "complete" | "error" | "idle" | "streaming";
+interface UseStreamResult<T> {
+  /** Force-cancel the stream and resolve the iterator. Safe to call multiple times. */
+  cancel: () => void;
+  /** Chunks the server has pushed so far, in arrival order. */
+  chunks: ReadonlyArray<T>;
+  error: Error | undefined;
+  status: UseStreamStatus;
+}
+interface UseStreamOptions {
+  /** Forwarded to `client.stream()` — caps the in-flight chunk buffer. */
+  maxBuffer?: number;
+  shardKey?: string;
+}
+/**
+* Subscribe to a streaming query. Returns the chunks pushed so far plus a
+* lifecycle status and a cancel function. Changing `fn` or the serialized
+* `args` resets the stream — the previous iterator is cancelled and a fresh
+* one opens with empty `chunks`.
+*
+* Pass `"skip"` for `args` to keep the hook mounted without opening a stream
+* (mirrors `useQuery` / `useSubscription`).
+*/
+declare const useStream: <F extends FunctionReference<"stream">>(function_: F, args: "skip" | ArgsOf<F>, options?: UseStreamOptions) => UseStreamResult<ReturnOf<F>>;
+/**
+* Result shape returned by {@link useHttpStream}.
+* @experimental Part of the HTTP-SSE stream surface.
+*/
+interface UseHttpStreamResult<T> {
+  /** Force-cancel the stream (aborts the fetch) and resolve the iterator. Safe to call multiple times. */
+  cancel: () => void;
+  /** Chunks the server has pushed so far, in arrival order. */
+  chunks: ReadonlyArray<T>;
+  error: Error | undefined;
+  status: UseStreamStatus;
+}
+/**
+* Options accepted by {@link useHttpStream}.
+* @experimental Part of the HTTP-SSE stream surface.
+*/
+interface UseHttpStreamOptions {
+  /** Forwarded to `client.httpStream()` — caps the in-flight chunk buffer. */
+  maxBuffer?: number;
+}
+/**
+* Consume an **HTTP-SSE route stream** (`httpRoute.&lt;verb>(path).stream()`) via
+* `client.httpStream`. Distinct from `useStream`, which consumes the WS
+* procedure stream (`kind: "stream"`). Returns the chunks received so far plus
+* a lifecycle status and a cancel function. Changing the route or the
+* serialized `args` resets the stream — the previous fetch is aborted (the
+* server sees `request.signal`) and a fresh one opens with empty `chunks`.
+* Unmount also aborts.
+*
+* Pass `"skip"` for `args` to keep the hook mounted without opening a stream
+* (mirrors `useQuery` / `useStream`).
+* @experimental Reconnect/POST-body/wire-fidelity design questions are still open, so the shape may change.
+*/
+declare const useHttpStream: <Ref extends HttpStreamRef>(route: Ref, args: "skip" | HttpStreamArgsOf<Ref>, options?: UseHttpStreamOptions) => UseHttpStreamResult<HttpStreamChunkOf<Ref>>;
 /** The args a paginated query exposes minus the framework-supplied page cursor. */
 type PaginatedArgs<F> = Omit<ArgsOf<F>, "paginationOpts">;
 /** The element type of the `page` array a paginated query returns. */
@@ -942,31 +1001,6 @@ interface UseRateLimitResult {
 * `useMemo`) so the `consume`/`check` callbacks keep a steady identity.
 */
 declare const useRateLimit: (config: RateLimitConfig, options?: UseRateLimitOptions) => UseRateLimitResult;
-/** The lifecycle of a stream the hook is observing. */
-type UseStreamStatus = "complete" | "error" | "idle" | "streaming";
-interface UseStreamResult<T> {
-  /** Force-cancel the stream and resolve the iterator. Safe to call multiple times. */
-  cancel: () => void;
-  /** Chunks the server has pushed so far, in arrival order. */
-  chunks: ReadonlyArray<T>;
-  error: Error | undefined;
-  status: UseStreamStatus;
-}
-interface UseStreamOptions {
-  /** Forwarded to `client.stream()` — caps the in-flight chunk buffer. */
-  maxBuffer?: number;
-  shardKey?: string;
-}
-/**
-* Subscribe to a streaming query. Returns the chunks pushed so far plus a
-* lifecycle status and a cancel function. Changing `fn` or the serialized
-* `args` resets the stream — the previous iterator is cancelled and a fresh
-* one opens with empty `chunks`.
-*
-* Pass `"skip"` for `args` to keep the hook mounted without opening a stream
-* (mirrors `useQuery` / `useSubscription`).
-*/
-declare const useStream: <F extends FunctionReference<"stream">>(function_: F, args: "skip" | ArgsOf<F>, options?: UseStreamOptions) => UseStreamResult<ReturnOf<F>>;
 /**
 * Subscribe to a real-time stream from the server. Unlike `useQuery`, this
 * hook does not issue an initial HTTP fetch — it only delivers values that
@@ -1120,4 +1154,4 @@ interface UseVoiceAgentResult {
 * `createSocket`) so the hook is drivable outside a browser.
 */
 declare const useVoiceAgent: (options: UseVoiceAgentOptions) => UseVoiceAgentResult;
-export { type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type MutatorHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseCheckoutResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthState, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };
+export { type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type MutatorHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseCheckoutResult, type UseHttpStreamOptions, type UseHttpStreamResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthState, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useHttpStream, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { ReactNode, ReactElement } from 'react';
-import { LunoraClient, OptimisticUpdate, User, FunctionReference, ClientQueryRef, ConnectionStatus, ReturnOf, ArgsOf, MutatorHandle, Preloaded } from '@lunora/client';
-export { type ArgsOf, type ClientQueryRef, type FunctionReference, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';
+import { LunoraClient, OptimisticUpdate, User, FunctionReference, ClientQueryRef, ConnectionStatus, ArgsOf, ReturnOf, HttpStreamRef, HttpStreamArgsOf, HttpStreamChunkOf, MutatorHandle, Preloaded } from '@lunora/client';
+export { type ArgsOf, type ClientQueryRef, type FunctionReference, type HttpStreamArgsOf, type HttpStreamChunkOf, type HttpStreamRef, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';
 import { QueryClient } from '@tanstack/react-query';
 export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-D4okOpO8.js";
 import { PaginationStatus } from '@lunora/client/pagination';
@@ -679,6 +679,65 @@ declare const useFlag: <T extends FlagValue>(key: string, defaultValue: T, conte
 * changes between renders.
 */
 declare const useFlags: <T extends Record<string, FlagValue>>(flags: T, context?: FlagContext) => T;
+/** The lifecycle of a stream the hook is observing. */
+type UseStreamStatus = "complete" | "error" | "idle" | "streaming";
+interface UseStreamResult<T> {
+  /** Force-cancel the stream and resolve the iterator. Safe to call multiple times. */
+  cancel: () => void;
+  /** Chunks the server has pushed so far, in arrival order. */
+  chunks: ReadonlyArray<T>;
+  error: Error | undefined;
+  status: UseStreamStatus;
+}
+interface UseStreamOptions {
+  /** Forwarded to `client.stream()` — caps the in-flight chunk buffer. */
+  maxBuffer?: number;
+  shardKey?: string;
+}
+/**
+* Subscribe to a streaming query. Returns the chunks pushed so far plus a
+* lifecycle status and a cancel function. Changing `fn` or the serialized
+* `args` resets the stream — the previous iterator is cancelled and a fresh
+* one opens with empty `chunks`.
+*
+* Pass `"skip"` for `args` to keep the hook mounted without opening a stream
+* (mirrors `useQuery` / `useSubscription`).
+*/
+declare const useStream: <F extends FunctionReference<"stream">>(function_: F, args: "skip" | ArgsOf<F>, options?: UseStreamOptions) => UseStreamResult<ReturnOf<F>>;
+/**
+* Result shape returned by {@link useHttpStream}.
+* @experimental Part of the HTTP-SSE stream surface.
+*/
+interface UseHttpStreamResult<T> {
+  /** Force-cancel the stream (aborts the fetch) and resolve the iterator. Safe to call multiple times. */
+  cancel: () => void;
+  /** Chunks the server has pushed so far, in arrival order. */
+  chunks: ReadonlyArray<T>;
+  error: Error | undefined;
+  status: UseStreamStatus;
+}
+/**
+* Options accepted by {@link useHttpStream}.
+* @experimental Part of the HTTP-SSE stream surface.
+*/
+interface UseHttpStreamOptions {
+  /** Forwarded to `client.httpStream()` — caps the in-flight chunk buffer. */
+  maxBuffer?: number;
+}
+/**
+* Consume an **HTTP-SSE route stream** (`httpRoute.&lt;verb>(path).stream()`) via
+* `client.httpStream`. Distinct from `useStream`, which consumes the WS
+* procedure stream (`kind: "stream"`). Returns the chunks received so far plus
+* a lifecycle status and a cancel function. Changing the route or the
+* serialized `args` resets the stream — the previous fetch is aborted (the
+* server sees `request.signal`) and a fresh one opens with empty `chunks`.
+* Unmount also aborts.
+*
+* Pass `"skip"` for `args` to keep the hook mounted without opening a stream
+* (mirrors `useQuery` / `useStream`).
+* @experimental Reconnect/POST-body/wire-fidelity design questions are still open, so the shape may change.
+*/
+declare const useHttpStream: <Ref extends HttpStreamRef>(route: Ref, args: "skip" | HttpStreamArgsOf<Ref>, options?: UseHttpStreamOptions) => UseHttpStreamResult<HttpStreamChunkOf<Ref>>;
 /** The args a paginated query exposes minus the framework-supplied page cursor. */
 type PaginatedArgs<F> = Omit<ArgsOf<F>, "paginationOpts">;
 /** The element type of the `page` array a paginated query returns. */
@@ -942,31 +1001,6 @@ interface UseRateLimitResult {
 * `useMemo`) so the `consume`/`check` callbacks keep a steady identity.
 */
 declare const useRateLimit: (config: RateLimitConfig, options?: UseRateLimitOptions) => UseRateLimitResult;
-/** The lifecycle of a stream the hook is observing. */
-type UseStreamStatus = "complete" | "error" | "idle" | "streaming";
-interface UseStreamResult<T> {
-  /** Force-cancel the stream and resolve the iterator. Safe to call multiple times. */
-  cancel: () => void;
-  /** Chunks the server has pushed so far, in arrival order. */
-  chunks: ReadonlyArray<T>;
-  error: Error | undefined;
-  status: UseStreamStatus;
-}
-interface UseStreamOptions {
-  /** Forwarded to `client.stream()` — caps the in-flight chunk buffer. */
-  maxBuffer?: number;
-  shardKey?: string;
-}
-/**
-* Subscribe to a streaming query. Returns the chunks pushed so far plus a
-* lifecycle status and a cancel function. Changing `fn` or the serialized
-* `args` resets the stream — the previous iterator is cancelled and a fresh
-* one opens with empty `chunks`.
-*
-* Pass `"skip"` for `args` to keep the hook mounted without opening a stream
-* (mirrors `useQuery` / `useSubscription`).
-*/
-declare const useStream: <F extends FunctionReference<"stream">>(function_: F, args: "skip" | ArgsOf<F>, options?: UseStreamOptions) => UseStreamResult<ReturnOf<F>>;
 /**
 * Subscribe to a real-time stream from the server. Unlike `useQuery`, this
 * hook does not issue an initial HTTP fetch — it only delivers values that
@@ -1120,4 +1154,4 @@ interface UseVoiceAgentResult {
 * `createSocket`) so the hook is drivable outside a browser.
 */
 declare const useVoiceAgent: (options: UseVoiceAgentOptions) => UseVoiceAgentResult;
-export { type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type MutatorHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseCheckoutResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthState, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };
+export { type AgentChatMessage, type AgentLiveEvent, type AgentProgressEvent, type AgentThreadRecord, type AgentThreadStatus, type AgentTokenDelta, type AgentToolEvent, AuthLoading, type AuthState, Authenticated, CheckoutButton, type CheckoutButtonProps, CustomerPortalButton, type CustomerPortalButtonProps, type FlagContext, type FlagValue, type HeartbeatReference, type ListPresentReference, LunoraProvider, type LunoraProviderProps, type MutationHook, type MutatorHook, type PageItemOf, type PaginatedArgs, type RedirectTarget, type RedirectTrigger, type Subscription, Unauthenticated, type UseAgentApi, type UseAgentChatApi, type UseAgentChatOptions, type UseAgentChatResult, type UseAgentOptions, type UseAgentResult, type UseAgentStateApi, type UseAgentStateOptions, type UseAgentStateResult, type UseAgentToolEventsApi, type UseAgentToolEventsOptions, type UseAgentToolEventsResult, type UseAuthResult, type UseCheckoutResult, type UseHttpStreamOptions, type UseHttpStreamResult, type UseInfiniteQueryOptions, type UseInfiniteQueryResult, type UseMutationCallOptions, type UsePaginatedQueryOptions, type UsePaginatedQueryResult, type UsePresenceOptions, type UsePresenceResult, type UseQueryOptions, type UseRateLimitOptions, type UseRateLimitResult, type UseStreamOptions, type UseStreamResult, type UseStreamStatus, type UseSubscriptionResult, type UseVoiceAgentOptions, type UseVoiceAgentResult, type VoiceAudioFormat, type VoiceReference, type VoiceStatus, hydratePreloaded, useAgent, useAgentChat, useAgentState, useAgentToolEvents, useAuth, useAuthState, useCheckout, useClientQuery, useConnectionStatus, useFlag, useFlags, useHttpStream, useInfiniteQuery, useLunora, useMutation, useMutator, usePaginatedQuery, usePreloadedQuery, usePresence, useQuery, useRateLimit, useStream, useSubscription, useVoiceAgent };

package/dist/index.mjs

@@ -3,24 +3,25 @@ export { AuthLoading, Authenticated, Unauthenticated } from './packem_shared/Aut
 export { useAuthState } from './packem_shared/useAuthState-CyF35qZR.mjs';
 export { LunoraProvider, useLunora } from './packem_shared/LunoraProvider-BsuiW4Lk.mjs';
 export { CheckoutButton, CustomerPortalButton, useCheckout } from './packem_shared/CheckoutButton-DUite8jJ.mjs';
-export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-C3uwOTMW.mjs';
-export { useAgent } from './packem_shared/useAgent-DwLxTc3P.mjs';
-export { useAgentChat } from './packem_shared/useAgentChat-WPm5iHgR.mjs';
-export { useAgentState } from './packem_shared/useAgentState-Cikdlomg.mjs';
-export { useAgentToolEvents } from './packem_shared/useAgentToolEvents-BM7ERo00.mjs';
+export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-CefbPBId.mjs';
+export { useAgent } from './packem_shared/useAgent-BNLlIYHz.mjs';
+export { useAgentChat } from './packem_shared/useAgentChat-CSjKniMO.mjs';
+export { useAgentState } from './packem_shared/useAgentState-Cqyd3Dfy.mjs';
+export { useAgentToolEvents } from './packem_shared/useAgentToolEvents-gF7U4_KY.mjs';
 export { default as useAuth } from './packem_shared/useAuth-BSutjJaa.mjs';
 export { default as useClientQuery } from './packem_shared/useClientQuery-CN1sC3cP.mjs';
 export { default as useConnectionStatus } from './packem_shared/useConnectionStatus-PJ7vyCHy.mjs';
-export { useFlag, useFlags } from './packem_shared/useFlag-C2Pkghli.mjs';
-export { default as useInfiniteQuery } from './packem_shared/useInfiniteQuery-BeaehE9f.mjs';
+export { useFlag, useFlags } from './packem_shared/useFlag-Beyeiq2b.mjs';
+export { useHttpStream } from './packem_shared/useHttpStream-oc4s1pMy.mjs';
+export { default as useInfiniteQuery } from './packem_shared/useInfiniteQuery-CJNw1XaZ.mjs';
 export { useMutation } from './packem_shared/useMutation-BeqeIjTr.mjs';
 export { useMutator } from './packem_shared/useMutator-IIrLtDiM.mjs';
-export { usePaginatedQuery } from './packem_shared/usePaginatedQuery-_6ETVUmf.mjs';
-export { hydratePreloaded, default as usePreloadedQuery } from './packem_shared/hydratePreloaded-uMDH_xA9.mjs';
+export { usePaginatedQuery } from './packem_shared/usePaginatedQuery-DWzydaVR.mjs';
+export { hydratePreloaded, default as usePreloadedQuery } from './packem_shared/hydratePreloaded-2omLtadR.mjs';
 export { usePresence } from './packem_shared/usePresence-Rnx1Fznc.mjs';
-export { default as useQuery } from './packem_shared/useQuery-C-hDzP-t.mjs';
+export { default as useQuery } from './packem_shared/useQuery-CE8_QUgh.mjs';
 export { useRateLimit } from './packem_shared/useRateLimit-DTEffQEi.mjs';
-export { useStream } from './packem_shared/useStream-CGC26afa.mjs';
-export { default as useSubscription } from './packem_shared/useSubscription-D38Jdyr8.mjs';
+export { useStream } from './packem_shared/useStream-GYNgc9J5.mjs';
+export { default as useSubscription } from './packem_shared/useSubscription-DcDlvVuI.mjs';
 export { useVoiceAgent } from './packem_shared/useVoiceAgent-sC5_ADB8.mjs';
 export { createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';

package/dist/packem_shared/{cache-D1O_xfAe.mjs → cache-JeuDAXfE.mjs}

@@ -1,4 +1,4 @@
-import { k as keyHash } from './query-key-BmCbgidV.mjs';
+import { k as keyHash } from './query-key-LGnArBTB.mjs';
 
 class LunoraSubscriptionRegistry {
   constructor(client) {

package/dist/packem_shared/{hydratePreloaded-uMDH_xA9.mjs → hydratePreloaded-2omLtadR.mjs}

@@ -2,9 +2,9 @@
 import { c } from 'react/compiler-runtime';
 import { useQueryClient, useQuery } from '@tanstack/react-query';
 import { useEffect } from 'react';
-import { g as getSubscriptionRegistry } from './cache-D1O_xfAe.mjs';
+import { g as getSubscriptionRegistry } from './cache-JeuDAXfE.mjs';
 import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-BmCbgidV.mjs';
+import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-LGnArBTB.mjs';
 
 const usePreloadedQuery = function(preloaded) {
   const $ = c(4);

package/dist/packem_shared/{lunoraQueryOptions-C3uwOTMW.mjs → lunoraQueryOptions-CefbPBId.mjs}

@@ -1,4 +1,4 @@
-import { l as lunoraQueryKey } from './query-key-BmCbgidV.mjs';
+import { l as lunoraQueryKey } from './query-key-LGnArBTB.mjs';
 
 const lunoraQueryOptions = (client, function_, args, options = {}) => {
   const argsRecord = args ?? {};

package/dist/packem_shared/{query-key-BmCbgidV.mjs → query-key-LGnArBTB.mjs}

@@ -1,6 +1,6 @@
-import { s as stableStringify } from './stable-key-CGp4e2Ux.mjs';
+import { s as stableWireKey } from './wire-key-Bg8BJ8YM.mjs';
 
-const keyHash = (queryKey) => stableStringify(queryKey);
+const keyHash = (queryKey) => stableWireKey(queryKey);
 const lunoraQueryKey = (function_, args, shardKey) => [
   "lunora",
   function_.__lunoraRef,

package/dist/packem_shared/{stable-key-CGp4e2Ux.mjs → stable-key-DePnevIy.mjs}

@@ -9,7 +9,7 @@ const stableStringify = (value) => {
     return "null";
   }
   if (typeof value === "bigint") {
-    throw new TypeError("stableStringify: cannot use a bigint in a cache key (query/subscription/shape args) — pass it as a string");
+    throw new TypeError("stableStringify: cannot use a bigint in a stable JSON cache key — pass it as a string, or use stableWireKey");
   }
   if (value === null || typeof value !== "object") {
     return JSON.stringify(value);
@@ -20,7 +20,7 @@ const stableStringify = (value) => {
   const proto = Object.getPrototypeOf(value);
   if (proto !== null && proto !== Object.prototype) {
     const name = value.constructor?.name ?? "value";
-    throw new TypeError(`stableStringify: cannot use a ${name} in a cache key (query/subscription/shape args) — only plain objects, arrays, and JSON primitives are supported`);
+    throw new TypeError(`stableStringify: cannot use a ${name} in a stable JSON cache key — only plain objects, arrays, and JSON primitives are supported (wire-typed values key via stableWireKey)`);
   }
   const record = value;
   const keys = Object.keys(record).toSorted(compareKeys);

package/dist/packem_shared/{use-paginated-core-DafedU4l.mjs → use-paginated-core-xxvd1YA0.mjs}

@@ -2,9 +2,9 @@
 import { initialPages, rebalance, derivePaginationStatus, applyLoadMore } from '@lunora/client/pagination';
 import { useQueryClient } from '@tanstack/react-query';
 import { useRef, useReducer, useState, useEffect, useCallback } from 'react';
-import { g as getSubscriptionRegistry } from './cache-D1O_xfAe.mjs';
+import { g as getSubscriptionRegistry } from './cache-JeuDAXfE.mjs';
 import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-BmCbgidV.mjs';
+import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-LGnArBTB.mjs';
 
 const useLazyRef = function(create) {
   const reference = useRef(void 0);

package/dist/packem_shared/{useAgent-DwLxTc3P.mjs → useAgent-BNLlIYHz.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import { c } from 'react/compiler-runtime';
 import { useMutation } from './useMutation-BeqeIjTr.mjs';
-import useSubscription from './useSubscription-D38Jdyr8.mjs';
+import useSubscription from './useSubscription-DcDlvVuI.mjs';
 
 const NO_MUTATION_REF = {
   __lunoraRef: ""

package/dist/packem_shared/{useAgentChat-WPm5iHgR.mjs → useAgentChat-CSjKniMO.mjs}

@@ -2,8 +2,8 @@
 import { c } from 'react/compiler-runtime';
 import { useState, useRef } from 'react';
 import { useMutation } from './useMutation-BeqeIjTr.mjs';
-import { useStream } from './useStream-CGC26afa.mjs';
-import useSubscription from './useSubscription-D38Jdyr8.mjs';
+import { useStream } from './useStream-GYNgc9J5.mjs';
+import useSubscription from './useSubscription-DcDlvVuI.mjs';
 
 const NO_MUTATION_REF = {
   __lunoraRef: ""

package/dist/packem_shared/{useAgentState-Cikdlomg.mjs → useAgentState-Cqyd3Dfy.mjs}

@@ -1,6 +1,6 @@
 'use client';
 import { c } from 'react/compiler-runtime';
-import useSubscription from './useSubscription-D38Jdyr8.mjs';
+import useSubscription from './useSubscription-DcDlvVuI.mjs';
 
 const useAgentState = (options) => {
   const $ = c(5);

package/dist/packem_shared/{useAgentToolEvents-BM7ERo00.mjs → useAgentToolEvents-gF7U4_KY.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import { c } from 'react/compiler-runtime';
-import { useStream } from './useStream-CGC26afa.mjs';
-import useSubscription from './useSubscription-D38Jdyr8.mjs';
+import { useStream } from './useStream-GYNgc9J5.mjs';
+import useSubscription from './useSubscription-DcDlvVuI.mjs';
 
 const NO_STREAM_REF = {
   __lunoraRef: ""

package/dist/packem_shared/{useFlag-C2Pkghli.mjs → useFlag-Beyeiq2b.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import { useState, useRef, useEffect } from 'react';
 import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as stableStringify } from './stable-key-CGp4e2Ux.mjs';
+import { s as stableStringify } from './stable-key-DePnevIy.mjs';
 
 const FLAGS_EVAL_PATH = "__lunora_flags__:eval";
 const flagKind = (value) => {

package/dist/packem_shared/useHttpStream-oc4s1pMy.mjs

@@ -0,0 +1,127 @@
+'use client';
+import { useReducer, useRef, useEffect } from 'react';
+import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
+import { s as stableStringify } from './stable-key-DePnevIy.mjs';
+
+const reducer = function(state, action) {
+  switch (action.type) {
+    case "chunk": {
+      return {
+        chunks: [...state.chunks, action.chunk],
+        error: void 0,
+        status: "streaming"
+      };
+    }
+    case "complete": {
+      return {
+        ...state,
+        status: "complete"
+      };
+    }
+    case "error": {
+      return {
+        ...state,
+        error: action.error,
+        status: "error"
+      };
+    }
+    case "reset": {
+      return {
+        chunks: [],
+        error: void 0,
+        status: "idle"
+      };
+    }
+    case "start": {
+      return {
+        ...state,
+        status: "streaming"
+      };
+    }
+    default: {
+      return state;
+    }
+  }
+};
+const useHttpStream = (route, args, options = {}) => {
+  const client = useLunora();
+  const [state, dispatch] = useReducer(reducer, {
+    chunks: [],
+    error: void 0,
+    status: "idle"
+  });
+  const skipped = args === "skip";
+  const serialized = skipped ? "skip" : stableStringify(args);
+  const cancelRef = useRef(void 0);
+  useEffect(() => {
+    if (skipped) {
+      dispatch({
+        type: "reset"
+      });
+      return () => {
+      };
+    }
+    dispatch({
+      type: "reset"
+    });
+    dispatch({
+      type: "start"
+    });
+    let stillMounted = true;
+    let cancelled = false;
+    const iterable = client.httpStream(route, args, {
+      maxBuffer: options.maxBuffer
+    });
+    const cancel = () => {
+      if (cancelled) {
+        return;
+      }
+      cancelled = true;
+      iterable.cancel();
+    };
+    cancelRef.current = cancel;
+    (async () => {
+      try {
+        for await (const chunk of iterable) {
+          if (!stillMounted) {
+            return;
+          }
+          dispatch({
+            chunk,
+            type: "chunk"
+          });
+        }
+        if (stillMounted) {
+          dispatch({
+            type: "complete"
+          });
+        }
+      } catch (error) {
+        if (!stillMounted) {
+          return;
+        }
+        const normalized = error instanceof Error ? error : new Error(String(error));
+        dispatch({
+          error: normalized,
+          type: "error"
+        });
+      }
+    })().catch(() => {
+    });
+    return () => {
+      stillMounted = false;
+      cancel();
+      cancelRef.current = void 0;
+    };
+  }, [client, route.method, route.path, serialized, skipped, options.maxBuffer]);
+  return {
+    cancel: () => {
+      cancelRef.current?.();
+    },
+    chunks: state.chunks,
+    error: state.error,
+    status: state.status
+  };
+};
+
+export { useHttpStream };

package/dist/packem_shared/{useInfiniteQuery-BeaehE9f.mjs → useInfiniteQuery-CJNw1XaZ.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import { c } from 'react/compiler-runtime';
 import { useRef, useEffect } from 'react';
-import { u as usePaginatedCore } from './use-paginated-core-DafedU4l.mjs';
+import { u as usePaginatedCore } from './use-paginated-core-xxvd1YA0.mjs';
 
 const useInfiniteQuery = (function_, args, options) => {
   const $ = c(15);

package/dist/packem_shared/{usePaginatedQuery-_6ETVUmf.mjs → usePaginatedQuery-DWzydaVR.mjs}

@@ -1,6 +1,6 @@
 'use client';
 import { c } from 'react/compiler-runtime';
-import { u as usePaginatedCore } from './use-paginated-core-DafedU4l.mjs';
+import { u as usePaginatedCore } from './use-paginated-core-xxvd1YA0.mjs';
 
 const usePaginatedQuery = (function_, args, options) => {
   const $ = c(7);

package/dist/packem_shared/{useQuery-C-hDzP-t.mjs → useQuery-CE8_QUgh.mjs}

@@ -2,9 +2,9 @@
 import { c } from 'react/compiler-runtime';
 import { useQueryClient, useQuery as useQuery$1 } from '@tanstack/react-query';
 import { useState, useEffect } from 'react';
-import { g as getSubscriptionRegistry } from './cache-D1O_xfAe.mjs';
+import { g as getSubscriptionRegistry } from './cache-JeuDAXfE.mjs';
 import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-BmCbgidV.mjs';
+import { s as serializeQueryKey, l as lunoraQueryKey } from './query-key-LGnArBTB.mjs';
 
 const useQuery = (function_, args, t0) => {
   const $ = c(9);

package/dist/packem_shared/{useStream-CGC26afa.mjs → useStream-GYNgc9J5.mjs}

@@ -1,7 +1,7 @@
 'use client';
 import { useReducer, useRef, useEffect } from 'react';
 import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as stableStringify } from './stable-key-CGp4e2Ux.mjs';
+import { s as stableWireKey } from './wire-key-Bg8BJ8YM.mjs';
 
 const reducer = function(state, action) {
   switch (action.type) {
@@ -51,7 +51,7 @@ const useStream = (function_, args, options = {}) => {
     status: "idle"
   });
   const skipped = args === "skip";
-  const serialized = skipped ? "skip" : stableStringify(args);
+  const serialized = skipped ? "skip" : stableWireKey(args);
   const cancelRef = useRef(void 0);
   useEffect(() => {
     if (skipped) {

package/dist/packem_shared/{useSubscription-D38Jdyr8.mjs → useSubscription-DcDlvVuI.mjs}

@@ -3,7 +3,7 @@ import { c } from 'react/compiler-runtime';
 import { createQuerySubscription } from '@lunora/client/query';
 import { useState, useRef, useEffect } from 'react';
 import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
-import { s as stableStringify } from './stable-key-CGp4e2Ux.mjs';
+import { s as stableWireKey } from './wire-key-Bg8BJ8YM.mjs';
 
 const useSubscription = (function_, args, t0) => {
   const $ = c(22);
@@ -31,7 +31,7 @@ const useSubscription = (function_, args, t0) => {
   const skipped = args === "skip";
   let t3;
   if ($[3] !== args || $[4] !== skipped) {
-    t3 = skipped ? "skip" : stableStringify(args);
+    t3 = skipped ? "skip" : stableWireKey(args);
     $[3] = args;
     $[4] = skipped;
     $[5] = t3;

package/dist/packem_shared/wire-key-Bg8BJ8YM.mjs

@@ -0,0 +1,101 @@
+import { s as stableStringify } from './stable-key-DePnevIy.mjs';
+
+const toBase64 = (bytes) => {
+  let binary = "";
+  const chunk = 32768;
+  for (let index = 0; index < bytes.length; index += chunk) {
+    binary += String.fromCharCode(...bytes.subarray(index, index + chunk));
+  }
+  return btoa(binary);
+};
+
+const TAG = "$lunora.wire$";
+const MAX_DEPTH = 64;
+const encodeWire = (value, depth = 0) => {
+  if (depth > MAX_DEPTH) {
+    throw new RangeError(`wire-codec: value nesting exceeds the ${MAX_DEPTH}-level limit`);
+  }
+  if (value === void 0) {
+    return [TAG, "undefined"];
+  }
+  if (value === null) {
+    return null;
+  }
+  const kind = typeof value;
+  if (kind === "bigint") {
+    return [TAG, "bigint", value.toString()];
+  }
+  if (kind === "number") {
+    const numeric = value;
+    if (Number.isNaN(numeric)) {
+      return [TAG, "nan"];
+    }
+    if (numeric === Infinity) {
+      return [TAG, "inf"];
+    }
+    if (numeric === -Infinity) {
+      return [TAG, "-inf"];
+    }
+    return numeric;
+  }
+  if (kind !== "object") {
+    return value;
+  }
+  if (value instanceof Date) {
+    return [TAG, "date", encodeWire(value.getTime(), depth + 1)];
+  }
+  if (value instanceof Error) {
+    const error = value;
+    const properties = {};
+    for (const key of Object.keys(error)) {
+      if (error[key] !== void 0) {
+        properties[key] = encodeWire(error[key], depth + 1);
+      }
+    }
+    const encodedError = [TAG, "error", error.name, error.message, properties];
+    if (error.cause !== void 0) {
+      encodedError.push(encodeWire(error.cause, depth + 1));
+    }
+    return encodedError;
+  }
+  if (value instanceof URL) {
+    return [TAG, "url", value.href];
+  }
+  if (value instanceof Map) {
+    return [TAG, "map", [...value.entries()].map(([k, v]) => [encodeWire(k, depth + 1), encodeWire(v, depth + 1)])];
+  }
+  if (value instanceof Set) {
+    return [TAG, "set", [...value].map((item) => encodeWire(item, depth + 1))];
+  }
+  if (value instanceof ArrayBuffer) {
+    return [TAG, "bytes", toBase64(new Uint8Array(value)), "ArrayBuffer"];
+  }
+  if (ArrayBuffer.isView(value)) {
+    const view = value;
+    const ctorName = view.constructor.name;
+    const bytes = new Uint8Array(view.buffer, view.byteOffset, view.byteLength);
+    return ctorName === "Uint8Array" ? [TAG, "bytes", toBase64(bytes)] : [TAG, "bytes", toBase64(bytes), ctorName];
+  }
+  if (Array.isArray(value)) {
+    const encoded = value.map((item) => encodeWire(item, depth + 1));
+    return encoded.length > 0 && encoded[0] === TAG ? [TAG, "arr", encoded] : encoded;
+  }
+  const proto = Object.getPrototypeOf(value);
+  if (proto !== null && proto !== Object.prototype) {
+    const name = value.constructor?.name ?? "value";
+    throw new TypeError(`wire-codec: cannot encode a ${name} over the Lunora wire — only plain objects, arrays, and the supported built-ins (Date, Error, URL, Map, Set, ArrayBuffer/typed arrays, bigint) round-trip`);
+  }
+  const source = value;
+  const result = {};
+  for (const key of Object.keys(source)) {
+    const field = source[key];
+    if (field !== void 0) {
+      result[key] = encodeWire(field, depth + 1);
+    }
+  }
+  return result;
+};
+
+const stableWireKey = (value) => stableStringify(encodeWire(value));
+
+export { stableWireKey as s };

package/dist/server.mjs

@@ -1,7 +1,7 @@
 import { createServerClient } from '@lunora/client/ssr';
 export { createServerClient, deserializePreloaded, getServerSession, serializePreloaded } from '@lunora/client/ssr';
-import { l as lunoraQueryKey } from './packem_shared/query-key-BmCbgidV.mjs';
-export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-C3uwOTMW.mjs';
+import { l as lunoraQueryKey } from './packem_shared/query-key-LGnArBTB.mjs';
+export { lunoraQueryOptions } from './packem_shared/lunoraQueryOptions-CefbPBId.mjs';
 export { preloadQuery, preloadedQueryResult } from '@lunora/client';
 export { HydrationBoundary, dehydrate } from '@tanstack/react-query';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react",
-  "version": "1.0.0-alpha.26",
+  "version": "1.0.0-alpha.27",
   "description": "React hooks for Lunora: useQuery, useMutation, useSubscription, and useAuth",
   "keywords": [
     "cloudflare",
@@ -49,9 +49,9 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.22",
-    "@lunora/errors": "1.0.0-alpha.4",
-    "@lunora/ratelimit": "1.0.0-alpha.7"
+    "@lunora/client": "1.0.0-alpha.23",
+    "@lunora/errors": "1.0.0-alpha.5",
+    "@lunora/ratelimit": "1.0.0-alpha.8"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.101.0",