@better-i18n/server 0.2.0 → 0.3.1

package/README.md

@@ -0,0 +1,177 @@
+# @better-i18n/server
+
+Framework-agnostic server-side i18n for [Better i18n](https://better-i18n.com). Built-in support for Hono, Express, Fastify, and any Node.js HTTP server.
+
+[![npm](https://img.shields.io/npm/v/@better-i18n/server)](https://www.npmjs.com/package/@better-i18n/server)
+
+## Features
+
+- **Framework Agnostic** — Core API uses Web Standards `Headers`, works everywhere
+- **Hono Middleware** — First-class middleware with typed context variables
+- **Express/Fastify Middleware** — Node.js adapter with `req.locale` and `req.t`
+- **Accept-Language Detection** — RFC 5646 compliant locale matching
+- **CDN-Cached** — Singleton pattern with shared TtlCache across all requests
+- **Type-Safe Translations** — Built on `use-intl/core` for consistent formatting
+
+## Installation
+
+```bash
+npm install @better-i18n/server
+# or
+bun add @better-i18n/server
+```
+
+## Quick Start
+
+### 1. Create a singleton instance
+
+```ts
+// i18n.ts (module scope — shared across all requests)
+import { createServerI18n } from "@better-i18n/server";
+
+export const i18n = createServerI18n({
+  project: "acme/api",
+  defaultLocale: "en",
+});
+```
+
+### 2. Use with your framework
+
+#### Hono
+
+```ts
+import { Hono } from "hono";
+import { betterI18n } from "@better-i18n/server/hono";
+import type { Translator } from "@better-i18n/server";
+import { i18n } from "./i18n";
+
+const app = new Hono<{
+  Variables: {
+    locale: string;
+    t: Translator;
+  };
+}>();
+
+app.use("*", betterI18n(i18n));
+
+app.get("/users/:id", (c) => {
+  const t = c.get("t");
+  const locale = c.get("locale");
+  return c.json({ message: t("users.welcome"), locale });
+});
+```
+
+#### Express
+
+```ts
+import express from "express";
+import { betterI18nMiddleware } from "@better-i18n/server/node";
+import { i18n } from "./i18n";
+
+const app = express();
+app.use(betterI18nMiddleware(i18n));
+
+app.get("/users/:id", (req, res) => {
+  res.json({ message: req.t("users.welcome"), locale: req.locale });
+});
+```
+
+TypeScript augmentation (add to a `.d.ts` file):
+
+```ts
+import type { Translator } from "@better-i18n/server";
+
+declare global {
+  namespace Express {
+    interface Request {
+      locale: string;
+      t: Translator;
+    }
+  }
+}
+```
+
+#### Fastify / Koa / Custom
+
+Use `fromNodeHeaders` to convert Node.js headers to Web Standards `Headers`:
+
+```ts
+import { fromNodeHeaders } from "@better-i18n/server/node";
+import { i18n } from "./i18n";
+
+// In any request handler
+const headers = fromNodeHeaders(req.headers);
+const locale = await i18n.detectLocaleFromHeaders(headers);
+const t = await i18n.getTranslator(locale);
+
+t("errors.notFound"); // → "Bulunamadı"
+```
+
+#### Direct API (no middleware)
+
+```ts
+import { i18n } from "./i18n";
+
+// Translate with any locale
+const t = await i18n.getTranslator("tr");
+t("errors.notFound"); // → "Bulunamadı"
+
+// With namespace
+const tAuth = await i18n.getTranslator("tr", "auth");
+tAuth("loginRequired"); // → "Giriş yapmanız gerekiyor"
+
+// Get available locales
+const locales = await i18n.getLocales();
+// ["en", "tr", "de"]
+```
+
+## API
+
+### `createServerI18n(config)`
+
+Creates a singleton i18n instance. Call once at module scope.
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `project` | `string` | — | Project identifier (`"org/project"`) |
+| `defaultLocale` | `string` | — | Fallback locale |
+| `cdnBaseUrl` | `string` | CDN default | CDN base URL override |
+| `debug` | `boolean` | `false` | Enable debug logging |
+
+### Instance Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `getTranslator(locale, namespace?)` | `Promise<Translator>` | Get a translator function for a locale |
+| `detectLocaleFromHeaders(headers)` | `Promise<string>` | Detect locale from Web Standards `Headers` |
+| `getLocales()` | `Promise<string[]>` | Get available locale codes |
+| `getLanguages()` | `Promise<LanguageOption[]>` | Get languages with metadata |
+
+### Entry Points
+
+| Import | Use Case |
+|--------|----------|
+| `@better-i18n/server` | Core `createServerI18n`, types |
+| `@better-i18n/server/hono` | `betterI18n()` Hono middleware |
+| `@better-i18n/server/node` | `betterI18nMiddleware()` for Express, `fromNodeHeaders()` for Fastify/Koa |
+
+## How It Works
+
+1. **Singleton pattern** — `createServerI18n` creates one `@better-i18n/core` instance with shared TtlCache
+2. **Locale detection** — `detectLocaleFromHeaders` parses Accept-Language, matches against CDN manifest locales
+3. **Translation** — `getTranslator` fetches messages from CDN (cached), creates a `use-intl/core` translator
+4. **Match strategy** — Exact match (`tr-TR`) → base language (`tr`) → region expansion (`tr` → `tr-TR`)
+
+## Peer Dependencies
+
+| Package | Required | Version |
+|---------|----------|---------|
+| `hono` | Optional | `>=4.0.0` |
+
+## Documentation
+
+Full documentation at [docs.better-i18n.com/frameworks/server-sdk](https://docs.better-i18n.com/frameworks/server-sdk)
+
+## License
+
+MIT © [Better i18n](https://better-i18n.com)

package/dist/node.d.ts

@@ -49,6 +49,9 @@ export declare function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Heade
  * }
  * ```
  */
-export declare function betterI18nMiddleware(i18n: ServerI18n): (req: any, _res: any, next: () => void) => Promise<void>;
+export declare function betterI18nMiddleware(i18n: ServerI18n): (req: {
+    headers: IncomingHttpHeaders;
+    [key: string]: unknown;
+}, _res: unknown, next: () => void) => Promise<void>;
 export type { Translator };
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CASzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,IACrC,KAAK,GAAG,EAAE,MAAM,GAAG,EAAE,MAAM,MAAM,IAAI,mBAUpD;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,mBAAmB,GAAG,OAAO,CASzE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,IAEjD,KAAK;IAAE,OAAO,EAAE,mBAAmB,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAC7D,MAAM,OAAO,EACb,MAAM,MAAM,IAAI,mBAWnB;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,WAAgC;IAC9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,OAAO,KAAK,EAAE,GAAQ,EAAE,IAAS,EAAE,IAAgB,EAAE,EAAE;QACrD,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,OAA8B,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAE3C,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QACpB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAEV,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,eAAe,CAAC,WAAgC;IAC9D,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QACvD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAgB;IACnD,OAAO,KAAK,EACV,GAA6D,EAC7D,IAAa,EACb,IAAgB,EAChB,EAAE;QACF,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,OAA8B,CAAC,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAE3C,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;QACpB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAEV,IAAI,EAAE,CAAC;IACT,CAAC,CAAC;AACJ,CAAC"}

package/dist/providers/better-auth.d.ts

@@ -0,0 +1,101 @@
+import type { ServerI18n } from "../types.js";
+/** @internal Duck-typed subset of Better Auth's HookEndpointContext */
+interface HookContext {
+    context: {
+        returned?: unknown;
+        responseHeaders?: Headers;
+    };
+    headers?: Headers;
+    path?: string;
+}
+/**
+ * Options for the Better Auth localization provider.
+ */
+export interface BetterAuthProviderOptions {
+    /**
+     * CDN namespace where auth error translations are stored.
+     * Maps to the namespace in your Better i18n project.
+     * @default "auth"
+     */
+    namespace?: string;
+    /**
+     * Custom locale resolver. Overrides the default Accept-Language detection.
+     *
+     * Useful when locale is stored in a cookie, database, or user profile.
+     *
+     * @example
+     * ```ts
+     * createBetterAuthProvider(i18n, {
+     *   getLocale: async ({ headers }) => {
+     *     const cookie = headers?.get("cookie");
+     *     return parseCookie(cookie)?.locale ?? "en";
+     *   },
+     * })
+     * ```
+     */
+    getLocale?: (context: {
+        headers?: Headers;
+    }) => string | Promise<string>;
+    /**
+     * Log a warning when a translation key is missing in the namespace.
+     * Helps identify untranslated error codes during development.
+     * @default true
+     */
+    warnOnMissingKeys?: boolean;
+}
+/**
+ * Creates a Better Auth plugin that translates error messages using your
+ * Better i18n project's CDN translations.
+ *
+ * Unlike bundled localization packages, translations are fetched from the CDN
+ * at runtime — add or update translations from the dashboard, no redeployment
+ * needed. Missing keys log a warning and fall back to the original English
+ * message, so auth never breaks.
+ *
+ * @param i18n - The `ServerI18n` singleton from `createServerI18n()`
+ * @param options - Optional configuration (namespace, locale resolver, etc.)
+ * @returns A Better Auth plugin — pass it to `betterAuth({ plugins: [...] })`
+ *
+ * @example
+ * ```ts
+ * import { createServerI18n } from "@better-i18n/server";
+ * import { createBetterAuthProvider } from "@better-i18n/server/providers/better-auth";
+ *
+ * const i18n = createServerI18n({
+ *   project: "acme/dashboard",
+ *   defaultLocale: "en",
+ * });
+ *
+ * export const auth = betterAuth({
+ *   plugins: [
+ *     createBetterAuthProvider(i18n),
+ *   ],
+ * });
+ * ```
+ */
+export declare function createBetterAuthProvider(i18n: ServerI18n, options?: BetterAuthProviderOptions): {
+    id: "better-i18n";
+    hooks: {
+        after: {
+            matcher: () => boolean;
+            handler: (ctx: HookContext) => Promise<void>;
+        }[];
+    };
+};
+/**
+ * All Better Auth core error codes with their default English messages.
+ * Use these to seed your project's "auth" namespace.
+ *
+ * @example
+ * ```ts
+ * import { DEFAULT_AUTH_KEYS } from "@better-i18n/server/providers/better-auth";
+ *
+ * // Seed via MCP createKeys tool
+ * for (const [key, message] of Object.entries(DEFAULT_AUTH_KEYS)) {
+ *   await createKey({ namespace: "auth", key, translations: { en: message } });
+ * }
+ * ```
+ */
+export declare const DEFAULT_AUTH_KEYS: Record<string, string>;
+export {};
+//# sourceMappingURL=better-auth.d.ts.map

package/dist/providers/better-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-auth.d.ts","sourceRoot":"","sources":["../../src/providers/better-auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQ9C,uEAAuE;AACvE,UAAU,WAAW;IACnB,OAAO,EAAE;QACP,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzE;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,yBAAyB;;;;;2BAWN,WAAW;;;EAuDzC;AAaD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAuEpD,CAAC"}

package/dist/providers/better-auth.js

@@ -0,0 +1,187 @@
+function isAPIErrorLike(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const obj = value;
+    if (obj.name !== "APIError" || typeof obj.statusCode !== "number")
+        return false;
+    const body = obj.body;
+    if (!body || typeof body !== "object")
+        return false;
+    return typeof body.code === "string";
+}
+/**
+ * Creates a Better Auth plugin that translates error messages using your
+ * Better i18n project's CDN translations.
+ *
+ * Unlike bundled localization packages, translations are fetched from the CDN
+ * at runtime — add or update translations from the dashboard, no redeployment
+ * needed. Missing keys log a warning and fall back to the original English
+ * message, so auth never breaks.
+ *
+ * @param i18n - The `ServerI18n` singleton from `createServerI18n()`
+ * @param options - Optional configuration (namespace, locale resolver, etc.)
+ * @returns A Better Auth plugin — pass it to `betterAuth({ plugins: [...] })`
+ *
+ * @example
+ * ```ts
+ * import { createServerI18n } from "@better-i18n/server";
+ * import { createBetterAuthProvider } from "@better-i18n/server/providers/better-auth";
+ *
+ * const i18n = createServerI18n({
+ *   project: "acme/dashboard",
+ *   defaultLocale: "en",
+ * });
+ *
+ * export const auth = betterAuth({
+ *   plugins: [
+ *     createBetterAuthProvider(i18n),
+ *   ],
+ * });
+ * ```
+ */
+export function createBetterAuthProvider(i18n, options) {
+    const namespace = options?.namespace ?? "auth";
+    const warnOnMissing = options?.warnOnMissingKeys ?? true;
+    return {
+        id: "better-i18n",
+        hooks: {
+            after: [
+                {
+                    matcher: () => true,
+                    handler: async (ctx) => {
+                        const returned = ctx.context.returned;
+                        // Only intercept APIError responses that carry an error code
+                        if (!isAPIErrorLike(returned))
+                            return;
+                        const { body } = returned;
+                        const errorCode = body.code;
+                        // ── Detect locale ──────────────────────────────────────
+                        let locale;
+                        try {
+                            if (options?.getLocale) {
+                                locale = await options.getLocale({ headers: ctx.headers });
+                            }
+                            else if (ctx.headers) {
+                                locale = await i18n.detectLocaleFromHeaders(ctx.headers);
+                            }
+                            else {
+                                locale = i18n.config.defaultLocale;
+                            }
+                        }
+                        catch {
+                            // Locale detection failed — keep original message
+                            return;
+                        }
+                        // ── Translate ──────────────────────────────────────────
+                        try {
+                            const t = await i18n.getTranslator(locale, namespace);
+                            const translated = t(errorCode);
+                            // use-intl returns "namespace.key" for missing keys (default
+                            // getMessageFallback). Detect this to avoid replacing a
+                            // readable message with a raw fallback string.
+                            const isFallback = translated === errorCode ||
+                                translated === `${namespace}.${errorCode}`;
+                            if (!isFallback && translated) {
+                                body.message = translated;
+                                // Also update Error.message for consistent logging
+                                // eslint-disable-next-line @typescript-eslint/no-explicit-any -- APIError.message is writable
+                                returned.message = translated;
+                            }
+                            else if (warnOnMissing) {
+                                console.warn(`[better-i18n] Missing auth translation: "${errorCode}" (locale: ${locale}, namespace: ${namespace})`);
+                            }
+                        }
+                        catch {
+                            // CDN fetch failed or namespace missing — keep original message.
+                            // Auth must never break because of i18n.
+                        }
+                    },
+                },
+            ],
+        },
+    };
+}
+// ---------------------------------------------------------------------------
+// Default English keys for Better Auth core error codes.
+//
+// Seed your Better i18n project's "auth" namespace with these keys,
+// then translate them from the dashboard. Use with MCP `createKeys` tool
+// or import in your seed script.
+//
+// These cover Better Auth core only. Plugin-specific error codes
+// (admin, two-factor, email-otp, etc.) can be added as separate keys.
+// ---------------------------------------------------------------------------
+/**
+ * All Better Auth core error codes with their default English messages.
+ * Use these to seed your project's "auth" namespace.
+ *
+ * @example
+ * ```ts
+ * import { DEFAULT_AUTH_KEYS } from "@better-i18n/server/providers/better-auth";
+ *
+ * // Seed via MCP createKeys tool
+ * for (const [key, message] of Object.entries(DEFAULT_AUTH_KEYS)) {
+ *   await createKey({ namespace: "auth", key, translations: { en: message } });
+ * }
+ * ```
+ */
+export const DEFAULT_AUTH_KEYS = {
+    // ── Authentication ─────────────────────────────────────────────────
+    INVALID_EMAIL_OR_PASSWORD: "Invalid email or password",
+    INVALID_PASSWORD: "Invalid password",
+    INVALID_EMAIL: "Invalid email",
+    INVALID_TOKEN: "Invalid token",
+    TOKEN_EXPIRED: "Token expired",
+    EMAIL_NOT_VERIFIED: "Email not verified",
+    EMAIL_ALREADY_VERIFIED: "Email is already verified",
+    EMAIL_MISMATCH: "Email mismatch",
+    // ── User management ────────────────────────────────────────────────
+    USER_NOT_FOUND: "User not found",
+    USER_ALREADY_EXISTS: "User already exists.",
+    USER_ALREADY_EXISTS_USE_ANOTHER_EMAIL: "User already exists. Use another email.",
+    INVALID_USER: "Invalid user",
+    USER_EMAIL_NOT_FOUND: "User email not found",
+    USER_ALREADY_HAS_PASSWORD: "User already has a password. Provide that to delete the account.",
+    FAILED_TO_CREATE_USER: "Failed to create user",
+    FAILED_TO_UPDATE_USER: "Failed to update user",
+    FAILED_TO_GET_USER_INFO: "Failed to get user info",
+    // ── Session ────────────────────────────────────────────────────────
+    SESSION_EXPIRED: "Session expired. Re-authenticate to perform this action.",
+    SESSION_NOT_FRESH: "Session is not fresh",
+    FAILED_TO_CREATE_SESSION: "Failed to create session",
+    FAILED_TO_GET_SESSION: "Failed to get session",
+    // ── Password ───────────────────────────────────────────────────────
+    PASSWORD_TOO_SHORT: "Password too short",
+    PASSWORD_TOO_LONG: "Password too long",
+    PASSWORD_ALREADY_SET: "User already has a password set",
+    CREDENTIAL_ACCOUNT_NOT_FOUND: "Credential account not found",
+    // ── Account & Social ──────────────────────────────────────────────
+    ACCOUNT_NOT_FOUND: "Account not found",
+    SOCIAL_ACCOUNT_ALREADY_LINKED: "Social account already linked",
+    LINKED_ACCOUNT_ALREADY_EXISTS: "Linked account already exists",
+    FAILED_TO_UNLINK_LAST_ACCOUNT: "You can't unlink your last account",
+    PROVIDER_NOT_FOUND: "Provider not found",
+    ID_TOKEN_NOT_SUPPORTED: "id_token not supported",
+    // ── Email verification ─────────────────────────────────────────────
+    VERIFICATION_EMAIL_NOT_ENABLED: "Verification email isn't enabled",
+    EMAIL_CAN_NOT_BE_UPDATED: "Email can not be updated",
+    FAILED_TO_CREATE_VERIFICATION: "Unable to create verification",
+    // ── URL validation ─────────────────────────────────────────────────
+    INVALID_ORIGIN: "Invalid origin",
+    INVALID_CALLBACK_URL: "Invalid callbackURL",
+    INVALID_REDIRECT_URL: "Invalid redirectURL",
+    INVALID_ERROR_CALLBACK_URL: "Invalid errorCallbackURL",
+    INVALID_NEW_USER_CALLBACK_URL: "Invalid newUserCallbackURL",
+    MISSING_OR_NULL_ORIGIN: "Missing or null Origin",
+    CALLBACK_URL_REQUIRED: "callbackURL is required",
+    // ── Security ───────────────────────────────────────────────────────
+    CROSS_SITE_NAVIGATION_LOGIN_BLOCKED: "Cross-site navigation login blocked. This request appears to be a CSRF attack.",
+    // ── Validation ─────────────────────────────────────────────────────
+    VALIDATION_ERROR: "Validation Error",
+    MISSING_FIELD: "Field is required",
+    FIELD_NOT_ALLOWED: "Field not allowed to be set",
+    ASYNC_VALIDATION_NOT_SUPPORTED: "Async validation is not supported",
+    BODY_MUST_BE_AN_OBJECT: "Body must be an object",
+    METHOD_NOT_ALLOWED_DEFER_SESSION_REQUIRED: "POST method requires deferSessionRefresh to be enabled in session config",
+};
+//# sourceMappingURL=better-auth.js.map

package/dist/providers/better-auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"better-auth.js","sourceRoot":"","sources":["../../src/providers/better-auth.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-i18n/server",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Framework-agnostic server-side i18n for Better i18n (Hono, Express, Fastify)",
   "license": "MIT",
   "repository": {
@@ -31,6 +31,11 @@
       "bun": "./src/node.ts",
       "default": "./dist/node.js"
     },
+    "./providers/better-auth": {
+      "types": "./dist/providers/better-auth.d.ts",
+      "bun": "./src/providers/better-auth.ts",
+      "default": "./dist/providers/better-auth.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -49,7 +54,10 @@
     "express",
     "fastify",
     "server",
-    "middleware"
+    "middleware",
+    "better-auth",
+    "auth",
+    "localization"
   ],
   "scripts": {
     "build": "tsc",
@@ -59,7 +67,7 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@better-i18n/core": "0.2.0",
+    "@better-i18n/core": "0.6.1",
     "use-intl": ">=4.0.0"
   },
   "peerDependencies": {