@lunora/react-native 1.0.0-alpha.4 → 1.0.0-alpha.41

package/README.md

@@ -131,10 +131,24 @@ import { client } from "./lunora";
 function Root() {
     const { data: session } = authClient.useSession();
 
+    // `expoBearerToken` is async since better-auth 1.7.1, and an async function
+    // is not a valid effect cleanup return — so kick off a promise instead.
+    // `cancelled` is load-bearing: two session changes in quick succession leave
+    // two reads in flight, and without it the slower one reinstates the previous
+    // session's token.
     useEffect(() => {
-        const token = expoBearerToken(authClient);
-        client.setAuthToken(token); // HTTP `Authorization: Bearer …`
-        client.setWsToken(token ?? undefined); // WS `?token=…`
+        let cancelled = false;
+
+        void (async () => {
+            const token = await expoBearerToken(authClient);
+            if (cancelled) return;
+            client.setAuthToken(token); // HTTP `Authorization: Bearer …`
+            client.setWsToken(token ?? undefined); // WS `?token=…`
+        })();
+
+        return () => {
+            cancelled = true;
+        };
     }, [session]);
 
     // …render the app

package/dist/auth.d.mts

@@ -1,37 +1,51 @@
-export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';
+export {
 /**
-* Read the current better-auth session token from an Expo auth client, for use
-* as a **bearer** credential on the Lunora client — `client.setAuthToken(token)`
-* for HTTP RPC and `client.setWsToken(token ?? undefined)` for the live socket.
-*
-* The Expo plugin persists the session as a cookie in `SecureStore`;
-* `getCookie()` exposes it, and this pulls the `session_token` value out.
-* better-auth's `bearer` plugin accepts that value verbatim in the
-* `Authorization` header — so the native client authenticates WITHOUT sending a
-* `Cookie`, which the runtime's CSRF guard rejects on an `Origin`-less native
-* request (React Native sends no `Origin`). Returns `null` when signed out.
-*
-* Re-run it whenever the session changes and feed the result to the client (see
-* the package README):
-*
-* ```ts
-* const token = expoBearerToken(authClient);
-* client.setAuthToken(token);
-* client.setWsToken(token ?? undefined);
-* ```
-* @experimental
-*/
-declare const expoBearerToken: (authClient: {
-  getCookie: () => string;
-}) => null | string;
+ * The slice of a key/value store the better-auth Expo plugin needs. Pass Expo
+ * `SecureStore` straight in.
+ *
+ * Re-exported from `@better-auth/expo/client` rather than restated here. This
+ * used to be a hand-written `SecureStorageLike` mirroring what upstream needed
+ * — two synchronous methods — and better-auth 1.7 moved the Expo storage
+ * integration to asynchronous `SecureStore` methods, so the real shape is now
+ * `getItem` + `getItemAsync` + `setItem` + `setItemAsync`. A hand-written
+ * mirror does not fail when upstream widens like that; it just silently
+ * describes a store the plugin will not accept. Re-exporting makes the
+ * compiler track it, which is the same lesson the `getCookie` shim taught in
+ * this file's history.
+ * @experimental
+ */
+type ExpoClientStorage, expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';
 /**
-* The slice of a key/value store the better-auth Expo plugin needs — the shape
-* of `expo-secure-store` (a synchronous `getItem`, plus `setItem`). Pass Expo
-* `SecureStore` straight in.
-* @experimental
-*/
-interface SecureStorageLike {
-  getItem: (key: string) => null | string;
-  setItem: (key: string, value: string) => unknown;
-}
-export { SecureStorageLike, expoBearerToken };
+ * Read the current better-auth session token from an Expo auth client, for use
+ * as a **bearer** credential on the Lunora client — `client.setAuthToken(token)`
+ * for HTTP RPC and `client.setWsToken(token ?? undefined)` for the live socket.
+ *
+ * The Expo plugin persists the session as a cookie in `SecureStore`;
+ * `getCookie()` exposes it, and this pulls the `session_token` value out.
+ * better-auth's `bearer` plugin accepts that value verbatim in the
+ * `Authorization` header — so the native client authenticates WITHOUT sending a
+ * `Cookie`, which the runtime's CSRF guard rejects on an `Origin`-less native
+ * request (React Native sends no `Origin`). Resolves `null` when signed out.
+ *
+ * **Async since better-auth 1.7.1**, which changed `@better-auth/expo`'s
+ * `getCookie` from `() => string` to `() => Promise<string>` (it reads
+ * `SecureStore` asynchronously now). The awaited value is what gets matched:
+ * regexing the Promise itself would test `"[object Promise]"`, find no
+ * `session_token`, and return `null` on every call — a signed-in native app
+ * that silently behaves as anonymous, which is exactly the failure this
+ * signature change prevents by making callers await.
+ *
+ * Re-run it whenever the session changes and feed the result to the client (see
+ * the package README):
+ *
+ * ```ts
+ * const token = await expoBearerToken(authClient);
+ * client.setAuthToken(token);
+ * client.setWsToken(token ?? undefined);
+ * ```
+ * @experimental
+ */
+declare const expoBearerToken: (authClient: {
+  getCookie: () => Promise<string> | string;
+}) => Promise<null | string>;
+export { expoBearerToken };

package/dist/auth.d.ts

@@ -1,37 +1,51 @@
-export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';
+export {
 /**
-* Read the current better-auth session token from an Expo auth client, for use
-* as a **bearer** credential on the Lunora client — `client.setAuthToken(token)`
-* for HTTP RPC and `client.setWsToken(token ?? undefined)` for the live socket.
-*
-* The Expo plugin persists the session as a cookie in `SecureStore`;
-* `getCookie()` exposes it, and this pulls the `session_token` value out.
-* better-auth's `bearer` plugin accepts that value verbatim in the
-* `Authorization` header — so the native client authenticates WITHOUT sending a
-* `Cookie`, which the runtime's CSRF guard rejects on an `Origin`-less native
-* request (React Native sends no `Origin`). Returns `null` when signed out.
-*
-* Re-run it whenever the session changes and feed the result to the client (see
-* the package README):
-*
-* ```ts
-* const token = expoBearerToken(authClient);
-* client.setAuthToken(token);
-* client.setWsToken(token ?? undefined);
-* ```
-* @experimental
-*/
-declare const expoBearerToken: (authClient: {
-  getCookie: () => string;
-}) => null | string;
+ * The slice of a key/value store the better-auth Expo plugin needs. Pass Expo
+ * `SecureStore` straight in.
+ *
+ * Re-exported from `@better-auth/expo/client` rather than restated here. This
+ * used to be a hand-written `SecureStorageLike` mirroring what upstream needed
+ * — two synchronous methods — and better-auth 1.7 moved the Expo storage
+ * integration to asynchronous `SecureStore` methods, so the real shape is now
+ * `getItem` + `getItemAsync` + `setItem` + `setItemAsync`. A hand-written
+ * mirror does not fail when upstream widens like that; it just silently
+ * describes a store the plugin will not accept. Re-exporting makes the
+ * compiler track it, which is the same lesson the `getCookie` shim taught in
+ * this file's history.
+ * @experimental
+ */
+type ExpoClientStorage, expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';
 /**
-* The slice of a key/value store the better-auth Expo plugin needs — the shape
-* of `expo-secure-store` (a synchronous `getItem`, plus `setItem`). Pass Expo
-* `SecureStore` straight in.
-* @experimental
-*/
-interface SecureStorageLike {
-  getItem: (key: string) => null | string;
-  setItem: (key: string, value: string) => unknown;
-}
-export { SecureStorageLike, expoBearerToken };
+ * Read the current better-auth session token from an Expo auth client, for use
+ * as a **bearer** credential on the Lunora client — `client.setAuthToken(token)`
+ * for HTTP RPC and `client.setWsToken(token ?? undefined)` for the live socket.
+ *
+ * The Expo plugin persists the session as a cookie in `SecureStore`;
+ * `getCookie()` exposes it, and this pulls the `session_token` value out.
+ * better-auth's `bearer` plugin accepts that value verbatim in the
+ * `Authorization` header — so the native client authenticates WITHOUT sending a
+ * `Cookie`, which the runtime's CSRF guard rejects on an `Origin`-less native
+ * request (React Native sends no `Origin`). Resolves `null` when signed out.
+ *
+ * **Async since better-auth 1.7.1**, which changed `@better-auth/expo`'s
+ * `getCookie` from `() => string` to `() => Promise<string>` (it reads
+ * `SecureStore` asynchronously now). The awaited value is what gets matched:
+ * regexing the Promise itself would test `"[object Promise]"`, find no
+ * `session_token`, and return `null` on every call — a signed-in native app
+ * that silently behaves as anonymous, which is exactly the failure this
+ * signature change prevents by making callers await.
+ *
+ * Re-run it whenever the session changes and feed the result to the client (see
+ * the package README):
+ *
+ * ```ts
+ * const token = await expoBearerToken(authClient);
+ * client.setAuthToken(token);
+ * client.setWsToken(token ?? undefined);
+ * ```
+ * @experimental
+ */
+declare const expoBearerToken: (authClient: {
+  getCookie: () => Promise<string> | string;
+}) => Promise<null | string>;
+export { expoBearerToken };

package/dist/auth.mjs

@@ -1,2 +1 @@
-export { default as expoBearerToken } from './packem_shared/expoBearerToken-B0Zorz--.mjs';
-export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';
+import{default as p}from"./packem_shared/expoBearerToken-CA88JtQp.mjs";import{expoClient as a,setupExpoFocusManager as n,setupExpoOnlineManager as t}from"@better-auth/expo/client";export{p as expoBearerToken,a as expoClient,n as setupExpoFocusManager,t as setupExpoOnlineManager};

package/dist/index.d.mts

@@ -1,78 +1,83 @@
 import { AsyncStorageLike, LunoraClientOptions, LunoraClient } from '@lunora/client';
 export * from '@lunora/react';
 /**
-* A `() => headers` factory the React Native client threads onto every HTTP RPC
-* request *and* the WebSocket upgrade — a generic escape hatch for attaching a
-* **custom** credential header (an API-gateway key, a proxy token, …) that
-* React Native's missing cookie jar can't carry implicitly. Return `undefined`
-* (or an empty object) when there's nothing to attach.
-*
-* For better-auth Expo sessions, prefer a **bearer** token instead: read it with
-* `@lunora/react-native/auth`'s `expoBearerToken` and feed it to
-* `client.setAuthToken` / `setWsToken` (see the package README). A bearer avoids
-* the `Cookie` header the runtime's CSRF guard rejects on `Origin`-less native
-* requests.
-* @experimental
-*/
+ * A `() => headers` factory the React Native client threads onto every HTTP RPC
+ * request *and* the WebSocket upgrade — a generic escape hatch for attaching a
+ * **custom** credential header (an API-gateway key, a proxy token, …) that
+ * React Native's missing cookie jar can't carry implicitly. Return `undefined`
+ * (or an empty object) when there's nothing to attach.
+ *
+ * For better-auth Expo sessions, prefer a **bearer** token instead: read it with
+ * `@lunora/react-native/auth`'s `expoBearerToken` and feed it to
+ * `client.setAuthToken` / `setWsToken` (see the package README). A bearer avoids
+ * the `Cookie` header the runtime's CSRF guard rejects on `Origin`-less native
+ * requests.
+ * @experimental
+ */
 type AuthHeadersFactory = () => Record<string, string> | undefined;
 /**
-* Options for `createLunoraClient` — the React Native / Expo counterpart to
-* constructing a `LunoraClient` directly. It is `LunoraClientOptions` with two
-* React-Native-shaped conveniences layered on. `storage` wires the
-* AsyncStorage-backed offline-queue persistence for you (the browser default
-* auto-probes IndexedDB, which React Native lacks, so without this the queue
-* stays in memory and is lost on reload). `getAuthHeaders` is a generic escape
-* hatch for a custom credential header on both the HTTP RPC path and the
-* WebSocket upgrade; for better-auth sessions prefer a bearer token
-* (`expoBearerToken` + the client's `setAuthToken` / `setWsToken`).
-*
-* The `persistence`, `fetch`, and `WebSocket` fields of `LunoraClientOptions`
-* are still accepted and take precedence when you need full control; the two
-* conveniences are sugar over exactly those seams.
-* @experimental
-*/
+ * Options for `createLunoraClient` — the React Native / Expo counterpart to
+ * constructing a `LunoraClient` directly. It is `LunoraClientOptions` with two
+ * React-Native-shaped conveniences layered on. `storage` wires the
+ * AsyncStorage-backed offline-queue persistence for you (the browser default
+ * auto-probes IndexedDB, which React Native lacks, so without this the queue
+ * stays in memory and is lost on reload). `getAuthHeaders` is a generic escape
+ * hatch for a custom credential header on both the HTTP RPC path and the
+ * WebSocket upgrade; for better-auth sessions prefer a bearer token
+ * (`expoBearerToken` + the client's `setAuthToken` / `setWsToken`).
+ *
+ * The `persistence`, `fetch`, and `WebSocket` fields of `LunoraClientOptions`
+ * are still accepted and take precedence when you need full control; the two
+ * conveniences are sugar over exactly those seams.
+ * @experimental
+ */
 interface CreateLunoraClientOptions extends LunoraClientOptions {
   /**
-  * Attaches a credential to every HTTP RPC request and to the WebSocket
-  * upgrade request. See `AuthHeadersFactory`. When omitted, requests go out
-  * with only whatever `LunoraClient` already sets (its bearer token from
-  * `setAuthToken`, if any).
-  *
-  * Merged UNDER the client's own headers on the HTTP path (an explicit
-  * `setAuthToken` bearer wins over a same-named header here); applied to the
-  * WebSocket upgrade via a wrapping `WebSocket`, since the socket has no other
-  * way to carry credentials in React Native.
-  */
+   * Attaches a credential to every HTTP RPC request and to the WebSocket
+   * upgrade request. See `AuthHeadersFactory`. When omitted, requests go out
+   * with only whatever `LunoraClient` already sets (its bearer token from
+   * `setAuthToken`, if any).
+   *
+   * Merged UNDER the client's own headers on the HTTP path (an explicit
+   * `setAuthToken` bearer wins over a same-named header here); applied to the
+   * WebSocket upgrade via a wrapping `WebSocket`, since the socket has no other
+   * way to carry credentials in React Native.
+   */
   getAuthHeaders?: AuthHeadersFactory;
   /**
-  * React Native `AsyncStorage` (or any async key/value store with the same
-  * `getItem`/`setItem`/`removeItem` surface — Expo `SecureStore`, an in-memory
-  * map in tests). When supplied, the offline mutation queue is persisted here
-  * via `createAsyncStoragePersistence`, so writes made offline survive an app
-  * restart. Ignored when an explicit `persistence` is passed.
-  */
+   * React Native `AsyncStorage` (or any async key/value store with the same
+   * `getItem`/`setItem`/`removeItem` surface — Expo `SecureStore`, an in-memory
+   * map in tests). When supplied, the offline mutation queue is persisted here
+   * via `createAsyncStoragePersistence`, so writes made offline survive an app
+   * restart. Ignored when an explicit `persistence` is passed.
+   */
   storage?: AsyncStorageLike;
 }
 /**
-* Construct a `LunoraClient` tuned for React Native / Expo — a thin wrapper over
-* `new LunoraClient(options)` that fills in the two things a browser gets for
-* free but React Native does not.
-*
-* First, a durable offline queue: pass `storage` (React Native `AsyncStorage`,
-* or any async key/value store) and the offline mutation queue is persisted
-* through `createAsyncStoragePersistence` — the browser default auto-probes
-* IndexedDB, which React Native lacks, so without this the queue lives only in
-* memory and is lost on reload.
-*
-* Second, credentialed requests: pass `getAuthHeaders` and the returned headers
-* ride both the HTTP RPC path and the WebSocket upgrade, since React Native has
-* no cookie jar to attach a session implicitly.
-*
-* Everything on `LunoraClientOptions` is still accepted and passed through; an
-* explicit `persistence`, `fetch`, or `WebSocket` takes precedence over the
-* convenience derived from `storage` / `getAuthHeaders`. See the package README
-* for a full setup example.
-* @experimental
-*/
+ * Construct a `LunoraClient` tuned for React Native / Expo — a thin wrapper over
+ * `new LunoraClient(options)` that fills in the three things a browser gets for
+ * free but React Native does not.
+ *
+ * First, a durable offline queue: pass `storage` (React Native `AsyncStorage`,
+ * or any async key/value store) and the offline mutation queue is persisted
+ * through `createAsyncStoragePersistence` — the browser default auto-probes
+ * IndexedDB, which React Native lacks, so without this the queue lives only in
+ * memory and is lost on reload.
+ *
+ * Second, a durable read cache: the same `storage` also backs the query cache
+ * through `createAsyncStorageQueryCache`, so cached reads render immediately
+ * after a restart while the socket reconnects — mirroring the browser's
+ * IndexedDB-backed default.
+ *
+ * Third, credentialed requests: pass `getAuthHeaders` and the returned headers
+ * ride both the HTTP RPC path and the WebSocket upgrade, since React Native has
+ * no cookie jar to attach a session implicitly.
+ *
+ * Everything on `LunoraClientOptions` is still accepted and passed through; an
+ * explicit `persistence`, `fetch`, or `WebSocket` takes precedence over the
+ * convenience derived from `storage` / `getAuthHeaders`. See the package README
+ * for a full setup example.
+ * @experimental
+ */
 declare const createLunoraClient: (options: CreateLunoraClientOptions) => LunoraClient;
 export { type AuthHeadersFactory, type CreateLunoraClientOptions, createLunoraClient };

package/dist/index.d.ts

@@ -1,78 +1,83 @@
 import { AsyncStorageLike, LunoraClientOptions, LunoraClient } from '@lunora/client';
 export * from '@lunora/react';
 /**
-* A `() => headers` factory the React Native client threads onto every HTTP RPC
-* request *and* the WebSocket upgrade — a generic escape hatch for attaching a
-* **custom** credential header (an API-gateway key, a proxy token, …) that
-* React Native's missing cookie jar can't carry implicitly. Return `undefined`
-* (or an empty object) when there's nothing to attach.
-*
-* For better-auth Expo sessions, prefer a **bearer** token instead: read it with
-* `@lunora/react-native/auth`'s `expoBearerToken` and feed it to
-* `client.setAuthToken` / `setWsToken` (see the package README). A bearer avoids
-* the `Cookie` header the runtime's CSRF guard rejects on `Origin`-less native
-* requests.
-* @experimental
-*/
+ * A `() => headers` factory the React Native client threads onto every HTTP RPC
+ * request *and* the WebSocket upgrade — a generic escape hatch for attaching a
+ * **custom** credential header (an API-gateway key, a proxy token, …) that
+ * React Native's missing cookie jar can't carry implicitly. Return `undefined`
+ * (or an empty object) when there's nothing to attach.
+ *
+ * For better-auth Expo sessions, prefer a **bearer** token instead: read it with
+ * `@lunora/react-native/auth`'s `expoBearerToken` and feed it to
+ * `client.setAuthToken` / `setWsToken` (see the package README). A bearer avoids
+ * the `Cookie` header the runtime's CSRF guard rejects on `Origin`-less native
+ * requests.
+ * @experimental
+ */
 type AuthHeadersFactory = () => Record<string, string> | undefined;
 /**
-* Options for `createLunoraClient` — the React Native / Expo counterpart to
-* constructing a `LunoraClient` directly. It is `LunoraClientOptions` with two
-* React-Native-shaped conveniences layered on. `storage` wires the
-* AsyncStorage-backed offline-queue persistence for you (the browser default
-* auto-probes IndexedDB, which React Native lacks, so without this the queue
-* stays in memory and is lost on reload). `getAuthHeaders` is a generic escape
-* hatch for a custom credential header on both the HTTP RPC path and the
-* WebSocket upgrade; for better-auth sessions prefer a bearer token
-* (`expoBearerToken` + the client's `setAuthToken` / `setWsToken`).
-*
-* The `persistence`, `fetch`, and `WebSocket` fields of `LunoraClientOptions`
-* are still accepted and take precedence when you need full control; the two
-* conveniences are sugar over exactly those seams.
-* @experimental
-*/
+ * Options for `createLunoraClient` — the React Native / Expo counterpart to
+ * constructing a `LunoraClient` directly. It is `LunoraClientOptions` with two
+ * React-Native-shaped conveniences layered on. `storage` wires the
+ * AsyncStorage-backed offline-queue persistence for you (the browser default
+ * auto-probes IndexedDB, which React Native lacks, so without this the queue
+ * stays in memory and is lost on reload). `getAuthHeaders` is a generic escape
+ * hatch for a custom credential header on both the HTTP RPC path and the
+ * WebSocket upgrade; for better-auth sessions prefer a bearer token
+ * (`expoBearerToken` + the client's `setAuthToken` / `setWsToken`).
+ *
+ * The `persistence`, `fetch`, and `WebSocket` fields of `LunoraClientOptions`
+ * are still accepted and take precedence when you need full control; the two
+ * conveniences are sugar over exactly those seams.
+ * @experimental
+ */
 interface CreateLunoraClientOptions extends LunoraClientOptions {
   /**
-  * Attaches a credential to every HTTP RPC request and to the WebSocket
-  * upgrade request. See `AuthHeadersFactory`. When omitted, requests go out
-  * with only whatever `LunoraClient` already sets (its bearer token from
-  * `setAuthToken`, if any).
-  *
-  * Merged UNDER the client's own headers on the HTTP path (an explicit
-  * `setAuthToken` bearer wins over a same-named header here); applied to the
-  * WebSocket upgrade via a wrapping `WebSocket`, since the socket has no other
-  * way to carry credentials in React Native.
-  */
+   * Attaches a credential to every HTTP RPC request and to the WebSocket
+   * upgrade request. See `AuthHeadersFactory`. When omitted, requests go out
+   * with only whatever `LunoraClient` already sets (its bearer token from
+   * `setAuthToken`, if any).
+   *
+   * Merged UNDER the client's own headers on the HTTP path (an explicit
+   * `setAuthToken` bearer wins over a same-named header here); applied to the
+   * WebSocket upgrade via a wrapping `WebSocket`, since the socket has no other
+   * way to carry credentials in React Native.
+   */
   getAuthHeaders?: AuthHeadersFactory;
   /**
-  * React Native `AsyncStorage` (or any async key/value store with the same
-  * `getItem`/`setItem`/`removeItem` surface — Expo `SecureStore`, an in-memory
-  * map in tests). When supplied, the offline mutation queue is persisted here
-  * via `createAsyncStoragePersistence`, so writes made offline survive an app
-  * restart. Ignored when an explicit `persistence` is passed.
-  */
+   * React Native `AsyncStorage` (or any async key/value store with the same
+   * `getItem`/`setItem`/`removeItem` surface — Expo `SecureStore`, an in-memory
+   * map in tests). When supplied, the offline mutation queue is persisted here
+   * via `createAsyncStoragePersistence`, so writes made offline survive an app
+   * restart. Ignored when an explicit `persistence` is passed.
+   */
   storage?: AsyncStorageLike;
 }
 /**
-* Construct a `LunoraClient` tuned for React Native / Expo — a thin wrapper over
-* `new LunoraClient(options)` that fills in the two things a browser gets for
-* free but React Native does not.
-*
-* First, a durable offline queue: pass `storage` (React Native `AsyncStorage`,
-* or any async key/value store) and the offline mutation queue is persisted
-* through `createAsyncStoragePersistence` — the browser default auto-probes
-* IndexedDB, which React Native lacks, so without this the queue lives only in
-* memory and is lost on reload.
-*
-* Second, credentialed requests: pass `getAuthHeaders` and the returned headers
-* ride both the HTTP RPC path and the WebSocket upgrade, since React Native has
-* no cookie jar to attach a session implicitly.
-*
-* Everything on `LunoraClientOptions` is still accepted and passed through; an
-* explicit `persistence`, `fetch`, or `WebSocket` takes precedence over the
-* convenience derived from `storage` / `getAuthHeaders`. See the package README
-* for a full setup example.
-* @experimental
-*/
+ * Construct a `LunoraClient` tuned for React Native / Expo — a thin wrapper over
+ * `new LunoraClient(options)` that fills in the three things a browser gets for
+ * free but React Native does not.
+ *
+ * First, a durable offline queue: pass `storage` (React Native `AsyncStorage`,
+ * or any async key/value store) and the offline mutation queue is persisted
+ * through `createAsyncStoragePersistence` — the browser default auto-probes
+ * IndexedDB, which React Native lacks, so without this the queue lives only in
+ * memory and is lost on reload.
+ *
+ * Second, a durable read cache: the same `storage` also backs the query cache
+ * through `createAsyncStorageQueryCache`, so cached reads render immediately
+ * after a restart while the socket reconnects — mirroring the browser's
+ * IndexedDB-backed default.
+ *
+ * Third, credentialed requests: pass `getAuthHeaders` and the returned headers
+ * ride both the HTTP RPC path and the WebSocket upgrade, since React Native has
+ * no cookie jar to attach a session implicitly.
+ *
+ * Everything on `LunoraClientOptions` is still accepted and passed through; an
+ * explicit `persistence`, `fetch`, or `WebSocket` takes precedence over the
+ * convenience derived from `storage` / `getAuthHeaders`. See the package README
+ * for a full setup example.
+ * @experimental
+ */
 declare const createLunoraClient: (options: CreateLunoraClientOptions) => LunoraClient;
 export { type AuthHeadersFactory, type CreateLunoraClientOptions, createLunoraClient };

package/dist/index.mjs

@@ -1,2 +1 @@
-export { createLunoraClient } from './packem_shared/createLunoraClient-D9i-IKbc.mjs';
-export * from '@lunora/react';
+import{createLunoraClient as o}from"./packem_shared/createLunoraClient-DriS3kEf.mjs";export*from"@lunora/react";export{o as createLunoraClient};

package/dist/packem_shared/createLunoraClient-DriS3kEf.mjs

@@ -0,0 +1 @@
+import{LunoraClient as h,createAsyncStorageQueryCache as d,createAsyncStoragePersistence as u}from"@lunora/client";const f=(r,t)=>(c,e)=>{const s=t();if(!s)return r(c,e);const o=new Headers(s);return e?.headers&&new Headers(e.headers).forEach((n,a)=>{o.set(a,n)}),r(c,{...e,headers:o})},i=(r,t)=>class extends r{constructor(e,s){const o=t();super(e,s,o?{headers:o}:void 0)}},k=r=>{const{getAuthHeaders:t,storage:c,...e}=r,s=t&&e.fetch===void 0&&typeof fetch=="function"?f(fetch.bind(globalThis),t):e.fetch,o=t&&e.WebSocket===void 0&&typeof WebSocket=="function"?i(WebSocket,t):e.WebSocket;return new h({...e,persistence:e.persistence??(c?u({storage:c}):void 0),queryCache:e.queryCache??(c?d({storage:c}):void 0),fetch:s,WebSocket:o})};export{k as createLunoraClient,f as withAuthHeaders,i as withAuthWebSocket};

package/dist/packem_shared/expoBearerToken-CA88JtQp.mjs

@@ -0,0 +1 @@
+const t=/(?:^|;)[^;=]*session_token=([^;]+)/,n=async e=>t.exec(await e.getCookie())?.[1]??null;export{n as default};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/react-native",
-  "version": "1.0.0-alpha.4",
+  "version": "1.0.0-alpha.41",
   "description": "React Native / Expo integration for Lunora: an AsyncStorage-backed client factory, the useQuery/useMutation/useSubscription hooks, and a one-call better-auth Expo client",
   "keywords": [
     "cloudflare",
@@ -50,13 +50,13 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/client": "1.0.0-alpha.24",
-    "@lunora/react": "1.0.0-alpha.28"
+    "@lunora/client": "1.0.0-alpha.61",
+    "@lunora/react": "1.0.0-alpha.66"
   },
   "peerDependencies": {
-    "@better-auth/expo": "^1.6.23",
+    "@better-auth/expo": "^1.7.1",
     "@tanstack/react-query": "^5.101.0",
-    "better-auth": "^1.6.23",
+    "better-auth": "^1.7.1",
     "react": "^19.2.7"
   },
   "peerDependenciesMeta": {

package/dist/packem_shared/createLunoraClient-D9i-IKbc.mjs

@@ -1,36 +0,0 @@
-import { LunoraClient, createAsyncStoragePersistence } from '@lunora/client';
-
-const withAuthHeaders = (fetchImpl, getAuthHeaders) => (input, init) => {
-  const extra = getAuthHeaders();
-  if (!extra) {
-    return fetchImpl(input, init);
-  }
-  const merged = new Headers(extra);
-  if (init?.headers) {
-    new Headers(init.headers).forEach((value, key) => {
-      merged.set(key, value);
-    });
-  }
-  return fetchImpl(input, { ...init, headers: merged });
-};
-const withAuthWebSocket = (WebSocketImpl, getAuthHeaders) => class AuthWebSocket extends WebSocketImpl {
-  constructor(url, protocols) {
-    const headers = getAuthHeaders();
-    super(url, protocols, headers ? { headers } : void 0);
-  }
-};
-const createLunoraClient = (options) => {
-  const { getAuthHeaders, storage, ...rest } = options;
-  const authedFetch = getAuthHeaders && rest.fetch === void 0 && typeof fetch === "function" ? withAuthHeaders(fetch.bind(globalThis), getAuthHeaders) : rest.fetch;
-  const authedWebSocket = getAuthHeaders && rest.WebSocket === void 0 && typeof WebSocket === "function" ? withAuthWebSocket(WebSocket, getAuthHeaders) : rest.WebSocket;
-  return new LunoraClient({
-    ...rest,
-    // Auto-wire AsyncStorage persistence unless the caller passed an explicit
-    // `persistence` (including `false` to opt out).
-    persistence: rest.persistence ?? (storage ? createAsyncStoragePersistence({ storage }) : void 0),
-    fetch: authedFetch,
-    WebSocket: authedWebSocket
-  });
-};
-
-export { createLunoraClient, withAuthHeaders, withAuthWebSocket };

package/dist/packem_shared/expoBearerToken-B0Zorz--.mjs

@@ -1,7 +0,0 @@
-const SESSION_TOKEN_COOKIE = /(?:^|;)[^;=]*session_token=([^;]+)/;
-const expoBearerToken = (authClient) => {
-  const match = SESSION_TOKEN_COOKIE.exec(authClient.getCookie());
-  return match?.[1] ?? null;
-};
-
-export { expoBearerToken as default };