@lunora/react-native 1.0.0-alpha.8 → 1.0.0-alpha.80

package/README.md

@@ -16,8 +16,9 @@ two seams a native app needs that a browser gives you for free: a durable offlin
 queue backed by `AsyncStorage`, and credentialed requests (there is no cookie jar
 in React Native, so the session has to be attached explicitly).
 
-This package **re-exports the entire `@lunora/react` surface**, so you import
-your hooks and provider from here, and adds:
+This package **re-exports the whole `@lunora/react` surface** (see
+[below](#re-exported-lunorareact-surface)), so you import your hooks and
+provider from here, and adds:
 
 - `createLunoraClient(options)` — a `LunoraClient` factory tuned for React
   Native.
@@ -131,10 +132,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
@@ -199,6 +214,23 @@ Everything on `LunoraClientOptions` (`url`, `wsUrl`, `authBasePath`,
 An explicit `persistence`, `fetch`, or `WebSocket` always takes precedence over
 the convenience derived from `storage` / `getAuthHeaders`.
 
+### Re-exported `@lunora/react` surface
+
+Every hook, provider, and auth gate from [`@lunora/react`](../react) is
+re-exported here, wholesale — a new hook there lands on native with no edit to
+this package.
+
+The payment kit is **not** part of that surface: `CheckoutButton`,
+`CustomerPortalButton`, and `useCheckout` render a DOM `<button>` and navigate
+via `globalThis.location`, so they ship from the `@lunora/react/payment` subpath
+rather than the `@lunora/react` root, and nothing re-exports them here. Drive
+purchases through the platform's own flow (or a WebView pointed at the web
+checkout URL).
+
+`useVoiceAgent` is re-exported but its defaults are Web APIs (`getUserMedia`,
+Web Audio, `WebSocket`): on native, pass your own `createMicrophone` /
+`createSpeaker` implementations.
+
 ### `@lunora/react-native/auth`
 
 - `expoBearerToken(authClient)` — reads the better-auth Expo session token (from

package/dist/auth.d.mts

@@ -1,4 +1,20 @@
-export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';
+export {
+/**
+ * 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';
 /**
  * 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)`
@@ -9,29 +25,27 @@ export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@bett
  * 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.
+ * 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 = expoBearerToken(authClient);
+ * const token = await 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 — 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 };
+  getCookie: () => Promise<string> | string;
+}) => Promise<null | string>;
+export { expoBearerToken };

package/dist/auth.d.ts

@@ -1,4 +1,20 @@
-export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';
+export {
+/**
+ * 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';
 /**
  * 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)`
@@ -9,29 +25,27 @@ export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@bett
  * 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.
+ * 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 = expoBearerToken(authClient);
+ * const token = await 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 — 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 };
+  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

@@ -47,15 +47,21 @@ interface CreateLunoraClientOptions extends LunoraClientOptions {
   /**
    * 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.
+   * map in tests). When supplied it backs two independent caches: the offline
+   * mutation queue (via `createAsyncStoragePersistence`, so writes made offline
+   * survive an app restart) and the durable query cache (via
+   * `createAsyncStorageQueryCache`, so reads repaint before the socket
+   * reconnects).
+   *
+   * Each is opted out of by its own option, not by the other: `persistence`
+   * overrides the queue and `queryCache` overrides the read cache, so
+   * `{ persistence: false, storage }` still writes query results to storage.
    */
   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
+ * `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`,
@@ -64,13 +70,20 @@ interface CreateLunoraClientOptions extends LunoraClientOptions {
  * 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
+ * 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
+ * explicit `persistence`, `queryCache`, `fetch`, or `WebSocket` takes precedence
+ * over the convenience derived from `storage` / `getAuthHeaders`. `persistence`
+ * and `queryCache` override independently — `storage` backs both, so opting out
+ * of one leaves the other wired. See the package README
  * for a full setup example.
  * @experimental
  */

package/dist/index.d.ts

@@ -47,15 +47,21 @@ interface CreateLunoraClientOptions extends LunoraClientOptions {
   /**
    * 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.
+   * map in tests). When supplied it backs two independent caches: the offline
+   * mutation queue (via `createAsyncStoragePersistence`, so writes made offline
+   * survive an app restart) and the durable query cache (via
+   * `createAsyncStorageQueryCache`, so reads repaint before the socket
+   * reconnects).
+   *
+   * Each is opted out of by its own option, not by the other: `persistence`
+   * overrides the queue and `queryCache` overrides the read cache, so
+   * `{ persistence: false, storage }` still writes query results to storage.
    */
   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
+ * `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`,
@@ -64,13 +70,20 @@ interface CreateLunoraClientOptions extends LunoraClientOptions {
  * 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
+ * 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
+ * explicit `persistence`, `queryCache`, `fetch`, or `WebSocket` takes precedence
+ * over the convenience derived from `storage` / `getAuthHeaders`. `persistence`
+ * and `queryCache` override independently — `storage` backs both, so opting out
+ * of one leaves the other wired. See the package README
  * for a full setup example.
  * @experimental
  */

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.8",
+  "version": "1.0.0-alpha.80",
   "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.28",
-    "@lunora/react": "1.0.0-alpha.32"
+    "@lunora/client": "1.0.0-alpha.101",
+    "@lunora/react": "1.0.0-alpha.106"
   },
   "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 };