Set the correct Typescript type when using plugins

I'm using the admin and organization plugins from

better-auth/plugins

better-auth/plugins

.

I'm explicitly typing by

betterAuth

betterAuth

instance as

ReturnType<typeof betterAuth>;

ReturnType<typeof betterAuth>;

, but when I try to access one of the API provided functions, e.g. betterAuth.api.listUsers, TS warns me it doesn't exist.

What is the correct typing for my

betterAuth

betterAuth

instance?

Ddan—1106 I'm using the admin and organization plugins from `better-auth/plugins`. I'm ex...

Ping•2/19/25, 7:46 PM

When inferring from a returnType of a function, it doesn't work with the generics you passed from your actual Better-Auth instance.

You should't need to explicitly define the auth variable type,

betterAuth

betterAuth

should auto infer and give you the correct returnType.

dan—1106OP•2/19/25, 7:48 PM

thanks @Ping -- I'm assigning the return value to a variable on my request locals, which I think needs to be explicitly typed (so that's it's not just ). Is it possible to construct a type manually?

Ddan—1106 thanks @Ping -- I'm assigning the return value to a variable on my request local...

Ping•2/19/25, 7:52 PM

You're creating a new auth instance for each request?

Ping•2/19/25, 7:53 PM

Is it possible to construct a type manually?

Let me think.

dan—1106OP•2/19/25, 7:53 PM

i have a global that is populated on first request (so hopefully I'm only constructing a new instance occasionally!)

dan—1106OP•2/19/25, 7:53 PM

I think this works?

let betterAuthGlobal: ReturnType<
typeof betterAuth<{
plugins: [ReturnType<typeof admin>, ReturnType<typeof organization>];
}>
>;

dan—1106OP•2/19/25, 7:54 PM

i have a global that is populated on first request (so hopefully I'm only constructing a new instance occasionally!)

I'm doing this because I'm deploying to Cloudflare workers, and I can only grab my database connection in a request/response cycle

Ping•2/19/25, 7:54 PM

If you do this, you will then get access to the type for that auth instance specifically:

here should correctly infer the plugins you defined in the auth instance.

Ddan—1106 I think this works? let betterAuthGlobal: ReturnType< typeof betterAuth<{ ...

Ping•2/19/25, 7:55 PM

Are each request creating unique auth instances?

Ping•2/19/25, 7:55 PM

Like plugins may differ, etc?

dan—1106OP•2/19/25, 7:56 PM

no, static config. Created once on first request to my serverless environment and then stored on a global.

dan—1106OP•2/19/25, 7:56 PM

my approach didn't solve the errors though

Ping•2/19/25, 7:57 PM

And you're not able to define the

betterAuth

betterAuth

instance at the global level because you need access to the request to deal with your DB connection on a per req/res cycle?

dan—1106OP•2/19/25, 7:58 PM

yeah, exactly. So I have a global and I lazy load the auth instance on first request.

dan—1106OP•2/19/25, 7:58 PM

as a hacky workaround i could create a global instance of auth with my plugins which would provide typing!

Ping•2/19/25, 8:01 PM

Give this a shot:

Ping•2/19/25, 8:01 PM

Wait, I'm stupid.

Ping•2/19/25, 8:01 PM

LOL!

Ping•2/19/25, 8:01 PM

Sorry, it's 6am for me, I haven't slept yet.

Ping•2/19/25, 8:02 PM

So this doesn't work??

dan—1106OP•2/19/25, 8:04 PM

not at all! thank for the help.

that lets me assign my betterAuth instance to the variable, but when I try to access betterAuth.api.listUsers I get an error:

dan—1106OP•2/19/25, 8:07 PM

this as a hacky workaround satisfies typescript:

but obviously isn't super elegant

Ping•2/19/25, 8:09 PM

There is another solution, which is overly complicated, and that's to have your auth config in another file/place, then use tsc and generate the of that, and the copy the declarations that is generated as the types.
But that isn't super elegant either.

Ddan—1106 this as a hacky workaround satisfies typescript: ``` const authForTyping = bett...

Ping•2/19/25, 8:10 PM

If you're worried that this is creating yet another auth instance, maybe you can place this in another file, then export the auth as a type.

Then in your main file, import the type only.
Since that file is never actually ran, that auth instance won't execute.

PPing If you're worried that this is creating *yet another* auth instance, maybe you c...

Ping•2/19/25, 8:11 PM

This might just be your best bet.

PPing If you're worried that this is creating *yet another* auth instance, maybe you c...

dan—1106OP•2/19/25, 8:15 PM

Oh that’s a nice suggestion!

dan—1106OP•2/19/25, 8:17 PM

thanks for all the help, appreciate it!

dan—1106OP•2/19/25, 8:17 PM

(should I mark this as solved or leave it?)

Ping•2/19/25, 8:17 PM

Solved :)

b3nab•2/20/25, 4:02 PM

Ehy hello

I have a kinda similar problem as your. But instead my config object I pass to betterAuth({ ...config }) is dynamic because I use a function to generate the betterAuth instance based on parameter of the function.

What could be the possible solutions to set the correct typescript type?

b3nab•2/20/25, 4:05 PM

I have something like this:

But typescript show an error on saying: The inferred type of "generateBetterAuthClient" cannot be named without a reference to ".pnpm/nanostores@0.11.3/node_modules/nanostores". This is likely not portable. A type annotation is necessary.

Ping•2/20/25, 4:09 PM

Can you show me your tsconfig?

b3nab•2/20/25, 4:10 PM

yep sure:

b3nab•2/20/25, 4:11 PM

Basically I'm trying to develop a plugin for Payload CMS and of course it should be like a dynamic wrapper around betterAuth. Also frontend side it will load plugins dynamically based on the plugin configuration.

b3nab•2/20/25, 4:15 PM

At first I was looking to fix the TS error with a type like this:

It has a limit, meaning that I need to know all the plugins that can be added here. But since everyone can develop a custom plugin this may be a limitation of the above type.

b3nab•2/20/25, 5:04 PM

mmhm the problem here seems to be this: https://github.com/microsoft/TypeScript/pull/58176#issuecomment-2052698294

So this means that TS is not able to resolve the type of nanostores because my project doesn't have that dependency but it's only used internally by better-auth.

GitHub

Check nearest package.json dependencies for possible package names ...

Implements this comment.
I won't say this "fixes" #42873, but it does prevent it from occurring for people in workspaces with appropriately set-up explicit dependencies in...

b3nab•2/20/25, 5:31 PM

So update on this: I got rid of the TS error by adding nanostores: "0.11.3" to my package.json and into the file where my generateBetterAuthClient function is present and it worked.

But then where I use betterAuthClient it was back to the original problem, so twoFactor was a missing key in betterAuthClient (so no correct type and auto inference not working).

So I modify the array without explicitly telling the type and I add the types that TS was not able to find, like so:

Hope it will help others.