refactor(better-auth): update adapter and migration logic for improved type safety

- Changed `AdapterDebugLogs` to `DBAdapterDebugLogOption` in `FileMakerAdapterConfig`.
- Updated `betterAuthSchema` type in `planMigration` to use a more accurate schema definition.
- Enhanced CLI to utilize `getSchema` instead of `getAuthTables` for better compatibility.
- Added new entries to `.gitignore` for machine-specific sync files.

Author: eluce2

.beads/.gitignore

@@ -32,6 +32,11 @@ beads.left.meta.json
 beads.right.jsonl
 beads.right.meta.json
 
+# Sync state (local-only, per-machine)
+# These files are machine-specific and should not be shared across clones
+.sync.lock
+sync_base.jsonl
+
 # NOTE: Do NOT add negation patterns (e.g., !issues.jsonl) here.
 # They would override fork protection in .git/info/exclude, allowing
 # contributors to accidentally commit upstream issue databases.

packages/better-auth/src/adapter.ts

@@ -1,6 +1,6 @@
 /** biome-ignore-all lint/suspicious/noExplicitAny: library code */
 import { logger } from "better-auth";
-import { type AdapterDebugLogs, type CleanedWhere, createAdapter } from "better-auth/adapters";
+import { type CleanedWhere, createAdapter, type DBAdapterDebugLogOption } from "better-auth/adapters";
 import buildQuery from "odata-query";
 import { prettifyError, z } from "zod/v4";
 import { createRawFetch, type FmOdataConfig } from "./odata";
@@ -15,11 +15,11 @@ const configSchema = z.object({
   }),
 });
 
-interface FileMakerAdapterConfig {
+export interface FileMakerAdapterConfig {
   /**
    * Helps you debug issues with the adapter.
    */
-  debugLogs?: AdapterDebugLogs;
+  debugLogs?: DBAdapterDebugLogOption;
   /**
    * If the table names in the schema are plural.
    */
@@ -168,7 +168,7 @@ export const FileMakerAdapter = (_config: FileMakerAdapterConfig = defaultConfig
     logging: config.debugLogs ? "verbose" : "none",
   });
 
-  return createAdapter({
+  const adapterFactory = createAdapter({
     config: {
       adapterId: "filemaker",
       adapterName: "FileMaker",
@@ -382,4 +382,8 @@ export const FileMakerAdapter = (_config: FileMakerAdapterConfig = defaultConfig
       };
     },
   });
+
+  // Expose the FileMaker config for CLI access
+  (adapterFactory as any).filemakerConfig = config as FileMakerAdapterConfig;
+  return adapterFactory;
 };

packages/better-auth/src/cli/index.ts

@@ -1,11 +1,11 @@
 #!/usr/bin/env node --no-warnings
 import { Command } from "@commander-js/extra-typings";
 import { logger } from "better-auth";
-import { getAdapter, getAuthTables } from "better-auth/db";
+import { getAdapter, getSchema } from "better-auth/db";
 import chalk from "chalk";
 import fs from "fs-extra";
 import prompts from "prompts";
-import type { AdapterOptions } from "../adapter";
+import type { FileMakerAdapterConfig } from "../adapter";
 import { getConfig } from "../better-auth-cli/utils/get-config";
 import { executeMigration, planMigration, prettyPrintMigrationPlan } from "../migrate";
 import { createRawFetch } from "../odata";
@@ -50,9 +50,9 @@ async function main() {
         return;
       }
 
-      const betterAuthSchema = getAuthTables(config);
+      const betterAuthSchema = getSchema(config);
 
-      const adapterConfig = (adapter.options as AdapterOptions).config;
+      const adapterConfig = (adapter as unknown as { filemakerConfig: FileMakerAdapterConfig }).filemakerConfig;
       const { fetch } = createRawFetch({
         ...adapterConfig.odata,
         auth:

packages/better-auth/src/migrate.ts

@@ -1,9 +1,12 @@
-import type { BetterAuthDbSchema } from "better-auth/db";
+import type { DBFieldAttribute } from "better-auth/db";
 import chalk from "chalk";
 import type { Metadata } from "fm-odata-client";
 import z from "zod/v4";
 import type { createRawFetch } from "./odata";
 
+/** Schema type returned by better-auth's getSchema function */
+type BetterAuthSchema = Record<string, { fields: Record<string, DBFieldAttribute>; order: number }>;
+
 export async function getMetadata(fetch: ReturnType<typeof createRawFetch>["fetch"], databaseName: string) {
   console.log("getting metadata...");
   const result = await fetch("/$metadata", {
@@ -28,7 +31,7 @@ export async function getMetadata(fetch: ReturnType<typeof createRawFetch>["fetc
 
 export async function planMigration(
   fetch: ReturnType<typeof createRawFetch>["fetch"],
-  betterAuthSchema: BetterAuthDbSchema,
+  betterAuthSchema: BetterAuthSchema,
   databaseName: string,
 ): Promise<MigrationPlan> {
   const metadata = await getMetadata(fetch, databaseName);
@@ -86,7 +89,7 @@ export async function planMigration(
     .sort((a, b) => (a[1].order ?? 0) - (b[1].order ?? 0))
     .map(([key, value]) => ({
       ...value,
-      keyName: key,
+      modelName: key, // Use the key as modelName since getSchema uses table names as keys
     }));
 
   const migrationPlan: MigrationPlan = [];