better-auth-offline 0.0.0 → 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Roman Sirokov <roman@mrlightful.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,248 @@
+# better-auth-offline
+
+[![NPM Version](https://img.shields.io/npm/v/better-auth-offline)](https://www.npmjs.com/package/better-auth-offline)
+[![NPM Downloads](https://img.shields.io/npm/dm/better-auth-offline)](https://www.npmjs.com/package/better-auth-offline)
+
+Offline-first plugin for [better-auth](https://github.com/better-auth/better-auth). Transparently caches auth API responses so your app keeps working when the network doesn't.
+
+## Why offline-first?
+
+The offline-first community is growing — and for good reason. Users expect apps to work everywhere: on flaky Wi-Fi, in airplane mode, in rural areas with spotty coverage, and on mobile devices that constantly switch between networks. PWAs, local-first architectures, and edge computing are making offline-capable apps the norm, not the exception.
+
+Authentication is often the first thing that breaks when the network drops. A user who was just signed in gets thrown to a login screen — or worse, a blank page. **better-auth-offline** fixes that. It's a drop-in plugin that caches auth responses so your users stay authenticated and your UI stays functional, even offline.
+
+No changes to your existing code. Just add the plugin.
+
+## Features
+
+- **Network-first with cache fallback** — always tries the network first, serves cached data when offline
+- **Drop-in integration** — one line to add, zero changes to your existing auth code
+- **Automatic cache invalidation** — clears cache on sign-in/sign-out to prevent cross-user data leaks
+- **Configurable allowlist** — choose which endpoints to cache, extend or replace the defaults
+- **IndexedDB storage** — persistent cache that survives page refreshes, with a pluggable storage adapter interface
+- **Online status tracking** — reactive `useOnlineStatus()` hook for your UI
+- **SSR safe** — works in server-side rendering environments without errors
+
+## Quick Start
+
+Install the plugin:
+
+```bash
+npm install better-auth-offline
+```
+
+Add it to your auth client:
+
+```ts
+import { createAuthClient } from "better-auth/react";
+import { offlinePlugin } from "better-auth-offline";
+
+const authClient = createAuthClient({
+  plugins: [offlinePlugin()],
+});
+```
+
+That's it. Your auth API responses are now cached and served when offline.
+
+## How It Works
+
+1. Your app makes a GET request to an allowlisted auth endpoint (e.g. `/api/auth/get-session`)
+2. The plugin lets the request go to the network as normal
+3. On success, the JSON response is cached in IndexedDB (fire-and-forget — doesn't slow down the response)
+4. If the network request fails (no connectivity), the plugin serves the cached response instead
+5. Cached responses include an `X-Offline-Cache: true` header so you can detect them if needed
+
+Only GET requests to allowlisted paths are cached. Mutations (sign-in, sign-out, etc.) always go to the network.
+
+## Configuration
+
+### Default mode — extend or exclude paths
+
+By default, the plugin caches a curated set of common auth endpoints. You can extend or trim this list:
+
+```ts
+offlinePlugin({
+  // Add your custom endpoints to the default list
+  includePaths: ["/my-custom-endpoint", "/user/preferences"],
+
+  // Remove endpoints you don't need cached
+  excludePaths: ["/admin/list-users"],
+})
+```
+
+### Custom mode — full control
+
+Replace the default allowlist entirely:
+
+```ts
+offlinePlugin({
+  mode: "custom",
+  allowlist: [
+    "/get-session",
+    "/list-accounts",
+    "/my-app/specific-endpoint",
+  ],
+})
+```
+
+### Custom storage adapter
+
+Swap out IndexedDB for any storage backend:
+
+```ts
+import { offlinePlugin } from "better-auth-offline";
+
+offlinePlugin({
+  storage: myCustomAdapter,
+})
+```
+
+See [Custom Storage Adapters](#custom-storage-adapters) for the interface.
+
+## Default Allowlist
+
+These endpoints are cached by default (in `mode: "default"`):
+
+| Category | Endpoints |
+|----------|-----------|
+| **Core** | `/get-session`, `/list-sessions`, `/list-accounts`, `/account-info` |
+| **Organization** | `/organization/list`, `/organization/get-active-member`, `/organization/get-active-member-role`, `/organization/get-full-organization`, `/organization/list-members`, `/organization/list-teams`, `/organization/list-invitations` |
+| **Admin** | `/admin/list-users` |
+| **Multi-session** | `/multi-session/list-device-sessions` |
+| **Passkey** | `/passkey/list-user-passkeys` |
+| **API Key** | `/api-key/get`, `/api-key/list` |
+
+Path matching uses suffix matching, so these work regardless of your `baseURL` or path prefix configuration.
+
+## Online Status
+
+The plugin exposes a reactive online/offline status hook:
+
+```tsx
+function MyComponent() {
+  const onlineStatus = authClient.useOnlineStatus();
+
+  return (
+    <div>
+      {onlineStatus ? "Online" : "Offline"}
+    </div>
+  );
+}
+```
+
+This tracks the browser's `navigator.onLine` property and listens for `online`/`offline` events. In SSR environments, it defaults to `true`.
+
+## Cache Management
+
+### Automatic invalidation
+
+The cache is automatically cleared when a user signs in or signs out. This prevents stale data from one user being served to another.
+
+### Manual cache clearing
+
+```ts
+await authClient.clearCache();
+```
+
+### Detecting cached responses
+
+Responses served from cache include the header `X-Offline-Cache: true`.
+
+## Custom Storage Adapters
+
+The plugin uses IndexedDB by default, but you can provide any storage backend that implements the `StorageAdapter` interface:
+
+```ts
+import type { StorageAdapter } from "better-auth-offline";
+
+const myAdapter: StorageAdapter = {
+  async get(key: string): Promise<unknown | null> {
+    // Return cached value or null
+  },
+  async set(key: string, value: unknown): Promise<void> {
+    // Store the value
+  },
+  async delete(key: string): Promise<void> {
+    // Remove a single entry
+  },
+  async clear(): Promise<void> {
+    // Remove all entries
+  },
+};
+
+offlinePlugin({ storage: myAdapter });
+```
+
+The built-in IndexedDB adapter can also be customized with a different database name:
+
+```ts
+import { createIndexedDBAdapter } from "better-auth-offline";
+
+offlinePlugin({
+  storage: createIndexedDBAdapter("my-custom-db-name"),
+});
+```
+
+## API Reference
+
+### Exports from `better-auth-offline`
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `offlinePlugin` | `(options?: OfflinePluginOptions) => BetterAuthClientPlugin` | Main plugin factory |
+| `createIndexedDBAdapter` | `(dbName?: string) => StorageAdapter` | Creates an IndexedDB storage adapter |
+| `createOnlineStatusAtom` | `() => Atom<boolean>` | Creates a nanostores atom tracking online status |
+| `StorageAdapter` | Type | Interface for custom storage backends |
+| `OfflinePluginOptions` | Type | Plugin configuration options |
+| `CacheEntry` | Type | Shape of cached entries (`{ data: unknown, cachedAt: number }`) |
+
+### Exports from `better-auth-offline/adapters`
+
+| Export | Type | Description |
+|--------|------|-------------|
+| `createIndexedDBAdapter` | `(dbName?: string) => StorageAdapter` | IndexedDB storage adapter (alternative import path) |
+
+## Example App
+
+The `example/` directory contains a full Next.js app demonstrating the plugin in action:
+
+- Sign in with demo credentials (`demo@example.com` / `demo`)
+- See session data cached and served offline
+- Toggle offline mode in DevTools to test
+- Inspect the IndexedDB cache directly
+
+Run it:
+
+```bash
+cd example
+bun install
+bun dev
+```
+
+## Roadmap
+
+- **Prewarming / Eager Data Loading** — Mechanism to eagerly fetch and cache endpoints on app initialization, so the cache is warm before going offline. Critical for apps that go offline unpredictably (mobile, field workers).
+
+## Contributing
+
+Contributions are welcome! This project uses:
+
+- **bun** as the package manager
+- **vitest** for testing
+- **tsup** for building
+- **turbo** for monorepo orchestration
+
+```bash
+# Install dependencies
+bun install
+
+# Run tests
+cd better-auth-offline && bun test
+
+# Build
+cd better-auth-offline && bun run build
+```
+
+## License
+
+MIT

package/dist/adapters/indexeddb.cjs

@@ -28,7 +28,9 @@ var STORE_NAME = "cache";
 function createIndexedDBAdapter(dbName = DEFAULT_DB_NAME) {
   let dbPromise = null;
   function openDB() {
-    if (dbPromise) return dbPromise;
+    if (dbPromise) {
+      return dbPromise;
+    }
     dbPromise = new Promise((resolve, reject) => {
       const request = indexedDB.open(dbName, 1);
       request.onupgradeneeded = () => {

package/dist/adapters/indexeddb.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/adapters/indexeddb.ts"],"sourcesContent":["import type { StorageAdapter, CacheEntry } from \"../types.js\";\n\nconst DEFAULT_DB_NAME = \"better-auth-offline\";\nconst STORE_NAME = \"cache\";\n\n/**\n * Creates an IndexedDB-backed storage adapter.\n *\n * @param dbName - Name of the IndexedDB database. Defaults to \"better-auth-offline\".\n */\nexport function createIndexedDBAdapter(\n  dbName: string = DEFAULT_DB_NAME,\n): StorageAdapter {\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  function openDB(): Promise<IDBDatabase> {\n    if (dbPromise) return dbPromise;\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(STORE_NAME)) {\n          db.createObjectStore(STORE_NAME);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => {\n        dbPromise = null;\n        reject(request.error);\n      };\n    });\n\n    return dbPromise;\n  }\n\n  return {\n    async get(key: string): Promise<CacheEntry | null> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readonly\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.get(key);\n          request.onsuccess = () => resolve(request.result ?? null);\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        return null;\n      }\n    },\n\n    async set(key: string, value: unknown): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.put(value, key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Fire-and-forget: swallow errors for cache writes\n      }\n    },\n\n    async delete(key: string): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.delete(key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n\n    async clear(): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.clear();\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAM,kBAAkB;AACxB,IAAM,aAAa;AAOZ,SAAS,uBACd,SAAiB,iBACD;AAChB,MAAI,YAAyC;AAE7C,WAAS,SAA+B;AACtC,QAAI,UAAW,QAAO;AAEtB,gBAAY,IAAI,QAAqB,CAAC,SAAS,WAAW;AACxD,YAAM,UAAU,UAAU,KAAK,QAAQ,CAAC;AAExC,cAAQ,kBAAkB,MAAM;AAC9B,cAAM,KAAK,QAAQ;AACnB,YAAI,CAAC,GAAG,iBAAiB,SAAS,UAAU,GAAG;AAC7C,aAAG,kBAAkB,UAAU;AAAA,QACjC;AAAA,MACF;AAEA,cAAQ,YAAY,MAAM,QAAQ,QAAQ,MAAM;AAChD,cAAQ,UAAU,MAAM;AACtB,oBAAY;AACZ,eAAO,QAAQ,KAAK;AAAA,MACtB;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM,IAAI,KAAyC;AACjD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,UAAU;AAChD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,GAAG;AAC7B,kBAAQ,YAAY,MAAM,QAAQ,QAAQ,UAAU,IAAI;AACxD,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,MAAM,IAAI,KAAa,OAA+B;AACpD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,OAAO,GAAG;AACpC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,OAAO,KAA4B;AACvC,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,OAAO,GAAG;AAChC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,QAAuB;AAC3B,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,MAAM;AAC5B,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/adapters/indexeddb.ts"],"sourcesContent":["import type { CacheEntry, StorageAdapter } from \"../types.js\";\n\nconst DEFAULT_DB_NAME = \"better-auth-offline\";\nconst STORE_NAME = \"cache\";\n\n/**\n * Creates an IndexedDB-backed storage adapter.\n *\n * @param dbName - Name of the IndexedDB database. Defaults to \"better-auth-offline\".\n */\nexport function createIndexedDBAdapter(\n  dbName: string = DEFAULT_DB_NAME\n): StorageAdapter {\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  function openDB(): Promise<IDBDatabase> {\n    if (dbPromise) {\n      return dbPromise;\n    }\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(STORE_NAME)) {\n          db.createObjectStore(STORE_NAME);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => {\n        dbPromise = null;\n        reject(request.error);\n      };\n    });\n\n    return dbPromise;\n  }\n\n  return {\n    async get(key: string): Promise<CacheEntry | null> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readonly\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.get(key);\n          request.onsuccess = () => resolve(request.result ?? null);\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        return null;\n      }\n    },\n\n    async set(key: string, value: unknown): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.put(value, key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Fire-and-forget: swallow errors for cache writes\n      }\n    },\n\n    async delete(key: string): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.delete(key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n\n    async clear(): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.clear();\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAEA,IAAM,kBAAkB;AACxB,IAAM,aAAa;AAOZ,SAAS,uBACd,SAAiB,iBACD;AAChB,MAAI,YAAyC;AAE7C,WAAS,SAA+B;AACtC,QAAI,WAAW;AACb,aAAO;AAAA,IACT;AAEA,gBAAY,IAAI,QAAqB,CAAC,SAAS,WAAW;AACxD,YAAM,UAAU,UAAU,KAAK,QAAQ,CAAC;AAExC,cAAQ,kBAAkB,MAAM;AAC9B,cAAM,KAAK,QAAQ;AACnB,YAAI,CAAC,GAAG,iBAAiB,SAAS,UAAU,GAAG;AAC7C,aAAG,kBAAkB,UAAU;AAAA,QACjC;AAAA,MACF;AAEA,cAAQ,YAAY,MAAM,QAAQ,QAAQ,MAAM;AAChD,cAAQ,UAAU,MAAM;AACtB,oBAAY;AACZ,eAAO,QAAQ,KAAK;AAAA,MACtB;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM,IAAI,KAAyC;AACjD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,UAAU;AAChD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,GAAG;AAC7B,kBAAQ,YAAY,MAAM,QAAQ,QAAQ,UAAU,IAAI;AACxD,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,MAAM,IAAI,KAAa,OAA+B;AACpD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,OAAO,GAAG;AACpC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,OAAO,KAA4B;AACvC,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,OAAO,GAAG;AAChC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,QAAuB;AAC3B,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,MAAM;AAC5B,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/adapters/indexeddb.d.cts

@@ -1 +1 @@
-export { c as createIndexedDBAdapter } from '../indexeddb-CkUWH5Sl.cjs';
+export { c as createIndexedDBAdapter } from '../indexeddb-B7LON8ue.cjs';

package/dist/adapters/indexeddb.d.ts

@@ -1 +1 @@
-export { c as createIndexedDBAdapter } from '../indexeddb-CkUWH5Sl.js';
+export { c as createIndexedDBAdapter } from '../indexeddb-B7LON8ue.js';

package/dist/adapters/indexeddb.js

@@ -1,6 +1,6 @@
 import {
   createIndexedDBAdapter
-} from "../chunk-JPTDSCSW.js";
+} from "../chunk-NFJRQCGL.js";
 export {
   createIndexedDBAdapter
 };

package/dist/{chunk-JPTDSCSW.js → chunk-NFJRQCGL.js}

@@ -4,7 +4,9 @@ var STORE_NAME = "cache";
 function createIndexedDBAdapter(dbName = DEFAULT_DB_NAME) {
   let dbPromise = null;
   function openDB() {
-    if (dbPromise) return dbPromise;
+    if (dbPromise) {
+      return dbPromise;
+    }
     dbPromise = new Promise((resolve, reject) => {
       const request = indexedDB.open(dbName, 1);
       request.onupgradeneeded = () => {
@@ -81,4 +83,4 @@ function createIndexedDBAdapter(dbName = DEFAULT_DB_NAME) {
 export {
   createIndexedDBAdapter
 };
-//# sourceMappingURL=chunk-JPTDSCSW.js.map
+//# sourceMappingURL=chunk-NFJRQCGL.js.map

package/dist/chunk-NFJRQCGL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/indexeddb.ts"],"sourcesContent":["import type { CacheEntry, StorageAdapter } from \"../types.js\";\n\nconst DEFAULT_DB_NAME = \"better-auth-offline\";\nconst STORE_NAME = \"cache\";\n\n/**\n * Creates an IndexedDB-backed storage adapter.\n *\n * @param dbName - Name of the IndexedDB database. Defaults to \"better-auth-offline\".\n */\nexport function createIndexedDBAdapter(\n  dbName: string = DEFAULT_DB_NAME\n): StorageAdapter {\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  function openDB(): Promise<IDBDatabase> {\n    if (dbPromise) {\n      return dbPromise;\n    }\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(STORE_NAME)) {\n          db.createObjectStore(STORE_NAME);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => {\n        dbPromise = null;\n        reject(request.error);\n      };\n    });\n\n    return dbPromise;\n  }\n\n  return {\n    async get(key: string): Promise<CacheEntry | null> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readonly\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.get(key);\n          request.onsuccess = () => resolve(request.result ?? null);\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        return null;\n      }\n    },\n\n    async set(key: string, value: unknown): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.put(value, key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Fire-and-forget: swallow errors for cache writes\n      }\n    },\n\n    async delete(key: string): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.delete(key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n\n    async clear(): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.clear();\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n  };\n}\n"],"mappings":";AAEA,IAAM,kBAAkB;AACxB,IAAM,aAAa;AAOZ,SAAS,uBACd,SAAiB,iBACD;AAChB,MAAI,YAAyC;AAE7C,WAAS,SAA+B;AACtC,QAAI,WAAW;AACb,aAAO;AAAA,IACT;AAEA,gBAAY,IAAI,QAAqB,CAAC,SAAS,WAAW;AACxD,YAAM,UAAU,UAAU,KAAK,QAAQ,CAAC;AAExC,cAAQ,kBAAkB,MAAM;AAC9B,cAAM,KAAK,QAAQ;AACnB,YAAI,CAAC,GAAG,iBAAiB,SAAS,UAAU,GAAG;AAC7C,aAAG,kBAAkB,UAAU;AAAA,QACjC;AAAA,MACF;AAEA,cAAQ,YAAY,MAAM,QAAQ,QAAQ,MAAM;AAChD,cAAQ,UAAU,MAAM;AACtB,oBAAY;AACZ,eAAO,QAAQ,KAAK;AAAA,MACtB;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM,IAAI,KAAyC;AACjD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,UAAU;AAChD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,GAAG;AAC7B,kBAAQ,YAAY,MAAM,QAAQ,QAAQ,UAAU,IAAI;AACxD,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,MAAM,IAAI,KAAa,OAA+B;AACpD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,OAAO,GAAG;AACpC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,OAAO,KAA4B;AACvC,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,OAAO,GAAG;AAChC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,QAAuB;AAC3B,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,MAAM;AAC5B,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/index.cjs

@@ -26,6 +26,88 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
+// src/adapters/indexeddb.ts
+var DEFAULT_DB_NAME = "better-auth-offline";
+var STORE_NAME = "cache";
+function createIndexedDBAdapter(dbName = DEFAULT_DB_NAME) {
+  let dbPromise = null;
+  function openDB() {
+    if (dbPromise) {
+      return dbPromise;
+    }
+    dbPromise = new Promise((resolve, reject) => {
+      const request = indexedDB.open(dbName, 1);
+      request.onupgradeneeded = () => {
+        const db = request.result;
+        if (!db.objectStoreNames.contains(STORE_NAME)) {
+          db.createObjectStore(STORE_NAME);
+        }
+      };
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => {
+        dbPromise = null;
+        reject(request.error);
+      };
+    });
+    return dbPromise;
+  }
+  return {
+    async get(key) {
+      try {
+        const db = await openDB();
+        return new Promise((resolve, reject) => {
+          const tx = db.transaction(STORE_NAME, "readonly");
+          const store = tx.objectStore(STORE_NAME);
+          const request = store.get(key);
+          request.onsuccess = () => resolve(request.result ?? null);
+          request.onerror = () => reject(request.error);
+        });
+      } catch {
+        return null;
+      }
+    },
+    async set(key, value) {
+      try {
+        const db = await openDB();
+        return new Promise((resolve, reject) => {
+          const tx = db.transaction(STORE_NAME, "readwrite");
+          const store = tx.objectStore(STORE_NAME);
+          const request = store.put(value, key);
+          request.onsuccess = () => resolve();
+          request.onerror = () => reject(request.error);
+        });
+      } catch {
+      }
+    },
+    async delete(key) {
+      try {
+        const db = await openDB();
+        return new Promise((resolve, reject) => {
+          const tx = db.transaction(STORE_NAME, "readwrite");
+          const store = tx.objectStore(STORE_NAME);
+          const request = store.delete(key);
+          request.onsuccess = () => resolve();
+          request.onerror = () => reject(request.error);
+        });
+      } catch {
+      }
+    },
+    async clear() {
+      try {
+        const db = await openDB();
+        return new Promise((resolve, reject) => {
+          const tx = db.transaction(STORE_NAME, "readwrite");
+          const store = tx.objectStore(STORE_NAME);
+          const request = store.clear();
+          request.onsuccess = () => resolve();
+          request.onerror = () => reject(request.error);
+        });
+      } catch {
+      }
+    }
+  };
+}
+
 // src/allowlist.ts
 var DEFAULT_ALLOWLIST = [
   // Core
@@ -61,7 +143,7 @@ function getAllowlist(options) {
 }
 function isAllowlisted(path, allowlist) {
   return allowlist.some(
-    (allowed) => path === allowed || path.endsWith(allowed) || path.includes(allowed + "/")
+    (allowed) => path === allowed || path.endsWith(allowed) || path.includes(`${allowed}/`)
   );
 }
 
@@ -69,7 +151,9 @@ function isAllowlisted(path, allowlist) {
 function extractPath(urlOrPath) {
   try {
     const url = typeof urlOrPath === "string" && urlOrPath.startsWith("http") ? new URL(urlOrPath) : null;
-    if (url) return url.pathname;
+    if (url) {
+      return url.pathname;
+    }
   } catch {
   }
   const str = typeof urlOrPath === "string" ? urlOrPath : urlOrPath.pathname;
@@ -77,8 +161,12 @@ function extractPath(urlOrPath) {
   return qIndex >= 0 ? str.slice(0, qIndex) : str;
 }
 function isNetworkError(error) {
-  if (error instanceof TypeError) return true;
-  if (error instanceof DOMException && error.name === "AbortError") return true;
+  if (error instanceof TypeError) {
+    return true;
+  }
+  if (error instanceof DOMException && error.name === "AbortError") {
+    return true;
+  }
   return false;
 }
 function createOfflineFetchPlugin(storage, options) {
@@ -146,86 +234,6 @@ function createOnlineStatusAtom() {
   return isOnline;
 }
 
-// src/adapters/indexeddb.ts
-var DEFAULT_DB_NAME = "better-auth-offline";
-var STORE_NAME = "cache";
-function createIndexedDBAdapter(dbName = DEFAULT_DB_NAME) {
-  let dbPromise = null;
-  function openDB() {
-    if (dbPromise) return dbPromise;
-    dbPromise = new Promise((resolve, reject) => {
-      const request = indexedDB.open(dbName, 1);
-      request.onupgradeneeded = () => {
-        const db = request.result;
-        if (!db.objectStoreNames.contains(STORE_NAME)) {
-          db.createObjectStore(STORE_NAME);
-        }
-      };
-      request.onsuccess = () => resolve(request.result);
-      request.onerror = () => {
-        dbPromise = null;
-        reject(request.error);
-      };
-    });
-    return dbPromise;
-  }
-  return {
-    async get(key) {
-      try {
-        const db = await openDB();
-        return new Promise((resolve, reject) => {
-          const tx = db.transaction(STORE_NAME, "readonly");
-          const store = tx.objectStore(STORE_NAME);
-          const request = store.get(key);
-          request.onsuccess = () => resolve(request.result ?? null);
-          request.onerror = () => reject(request.error);
-        });
-      } catch {
-        return null;
-      }
-    },
-    async set(key, value) {
-      try {
-        const db = await openDB();
-        return new Promise((resolve, reject) => {
-          const tx = db.transaction(STORE_NAME, "readwrite");
-          const store = tx.objectStore(STORE_NAME);
-          const request = store.put(value, key);
-          request.onsuccess = () => resolve();
-          request.onerror = () => reject(request.error);
-        });
-      } catch {
-      }
-    },
-    async delete(key) {
-      try {
-        const db = await openDB();
-        return new Promise((resolve, reject) => {
-          const tx = db.transaction(STORE_NAME, "readwrite");
-          const store = tx.objectStore(STORE_NAME);
-          const request = store.delete(key);
-          request.onsuccess = () => resolve();
-          request.onerror = () => reject(request.error);
-        });
-      } catch {
-      }
-    },
-    async clear() {
-      try {
-        const db = await openDB();
-        return new Promise((resolve, reject) => {
-          const tx = db.transaction(STORE_NAME, "readwrite");
-          const store = tx.objectStore(STORE_NAME);
-          const request = store.clear();
-          request.onsuccess = () => resolve();
-          request.onerror = () => reject(request.error);
-        });
-      } catch {
-      }
-    }
-  };
-}
-
 // src/index.ts
 var SIGN_OUT_PATHS = ["/sign-out", "/signout", "/logout"];
 var SIGN_IN_PATHS = ["/sign-in", "/signin", "/login"];

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/allowlist.ts","../src/fetch-plugin.ts","../src/online-status.ts","../src/adapters/indexeddb.ts"],"sourcesContent":["import type { BetterAuthClientPlugin } from \"better-auth/client\";\nimport type { OfflinePluginOptions, StorageAdapter } from \"./types.js\";\nimport { createOfflineFetchPlugin } from \"./fetch-plugin.js\";\nimport { createOnlineStatusAtom } from \"./online-status.js\";\nimport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\n\n// Re-export types for consumers\nexport type { StorageAdapter, OfflinePluginOptions, CacheEntry } from \"./types.js\";\nexport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\nexport { createOnlineStatusAtom } from \"./online-status.js\";\n\nconst SIGN_OUT_PATHS = [\"/sign-out\", \"/signout\", \"/logout\"];\nconst SIGN_IN_PATHS = [\"/sign-in\", \"/signin\", \"/login\"];\n\nfunction isAuthChangePath(path: string): boolean {\n  return (\n    SIGN_OUT_PATHS.some((p) => path.includes(p)) ||\n    SIGN_IN_PATHS.some((p) => path.includes(p))\n  );\n}\n\n/**\n * better-auth offline plugin.\n *\n * Transparently caches GET API responses and serves them when offline.\n * Drop-in: no consumer code changes required.\n *\n * @example\n * ```ts\n * import { createAuthClient } from \"better-auth/client\";\n * import { offlinePlugin } from \"better-auth-offline\";\n *\n * const authClient = createAuthClient({\n *   plugins: [offlinePlugin()],\n * });\n * ```\n */\nexport function offlinePlugin(\n  options: OfflinePluginOptions = {},\n): BetterAuthClientPlugin {\n  const storage: StorageAdapter =\n    options.storage ?? createIndexedDBAdapter();\n\n  return {\n    id: \"better-auth-offline\",\n\n    getAtoms() {\n      return {\n        onlineStatus: createOnlineStatusAtom(),\n      };\n    },\n\n    fetchPlugins: [createOfflineFetchPlugin(storage, options)],\n\n    atomListeners: [\n      {\n        matcher(path: string) {\n          return isAuthChangePath(path);\n        },\n        signal: \"$sessionSignal\",\n        callback() {\n          // Clear cache on sign-out / sign-in to prevent cross-user data leaks\n          storage.clear();\n        },\n      },\n    ],\n\n    getActions() {\n      return {\n        clearCache: () => storage.clear(),\n      };\n    },\n  };\n}\n","import type { OfflinePluginOptions } from \"./types.js\";\n\n/**\n * Default paths that are cached for offline access.\n * Only GET requests to these paths will be cached.\n */\nconst DEFAULT_ALLOWLIST = [\n  // Core\n  \"/get-session\",\n  \"/list-sessions\",\n  \"/list-accounts\",\n  \"/account-info\",\n  // Organization\n  \"/organization/list\",\n  \"/organization/get-active-member\",\n  \"/organization/get-active-member-role\",\n  \"/organization/get-full-organization\",\n  \"/organization/list-members\",\n  \"/organization/list-teams\",\n  \"/organization/list-invitations\",\n  // Admin\n  \"/admin/list-users\",\n  // Multi-session\n  \"/multi-session/list-device-sessions\",\n  // Passkey\n  \"/passkey/list-user-passkeys\",\n  // API Key\n  \"/api-key/get\",\n  \"/api-key/list\",\n];\n\n/**\n * Get the effective allowlist based on plugin options.\n */\nexport function getAllowlist(options: OfflinePluginOptions): string[] {\n  if (options.mode === \"custom\") {\n    return options.allowlist;\n  }\n  const exclude = new Set(options.excludePaths ?? []);\n  const base = exclude.size > 0\n    ? DEFAULT_ALLOWLIST.filter((p) => !exclude.has(p))\n    : DEFAULT_ALLOWLIST;\n  return [...base, ...(options.includePaths ?? [])];\n}\n\n/**\n * Check if a path should be cached.\n * Uses suffix matching to handle configurable base path prefixes.\n */\nexport function isAllowlisted(\n  path: string,\n  allowlist: string[],\n): boolean {\n  return allowlist.some(\n    (allowed) =>\n      path === allowed ||\n      path.endsWith(allowed) ||\n      path.includes(allowed + \"/\"),\n  );\n}\n","import type { BetterFetchPlugin } from \"@better-fetch/fetch\";\nimport type { StorageAdapter, CacheEntry, OfflinePluginOptions } from \"./types.js\";\nimport { getAllowlist, isAllowlisted } from \"./allowlist.js\";\n\n/**\n * Extracts the pathname from a URL string, stripping query params.\n * Used as the cache key.\n */\nexport function extractPath(urlOrPath: string | URL): string {\n  try {\n    const url = typeof urlOrPath === \"string\" && urlOrPath.startsWith(\"http\")\n      ? new URL(urlOrPath)\n      : null;\n    if (url) return url.pathname;\n  } catch {\n    // Not a valid URL, treat as path\n  }\n  // Strip query string from path\n  const str = typeof urlOrPath === \"string\" ? urlOrPath : urlOrPath.pathname;\n  const qIndex = str.indexOf(\"?\");\n  return qIndex >= 0 ? str.slice(0, qIndex) : str;\n}\n\n/**\n * Checks if a network error is a connectivity failure (not an HTTP error).\n */\nfunction isNetworkError(error: unknown): boolean {\n  if (error instanceof TypeError) return true;\n  if (error instanceof DOMException && error.name === \"AbortError\") return true;\n  return false;\n}\n\n/**\n * Creates the BetterFetchPlugin that provides offline caching.\n *\n * Strategy: Network-First with Cache Fallback\n * - Uses `init` to inject a custom fetch that wraps the real fetch\n * - On successful GET: caches the response body (fire-and-forget)\n * - On network error for GET: serves cached response if available\n * - Only allowlisted GET paths are cached; everything else passes through\n */\nexport function createOfflineFetchPlugin(\n  storage: StorageAdapter,\n  options: OfflinePluginOptions,\n): BetterFetchPlugin {\n  const allowlist = getAllowlist(options);\n\n  return {\n    id: \"better-auth-offline\",\n    name: \"better-auth-offline\",\n\n    init(url, fetchOptions) {\n      const originalFetch = fetchOptions?.customFetchImpl ?? globalThis.fetch;\n      const method = (fetchOptions?.method ?? \"GET\").toUpperCase();\n      const path = extractPath(url);\n      const shouldCache = method === \"GET\" && isAllowlisted(path, allowlist);\n\n      const wrappedFetch: typeof globalThis.fetch = async (input, init) => {\n        if (!shouldCache) {\n          return originalFetch(input, init);\n        }\n\n        try {\n          const response = await originalFetch(input, init);\n\n          // Cache successful GET responses (fire-and-forget)\n          if (response.ok) {\n            // Clone before reading body so the original response remains usable\n            const clone = response.clone();\n            clone.json().then((data) => {\n              const entry: CacheEntry = { data, cachedAt: Date.now() };\n              storage.set(path, entry);\n            }).catch(() => {\n              // Response wasn't JSON or read failed — skip caching\n            });\n          }\n\n          return response;\n        } catch (error) {\n          // Network error — try serving from cache\n          if (isNetworkError(error)) {\n            const cached = await storage.get(path) as CacheEntry | null;\n            if (cached) {\n              return new Response(JSON.stringify(cached.data), {\n                status: 200,\n                headers: {\n                  \"Content-Type\": \"application/json\",\n                  \"X-Offline-Cache\": \"true\",\n                },\n              });\n            }\n          }\n          // No cache hit or not a network error — rethrow\n          throw error;\n        }\n      };\n\n      // Mutate the original options object directly rather than spreading\n      // into a new one. @better-fetch/fetch's initializePlugins passes the\n      // same `options` reference to every plugin's init(). If we return a\n      // new object, a later plugin (e.g. applySchemaPlugin) that returns\n      // the original reference will overwrite our customFetchImpl, silently\n      // disabling the offline cache. By mutating in place, the wrapping\n      // survives regardless of plugin ordering.\n      if (fetchOptions) {\n        fetchOptions.customFetchImpl = wrappedFetch;\n      }\n\n      return {\n        url,\n        options: fetchOptions ?? { customFetchImpl: wrappedFetch },\n      };\n    },\n  };\n}\n","import { atom } from \"nanostores\";\n\n/**\n * Creates a reactive atom that tracks the browser's online/offline status.\n * Defaults to `true` in non-browser environments (SSR).\n */\nexport function createOnlineStatusAtom() {\n  const isOnline = atom<boolean>(\n    typeof navigator !== \"undefined\" && typeof navigator.onLine === \"boolean\"\n      ? navigator.onLine\n      : true,\n  );\n\n  if (typeof window !== \"undefined\") {\n    window.addEventListener(\"online\", () => isOnline.set(true));\n    window.addEventListener(\"offline\", () => isOnline.set(false));\n  }\n\n  return isOnline;\n}\n","import type { StorageAdapter, CacheEntry } from \"../types.js\";\n\nconst DEFAULT_DB_NAME = \"better-auth-offline\";\nconst STORE_NAME = \"cache\";\n\n/**\n * Creates an IndexedDB-backed storage adapter.\n *\n * @param dbName - Name of the IndexedDB database. Defaults to \"better-auth-offline\".\n */\nexport function createIndexedDBAdapter(\n  dbName: string = DEFAULT_DB_NAME,\n): StorageAdapter {\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  function openDB(): Promise<IDBDatabase> {\n    if (dbPromise) return dbPromise;\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(STORE_NAME)) {\n          db.createObjectStore(STORE_NAME);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => {\n        dbPromise = null;\n        reject(request.error);\n      };\n    });\n\n    return dbPromise;\n  }\n\n  return {\n    async get(key: string): Promise<CacheEntry | null> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readonly\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.get(key);\n          request.onsuccess = () => resolve(request.result ?? null);\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        return null;\n      }\n    },\n\n    async set(key: string, value: unknown): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.put(value, key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Fire-and-forget: swallow errors for cache writes\n      }\n    },\n\n    async delete(key: string): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.delete(key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n\n    async clear(): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.clear();\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/adapters/indexeddb.ts","../src/allowlist.ts","../src/fetch-plugin.ts","../src/online-status.ts"],"sourcesContent":["import type { BetterAuthClientPlugin } from \"better-auth/client\";\nimport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\nimport { createOfflineFetchPlugin } from \"./fetch-plugin.js\";\nimport { createOnlineStatusAtom } from \"./online-status.js\";\nimport type { OfflinePluginOptions, StorageAdapter } from \"./types.js\";\n\nexport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\nexport { createOnlineStatusAtom } from \"./online-status.js\";\n// Re-export types for consumers\nexport type {\n  CacheEntry,\n  OfflinePluginOptions,\n  StorageAdapter,\n} from \"./types.js\";\n\nconst SIGN_OUT_PATHS = [\"/sign-out\", \"/signout\", \"/logout\"];\nconst SIGN_IN_PATHS = [\"/sign-in\", \"/signin\", \"/login\"];\n\nfunction isAuthChangePath(path: string): boolean {\n  return (\n    SIGN_OUT_PATHS.some((p) => path.includes(p)) ||\n    SIGN_IN_PATHS.some((p) => path.includes(p))\n  );\n}\n\n/**\n * better-auth offline plugin.\n *\n * Transparently caches GET API responses and serves them when offline.\n * Drop-in: no consumer code changes required.\n *\n * @example\n * ```ts\n * import { createAuthClient } from \"better-auth/client\";\n * import { offlinePlugin } from \"better-auth-offline\";\n *\n * const authClient = createAuthClient({\n *   plugins: [offlinePlugin()],\n * });\n * ```\n */\nexport function offlinePlugin(\n  options: OfflinePluginOptions = {}\n): BetterAuthClientPlugin {\n  const storage: StorageAdapter = options.storage ?? createIndexedDBAdapter();\n\n  return {\n    id: \"better-auth-offline\",\n\n    getAtoms() {\n      return {\n        onlineStatus: createOnlineStatusAtom(),\n      };\n    },\n\n    fetchPlugins: [createOfflineFetchPlugin(storage, options)],\n\n    atomListeners: [\n      {\n        matcher(path: string) {\n          return isAuthChangePath(path);\n        },\n        signal: \"$sessionSignal\",\n        callback() {\n          // Clear cache on sign-out / sign-in to prevent cross-user data leaks\n          storage.clear();\n        },\n      },\n    ],\n\n    getActions() {\n      return {\n        clearCache: () => storage.clear(),\n      };\n    },\n  };\n}\n","import type { CacheEntry, StorageAdapter } from \"../types.js\";\n\nconst DEFAULT_DB_NAME = \"better-auth-offline\";\nconst STORE_NAME = \"cache\";\n\n/**\n * Creates an IndexedDB-backed storage adapter.\n *\n * @param dbName - Name of the IndexedDB database. Defaults to \"better-auth-offline\".\n */\nexport function createIndexedDBAdapter(\n  dbName: string = DEFAULT_DB_NAME\n): StorageAdapter {\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  function openDB(): Promise<IDBDatabase> {\n    if (dbPromise) {\n      return dbPromise;\n    }\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(STORE_NAME)) {\n          db.createObjectStore(STORE_NAME);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => {\n        dbPromise = null;\n        reject(request.error);\n      };\n    });\n\n    return dbPromise;\n  }\n\n  return {\n    async get(key: string): Promise<CacheEntry | null> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readonly\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.get(key);\n          request.onsuccess = () => resolve(request.result ?? null);\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        return null;\n      }\n    },\n\n    async set(key: string, value: unknown): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.put(value, key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Fire-and-forget: swallow errors for cache writes\n      }\n    },\n\n    async delete(key: string): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.delete(key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n\n    async clear(): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.clear();\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n  };\n}\n","import type { OfflinePluginOptions } from \"./types.js\";\n\n/**\n * Default paths that are cached for offline access.\n * Only GET requests to these paths will be cached.\n */\nconst DEFAULT_ALLOWLIST = [\n  // Core\n  \"/get-session\",\n  \"/list-sessions\",\n  \"/list-accounts\",\n  \"/account-info\",\n  // Organization\n  \"/organization/list\",\n  \"/organization/get-active-member\",\n  \"/organization/get-active-member-role\",\n  \"/organization/get-full-organization\",\n  \"/organization/list-members\",\n  \"/organization/list-teams\",\n  \"/organization/list-invitations\",\n  // Admin\n  \"/admin/list-users\",\n  // Multi-session\n  \"/multi-session/list-device-sessions\",\n  // Passkey\n  \"/passkey/list-user-passkeys\",\n  // API Key\n  \"/api-key/get\",\n  \"/api-key/list\",\n];\n\n/**\n * Get the effective allowlist based on plugin options.\n */\nexport function getAllowlist(options: OfflinePluginOptions): string[] {\n  if (options.mode === \"custom\") {\n    return options.allowlist;\n  }\n  const exclude = new Set(options.excludePaths ?? []);\n  const base =\n    exclude.size > 0\n      ? DEFAULT_ALLOWLIST.filter((p) => !exclude.has(p))\n      : DEFAULT_ALLOWLIST;\n  return [...base, ...(options.includePaths ?? [])];\n}\n\n/**\n * Check if a path should be cached.\n * Uses suffix matching to handle configurable base path prefixes.\n */\nexport function isAllowlisted(path: string, allowlist: string[]): boolean {\n  return allowlist.some(\n    (allowed) =>\n      path === allowed || path.endsWith(allowed) || path.includes(`${allowed}/`)\n  );\n}\n","import type { BetterFetchPlugin } from \"@better-fetch/fetch\";\nimport { getAllowlist, isAllowlisted } from \"./allowlist.js\";\nimport type {\n  CacheEntry,\n  OfflinePluginOptions,\n  StorageAdapter,\n} from \"./types.js\";\n\n/**\n * Extracts the pathname from a URL string, stripping query params.\n * Used as the cache key.\n */\nexport function extractPath(urlOrPath: string | URL): string {\n  try {\n    const url =\n      typeof urlOrPath === \"string\" && urlOrPath.startsWith(\"http\")\n        ? new URL(urlOrPath)\n        : null;\n    if (url) {\n      return url.pathname;\n    }\n  } catch {\n    // Not a valid URL, treat as path\n  }\n  // Strip query string from path\n  const str = typeof urlOrPath === \"string\" ? urlOrPath : urlOrPath.pathname;\n  const qIndex = str.indexOf(\"?\");\n  return qIndex >= 0 ? str.slice(0, qIndex) : str;\n}\n\n/**\n * Checks if a network error is a connectivity failure (not an HTTP error).\n */\nfunction isNetworkError(error: unknown): boolean {\n  if (error instanceof TypeError) {\n    return true;\n  }\n  if (error instanceof DOMException && error.name === \"AbortError\") {\n    return true;\n  }\n  return false;\n}\n\n/**\n * Creates the BetterFetchPlugin that provides offline caching.\n *\n * Strategy: Network-First with Cache Fallback\n * - Uses `init` to inject a custom fetch that wraps the real fetch\n * - On successful GET: caches the response body (fire-and-forget)\n * - On network error for GET: serves cached response if available\n * - Only allowlisted GET paths are cached; everything else passes through\n */\nexport function createOfflineFetchPlugin(\n  storage: StorageAdapter,\n  options: OfflinePluginOptions\n): BetterFetchPlugin {\n  const allowlist = getAllowlist(options);\n\n  return {\n    id: \"better-auth-offline\",\n    name: \"better-auth-offline\",\n\n    init(url, fetchOptions) {\n      const originalFetch = fetchOptions?.customFetchImpl ?? globalThis.fetch;\n      const method = (fetchOptions?.method ?? \"GET\").toUpperCase();\n      const path = extractPath(url);\n      const shouldCache = method === \"GET\" && isAllowlisted(path, allowlist);\n\n      const wrappedFetch: typeof globalThis.fetch = async (input, init) => {\n        if (!shouldCache) {\n          return originalFetch(input, init);\n        }\n\n        try {\n          const response = await originalFetch(input, init);\n\n          // Cache successful GET responses (fire-and-forget)\n          if (response.ok) {\n            // Clone before reading body so the original response remains usable\n            const clone = response.clone();\n            clone\n              .json()\n              .then((data) => {\n                const entry: CacheEntry = { data, cachedAt: Date.now() };\n                storage.set(path, entry);\n              })\n              .catch(() => {\n                // Response wasn't JSON or read failed — skip caching\n              });\n          }\n\n          return response;\n        } catch (error) {\n          // Network error — try serving from cache\n          if (isNetworkError(error)) {\n            const cached = (await storage.get(path)) as CacheEntry | null;\n            if (cached) {\n              return new Response(JSON.stringify(cached.data), {\n                status: 200,\n                headers: {\n                  \"Content-Type\": \"application/json\",\n                  \"X-Offline-Cache\": \"true\",\n                },\n              });\n            }\n          }\n          // No cache hit or not a network error — rethrow\n          throw error;\n        }\n      };\n\n      // Mutate the original options object directly rather than spreading\n      // into a new one. @better-fetch/fetch's initializePlugins passes the\n      // same `options` reference to every plugin's init(). If we return a\n      // new object, a later plugin (e.g. applySchemaPlugin) that returns\n      // the original reference will overwrite our customFetchImpl, silently\n      // disabling the offline cache. By mutating in place, the wrapping\n      // survives regardless of plugin ordering.\n      if (fetchOptions) {\n        fetchOptions.customFetchImpl = wrappedFetch;\n      }\n\n      return {\n        url,\n        options: fetchOptions ?? { customFetchImpl: wrappedFetch },\n      };\n    },\n  };\n}\n","import { atom } from \"nanostores\";\n\n/**\n * Creates a reactive atom that tracks the browser's online/offline status.\n * Defaults to `true` in non-browser environments (SSR).\n */\nexport function createOnlineStatusAtom() {\n  const isOnline = atom<boolean>(\n    typeof navigator !== \"undefined\" && typeof navigator.onLine === \"boolean\"\n      ? navigator.onLine\n      : true\n  );\n\n  if (typeof window !== \"undefined\") {\n    window.addEventListener(\"online\", () => isOnline.set(true));\n    window.addEventListener(\"offline\", () => isOnline.set(false));\n  }\n\n  return isOnline;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { BetterAuthClientPlugin } from 'better-auth/client';
-import { O as OfflinePluginOptions } from './indexeddb-CkUWH5Sl.cjs';
-export { C as CacheEntry, S as StorageAdapter, c as createIndexedDBAdapter } from './indexeddb-CkUWH5Sl.cjs';
+import { O as OfflinePluginOptions } from './indexeddb-B7LON8ue.cjs';
+export { C as CacheEntry, S as StorageAdapter, c as createIndexedDBAdapter } from './indexeddb-B7LON8ue.cjs';
 import * as nanostores from 'nanostores';
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { BetterAuthClientPlugin } from 'better-auth/client';
-import { O as OfflinePluginOptions } from './indexeddb-CkUWH5Sl.js';
-export { C as CacheEntry, S as StorageAdapter, c as createIndexedDBAdapter } from './indexeddb-CkUWH5Sl.js';
+import { O as OfflinePluginOptions } from './indexeddb-B7LON8ue.js';
+export { C as CacheEntry, S as StorageAdapter, c as createIndexedDBAdapter } from './indexeddb-B7LON8ue.js';
 import * as nanostores from 'nanostores';
 
 /**

package/dist/index.js

@@ -1,6 +1,6 @@
 import {
   createIndexedDBAdapter
-} from "./chunk-JPTDSCSW.js";
+} from "./chunk-NFJRQCGL.js";
 
 // src/allowlist.ts
 var DEFAULT_ALLOWLIST = [
@@ -37,7 +37,7 @@ function getAllowlist(options) {
 }
 function isAllowlisted(path, allowlist) {
   return allowlist.some(
-    (allowed) => path === allowed || path.endsWith(allowed) || path.includes(allowed + "/")
+    (allowed) => path === allowed || path.endsWith(allowed) || path.includes(`${allowed}/`)
   );
 }
 
@@ -45,7 +45,9 @@ function isAllowlisted(path, allowlist) {
 function extractPath(urlOrPath) {
   try {
     const url = typeof urlOrPath === "string" && urlOrPath.startsWith("http") ? new URL(urlOrPath) : null;
-    if (url) return url.pathname;
+    if (url) {
+      return url.pathname;
+    }
   } catch {
   }
   const str = typeof urlOrPath === "string" ? urlOrPath : urlOrPath.pathname;
@@ -53,8 +55,12 @@ function extractPath(urlOrPath) {
   return qIndex >= 0 ? str.slice(0, qIndex) : str;
 }
 function isNetworkError(error) {
-  if (error instanceof TypeError) return true;
-  if (error instanceof DOMException && error.name === "AbortError") return true;
+  if (error instanceof TypeError) {
+    return true;
+  }
+  if (error instanceof DOMException && error.name === "AbortError") {
+    return true;
+  }
   return false;
 }
 function createOfflineFetchPlugin(storage, options) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/allowlist.ts","../src/fetch-plugin.ts","../src/online-status.ts","../src/index.ts"],"sourcesContent":["import type { OfflinePluginOptions } from \"./types.js\";\n\n/**\n * Default paths that are cached for offline access.\n * Only GET requests to these paths will be cached.\n */\nconst DEFAULT_ALLOWLIST = [\n  // Core\n  \"/get-session\",\n  \"/list-sessions\",\n  \"/list-accounts\",\n  \"/account-info\",\n  // Organization\n  \"/organization/list\",\n  \"/organization/get-active-member\",\n  \"/organization/get-active-member-role\",\n  \"/organization/get-full-organization\",\n  \"/organization/list-members\",\n  \"/organization/list-teams\",\n  \"/organization/list-invitations\",\n  // Admin\n  \"/admin/list-users\",\n  // Multi-session\n  \"/multi-session/list-device-sessions\",\n  // Passkey\n  \"/passkey/list-user-passkeys\",\n  // API Key\n  \"/api-key/get\",\n  \"/api-key/list\",\n];\n\n/**\n * Get the effective allowlist based on plugin options.\n */\nexport function getAllowlist(options: OfflinePluginOptions): string[] {\n  if (options.mode === \"custom\") {\n    return options.allowlist;\n  }\n  const exclude = new Set(options.excludePaths ?? []);\n  const base = exclude.size > 0\n    ? DEFAULT_ALLOWLIST.filter((p) => !exclude.has(p))\n    : DEFAULT_ALLOWLIST;\n  return [...base, ...(options.includePaths ?? [])];\n}\n\n/**\n * Check if a path should be cached.\n * Uses suffix matching to handle configurable base path prefixes.\n */\nexport function isAllowlisted(\n  path: string,\n  allowlist: string[],\n): boolean {\n  return allowlist.some(\n    (allowed) =>\n      path === allowed ||\n      path.endsWith(allowed) ||\n      path.includes(allowed + \"/\"),\n  );\n}\n","import type { BetterFetchPlugin } from \"@better-fetch/fetch\";\nimport type { StorageAdapter, CacheEntry, OfflinePluginOptions } from \"./types.js\";\nimport { getAllowlist, isAllowlisted } from \"./allowlist.js\";\n\n/**\n * Extracts the pathname from a URL string, stripping query params.\n * Used as the cache key.\n */\nexport function extractPath(urlOrPath: string | URL): string {\n  try {\n    const url = typeof urlOrPath === \"string\" && urlOrPath.startsWith(\"http\")\n      ? new URL(urlOrPath)\n      : null;\n    if (url) return url.pathname;\n  } catch {\n    // Not a valid URL, treat as path\n  }\n  // Strip query string from path\n  const str = typeof urlOrPath === \"string\" ? urlOrPath : urlOrPath.pathname;\n  const qIndex = str.indexOf(\"?\");\n  return qIndex >= 0 ? str.slice(0, qIndex) : str;\n}\n\n/**\n * Checks if a network error is a connectivity failure (not an HTTP error).\n */\nfunction isNetworkError(error: unknown): boolean {\n  if (error instanceof TypeError) return true;\n  if (error instanceof DOMException && error.name === \"AbortError\") return true;\n  return false;\n}\n\n/**\n * Creates the BetterFetchPlugin that provides offline caching.\n *\n * Strategy: Network-First with Cache Fallback\n * - Uses `init` to inject a custom fetch that wraps the real fetch\n * - On successful GET: caches the response body (fire-and-forget)\n * - On network error for GET: serves cached response if available\n * - Only allowlisted GET paths are cached; everything else passes through\n */\nexport function createOfflineFetchPlugin(\n  storage: StorageAdapter,\n  options: OfflinePluginOptions,\n): BetterFetchPlugin {\n  const allowlist = getAllowlist(options);\n\n  return {\n    id: \"better-auth-offline\",\n    name: \"better-auth-offline\",\n\n    init(url, fetchOptions) {\n      const originalFetch = fetchOptions?.customFetchImpl ?? globalThis.fetch;\n      const method = (fetchOptions?.method ?? \"GET\").toUpperCase();\n      const path = extractPath(url);\n      const shouldCache = method === \"GET\" && isAllowlisted(path, allowlist);\n\n      const wrappedFetch: typeof globalThis.fetch = async (input, init) => {\n        if (!shouldCache) {\n          return originalFetch(input, init);\n        }\n\n        try {\n          const response = await originalFetch(input, init);\n\n          // Cache successful GET responses (fire-and-forget)\n          if (response.ok) {\n            // Clone before reading body so the original response remains usable\n            const clone = response.clone();\n            clone.json().then((data) => {\n              const entry: CacheEntry = { data, cachedAt: Date.now() };\n              storage.set(path, entry);\n            }).catch(() => {\n              // Response wasn't JSON or read failed — skip caching\n            });\n          }\n\n          return response;\n        } catch (error) {\n          // Network error — try serving from cache\n          if (isNetworkError(error)) {\n            const cached = await storage.get(path) as CacheEntry | null;\n            if (cached) {\n              return new Response(JSON.stringify(cached.data), {\n                status: 200,\n                headers: {\n                  \"Content-Type\": \"application/json\",\n                  \"X-Offline-Cache\": \"true\",\n                },\n              });\n            }\n          }\n          // No cache hit or not a network error — rethrow\n          throw error;\n        }\n      };\n\n      // Mutate the original options object directly rather than spreading\n      // into a new one. @better-fetch/fetch's initializePlugins passes the\n      // same `options` reference to every plugin's init(). If we return a\n      // new object, a later plugin (e.g. applySchemaPlugin) that returns\n      // the original reference will overwrite our customFetchImpl, silently\n      // disabling the offline cache. By mutating in place, the wrapping\n      // survives regardless of plugin ordering.\n      if (fetchOptions) {\n        fetchOptions.customFetchImpl = wrappedFetch;\n      }\n\n      return {\n        url,\n        options: fetchOptions ?? { customFetchImpl: wrappedFetch },\n      };\n    },\n  };\n}\n","import { atom } from \"nanostores\";\n\n/**\n * Creates a reactive atom that tracks the browser's online/offline status.\n * Defaults to `true` in non-browser environments (SSR).\n */\nexport function createOnlineStatusAtom() {\n  const isOnline = atom<boolean>(\n    typeof navigator !== \"undefined\" && typeof navigator.onLine === \"boolean\"\n      ? navigator.onLine\n      : true,\n  );\n\n  if (typeof window !== \"undefined\") {\n    window.addEventListener(\"online\", () => isOnline.set(true));\n    window.addEventListener(\"offline\", () => isOnline.set(false));\n  }\n\n  return isOnline;\n}\n","import type { BetterAuthClientPlugin } from \"better-auth/client\";\nimport type { OfflinePluginOptions, StorageAdapter } from \"./types.js\";\nimport { createOfflineFetchPlugin } from \"./fetch-plugin.js\";\nimport { createOnlineStatusAtom } from \"./online-status.js\";\nimport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\n\n// Re-export types for consumers\nexport type { StorageAdapter, OfflinePluginOptions, CacheEntry } from \"./types.js\";\nexport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\nexport { createOnlineStatusAtom } from \"./online-status.js\";\n\nconst SIGN_OUT_PATHS = [\"/sign-out\", \"/signout\", \"/logout\"];\nconst SIGN_IN_PATHS = [\"/sign-in\", \"/signin\", \"/login\"];\n\nfunction isAuthChangePath(path: string): boolean {\n  return (\n    SIGN_OUT_PATHS.some((p) => path.includes(p)) ||\n    SIGN_IN_PATHS.some((p) => path.includes(p))\n  );\n}\n\n/**\n * better-auth offline plugin.\n *\n * Transparently caches GET API responses and serves them when offline.\n * Drop-in: no consumer code changes required.\n *\n * @example\n * ```ts\n * import { createAuthClient } from \"better-auth/client\";\n * import { offlinePlugin } from \"better-auth-offline\";\n *\n * const authClient = createAuthClient({\n *   plugins: [offlinePlugin()],\n * });\n * ```\n */\nexport function offlinePlugin(\n  options: OfflinePluginOptions = {},\n): BetterAuthClientPlugin {\n  const storage: StorageAdapter =\n    options.storage ?? createIndexedDBAdapter();\n\n  return {\n    id: \"better-auth-offline\",\n\n    getAtoms() {\n      return {\n        onlineStatus: createOnlineStatusAtom(),\n      };\n    },\n\n    fetchPlugins: [createOfflineFetchPlugin(storage, options)],\n\n    atomListeners: [\n      {\n        matcher(path: string) {\n          return isAuthChangePath(path);\n        },\n        signal: \"$sessionSignal\",\n        callback() {\n          // Clear cache on sign-out / sign-in to prevent cross-user data leaks\n          storage.clear();\n        },\n      },\n    ],\n\n    getActions() {\n      return {\n        clearCache: () => storage.clear(),\n      };\n    },\n  };\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/allowlist.ts","../src/fetch-plugin.ts","../src/online-status.ts","../src/index.ts"],"sourcesContent":["import type { OfflinePluginOptions } from \"./types.js\";\n\n/**\n * Default paths that are cached for offline access.\n * Only GET requests to these paths will be cached.\n */\nconst DEFAULT_ALLOWLIST = [\n  // Core\n  \"/get-session\",\n  \"/list-sessions\",\n  \"/list-accounts\",\n  \"/account-info\",\n  // Organization\n  \"/organization/list\",\n  \"/organization/get-active-member\",\n  \"/organization/get-active-member-role\",\n  \"/organization/get-full-organization\",\n  \"/organization/list-members\",\n  \"/organization/list-teams\",\n  \"/organization/list-invitations\",\n  // Admin\n  \"/admin/list-users\",\n  // Multi-session\n  \"/multi-session/list-device-sessions\",\n  // Passkey\n  \"/passkey/list-user-passkeys\",\n  // API Key\n  \"/api-key/get\",\n  \"/api-key/list\",\n];\n\n/**\n * Get the effective allowlist based on plugin options.\n */\nexport function getAllowlist(options: OfflinePluginOptions): string[] {\n  if (options.mode === \"custom\") {\n    return options.allowlist;\n  }\n  const exclude = new Set(options.excludePaths ?? []);\n  const base =\n    exclude.size > 0\n      ? DEFAULT_ALLOWLIST.filter((p) => !exclude.has(p))\n      : DEFAULT_ALLOWLIST;\n  return [...base, ...(options.includePaths ?? [])];\n}\n\n/**\n * Check if a path should be cached.\n * Uses suffix matching to handle configurable base path prefixes.\n */\nexport function isAllowlisted(path: string, allowlist: string[]): boolean {\n  return allowlist.some(\n    (allowed) =>\n      path === allowed || path.endsWith(allowed) || path.includes(`${allowed}/`)\n  );\n}\n","import type { BetterFetchPlugin } from \"@better-fetch/fetch\";\nimport { getAllowlist, isAllowlisted } from \"./allowlist.js\";\nimport type {\n  CacheEntry,\n  OfflinePluginOptions,\n  StorageAdapter,\n} from \"./types.js\";\n\n/**\n * Extracts the pathname from a URL string, stripping query params.\n * Used as the cache key.\n */\nexport function extractPath(urlOrPath: string | URL): string {\n  try {\n    const url =\n      typeof urlOrPath === \"string\" && urlOrPath.startsWith(\"http\")\n        ? new URL(urlOrPath)\n        : null;\n    if (url) {\n      return url.pathname;\n    }\n  } catch {\n    // Not a valid URL, treat as path\n  }\n  // Strip query string from path\n  const str = typeof urlOrPath === \"string\" ? urlOrPath : urlOrPath.pathname;\n  const qIndex = str.indexOf(\"?\");\n  return qIndex >= 0 ? str.slice(0, qIndex) : str;\n}\n\n/**\n * Checks if a network error is a connectivity failure (not an HTTP error).\n */\nfunction isNetworkError(error: unknown): boolean {\n  if (error instanceof TypeError) {\n    return true;\n  }\n  if (error instanceof DOMException && error.name === \"AbortError\") {\n    return true;\n  }\n  return false;\n}\n\n/**\n * Creates the BetterFetchPlugin that provides offline caching.\n *\n * Strategy: Network-First with Cache Fallback\n * - Uses `init` to inject a custom fetch that wraps the real fetch\n * - On successful GET: caches the response body (fire-and-forget)\n * - On network error for GET: serves cached response if available\n * - Only allowlisted GET paths are cached; everything else passes through\n */\nexport function createOfflineFetchPlugin(\n  storage: StorageAdapter,\n  options: OfflinePluginOptions\n): BetterFetchPlugin {\n  const allowlist = getAllowlist(options);\n\n  return {\n    id: \"better-auth-offline\",\n    name: \"better-auth-offline\",\n\n    init(url, fetchOptions) {\n      const originalFetch = fetchOptions?.customFetchImpl ?? globalThis.fetch;\n      const method = (fetchOptions?.method ?? \"GET\").toUpperCase();\n      const path = extractPath(url);\n      const shouldCache = method === \"GET\" && isAllowlisted(path, allowlist);\n\n      const wrappedFetch: typeof globalThis.fetch = async (input, init) => {\n        if (!shouldCache) {\n          return originalFetch(input, init);\n        }\n\n        try {\n          const response = await originalFetch(input, init);\n\n          // Cache successful GET responses (fire-and-forget)\n          if (response.ok) {\n            // Clone before reading body so the original response remains usable\n            const clone = response.clone();\n            clone\n              .json()\n              .then((data) => {\n                const entry: CacheEntry = { data, cachedAt: Date.now() };\n                storage.set(path, entry);\n              })\n              .catch(() => {\n                // Response wasn't JSON or read failed — skip caching\n              });\n          }\n\n          return response;\n        } catch (error) {\n          // Network error — try serving from cache\n          if (isNetworkError(error)) {\n            const cached = (await storage.get(path)) as CacheEntry | null;\n            if (cached) {\n              return new Response(JSON.stringify(cached.data), {\n                status: 200,\n                headers: {\n                  \"Content-Type\": \"application/json\",\n                  \"X-Offline-Cache\": \"true\",\n                },\n              });\n            }\n          }\n          // No cache hit or not a network error — rethrow\n          throw error;\n        }\n      };\n\n      // Mutate the original options object directly rather than spreading\n      // into a new one. @better-fetch/fetch's initializePlugins passes the\n      // same `options` reference to every plugin's init(). If we return a\n      // new object, a later plugin (e.g. applySchemaPlugin) that returns\n      // the original reference will overwrite our customFetchImpl, silently\n      // disabling the offline cache. By mutating in place, the wrapping\n      // survives regardless of plugin ordering.\n      if (fetchOptions) {\n        fetchOptions.customFetchImpl = wrappedFetch;\n      }\n\n      return {\n        url,\n        options: fetchOptions ?? { customFetchImpl: wrappedFetch },\n      };\n    },\n  };\n}\n","import { atom } from \"nanostores\";\n\n/**\n * Creates a reactive atom that tracks the browser's online/offline status.\n * Defaults to `true` in non-browser environments (SSR).\n */\nexport function createOnlineStatusAtom() {\n  const isOnline = atom<boolean>(\n    typeof navigator !== \"undefined\" && typeof navigator.onLine === \"boolean\"\n      ? navigator.onLine\n      : true\n  );\n\n  if (typeof window !== \"undefined\") {\n    window.addEventListener(\"online\", () => isOnline.set(true));\n    window.addEventListener(\"offline\", () => isOnline.set(false));\n  }\n\n  return isOnline;\n}\n","import type { BetterAuthClientPlugin } from \"better-auth/client\";\nimport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\nimport { createOfflineFetchPlugin } from \"./fetch-plugin.js\";\nimport { createOnlineStatusAtom } from \"./online-status.js\";\nimport type { OfflinePluginOptions, StorageAdapter } from \"./types.js\";\n\nexport { createIndexedDBAdapter } from \"./adapters/indexeddb.js\";\nexport { createOnlineStatusAtom } from \"./online-status.js\";\n// Re-export types for consumers\nexport type {\n  CacheEntry,\n  OfflinePluginOptions,\n  StorageAdapter,\n} from \"./types.js\";\n\nconst SIGN_OUT_PATHS = [\"/sign-out\", \"/signout\", \"/logout\"];\nconst SIGN_IN_PATHS = [\"/sign-in\", \"/signin\", \"/login\"];\n\nfunction isAuthChangePath(path: string): boolean {\n  return (\n    SIGN_OUT_PATHS.some((p) => path.includes(p)) ||\n    SIGN_IN_PATHS.some((p) => path.includes(p))\n  );\n}\n\n/**\n * better-auth offline plugin.\n *\n * Transparently caches GET API responses and serves them when offline.\n * Drop-in: no consumer code changes required.\n *\n * @example\n * ```ts\n * import { createAuthClient } from \"better-auth/client\";\n * import { offlinePlugin } from \"better-auth-offline\";\n *\n * const authClient = createAuthClient({\n *   plugins: [offlinePlugin()],\n * });\n * ```\n */\nexport function offlinePlugin(\n  options: OfflinePluginOptions = {}\n): BetterAuthClientPlugin {\n  const storage: StorageAdapter = options.storage ?? createIndexedDBAdapter();\n\n  return {\n    id: \"better-auth-offline\",\n\n    getAtoms() {\n      return {\n        onlineStatus: createOnlineStatusAtom(),\n      };\n    },\n\n    fetchPlugins: [createOfflineFetchPlugin(storage, options)],\n\n    atomListeners: [\n      {\n        matcher(path: string) {\n          return isAuthChangePath(path);\n        },\n        signal: \"$sessionSignal\",\n        callback() {\n          // Clear cache on sign-out / sign-in to prevent cross-user data leaks\n          storage.clear();\n        },\n      },\n    ],\n\n    getActions() {\n      return {\n        clearCache: () => storage.clear(),\n      };\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-auth-offline",
-  "version": "0.0.0",
+  "version": "0.0.2",
   "description": "Caches better-auth API responses so your app keeps working when the network doesn't.",
   "author": {
     "name": "Roman Sirokov",
@@ -10,7 +10,7 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/MrLightful/better-auth-offline.git"
+    "url": "git+https://github.com/MrLightful/better-auth-offline.git"
   },
   "homepage": "https://github.com/MrLightful/better-auth-offline",
   "bugs": {
@@ -46,15 +46,21 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
     "build": "bun run tsup",
     "dev": "bun run tsup --watch",
     "test": "bun run vitest run",
     "test:watch": "bun run vitest",
-    "typecheck": "bun run tsc --noEmit"
+    "typecheck": "bun run tsc --noEmit",
+    "check": "ultracite check",
+    "fix": "ultracite fix",
+    "prepare": "husky"
   },
+  "packageManager": "bun@1.3.10",
   "peerDependencies": {
     "better-auth": ">=1.0.0"
   },
@@ -63,10 +69,20 @@
   },
   "devDependencies": {
     "@better-fetch/fetch": "^1.1.21",
+    "@biomejs/biome": "2.4.7",
+    "@changesets/cli": "^2.30.0",
     "better-auth": "^1.5.6",
     "fake-indexeddb": "^6.2.5",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.4.0",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
+    "ultracite": "7.3.2",
     "vitest": "^3.2.4"
+  },
+  "lint-staged": {
+    "*.{js,jsx,ts,tsx,json,jsonc,css,scss,md,mdx}": [
+      "bun x ultracite fix"
+    ]
   }
 }

package/dist/chunk-JPTDSCSW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/adapters/indexeddb.ts"],"sourcesContent":["import type { StorageAdapter, CacheEntry } from \"../types.js\";\n\nconst DEFAULT_DB_NAME = \"better-auth-offline\";\nconst STORE_NAME = \"cache\";\n\n/**\n * Creates an IndexedDB-backed storage adapter.\n *\n * @param dbName - Name of the IndexedDB database. Defaults to \"better-auth-offline\".\n */\nexport function createIndexedDBAdapter(\n  dbName: string = DEFAULT_DB_NAME,\n): StorageAdapter {\n  let dbPromise: Promise<IDBDatabase> | null = null;\n\n  function openDB(): Promise<IDBDatabase> {\n    if (dbPromise) return dbPromise;\n\n    dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n      const request = indexedDB.open(dbName, 1);\n\n      request.onupgradeneeded = () => {\n        const db = request.result;\n        if (!db.objectStoreNames.contains(STORE_NAME)) {\n          db.createObjectStore(STORE_NAME);\n        }\n      };\n\n      request.onsuccess = () => resolve(request.result);\n      request.onerror = () => {\n        dbPromise = null;\n        reject(request.error);\n      };\n    });\n\n    return dbPromise;\n  }\n\n  return {\n    async get(key: string): Promise<CacheEntry | null> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readonly\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.get(key);\n          request.onsuccess = () => resolve(request.result ?? null);\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        return null;\n      }\n    },\n\n    async set(key: string, value: unknown): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.put(value, key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Fire-and-forget: swallow errors for cache writes\n      }\n    },\n\n    async delete(key: string): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.delete(key);\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n\n    async clear(): Promise<void> {\n      try {\n        const db = await openDB();\n        return new Promise((resolve, reject) => {\n          const tx = db.transaction(STORE_NAME, \"readwrite\");\n          const store = tx.objectStore(STORE_NAME);\n          const request = store.clear();\n          request.onsuccess = () => resolve();\n          request.onerror = () => reject(request.error);\n        });\n      } catch {\n        // Swallow errors\n      }\n    },\n  };\n}\n"],"mappings":";AAEA,IAAM,kBAAkB;AACxB,IAAM,aAAa;AAOZ,SAAS,uBACd,SAAiB,iBACD;AAChB,MAAI,YAAyC;AAE7C,WAAS,SAA+B;AACtC,QAAI,UAAW,QAAO;AAEtB,gBAAY,IAAI,QAAqB,CAAC,SAAS,WAAW;AACxD,YAAM,UAAU,UAAU,KAAK,QAAQ,CAAC;AAExC,cAAQ,kBAAkB,MAAM;AAC9B,cAAM,KAAK,QAAQ;AACnB,YAAI,CAAC,GAAG,iBAAiB,SAAS,UAAU,GAAG;AAC7C,aAAG,kBAAkB,UAAU;AAAA,QACjC;AAAA,MACF;AAEA,cAAQ,YAAY,MAAM,QAAQ,QAAQ,MAAM;AAChD,cAAQ,UAAU,MAAM;AACtB,oBAAY;AACZ,eAAO,QAAQ,KAAK;AAAA,MACtB;AAAA,IACF,CAAC;AAED,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM,IAAI,KAAyC;AACjD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,UAAU;AAChD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,GAAG;AAC7B,kBAAQ,YAAY,MAAM,QAAQ,QAAQ,UAAU,IAAI;AACxD,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AACN,eAAO;AAAA,MACT;AAAA,IACF;AAAA,IAEA,MAAM,IAAI,KAAa,OAA+B;AACpD,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,IAAI,OAAO,GAAG;AACpC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,OAAO,KAA4B;AACvC,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,OAAO,GAAG;AAChC,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,IAEA,MAAM,QAAuB;AAC3B,UAAI;AACF,cAAM,KAAK,MAAM,OAAO;AACxB,eAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,gBAAM,KAAK,GAAG,YAAY,YAAY,WAAW;AACjD,gBAAM,QAAQ,GAAG,YAAY,UAAU;AACvC,gBAAM,UAAU,MAAM,MAAM;AAC5B,kBAAQ,YAAY,MAAM,QAAQ;AAClC,kBAAQ,UAAU,MAAM,OAAO,QAAQ,KAAK;AAAA,QAC9C,CAAC;AAAA,MACH,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/{indexeddb-CkUWH5Sl.d.cts → indexeddb-B7LON8ue.d.cts}

@@ -1,8 +1,8 @@
 interface StorageAdapter {
+    clear(): Promise<void>;
+    delete(key: string): Promise<void>;
     get(key: string): Promise<unknown | null>;
     set(key: string, value: unknown): Promise<void>;
-    delete(key: string): Promise<void>;
-    clear(): Promise<void>;
 }
 interface BaseOptions {
     /**
@@ -11,30 +11,30 @@ interface BaseOptions {
     storage?: StorageAdapter;
 }
 interface DefaultAllowlistOptions extends BaseOptions {
-    mode?: "default";
-    /**
-     * Additional paths to cache (extends the default allowlist).
-     */
-    includePaths?: string[];
     /**
      * Paths to remove from the default allowlist.
      */
     excludePaths?: string[];
+    /**
+     * Additional paths to cache (extends the default allowlist).
+     */
+    includePaths?: string[];
+    mode?: "default";
 }
 interface CustomAllowlistOptions extends BaseOptions {
-    mode: "custom";
     /**
      * Only these paths are cached (default allowlist is ignored).
      */
     allowlist: string[];
+    mode: "custom";
 }
 type OfflinePluginOptions = DefaultAllowlistOptions | CustomAllowlistOptions;
 /**
  * Shape of a cached response entry.
  */
 interface CacheEntry {
-    data: unknown;
     cachedAt: number;
+    data: unknown;
 }
 
 /**

package/dist/{indexeddb-CkUWH5Sl.d.ts → indexeddb-B7LON8ue.d.ts}

@@ -1,8 +1,8 @@
 interface StorageAdapter {
+    clear(): Promise<void>;
+    delete(key: string): Promise<void>;
     get(key: string): Promise<unknown | null>;
     set(key: string, value: unknown): Promise<void>;
-    delete(key: string): Promise<void>;
-    clear(): Promise<void>;
 }
 interface BaseOptions {
     /**
@@ -11,30 +11,30 @@ interface BaseOptions {
     storage?: StorageAdapter;
 }
 interface DefaultAllowlistOptions extends BaseOptions {
-    mode?: "default";
-    /**
-     * Additional paths to cache (extends the default allowlist).
-     */
-    includePaths?: string[];
     /**
      * Paths to remove from the default allowlist.
      */
     excludePaths?: string[];
+    /**
+     * Additional paths to cache (extends the default allowlist).
+     */
+    includePaths?: string[];
+    mode?: "default";
 }
 interface CustomAllowlistOptions extends BaseOptions {
-    mode: "custom";
     /**
      * Only these paths are cached (default allowlist is ignored).
      */
     allowlist: string[];
+    mode: "custom";
 }
 type OfflinePluginOptions = DefaultAllowlistOptions | CustomAllowlistOptions;
 /**
  * Shape of a cached response entry.
  */
 interface CacheEntry {
-    data: unknown;
     cachedAt: number;
+    data: unknown;
 }
 
 /**