@better-auth/i18n 1.5.6 → 1.6.0-beta.0

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { t as i18n } from "./index-CLmzQKXC.mjs";
+import { t as i18n } from "./index-CBC5D-Ic.mjs";
 
 //#region src/client.d.ts
 /**
@@ -20,8 +20,8 @@ import { t as i18n } from "./index-CLmzQKXC.mjs";
  */
 declare const i18nClient: () => {
   id: "i18n";
+  version: string;
   $InferServerPlugin: ReturnType<typeof i18n>;
 };
 //#endregion
-export { i18nClient };
-//# sourceMappingURL=client.d.mts.map
+export { i18nClient };

package/dist/client.mjs

@@ -1,3 +1,4 @@
+import { t as PACKAGE_VERSION } from "./version-BqMHXjG-.mjs";
 //#region src/client.ts
 /**
 * i18n client plugin for Better Auth
@@ -19,10 +20,9 @@
 const i18nClient = () => {
 	return {
 		id: "i18n",
+		version: PACKAGE_VERSION,
 		$InferServerPlugin: {}
 	};
 };
-
 //#endregion
 export { i18nClient };
-//# sourceMappingURL=client.mjs.map

package/dist/index-CBC5D-Ic.d.mts

@@ -0,0 +1,431 @@
+import { BetterAuthPluginRegistry, BetterAuthPluginRegistryIdentifier, GenericEndpointContext, UnionToIntersection } from "@better-auth/core";
+
+//#region ../../node_modules/.pnpm/better-call@2.0.3_zod@4.3.6/node_modules/better-call/dist/cookies.d.mts
+//#region src/cookies.d.ts
+type CookiePrefixOptions = "host" | "secure";
+type CookieOptions = {
+  /**
+   * Domain of the cookie
+   *
+   * The Domain attribute specifies which server can receive a cookie. If specified, cookies are
+   * available on the specified server and its subdomains. If the it is not
+   * specified, the cookies are available on the server that sets it but not on
+   * its subdomains.
+   *
+   * @example
+   * `domain: "example.com"`
+   */
+  domain?: string;
+  /**
+   * A lifetime of a cookie. Permanent cookies are deleted after the date specified in the
+   * Expires attribute:
+   *
+   * Expires has been available for longer than Max-Age, however Max-Age is less error-prone, and
+   * takes precedence when both are set. The rationale behind this is that when you set an
+   * Expires date and time, they're relative to the client the cookie is being set on. If the
+   * server is set to a different time, this could cause errors
+   */
+  expires?: Date;
+  /**
+   * Forbids JavaScript from accessing the cookie, for example, through the Document.cookie
+   * property. Note that a cookie that has been created with HttpOnly will still be sent with
+   * JavaScript-initiated requests, for example, when calling XMLHttpRequest.send() or fetch().
+   * This mitigates attacks against cross-site scripting
+   */
+  httpOnly?: boolean;
+  /**
+   * Indicates the number of seconds until the cookie expires. A zero or negative number will
+   * expire the cookie immediately. If both Expires and Max-Age are set, Max-Age has precedence.
+   *
+   * @example 604800 - 7 days
+   */
+  maxAge?: number;
+  /**
+   * Indicates the path that must exist in the requested URL for the browser to send the Cookie
+   * header.
+   *
+   * @example
+   * "/docs"
+   * // -> the request paths /docs, /docs/, /docs/Web/, and /docs/Web/HTTP will all match. the request paths /, /fr/docs will not match.
+   */
+  path?: string;
+  /**
+   * Indicates that the cookie is sent to the server only when a request is made with the https:
+   * scheme (except on localhost), and therefore, is more resistant to man-in-the-middle attacks.
+   */
+  secure?: boolean;
+  /**
+   * Controls whether or not a cookie is sent with cross-site requests, providing some protection
+   * against cross-site request forgery attacks (CSRF).
+   *
+   * Strict -  Means that the browser sends the cookie only for same-site requests, that is,
+   * requests originating from the same site that set the cookie. If a request originates from a
+   * different domain or scheme (even with the same domain), no cookies with the SameSite=Strict
+   * attribute are sent.
+   *
+   * Lax - Means that the cookie is not sent on cross-site requests, such as on requests to load
+   * images or frames, but is sent when a user is navigating to the origin site from an external
+   * site (for example, when following a link). This is the default behavior if the SameSite
+   * attribute is not specified.
+   *
+   * None - Means that the browser sends the cookie with both cross-site and same-site requests.
+   * The Secure attribute must also be set when setting this value.
+   */
+  sameSite?: "Strict" | "Lax" | "None" | "strict" | "lax" | "none";
+  /**
+   * Indicates that the cookie should be stored using partitioned storage. Note that if this is
+   * set, the Secure directive must also be set.
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/Privacy/Privacy_sandbox/Partitioned_cookies
+   */
+  partitioned?: boolean;
+  /**
+   * Cooke Prefix
+   *
+   * - secure: `__Secure-` -> `__Secure-cookie-name`
+   * - host: `__Host-` -> `__Host-cookie-name`
+   *
+   * `secure` must be set to true to use prefixes
+   */
+  prefix?: CookiePrefixOptions;
+};
+//#endregion
+//#region ../../node_modules/.pnpm/better-call@2.0.3_zod@4.3.6/node_modules/better-call/dist/error.d.mts
+declare const statusCodes: {
+  OK: number;
+  CREATED: number;
+  ACCEPTED: number;
+  NO_CONTENT: number;
+  MULTIPLE_CHOICES: number;
+  MOVED_PERMANENTLY: number;
+  FOUND: number;
+  SEE_OTHER: number;
+  NOT_MODIFIED: number;
+  TEMPORARY_REDIRECT: number;
+  BAD_REQUEST: number;
+  UNAUTHORIZED: number;
+  PAYMENT_REQUIRED: number;
+  FORBIDDEN: number;
+  NOT_FOUND: number;
+  METHOD_NOT_ALLOWED: number;
+  NOT_ACCEPTABLE: number;
+  PROXY_AUTHENTICATION_REQUIRED: number;
+  REQUEST_TIMEOUT: number;
+  CONFLICT: number;
+  GONE: number;
+  LENGTH_REQUIRED: number;
+  PRECONDITION_FAILED: number;
+  PAYLOAD_TOO_LARGE: number;
+  URI_TOO_LONG: number;
+  UNSUPPORTED_MEDIA_TYPE: number;
+  RANGE_NOT_SATISFIABLE: number;
+  EXPECTATION_FAILED: number;
+  "I'M_A_TEAPOT": number;
+  MISDIRECTED_REQUEST: number;
+  UNPROCESSABLE_ENTITY: number;
+  LOCKED: number;
+  FAILED_DEPENDENCY: number;
+  TOO_EARLY: number;
+  UPGRADE_REQUIRED: number;
+  PRECONDITION_REQUIRED: number;
+  TOO_MANY_REQUESTS: number;
+  REQUEST_HEADER_FIELDS_TOO_LARGE: number;
+  UNAVAILABLE_FOR_LEGAL_REASONS: number;
+  INTERNAL_SERVER_ERROR: number;
+  NOT_IMPLEMENTED: number;
+  BAD_GATEWAY: number;
+  SERVICE_UNAVAILABLE: number;
+  GATEWAY_TIMEOUT: number;
+  HTTP_VERSION_NOT_SUPPORTED: number;
+  VARIANT_ALSO_NEGOTIATES: number;
+  INSUFFICIENT_STORAGE: number;
+  LOOP_DETECTED: number;
+  NOT_EXTENDED: number;
+  NETWORK_AUTHENTICATION_REQUIRED: number;
+};
+type Status = 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511;
+declare class InternalAPIError extends Error {
+  status: keyof typeof statusCodes | Status;
+  body: ({
+    message?: string;
+    code?: string;
+    cause?: unknown;
+  } & Record<string, any>) | undefined;
+  headers: HeadersInit;
+  statusCode: number;
+  constructor(status?: keyof typeof statusCodes | Status, body?: ({
+    message?: string;
+    code?: string;
+    cause?: unknown;
+  } & Record<string, any>) | undefined, headers?: HeadersInit, statusCode?: number);
+}
+type APIError = InstanceType<typeof InternalAPIError>;
+declare const APIError: new (status?: Status | "OK" | "CREATED" | "ACCEPTED" | "NO_CONTENT" | "MULTIPLE_CHOICES" | "MOVED_PERMANENTLY" | "FOUND" | "SEE_OTHER" | "NOT_MODIFIED" | "TEMPORARY_REDIRECT" | "BAD_REQUEST" | "UNAUTHORIZED" | "PAYMENT_REQUIRED" | "FORBIDDEN" | "NOT_FOUND" | "METHOD_NOT_ALLOWED" | "NOT_ACCEPTABLE" | "PROXY_AUTHENTICATION_REQUIRED" | "REQUEST_TIMEOUT" | "CONFLICT" | "GONE" | "LENGTH_REQUIRED" | "PRECONDITION_FAILED" | "PAYLOAD_TOO_LARGE" | "URI_TOO_LONG" | "UNSUPPORTED_MEDIA_TYPE" | "RANGE_NOT_SATISFIABLE" | "EXPECTATION_FAILED" | "I'M_A_TEAPOT" | "MISDIRECTED_REQUEST" | "UNPROCESSABLE_ENTITY" | "LOCKED" | "FAILED_DEPENDENCY" | "TOO_EARLY" | "UPGRADE_REQUIRED" | "PRECONDITION_REQUIRED" | "TOO_MANY_REQUESTS" | "REQUEST_HEADER_FIELDS_TOO_LARGE" | "UNAVAILABLE_FOR_LEGAL_REASONS" | "INTERNAL_SERVER_ERROR" | "NOT_IMPLEMENTED" | "BAD_GATEWAY" | "SERVICE_UNAVAILABLE" | "GATEWAY_TIMEOUT" | "HTTP_VERSION_NOT_SUPPORTED" | "VARIANT_ALSO_NEGOTIATES" | "INSUFFICIENT_STORAGE" | "LOOP_DETECTED" | "NOT_EXTENDED" | "NETWORK_AUTHENTICATION_REQUIRED" | undefined, body?: ({
+  message?: string;
+  code?: string;
+  cause?: unknown;
+} & Record<string, any>) | undefined, headers?: HeadersInit | undefined, statusCode?: number | undefined) => InternalAPIError & {
+  errorStack: string | undefined;
+}; //#endregion
+//#endregion
+//#region ../../node_modules/.pnpm/better-call@2.0.3_zod@4.3.6/node_modules/better-call/dist/helper.d.mts
+type Prettify<T> = 0 extends 1 & T ? any : { [K in keyof T]: T[K] } & {};
+//#endregion
+//#region ../../node_modules/.pnpm/better-call@2.0.3_zod@4.3.6/node_modules/better-call/dist/middleware.d.mts
+//#region src/middleware.d.ts
+type MiddlewareContext<Context = {}> = {
+  /**
+   * Method
+   *
+   * The request method
+   */
+  method: string;
+  /**
+   * Path
+   *
+   * The path of the endpoint
+   */
+  path: string;
+  /**
+   * Body
+   *
+   * The body object will be the parsed JSON from the request and validated
+   * against the body schema if it exists
+   */
+  body: any;
+  /**
+   * Query
+   *
+   * The query object will be the parsed query string from the request
+   * and validated against the query schema if it exists
+   */
+  query: Record<string, any> | undefined;
+  /**
+   * Params
+   *
+   * If the path is `/user/:id` and the request is `/user/1` then the
+   * params will be `{ id: "1" }` and if the path includes a wildcard like
+   * `/user/*` then the params will be `{ _: "1" }` where `_` is the wildcard
+   * key. If the wildcard is named like `/user/**:name` then the params will
+   * be `{ name: string }`
+   */
+  params: Record<string, any> | undefined;
+  /**
+   * Request object
+   *
+   * If `requireRequest` is set to true in the endpoint options this will be
+   * required
+   */
+  request: Request | undefined;
+  /**
+   * Headers
+   *
+   * If `requireHeaders` is set to true in the endpoint options this will be
+   * required
+   */
+  headers: Headers | undefined;
+  /**
+   * Set header
+   *
+   * If it's called outside of a request it will just be ignored.
+   */
+  setHeader: (key: string, value: string) => void;
+  /**
+   * Set the response status code
+   */
+  setStatus: (status: Status) => void;
+  /**
+   * Get header
+   *
+   * If it's called outside of a request it will just return null
+   *
+   * @param key - The key of the header
+   */
+  getHeader: (key: string) => string | null;
+  /**
+   * Get a cookie value from the request
+   *
+   * @param key - The key of the cookie
+   * @param prefix - The prefix of the cookie between `__Secure-` and `__Host-`
+   * @returns The value of the cookie
+   */
+  getCookie: (key: string, prefix?: CookiePrefixOptions) => string | null;
+  /**
+   * Get a signed cookie value from the request
+   *
+   * @param key - The key of the cookie
+   * @param secret - The secret of the signed cookie
+   * @param prefix - The prefix of the cookie between `__Secure-` and `__Host-`
+   * @returns The value of the cookie or null if the cookie is not found or false if the signature is invalid
+   */
+  getSignedCookie: (key: string, secret: string, prefix?: CookiePrefixOptions) => Promise<string | null | false>;
+  /**
+   * Set a cookie value in the response
+   *
+   * @param key - The key of the cookie
+   * @param value - The value to set
+   * @param options - The options of the cookie
+   * @returns The cookie string
+   */
+  setCookie: (key: string, value: string, options?: CookieOptions) => string;
+  /**
+   * Set signed cookie
+   *
+   * @param key - The key of the cookie
+   * @param value - The value to set
+   * @param secret - The secret to sign the cookie with
+   * @param options - The options of the cookie
+   * @returns The cookie string
+   */
+  setSignedCookie: (key: string, value: string, secret: string, options?: CookieOptions) => Promise<string>;
+  /**
+   * JSON
+   *
+   * A helper function to create a JSON response with the correct headers
+   * and status code. If `asResponse` is set to true in the context then
+   * it will return a Response object instead of the JSON object.
+   *
+   * @param json - The JSON object to return
+   * @param routerResponse - The response object to return if `asResponse` is
+   * true in the context this will take precedence
+   */
+  json: <R extends Record<string, any> | null>(json: R, routerResponse?: {
+    status?: number;
+    headers?: Record<string, string>;
+    response?: Response;
+    body?: Record<string, any>;
+  } | Response) => R;
+  /**
+   * Middleware context
+   */
+  context: Prettify<Context>;
+  /**
+   * Redirect to a new URL
+   */
+  redirect: (url: string) => APIError;
+  /**
+   * Return error
+   */
+  error: (status: keyof typeof statusCodes | Status, body?: {
+    message?: string;
+    code?: string;
+  } & Record<string, any>, headers?: HeadersInit) => APIError;
+  asResponse?: boolean;
+  returnHeaders?: boolean;
+  returnStatus?: boolean;
+  responseHeaders: Headers;
+};
+type DefaultHandler = (inputCtx: MiddlewareContext<any>) => Promise<any>;
+type Middleware<Handler extends (inputCtx: MiddlewareContext<any>) => Promise<any> = DefaultHandler> = Handler & {
+  options: Record<string, any>;
+};
+//#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> {
+    i18n: {
+      creator: typeof i18n;
+    };
+  }
+}
+/**
+ * i18n plugin for Better Auth
+ *
+ * Translates error messages based on detected locale.
+ *
+ * @example
+ * ```ts
+ * import { betterAuth } from "better-auth";
+ * import { i18n } from "@better-auth/i18n";
+ *
+ * export const auth = betterAuth({
+ *   plugins: [
+ *     i18n({
+ *       translations: {
+ *         en: { USER_NOT_FOUND: "User not found" },
+ *         fr: { USER_NOT_FOUND: "Utilisateur non trouvé" },
+ *       },
+ *       detection: ["header", "cookie"],
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare const i18n: <Locales extends string[]>(options: I18nOptions<Locales>) => {
+  id: "i18n";
+  version: string;
+  hooks: {
+    after: {
+      matcher: () => true;
+      handler: Middleware<(inputContext: Record<string, any>) => Promise<void>>;
+    }[];
+  };
+  options: {
+    translations: { [Locale in Locales[number]]: TranslationDictionary };
+    defaultLocale: Locales[number];
+    detection: LocaleDetectionStrategy[];
+    localeCookie: string;
+    userLocaleField: string;
+    getLocale?: ((ctx: GenericEndpointContext) => Locales[number] | Promise<Locales[number] | null> | null) | undefined;
+  };
+};
+//#endregion
+export { TranslationDictionary as i, I18nOptions as n, LocaleDetectionStrategy as r, i18n as t };

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { i as TranslationDictionary, n as I18nOptions, r as LocaleDetectionStrategy, t as i18n } from "./index-CLmzQKXC.mjs";
+import { i as TranslationDictionary, n as I18nOptions, r as LocaleDetectionStrategy, t as i18n } from "./index-CBC5D-Ic.mjs";
 export { I18nOptions, LocaleDetectionStrategy, TranslationDictionary, i18n };

package/dist/index.mjs

@@ -1,6 +1,6 @@
+import { t as PACKAGE_VERSION } from "./version-BqMHXjG-.mjs";
 import { APIError, createAuthMiddleware, isAPIError } from "better-auth/api";
 import { parseCookies } from "better-auth/cookies";
-
 //#region src/index.ts
 /**
 * Parse Accept-Language header and return locales sorted by quality
@@ -87,6 +87,7 @@ const i18n = (options) => {
 	}
 	return {
 		id: "i18n",
+		version: PACKAGE_VERSION,
 		hooks: { after: [{
 			matcher: () => true,
 			handler: createAuthMiddleware(async (ctx) => {
@@ -107,7 +108,5 @@ const i18n = (options) => {
 		options: opts
 	};
 };
-
 //#endregion
 export { i18n };
-//# sourceMappingURL=index.mjs.map

package/dist/version-BqMHXjG-.mjs

@@ -0,0 +1,5 @@
+//#endregion
+//#region src/version.ts
+const PACKAGE_VERSION = "1.6.0-beta.0";
+//#endregion
+export { PACKAGE_VERSION as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-auth/i18n",
-  "version": "1.5.6",
+  "version": "1.6.0-beta.0",
   "description": "i18n plugin for Better Auth - translate error messages",
   "type": "module",
   "license": "MIT",
@@ -20,6 +20,7 @@
   "publishConfig": {
     "access": "public"
   },
+  "sideEffects": false,
   "files": [
     "dist"
   ],
@@ -49,18 +50,18 @@
     }
   },
   "devDependencies": {
-    "tsdown": "0.21.0-beta.2",
-    "@better-auth/core": "1.5.6",
-    "better-auth": "1.5.6"
+    "tsdown": "0.21.1",
+    "@better-auth/core": "1.6.0-beta.0",
+    "better-auth": "1.6.0-beta.0"
   },
   "peerDependencies": {
-    "@better-auth/core": "1.5.6",
-    "better-auth": "1.5.6"
+    "@better-auth/core": "^1.6.0-beta.0",
+    "better-auth": "^1.6.0-beta.0"
   },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
-    "lint:package": "publint run --strict",
+    "lint:package": "publint run --strict --pack false",
     "lint:types": "attw --profile esm-only --pack .",
     "typecheck": "tsc --project tsconfig.json",
     "test": "vitest",

package/dist/client.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import type { BetterAuthClientPlugin } from \"@better-auth/core\";\nimport type { i18n } from \".\";\n\n/**\n * i18n client plugin for Better Auth\n *\n * This client plugin provides type inference for the i18n server plugin.\n * Error messages from the server will already be translated based on\n * the detected locale.\n *\n * @example\n * ```ts\n * import { createAuthClient } from \"better-auth/client\";\n * import { i18nClient } from \"@better-auth/i18n/client\";\n *\n * export const client = createAuthClient({\n *   plugins: [i18nClient()],\n * });\n * ```\n */\nexport const i18nClient = () => {\n\treturn {\n\t\tid: \"i18n\",\n\t\t$InferServerPlugin: {} as ReturnType<typeof i18n>,\n\t} satisfies BetterAuthClientPlugin;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,MAAa,mBAAmB;AAC/B,QAAO;EACN,IAAI;EACJ,oBAAoB,EAAE;EACtB"}

package/dist/index-CLmzQKXC.d.mts

@@ -1,112 +0,0 @@
-import * as better_call0 from "better-call";
-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/index.d.ts
-declare module "@better-auth/core" {
-  interface BetterAuthPluginRegistry<AuthOptions, Options> {
-    i18n: {
-      creator: typeof i18n;
-    };
-  }
-}
-/**
- * i18n plugin for Better Auth
- *
- * Translates error messages based on detected locale.
- *
- * @example
- * ```ts
- * import { betterAuth } from "better-auth";
- * import { i18n } from "@better-auth/i18n";
- *
- * export const auth = betterAuth({
- *   plugins: [
- *     i18n({
- *       translations: {
- *         en: { USER_NOT_FOUND: "User not found" },
- *         fr: { USER_NOT_FOUND: "Utilisateur non trouvé" },
- *       },
- *       detection: ["header", "cookie"],
- *     }),
- *   ],
- * });
- * ```
- */
-declare const i18n: <Locales extends string[]>(options: I18nOptions<Locales>) => {
-  id: "i18n";
-  hooks: {
-    after: {
-      matcher: () => true;
-      handler: (inputContext: better_call0.MiddlewareInputContext<better_call0.MiddlewareOptions>) => Promise<void>;
-    }[];
-  };
-  options: {
-    translations: { [Locale in Locales[number]]: TranslationDictionary };
-    defaultLocale: Locales[number];
-    detection: LocaleDetectionStrategy[];
-    localeCookie: string;
-    userLocaleField: string;
-    getLocale?: ((ctx: GenericEndpointContext) => Locales[number] | Promise<Locales[number] | null> | null) | undefined;
-  };
-};
-//#endregion
-export { TranslationDictionary as i, I18nOptions as n, LocaleDetectionStrategy as r, i18n as t };
-//# sourceMappingURL=index-CLmzQKXC.d.mts.map

package/dist/index.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["import type {\n\tBetterAuthPlugin,\n\tGenericEndpointContext,\n} from \"@better-auth/core\";\nimport { APIError, createAuthMiddleware, isAPIError } from \"better-auth/api\";\nimport { parseCookies } from \"better-auth/cookies\";\nimport type { I18nOptions, LocaleDetectionStrategy } from \"./types\";\n\nexport type {\n\tI18nOptions,\n\tLocaleDetectionStrategy,\n\tTranslationDictionary,\n} from \"./types\";\n\ndeclare module \"@better-auth/core\" {\n\tinterface BetterAuthPluginRegistry<AuthOptions, Options> {\n\t\ti18n: {\n\t\t\tcreator: typeof i18n;\n\t\t};\n\t}\n}\n\n/**\n * Parse Accept-Language header and return locales sorted by quality\n */\nfunction parseAcceptLanguage(header: string | null): string[] {\n\tif (!header) return [];\n\treturn header\n\t\t.split(\",\")\n\t\t.map((part) => {\n\t\t\tconst [localeStr, quality = \"q=1\"] = part.trim().split(\";\");\n\t\t\tconst q = Number.parseFloat(quality.replace(\"q=\", \"\"));\n\t\t\t// Get base locale (e.g., \"en\" from \"en-US\")\n\t\t\tconst locale = localeStr?.trim().split(\"-\")[0] ?? \"\";\n\t\t\treturn { locale, q };\n\t\t})\n\t\t.filter((item) => item.locale.length > 0)\n\t\t.sort((a, b) => b.q - a.q)\n\t\t.map((item) => item.locale);\n}\n\n/**\n * i18n plugin for Better Auth\n *\n * Translates error messages based on detected locale.\n *\n * @example\n * ```ts\n * import { betterAuth } from \"better-auth\";\n * import { i18n } from \"@better-auth/i18n\";\n *\n * export const auth = betterAuth({\n *   plugins: [\n *     i18n({\n *       translations: {\n *         en: { USER_NOT_FOUND: \"User not found\" },\n *         fr: { USER_NOT_FOUND: \"Utilisateur non trouvé\" },\n *       },\n *       detection: [\"header\", \"cookie\"],\n *     }),\n *   ],\n * });\n * ```\n */\nexport const i18n = <Locales extends string[]>(\n\toptions: I18nOptions<Locales>,\n) => {\n\tconst availableLocales = Object.keys(options.translations);\n\n\tlet defaultLocale: Locales[number];\n\tif (\n\t\toptions.defaultLocale &&\n\t\tavailableLocales.includes(options.defaultLocale)\n\t) {\n\t\tdefaultLocale = options.defaultLocale;\n\t} else if (availableLocales.includes(\"en\")) {\n\t\tdefaultLocale = \"en\" as Locales[number];\n\t} else if (availableLocales.length > 0) {\n\t\tdefaultLocale = availableLocales[0] as Locales[number];\n\t} else {\n\t\tthrow new Error(\n\t\t\t\"i18n plugin: translations object is empty. At least one locale must be provided.\",\n\t\t);\n\t}\n\n\tconst opts = {\n\t\tdefaultLocale,\n\t\tdetection: [\"header\"] as LocaleDetectionStrategy[],\n\t\tlocaleCookie: \"locale\",\n\t\tuserLocaleField: \"locale\",\n\t\t...options,\n\t};\n\n\tasync function detectLocale(\n\t\tctx: GenericEndpointContext,\n\t): Promise<Locales[number]> {\n\t\tfor (const strategy of opts.detection) {\n\t\t\tlet locale: Locales[number] | null = null;\n\n\t\t\tswitch (strategy) {\n\t\t\t\tcase \"header\": {\n\t\t\t\t\tconst acceptLang = ctx.headers?.get(\"Accept-Language\") ?? null;\n\t\t\t\t\tconst preferred = parseAcceptLanguage(acceptLang);\n\t\t\t\t\tlocale = preferred.find((l) => availableLocales.includes(l)) ?? null;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tcase \"cookie\": {\n\t\t\t\t\tconst cookieHeader = ctx.headers?.get(\"Cookie\");\n\t\t\t\t\tif (cookieHeader) {\n\t\t\t\t\t\tconst cookies = parseCookies(cookieHeader);\n\t\t\t\t\t\tconst cookieLocale = cookies.get(opts.localeCookie);\n\t\t\t\t\t\tif (cookieLocale && availableLocales.includes(cookieLocale)) {\n\t\t\t\t\t\t\tlocale = cookieLocale;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tcase \"session\": {\n\t\t\t\t\tif (ctx.context.session?.user) {\n\t\t\t\t\t\tconst userLocale = (\n\t\t\t\t\t\t\tctx.context.session.user as Record<string, unknown>\n\t\t\t\t\t\t)[opts.userLocaleField];\n\t\t\t\t\t\tif (\n\t\t\t\t\t\t\ttypeof userLocale === \"string\" &&\n\t\t\t\t\t\t\tavailableLocales.includes(userLocale)\n\t\t\t\t\t\t) {\n\t\t\t\t\t\t\tlocale = userLocale;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\tcase \"callback\": {\n\t\t\t\t\tif (opts.getLocale) {\n\t\t\t\t\t\tconst callbackLocale = await opts.getLocale(ctx);\n\t\t\t\t\t\tif (callbackLocale && availableLocales.includes(callbackLocale)) {\n\t\t\t\t\t\t\tlocale = callbackLocale;\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (locale) return locale;\n\t\t}\n\n\t\treturn opts.defaultLocale;\n\t}\n\n\treturn {\n\t\tid: \"i18n\",\n\t\thooks: {\n\t\t\tafter: [\n\t\t\t\t{\n\t\t\t\t\tmatcher: () => true,\n\t\t\t\t\thandler: createAuthMiddleware(async (ctx) => {\n\t\t\t\t\t\tconst returned = ctx.context.returned;\n\n\t\t\t\t\t\tif (!isAPIError(returned)) {\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst errorCode = (returned.body as Record<string, unknown>)?.code;\n\t\t\t\t\t\tif (typeof errorCode !== \"string\") {\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tconst locale = await detectLocale(ctx);\n\n\t\t\t\t\t\tconst translation = opts.translations[locale]?.[errorCode];\n\n\t\t\t\t\t\tif (!translation) {\n\t\t\t\t\t\t\treturn;\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tthrow new APIError(returned.status, {\n\t\t\t\t\t\t\tcode: errorCode,\n\t\t\t\t\t\t\tmessage: translation,\n\t\t\t\t\t\t\toriginalMessage: returned.message,\n\t\t\t\t\t\t});\n\t\t\t\t\t}),\n\t\t\t\t},\n\t\t\t],\n\t\t},\n\n\t\toptions: opts,\n\t} satisfies BetterAuthPlugin;\n};\n\nexport type * from \"./types\";\n"],"mappings":";;;;;;;AAyBA,SAAS,oBAAoB,QAAiC;AAC7D,KAAI,CAAC,OAAQ,QAAO,EAAE;AACtB,QAAO,OACL,MAAM,IAAI,CACV,KAAK,SAAS;EACd,MAAM,CAAC,WAAW,UAAU,SAAS,KAAK,MAAM,CAAC,MAAM,IAAI;EAC3D,MAAM,IAAI,OAAO,WAAW,QAAQ,QAAQ,MAAM,GAAG,CAAC;AAGtD,SAAO;GAAE,QADM,WAAW,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM;GACjC;GAAG;GACnB,CACD,QAAQ,SAAS,KAAK,OAAO,SAAS,EAAE,CACxC,MAAM,GAAG,MAAM,EAAE,IAAI,EAAE,EAAE,CACzB,KAAK,SAAS,KAAK,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;AA0B7B,MAAa,QACZ,YACI;CACJ,MAAM,mBAAmB,OAAO,KAAK,QAAQ,aAAa;CAE1D,IAAI;AACJ,KACC,QAAQ,iBACR,iBAAiB,SAAS,QAAQ,cAAc,CAEhD,iBAAgB,QAAQ;UACd,iBAAiB,SAAS,KAAK,CACzC,iBAAgB;UACN,iBAAiB,SAAS,EACpC,iBAAgB,iBAAiB;KAEjC,OAAM,IAAI,MACT,mFACA;CAGF,MAAM,OAAO;EACZ;EACA,WAAW,CAAC,SAAS;EACrB,cAAc;EACd,iBAAiB;EACjB,GAAG;EACH;CAED,eAAe,aACd,KAC2B;AAC3B,OAAK,MAAM,YAAY,KAAK,WAAW;GACtC,IAAI,SAAiC;AAErC,WAAQ,UAAR;IACC,KAAK;AAGJ,cADkB,oBADC,IAAI,SAAS,IAAI,kBAAkB,IAAI,KACT,CAC9B,MAAM,MAAM,iBAAiB,SAAS,EAAE,CAAC,IAAI;AAChE;IAGD,KAAK,UAAU;KACd,MAAM,eAAe,IAAI,SAAS,IAAI,SAAS;AAC/C,SAAI,cAAc;MAEjB,MAAM,eADU,aAAa,aAAa,CACb,IAAI,KAAK,aAAa;AACnD,UAAI,gBAAgB,iBAAiB,SAAS,aAAa,CAC1D,UAAS;;AAGX;;IAGD,KAAK;AACJ,SAAI,IAAI,QAAQ,SAAS,MAAM;MAC9B,MAAM,aACL,IAAI,QAAQ,QAAQ,KACnB,KAAK;AACP,UACC,OAAO,eAAe,YACtB,iBAAiB,SAAS,WAAW,CAErC,UAAS;;AAGX;IAGD,KAAK;AACJ,SAAI,KAAK,WAAW;MACnB,MAAM,iBAAiB,MAAM,KAAK,UAAU,IAAI;AAChD,UAAI,kBAAkB,iBAAiB,SAAS,eAAe,CAC9D,UAAS;;AAGX;;AAIF,OAAI,OAAQ,QAAO;;AAGpB,SAAO,KAAK;;AAGb,QAAO;EACN,IAAI;EACJ,OAAO,EACN,OAAO,CACN;GACC,eAAe;GACf,SAAS,qBAAqB,OAAO,QAAQ;IAC5C,MAAM,WAAW,IAAI,QAAQ;AAE7B,QAAI,CAAC,WAAW,SAAS,CACxB;IAGD,MAAM,YAAa,SAAS,MAAkC;AAC9D,QAAI,OAAO,cAAc,SACxB;IAGD,MAAM,SAAS,MAAM,aAAa,IAAI;IAEtC,MAAM,cAAc,KAAK,aAAa,UAAU;AAEhD,QAAI,CAAC,YACJ;AAGD,UAAM,IAAI,SAAS,SAAS,QAAQ;KACnC,MAAM;KACN,SAAS;KACT,iBAAiB,SAAS;KAC1B,CAAC;KACD;GACF,CACD,EACD;EAED,SAAS;EACT"}