@better-auth/test-utils 1.5.0-beta.18 → 1.5.0-beta.20

package/README.md

@@ -0,0 +1,17 @@
+# Better Auth Test Utils
+
+Testing utilities for [Better Auth](https://www.better-auth.com) adapter development and integration testing.
+
+## Installation
+
+```bash
+npm install @better-auth/test-utils
+```
+
+## Documentation
+
+For full documentation, visit [better-auth.com](https://www.better-auth.com).
+
+## License
+
+MIT

package/package.json

@@ -1,11 +1,27 @@
 {
   "name": "@better-auth/test-utils",
-  "version": "1.5.0-beta.18",
+  "version": "1.5.0-beta.20",
+  "description": "Testing utilities for Better Auth adapter development",
   "type": "module",
+  "license": "MIT",
+  "homepage": "https://www.better-auth.com",
   "repository": {
     "type": "git",
-    "url": "https://github.com/better-auth/better-auth.git"
+    "url": "git+https://github.com/better-auth/better-auth.git",
+    "directory": "packages/test-utils"
   },
+  "keywords": [
+    "auth",
+    "testing",
+    "typescript",
+    "better-auth"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
   "exports": {
     "./adapter": {
       "dev-source": "./src/adapter.ts",
@@ -16,13 +32,13 @@
   "devDependencies": {
     "tsdown": "^0.20.3",
     "vitest": "^4.0.18",
-    "@better-auth/core": "1.5.0-beta.18",
-    "better-auth": "1.5.0-beta.18"
+    "@better-auth/core": "1.5.0-beta.20",
+    "better-auth": "1.5.0-beta.20"
   },
   "peerDependencies": {
     "vitest": "^4.0.18",
-    "@better-auth/core": "1.5.0-beta.18",
-    "better-auth": "1.5.0-beta.18"
+    "@better-auth/core": "1.5.0-beta.20",
+    "better-auth": "1.5.0-beta.20"
   },
   "scripts": {
     "build": "tsdown",

package/.turbo/turbo-build.log

@@ -1,21 +0,0 @@
-
-> @better-auth/test-utils@1.5.0-beta.18 build /home/runner/work/better-auth/better-auth/packages/test-utils
-> tsdown
-
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/better-auth/better-auth/packages/test-utils/tsdown.config.ts 
-ℹ entry: src/adapter/index.ts
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/adapter.mjs                 0.15 kB │ gzip: 0.10 kB
-ℹ dist/create-test-suite.mjs.map  39.07 kB │ gzip: 9.66 kB
-ℹ dist/test-adapter.mjs.map       18.06 kB │ gzip: 4.23 kB
-ℹ dist/create-test-suite.mjs      15.96 kB │ gzip: 3.98 kB
-ℹ dist/test-adapter.mjs            8.12 kB │ gzip: 1.97 kB
-ℹ dist/adapter.d.mts               0.27 kB │ gzip: 0.16 kB
-ℹ dist/create-test-suite.d.mts     5.13 kB │ gzip: 1.70 kB
-ℹ dist/test-adapter.d.mts          2.21 kB │ gzip: 0.87 kB
-ℹ 8 files, total: 88.97 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugin `rolldown-plugin-dts:generate`. See https://rolldown.rs/options/checks#plugintimings for more details.
-
-✔ Build complete in 16224ms

package/src/adapter/create-test-suite.ts

@@ -1,899 +0,0 @@
-import type { BetterAuthOptions } from "@better-auth/core";
-import type {
-	Account,
-	Session,
-	User,
-	Verification,
-} from "@better-auth/core/db";
-import { getAuthTables } from "@better-auth/core/db";
-import type { DBAdapter } from "@better-auth/core/db/adapter";
-import {
-	createAdapterFactory,
-	deepmerge,
-	initGetDefaultModelName,
-} from "@better-auth/core/db/adapter";
-import { TTY_COLORS } from "@better-auth/core/env";
-import { generateId } from "@better-auth/core/utils/id";
-import type { Auth } from "better-auth";
-import { betterAuth } from "better-auth";
-import { test } from "vitest";
-import type { Logger } from "./test-adapter";
-
-/**
- * Test entry type that supports both callback and object formats.
- * Object format allows specifying migration options that will be applied before the test runs.
- */
-export type TestEntry =
-	| ((context: {
-			readonly skip: {
-				(note?: string | undefined): never;
-				(condition: boolean, note?: string | undefined): void;
-			};
-	  }) => Promise<void>)
-	| {
-			migrateBetterAuth?: BetterAuthOptions;
-			test: (context: {
-				readonly skip: {
-					(note?: string | undefined): never;
-					(condition: boolean, note?: string | undefined): void;
-				};
-			}) => Promise<void>;
-	  };
-
-/**
- * Deep equality comparison for BetterAuthOptions.
- * Handles nested objects, arrays, and primitive values.
- */
-function deepEqual(a: any, b: any): boolean {
-	if (a === b) return true;
-	if (a == null || b == null) return a === b;
-	if (typeof a !== typeof b) return false;
-
-	if (typeof a === "object") {
-		if (Array.isArray(a) !== Array.isArray(b)) return false;
-
-		if (Array.isArray(a)) {
-			if (a.length !== b.length) return false;
-			for (let i = 0; i < a.length; i++) {
-				if (!deepEqual(a[i], b[i])) return false;
-			}
-			return true;
-		}
-
-		const keysA = Object.keys(a);
-		const keysB = Object.keys(b);
-
-		if (keysA.length !== keysB.length) return false;
-
-		for (const key of keysA) {
-			if (!keysB.includes(key)) return false;
-			if (!deepEqual(a[key], b[key])) return false;
-		}
-
-		return true;
-	}
-
-	return false;
-}
-
-/**
- * Statistics tracking for test suites.
- */
-export type TestSuiteStats = {
-	migrationCount: number;
-	totalMigrationTime: number;
-	testCount: number;
-	suiteStartTime: number;
-	suiteDuration: number;
-	suiteName: string;
-	groupingStats?: {
-		totalGroups: number;
-		averageTestsPerGroup: number;
-		largestGroupSize: number;
-		smallestGroupSize: number;
-		groupsWithMultipleTests: number;
-		totalTestsInGroups: number;
-	};
-};
-
-type GenerateFn = <M extends "user" | "session" | "verification" | "account">(
-	Model: M,
-) => Promise<
-	M extends "user"
-		? User
-		: M extends "session"
-			? Session
-			: M extends "verification"
-				? Verification
-				: M extends "account"
-					? Account
-					: undefined
->;
-
-type Success<T> = {
-	data: T;
-	error: null;
-};
-
-type Failure<E> = {
-	data: null;
-	error: E;
-};
-
-type Result<T, E = Error> = Success<T> | Failure<E>;
-
-async function tryCatch<T, E = Error>(
-	promise: Promise<T>,
-): Promise<Result<T, E>> {
-	try {
-		const data = await promise;
-		return { data, error: null };
-	} catch (error) {
-		return { data: null, error: error as E };
-	}
-}
-
-export type InsertRandomFn = <
-	M extends "user" | "session" | "verification" | "account",
-	Count extends number = 1,
->(
-	model: M,
-	count?: Count | undefined,
-) => Promise<
-	Count extends 1
-		? M extends "user"
-			? [User]
-			: M extends "session"
-				? [User, Session]
-				: M extends "verification"
-					? [Verification]
-					: M extends "account"
-						? [User, Account]
-						: [undefined]
-		: Array<
-				M extends "user"
-					? [User]
-					: M extends "session"
-						? [User, Session]
-						: M extends "verification"
-							? [Verification]
-							: M extends "account"
-								? [User, Account]
-								: [undefined]
-			>
->;
-
-export const createTestSuite = <
-	Tests extends Record<string, TestEntry>,
-	AdditionalOptions extends Record<string, any> = {},
->(
-	suiteName: string,
-	config: {
-		defaultBetterAuthOptions?: BetterAuthOptions | undefined;
-		/**
-		 * Helpful if the default better auth options require migrations to be run.
-		 */
-		alwaysMigrate?: boolean | undefined;
-		prefixTests?: string | undefined;
-		customIdGenerator?: () => any | Promise<any> | undefined;
-	},
-	tests: (
-		helpers: {
-			adapter: DBAdapter;
-			log: Logger;
-			generate: GenerateFn;
-			insertRandom: InsertRandomFn;
-			/**
-			 * A light cleanup function that will only delete rows it knows about.
-			 */
-			cleanup: () => Promise<void>;
-			/**
-			 * A hard cleanup function that will delete all rows from the database.
-			 */
-			hardCleanup: () => Promise<void>;
-			modifyBetterAuthOptions: (
-				options: BetterAuthOptions,
-				shouldRunMigrations: boolean,
-			) => Promise<BetterAuthOptions>;
-			getBetterAuthOptions: () => BetterAuthOptions;
-			sortModels: (
-				models: Array<
-					Record<string, any> & {
-						id: string;
-					}
-				>,
-				by?: ("id" | "createdAt") | undefined,
-			) => (Record<string, any> & {
-				id: string;
-			})[];
-			getAuth: () => Promise<Auth>;
-			tryCatch<T, E = Error>(promise: Promise<T>): Promise<Result<T, E>>;
-			customIdGenerator?: () => any | Promise<any> | undefined;
-			transformIdOutput?: (id: any) => string | undefined;
-			/**
-			 * Some adapters may change the ID type, this function allows you to pass the entire model
-			 * data and it will return the correct better-auth-expected transformed data.
-			 *
-			 * Eg:
-			 * MongoDB uses ObjectId for IDs, but it's possible the user can disable that option in the adapter config.
-			 * Because of this, the expected data would be a string.
-			 * These sorts of conversions will cause issues with the test when you use the `generate` function.
-			 * This is because the `generate` function will return the raw data expected to be saved in DB, not the excpected BA output.
-			 */
-			transformGeneratedModel: (
-				data: Record<string, any>,
-			) => Record<string, any>;
-		},
-		additionalOptions?: AdditionalOptions | undefined,
-	) => Tests,
-) => {
-	return (
-		options?:
-			| ({
-					disableTests?: Partial<
-						Record<keyof Tests, boolean> & { ALL?: boolean }
-					>;
-			  } & AdditionalOptions)
-			| undefined,
-	) => {
-		return async (helpers: {
-			adapter: () => Promise<DBAdapter<BetterAuthOptions>>;
-			log: Logger;
-			adapterDisplayName: string;
-			getBetterAuthOptions: () => BetterAuthOptions;
-			modifyBetterAuthOptions: (
-				options: BetterAuthOptions,
-			) => Promise<BetterAuthOptions>;
-			cleanup: () => Promise<void>;
-			runMigrations: () => Promise<void>;
-			prefixTests?: string | undefined;
-			onTestFinish: (stats: TestSuiteStats) => Promise<void>;
-			customIdGenerator?: () => any | Promise<any> | undefined;
-			transformIdOutput?: (id: any) => string | undefined;
-		}) => {
-			const createdRows: Record<string, any[]> = {};
-
-			let adapter = await helpers.adapter();
-			const wrapperAdapter = (
-				overrideOptions?: BetterAuthOptions | undefined,
-			) => {
-				const options = deepmerge(
-					deepmerge(
-						helpers.getBetterAuthOptions(),
-						config?.defaultBetterAuthOptions || {},
-					),
-					overrideOptions || {},
-				);
-				const adapterConfig = {
-					adapterId: helpers.adapterDisplayName,
-					...(adapter.options?.adapterConfig || {}),
-					adapterName: `Wrapped ${adapter.options?.adapterConfig.adapterName}`,
-					disableTransformOutput: true,
-					disableTransformInput: true,
-					disableTransformJoin: true,
-				};
-				const adapterCreator = (
-					options: BetterAuthOptions,
-				): DBAdapter<BetterAuthOptions> =>
-					createAdapterFactory({
-						config: {
-							...adapterConfig,
-							transaction: adapter.transaction,
-						},
-						adapter: ({ getDefaultModelName }) => {
-							adapter.transaction = undefined as any;
-							return {
-								count: async (args: any) => {
-									adapter = await helpers.adapter();
-									const res = await adapter.count(args);
-									return res as any;
-								},
-								deleteMany: async (args: any) => {
-									adapter = await helpers.adapter();
-									const res = await adapter.deleteMany(args);
-									return res as any;
-								},
-								delete: async (args: any) => {
-									adapter = await helpers.adapter();
-									const res = await adapter.delete(args);
-									return res as any;
-								},
-								findOne: async (args) => {
-									adapter = await helpers.adapter();
-									const res = await adapter.findOne(args);
-									return res as any;
-								},
-								findMany: async (args) => {
-									adapter = await helpers.adapter();
-									const res = await adapter.findMany(args);
-									return res as any;
-								},
-								update: async (args: any) => {
-									adapter = await helpers.adapter();
-									const res = await adapter.update(args);
-									return res as any;
-								},
-								updateMany: async (args) => {
-									adapter = await helpers.adapter();
-									const res = await adapter.updateMany(args);
-									return res as any;
-								},
-								createSchema: adapter.createSchema as any,
-								async create({ data, model, select }) {
-									const defaultModelName = getDefaultModelName(model);
-									adapter = await helpers.adapter();
-									const res = await adapter.create({
-										data: data,
-										model: defaultModelName,
-										select,
-										forceAllowId: true,
-									});
-									createdRows[model] = [...(createdRows[model] || []), res];
-									return res as any;
-								},
-								options: adapter.options,
-							};
-						},
-					})(options);
-
-				return adapterCreator(options);
-			};
-
-			const resetDebugLogs = () => {
-				//@ts-expect-error
-				wrapperAdapter()?.adapterTestDebugLogs?.resetDebugLogs();
-			};
-
-			const printDebugLogs = () => {
-				//@ts-expect-error
-				wrapperAdapter()?.adapterTestDebugLogs?.printDebugLogs();
-			};
-
-			const cleanupCreatedRows = async () => {
-				adapter = await helpers.adapter();
-				for (const model of Object.keys(createdRows)) {
-					for (const row of createdRows[model]!) {
-						const schema = getAuthTables(helpers.getBetterAuthOptions());
-						const getDefaultModelName = initGetDefaultModelName({
-							schema,
-							usePlural: adapter.options?.adapterConfig.usePlural,
-						});
-						let defaultModelName: string;
-						try {
-							defaultModelName = getDefaultModelName(model);
-						} catch {
-							continue;
-						}
-						if (!schema[defaultModelName]) continue; // model doesn't exist in the schema anymore, so we skip it
-						try {
-							await adapter.delete({
-								model,
-								where: [{ field: "id", value: row.id }],
-							});
-						} catch {
-							// We ignore any failed attempts to delete the created rows.
-						}
-						if (createdRows[model]!.length === 1) {
-							delete createdRows[model];
-						}
-					}
-				}
-			};
-
-			// Track current applied BetterAuth options state
-			let currentAppliedOptions: BetterAuthOptions | null = null;
-
-			// Statistics tracking
-			const stats: TestSuiteStats = {
-				migrationCount: 0,
-				totalMigrationTime: 0,
-				testCount: 0,
-				suiteStartTime: performance.now(),
-				suiteDuration: 0,
-				suiteName,
-			};
-
-			/**
-			 * Apply BetterAuth options and run migrations if needed.
-			 * Tracks migration statistics.
-			 */
-			const applyOptionsAndMigrate = async (
-				options: BetterAuthOptions | Partial<BetterAuthOptions>,
-				forceMigrate: boolean = false,
-			): Promise<BetterAuthOptions> => {
-				const finalOptions = deepmerge(
-					config?.defaultBetterAuthOptions || {},
-					options || {},
-				);
-
-				// Check if options have changed
-				const optionsChanged = !deepEqual(currentAppliedOptions, finalOptions);
-
-				if (optionsChanged || forceMigrate) {
-					adapter = await helpers.adapter();
-					await helpers.modifyBetterAuthOptions(finalOptions);
-
-					if (config.alwaysMigrate || forceMigrate) {
-						const migrationStart = performance.now();
-						await helpers.runMigrations();
-						const migrationTime = performance.now() - migrationStart;
-
-						stats.migrationCount++;
-						stats.totalMigrationTime += migrationTime;
-
-						adapter = await helpers.adapter();
-					}
-
-					currentAppliedOptions = finalOptions;
-				} else {
-					// Options haven't changed, just update the reference
-					currentAppliedOptions = finalOptions;
-				}
-
-				return finalOptions;
-			};
-
-			const transformGeneratedModel = (data: Record<string, any>) => {
-				const newData = { ...data };
-				if (helpers.transformIdOutput) {
-					newData.id = helpers.transformIdOutput(newData.id);
-				}
-				return newData;
-			};
-
-			const idGenerator = async () => {
-				if (config.customIdGenerator) {
-					return config.customIdGenerator();
-				}
-				if (helpers.customIdGenerator) {
-					return helpers.customIdGenerator();
-				}
-				return generateId();
-			};
-
-			const generateModel: GenerateFn = async (model: string) => {
-				const id = await idGenerator();
-				const randomDate = new Date(
-					Date.now() - Math.random() * 1000 * 60 * 60 * 24 * 365,
-				);
-				if (model === "user") {
-					const user: User = {
-						id,
-						createdAt: randomDate,
-						updatedAt: new Date(),
-						email:
-							`user-${helpers.transformIdOutput?.(id) ?? id}@email.com`.toLowerCase(),
-						emailVerified: true,
-						name: `user-${helpers.transformIdOutput?.(id) ?? id}`,
-						image: null,
-					};
-					return user as any;
-				}
-				if (model === "session") {
-					const session: Session = {
-						id,
-						createdAt: randomDate,
-						updatedAt: new Date(),
-						expiresAt: new Date(),
-						token: generateId(32),
-						userId: generateId(),
-						ipAddress: "127.0.0.1",
-						userAgent: "Some User Agent",
-					};
-					return session as any;
-				}
-				if (model === "verification") {
-					const verification: Verification = {
-						id,
-						createdAt: randomDate,
-						updatedAt: new Date(),
-						expiresAt: new Date(),
-						identifier: `test:${generateId()}`,
-						value: generateId(),
-					};
-					return verification as any;
-				}
-				if (model === "account") {
-					const account: Account = {
-						id,
-						createdAt: randomDate,
-						updatedAt: new Date(),
-						accountId: generateId(),
-						providerId: "test",
-						userId: generateId(),
-						accessToken: generateId(),
-						refreshToken: generateId(),
-						idToken: generateId(),
-						accessTokenExpiresAt: new Date(),
-						refreshTokenExpiresAt: new Date(),
-						scope: "test",
-					};
-					return account as any;
-				}
-				// This should never happen given the type constraints, but TypeScript needs an exhaustive check
-				throw new Error(`Unknown model type: ${model}`);
-			};
-
-			const insertRandom: InsertRandomFn = async <
-				M extends "user" | "session" | "verification" | "account",
-				Count extends number = 1,
-			>(
-				model: M,
-				count: Count = 1 as Count,
-			) => {
-				const res: any[] = [];
-				const a = wrapperAdapter();
-
-				for (let i = 0; i < count; i++) {
-					const modelResults = [];
-
-					if (model === "user") {
-						const user = await generateModel("user");
-						modelResults.push(
-							await a.create({
-								data: user,
-								model: "user",
-								forceAllowId: true,
-							}),
-						);
-					}
-					if (model === "session") {
-						const user = await generateModel("user");
-						const userRes = await a.create({
-							data: user,
-							model: "user",
-							forceAllowId: true,
-						});
-						const session = await generateModel("session");
-						session.userId = userRes.id;
-						const sessionRes = await a.create({
-							data: session,
-							model: "session",
-							forceAllowId: true,
-						});
-						modelResults.push(userRes, sessionRes);
-					}
-					if (model === "verification") {
-						const verification = await generateModel("verification");
-						modelResults.push(
-							await a.create({
-								data: verification,
-								model: "verification",
-								forceAllowId: true,
-							}),
-						);
-					}
-					if (model === "account") {
-						const user = await generateModel("user");
-						const account = await generateModel("account");
-						const userRes = await a.create({
-							data: user,
-							model: "user",
-							forceAllowId: true,
-						});
-						account.userId = userRes.id;
-						const accRes = await a.create({
-							data: account,
-							model: "account",
-							forceAllowId: true,
-						});
-						modelResults.push(userRes, accRes);
-					}
-					res.push(modelResults);
-				}
-				return res.length === 1 ? res[0] : (res as any);
-			};
-
-			const sortModels = (
-				models: Array<Record<string, any> & { id: string }>,
-				by: "id" | "createdAt" = "id",
-			) => {
-				return models.sort((a, b) => {
-					if (by === "createdAt") {
-						return (
-							new Date(a.createdAt).getTime() - new Date(b.createdAt).getTime()
-						);
-					}
-					return a.id.localeCompare(b.id);
-				});
-			};
-
-			const modifyBetterAuthOptions = async (
-				opts: BetterAuthOptions,
-				shouldRunMigrations: boolean,
-			) => {
-				return await applyOptionsAndMigrate(opts, shouldRunMigrations);
-			};
-
-			const additionalOptions = { ...options };
-			additionalOptions.disableTests = undefined;
-
-			const fullTests = tests(
-				{
-					adapter: new Proxy({} as any, {
-						get(target, prop) {
-							const adapter = wrapperAdapter();
-							if (prop === "transaction") {
-								return adapter.transaction;
-							}
-							const value = adapter[prop as keyof typeof adapter];
-							if (typeof value === "function") {
-								return value.bind(adapter);
-							}
-							return value;
-						},
-					}),
-					getAuth: async () => {
-						adapter = await helpers.adapter();
-						const auth = betterAuth({
-							...helpers.getBetterAuthOptions(),
-							...(config?.defaultBetterAuthOptions || {}),
-							database: (options: BetterAuthOptions) => {
-								const adapter = wrapperAdapter(options);
-								return adapter;
-							},
-						} as BetterAuthOptions);
-						return auth;
-					},
-					log: helpers.log,
-					generate: generateModel,
-					cleanup: cleanupCreatedRows,
-					hardCleanup: helpers.cleanup,
-					insertRandom,
-					modifyBetterAuthOptions,
-					getBetterAuthOptions: helpers.getBetterAuthOptions,
-					sortModels,
-					tryCatch,
-					customIdGenerator: helpers.customIdGenerator,
-					transformGeneratedModel,
-					transformIdOutput: helpers.transformIdOutput,
-				},
-				additionalOptions as AdditionalOptions,
-			);
-
-			const dash = `─`;
-			const allDisabled: boolean = options?.disableTests?.ALL ?? false;
-
-			// Here to display a label in the tests showing the suite name
-			test(`\n${TTY_COLORS.fg.white}${" ".repeat(3)}${dash.repeat(35)} [${TTY_COLORS.fg.magenta}${suiteName}${TTY_COLORS.fg.white}] ${dash.repeat(35)}`, async () => {
-				try {
-					await helpers.cleanup();
-				} catch {}
-				if (config.defaultBetterAuthOptions && !allDisabled) {
-					await applyOptionsAndMigrate(
-						config.defaultBetterAuthOptions,
-						config.alwaysMigrate,
-					);
-				}
-			});
-
-			/**
-			 * Extract test function and migration options from a test entry.
-			 */
-			const extractTestEntry = (
-				entry: TestEntry,
-			): {
-				testFn: (context: {
-					readonly skip: {
-						(note?: string | undefined): never;
-						(condition: boolean, note?: string | undefined): void;
-					};
-				}) => Promise<void>;
-				migrateBetterAuth?: BetterAuthOptions;
-			} => {
-				if (typeof entry === "function") {
-					return { testFn: entry };
-				}
-				return {
-					testFn: entry.test,
-					migrateBetterAuth: entry.migrateBetterAuth,
-				};
-			};
-
-			// Convert test entries to array with migration info (moved before onFinish for access)
-			const testEntries = Object.entries(fullTests).map(([name, entry]) => {
-				const { testFn, migrateBetterAuth } = extractTestEntry(
-					entry as TestEntry,
-				);
-				return { name, testFn, migrateBetterAuth };
-			});
-
-			/**
-			 * Group tests by their migrateBetterAuth options.
-			 * Tests with equal migration options are grouped together.
-			 */
-			type TestGroup = {
-				migrationOptions: BetterAuthOptions | null | undefined;
-				testIndices: number[];
-			};
-
-			const groupTestsByMigrationOptions = (): TestGroup[] => {
-				const groups: TestGroup[] = [];
-				let currentGroup: TestGroup | null = null;
-
-				for (let i = 0; i < testEntries.length; i++) {
-					const { migrateBetterAuth } = testEntries[i]!;
-					const isSkipped =
-						(allDisabled &&
-							options?.disableTests?.[testEntries[i]!.name] !== false) ||
-						(options?.disableTests?.[testEntries[i]!.name] ?? false);
-
-					// Skip grouping for skipped tests - they'll be handled individually
-					if (isSkipped) {
-						if (currentGroup) {
-							groups.push(currentGroup);
-							currentGroup = null;
-						}
-						groups.push({
-							migrationOptions: migrateBetterAuth,
-							testIndices: [i],
-						});
-						continue;
-					}
-
-					// Check if this test belongs to the current group
-					if (
-						currentGroup &&
-						deepEqual(currentGroup.migrationOptions, migrateBetterAuth)
-					) {
-						currentGroup.testIndices.push(i);
-					} else {
-						// Start a new group
-						if (currentGroup) {
-							groups.push(currentGroup);
-						}
-						currentGroup = {
-							migrationOptions: migrateBetterAuth,
-							testIndices: [i],
-						};
-					}
-				}
-
-				// Add the last group if it exists
-				if (currentGroup) {
-					groups.push(currentGroup);
-				}
-
-				return groups;
-			};
-
-			const testGroups = groupTestsByMigrationOptions();
-
-			// Calculate grouping statistics
-			const calculateGroupingStats = () => {
-				const nonSkippedGroups = testGroups.filter(
-					(group) => group.testIndices.length > 0,
-				);
-				const groupSizes = nonSkippedGroups.map(
-					(group) => group.testIndices.length,
-				);
-
-				if (groupSizes.length === 0) {
-					return {
-						totalGroups: 0,
-						averageTestsPerGroup: 0,
-						largestGroupSize: 0,
-						smallestGroupSize: 0,
-						groupsWithMultipleTests: 0,
-						totalTestsInGroups: 0,
-					};
-				}
-
-				const totalTestsInGroups = groupSizes.reduce(
-					(sum, size) => sum + size,
-					0,
-				);
-				const groupsWithMultipleTests = groupSizes.filter(
-					(size) => size > 1,
-				).length;
-
-				return {
-					totalGroups: nonSkippedGroups.length,
-					averageTestsPerGroup: totalTestsInGroups / nonSkippedGroups.length,
-					largestGroupSize: Math.max(...groupSizes),
-					smallestGroupSize: Math.min(...groupSizes),
-					groupsWithMultipleTests,
-					totalTestsInGroups,
-				};
-			};
-
-			const onFinish = async (testName: string) => {
-				await cleanupCreatedRows();
-
-				const currentTestIndex = testEntries.findIndex(
-					({ name }) => name === testName,
-				);
-				const isLastTest = currentTestIndex === testEntries.length - 1;
-
-				if (isLastTest) {
-					stats.suiteDuration = performance.now() - stats.suiteStartTime;
-					stats.groupingStats = calculateGroupingStats();
-					await helpers.onTestFinish(stats);
-				}
-			};
-
-			// Track the current group's migration options
-			let currentGroupMigrationOptions: BetterAuthOptions | null | undefined =
-				null;
-
-			for (let i = 0; i < testEntries.length; i++) {
-				const { name: testName, testFn, migrateBetterAuth } = testEntries[i]!;
-
-				// Find which group this test belongs to
-				const testGroup = testGroups.find((group) =>
-					group.testIndices.includes(i),
-				);
-				const isFirstInGroup = testGroup && testGroup.testIndices[0] === i;
-
-				const shouldSkip =
-					(allDisabled && options?.disableTests?.[testName] !== false) ||
-					(options?.disableTests?.[testName] ?? false);
-
-				let displayName = testName.replace(
-					" - ",
-					` ${TTY_COLORS.dim}${dash}${TTY_COLORS.undim} `,
-				);
-				if (config.prefixTests) {
-					displayName = `${config.prefixTests} ${TTY_COLORS.dim}>${TTY_COLORS.undim} ${displayName}`;
-				}
-				if (helpers.prefixTests) {
-					displayName = `[${TTY_COLORS.dim}${helpers.prefixTests}${TTY_COLORS.undim}] ${displayName}`;
-				}
-
-				test.skipIf(shouldSkip)(
-					displayName,
-					{ timeout: 30000 },
-					async ({ onTestFailed, skip }) => {
-						resetDebugLogs();
-
-						// Apply migration options before test runs
-						await (async () => {
-							if (shouldSkip) return;
-
-							const thisMigration = deepmerge(
-								config.defaultBetterAuthOptions || {},
-								migrateBetterAuth || {},
-							);
-
-							// If this is the first test in a group, migrate to the group's options
-							if (isFirstInGroup && testGroup) {
-								const groupMigrationOptions = testGroup.migrationOptions;
-								const groupFinalOptions = deepmerge(
-									config.defaultBetterAuthOptions || {},
-									groupMigrationOptions || {},
-								);
-
-								// Only migrate if the group's options are different from current state
-								if (
-									!deepEqual(
-										currentGroupMigrationOptions,
-										groupMigrationOptions,
-									)
-								) {
-									await applyOptionsAndMigrate(groupFinalOptions, true);
-									currentGroupMigrationOptions = groupMigrationOptions;
-								}
-							}
-							// If this test is not in a group or not first in group, check if migration is needed
-							else if (
-								!deepEqual(currentGroupMigrationOptions, migrateBetterAuth)
-							) {
-								await applyOptionsAndMigrate(thisMigration, true);
-								currentGroupMigrationOptions = migrateBetterAuth;
-							}
-						})();
-
-						stats.testCount++;
-
-						onTestFailed(async () => {
-							printDebugLogs();
-							await onFinish(testName);
-						});
-						await testFn({ skip });
-						await onFinish(testName);
-					},
-				);
-			}
-		};
-	};
-};

package/src/adapter/index.ts

@@ -1,7 +0,0 @@
-export {
-	createTestSuite,
-	type InsertRandomFn,
-	type TestEntry,
-	type TestSuiteStats,
-} from "./create-test-suite";
-export { type Logger, testAdapter } from "./test-adapter";

package/src/adapter/test-adapter.ts

@@ -1,384 +0,0 @@
-import type { Awaitable, BetterAuthOptions } from "@better-auth/core";
-import type { DBAdapter } from "@better-auth/core/db/adapter";
-import { deepmerge, initGetModelName } from "@better-auth/core/db/adapter";
-import { TTY_COLORS } from "@better-auth/core/env";
-import { getAuthTables } from "better-auth/db";
-import { afterAll, beforeAll, describe } from "vitest";
-import type { createTestSuite, TestSuiteStats } from "./create-test-suite";
-
-export type Logger = {
-	info: (...args: any[]) => void;
-	success: (...args: any[]) => void;
-	warn: (...args: any[]) => void;
-	error: (...args: any[]) => void;
-	debug: (...args: any[]) => void;
-};
-
-export const testAdapter = async ({
-	adapter: getAdapter,
-	runMigrations,
-	overrideBetterAuthOptions,
-	additionalCleanups,
-	tests,
-	prefixTests,
-	onFinish,
-	customIdGenerator,
-	transformIdOutput,
-}: {
-	/**
-	 * A function that will return the adapter instance to test with.
-	 *
-	 * @example
-	 * ```ts
-	 * testAdapter({
-	 *   adapter: (options) => drizzleAdapter(drizzle(db), {
-	 *     schema: generateSchema(options),
-	 *   }),
-	 * })
-	 */
-	adapter: (
-		options: BetterAuthOptions,
-	) => Awaitable<(options: BetterAuthOptions) => DBAdapter<BetterAuthOptions>>;
-	/**
-	 * A function that will run the database migrations.
-	 */
-	runMigrations: (betterAuthOptions: BetterAuthOptions) => Promise<void> | void;
-	/**
-	 * Any potential better-auth options overrides.
-	 */
-	overrideBetterAuthOptions?: (
-		betterAuthOptions: BetterAuthOptions,
-	) => BetterAuthOptions;
-	/**
-	 * By default we will cleanup all tables automatically,
-	 * but if you have additional cleanup logic, you can pass it here.
-	 *
-	 * Such as deleting a DB file that could had been created.
-	 */
-	additionalCleanups?: () => Promise<void> | void;
-	/**
-	 * A test suite to run.
-	 */
-	tests: ReturnType<ReturnType<typeof createTestSuite>>[];
-	/**
-	 * A prefix to add to the test suite name.
-	 */
-	prefixTests?: string;
-	/**
-	 * Upon finish of the tests, this function will be called.
-	 */
-	onFinish?: () => Promise<void> | void;
-	/**
-	 * Custom ID generator function to be used by the helper functions. (such as `insertRandom`)
-	 */
-	customIdGenerator?: () => any;
-	/**
-	 * A function that will transform the ID output.
-	 */
-	transformIdOutput?: (id: any) => any;
-}) => {
-	const defaultBAOptions = {} satisfies BetterAuthOptions;
-	let betterAuthOptions = (() => {
-		return {
-			...defaultBAOptions,
-			...(overrideBetterAuthOptions?.(defaultBAOptions) || {}),
-		} satisfies BetterAuthOptions;
-	})();
-
-	let adapter: DBAdapter<BetterAuthOptions> = (
-		await getAdapter(betterAuthOptions)
-	)(betterAuthOptions);
-
-	const adapterName = adapter.options?.adapterConfig.adapterName;
-	const adapterId = adapter.options?.adapterConfig.adapterId || adapter.id;
-	const adapterDisplayName = adapterName || adapterId;
-
-	const refreshAdapter = async (betterAuthOptions: BetterAuthOptions) => {
-		adapter = (await getAdapter(betterAuthOptions))(betterAuthOptions);
-	};
-
-	/**
-	 * A helper function to log to the console.
-	 */
-	const log: Logger = (() => {
-		return {
-			info: (...args: any[]) =>
-				console.log(
-					`${TTY_COLORS.fg.blue}INFO   ${TTY_COLORS.reset} [${adapterDisplayName}]`,
-					...args,
-				),
-			success: (...args: any[]) =>
-				console.log(
-					`${TTY_COLORS.fg.green}SUCCESS${TTY_COLORS.reset} [${adapterDisplayName}]`,
-					...args,
-				),
-			warn: (...args: any[]) =>
-				console.log(
-					`${TTY_COLORS.fg.yellow}WARN   ${TTY_COLORS.reset} [${adapterDisplayName}]`,
-					...args,
-				),
-			error: (...args: any[]) =>
-				console.log(
-					`${TTY_COLORS.fg.red}ERROR  ${TTY_COLORS.reset} [${adapterDisplayName}]`,
-					...args,
-				),
-			debug: (...args: any[]) =>
-				console.log(
-					`${TTY_COLORS.fg.magenta}DEBUG  ${TTY_COLORS.reset} [${adapterDisplayName}]`,
-					...args,
-				),
-		};
-	})();
-
-	/**
-	 * Cleanup function to remove all rows from the database.
-	 */
-	const cleanup = async () => {
-		const start = performance.now();
-		await refreshAdapter(betterAuthOptions);
-		const getAllModels = getAuthTables(betterAuthOptions);
-
-		// Clean up all rows from all models
-		for (const model of Object.keys(getAllModels)) {
-			const getModelName = initGetModelName({
-				usePlural: adapter.options?.adapterConfig?.usePlural,
-				schema: getAllModels,
-			});
-			try {
-				const modelName = getModelName(model);
-				await adapter.deleteMany({ model: modelName, where: [] });
-			} catch (error) {
-				const msg = `Error while cleaning up all rows from ${model}`;
-				log.error(msg, error);
-				throw new Error(msg, {
-					cause: error,
-				});
-			}
-		}
-
-		// Run additional cleanups
-		try {
-			await additionalCleanups?.();
-		} catch (error) {
-			const msg = `Error while running additional cleanups`;
-			log.error(msg, error);
-			throw new Error(msg, {
-				cause: error,
-			});
-		}
-		await refreshAdapter(betterAuthOptions);
-		log.success(
-			`${TTY_COLORS.bright}CLEAN-UP${TTY_COLORS.reset} completed successfully (${(performance.now() - start).toFixed(3)}ms)`,
-		);
-	};
-
-	/**
-	 * A function that will run the database migrations.
-	 */
-	const migrate = async () => {
-		const start = performance.now();
-
-		try {
-			await runMigrations(betterAuthOptions);
-		} catch (error) {
-			const msg = `Error while running migrations`;
-			log.error(msg, error);
-			throw new Error(msg, {
-				cause: error,
-			});
-		}
-		log.success(
-			`${TTY_COLORS.bright}MIGRATIONS${TTY_COLORS.reset} completed successfully (${(performance.now() - start).toFixed(3)}ms)`,
-		);
-	};
-
-	return {
-		execute: () => {
-			describe(adapterDisplayName, async () => {
-				// Collect statistics from all test suites
-				const allSuiteStats: TestSuiteStats[] = [];
-
-				beforeAll(async () => {
-					await migrate();
-				}, 60000);
-
-				afterAll(async () => {
-					await cleanup();
-
-					// Display statistics summary
-					if (allSuiteStats.length > 0) {
-						const totalMigrations = allSuiteStats.reduce(
-							(sum, stats) => sum + stats.migrationCount,
-							0,
-						);
-						const totalMigrationTime = allSuiteStats.reduce(
-							(sum, stats) => sum + stats.totalMigrationTime,
-							0,
-						);
-						const totalTests = allSuiteStats.reduce(
-							(sum, stats) => sum + stats.testCount,
-							0,
-						);
-						const totalDuration = allSuiteStats.reduce(
-							(sum, stats) => sum + stats.suiteDuration,
-							0,
-						);
-
-						const dash = "─";
-						const separator = `${dash.repeat(80)}`;
-
-						console.log(`\n${TTY_COLORS.fg.cyan}${separator}`);
-						console.log(
-							`${TTY_COLORS.fg.cyan}${TTY_COLORS.bright}TEST SUITE STATISTICS SUMMARY${TTY_COLORS.reset}`,
-						);
-						console.log(
-							`${TTY_COLORS.fg.cyan}${separator}${TTY_COLORS.reset}\n`,
-						);
-
-						// Per-suite breakdown
-						for (const stats of allSuiteStats) {
-							const avgMigrationTime =
-								stats.migrationCount > 0
-									? (stats.totalMigrationTime / stats.migrationCount).toFixed(2)
-									: "0.00";
-							console.log(
-								`${TTY_COLORS.fg.magenta}${stats.suiteName}${TTY_COLORS.reset}:`,
-							);
-							console.log(
-								`  Tests: ${TTY_COLORS.fg.green}${stats.testCount}${TTY_COLORS.reset}`,
-							);
-							console.log(
-								`  Migrations: ${TTY_COLORS.fg.yellow}${stats.migrationCount}${TTY_COLORS.reset} (avg: ${avgMigrationTime}ms)`,
-							);
-							console.log(
-								`  Total Migration Time: ${TTY_COLORS.fg.yellow}${stats.totalMigrationTime.toFixed(2)}ms${TTY_COLORS.reset}`,
-							);
-							console.log(
-								`  Suite Duration: ${TTY_COLORS.fg.blue}${stats.suiteDuration.toFixed(2)}ms${TTY_COLORS.reset}`,
-							);
-
-							// Display grouping statistics if available
-							if (stats.groupingStats) {
-								const {
-									totalGroups,
-									averageTestsPerGroup,
-									largestGroupSize,
-									smallestGroupSize,
-									groupsWithMultipleTests,
-								} = stats.groupingStats;
-								console.log(
-									`  Test Groups: ${TTY_COLORS.fg.cyan}${totalGroups}${TTY_COLORS.reset}`,
-								);
-								if (totalGroups > 0) {
-									console.log(
-										`    Avg Tests/Group: ${TTY_COLORS.fg.cyan}${averageTestsPerGroup.toFixed(2)}${TTY_COLORS.reset}`,
-									);
-									console.log(
-										`    Largest Group: ${TTY_COLORS.fg.cyan}${largestGroupSize}${TTY_COLORS.reset}`,
-									);
-									console.log(
-										`    Smallest Group: ${TTY_COLORS.fg.cyan}${smallestGroupSize}${TTY_COLORS.reset}`,
-									);
-									console.log(
-										`    Groups w/ Multiple Tests: ${TTY_COLORS.fg.cyan}${groupsWithMultipleTests}${TTY_COLORS.reset}`,
-									);
-								}
-							}
-
-							console.log("");
-						}
-
-						// Totals
-						const avgMigrationTime =
-							totalMigrations > 0
-								? (totalMigrationTime / totalMigrations).toFixed(2)
-								: "0.00";
-
-						// Calculate total grouping statistics
-						const totalGroups = allSuiteStats.reduce(
-							(sum, stats) => sum + (stats.groupingStats?.totalGroups || 0),
-							0,
-						);
-						const totalGroupsWithMultipleTests = allSuiteStats.reduce(
-							(sum, stats) =>
-								sum + (stats.groupingStats?.groupsWithMultipleTests || 0),
-							0,
-						);
-						const totalTestsInGroups = allSuiteStats.reduce(
-							(sum, stats) =>
-								sum + (stats.groupingStats?.totalTestsInGroups || 0),
-							0,
-						);
-						const avgTestsPerGroup =
-							totalGroups > 0 ? totalTestsInGroups / totalGroups : 0;
-
-						console.log(`${TTY_COLORS.fg.cyan}${separator}`);
-						console.log(
-							`${TTY_COLORS.fg.cyan}${TTY_COLORS.bright}TOTALS${TTY_COLORS.reset}`,
-						);
-						console.log(
-							`  Total Tests: ${TTY_COLORS.fg.green}${totalTests}${TTY_COLORS.reset}`,
-						);
-						console.log(
-							`  Total Migrations: ${TTY_COLORS.fg.yellow}${totalMigrations}${TTY_COLORS.reset} (avg: ${avgMigrationTime}ms)`,
-						);
-						console.log(
-							`  Total Migration Time: ${TTY_COLORS.fg.yellow}${totalMigrationTime.toFixed(2)}ms${TTY_COLORS.reset}`,
-						);
-						console.log(
-							`  Total Duration: ${TTY_COLORS.fg.blue}${totalDuration.toFixed(2)}ms${TTY_COLORS.reset}`,
-						);
-
-						// Display total grouping statistics
-						if (totalGroups > 0) {
-							console.log(
-								`  Total Test Groups: ${TTY_COLORS.fg.cyan}${totalGroups}${TTY_COLORS.reset}`,
-							);
-							console.log(
-								`    Avg Tests/Group: ${TTY_COLORS.fg.cyan}${avgTestsPerGroup.toFixed(2)}${TTY_COLORS.reset}`,
-							);
-							console.log(
-								`    Groups w/ Multiple Tests: ${TTY_COLORS.fg.cyan}${totalGroupsWithMultipleTests}${TTY_COLORS.reset}`,
-							);
-						}
-
-						console.log(
-							`${TTY_COLORS.fg.cyan}${separator}${TTY_COLORS.reset}\n`,
-						);
-					}
-
-					await onFinish?.();
-				}, 60000);
-
-				for (const testSuite of tests) {
-					await testSuite({
-						adapter: async () => {
-							await refreshAdapter(betterAuthOptions);
-							return adapter;
-						},
-						adapterDisplayName,
-						log,
-						getBetterAuthOptions: () => betterAuthOptions,
-						modifyBetterAuthOptions: async (options) => {
-							const newOptions = deepmerge(defaultBAOptions, options);
-							betterAuthOptions = deepmerge(
-								newOptions,
-								overrideBetterAuthOptions?.(newOptions) || {},
-							);
-							await refreshAdapter(betterAuthOptions);
-							return betterAuthOptions;
-						},
-						cleanup,
-						prefixTests,
-						runMigrations: migrate,
-						onTestFinish: async (stats: TestSuiteStats) => {
-							allSuiteStats.push(stats);
-						},
-						customIdGenerator,
-						transformIdOutput,
-					});
-				}
-			});
-		},
-	};
-};

package/tsconfig.json

@@ -1,11 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "references": [
-    {
-      "path": "../core/tsconfig.json"
-    },
-    {
-      "path": "../better-auth/tsconfig.json"
-    }
-  ]
-}

package/tsdown.config.ts

@@ -1,13 +0,0 @@
-import { defineConfig } from "tsdown";
-
-export default defineConfig({
-	dts: { build: true, incremental: true },
-	format: ["esm"],
-	entry: {
-		adapter: "./src/adapter/index.ts",
-	},
-	sourcemap: true,
-	unbundle: true,
-	outDir: "./dist",
-	clean: true,
-});