What is the proper way to handle error for authClient?

sathit0uwan · 2025-12-17T06:10:23.917Z

I can see that the response is `{ data, error }` object, e.g. ``` const { data, error } = await authClient.admin.revokeUserSessions({ userId: user.id }); ``` Is it enough or do I need to wrap with `try.. catch..` block?

L

lonelyplanet•12/17/25, 10:23 AM

@sathit0uwan https://www.better-auth.com/docs/concepts/client#handling-errors

Client | Better Auth

Better Auth client library for authentication.

Llonelyplanet <@853612574264131584> https://www.better-auth.com/docs/concepts/client#handling-...

N

NunoLima•12/17/25, 4:29 PM

Regarding the issue, I didn't see a way to handle the other errors, for example, from the organization plugin. I can only import the BASE ERROR CODE, but not the organization error code.

NNunoLima Regarding the issue, I didn't see a way to handle the other errors, for example,...

L

lonelyplanet•12/17/25, 11:25 PM

https://github.com/better-auth/better-auth/blob/canary/packages/better-auth/src/plugins/organization/error-codes.ts

You should not have to import the error type the error object code property is just a string? If you need a list of error codes you can look at the source code but again its not needed.

const { data, error } = await authClient... // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === "‎INVITATION_NOT_FOUND") {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

const { data, error } = await authClient... // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === "‎INVITATION_NOT_FOUND") {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

const { data, error } = await authClient... // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === "‎INVITATION_NOT_FOUND") {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

const { data, error } = await authClient... // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === "‎INVITATION_NOT_FOUND") {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

GitHub

better-auth/packages/better-auth/src/plugins/organization/error-cod...

The most comprehensive authentication framework for TypeScript - better-auth/better-auth

N

NunoLima•12/17/25, 11:27 PM

Thank you, I need it for translation.

N

NunoLima•12/17/25, 11:27 PM

L

lonelyplanet•12/17/25, 11:37 PM

@NunoLima I have found this

//auth.ts
import { betterAuth } from "better-auth";
import { createAuthClient } from "better-auth/client";
import { organization } from "better-auth/plugins";

const auth = betterAuth({
  plugins: [organization()]
});

export type AuthErrorCodes = {
  [K in keyof typeof auth.$ERROR_CODES]: K;
};
// ^?: { YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS: "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS", ... }

//auth.ts
import { betterAuth } from "better-auth";
import { createAuthClient } from "better-auth/client";
import { organization } from "better-auth/plugins";

const auth = betterAuth({
  plugins: [organization()]
});

export type AuthErrorCodes = {
  [K in keyof typeof auth.$ERROR_CODES]: K;
};
// ^?: { YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS: "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS", ... }

//auth.ts
import { betterAuth } from "better-auth";
import { createAuthClient } from "better-auth/client";
import { organization } from "better-auth/plugins";

const auth = betterAuth({
  plugins: [organization()]
});

export type AuthErrorCodes = {
  [K in keyof typeof auth.$ERROR_CODES]: K;
};
// ^?: { YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS: "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS", ... }

//auth.ts
import { betterAuth } from "better-auth";
import { createAuthClient } from "better-auth/client";
import { organization } from "better-auth/plugins";

const auth = betterAuth({
  plugins: [organization()]
});

export type AuthErrorCodes = {
  [K in keyof typeof auth.$ERROR_CODES]: K;
};
// ^?: { YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS: "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS", ... }

//auth-client.ts
import type { AuthErrorCodes } from "./auth";

const maxOrgError = "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS" satisfies AuthErrorCodes['YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS'];

const authClient = createAuthClient();

const { data, error } = await authClient.signIn.email({ ... }) // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === maxOrgError) {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

//auth-client.ts
import type { AuthErrorCodes } from "./auth";

const maxOrgError = "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS" satisfies AuthErrorCodes['YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS'];

const authClient = createAuthClient();

const { data, error } = await authClient.signIn.email({ ... }) // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === maxOrgError) {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

//auth-client.ts
import type { AuthErrorCodes } from "./auth";

const maxOrgError = "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS" satisfies AuthErrorCodes['YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS'];

const authClient = createAuthClient();

const { data, error } = await authClient.signIn.email({ ... }) // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === maxOrgError) {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

//auth-client.ts
import type { AuthErrorCodes } from "./auth";

const maxOrgError = "YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS" satisfies AuthErrorCodes['YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS'];

const authClient = createAuthClient();

const { data, error } = await authClient.signIn.email({ ... }) // this would be the authclient call you are making ie: authClient.signin.email({...})

if (error) {
  if (error.code === maxOrgError) {
    // additonal custom handling for specific error
  }
  showError(error.message);
}

L

lonelyplanet•12/17/25, 11:37 PM

It can help you stay even more typesafe

N

NunoLima•12/17/25, 11:38 PM

a just get repose

N

NunoLima•12/17/25, 11:38 PM

NNunoLima Click to see attachment

L

lonelyplanet•12/17/25, 11:39 PM

the only thing by importing

organization()

organization()

organization()

organization() is you are potentially leaking server side code into the final bundle of your app

L

lonelyplanet•12/17/25, 11:39 PM

I do not recommend you do that

N

NunoLima•12/17/25, 11:41 PM

This code is in a separate package (monorepo), with a utility function that converts errors.

What is the proper way to handle error for authClient?

Similar Threads

Similar Threads

Similar Threads