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

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { ReactNode, ReactElement } from 'react';
-import { LunoraClient, OptimisticUpdate, User, FunctionReference, ConnectionStatus, ReturnOf, ArgsOf, MutatorHandle, Preloaded } from '@lunora/client';
-export { type ArgsOf, type FunctionReference, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, 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';
@@ -615,6 +615,31 @@ declare const useAgentToolEvents: (options: UseAgentToolEventsOptions) => UseAge
 * hook with the freshly-resolved user.
 */
 declare const useAuth: () => UseAuthResult;
+type Setter<T> = (value: T) => void;
+/**
+* Subscribe to a local-only {@link ClientQueryRef} and re-render when its
+* value changes. Unlike `useQuery`, this never touches the network — the
+* value lives in a reactive store on the `LunoraClient` instance and is shared
+* across every consumer of the same ref.
+*
+* The initial render reads the store synchronously (via
+* `useSyncExternalStore`), so there is never an "undefined flash" — the value
+* is either the one most recently set or `ref.defaultValue`.
+*
+* Returns a `[value, setter]` tuple, matching the `useState` convention.
+* @example
+* ```tsx
+* import { useClientQuery, createClientQuery } from "@lunora/react";
+*
+* const sidebarOpen = createClientQuery("sidebarOpen", true);
+*
+* function Sidebar() {
+*   const [open, setOpen] = useClientQuery(sidebarOpen);
+*   return <aside data-open={open}>…</aside>;
+* }
+* ```
+*/
+declare const useClientQuery: <T extends unknown>(ref: ClientQueryRef<T>) => [T, Setter<T>];
 /**
 * Reactive view of the client's aggregate live-socket status across all shard
 * connections. Re-renders on every transition (`idle` → `connecting` →
@@ -654,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. */
@@ -871,6 +955,12 @@ declare const usePresence: <H extends HeartbeatReference, L extends ListPresentR
 * Returns `undefined` until the first response lands. Pass `"skip"` for
 * `args` to short-circuit the query (no network call, no subscription).
 *
+* When the `LunoraClient` was created with `hydrateOnStart: true` and a
+* `queryCache` adapter, the first **enabled** render waits for the durable
+* read cache to finish loading. If a cached value exists for this query it
+* is fed as `initialData` so the user sees it immediately — no undefined
+* flash before the socket round-trip.
+*
 * Internally this routes through TanStack Query: the queryKey is
 * `["lunora", fn.__lunoraRef, args, shardKey]` (TanStack hashes structurally
 * so an args object built in a different key order still dedupes). The
@@ -911,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
@@ -1089,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, 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, ConnectionStatus, ReturnOf, ArgsOf, MutatorHandle, Preloaded } from '@lunora/client';
-export { type ArgsOf, type FunctionReference, type LunoraClient, type LunoraErrorCode, type MutatorHandle, type MutatorTransaction, type OptimisticLocalStore, type OptimisticUpdate, type Preloaded, type ReturnOf, type User, 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';
@@ -615,6 +615,31 @@ declare const useAgentToolEvents: (options: UseAgentToolEventsOptions) => UseAge
 * hook with the freshly-resolved user.
 */
 declare const useAuth: () => UseAuthResult;
+type Setter<T> = (value: T) => void;
+/**
+* Subscribe to a local-only {@link ClientQueryRef} and re-render when its
+* value changes. Unlike `useQuery`, this never touches the network — the
+* value lives in a reactive store on the `LunoraClient` instance and is shared
+* across every consumer of the same ref.
+*
+* The initial render reads the store synchronously (via
+* `useSyncExternalStore`), so there is never an "undefined flash" — the value
+* is either the one most recently set or `ref.defaultValue`.
+*
+* Returns a `[value, setter]` tuple, matching the `useState` convention.
+* @example
+* ```tsx
+* import { useClientQuery, createClientQuery } from "@lunora/react";
+*
+* const sidebarOpen = createClientQuery("sidebarOpen", true);
+*
+* function Sidebar() {
+*   const [open, setOpen] = useClientQuery(sidebarOpen);
+*   return <aside data-open={open}>…</aside>;
+* }
+* ```
+*/
+declare const useClientQuery: <T extends unknown>(ref: ClientQueryRef<T>) => [T, Setter<T>];
 /**
 * Reactive view of the client's aggregate live-socket status across all shard
 * connections. Re-renders on every transition (`idle` → `connecting` →
@@ -654,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. */
@@ -871,6 +955,12 @@ declare const usePresence: <H extends HeartbeatReference, L extends ListPresentR
 * Returns `undefined` until the first response lands. Pass `"skip"` for
 * `args` to short-circuit the query (no network call, no subscription).
 *
+* When the `LunoraClient` was created with `hydrateOnStart: true` and a
+* `queryCache` adapter, the first **enabled** render waits for the durable
+* read cache to finish loading. If a cached value exists for this query it
+* is fed as `initialData` so the user sees it immediately — no undefined
+* flash before the socket round-trip.
+*
 * Internally this routes through TanStack Query: the queryKey is
 * `["lunora", fn.__lunoraRef, args, shardKey]` (TanStack hashes structurally
 * so an args object built in a different key order still dedupes). The
@@ -911,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
@@ -1089,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, 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,23 +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-D3_ZxMYs.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 { getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';
+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/useClientQuery-CN1sC3cP.mjs

@@ -0,0 +1,56 @@
+'use client';
+import { c } from 'react/compiler-runtime';
+import { useSyncExternalStore } from 'react';
+import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
+
+const useClientQuery = (ref) => {
+  const $ = c(11);
+  const client = useLunora();
+  let t0;
+  let t1;
+  let t2;
+  if ($[0] !== client || $[1] !== ref) {
+    t0 = (onStoreChange) => {
+      const unsubscribe = client.subscribeClientQuery(ref, () => {
+        onStoreChange();
+      });
+      return unsubscribe;
+    };
+    t1 = () => client.getClientQuery(ref);
+    t2 = () => client.getClientQuery(ref);
+    $[0] = client;
+    $[1] = ref;
+    $[2] = t0;
+    $[3] = t1;
+    $[4] = t2;
+  } else {
+    t0 = $[2];
+    t1 = $[3];
+    t2 = $[4];
+  }
+  const value = useSyncExternalStore(t0, t1, t2);
+  let t3;
+  if ($[5] !== client || $[6] !== ref) {
+    t3 = (next) => {
+      client.setClientQuery(ref, next);
+    };
+    $[5] = client;
+    $[6] = ref;
+    $[7] = t3;
+  } else {
+    t3 = $[7];
+  }
+  const setter = t3;
+  let t4;
+  if ($[8] !== setter || $[9] !== value) {
+    t4 = [value, setter];
+    $[8] = setter;
+    $[9] = value;
+    $[10] = t4;
+  } else {
+    t4 = $[10];
+  }
+  return t4;
+};
+
+export { useClientQuery as default };

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-D3_ZxMYs.mjs → useQuery-CE8_QUgh.mjs}

@@ -1,13 +1,13 @@
 'use client';
 import { c } from 'react/compiler-runtime';
 import { useQueryClient, useQuery as useQuery$1 } from '@tanstack/react-query';
-import { useEffect } from 'react';
-import { g as getSubscriptionRegistry } from './cache-D1O_xfAe.mjs';
+import { useState, useEffect } from 'react';
+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(5);
+  const $ = c(9);
   const options = t0 === void 0 ? {} : t0;
   const client = useLunora();
   const queryClient = useQueryClient();
@@ -17,27 +17,50 @@ const useQuery = (function_, args, t0) => {
   const skipped = args === "skip";
   const argsRecord = skipped ? {} : args;
   const queryKey = lunoraQueryKey(function_, argsRecord, shardKey);
+  const [hydrated, setHydrated] = useState(client.isReady);
+  let t1;
+  let t2;
+  if ($[0] !== client || $[1] !== hydrated) {
+    t1 = () => {
+      if (!hydrated) {
+        client.whenReady().then(() => {
+          setHydrated(true);
+        });
+      }
+    };
+    t2 = [client, hydrated];
+    $[0] = client;
+    $[1] = hydrated;
+    $[2] = t1;
+    $[3] = t2;
+  } else {
+    t1 = $[2];
+    t2 = $[3];
+  }
+  useEffect(t1, t2);
+  const cachedData = skipped ? void 0 : client.peekHydratedQuery(function_.__lunoraRef, argsRecord, shardKey);
   const {
     data
   } = useQuery$1({
-    enabled: !skipped,
+    enabled: !skipped && hydrated,
+    initialData: cachedData,
     queryFn: () => client.query(function_, argsRecord, {
       shardKey
     }),
     queryKey,
     staleTime: Number.POSITIVE_INFINITY
   });
-  const t1 = serializeQueryKey(queryKey);
-  let t2;
-  if ($[0] !== client || $[1] !== queryClient || $[2] !== skipped || $[3] !== t1) {
-    t2 = [client, queryClient, t1, skipped];
-    $[0] = client;
-    $[1] = queryClient;
-    $[2] = skipped;
-    $[3] = t1;
-    $[4] = t2;
+  const t3 = serializeQueryKey(queryKey);
+  let t4;
+  if ($[4] !== client || $[5] !== queryClient || $[6] !== skipped || $[7] !== t3) {
+    t4 = [client, queryClient, t3, skipped];
+    $[4] = client;
+    $[5] = queryClient;
+    $[6] = skipped;
+    $[7] = t3;
+    $[8] = t4;
   } else {
-    t2 = $[4];
+    t4 = $[8];
   }
   useEffect(() => {
     if (skipped) {
@@ -45,7 +68,7 @@ const useQuery = (function_, args, t0) => {
     }
     const registry = getSubscriptionRegistry(client);
     return registry.attach(queryClient, queryKey, function_, argsRecord, shardKey);
-  }, t2);
+  }, t4);
   return skipped ? void 0 : data;
 };
 function _temp() {

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.25",
+  "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.21",
-    "@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",