Runtime error: `Error: Client created with undefined deployment address. If you used an environment variable, check that it's set.`

[jasongitmail]

I have Convex set up and working, to read from and write to the database, which is to say that I have CONVEX_URL, etc all set up properly.

After installing Better Auth and the related aspects from better-auth-kit, I set up Github OAuth to attempt sign in.

The build is still error free. But when I click my signInGithub() (see further below), I get the runtime error below:

Error

Error importing route file: Error: Client created with undefined deployment address. If you used an environment variable, check that it's set.
    at validateDeploymentUrl (file:///Users/me/proj/node_modules/convex/dist/esm/common/index.js:15:11)
    at new ConvexHttpClient (file:///Users/me/proj/node_modules/convex/dist/esm/browser/http_client.js:52:7)
    at eval (/Users/me/proj/src/lib/auth.ts:6:22)
    at async ESModulesEvaluator.runInlinedModule (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1049:5)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1271:61)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/chunks/dep-B0fRCRkQ.js:30915:23)
    at async SSRCompatModuleRunner.cachedRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1167:76)
    at async eval (/Users/me/proj/src/routes/api/auth/$.ts?pick=APIRoute:3:44)
    at async ESModulesEvaluator.runInlinedModule (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1049:5)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1271:61)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/chunks/dep-B0fRCRkQ.js:30915:23)
    at async SSRCompatModuleRunner.cachedRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1167:76)
    at async defaultAPIFileRouteHandler (/Users/me/proj/node_modules/@tanstack/start-api-routes/dist/esm/index.js:134:14)
    at async eval (/Users/me/proj/node_modules/@tanstack/start-api-routes/dist/esm/index.js:17:17)
    at async _callHandler (file:///Users/me/proj/node_modules/h3/dist/index.mjs:1837:16)
    at async file:///Users/me/proj/node_modules/h3/dist/index.mjs:1978:19
    at async Object.callAsync (file:///Users/me/proj/node_modules/unctx/dist/index.mjs:72:16)
    at async Server.toNodeHandle (file:///Users/me/proj/node_modules/h3/dist/index.mjs:2270:7)

Code

// /src/lib/auth-client.ts

import { createAuthClient } from "better-auth/react";

export const authClient = createAuthClient();

export async function signInGithub() {
  // alert("Github handler");
  await authClient.signIn.social({
    /**
     * The social provider id
     * @example "github", "google", "apple"
     */
    provider: "github",
    /**
     * a url to redirect after the user authenticates with the provider
     * @default "/"
     */
    callbackURL: "/dashboard",
    /**
     * a url to redirect if an error occurs during the sign in process
     */
    errorCallbackURL: "/error",
    /**
     * a url to redirect if the user is newly registered
     */
    newUserCallbackURL: "/welcome",
    /**
     * disable the automatic redirect to the provider.
     * @default false
     */
    disableRedirect: false,
  });
}

// src/lib/auth.ts

import { betterAuth } from "better-auth";
import { convexAdapter } from "@better-auth-kit/convex";
import { ConvexHttpClient } from "convex/browser";

const convexClient = new ConvexHttpClient(import.meta.env.CONVEX_URL);

export const auth = betterAuth({
  database: convexAdapter(convexClient),
  plugins: [],
  socialProviders: {
    github: {
      clientId: import.meta.env.GITHUB_CLIENT_ID,
      clientSecret: import.meta.env.GITHUB_CLIENT_SECRET,
    },
  },
});

Versions

"@better-auth-kit/convex": "^1.1.4",
"better-auth": "^1.2.5",
"convex": "^1.21.0",
"@convex-dev/react-query": "^0.0.0-alpha.8",
"@tanstack/react-query": "^5.69.0",
"@tanstack/react-router": "^1.114.27",
"@tanstack/react-router-with-query": "^1.114.27",
"@tanstack/react-start": "^1.114.27",

[ping-maxwell]

Hey, can you enable debug logs just to see if this can maybe give us more info right before the error occured?

All this does is shows each adapter call, so if you clicking the github oauth button was to add a new row into DB for example, we'd know from the debug logs.

[jasongitmail]

Ok. I enabled debug logs, restarted both the convex dev server and TanStart Start dev server. Similar error output appears (see below).

Notable:

• I still do not see any better auth related tables in the Convex dashboard, for some reason. My expectation was that they'd be automatically created when restarting the Convex dev server, so I find this curious.
• I do see the better auth-related Convex functions in the Convex dashboard:

• In my TanStack Start app.config.ts I am using the envPrefix of "PUBLIC_", which is working fine for my other env variables. But I'm mentioning in case your code might be hard coding "VITE_" related env vars:

Error importing route file: Error: Client created with undefined deployment address. If you used an environment variable, check that it's set.
    at validateDeploymentUrl (file:///Users/me/proj/node_modules/convex/dist/esm/common/index.js:15:11)
    at new ConvexHttpClient (file:///Users/me/proj/node_modules/convex/dist/esm/browser/http_client.js:52:7)
    at eval (/Users/me/proj/src/lib/auth.ts:6:22)
    at async ESModulesEvaluator.runInlinedModule (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1049:5)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1271:61)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/chunks/dep-B0fRCRkQ.js:30915:23)
    at async SSRCompatModuleRunner.cachedRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1167:76)
    at async eval (/Users/me/proj/src/routes/api/auth/$.ts?pick=APIRoute:3:44)
    at async ESModulesEvaluator.runInlinedModule (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1049:5)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1271:61)
    at async SSRCompatModuleRunner.directRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/chunks/dep-B0fRCRkQ.js:30915:23)
    at async SSRCompatModuleRunner.cachedRequest (file:///Users/me/proj/node_modules/vinxi/node_modules/vite/dist/node/module-runner.js:1167:76)
    at async defaultAPIFileRouteHandler (/Users/me/proj/node_modules/@tanstack/start-api-routes/dist/esm/index.js:134:14)
    at async eval (/Users/me/proj/node_modules/@tanstack/start-api-routes/dist/esm/index.js:17:17)
    at async _callHandler (file:///Users/me/proj/node_modules/h3/dist/index.mjs:1837:16)
    at async file:///Users/me/proj/node_modules/h3/dist/index.mjs:1978:19
    at async Object.callAsync (file:///Users/me/proj/node_modules/unctx/dist/index.mjs:72:16)
    at async Server.toNodeHandle (file:///Users/me/proj/node_modules/h3/dist/index.mjs:2270:7)

My full /src/lib/auth.ts

import { betterAuth } from "better-auth";
import { convexAdapter } from "@better-auth-kit/convex";
import { ConvexHttpClient } from "convex/browser";

const convexClient = new ConvexHttpClient(import.meta.env.CONVEX_URL);

export const auth = betterAuth({
  database: convexAdapter(convexClient, { enable_debug_logs: true }),
  session: {
    cookieCache: {
      enabled: true,
      maxAge: 5 * 60, // Cache duration in seconds
    },
  },
  plugins: [],
  socialProviders: {
    github: {
      clientId: import.meta.env.GITHUB_CLIENT_ID,
      clientSecret: import.meta.env.GITHUB_CLIENT_SECRET,
    },
  },
});

[ping-maxwell]

Regarding the tables not in your dashboard:
Since there isn't a defined schema yet, Convex DB doesn't know which tables will exist.
If you're able to sign-in or up via email using Better-Auth, then the tables will be created.

In saying this, do you think you can help me test if better auth signup via email works?

[ping-maxwell]

Also if you haven't already, I recommend upgrading to the latest version of this convex adapter.

It does however come with breaking change. All you need to change is your betterAuth.ts file:
https://www.better-auth-kit.com/docs/adapters/convex#create-the-convex-handler

[jasongitmail]

Progress!

• I updated to 1.2.2 and updated betterAuth.ts as shown.
• I also needed to update my /src/lib/auth.ts to make the Github Client ID a public env var:

import { betterAuth } from "better-auth";
import { convexAdapter } from "@better-auth-kit/convex";
import { ConvexHttpClient } from "convex/browser";

const convexClient = new ConvexHttpClient(import.meta.env.PUBLIC_CONVEX_URL);

export const auth = betterAuth({
  database: convexAdapter(convexClient, { enable_debug_logs: true }),
  session: {
    cookieCache: {
      enabled: true,
      maxAge: 5 * 60, 
    },
  },
  plugins: [],
  socialProviders: {
    github: {
      clientId: import.meta.env.PUBLIC_GITHUB_CLIENT_ID,
      clientSecret: import.meta.env.GITHUB_CLIENT_SECRET,
    },
  },
});

It needing to be a public var is surprising to me b/c src/lib/auth.ts is a server file, but if it does not have the PUBLIC_ (a.k.a. VITE_ for other readers of this issue) prefix, then the Github OAuth URL has undefined value for the client ID, like this: https://github.com/login/oauth/authorize?response_type=code&client_id=undefined&state=tLBcF5up...

• The redirect to Github works and Convex has a new table "verification" table. If I check the Convex database--after clicking "login with Github" but prior to authorizing OAuth as a user on the Github website--I can see a document created in this table.
• After I click authorize, I get redirected back to my site and encounter an error: http://localhost:3000/error?error=unable_to_get_user_info. Note that on Convex's dashboard, my DB has no users table or any auth tables other than "verification".

-here are the debug logs:

[convex-adapter] create {
  model: 'verification',
  values: {
    createdAt: 2025-03-29T15:32:27.812Z,
    updatedAt: 2025-03-29T15:32:27.812Z,
    value: '{"callbackURL":"/dashboard","codeVerifier":"T_uz-2umceYHYZLD2LH2d6LX0mE2DBc9yUwMr9iGsFpdU_QuvQqjWyWntgiRkNwGRiSldkynD4ctGLmCLXej51c_vVOF_kxEtmawW2_x8YbIfuHR_h-_CpydOy-49GfJ","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743262947812}',
    identifier: 'QunEJsfBwjAnLhA_UyPf8eqJUyIgVaw_',
    expiresAt: 2025-03-29T15:42:27.812Z
  },
  select: undefined
}
[convex-adapter] create result {
  result: {
    expiresAt: 2025-03-29T15:42:27.812Z,
    identifier: 'QunEJsfBwjAnLhA_UyPf8eqJUyIgVaw_',
    updatedAt: 2025-03-29T15:32:27.812Z,
    value: '{"callbackURL":"/dashboard","codeVerifier":"T_uz-2umceYHYZLD2LH2d6LX0mE2DBc9yUwMr9iGsFpdU_QuvQqjWyWntgiRkNwGRiSldkynD4ctGLmCLXej51c_vVOF_kxEtmawW2_x8YbIfuHR_h-_CpydOy-49GfJ","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743262947812}',
    id: 'jh78p4h3z9xw5bxh7ddw6rbbhx7d02xa'
  },
  duration: '419ms'
}
[convex-adapter] findMany {
  model: 'verification',
  where: [
    { field: 'identifier', value: 'QunEJsfBwjAnLhA_UyPf8eqJUyIgVaw_' }
  ],
  limit: 1,
  offset: undefined,
  sortBy: { field: 'createdAt', direction: 'desc' }
}
[convex-adapter] findMany queryString {
  queryString: 'q.eq(q.field("identifier"), "QunEJsfBwjAnLhA_UyPf8eqJUyIgVaw_")'
}
[convex-adapter] findMany result {
  result: [
    {
      expiresAt: 2025-03-29T15:42:27.812Z,
      identifier: 'QunEJsfBwjAnLhA_UyPf8eqJUyIgVaw_',
      updatedAt: 2025-03-29T15:32:27.812Z,
      value: '{"callbackURL":"/dashboard","codeVerifier":"T_uz-2umceYHYZLD2LH2d6LX0mE2DBc9yUwMr9iGsFpdU_QuvQqjWyWntgiRkNwGRiSldkynD4ctGLmCLXej51c_vVOF_kxEtmawW2_x8YbIfuHR_h-_CpydOy-49GfJ","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743262947812}',
      createdAt: 2025-03-29T15:32:28.097Z,
      id: 'jh78p4h3z9xw5bxh7ddw6rbbhx7d02xa'
    }
  ],
  duration: '147ms'
}
[convex-adapter] deleteMany {
  model: 'verification',
  where: [
    {
      field: 'expiresAt',
      value: 2025-03-29T15:32:28.898Z,
      operator: 'lt'
    }
  ]
}
[convex-adapter] deleteMany result { result: null, duration: '300ms' }
[convex-adapter] delete {
  model: 'verification',
  where: [ { field: 'id', value: 'jh78p4h3z9xw5bxh7ddw6rbbhx7d02xa' } ]
}
[convex-adapter] delete complete { duration: '148ms' }
2025-03-29T15:32:30.017Z ERROR [Better Auth]: Unable to get user info
[convex-adapter] create {
  model: 'verification',
  values: {
    createdAt: 2025-03-29T15:33:11.623Z,
    updatedAt: 2025-03-29T15:33:11.623Z,
    value: '{"callbackURL":"/dashboard","codeVerifier":"6jaY5ZAe2V3QrGswAUpv-Qs_dwF8pN1i9ROsTYYl2vbL4jmsvLh5OjvY6Jti_qedDwCVJ8v61YR8WM1gWSioXx1Ocb7TITT9DQmmv5JmxYEXuow013LZ_GnVqzf_12hD","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743262991623}',
    identifier: '_awESwWTWn1P_l9vXzhzuydOv2McpEMT',
    expiresAt: 2025-03-29T15:43:11.623Z
  },
  select: undefined
}
[convex-adapter] create result {
  result: {
    expiresAt: 2025-03-29T15:43:11.623Z,
    identifier: '_awESwWTWn1P_l9vXzhzuydOv2McpEMT',
    updatedAt: 2025-03-29T15:33:11.623Z,
    value: '{"callbackURL":"/dashboard","codeVerifier":"6jaY5ZAe2V3QrGswAUpv-Qs_dwF8pN1i9ROsTYYl2vbL4jmsvLh5OjvY6Jti_qedDwCVJ8v61YR8WM1gWSioXx1Ocb7TITT9DQmmv5JmxYEXuow013LZ_GnVqzf_12hD","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743262991623}',
    id: 'jh7azq6pk4sswt8h49ew88nvcd7d1j12'
  },
  duration: '883ms'
}
[convex-adapter] findMany {
  model: 'verification',
  where: [
    { field: 'identifier', value: '_awESwWTWn1P_l9vXzhzuydOv2McpEMT' }
  ],
  limit: 1,
  offset: undefined,
  sortBy: { field: 'createdAt', direction: 'desc' }
}
[convex-adapter] findMany queryString {
  queryString: 'q.eq(q.field("identifier"), "_awESwWTWn1P_l9vXzhzuydOv2McpEMT")'
}
[convex-adapter] findMany result {
  result: [
    {
      expiresAt: 2025-03-29T15:43:11.623Z,
      identifier: '_awESwWTWn1P_l9vXzhzuydOv2McpEMT',
      updatedAt: 2025-03-29T15:33:11.623Z,
      value: '{"callbackURL":"/dashboard","codeVerifier":"6jaY5ZAe2V3QrGswAUpv-Qs_dwF8pN1i9ROsTYYl2vbL4jmsvLh5OjvY6Jti_qedDwCVJ8v61YR8WM1gWSioXx1Ocb7TITT9DQmmv5JmxYEXuow013LZ_GnVqzf_12hD","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743262991623}',
      createdAt: 2025-03-29T15:33:12.409Z,
      id: 'jh7azq6pk4sswt8h49ew88nvcd7d1j12'
    }
  ],
  duration: '278ms'
}
[convex-adapter] deleteMany {
  model: 'verification',
  where: [
    {
      field: 'expiresAt',
      value: 2025-03-29T15:33:17.394Z,
      operator: 'lt'
    }
  ]
}
[convex-adapter] deleteMany result { result: null, duration: '304ms' }
[convex-adapter] delete {
  model: 'verification',
  where: [ { field: 'id', value: 'jh7azq6pk4sswt8h49ew88nvcd7d1j12' } ]
}
[convex-adapter] delete complete { duration: '146ms' }
2025-03-29T15:33:18.494Z ERROR [Better Auth]: Unable to get user info
[convex-adapter] create {
  model: 'verification',
  values: {
    createdAt: 2025-03-29T15:34:31.528Z,
    updatedAt: 2025-03-29T15:34:31.528Z,
    value: '{"callbackURL":"/dashboard","codeVerifier":"R3rC5wTXTs4lbHtVneehqOHwoa4YETQsThRncYHPnYpd-L8GKkEZXzxY2iGOzHIYsBg8ZGxeB2enWyUv0yj2xRevMdO7ryrk6UgX7GwqtpjWUiA8DOGqi0YgSm6w2OYI","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743263071528}',
    identifier: '2UIKqfdhglzZ9fBQyyLi1J9LxvPsFiBU',
    expiresAt: 2025-03-29T15:44:31.528Z
  },
  select: undefined
}
[convex-adapter] create result {
  result: {
    expiresAt: 2025-03-29T15:44:31.528Z,
    identifier: '2UIKqfdhglzZ9fBQyyLi1J9LxvPsFiBU',
    updatedAt: 2025-03-29T15:34:31.528Z,
    value: '{"callbackURL":"/dashboard","codeVerifier":"R3rC5wTXTs4lbHtVneehqOHwoa4YETQsThRncYHPnYpd-L8GKkEZXzxY2iGOzHIYsBg8ZGxeB2enWyUv0yj2xRevMdO7ryrk6UgX7GwqtpjWUiA8DOGqi0YgSm6w2OYI","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743263071528}',
    id: 'jh7509zrk73k2xsxtvpnhsxw4n7d15zq'
  },
  duration: '540ms'
}
[convex-adapter] findMany {
  model: 'verification',
  where: [
    { field: 'identifier', value: '2UIKqfdhglzZ9fBQyyLi1J9LxvPsFiBU' }
  ],
  limit: 1,
  offset: undefined,
  sortBy: { field: 'createdAt', direction: 'desc' }
}
[convex-adapter] findMany queryString {
  queryString: 'q.eq(q.field("identifier"), "2UIKqfdhglzZ9fBQyyLi1J9LxvPsFiBU")'
}
[convex-adapter] findMany result {
  result: [
    {
      expiresAt: 2025-03-29T15:44:31.528Z,
      identifier: '2UIKqfdhglzZ9fBQyyLi1J9LxvPsFiBU',
      updatedAt: 2025-03-29T15:34:31.528Z,
      value: '{"callbackURL":"/dashboard","codeVerifier":"R3rC5wTXTs4lbHtVneehqOHwoa4YETQsThRncYHPnYpd-L8GKkEZXzxY2iGOzHIYsBg8ZGxeB2enWyUv0yj2xRevMdO7ryrk6UgX7GwqtpjWUiA8DOGqi0YgSm6w2OYI","errorURL":"/error","newUserURL":"/welcome","expiresAt":1743263071528}',
      createdAt: 2025-03-29T15:34:31.978Z,
      id: 'jh7509zrk73k2xsxtvpnhsxw4n7d15zq'
    }
  ],
  duration: '342ms'
}
[convex-adapter] deleteMany {
  model: 'verification',
  where: [
    {
      field: 'expiresAt',
      value: 2025-03-29T15:35:30.949Z,
      operator: 'lt'
    }
  ]
}
[convex-adapter] deleteMany result { result: null, duration: '307ms' }
[convex-adapter] delete {
  model: 'verification',
  where: [ { field: 'id', value: 'jh7509zrk73k2xsxtvpnhsxw4n7d15zq' } ]
}
[convex-adapter] delete complete { duration: '381ms' }
2025-03-29T15:35:32.591Z ERROR [Better Auth]: Unable to get user info

[jasongitmail]

I can help test email sign up too, but won't have time to set that up today

[ping-maxwell]

I'm glad to see big progress being made! Always good to hear.

Reading through the logs and not spotting any transactions towards the user table was interesting...

It would be great if you can test email sign up, I know that should work since I've tested that myself with Convex.
So hopefully that can rule out unexpected stuff.

[jasongitmail]

I setup Email OTP plugin. This works fully (as far as I can tell) and creates session and user tables. I have a session created after a successful login.

If I keep these tables in Convex, but clear all their data, and then try to use Githb OAuth sign in again, the same set of debug error messages that I provided earlier still occurs. It fails to create the user in the database, even when the user table already exists. It errors with ERROR [Better Auth]: Unable to get user info b/c it does not create the user prior to trying to fetch the user.