@lunora/react-native 0.0.0 → 1.0.0-alpha.2

package/dist/auth.d.mts

@@ -0,0 +1,35 @@
+export { 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)`
+* 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);
+* ```
+*/
+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.
+*/
+interface SecureStorageLike {
+  getItem: (key: string) => null | string;
+  setItem: (key: string, value: string) => unknown;
+}
+export { SecureStorageLike, expoBearerToken };

package/dist/auth.d.ts

@@ -0,0 +1,35 @@
+export { 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)`
+* 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);
+* ```
+*/
+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.
+*/
+interface SecureStorageLike {
+  getItem: (key: string) => null | string;
+  setItem: (key: string, value: string) => unknown;
+}
+export { SecureStorageLike, expoBearerToken };

package/dist/auth.mjs

@@ -0,0 +1,2 @@
+export { default as expoBearerToken } from './packem_shared/expoBearerToken-B0Zorz--.mjs';
+export { expoClient, setupExpoFocusManager, setupExpoOnlineManager } from '@better-auth/expo/client';

package/dist/index.d.mts

@@ -0,0 +1,75 @@
+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.
+*/
+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.
+*/
+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.
+  */
+  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.
+  */
+  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.
+*/
+declare const createLunoraClient: (options: CreateLunoraClientOptions) => LunoraClient;
+export { type AuthHeadersFactory, type CreateLunoraClientOptions, createLunoraClient };

package/dist/index.d.ts

@@ -0,0 +1,75 @@
+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.
+*/
+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.
+*/
+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.
+  */
+  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.
+  */
+  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.
+*/
+declare const createLunoraClient: (options: CreateLunoraClientOptions) => LunoraClient;
+export { type AuthHeadersFactory, type CreateLunoraClientOptions, createLunoraClient };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+export { createLunoraClient } from './packem_shared/createLunoraClient-D9i-IKbc.mjs';
+export * from '@lunora/react';

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

@@ -0,0 +1,36 @@
+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

@@ -0,0 +1,7 @@
+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 };

package/package.json

@@ -1,10 +1,73 @@
 {
   "name": "@lunora/react-native",
-  "version": "0.0.0",
-  "description": "OIDC trusted publishing setup package for @lunora/react-native",
+  "version": "1.0.0-alpha.2",
+  "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": [
-    "oidc",
-    "trusted-publishing",
-    "setup"
-  ]
-}
+    "cloudflare",
+    "durable-objects",
+    "expo",
+    "hooks",
+    "lunora",
+    "react-native",
+    "realtime",
+    "usequery",
+    "workers"
+  ],
+  "homepage": "https://lunora.sh",
+  "bugs": "https://github.com/anolilab/lunora/issues",
+  "license": "FSL-1.1-Apache-2.0",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anolilab/lunora.git",
+    "directory": "packages/react-native"
+  },
+  "files": [
+    "./dist",
+    "README.md",
+    "LICENSE.md",
+    "__assets__"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs"
+    },
+    "./auth": {
+      "types": "./dist/auth.d.ts",
+      "import": "./dist/auth.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@lunora/client": "1.0.0-alpha.21",
+    "@lunora/react": "1.0.0-alpha.25"
+  },
+  "peerDependencies": {
+    "@better-auth/expo": "^1.6.23",
+    "@tanstack/react-query": "^5.101.0",
+    "better-auth": "^1.6.23",
+    "react": "^19.2.7"
+  },
+  "peerDependenciesMeta": {
+    "@better-auth/expo": {
+      "optional": true
+    },
+    "better-auth": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": "^22.15.0 || >=24.11.0"
+  }
+}