better-auth-firestore 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025, Slava Yultyyev
+
+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,103 @@
+# 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.
+
+- 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
+
+## Installation
+
+```bash
+pnpm add @yultyyev/better-auth-firestore firebase-admin better-auth
+```
+
+## Quick start
+
+```ts
+import { betterAuth } from "better-auth";
+import { firestoreAdapter, initFirestore } from "@yultyyev/better-auth-firestore";
+import { cert } from "firebase-admin/app";
+
+const firestore = initFirestore({
+	credential: cert({
+		projectId: process.env.FIREBASE_PROJECT_ID!,
+		clientEmail: process.env.FIREBASE_CLIENT_EMAIL!,
+		privateKey: process.env.FIREBASE_PRIVATE_KEY!.replace(/\\n/g, "\n"),
+	}),
+	projectId: process.env.FIREBASE_PROJECT_ID!,
+	name: "better-auth",
+});
+
+export const auth = betterAuth({
+	// ... your Better Auth options
+	database: firestoreAdapter({
+		firestore,
+		namingStrategy: "default", // or "snake_case"
+		collections: {
+			// users: "users",
+			// sessions: "sessions",
+			// accounts: "accounts",
+			// verificationTokens: "verificationTokens",
+		},
+	}),
+});
+```
+
+## Options
+
+```ts
+firestoreAdapter({
+	firestore?: Firestore;
+	namingStrategy?: "default" | "snake_case";
+	collections?: { users?: string; sessions?: string; accounts?: string; verificationTokens?: string };
+	debugLogs?: boolean | DBAdapterDebugLogOption;
+});
+```
+
+**Default collection names:**
+- `users`: "users"
+- `sessions`: "sessions"
+- `accounts`: "accounts"
+- `verificationTokens`: "verification_tokens" (snake_case) or "verificationTokens" (default)
+
+## 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:
+
+```ts
+// If you were using Auth.js with custom collection names
+firestoreAdapter({
+	firestore,
+	collections: {
+		accounts: "authjs_accounts", // or whatever name you were using
+		// ... other overrides
+	},
+});
+```
+
+The adapter maintains the same data shape, so your existing data will work without migration scripts.
+
+## Testing with Firestore Emulator
+
+```bash
+# start emulator (example)
+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
+
+export FIRESTORE_EMULATOR_HOST=localhost:8080
+pnpm vitest run
+```
+
+## Build
+
+```bash
+pnpm build
+```
+
+## License
+
+MIT.

package/dist/firebase-adapter.d.ts

@@ -0,0 +1,8 @@
+import { 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;