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

package/dist/index.mjs

@@ -5,11 +5,11 @@ export { LunoraProvider, useLunora } from './packem_shared/LunoraProvider-BsuiW4
 export { CheckoutButton, CustomerPortalButton, useCheckout } from './packem_shared/CheckoutButton-DUite8jJ.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 { useAgentChat } from './packem_shared/useAgentChat-0cebQe7-.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 useClientQuery } from './packem_shared/useClientQuery-DIkNT4QA.mjs';
 export { default as useConnectionStatus } from './packem_shared/useConnectionStatus-PJ7vyCHy.mjs';
 export { useFlag, useFlags } from './packem_shared/useFlag-Beyeiq2b.mjs';
 export { useHttpStream } from './packem_shared/useHttpStream-oc4s1pMy.mjs';
@@ -23,5 +23,5 @@ 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-GYNgc9J5.mjs';
 export { default as useSubscription } from './packem_shared/useSubscription-DcDlvVuI.mjs';
-export { useVoiceAgent } from './packem_shared/useVoiceAgent-sC5_ADB8.mjs';
+export { useVoiceAgent } from './packem_shared/useVoiceAgent-w7fzAMSB.mjs';
 export { createClientQuery, getErrorCode, getRetryAfterMs, isConflictError, isForbiddenError, isRateLimitedError, isUnauthorizedError } from '@lunora/client';

package/dist/packem_shared/query-options.d-CdgGQ9s4.d.mts

@@ -0,0 +1,38 @@
+import { FunctionReference, ReturnOf, LunoraClient, ArgsOf } from '@lunora/client';
+import { QueryKey } from '@tanstack/react-query';
+/**
+ * Pure, transport-free adapter between a Lunora function reference and a
+ * TanStack Query options object. No `"use client"` directive and only a
+ * type-level `@lunora/client` import, so it is safe to use on either side of an
+ * RSC boundary (the runtime transport is the `LunoraClient` you pass in).
+ *
+ * Use it when you want to drive a Lunora query through TanStack's own hooks —
+ * `useSuspenseQuery`, `useQueries`, or the server-side
+ * `queryClient.ensureQueryData` / `prefetchQuery` — rather than the first-class
+ * `useQuery` from `@lunora/react`.
+ */
+/** Shape returned by `lunoraQueryOptions`, spread into a TanStack hook. */
+interface LunoraQueryOptions<F extends FunctionReference> {
+  queryFn: () => Promise<ReturnOf<F>>;
+  queryKey: QueryKey;
+  staleTime: number;
+}
+/**
+ * Build a TanStack Query options object for a Lunora query, keyed identically
+ * to the first-class hooks (see `lunoraQueryKey`) so a value fetched through
+ * this adapter shares cache identity with anything `useQuery` /
+ * `prefetchQuery` reads or writes for the same `(fn, args, shardKey)` triple.
+ *
+ * ```ts
+ * const { data } = useSuspenseQuery(lunoraQueryOptions(client, api.posts.list, {}));
+ * ```
+ *
+ * This is a one-shot fetch: it resolves once and `staleTime` is infinite, so
+ * TanStack never refetches on its own. It does not open a WebSocket — for live
+ * updates that re-render on every server push, use `useQuery` from
+ * `@lunora/react`, which attaches a shared subscription to the same cache key.
+ */
+declare const lunoraQueryOptions: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
+  shardKey?: string;
+}) => LunoraQueryOptions<F>;
+export { LunoraQueryOptions as L, lunoraQueryOptions as l };

package/dist/packem_shared/query-options.d-CdgGQ9s4.d.ts

@@ -0,0 +1,38 @@
+import { FunctionReference, ReturnOf, LunoraClient, ArgsOf } from '@lunora/client';
+import { QueryKey } from '@tanstack/react-query';
+/**
+ * Pure, transport-free adapter between a Lunora function reference and a
+ * TanStack Query options object. No `"use client"` directive and only a
+ * type-level `@lunora/client` import, so it is safe to use on either side of an
+ * RSC boundary (the runtime transport is the `LunoraClient` you pass in).
+ *
+ * Use it when you want to drive a Lunora query through TanStack's own hooks —
+ * `useSuspenseQuery`, `useQueries`, or the server-side
+ * `queryClient.ensureQueryData` / `prefetchQuery` — rather than the first-class
+ * `useQuery` from `@lunora/react`.
+ */
+/** Shape returned by `lunoraQueryOptions`, spread into a TanStack hook. */
+interface LunoraQueryOptions<F extends FunctionReference> {
+  queryFn: () => Promise<ReturnOf<F>>;
+  queryKey: QueryKey;
+  staleTime: number;
+}
+/**
+ * Build a TanStack Query options object for a Lunora query, keyed identically
+ * to the first-class hooks (see `lunoraQueryKey`) so a value fetched through
+ * this adapter shares cache identity with anything `useQuery` /
+ * `prefetchQuery` reads or writes for the same `(fn, args, shardKey)` triple.
+ *
+ * ```ts
+ * const { data } = useSuspenseQuery(lunoraQueryOptions(client, api.posts.list, {}));
+ * ```
+ *
+ * This is a one-shot fetch: it resolves once and `staleTime` is infinite, so
+ * TanStack never refetches on its own. It does not open a WebSocket — for live
+ * updates that re-render on every server push, use `useQuery` from
+ * `@lunora/react`, which attaches a shared subscription to the same cache key.
+ */
+declare const lunoraQueryOptions: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
+  shardKey?: string;
+}) => LunoraQueryOptions<F>;
+export { LunoraQueryOptions as L, lunoraQueryOptions as l };

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

@@ -13,18 +13,21 @@ const NO_STREAM_REF = {
 };
 const EMPTY_MESSAGES = [];
 const reconcileOptimistic = (optimistic, durable) => {
-  const pool = durable.filter((message) => message.role === "user").map((message) => message.content);
+  const durableUserRows = durable.filter((message) => message.role === "user");
+  const consumed = /* @__PURE__ */ new Set();
   return optimistic.filter((pending) => {
-    const index = pool.indexOf(pending.content);
-    if (index !== -1) {
-      pool.splice(index, 1);
-      return false;
+    for (let index = pending.durableUserCountAtSend; index < durableUserRows.length; index += 1) {
+      const row = durableUserRows[index];
+      if (row !== void 0 && !consumed.has(index) && row.content === pending.content) {
+        consumed.add(index);
+        return false;
+      }
     }
     return true;
   });
 };
 const useAgentChat = (options) => {
-  const $ = c(47);
+  const $ = c(49);
   const {
     api,
     cancel: cancelReference,
@@ -99,11 +102,24 @@ const useAgentChat = (options) => {
   let t4;
   if ($[9] !== durable || $[10] !== optimistic) {
     const visibleOptimistic = reconcileOptimistic(optimistic, durable);
+    let maxDurableSeq;
+    if ($[12] !== durable) {
+      maxDurableSeq = -1;
+      for (const message of durable) {
+        if (message.seq > maxDurableSeq) {
+          maxDurableSeq = message.seq;
+        }
+      }
+      $[12] = durable;
+      $[13] = maxDurableSeq;
+    } else {
+      maxDurableSeq = $[13];
+    }
     t4 = visibleOptimistic.length === 0 ? durable : [...durable, ...visibleOptimistic.map((pending, index) => ({
       content: pending.content,
       optimistic: true,
       role: "user",
-      seq: durable.length + index
+      seq: maxDurableSeq + 1 + index
     }))];
     $[9] = durable;
     $[10] = optimistic;
@@ -113,32 +129,32 @@ const useAgentChat = (options) => {
   }
   const messages = t4;
   let t5;
-  if ($[12] !== durable) {
+  if ($[14] !== durable) {
     t5 = durable.filter(_temp);
-    $[12] = durable;
-    $[13] = t5;
+    $[14] = durable;
+    $[15] = t5;
   } else {
-    t5 = $[13];
+    t5 = $[15];
   }
   const assistantCount = t5.length;
   let t6;
-  if ($[14] !== assistantCount || $[15] !== chunks || $[16] !== threadKey) {
+  if ($[16] !== assistantCount || $[17] !== chunks || $[18] !== threadKey) {
     let t72;
-    if ($[18] !== assistantCount || $[19] !== threadKey) {
+    if ($[20] !== assistantCount || $[21] !== threadKey) {
       t72 = (event) => event.kind !== "progress" && event.threadKey === threadKey && event.turn >= assistantCount;
-      $[18] = assistantCount;
-      $[19] = threadKey;
-      $[20] = t72;
+      $[20] = assistantCount;
+      $[21] = threadKey;
+      $[22] = t72;
     } else {
-      t72 = $[20];
+      t72 = $[22];
     }
     t6 = chunks.filter(t72).map(_temp2).join("");
-    $[14] = assistantCount;
-    $[15] = chunks;
-    $[16] = threadKey;
-    $[17] = t6;
+    $[16] = assistantCount;
+    $[17] = chunks;
+    $[18] = threadKey;
+    $[19] = t6;
   } else {
-    t6 = $[17];
+    t6 = $[19];
   }
   const streamingText = t6;
   const {
@@ -151,12 +167,14 @@ const useAgentChat = (options) => {
     mutate: resolveMutate
   } = approvalMutation;
   let t7;
-  if ($[21] !== durable || $[22] !== sendArgs || $[23] !== sendMutate || $[24] !== threadKey) {
+  if ($[23] !== durable || $[24] !== sendArgs || $[25] !== sendMutate || $[26] !== threadKey) {
     t7 = async (input, args) => {
       const id = nextIdRef.current;
       nextIdRef.current = nextIdRef.current + 1;
+      const durableUserCountAtSend = durable.filter(_temp3).length;
       setOptimistic((previous) => [...reconcileOptimistic(previous, durable), {
         content: input,
+        durableUserCountAtSend,
         id
       }]);
       try {
@@ -172,17 +190,17 @@ const useAgentChat = (options) => {
         throw error;
       }
     };
-    $[21] = durable;
-    $[22] = sendArgs;
-    $[23] = sendMutate;
-    $[24] = threadKey;
-    $[25] = t7;
+    $[23] = durable;
+    $[24] = sendArgs;
+    $[25] = sendMutate;
+    $[26] = threadKey;
+    $[27] = t7;
   } else {
-    t7 = $[25];
+    t7 = $[27];
   }
   const send = t7;
   let t8;
-  if ($[26] !== instanceId || $[27] !== resolveMutate || $[28] !== threadKey) {
+  if ($[28] !== instanceId || $[29] !== resolveMutate || $[30] !== threadKey) {
     t8 = async (toolCallId, note) => {
       if (instanceId === void 0) {
         throw new Error("useAgentChat: cannot approve — no in-flight run (thread has no instanceId)");
@@ -197,16 +215,16 @@ const useAgentChat = (options) => {
         }
       });
     };
-    $[26] = instanceId;
-    $[27] = resolveMutate;
-    $[28] = threadKey;
-    $[29] = t8;
+    $[28] = instanceId;
+    $[29] = resolveMutate;
+    $[30] = threadKey;
+    $[31] = t8;
   } else {
-    t8 = $[29];
+    t8 = $[31];
   }
   const approve = t8;
   let t9;
-  if ($[30] !== instanceId || $[31] !== resolveMutate || $[32] !== threadKey) {
+  if ($[32] !== instanceId || $[33] !== resolveMutate || $[34] !== threadKey) {
     t9 = async (toolCallId_0, note_0) => {
       if (instanceId === void 0) {
         throw new Error("useAgentChat: cannot reject — no in-flight run (thread has no instanceId)");
@@ -221,16 +239,16 @@ const useAgentChat = (options) => {
         }
       });
     };
-    $[30] = instanceId;
-    $[31] = resolveMutate;
-    $[32] = threadKey;
-    $[33] = t9;
+    $[32] = instanceId;
+    $[33] = resolveMutate;
+    $[34] = threadKey;
+    $[35] = t9;
   } else {
-    t9 = $[33];
+    t9 = $[35];
   }
   const reject = t9;
   let t10;
-  if ($[34] !== cancelMutate || $[35] !== cancelReference || $[36] !== instanceId || $[37] !== threadKey) {
+  if ($[36] !== cancelMutate || $[37] !== cancelReference || $[38] !== instanceId || $[39] !== threadKey) {
     t10 = async () => {
       if (cancelReference === void 0 || instanceId === void 0) {
         return;
@@ -240,17 +258,17 @@ const useAgentChat = (options) => {
         threadKey
       });
     };
-    $[34] = cancelMutate;
-    $[35] = cancelReference;
-    $[36] = instanceId;
-    $[37] = threadKey;
-    $[38] = t10;
+    $[36] = cancelMutate;
+    $[37] = cancelReference;
+    $[38] = instanceId;
+    $[39] = threadKey;
+    $[40] = t10;
   } else {
-    t10 = $[38];
+    t10 = $[40];
   }
   const cancel = t10;
   let t11;
-  if ($[39] !== approve || $[40] !== cancel || $[41] !== messages || $[42] !== reject || $[43] !== send || $[44] !== status || $[45] !== streamingText) {
+  if ($[41] !== approve || $[42] !== cancel || $[43] !== messages || $[44] !== reject || $[45] !== send || $[46] !== status || $[47] !== streamingText) {
     t11 = {
       approve,
       cancel,
@@ -260,24 +278,27 @@ const useAgentChat = (options) => {
       status,
       streamingText
     };
-    $[39] = approve;
-    $[40] = cancel;
-    $[41] = messages;
-    $[42] = reject;
-    $[43] = send;
-    $[44] = status;
-    $[45] = streamingText;
-    $[46] = t11;
+    $[41] = approve;
+    $[42] = cancel;
+    $[43] = messages;
+    $[44] = reject;
+    $[45] = send;
+    $[46] = status;
+    $[47] = streamingText;
+    $[48] = t11;
   } else {
-    t11 = $[46];
+    t11 = $[48];
   }
   return t11;
 };
-function _temp(message) {
-  return message.role === "assistant";
+function _temp(message_0) {
+  return message_0.role === "assistant";
 }
 function _temp2(delta) {
   return delta.text;
 }
+function _temp3(message_1) {
+  return message_1.role === "user";
+}
 
 export { useAgentChat };

package/dist/packem_shared/useClientQuery-DIkNT4QA.mjs

@@ -0,0 +1,17 @@
+'use client';
+import { useCallback, useSyncExternalStore } from 'react';
+import { useLunora } from './LunoraProvider-BsuiW4Lk.mjs';
+
+const useClientQuery = (ref) => {
+  const client = useLunora();
+  const subscribe = useCallback((onStoreChange) => client.subscribeClientQuery(ref, () => {
+    onStoreChange();
+  }), [client, ref.key]);
+  const value = useSyncExternalStore(subscribe, () => client.getClientQuery(ref), () => client.getClientQuery(ref));
+  const setter = useCallback((next) => {
+    client.setClientQuery(ref, next);
+  }, [client, ref]);
+  return [value, setter];
+};
+
+export { useClientQuery as default };

package/dist/packem_shared/{useVoiceAgent-sC5_ADB8.mjs → useVoiceAgent-w7fzAMSB.mjs}

@@ -309,7 +309,13 @@ const useVoiceAgent = (options) => {
     setInterimTranscript("");
     try {
       const url = voiceSocketUrl(client.url, agentNameFromReference(voice), threadKey);
-      const openSocket = createSocket ?? ((target) => new globalThis.WebSocket(target));
+      const openSocket = createSocket ?? ((target) => {
+        const WebSocketImpl = client.getWebSocketImpl();
+        if (!WebSocketImpl) {
+          throw new Error("useVoiceAgent: no WebSocket implementation available (pass createSocket explicitly)");
+        }
+        return new WebSocketImpl(target);
+      });
       const socket_0 = openSocket(url);
       socket_0.binaryType = "arraybuffer";
       const connection_2 = {

package/dist/server.d.mts

@@ -4,20 +4,20 @@ import { ServerClientOptions } from '@lunora/client/ssr';
 export { type AuthLike, type HeadersSource, type ServerClientOptions, type ServerSession, createServerClient, deserializePreloaded, getServerSession, serializePreloaded } from '@lunora/client/ssr';
 import { QueryClient } from '@tanstack/react-query';
 export { HydrationBoundary, dehydrate } from '@tanstack/react-query';
-export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-D4okOpO8.mjs";
+export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-CdgGQ9s4.mjs";
 /**
-* Run a query on the server and seed `queryClient` with the result under the
-* same key the client hooks use (see `lunoraQueryKey`), so a later
-* `useQuery(fn, args)` reads it straight from the hydrated cache — no loading
-* flash, no duplicate fetch on the client.
-*
-* Pair it with TanStack's `dehydrate` + `HydrationBoundary` (both re-exported
-* from this module): prefetch into a fresh `QueryClient`, `dehydrate` it, wrap
-* the client subtree in `HydrationBoundary`, and the client hooks pick the value
-* up from cache. Errors propagate — wrap the call if you'd rather render a
-* fallback than fail the server render. Drop the `await` for fire-and-forget
-* prefetch when you don't need the data present on the very first paint.
-*/
+ * Run a query on the server and seed `queryClient` with the result under the
+ * same key the client hooks use (see `lunoraQueryKey`), so a later
+ * `useQuery(fn, args)` reads it straight from the hydrated cache — no loading
+ * flash, no duplicate fetch on the client.
+ *
+ * Pair it with TanStack's `dehydrate` + `HydrationBoundary` (both re-exported
+ * from this module): prefetch into a fresh `QueryClient`, `dehydrate` it, wrap
+ * the client subtree in `HydrationBoundary`, and the client hooks pick the value
+ * up from cache. Errors propagate — wrap the call if you'd rather render a
+ * fallback than fail the server render. Drop the `await` for fire-and-forget
+ * prefetch when you don't need the data present on the very first paint.
+ */
 declare const prefetchQuery: <F extends FunctionReference>(queryClient: QueryClient, client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
   shardKey?: string;
 }) => Promise<void>;
@@ -27,25 +27,25 @@ interface ServerCallOptions {
   shardKey?: string;
 }
 /**
-* Run a query once on the server and return its result — the standalone
-* counterpart to `prefetchQuery`/`preloadQuery` for when you just want the data
-* inline in a Server Component (e.g. to compute metadata or branch on a value)
-* rather than seed a cache or hand a `Preloaded` to the client.
-*
-* Builds a fresh request-scoped client per call (see `createServerClient`), so
-* pass `token` to run as the signed-in user. For several reads in one request,
-* prefer holding one `createServerClient` and calling `.query()` yourself to
-* avoid rebuilding the transport each time. Errors propagate.
-*/
+ * Run a query once on the server and return its result — the standalone
+ * counterpart to `prefetchQuery`/`preloadQuery` for when you just want the data
+ * inline in a Server Component (e.g. to compute metadata or branch on a value)
+ * rather than seed a cache or hand a `Preloaded` to the client.
+ *
+ * Builds a fresh request-scoped client per call (see `createServerClient`), so
+ * pass `token` to run as the signed-in user. For several reads in one request,
+ * prefer holding one `createServerClient` and calling `.query()` yourself to
+ * avoid rebuilding the transport each time. Errors propagate.
+ */
 declare const fetchQuery: <F extends FunctionReference>(options: ServerClientOptions, function_: F, args: ArgsOf<F>, callOptions?: ServerCallOptions) => Promise<ReturnOf<F>>;
 /**
-* Run a mutation once on the server and return its result. Server-side calls go
-* straight over HTTP RPC — the offline queue and optimistic-update machinery are
-* client-only and never engage here. Errors propagate.
-*/
+ * Run a mutation once on the server and return its result. Server-side calls go
+ * straight over HTTP RPC — the offline queue and optimistic-update machinery are
+ * client-only and never engage here. Errors propagate.
+ */
 declare const fetchMutation: <F extends FunctionReference>(options: ServerClientOptions, function_: F, args: ArgsOf<F>, callOptions?: ServerCallOptions) => Promise<ReturnOf<F>>;
 /**
-* Run an action once on the server and return its result. Errors propagate.
-*/
+ * Run an action once on the server and return its result. Errors propagate.
+ */
 declare const fetchAction: <F extends FunctionReference>(options: ServerClientOptions, function_: F, args: ArgsOf<F>, callOptions?: ServerCallOptions) => Promise<ReturnOf<F>>;
 export { ServerCallOptions, fetchAction, fetchMutation, fetchQuery, prefetchQuery };

package/dist/server.d.ts

@@ -4,20 +4,20 @@ import { ServerClientOptions } from '@lunora/client/ssr';
 export { type AuthLike, type HeadersSource, type ServerClientOptions, type ServerSession, createServerClient, deserializePreloaded, getServerSession, serializePreloaded } from '@lunora/client/ssr';
 import { QueryClient } from '@tanstack/react-query';
 export { HydrationBoundary, dehydrate } from '@tanstack/react-query';
-export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-D4okOpO8.js";
+export { type L as LunoraQueryOptions, l as lunoraQueryOptions } from "./packem_shared/query-options.d-CdgGQ9s4.js";
 /**
-* Run a query on the server and seed `queryClient` with the result under the
-* same key the client hooks use (see `lunoraQueryKey`), so a later
-* `useQuery(fn, args)` reads it straight from the hydrated cache — no loading
-* flash, no duplicate fetch on the client.
-*
-* Pair it with TanStack's `dehydrate` + `HydrationBoundary` (both re-exported
-* from this module): prefetch into a fresh `QueryClient`, `dehydrate` it, wrap
-* the client subtree in `HydrationBoundary`, and the client hooks pick the value
-* up from cache. Errors propagate — wrap the call if you'd rather render a
-* fallback than fail the server render. Drop the `await` for fire-and-forget
-* prefetch when you don't need the data present on the very first paint.
-*/
+ * Run a query on the server and seed `queryClient` with the result under the
+ * same key the client hooks use (see `lunoraQueryKey`), so a later
+ * `useQuery(fn, args)` reads it straight from the hydrated cache — no loading
+ * flash, no duplicate fetch on the client.
+ *
+ * Pair it with TanStack's `dehydrate` + `HydrationBoundary` (both re-exported
+ * from this module): prefetch into a fresh `QueryClient`, `dehydrate` it, wrap
+ * the client subtree in `HydrationBoundary`, and the client hooks pick the value
+ * up from cache. Errors propagate — wrap the call if you'd rather render a
+ * fallback than fail the server render. Drop the `await` for fire-and-forget
+ * prefetch when you don't need the data present on the very first paint.
+ */
 declare const prefetchQuery: <F extends FunctionReference>(queryClient: QueryClient, client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
   shardKey?: string;
 }) => Promise<void>;
@@ -27,25 +27,25 @@ interface ServerCallOptions {
   shardKey?: string;
 }
 /**
-* Run a query once on the server and return its result — the standalone
-* counterpart to `prefetchQuery`/`preloadQuery` for when you just want the data
-* inline in a Server Component (e.g. to compute metadata or branch on a value)
-* rather than seed a cache or hand a `Preloaded` to the client.
-*
-* Builds a fresh request-scoped client per call (see `createServerClient`), so
-* pass `token` to run as the signed-in user. For several reads in one request,
-* prefer holding one `createServerClient` and calling `.query()` yourself to
-* avoid rebuilding the transport each time. Errors propagate.
-*/
+ * Run a query once on the server and return its result — the standalone
+ * counterpart to `prefetchQuery`/`preloadQuery` for when you just want the data
+ * inline in a Server Component (e.g. to compute metadata or branch on a value)
+ * rather than seed a cache or hand a `Preloaded` to the client.
+ *
+ * Builds a fresh request-scoped client per call (see `createServerClient`), so
+ * pass `token` to run as the signed-in user. For several reads in one request,
+ * prefer holding one `createServerClient` and calling `.query()` yourself to
+ * avoid rebuilding the transport each time. Errors propagate.
+ */
 declare const fetchQuery: <F extends FunctionReference>(options: ServerClientOptions, function_: F, args: ArgsOf<F>, callOptions?: ServerCallOptions) => Promise<ReturnOf<F>>;
 /**
-* Run a mutation once on the server and return its result. Server-side calls go
-* straight over HTTP RPC — the offline queue and optimistic-update machinery are
-* client-only and never engage here. Errors propagate.
-*/
+ * Run a mutation once on the server and return its result. Server-side calls go
+ * straight over HTTP RPC — the offline queue and optimistic-update machinery are
+ * client-only and never engage here. Errors propagate.
+ */
 declare const fetchMutation: <F extends FunctionReference>(options: ServerClientOptions, function_: F, args: ArgsOf<F>, callOptions?: ServerCallOptions) => Promise<ReturnOf<F>>;
 /**
-* Run an action once on the server and return its result. Errors propagate.
-*/
+ * Run an action once on the server and return its result. Errors propagate.
+ */
 declare const fetchAction: <F extends FunctionReference>(options: ServerClientOptions, function_: F, args: ArgsOf<F>, callOptions?: ServerCallOptions) => Promise<ReturnOf<F>>;
 export { ServerCallOptions, fetchAction, fetchMutation, fetchQuery, prefetchQuery };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react",
-  "version": "1.0.0-alpha.27",
+  "version": "1.0.0-alpha.29",
   "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.23",
-    "@lunora/errors": "1.0.0-alpha.5",
-    "@lunora/ratelimit": "1.0.0-alpha.8"
+    "@lunora/client": "1.0.0-alpha.25",
+    "@lunora/errors": "1.0.0-alpha.6",
+    "@lunora/ratelimit": "1.0.0-alpha.9"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.101.0",

package/dist/packem_shared/query-options.d-D4okOpO8.d.mts

@@ -1,38 +0,0 @@
-import { FunctionReference, ReturnOf, LunoraClient, ArgsOf } from '@lunora/client';
-import { QueryKey } from '@tanstack/react-query';
-/**
-* Pure, transport-free adapter between a Lunora function reference and a
-* TanStack Query options object. No `"use client"` directive and only a
-* type-level `@lunora/client` import, so it is safe to use on either side of an
-* RSC boundary (the runtime transport is the `LunoraClient` you pass in).
-*
-* Use it when you want to drive a Lunora query through TanStack's own hooks —
-* `useSuspenseQuery`, `useQueries`, or the server-side
-* `queryClient.ensureQueryData` / `prefetchQuery` — rather than the first-class
-* `useQuery` from `@lunora/react`.
-*/
-/** Shape returned by `lunoraQueryOptions`, spread into a TanStack hook. */
-interface LunoraQueryOptions<F extends FunctionReference> {
-  queryFn: () => Promise<ReturnOf<F>>;
-  queryKey: QueryKey;
-  staleTime: number;
-}
-/**
-* Build a TanStack Query options object for a Lunora query, keyed identically
-* to the first-class hooks (see `lunoraQueryKey`) so a value fetched through
-* this adapter shares cache identity with anything `useQuery` /
-* `prefetchQuery` reads or writes for the same `(fn, args, shardKey)` triple.
-*
-* ```ts
-* const { data } = useSuspenseQuery(lunoraQueryOptions(client, api.posts.list, {}));
-* ```
-*
-* This is a one-shot fetch: it resolves once and `staleTime` is infinite, so
-* TanStack never refetches on its own. It does not open a WebSocket — for live
-* updates that re-render on every server push, use `useQuery` from
-* `@lunora/react`, which attaches a shared subscription to the same cache key.
-*/
-declare const lunoraQueryOptions: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
-  shardKey?: string;
-}) => LunoraQueryOptions<F>;
-export { LunoraQueryOptions as L, lunoraQueryOptions as l };

package/dist/packem_shared/query-options.d-D4okOpO8.d.ts

@@ -1,38 +0,0 @@
-import { FunctionReference, ReturnOf, LunoraClient, ArgsOf } from '@lunora/client';
-import { QueryKey } from '@tanstack/react-query';
-/**
-* Pure, transport-free adapter between a Lunora function reference and a
-* TanStack Query options object. No `"use client"` directive and only a
-* type-level `@lunora/client` import, so it is safe to use on either side of an
-* RSC boundary (the runtime transport is the `LunoraClient` you pass in).
-*
-* Use it when you want to drive a Lunora query through TanStack's own hooks —
-* `useSuspenseQuery`, `useQueries`, or the server-side
-* `queryClient.ensureQueryData` / `prefetchQuery` — rather than the first-class
-* `useQuery` from `@lunora/react`.
-*/
-/** Shape returned by `lunoraQueryOptions`, spread into a TanStack hook. */
-interface LunoraQueryOptions<F extends FunctionReference> {
-  queryFn: () => Promise<ReturnOf<F>>;
-  queryKey: QueryKey;
-  staleTime: number;
-}
-/**
-* Build a TanStack Query options object for a Lunora query, keyed identically
-* to the first-class hooks (see `lunoraQueryKey`) so a value fetched through
-* this adapter shares cache identity with anything `useQuery` /
-* `prefetchQuery` reads or writes for the same `(fn, args, shardKey)` triple.
-*
-* ```ts
-* const { data } = useSuspenseQuery(lunoraQueryOptions(client, api.posts.list, {}));
-* ```
-*
-* This is a one-shot fetch: it resolves once and `staleTime` is infinite, so
-* TanStack never refetches on its own. It does not open a WebSocket — for live
-* updates that re-render on every server push, use `useQuery` from
-* `@lunora/react`, which attaches a shared subscription to the same cache key.
-*/
-declare const lunoraQueryOptions: <F extends FunctionReference>(client: LunoraClient, function_: F, args: ArgsOf<F>, options?: {
-  shardKey?: string;
-}) => LunoraQueryOptions<F>;
-export { LunoraQueryOptions as L, lunoraQueryOptions as l };