better-auth-firestore 1.0.0 → 1.1.0

package/README.md

@@ -1,22 +1,75 @@
 # better-auth-firestore
 
-Firestore (Firebase Admin SDK) adapter for Better Auth. Drop-in replacement for the Auth.js/NextAuth Firebase adapter with matching data shape to ease migration.
+[![npm version](https://img.shields.io/npm/v/better-auth-firestore.svg)](https://www.npmjs.com/package/better-auth-firestore)
+[![CI](https://github.com/yultyyev/better-auth-firestore/actions/workflows/release.yml/badge.svg)](https://github.com/yultyyev/better-auth-firestore/actions)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
 
-- Better Auth guide: https://www.better-auth.com/docs/guides/create-a-db-adapter
-- Auth.js Firebase adapter docs: https://authjs.dev/getting-started/adapters/firebase#installation
-- Auth.js Firebase adapter source: https://github.com/nextauthjs/next-auth/tree/main/packages/adapter-firebase
+> **Note:** If you're using `@yultyyev/better-auth-firestore`, please migrate to `better-auth-firestore`. The scoped package is deprecated. See [Migration from Scoped Package](#migration-from-scoped-package) below.
+
+**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)
+- **Example:** See [`/examples/minimal`](./examples/minimal) for a complete Next.js App Router example
+
+---
+
+## Related: Firebase Auth Plugin
+
+For Firebase Authentication integration with Better Auth, see **[better-auth-firebase-auth](https://github.com/yultyyev/better-auth-firebase-auth)**. It provides:
+
+- Firebase Authentication provider support (Email/Password, Google, etc.)
+- Client-side or server-side token generation
+- Password reset functionality
+- Full TypeScript support
+
+Use `better-auth-firebase-auth` for authentication and `better-auth-firestore` for data storage.
+
+---
 
 ## Installation
 
+# npm
+
+```bash
+npm install better-auth-firestore firebase-admin better-auth
+```
+
+# pnpm
+
+```bash
+pnpm add better-auth-firestore firebase-admin better-auth
+```
+
+# yarn
+
 ```bash
-pnpm add @yultyyev/better-auth-firestore firebase-admin better-auth
+yarn add better-auth-firestore firebase-admin better-auth
+```
+
+# bun
+
+```bash
+bun add better-auth-firestore firebase-admin better-auth
+```
+
+### Minimal usage
+
+```ts
+import { firestoreAdapter } from "better-auth-firestore";
+import { createAuth } from "better-auth";
+import { getFirestore } from "firebase-admin/firestore";
+
+export const auth = createAuth({
+  adapter: firestoreAdapter({ firestore: getFirestore() })
+});
 ```
 
 ## Quick start
 
 ```ts
 import { betterAuth } from "better-auth";
-import { firestoreAdapter, initFirestore } from "@yultyyev/better-auth-firestore";
+import { firestoreAdapter, initFirestore } from "better-auth-firestore";
 import { cert } from "firebase-admin/app";
 
 const firestore = initFirestore({
@@ -44,6 +97,92 @@ export const auth = betterAuth({
 });
 ```
 
+## Firebase Setup
+
+### 1. Create a new Firebase project
+
+1. Go to [Firebase Console](https://console.firebase.google.com/)
+2. Click "Add project" or "Create a project"
+3. Enter a project name and follow the setup wizard
+
+### 2. Create Firestore Database
+
+1. In your Firebase project, go to **Build** → **Firestore Database**
+2. Click "Create database"
+3. Choose your preferred security rules mode (you can update rules later)
+4. Select a location for your database
+
+### 3. Create Required Firestore Index
+
+The adapter requires a composite index on the `verification` collection. Choose one of the following methods:
+
+**Option A: Create via Firebase Console (Recommended)**
+
+You can generate a direct link that pre-fills the index creation form:
+
+```ts
+import { generateIndexSetupUrl } from "better-auth-firestore";
+
+// Generate the URL (pre-fills the form automatically)
+const url = generateIndexSetupUrl(
+  process.env.FIREBASE_PROJECT_ID!,
+  "(default)", // or your database ID if using a named database
+  "verification" // or your custom collection name
+);
+
+console.log("Open this URL to create the index:", url);
+```
+
+Or manually:
+1. Open: `https://console.firebase.google.com/project/YOUR_PROJECT_ID/firestore/indexes`
+2. Click "Create Index"
+3. Configure:
+   - **Collection ID:** `verification`
+   - **Fields:**
+     - `identifier` (Ascending)
+     - `createdAt` (Descending)
+     - `__name__` (Descending)
+   - **Query scope:** Collection
+4. Click "Create" and wait for the index to build (usually a few minutes)
+
+**Option B: Use firestore.indexes.json Template**
+
+1. Copy `firestore.indexes.json` from `node_modules/better-auth-firestore/` to your project root
+2. (Optional) Update collection name if using custom `collections.verificationTokens`
+3. Deploy: `firebase deploy --only firestore:indexes`
+
+> **Note:** If you're using a custom collection name for verification tokens (via `collections.verificationTokens`), replace `verification` with your custom collection name in the index configuration.
+
+### 4. Generate Service Account Key
+
+1. Go to **Project Settings** (gear icon) → **Service Accounts**
+2. Under "Firebase Admin SDK", click **"Generate new private key"**
+3. Download the JSON file (keep it secure - never commit it to version control)
+
+### 5. Extract Environment Variables
+
+From the downloaded service account JSON file, extract these values:
+
+- `project_id` → `FIREBASE_PROJECT_ID`
+- `client_email` → `FIREBASE_CLIENT_EMAIL`
+- `private_key` → `FIREBASE_PRIVATE_KEY` (requires newline replacement - see [Troubleshooting](#troubleshooting))
+
+**Alternative:** You can use the JSON file directly by setting `GOOGLE_APPLICATION_CREDENTIALS` environment variable to the path of your service account JSON file.
+
+### 6. (Optional) Set up Security Rules
+
+The adapter uses the Firebase Admin SDK (server-side), so Firestore security rules should deny direct client access. See [Firestore Security Rules](#firestore-security-rules) below.
+
+## Environment Variables
+
+Required environment variables:
+
+- `FIREBASE_PROJECT_ID` - Your Firebase project ID
+- `FIREBASE_CLIENT_EMAIL` - Service account email from the JSON file
+- `FIREBASE_PRIVATE_KEY` - Service account private key (with newlines properly escaped)
+
+**Note:** The `FIREBASE_PRIVATE_KEY` often contains literal `\n` characters in environment variables. See [Troubleshooting](#troubleshooting) for how to handle this.
+
 ## Options
 
 ```ts
@@ -61,22 +200,181 @@ firestoreAdapter({
 - `accounts`: "accounts"
 - `verificationTokens`: "verification_tokens" (snake_case) or "verificationTokens" (default)
 
+### Debug logging
+
+```ts
+firestoreAdapter({
+  firestore,
+  debugLogs: true, // Enable verbose logging
+});
+```
+
+## Compatibility
+
+| Runtime | Supported | Notes |
+|---|---|---|
+| Node 18+ | ✅ | Recommended |
+| Next.js (App Router) | ✅ | Server routes only |
+| Cloud Functions / Cloud Run | ✅ | Provide `FIREBASE_*` creds |
+| Vercel Edge / CF Workers | ❌ | Firestore Admin SDK not supported at Edge runtime |
+
+## Collections & Data Shape
+
+The adapter maintains the same data shape as Auth.js/NextAuth for seamless migration:
+
+| Collection | Typical fields |
+|---|---|
+| `users` | `id`, `email`, `name`, `image`, `createdAt`, `updatedAt` |
+| `accounts` | `provider`, `providerAccountId`, `userId`, `access_token`, `refresh_token` |
+| `sessions` | `sessionToken`, `userId`, `expires` |
+| `verificationTokens` | `identifier`, `token`, `expires` |
+
+> **Defaults:** Collections default to `users`, `sessions`, `accounts`, `verification_tokens` (snake_case) / `verificationTokens` (default). See [Options](#options) to customize collection names.
+>
+> **Note:** The `verification` collection requires a composite index on `identifier` (ASC), `createdAt` (DESC), `__name__` (DESC). See [Firebase Setup - Step 3](#3-create-required-firestore-index) for setup instructions.
+
+### Minimal Firestore Security Rules (server/admin only)
+
+Since this adapter uses the Firebase Admin SDK (server-side), Firestore security rules should deny direct client access:
+
+```javascript
+rules_version = '2';
+service cloud.firestore {
+  match /databases/{database}/documents {
+    match /{document=**} {
+      allow read, write: if false;
+    }
+  }
+}
+```
+
+## Why this vs Auth.js Firebase adapter?
+
+| Feature | Better Auth Firestore | Auth.js Firebase Adapter |
+|---|---|---|
+| **Status** | ✅ Active development | Now maintained by Better Auth team ([announcement](https://www.better-auth.com/blog/authjs-joins-better-auth)) |
+| **Firebase Admin SDK** | ✅ Uses Admin SDK | ✅ Uses Admin SDK |
+| **Data shape compatibility** | ✅ Matching shape, migration-free | - |
+| **Drop-in replacement** | ✅ Yes | - |
+
+This adapter is the Better Auth-native solution for Firestore users, recommended for new projects.
+
+## Migration from Scoped Package
+
+If you're currently using `@yultyyev/better-auth-firestore`, migrate to `better-auth-firestore`:
+
+1. **Update package name in your dependencies:**
+   ```bash
+   npm uninstall @yultyyev/better-auth-firestore
+   npm install better-auth-firestore
+   # or
+   pnpm remove @yultyyev/better-auth-firestore
+   pnpm add better-auth-firestore
+   ```
+
+2. **Update import statements:**
+   ```ts
+   // Before
+   import { firestoreAdapter } from "@yultyyev/better-auth-firestore";
+   
+   // After
+   import { firestoreAdapter } from "better-auth-firestore";
+   ```
+
+That's it! The API is identical, so no code changes are needed beyond the import path.
+
 ## Migration from Auth.js/NextAuth
 
-If you're migrating from the Auth.js Firebase adapter, you can use your existing collection names by overriding them:
+> **For complete migration steps**, see the [Better Auth NextAuth Migration Guide](https://www.better-auth.com/docs/guides/next-auth-migration-guide), which covers route handlers, client setup, and server-side session handling.
+
+### Adapter-Specific Migration
+
+This adapter uses the same default collection names and field names as Auth.js Firebase adapter, making it a **drop-in replacement** for the database adapter portion of your migration:
+
+- **Collection names:** `users`, `sessions`, `accounts`, `verificationTokens` (same as Auth.js)
+- **Field names:** `sessionToken`, `userId`, `providerAccountId`, etc. (same as Auth.js)
+- **Data shape:** Identical, so no data migration scripts needed
+
+Simply replace your Auth.js Firebase adapter with this one:
+
+```ts
+// Before (Auth.js)
+import { FirestoreAdapter } from "@auth/firebase-adapter";
+
+// After (Better Auth)
+import { firestoreAdapter } from "better-auth-firestore";
+
+// Same Firestore instance, same collections, same data shape
+export const auth = betterAuth({
+  database: firestoreAdapter({ firestore }),
+});
+```
+
+If you were using custom collection names with Auth.js, you can override them:
 
 ```ts
-// If you were using Auth.js with custom collection names
 firestoreAdapter({
 	firestore,
 	collections: {
-		accounts: "authjs_accounts", // or whatever name you were using
+		accounts: "authjs_accounts", // or whatever custom names you were using
 		// ... other overrides
 	},
 });
 ```
 
-The adapter maintains the same data shape, so your existing data will work without migration scripts.
+## Recipes
+
+### Use snake_case collections
+
+```ts
+firestoreAdapter({
+  firestore,
+  namingStrategy: "snake_case",
+});
+```
+
+### Keep Auth.js collection names (no data migration)
+
+```ts
+firestoreAdapter({
+  firestore,
+  collections: {
+    accounts: "accounts", // or your custom collection names
+    // ... other overrides
+  },
+});
+```
+
+### Usage with Next.js (App Router)
+
+```ts
+// app/api/auth/[...all]/route.ts
+import { toNextJsHandler } from "better-auth/next-js";
+import { auth } from "@/lib/auth";
+
+export const { GET, POST } = toNextJsHandler(auth);
+```
+
+### Usage in Node.js script
+
+```ts
+import { firestoreAdapter } from "better-auth-firestore";
+import { createAuth } from "better-auth";
+import { initializeApp, cert } from "firebase-admin/app";
+import { getFirestore } from "firebase-admin/firestore";
+
+const app = initializeApp({
+  credential: cert({
+    projectId: process.env.FIREBASE_PROJECT_ID,
+    clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
+    privateKey: process.env.FIREBASE_PRIVATE_KEY?.replace(/\\n/g, "\n"),
+  }),
+});
+
+export const auth = createAuth({
+  adapter: firestoreAdapter({ firestore: getFirestore(app) }),
+});
+```
 
 ## Testing with Firestore Emulator
 
@@ -92,6 +390,44 @@ export FIRESTORE_EMULATOR_HOST=localhost:8080
 pnpm vitest run
 ```
 
+## Troubleshooting
+
+### Error: `FIREBASE_PRIVATE_KEY` has literal `\n`
+
+**Symptom:** Authentication fails or you see errors about invalid private key format.
+
+**Fix:** Environment variables often store newlines as literal `\n` strings. Replace them at runtime:
+
+```ts
+privateKey: process.env.FIREBASE_PRIVATE_KEY!.replace(/\\n/g, "\n")
+```
+
+### Error: Requests hang on local dev
+
+**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.
+
+### Error: Missing or insufficient permissions / Index required
+
+**Symptom:** Queries on verification tokens fail with errors about missing index or insufficient permissions.
+
+**Fix:** Create the required composite index on the `verification` collection. See [Firebase Setup - Step 3](#3-create-required-firestore-index) for detailed instructions.
+
+You can generate a direct link using:
+```ts
+import { generateIndexSetupUrl } from "better-auth-firestore";
+const url = generateIndexSetupUrl(process.env.FIREBASE_PROJECT_ID!);
+console.log(url); // Open this URL to create the index
+```
+
+## Related Links
+
+- [Better Auth Documentation](https://www.better-auth.com/docs)
+- [Better Auth Adapter Guide](https://www.better-auth.com/docs/guides/create-a-db-adapter)
+- [Auth.js Firebase Adapter](https://authjs.dev/getting-started/adapters/firebase) (legacy, for reference)
+- [Auth.js joins Better Auth](https://www.better-auth.com/blog/authjs-joins-better-auth) - Announcement
+
 ## Build
 
 ```bash

package/dist/firebase-adapter.js

@@ -1,7 +1,23 @@
 import { createAdapterFactory, } from "better-auth/adapters";
 import { FieldPath, Timestamp } from "firebase-admin/firestore";
 import { initFirestore } from "./firestore";
-import { mapFieldsFactory } from "./utils";
+const MAP_TO_FIRESTORE = {
+    userId: "user_id",
+    sessionToken: "session_token",
+    providerAccountId: "provider_account_id",
+    emailVerified: "email_verified",
+};
+const MAP_FROM_FIRESTORE = Object.fromEntries(Object.entries(MAP_TO_FIRESTORE).map(([k, v]) => [v, k]));
+const identity = (x) => x;
+function mapFieldsFactory(preferSnakeCase) {
+    if (preferSnakeCase) {
+        return {
+            toDb: (field) => MAP_TO_FIRESTORE[field] ?? field,
+            fromDb: (field) => MAP_FROM_FIRESTORE[field] ?? field,
+        };
+    }
+    return { toDb: identity, fromDb: identity };
+}
 function resolveDb(config) {
     if (!config)
         return initFirestore();

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export { firestoreAdapter } from "./firebase-adapter";
 export { initFirestore } from "./firestore";
+export { generateIndexSetupUrl, getIndexConfig } from "./setup";
 export * from "./types";

package/dist/index.js

@@ -1,3 +1,4 @@
 export { firestoreAdapter } from "./firebase-adapter";
 export { initFirestore } from "./firestore";
+export { generateIndexSetupUrl, getIndexConfig } from "./setup";
 export * from "./types";

package/firestore.indexes.json

@@ -0,0 +1,24 @@
+{
+  "indexes": [
+    {
+      "collectionGroup": "verification",
+      "queryScope": "COLLECTION",
+      "fields": [
+        {
+          "fieldPath": "identifier",
+          "order": "ASCENDING"
+        },
+        {
+          "fieldPath": "createdAt",
+          "order": "DESCENDING"
+        },
+        {
+          "fieldPath": "__name__",
+          "order": "DESCENDING"
+        }
+      ]
+    }
+  ],
+  "fieldOverrides": []
+}
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "better-auth-firestore",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "private": false,
   "description": "Firestore adapter for Better Auth (Firebase Admin SDK)",
   "author": "Slava Yultyyev <yultyyev@gmail.com>",
@@ -19,7 +19,8 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "firestore.indexes.json"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
@@ -46,7 +47,11 @@
     "firebase",
     "firestore",
     "adapter",
-    "authentication"
+    "authjs",
+    "nextauth",
+    "oauth",
+    "session",
+    "typescript"
   ],
   "peerDependencies": {
     "better-auth": "*",
@@ -54,15 +59,15 @@
     "typescript": "^5.0.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.3.2",
+    "@biomejs/biome": "^2.3.11",
     "@semantic-release/changelog": "^6.0.3",
-    "@semantic-release/commit-analyzer": "^13.0.0",
-    "@semantic-release/github": "^11.0.1",
-    "@semantic-release/npm": "^12.0.1",
-    "@semantic-release/release-notes-generator": "^12.1.0",
-    "rimraf": "^6.0.1",
-    "semantic-release": "^24.0.0",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/github": "^12.0.2",
+    "@semantic-release/npm": "^13.1.3",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "rimraf": "^6.1.2",
+    "semantic-release": "^25.0.2",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.5"
+    "vitest": "^4.0.16"
   }
 }

package/dist/index-utils.d.ts

@@ -1,28 +0,0 @@
-import type { Firestore } from "firebase-admin/firestore";
-import type { NamingStrategy } from "./types";
-export interface FirestoreIndexField {
-    fieldPath: string;
-    order: "ASCENDING" | "DESCENDING";
-}
-export interface FirestoreIndex {
-    collectionGroup: string;
-    queryScope: "COLLECTION" | "COLLECTION_GROUP";
-    fields: FirestoreIndexField[];
-}
-/**
- * Returns all required Firestore index definitions for Better Auth adapter.
- * Supports both default and snake_case naming strategies.
- */
-export declare function getRequiredIndexes(namingStrategy?: NamingStrategy): FirestoreIndex[];
-/**
- * Creates Firestore indexes programmatically using the Firestore REST API.
- * Note: Firebase Admin SDK doesn't have direct index creation methods,
- * so this function provides a helper to format indexes for manual creation
- * or uses the REST API if credentials are available.
- *
- * @param firestore - Firestore instance
- * @param projectId - Firebase project ID
- * @param namingStrategy - Naming strategy to use ("default" or "snake_case")
- * @returns Array of index definitions that can be used to create indexes
- */
-export declare function createFirestoreIndexes(firestore: Firestore, projectId: string, namingStrategy?: NamingStrategy): Promise<FirestoreIndex[]>;

package/dist/index-utils.js

@@ -1,51 +0,0 @@
-/**
- * Returns all required Firestore index definitions for Better Auth adapter.
- * Supports both default and snake_case naming strategies.
- */
-export function getRequiredIndexes(namingStrategy = "default") {
-    const isSnakeCase = namingStrategy === "snake_case";
-    const collectionName = isSnakeCase
-        ? "verification_tokens"
-        : "verificationTokens";
-    const createdAtField = isSnakeCase ? "created_at" : "createdAt";
-    return [
-        {
-            collectionGroup: collectionName,
-            queryScope: "COLLECTION",
-            fields: [
-                {
-                    fieldPath: "identifier",
-                    order: "ASCENDING",
-                },
-                {
-                    fieldPath: createdAtField,
-                    order: "DESCENDING",
-                },
-            ],
-        },
-    ];
-}
-/**
- * Creates Firestore indexes programmatically using the Firestore REST API.
- * Note: Firebase Admin SDK doesn't have direct index creation methods,
- * so this function provides a helper to format indexes for manual creation
- * or uses the REST API if credentials are available.
- *
- * @param firestore - Firestore instance
- * @param projectId - Firebase project ID
- * @param namingStrategy - Naming strategy to use ("default" or "snake_case")
- * @returns Array of index definitions that can be used to create indexes
- */
-export async function createFirestoreIndexes(firestore, projectId, namingStrategy = "default") {
-    const indexes = getRequiredIndexes(namingStrategy);
-    // Note: The Firebase Admin SDK doesn't provide direct methods to create indexes.
-    // Indexes must be created via:
-    // 1. Firebase Console (Firestore provides URLs in error messages)
-    // 2. Firebase CLI: `firebase deploy --only firestore:indexes`
-    // 3. Firestore REST API (requires additional authentication)
-    // This function returns the index definitions for reference.
-    // Users should deploy indexes using one of the methods above.
-    console.log(`[Firestore Indexes] ${indexes.length} index definition(s) generated for project: ${projectId}`);
-    console.log(`[Firestore Indexes] Deploy indexes using: firebase deploy --only firestore:indexes`);
-    return indexes;
-}

package/dist/utils.d.ts

@@ -1,27 +0,0 @@
-import type { Firestore } from "firebase-admin/firestore";
-export type FieldMapper = {
-    toDb: (field: string) => string;
-    fromDb: (field: string) => string;
-};
-export declare function mapFieldsFactory(preferSnakeCase?: boolean): FieldMapper;
-export declare function getConverter<Document extends Record<string, any>>(options: {
-    excludeId?: boolean;
-    preferSnakeCase?: boolean;
-}): {
-    toFirestore(object: Document): Record<string, unknown>;
-    fromFirestore(snapshot: FirebaseFirestore.QueryDocumentSnapshot<Document>): Document;
-};
-export declare function getOneDoc<T>(querySnapshot: FirebaseFirestore.Query<T>): Promise<T | null>;
-export declare function getDoc<T>(docRef: FirebaseFirestore.DocumentReference<T>): Promise<T | null>;
-export declare function deleteDocs<T>(querySnapshot: FirebaseFirestore.Query<T>): Promise<void>;
-export declare function collectionsFactory(db: Firestore, preferSnakeCase: boolean | undefined, collections: {
-    users: string;
-    sessions: string;
-    accounts: string;
-    verificationTokens: string;
-}): {
-    users: FirebaseFirestore.CollectionReference<any, FirebaseFirestore.DocumentData>;
-    sessions: FirebaseFirestore.CollectionReference<any, FirebaseFirestore.DocumentData>;
-    accounts: FirebaseFirestore.CollectionReference<any, FirebaseFirestore.DocumentData>;
-    verification_tokens: FirebaseFirestore.CollectionReference<any, FirebaseFirestore.DocumentData>;
-};

package/dist/utils.js

@@ -1,78 +0,0 @@
-import { Timestamp } from "firebase-admin/firestore";
-const MAP_TO_FIRESTORE = {
-    userId: "user_id",
-    sessionToken: "session_token",
-    providerAccountId: "provider_account_id",
-    emailVerified: "email_verified",
-};
-const MAP_FROM_FIRESTORE = Object.fromEntries(Object.entries(MAP_TO_FIRESTORE).map(([k, v]) => [v, k]));
-const identity = (x) => x;
-export function mapFieldsFactory(preferSnakeCase) {
-    if (preferSnakeCase) {
-        return {
-            toDb: (field) => MAP_TO_FIRESTORE[field] ?? field,
-            fromDb: (field) => MAP_FROM_FIRESTORE[field] ?? field,
-        };
-    }
-    return { toDb: identity, fromDb: identity };
-}
-export function getConverter(options) {
-    const mapper = mapFieldsFactory(options?.preferSnakeCase);
-    return {
-        toFirestore(object) {
-            const document = {};
-            for (const key in object) {
-                if (key === "id")
-                    continue;
-                const value = object[key];
-                if (value !== undefined) {
-                    document[mapper.toDb(key)] = value;
-                }
-            }
-            return document;
-        },
-        fromFirestore(snapshot) {
-            const document = snapshot.data();
-            const object = {};
-            if (!options?.excludeId)
-                object.id = snapshot.id;
-            for (const key in document) {
-                let value = document[key];
-                if (value instanceof Timestamp)
-                    value = value.toDate();
-                object[mapper.fromDb(key)] = value;
-            }
-            return object;
-        },
-    };
-}
-export async function getOneDoc(querySnapshot) {
-    const querySnap = await querySnapshot.limit(1).get();
-    return querySnap.docs[0]?.data() ?? null;
-}
-export async function getDoc(docRef) {
-    const docSnap = await docRef.get();
-    return docSnap.data() ?? null;
-}
-export async function deleteDocs(querySnapshot) {
-    const querySnap = await querySnapshot.get();
-    for (const doc of querySnap.docs) {
-        await doc.ref.delete();
-    }
-}
-export function collectionsFactory(db, preferSnakeCase = false, collections) {
-    return {
-        users: db
-            .collection(collections.users)
-            .withConverter(getConverter({ preferSnakeCase })),
-        sessions: db
-            .collection(collections.sessions)
-            .withConverter(getConverter({ preferSnakeCase })),
-        accounts: db
-            .collection(collections.accounts)
-            .withConverter(getConverter({ preferSnakeCase })),
-        verification_tokens: db
-            .collection(collections.verificationTokens)
-            .withConverter(getConverter({ preferSnakeCase, excludeId: true })),
-    };
-}