@lunora/react 1.0.0-alpha.156 → 1.0.0-alpha.158

package/README.md

@@ -101,7 +101,7 @@ function MessageList({ room }: { room: string }) {
 | `useSubscription(fn, args, options?)`                                      | `{ data, error }`                                                                                                                | No initial fetch — only server-pushed values.                                                                                          |
 | `usePaginatedQuery(fn, args, { initialNumItems, onError? })`               | `{ results, status, isLoading, loadMore, error }`                                                                                | Cursor-paginated feed that stays consistent under live edits. A failed tail page is dropped so `loadMore` can retry it.                |
 | `useInfiniteQuery(fn, args, { initialNumItems, onError? })`                | `{ pages, status, hasNextPage, fetchNextPage, error, … }`                                                                        | Page-array variant of the same paginator.                                                                                              |
-| `usePreloadedQuery(preloaded, options?)`                                   | `T`                                                                                                                              | Reads a server `Preloaded` token, then goes live. Pass `onError` to see a session expiry instead of rendering the stale SSR snapshot.  |
+| `usePreloadedQuery(preloaded, options?)`                                   | `T \| undefined`                                                                                                                 | Reads a server `Preloaded` token, then goes live. Pass `onError` to see a session expiry instead of rendering the stale SSR snapshot.  |
 | `usePresence(roomId, { heartbeat, listPresent, … })`                       | `{ present, sessionId, setData, error }`                                                                                         | Drives the `definePresence` heartbeat + list functions. `roomId` is a positional first argument, not an option.                        |
 | `useFlag(key, default)`                                                    | flag value (live)                                                                                                                | Live OpenFeature flag over the WS; reads `default` until the server answers. Evaluated under the socket's server-verified identity.    |
 | `useFlags(defaults)`                                                       | `{ [key]: value }`                                                                                                               | Batch variant — one live value per key in the `defaults` map.                                                                          |

package/dist/index.d.mts

@@ -1055,13 +1055,14 @@ declare const useMutator: <TArgs = Record<string, unknown>>(handle: MutatorHandl
  * The preloaded value was read for whoever was signed in when the page loaded.
  * After a sign-out or user switch retires an identity, every `usePreloadedQuery`
  * on the client (mounted then or later) stops using it and returns `undefined`
- * until the live value arrives. A token preloaded after the switch (a client-side
- * navigation that preloads again) is ignored too and costs a loading flash: the
- * hook cannot tell which identity a token was read under.
+ * until the live value arrives — hence the `T | undefined` return type. A token
+ * preloaded after the switch (a client-side navigation that preloads again) is
+ * ignored too and costs a loading flash: the hook cannot tell which identity a
+ * token was read under.
  */
 declare const usePreloadedQuery: <T>(preloaded: Preloaded<T>, options?: {
   onError?: SubscriptionErrorCallback;
-}) => T;
+}) => T | undefined;
 /**
  * The PLAN4 §1 framework-neutral name for the preloaded-hydration handoff:
  * `hydratePreloaded(preloaded)` seeds the SSR value on the first paint, then
@@ -1075,7 +1076,7 @@ declare const usePreloadedQuery: <T>(preloaded: Preloaded<T>, options?: {
  */
 declare const hydratePreloaded: <T>(preloaded: Preloaded<T>, options?: {
   onError?: SubscriptionErrorCallback;
-}) => T;
+}) => T | undefined;
 /**
  * `usePresence` — collaborative-awareness hook, the client half of the
  * `@lunora/server` `definePresence` preset (Convex `@convex-dev/presence`

package/dist/index.d.ts

@@ -1055,13 +1055,14 @@ declare const useMutator: <TArgs = Record<string, unknown>>(handle: MutatorHandl
  * The preloaded value was read for whoever was signed in when the page loaded.
  * After a sign-out or user switch retires an identity, every `usePreloadedQuery`
  * on the client (mounted then or later) stops using it and returns `undefined`
- * until the live value arrives. A token preloaded after the switch (a client-side
- * navigation that preloads again) is ignored too and costs a loading flash: the
- * hook cannot tell which identity a token was read under.
+ * until the live value arrives — hence the `T | undefined` return type. A token
+ * preloaded after the switch (a client-side navigation that preloads again) is
+ * ignored too and costs a loading flash: the hook cannot tell which identity a
+ * token was read under.
  */
 declare const usePreloadedQuery: <T>(preloaded: Preloaded<T>, options?: {
   onError?: SubscriptionErrorCallback;
-}) => T;
+}) => T | undefined;
 /**
  * The PLAN4 §1 framework-neutral name for the preloaded-hydration handoff:
  * `hydratePreloaded(preloaded)` seeds the SSR value on the first paint, then
@@ -1075,7 +1076,7 @@ declare const usePreloadedQuery: <T>(preloaded: Preloaded<T>, options?: {
  */
 declare const hydratePreloaded: <T>(preloaded: Preloaded<T>, options?: {
   onError?: SubscriptionErrorCallback;
-}) => T;
+}) => T | undefined;
 /**
  * `usePresence` — collaborative-awareness hook, the client half of the
  * `@lunora/server` `definePresence` preset (Convex `@convex-dev/presence`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react",
-  "version": "1.0.0-alpha.156",
+  "version": "1.0.0-alpha.158",
   "description": "React hooks for Lunora: useQuery, useMutation, useSubscription, and useAuth",
   "keywords": [
     "cloudflare",
@@ -57,7 +57,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.150",
+    "@lunora/client": "1.0.0-alpha.151",
     "@lunora/errors": "1.0.0-alpha.45",
     "@lunora/ratelimit": "1.0.0-alpha.87",
     "@visulima/storage-client": "1.0.3"