@better-auth/i18n 1.7.0-beta.0 → 1.7.0-beta.10

package/README.md

@@ -1,6 +1,6 @@
 # Better Auth i18n Plugin
 
-Internationalization plugin for [Better Auth](https://www.better-auth.com) — translate error messages and UI strings.
+Internationalization plugin for [Better Auth](https://www.better-auth.com) — translate error messages based on the detected locale.
 
 ## Installation
 
@@ -8,6 +8,109 @@ Internationalization plugin for [Better Auth](https://www.better-auth.com) — t
 npm install @better-auth/i18n
 ```
 
+## Built-in translations
+
+The package ships with ready-to-use translations for 22 languages:
+
+| Code | Language  |
+|------|-----------|
+| `ar` | Arabic |
+| `bn` | Bengali |
+| `de` | German |
+| `en` | English |
+| `es` | Spanish |
+| `fa` | Persian (Farsi) |
+| `fr` | French |
+| `hi` | Hindi |
+| `id` | Indonesian |
+| `it` | Italian |
+| `ja` | Japanese |
+| `ko` | Korean |
+| `nl` | Dutch |
+| `pl` | Polish |
+| `pt` | Portuguese |
+| `ru` | Russian |
+| `sv` | Swedish |
+| `th` | Thai |
+| `tr` | Turkish |
+| `uk` | Ukrainian |
+| `vi` | Vietnamese |
+| `zh` | Chinese (Simplified) |
+
+### Use all built-in locales
+
+```ts
+import { betterAuth } from "better-auth";
+import { i18n, locales } from "@better-auth/i18n";
+
+export const auth = betterAuth({
+  plugins: [
+    i18n({ translations: locales }),
+  ],
+});
+```
+
+### Use a subset of locales
+
+```ts
+import { i18n, locales } from "@better-auth/i18n";
+
+export const auth = betterAuth({
+  plugins: [
+    i18n({
+      translations: {
+        en: locales.en,
+        fr: locales.fr,
+      },
+    }),
+  ],
+});
+```
+
+### Override specific messages
+
+```ts
+import { i18n, locales } from "@better-auth/i18n";
+
+export const auth = betterAuth({
+  plugins: [
+    i18n({
+      translations: {
+        ...locales,
+        fr: {
+          ...locales.fr,
+          USER_NOT_FOUND: "Membre introuvable",
+        },
+      },
+    }),
+  ],
+});
+```
+
+### Add a custom locale
+
+```ts
+import { i18n, locales } from "@better-auth/i18n";
+import type { TranslationDictionary } from "@better-auth/i18n";
+
+const myLocale: TranslationDictionary = {
+  USER_NOT_FOUND: "...",
+  INVALID_EMAIL_OR_PASSWORD: "...",
+  // ... other error codes
+};
+
+export const auth = betterAuth({
+  plugins: [
+    i18n({
+      translations: {
+        ...locales,
+        xx: myLocale,
+      },
+    }),
+  ],
+});
+```
+
 ## Documentation
 
 For full documentation, visit [better-auth.com/docs/plugins/i18n](https://www.better-auth.com/docs/plugins/i18n).

package/dist/chunk-CfYAbeIz.mjs

@@ -0,0 +1,13 @@
+//#region \0rolldown/runtime.js
+var __defProp = Object.defineProperty;
+var __exportAll = (all, no_symbols) => {
+	let target = {};
+	for (var name in all) __defProp(target, name, {
+		get: all[name],
+		enumerable: true
+	});
+	if (!no_symbols) __defProp(target, Symbol.toStringTag, { value: "Module" });
+	return target;
+};
+//#endregion
+export { __exportAll as t };

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { t as i18n } from "./index-Dfuc66o9.mjs";
+import { t as i18n } from "./index-CMj6OYMa.mjs";
 
 //#region src/client.d.ts
 /**

package/dist/client.mjs

@@ -1,4 +1,4 @@
-import { t as PACKAGE_VERSION } from "./version-CzfTSPRz.mjs";
+import { t as PACKAGE_VERSION } from "./version-HDMRsu7o.mjs";
 //#region src/client.ts
 /**
 * i18n client plugin for Better Auth

package/dist/{index-Dfuc66o9.d.mts → index-CMj6OYMa.d.mts}

@@ -1,6 +1,7 @@
-import { BetterAuthPluginRegistry, BetterAuthPluginRegistryIdentifier, GenericEndpointContext, UnionToIntersection } from "@better-auth/core";
+import { E as TranslationDictionary, T as LocaleDetectionStrategy, w as I18nOptions } from "./index-CYmtmQve.mjs";
+import { GenericEndpointContext } from "@better-auth/core";
 
-//#region ../../node_modules/.pnpm/better-call@1.3.5_zod@4.3.6/node_modules/better-call/dist/standard-schema.d.mts
+//#region ../../node_modules/.pnpm/better-call@1.3.7_zod@4.3.6/node_modules/better-call/dist/standard-schema.d.mts
 //#region src/standard-schema.d.ts
 /** The Standard Schema interface. */
 interface StandardSchemaV1<Input = unknown, Output = Input> {
@@ -58,7 +59,7 @@ declare namespace StandardSchemaV1 {
   type InferOutput<Schema extends StandardSchemaV1> = NonNullable<Schema["~standard"]["types"]>["output"];
 } //#endregion
 //#endregion
-//#region ../../node_modules/.pnpm/better-call@1.3.5_zod@4.3.6/node_modules/better-call/dist/error.d.mts
+//#region ../../node_modules/.pnpm/better-call@1.3.7_zod@4.3.6/node_modules/better-call/dist/error.d.mts
 declare const statusCodes: {
   OK: number;
   CREATED: number;
@@ -136,7 +137,7 @@ declare const APIError: new (status?: Status | "OK" | "CREATED" | "ACCEPTED" | "
   errorStack: string | undefined;
 }; //#endregion
 //#endregion
-//#region ../../node_modules/.pnpm/better-call@1.3.5_zod@4.3.6/node_modules/better-call/dist/openapi.d.mts
+//#region ../../node_modules/.pnpm/better-call@1.3.7_zod@4.3.6/node_modules/better-call/dist/openapi.d.mts
 //#region src/openapi.d.ts
 type OpenAPISchemaType = "string" | "number" | "integer" | "boolean" | "array" | "object";
 interface OpenAPIParameter {
@@ -158,7 +159,7 @@ interface OpenAPIParameter {
   };
 }
 //#endregion
-//#region ../../node_modules/.pnpm/better-call@1.3.5_zod@4.3.6/node_modules/better-call/dist/endpoint.d.mts
+//#region ../../node_modules/.pnpm/better-call@1.3.7_zod@4.3.6/node_modules/better-call/dist/endpoint.d.mts
 //#region src/endpoint.d.ts
 interface EndpointBaseOptions {
   /**
@@ -375,7 +376,7 @@ type EndpointBodyMethodOptions = {
 };
 type EndpointOptions = EndpointBaseOptions & EndpointBodyMethodOptions;
 //#endregion
-//#region ../../node_modules/.pnpm/better-call@1.3.5_zod@4.3.6/node_modules/better-call/dist/middleware.d.mts
+//#region ../../node_modules/.pnpm/better-call@1.3.7_zod@4.3.6/node_modules/better-call/dist/middleware.d.mts
 //#region src/middleware.d.ts
 interface MiddlewareOptions extends Omit<EndpointOptions, "method"> {}
 type MiddlewareInputContext<Options extends MiddlewareOptions> = InferBodyInput<Options> & InferQueryInput<Options> & InferRequestInput<Options> & InferHeadersInput<Options> & {
@@ -387,7 +388,7 @@ type Middleware<Options extends MiddlewareOptions = MiddlewareOptions, Handler e
   options: Options;
 }; //#endregion
 //#endregion
-//#region ../../node_modules/.pnpm/better-call@1.3.5_zod@4.3.6/node_modules/better-call/dist/context.d.mts
+//#region ../../node_modules/.pnpm/better-call@1.3.7_zod@4.3.6/node_modules/better-call/dist/context.d.mts
 type InferBodyInput<Options extends EndpointOptions | MiddlewareOptions, Body = (Options["metadata"] extends {
   $Infer: {
     body: infer B;
@@ -417,64 +418,6 @@ type InferHeadersInput<Option extends EndpointOptions | MiddlewareOptions> = Opt
   headers?: HeadersInit;
 };
 //#endregion
-//#region src/types.d.ts
-type ALL_PLUGIN_ERROR_CODE_KEYS = keyof UnionToIntersection<{ [Key in Exclude<BetterAuthPluginRegistryIdentifier, "i18n">]: BetterAuthPluginRegistry<unknown, unknown>[Key] extends {
-  creator: infer C;
-} ? C extends ((...args: any[]) => infer P) ? P extends {
-  $ERROR_CODES: infer E;
-} ? E : {} : {} : {} }[Exclude<BetterAuthPluginRegistryIdentifier, "i18n">]>;
-type InternalTranslationDictionary = Partial<{ [Key in ALL_PLUGIN_ERROR_CODE_KEYS]: string }>;
-/**
- * Translation dictionary mapping error codes to translated messages
- */
-type TranslationDictionary = InternalTranslationDictionary & Record<string, string>;
-/**
- * Locale detection strategy
- */
-type LocaleDetectionStrategy = "header" | "cookie" | "session" | "callback";
-/**
- * Options for the i18n plugin
- */
-interface I18nOptions<Locales extends string[]> {
-  /**
-   * Translation dictionaries keyed by locale code
-   * @example
-   * {
-   *   en: { USER_NOT_FOUND: "User not found" },
-   *   fr: { USER_NOT_FOUND: "Utilisateur non trouvé" }
-   * }
-   */
-  translations: { [Locale in Locales[number]]: TranslationDictionary };
-  /**
-   * Default/fallback locale when detection fails
-   * @default "en"
-   */
-  defaultLocale?: Locales[number] | undefined;
-  /**
-   * Locale detection strategies in priority order
-   * @default ["header"]
-   */
-  detection?: LocaleDetectionStrategy[] | undefined;
-  /**
-   * Cookie name for locale detection (when "cookie" strategy is used)
-   * @default "locale"
-   */
-  localeCookie?: string | undefined;
-  /**
-   * User field name for stored locale preference (when "session" strategy is used)
-   * @default "locale"
-   */
-  userLocaleField?: string | undefined;
-  /**
-   * Custom locale detection function (when "callback" strategy is used).
-   * @example
-   * getLocale: (ctx) => {
-   *   return ctx.headers?.get("X-Custom-Locale") ?? null;
-   * }
-   */
-  getLocale?: undefined | ((ctx: GenericEndpointContext) => Promise<Locales[number] | null> | Locales[number] | null);
-}
-//#endregion
 //#region src/index.d.ts
 declare module "@better-auth/core" {
   interface BetterAuthPluginRegistry<AuthOptions, Options> {
@@ -525,4 +468,4 @@ declare const i18n: <Locales extends string[]>(options: I18nOptions<Locales>) =>
   };
 };
 //#endregion
-export { TranslationDictionary as i, I18nOptions as n, LocaleDetectionStrategy as r, i18n as t };
+export { i18n as t };

package/dist/index-CYmtmQve.d.mts

@@ -0,0 +1,196 @@
+import { BetterAuthPluginRegistry, BetterAuthPluginRegistryIdentifier, GenericEndpointContext, UnionToIntersection } from "@better-auth/core";
+
+//#region src/types.d.ts
+type ALL_PLUGIN_ERROR_CODE_KEYS = keyof UnionToIntersection<{ [Key in Exclude<BetterAuthPluginRegistryIdentifier, "i18n">]: BetterAuthPluginRegistry<unknown, unknown>[Key] extends {
+  creator: infer C;
+} ? C extends ((...args: any[]) => infer P) ? P extends {
+  $ERROR_CODES: infer E;
+} ? E : {} : {} : {} }[Exclude<BetterAuthPluginRegistryIdentifier, "i18n">]>;
+type InternalTranslationDictionary = Partial<{ [Key in ALL_PLUGIN_ERROR_CODE_KEYS]: string }>;
+/**
+ * Translation dictionary mapping error codes to translated messages
+ */
+type TranslationDictionary = InternalTranslationDictionary & Record<string, string>;
+/**
+ * Locale detection strategy
+ */
+type LocaleDetectionStrategy = "header" | "cookie" | "session" | "callback";
+/**
+ * Options for the i18n plugin
+ */
+interface I18nOptions<Locales extends string[]> {
+  /**
+   * Translation dictionaries keyed by locale code
+   * @example
+   * {
+   *   en: { USER_NOT_FOUND: "User not found" },
+   *   fr: { USER_NOT_FOUND: "Utilisateur non trouvé" }
+   * }
+   */
+  translations: { [Locale in Locales[number]]: TranslationDictionary };
+  /**
+   * Default/fallback locale when detection fails
+   * @default "en"
+   */
+  defaultLocale?: Locales[number] | undefined;
+  /**
+   * Locale detection strategies in priority order
+   * @default ["header"]
+   */
+  detection?: LocaleDetectionStrategy[] | undefined;
+  /**
+   * Cookie name for locale detection (when "cookie" strategy is used)
+   * @default "locale"
+   */
+  localeCookie?: string | undefined;
+  /**
+   * User field name for stored locale preference (when "session" strategy is used)
+   * @default "locale"
+   */
+  userLocaleField?: string | undefined;
+  /**
+   * Custom locale detection function (when "callback" strategy is used).
+   * @example
+   * getLocale: (ctx) => {
+   *   return ctx.headers?.get("X-Custom-Locale") ?? null;
+   * }
+   */
+  getLocale?: undefined | ((ctx: GenericEndpointContext) => Promise<Locales[number] | null> | Locales[number] | null);
+}
+//#endregion
+//#region src/locales/ar.d.ts
+/**
+ * Arabic translations
+ */
+declare const ar: TranslationDictionary;
+//#endregion
+//#region src/locales/bn.d.ts
+/**
+ * Bengali translations
+ */
+declare const bn: TranslationDictionary;
+//#endregion
+//#region src/locales/de.d.ts
+/**
+ * German translations
+ */
+declare const de: TranslationDictionary;
+//#endregion
+//#region src/locales/en.d.ts
+/**
+ * English translations (default)
+ */
+declare const en: TranslationDictionary;
+//#endregion
+//#region src/locales/es.d.ts
+/**
+ * Spanish translations
+ */
+declare const es: TranslationDictionary;
+//#endregion
+//#region src/locales/fa.d.ts
+/**
+ * Persian (Farsi) translations
+ */
+declare const fa: TranslationDictionary;
+//#endregion
+//#region src/locales/fr.d.ts
+/**
+ * French translations
+ */
+declare const fr: TranslationDictionary;
+//#endregion
+//#region src/locales/hi.d.ts
+/**
+ * Hindi translations
+ */
+declare const hi: TranslationDictionary;
+//#endregion
+//#region src/locales/id.d.ts
+/**
+ * Indonesian translations
+ */
+declare const id: TranslationDictionary;
+//#endregion
+//#region src/locales/it.d.ts
+/**
+ * Italian translations
+ */
+declare const it: TranslationDictionary;
+//#endregion
+//#region src/locales/ja.d.ts
+/**
+ * Japanese translations
+ */
+declare const ja: TranslationDictionary;
+//#endregion
+//#region src/locales/ko.d.ts
+/**
+ * Korean translations
+ */
+declare const ko: TranslationDictionary;
+//#endregion
+//#region src/locales/nl.d.ts
+/**
+ * Dutch translations
+ */
+declare const nl: TranslationDictionary;
+//#endregion
+//#region src/locales/pl.d.ts
+/**
+ * Polish translations
+ */
+declare const pl: TranslationDictionary;
+//#endregion
+//#region src/locales/pt.d.ts
+/**
+ * Portuguese translations
+ */
+declare const pt: TranslationDictionary;
+//#endregion
+//#region src/locales/ru.d.ts
+/**
+ * Russian translations
+ */
+declare const ru: TranslationDictionary;
+//#endregion
+//#region src/locales/sv.d.ts
+/**
+ * Swedish translations
+ */
+declare const sv: TranslationDictionary;
+//#endregion
+//#region src/locales/th.d.ts
+/**
+ * Thai translations
+ */
+declare const th: TranslationDictionary;
+//#endregion
+//#region src/locales/tr.d.ts
+/**
+ * Turkish translations
+ */
+declare const tr: TranslationDictionary;
+//#endregion
+//#region src/locales/uk.d.ts
+/**
+ * Ukrainian translations
+ */
+declare const uk: TranslationDictionary;
+//#endregion
+//#region src/locales/vi.d.ts
+/**
+ * Vietnamese translations
+ */
+declare const vi: TranslationDictionary;
+//#endregion
+//#region src/locales/zh.d.ts
+/**
+ * Simplified Chinese translations
+ */
+declare const zh: TranslationDictionary;
+declare namespace index_d_exports {
+  export { ar, bn, de, en, es, fa, fr, hi, id, it, ja, ko, nl, pl, pt, ru, sv, th, tr, uk, vi, zh };
+}
+//#endregion
+export { ar as C, TranslationDictionary as E, bn as S, LocaleDetectionStrategy as T, fr as _, tr as a, en as b, ru as c, nl as d, ko as f, hi as g, id as h, uk as i, pt as l, it as m, zh as n, th as o, ja as p, vi as r, sv as s, index_d_exports as t, pl as u, fa as v, I18nOptions as w, de as x, es as y };

package/dist/index.d.mts

@@ -1,2 +1,3 @@
-import { i as TranslationDictionary, n as I18nOptions, r as LocaleDetectionStrategy, t as i18n } from "./index-Dfuc66o9.mjs";
-export { I18nOptions, LocaleDetectionStrategy, TranslationDictionary, i18n };
+import { t as i18n } from "./index-CMj6OYMa.mjs";
+import { E as TranslationDictionary, T as LocaleDetectionStrategy, t as index_d_exports, w as I18nOptions } from "./index-CYmtmQve.mjs";
+export { I18nOptions, LocaleDetectionStrategy, TranslationDictionary, i18n, index_d_exports as locales };

package/dist/index.mjs

@@ -1,4 +1,5 @@
-import { t as PACKAGE_VERSION } from "./version-CzfTSPRz.mjs";
+import { t as PACKAGE_VERSION } from "./version-HDMRsu7o.mjs";
+import { t as locales_exports } from "./locales-CSRpG5Mc.mjs";
 import { APIError, createAuthMiddleware, isAPIError } from "better-auth/api";
 import { parseCookies } from "better-auth/cookies";
 //#region src/index.ts
@@ -43,8 +44,7 @@ const i18n = (options) => {
 	const availableLocales = Object.keys(options.translations);
 	let defaultLocale;
 	if (options.defaultLocale && availableLocales.includes(options.defaultLocale)) defaultLocale = options.defaultLocale;
-	else if (availableLocales.includes("en")) defaultLocale = "en";
-	else if (availableLocales.length > 0) defaultLocale = availableLocales[0];
+	else if (availableLocales.length > 0) defaultLocale = "en";
 	else throw new Error("i18n plugin: translations object is empty. At least one locale must be provided.");
 	const opts = {
 		defaultLocale,
@@ -109,4 +109,4 @@ const i18n = (options) => {
 	};
 };
 //#endregion
-export { i18n };
+export { i18n, locales_exports as locales };

package/dist/locales/index.d.mts

@@ -0,0 +1,2 @@
+import { C as ar, S as bn, _ as fr, a as tr, b as en, c as ru, d as nl, f as ko, g as hi, h as id, i as uk, l as pt, m as it, n as zh, o as th, p as ja, r as vi, s as sv, u as pl, v as fa, x as de, y as es } from "../index-CYmtmQve.mjs";
+export { ar, bn, de, en, es, fa, fr, hi, id, it, ja, ko, nl, pl, pt, ru, sv, th, tr, uk, vi, zh };

package/dist/locales/index.mjs

@@ -0,0 +1,2 @@
+import { C as ar, S as bn, _ as fr, a as tr, b as en, c as ru, d as nl, f as ko, g as hi, h as id, i as uk, l as pt, m as it, n as zh, o as th, p as ja, r as vi, s as sv, u as pl, v as fa, x as de, y as es } from "../locales-CSRpG5Mc.mjs";
+export { ar, bn, de, en, es, fa, fr, hi, id, it, ja, ko, nl, pl, pt, ru, sv, th, tr, uk, vi, zh };