better-auth-firestore 1.1.2 → 1.1.3

package/README.md

@@ -9,7 +9,7 @@
 **Firestore (Firebase Admin SDK) adapter for Better Auth.** A drop-in replacement for the Auth.js Firebase adapter with matching data shape.
 
 - **Install:** `pnpm add better-auth-firestore firebase-admin better-auth`
-- **Docs:** [Quickstart](#quick-start) • [Options](#options) • [Migration](#migration-from-authjsnextauth) • [Emulator](#testing-with-firestore-emulator)
+- **Docs:** [Quickstart](#quick-start) • [Options](#options) • [Migration](#migration-from-authjsnextauth) • [Emulator](#using-the-firestore-emulator)
 - **Example:** See [`/examples/minimal`](./examples/minimal) for a complete Next.js App Router example
 
 ---
@@ -57,11 +57,11 @@ bun add better-auth-firestore firebase-admin better-auth
 
 ```ts
 import { firestoreAdapter } from "better-auth-firestore";
-import { createAuth } from "better-auth";
+import { betterAuth } from "better-auth";
 import { getFirestore } from "firebase-admin/firestore";
 
-export const auth = createAuth({
-  adapter: firestoreAdapter({ firestore: getFirestore() })
+export const auth = betterAuth({
+  database: firestoreAdapter({ firestore: getFirestore() })
 });
 ```
 
@@ -211,6 +211,17 @@ firestoreAdapter({
 
 ## Compatibility
 
+### Better Auth versions
+
+| Better Auth | Status | Notes |
+|---|---|---|
+| `^1.5.0` | ✅ Recommended | Uses the latest API and security fixes. |
+| `^1.4.18` | ✅ Supported | Backward-compatible for existing projects. |
+
+> **For older projects:** if your app still uses older Better Auth patterns (`createAuth` + `adapter`), this adapter remains compatible, but new projects should use `betterAuth` + `database`.
+
+### Runtime compatibility
+
 | Runtime | Supported | Notes |
 |---|---|---|
 | Node 18+ | ✅ | Recommended |
@@ -359,7 +370,7 @@ export const { GET, POST } = toNextJsHandler(auth);
 
 ```ts
 import { firestoreAdapter } from "better-auth-firestore";
-import { createAuth } from "better-auth";
+import { betterAuth } from "better-auth";
 import { initializeApp, cert } from "firebase-admin/app";
 import { getFirestore } from "firebase-admin/firestore";
 
@@ -371,21 +382,37 @@ const app = initializeApp({
   }),
 });
 
-export const auth = createAuth({
-  adapter: firestoreAdapter({ firestore: getFirestore(app) }),
+export const auth = betterAuth({
+  database: firestoreAdapter({ firestore: getFirestore(app) }),
 });
 ```
 
-## Testing with Firestore Emulator
+## Using the Firestore Emulator
+
+The adapter fully supports the Firestore Emulator for both **local development** and **testing**. When `FIRESTORE_EMULATOR_HOST` is set, the Firebase Admin SDK automatically routes all requests to the emulator instead of production Firestore. Collection names remain unchanged — the adapter uses the same collections in emulator mode as in production.
+
+### Local development
 
 ```bash
-# start emulator (example)
+# 1. Start the emulator
 docker run -d --rm \
 	--name auth-firestore \
 	-p 8080:8080 \
 	google/cloud-sdk:emulators gcloud beta emulators firestore start \
 	--host-port=0.0.0.0:8080
 
+# 2. Set the env var and start your app
+export FIRESTORE_EMULATOR_HOST=localhost:8080
+pnpm run dev
+```
+
+Or add `FIRESTORE_EMULATOR_HOST=localhost:8080` to your `.env` file (supported by Next.js, Vite, etc.).
+
+> **Note:** No credential or service account setup is needed when using the emulator — the Admin SDK skips authentication automatically.
+
+### Running tests
+
+```bash
 export FIRESTORE_EMULATOR_HOST=localhost:8080
 pnpm vitest run
 ```
@@ -406,7 +433,7 @@ privateKey: process.env.FIREBASE_PRIVATE_KEY!.replace(/\\n/g, "\n")
 
 **Symptom:** Firebase Admin SDK requests hang or time out during local development.
 
-**Fix:** Use the Firestore Emulator and set `FIRESTORE_EMULATOR_HOST=localhost:8080` before running your app. See [Testing with Firestore Emulator](#testing-with-firestore-emulator) for setup instructions.
+**Fix:** Use the Firestore Emulator and set `FIRESTORE_EMULATOR_HOST=localhost:8080` before running your app. See [Using the Firestore Emulator](#using-the-firestore-emulator) for setup instructions.
 
 ### Error: Missing or insufficient permissions / Index required
 

package/dist/firebase-adapter.d.ts

@@ -1,8 +1,8 @@
-import { type DBAdapterDebugLogOption } from "better-auth/adapters";
+import { createAdapterFactory, type DBAdapterDebugLogOption } from "better-auth/adapters";
 import type { Firestore } from "firebase-admin/firestore";
 import type { FirestoreAdapterConfig } from "./types";
 export interface FirestoreAdapterOptions extends Omit<FirestoreAdapterConfig, "firestore"> {
     firestore?: Firestore;
     debugLogs?: DBAdapterDebugLogOption;
 }
-export declare const firestoreAdapter: (config?: FirestoreAdapterOptions | Firestore) => import("better-auth/adapters").AdapterFactory;
+export declare const firestoreAdapter: (config?: FirestoreAdapterOptions | Firestore) => ReturnType<typeof createAdapterFactory>;

package/dist/firebase-adapter.js

@@ -33,15 +33,12 @@ function resolveDb(config) {
  */
 function resolveCollectionNames(namingStrategy, overrides) {
     const snake = namingStrategy === "snake_case";
-    // Only suffix collection names in test mode (when using emulator) to isolate test suites
-    const isTestMode = Boolean(process.env.FIRESTORE_EMULATOR_HOST);
-    const suffix = isTestMode ? (snake ? "_snake" : "_default") : "";
     return {
-        users: overrides?.users ?? `users${suffix}`,
-        sessions: overrides?.sessions ?? `sessions${suffix}`,
-        accounts: overrides?.accounts ?? `accounts${suffix}`,
+        users: overrides?.users ?? "users",
+        sessions: overrides?.sessions ?? "sessions",
+        accounts: overrides?.accounts ?? "accounts",
         verificationTokens: overrides?.verificationTokens ??
-            (snake ? `verification_tokens${suffix}` : `verificationTokens${suffix}`),
+            (snake ? "verification_tokens" : "verificationTokens"),
     };
 }
 function convertTimestamp(value) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-auth-firestore",
-  "version": "1.1.2",
+  "version": "1.1.3",
   "private": false,
   "description": "Firestore adapter for Better Auth (Firebase Admin SDK)",
   "author": "Slava Yultyyev <yultyyev@gmail.com>",
@@ -59,15 +59,15 @@
     "typescript": "^5.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.11",
+    "@biomejs/biome": "^2.4.7",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
-    "@semantic-release/github": "^12.0.2",
-    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/github": "^12.0.6",
+    "@semantic-release/npm": "^13.1.5",
     "@semantic-release/release-notes-generator": "^14.1.0",
-    "rimraf": "^6.1.2",
-    "semantic-release": "^25.0.2",
+    "rimraf": "^6.1.3",
+    "semantic-release": "^25.0.3",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.16"
+    "vitest": "^4.1.0"
   }
 }