@convex-dev/better-auth 0.11.5 → 0.12.1

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION = "0.12.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,WAAW,CAAC"}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = "0.12.1";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC"}

package/package.json

@@ -6,7 +6,7 @@
   "bugs": {
     "url": "https://github.com/get-convex/better-auth/issues"
   },
-  "version": "0.11.5",
+  "version": "0.12.1",
   "license": "Apache-2.0",
   "keywords": [
     "convex",
@@ -32,7 +32,7 @@
     "preversion": "npm ci && npm run build:clean && npm run test && npm run lint && npm run typecheck",
     "alpha": "npm version prerelease --preid alpha && npm publish --tag alpha && git push --follow-tags",
     "release": "npm version patch && npm publish && git push --follow-tags",
-    "version": "(npm whoami || npm login) && vim -c 'normal o' -c 'normal o## '$npm_package_version CHANGELOG.md && prettier -w CHANGELOG.md && git add CHANGELOG.md"
+    "version": "(npm whoami || npm login) && node scripts/sync-version.mjs && vim -c 'normal o' -c 'normal o## '$npm_package_version CHANGELOG.md && prettier -w CHANGELOG.md && git add CHANGELOG.md src/version.ts"
   },
   "files": [
     "dist",
@@ -101,13 +101,13 @@
     }
   },
   "peerDependencies": {
-    "better-auth": ">=1.5.0 <1.6.0",
+    "better-auth": ">=1.6.9 <1.7.0",
     "convex": "^1.25.0",
     "react": "^18.3.1 || ^19.0.0"
   },
   "devDependencies": {
-    "@better-auth/core": "~1.5.6",
-    "@better-auth/test-utils": "~1.5.6",
+    "@better-auth/core": "~1.6.9",
+    "@better-auth/test-utils": "~1.6.9",
     "@edge-runtime/vm": "5.0.0",
     "@eslint/eslintrc": "3.3.1",
     "@eslint/js": "9.39.1",
@@ -117,7 +117,7 @@
     "@types/react": "19.2.14",
     "@types/react-dom": "19.2.3",
     "@types/semver": "^7.7.0",
-    "better-auth": "~1.5.6",
+    "better-auth": "~1.6.9",
     "chokidar-cli": "3.0.0",
     "concurrently": "^9.2.0",
     "convex": "1.35.1",

package/src/auth-options.ts

@@ -37,6 +37,7 @@ export const options = {
     }),
     oidcProvider({
       loginPage: "/login",
+      __skipDeprecationWarning: true,
     }),
     bearer(),
     oneTimeToken(),

package/src/client/adapter-utils.ts

@@ -41,6 +41,7 @@ export const adapterWhereValidator = v.object({
     v.null()
   ),
   connector: v.optional(v.union(v.literal("AND"), v.literal("OR"))),
+  mode: v.optional(v.union(v.literal("sensitive"), v.literal("insensitive"))),
 });
 
 export const adapterArgsValidator = v.object({
@@ -106,6 +107,7 @@ const findIndex = (
         | "ends_with";
       value: string | number | boolean | null | string[] | number[];
       connector?: "AND" | "OR";
+      mode?: "sensitive" | "insensitive";
     }[];
     sortBy?: {
       field: string;
@@ -185,11 +187,7 @@ const findIndex = (
   // We internally use _creationTime in place of Better Auth's createdAt
   const indexFields = indexEqFields
     .map(([field]) => field)
-    .concat(
-      boundField && boundField !== "createdAt"
-        ? boundField
-        : ""
-    )
+    .concat(boundField && boundField !== "createdAt" ? boundField : "")
     .concat(
       sortField && sortField !== "createdAt" && boundField !== sortField
         ? sortField
@@ -499,6 +497,11 @@ export const paginate = async <
       `_id can only be used with eq, in, or not_in operator: ${JSON.stringify(args.where)}`
     );
   }
+  if (args.where?.some((w) => w.mode === "insensitive")) {
+    throw new Error(
+      `Case-insensitive queries (mode: "insensitive") are not supported by the Convex adapter. Store values in a normalized form (e.g. lowercase on write) and query against the normalized value.`
+    );
+  }
   // If any where clause is "eq" (or missing operator) on a unique field,
   // we can only return a single document, so we get it and use any other
   // where clauses as static filters.
@@ -514,6 +517,11 @@ export const paginate = async <
         model: args.model,
         where: [uniqueWhere],
       }) || {};
+    if (uniqueWhere.field !== "_id" && !index) {
+      throw new Error(
+        `No index found for ${args.model}.${uniqueWhere.field}`
+      );
+    }
     const doc =
       uniqueWhere.field === "_id"
         ? await ctx.db.get(uniqueWhere.value as GenericId<T>)

package/src/client/adapter.test.ts

@@ -2,8 +2,29 @@
 
 import { describe, it } from "vitest";
 import { convexTest } from "convex-test";
-import { api } from "../component/_generated/api.js";
+import {
+  testAdapter,
+  transactionsTestSuite,
+  uuidTestSuite,
+} from "@better-auth/test-utils/adapter";
+import type { BetterAuthOptions } from "better-auth";
+import { internal } from "../component/_generated/api.js";
 import schema from "../component/testProfiles/schema.profile-plugin-table.js";
+import { createClient } from "./index.js";
+import type { DataModel } from "../component/_generated/dataModel.js";
+import type { ComponentApi } from "../component/_generated/component.js";
+import {
+  additionalFieldsAuthFlowTestSuite,
+  additionalFieldsNormalTestSuite,
+  convexCustomTestSuite,
+  coreAuthFlowTestSuite,
+  coreNormalTestSuite,
+  multiJoinsMissingRowsTestSuite,
+  pluginTableNormalTestSuite,
+  renameFieldAndJoinTestSuite,
+  renameModelUserCustomTestSuite,
+  renameModelUserTableTestSuite,
+} from "../test/adapter-factory/index.js";
 
 const MIN_NODE_MAJOR = 24;
 const currentNodeMajor = Number.parseInt(
@@ -11,6 +32,85 @@ const currentNodeMajor = Number.parseInt(
   10
 );
 
+const NORMAL_DISABLED_TESTS = [
+  // dynamic-schema-plugin-table/dynamic-schema-additional-fields:
+  // Convex validators are static in this harness, so runtime schema mutation
+  // tests are validated in dedicated profiles instead.
+  "create - should apply default values to fields",
+  "create - should return null for nullable foreign keys",
+  "create - should support arrays",
+  "create - should support json",
+  // convex-id-generation:
+  // Convex controls generated IDs at write time.
+  "create - should use generateId if provided",
+  // offset-unsupported:
+  // Convex adapter rejects offset pagination.
+  "findMany - should be able to perform a complex limited join",
+  "findMany - should find many models with limit and offset",
+  "findMany - should find many models with offset",
+  "findMany - should find many models with sortBy and limit and offset",
+  "findMany - should find many models with sortBy and limit and offset and where",
+  "findMany - should find many models with sortBy and offset",
+  "findMany - should find many with both one-to-one and one-to-many joins",
+  "findMany - should find many with join and offset",
+  "findMany - should find many with join, where, limit, and offset",
+  "findMany - should find many with one-to-one join",
+  "findMany - should handle mixed joins correctly when some are missing",
+  "findMany - should return empty array when base records don't exist with joins",
+  "findMany - should return null for one-to-one join when joined records don't exist",
+  "findMany - should select fields with one-to-one join",
+  // profile-specific coverage:
+  // These are intentionally exercised in dedicated profile suites.
+  "findOne - backwards join with modified field name (session base, users-table join)",
+  "findOne - multiple joins should return result even when some joined tables have no matching rows",
+  "findOne - should find a model with modified field name",
+  "findOne - should find a model with modified model name",
+  "findOne - should join a model with modified field name",
+  "findOne - should not apply defaultValue if value not found",
+  "findOne - should return an object for one-to-one joins",
+  "findOne - should return null for failed base model lookup that has joins",
+  "findOne - should return null for one-to-one join when joined record doesn't exist",
+  "findOne - should select fields with one-to-one join",
+  "findOne - should work with both one-to-one and one-to-many joins",
+] as const;
+
+const UUID_SUITE_TESTS = ["init - tests"] as const;
+
+const toDisableMap = (testNames: readonly string[]) =>
+  Object.fromEntries(testNames.map((testName) => [testName, true]));
+
+const toEnableOnlyMap = (testNames: readonly string[]) => ({
+  ALL: true,
+  ...Object.fromEntries(testNames.map((testName) => [testName, false])),
+});
+
+const getOverrideBetterAuthOptions = (
+  opts: BetterAuthOptions
+): BetterAuthOptions => ({
+  ...opts,
+  advanced: {
+    ...opts.advanced,
+    database: {
+      ...opts.advanced?.database,
+      generateId: "uuid",
+    },
+  },
+});
+
+type AdapterModule = ComponentApi["adapter"];
+type TestProfileName =
+  | "adapterAdditionalFields"
+  | "adapterPluginTable"
+  | "adapterRenameField"
+  | "adapterRenameUserCustom"
+  | "adapterRenameUserTable"
+  | "adapterOrganizationJoins";
+
+type InternalWithTestProfiles = {
+  adapter: AdapterModule;
+  testProfiles: Record<TestProfileName, AdapterModule>;
+};
+
 if (currentNodeMajor < MIN_NODE_MAJOR) {
   describe("Better Auth Adapter Tests", () => {
     it.skip(
@@ -21,6 +121,129 @@ if (currentNodeMajor < MIN_NODE_MAJOR) {
 } else {
   describe("Better Auth Adapter Tests", async () => {
     const t = convexTest(schema, import.meta.glob("../component/**/*.*s"));
-    await t.action(api.adapterTest.runTests, {});
+
+    // Bridge `convexAdapter`'s ctx surface to `convexTest`. Each adapter call
+    // re-enters convex-test's AsyncLocalStorage frame via t.query / t.mutation,
+    // which is required by convex-test ≥0.0.45. State persists across calls
+    // because the test database lives on `t`, not in ALS.
+    const wrappedCtx = {
+      runQuery: t.query.bind(t),
+      runMutation: t.mutation.bind(t),
+    } as any;
+
+    const internalWithTestProfiles =
+      internal as unknown as InternalWithTestProfiles;
+    const profileApi = (name: TestProfileName): { adapter: AdapterModule } => ({
+      adapter: internalWithTestProfiles.testProfiles[name],
+    });
+
+    const baseProfileClient = createClient<DataModel>(
+      { adapter: internalWithTestProfiles.adapter },
+      { verbose: false }
+    );
+    const additionalFieldsProfileClient = createClient<DataModel>(
+      profileApi("adapterAdditionalFields"),
+      { verbose: false }
+    );
+    const pluginTableProfileClient = createClient<DataModel>(
+      profileApi("adapterPluginTable"),
+      { verbose: false }
+    );
+    const renameFieldProfileClient = createClient<DataModel>(
+      profileApi("adapterRenameField"),
+      { verbose: false }
+    );
+    const renameUserCustomProfileClient = createClient<DataModel>(
+      profileApi("adapterRenameUserCustom"),
+      { verbose: false }
+    );
+    const renameUserTableProfileClient = createClient<DataModel>(
+      profileApi("adapterRenameUserTable"),
+      { verbose: false }
+    );
+    const organizationJoinsProfileClient = createClient<DataModel>(
+      profileApi("adapterOrganizationJoins"),
+      { verbose: false }
+    );
+
+    const noMigrations = () => {
+      // Convex schema is static — no migrations needed.
+    };
+
+    const { execute: executeBaseProfile } = await testAdapter({
+      adapter: () => baseProfileClient.adapter(wrappedCtx),
+      runMigrations: noMigrations,
+      overrideBetterAuthOptions: getOverrideBetterAuthOptions,
+      tests: [
+        coreNormalTestSuite({
+          disableTests: toDisableMap(NORMAL_DISABLED_TESTS),
+        }),
+        uuidTestSuite({
+          disableTests: toEnableOnlyMap(UUID_SUITE_TESTS),
+        }),
+        transactionsTestSuite({ disableTests: { ALL: true } }),
+        coreAuthFlowTestSuite(),
+        convexCustomTestSuite(),
+      ],
+    });
+
+    const { execute: executeAdditionalFieldsProfile } = await testAdapter({
+      adapter: () => additionalFieldsProfileClient.adapter(wrappedCtx),
+      runMigrations: noMigrations,
+      overrideBetterAuthOptions: getOverrideBetterAuthOptions,
+      prefixTests: "profile:additional-fields",
+      tests: [
+        additionalFieldsNormalTestSuite(),
+        additionalFieldsAuthFlowTestSuite(),
+      ],
+    });
+
+    const { execute: executePluginTableProfile } = await testAdapter({
+      adapter: () => pluginTableProfileClient.adapter(wrappedCtx),
+      runMigrations: noMigrations,
+      overrideBetterAuthOptions: getOverrideBetterAuthOptions,
+      prefixTests: "profile:plugin-table",
+      tests: [pluginTableNormalTestSuite()],
+    });
+
+    const { execute: executeRenameFieldProfile } = await testAdapter({
+      adapter: () => renameFieldProfileClient.adapter(wrappedCtx),
+      runMigrations: noMigrations,
+      overrideBetterAuthOptions: getOverrideBetterAuthOptions,
+      prefixTests: "profile:rename-field-join",
+      tests: [renameFieldAndJoinTestSuite()],
+    });
+
+    const { execute: executeRenameUserCustomProfile } = await testAdapter({
+      adapter: () => renameUserCustomProfileClient.adapter(wrappedCtx),
+      runMigrations: noMigrations,
+      overrideBetterAuthOptions: getOverrideBetterAuthOptions,
+      prefixTests: "profile:rename-user-custom",
+      tests: [renameModelUserCustomTestSuite()],
+    });
+
+    const { execute: executeRenameUserTableProfile } = await testAdapter({
+      adapter: () => renameUserTableProfileClient.adapter(wrappedCtx),
+      runMigrations: noMigrations,
+      overrideBetterAuthOptions: getOverrideBetterAuthOptions,
+      prefixTests: "profile:rename-user-table",
+      tests: [renameModelUserTableTestSuite()],
+    });
+
+    const { execute: executeOrganizationJoinsProfile } = await testAdapter({
+      adapter: () => organizationJoinsProfileClient.adapter(wrappedCtx),
+      runMigrations: noMigrations,
+      overrideBetterAuthOptions: getOverrideBetterAuthOptions,
+      prefixTests: "profile:organization-joins",
+      tests: [multiJoinsMissingRowsTestSuite()],
+    });
+
+    await executeBaseProfile();
+    await executeAdditionalFieldsProfile();
+    await executePluginTableProfile();
+    await executeRenameFieldProfile();
+    await executeRenameUserCustomProfile();
+    await executeRenameUserTableProfile();
+    await executeOrganizationJoinsProfile();
   });
 }

package/src/client/adapter.ts

@@ -93,6 +93,13 @@ const parseWhere = (
     return [];
   }
   const whereArray = Array.isArray(where) ? where : [where];
+  for (const w of whereArray) {
+    if (w.mode === "insensitive") {
+      throw new Error(
+        `Case-insensitive queries (mode: "insensitive") are not supported by the Convex adapter. Store values in a normalized form (e.g. lowercase on write) and query against the normalized value. Field: ${w.field}`
+      );
+    }
+  }
   return whereArray.map((w) => {
     if (w.value instanceof Date) {
       return {
@@ -164,7 +171,6 @@ export const convexAdapter = <
   ctx: Ctx,
   api: {
     adapter: ComponentApi["adapter"];
-    adapterTest?: ComponentApi["adapterTest"];
   },
   config: {
     debugLogs?: DBAdapterDebugLogOption;

package/src/client/create-api.ts

@@ -55,6 +55,9 @@ const whereValidator = (
       v.null()
     ),
     connector: v.optional(v.union(v.literal("AND"), v.literal("OR"))),
+    mode: v.optional(
+      v.union(v.literal("sensitive"), v.literal("insensitive"))
+    ),
   });
 
 export const createApi = <Schema extends SchemaDefinition<any, any>>(

package/src/client/create-client.ts

@@ -17,7 +17,6 @@ import type { Infer } from "convex/values";
 import { convexAdapter } from "./adapter.js";
 import { corsRouter } from "convex-helpers/server/cors";
 import type defaultSchema from "../component/schema.js";
-import type { ComponentApi } from "../component/_generated/component.js";
 import type { CreateAuth, GenericCtx } from "./index.js";
 import type { TrustedOriginsOption } from "../utils/index.js";
 
@@ -70,7 +69,6 @@ type SlimComponentApi = {
     deleteOne: FunctionReference<"mutation", "internal">;
     deleteMany: FunctionReference<"mutation", "internal">;
   };
-  adapterTest?: ComponentApi["adapterTest"];
 };
 
 type RouteCorsOptions =

package/src/client/create-schema.ts

@@ -1,5 +1,18 @@
 import type { BetterAuthDBSchema, DBFieldAttribute } from "better-auth/db";
 
+const resolveCdTarget = (
+  relativeDir: string | null,
+  cwdBasename: string
+): string | null => {
+  if (relativeDir === "") {
+    return null;
+  }
+  if (relativeDir !== null) {
+    return relativeDir;
+  }
+  return cwdBasename;
+};
+
 // Manually add fields to index on for schema generation,
 // all fields in the schema specialFields are automatically indexed
 export const indexFields = {
@@ -66,11 +79,12 @@ export const createSchema = async ({
   tables: BetterAuthDBSchema;
   file?: string;
 }) => {
-  // stop convex esbuild from throwing over this import, only runs
-  // in the better auth cli
-  const pathImport = "path";
-  const path = await import(pathImport);
-  const baseName = path.basename(path.resolve(process.cwd(), file ?? ""));
+  // Hide these node builtins from Convex's esbuild so it doesn't try to
+  // resolve them at bundle time. Only runs from the better-auth CLI.
+  const path = await import(["p", "a", "t", "h"].join(""));
+  const fs = await import(["f", "s"].join(""));
+  const cwd = process.cwd();
+  const baseName = path.basename(path.resolve(cwd, file ?? ""));
   // if the target directory is named "convex", they're almost definitely
   // generating the schema in the wrong directory, likely would replace the
   // app schema
@@ -79,11 +93,35 @@ export const createSchema = async ({
       "Better Auth schema must be generated in the Better Auth component directory."
     );
   }
+
+  const findProjectRoot = (dir: string): string | null => {
+    if (fs.existsSync(path.join(dir, "package.json"))) {
+      return dir;
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) {
+      return null;
+    }
+    return findProjectRoot(parent);
+  };
+
+  const projectRoot = findProjectRoot(cwd);
+  const relativeDir =
+    projectRoot !== null
+      ? path.relative(projectRoot, cwd).split(path.sep).join("/")
+      : null;
+  const generateCommand = `npx auth generate${file ? ` --output ${file}` : ""}`;
+  const cdTarget = resolveCdTarget(relativeDir, path.basename(cwd));
+  const commandBlock = cdTarget
+    ? ` *   cd ${cdTarget}\n *   ${generateCommand}`
+    : ` *   ${generateCommand}`;
+
   let code: string = `/**
  * This file is auto-generated. Do not edit this file manually.
- * To regenerate the schema, run:
- * \`npx @better-auth/cli generate --output ${file} -y\`
- * 
+ * To regenerate the schema, from your project root:
+ *
+${commandBlock}
+ *
  * To customize the schema, generate to an alternate file and import
  * the table definitions to your schema file. See
  * https://labs.convex.dev/better-auth/features/local-install#adding-custom-indexes.

package/src/component/_generated/api.ts

@@ -9,7 +9,6 @@
  */
 
 import type * as adapter from "../adapter.js";
-import type * as adapterTest from "../adapterTest.js";
 import type * as testProfiles_adapterAdditionalFields from "../testProfiles/adapterAdditionalFields.js";
 import type * as testProfiles_adapterOrganizationJoins from "../testProfiles/adapterOrganizationJoins.js";
 import type * as testProfiles_adapterPluginTable from "../testProfiles/adapterPluginTable.js";
@@ -26,7 +25,6 @@ import { anyApi, componentsGeneric } from "convex/server";
 
 const fullApi: ApiFromModules<{
   adapter: typeof adapter;
-  adapterTest: typeof adapterTest;
   "testProfiles/adapterAdditionalFields": typeof testProfiles_adapterAdditionalFields;
   "testProfiles/adapterOrganizationJoins": typeof testProfiles_adapterOrganizationJoins;
   "testProfiles/adapterPluginTable": typeof testProfiles_adapterPluginTable;