@better-i18n/server 0.2.0

package/dist/hono.d.ts

@@ -0,0 +1,32 @@
+import type { MiddlewareHandler } from "hono";
+import type { ServerI18n, Translator } from "./types.js";
+/**
+ * Hono middleware that injects `locale` and `t` into the context variables.
+ *
+ * Hono uses Web Standards natively (`c.req.raw.headers` is a `Headers` object),
+ * so no adapter layer is needed — unlike Express/Fastify.
+ *
+ * @example
+ * ```ts
+ * import { Hono } from "hono";
+ * import { betterI18n } from "@better-i18n/server/hono";
+ * import { i18n } from "./i18n"; // createServerI18n singleton
+ *
+ * const app = new Hono<{
+ *   Variables: {
+ *     locale: string;
+ *     t: Translator;
+ *   }
+ * }>();
+ *
+ * app.use("*", betterI18n(i18n));
+ *
+ * app.get("/users/:id", (c) => {
+ *   const t = c.get("t");
+ *   return c.json({ error: t("errors.notFound") }, 404);
+ * });
+ * ```
+ */
+export declare function betterI18n(i18n: ServerI18n): MiddlewareHandler;
+export type { Translator };
+//# sourceMappingURL=hono.d.ts.map

package/dist/hono.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAW9D;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/hono.js

@@ -0,0 +1,38 @@
+/**
+ * Hono middleware that injects `locale` and `t` into the context variables.
+ *
+ * Hono uses Web Standards natively (`c.req.raw.headers` is a `Headers` object),
+ * so no adapter layer is needed — unlike Express/Fastify.
+ *
+ * @example
+ * ```ts
+ * import { Hono } from "hono";
+ * import { betterI18n } from "@better-i18n/server/hono";
+ * import { i18n } from "./i18n"; // createServerI18n singleton
+ *
+ * const app = new Hono<{
+ *   Variables: {
+ *     locale: string;
+ *     t: Translator;
+ *   }
+ * }>();
+ *
+ * app.use("*", betterI18n(i18n));
+ *
+ * app.get("/users/:id", (c) => {
+ *   const t = c.get("t");
+ *   return c.json({ error: t("errors.notFound") }, 404);
+ * });
+ * ```
+ */
+export function betterI18n(i18n) {
+    return async (c, next) => {
+        // Hono is Web Standards — c.req.raw.headers is already a Headers object
+        const locale = await i18n.detectLocaleFromHeaders(c.req.raw.headers);
+        const t = await i18n.getTranslator(locale);
+        c.set("locale", locale);
+        c.set("t", t);
+        await next();
+    };
+}
+//# sourceMappingURL=hono.js.map

package/dist/hono.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hono.js","sourceRoot":"","sources":["../src/hono.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,UAAU,CAAC,IAAgB;IACzC,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,wEAAwE;QACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACrE,MAAM,CAAC,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAE3C,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACxB,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAEd,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import type { ServerI18n, ServerI18nConfig } from "./types.js";
+export type { ServerI18n, ServerI18nConfig, Translator } from "./types.js";
+/**
+ * Create a server-side i18n instance.
+ *
+ * Intended to be instantiated once at module scope (singleton pattern) so that
+ * the underlying TtlCache is shared across all requests — avoiding redundant CDN
+ * fetches on every request.
+ *
+ * @example
+ * ```ts
+ * // server.ts (module scope — singleton)
+ * import { createServerI18n } from "@better-i18n/server";
+ *
+ * export const i18n = createServerI18n({
+ *   project: "acme/api",
+ *   defaultLocale: "en",
+ * });
+ *
+ * // route handler
+ * const t = await i18n.getTranslator("tr");
+ * t("errors.notFound"); // → "Bulunamadı"
+ * ```
+ */
+export declare function createServerI18n(config: ServerI18nConfig): ServerI18n;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE/D,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU,CA2BrE"}

package/dist/index.js

@@ -0,0 +1,51 @@
+import { createI18nCore } from "@better-i18n/core";
+import { createTranslator } from "use-intl/core";
+import { parseAcceptLanguage, matchLocale } from "./utils/accept-language.js";
+/**
+ * Create a server-side i18n instance.
+ *
+ * Intended to be instantiated once at module scope (singleton pattern) so that
+ * the underlying TtlCache is shared across all requests — avoiding redundant CDN
+ * fetches on every request.
+ *
+ * @example
+ * ```ts
+ * // server.ts (module scope — singleton)
+ * import { createServerI18n } from "@better-i18n/server";
+ *
+ * export const i18n = createServerI18n({
+ *   project: "acme/api",
+ *   defaultLocale: "en",
+ * });
+ *
+ * // route handler
+ * const t = await i18n.getTranslator("tr");
+ * t("errors.notFound"); // → "Bulunamadı"
+ * ```
+ */
+export function createServerI18n(config) {
+    const core = createI18nCore(config);
+    async function getTranslator(locale, namespace) {
+        const messages = await core.getMessages(locale);
+        return createTranslator({
+            locale,
+            messages: messages,
+            namespace,
+        });
+    }
+    async function detectLocaleFromHeaders(headers) {
+        const availableLocales = await core.getLocales();
+        const acceptLanguage = headers.get("accept-language");
+        const parsed = parseAcceptLanguage(acceptLanguage);
+        const matched = matchLocale(parsed, availableLocales);
+        return matched ?? config.defaultLocale;
+    }
+    return {
+        config: core.config,
+        getTranslator,
+        detectLocaleFromHeaders,
+        getLocales: core.getLocales.bind(core),
+        getLanguages: core.getLanguages.bind(core),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAK9E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAwB;IACvD,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEpC,KAAK,UAAU,aAAa,CAAC,MAAc,EAAE,SAAkB;QAC7D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAChD,OAAO,gBAAgB,CAAC;YACtB,MAAM;YACN,QAAQ,EAAE,QAA8D;YACxE,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,KAAK,UAAU,uBAAuB,CAAC,OAAgB;QACrD,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACjD,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACtD,OAAO,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC;IACzC,CAAC;IAED,OAAO;QACL,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,aAAa;QACb,uBAAuB;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QACtC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;KAC3C,CAAC;AACJ,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,54 @@
+import type { IncomingHttpHeaders } from "node:http";
+import type { ServerI18n, Translator } from "./types.js";
+/**
+ * Convert Node.js `IncomingHttpHeaders` (from `http.IncomingMessage`) to a
+ * Web Standards `Headers` object.
+ *
+ * This mirrors the pattern used by better-auth's `fromNodeHeaders()` utility,
+ * enabling the framework-agnostic `ServerI18n` API to work in Express, Fastify,
+ * Koa, and any other Node.js HTTP server.
+ *
+ * @example
+ * ```ts
+ * import { fromNodeHeaders } from "@better-i18n/server/node";
+ *
+ * // Fastify / Koa — manual usage
+ * const headers = fromNodeHeaders(req.headers);
+ * const locale = await i18n.detectLocaleFromHeaders(headers);
+ * ```
+ */
+export declare function fromNodeHeaders(nodeHeaders: IncomingHttpHeaders): Headers;
+/**
+ * Express/Connect-compatible middleware that injects `req.locale` and `req.t`
+ * into every request.
+ *
+ * @example
+ * ```ts
+ * import express from "express";
+ * import { betterI18nMiddleware } from "@better-i18n/server/node";
+ * import { i18n } from "./i18n"; // createServerI18n singleton
+ *
+ * const app = express();
+ * app.use(betterI18nMiddleware(i18n));
+ *
+ * app.get("/users/:id", (req, res) => {
+ *   res.json({ error: req.t("errors.notFound") });
+ * });
+ * ```
+ *
+ * TypeScript augmentation (add to a .d.ts file in your project):
+ * ```ts
+ * import { Translator } from "@better-i18n/server";
+ * declare global {
+ *   namespace Express {
+ *     interface Request {
+ *       locale: string;
+ *       t: Translator;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare function betterI18nMiddleware(i18n: ServerI18n): (req: any, _res: any, next: () => void) => Promise<void>;
+export type { Translator };
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +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"}

package/dist/node.js

@@ -0,0 +1,68 @@
+/**
+ * Convert Node.js `IncomingHttpHeaders` (from `http.IncomingMessage`) to a
+ * Web Standards `Headers` object.
+ *
+ * This mirrors the pattern used by better-auth's `fromNodeHeaders()` utility,
+ * enabling the framework-agnostic `ServerI18n` API to work in Express, Fastify,
+ * Koa, and any other Node.js HTTP server.
+ *
+ * @example
+ * ```ts
+ * import { fromNodeHeaders } from "@better-i18n/server/node";
+ *
+ * // Fastify / Koa — manual usage
+ * const headers = fromNodeHeaders(req.headers);
+ * const locale = await i18n.detectLocaleFromHeaders(headers);
+ * ```
+ */
+export function fromNodeHeaders(nodeHeaders) {
+    const headers = new Headers();
+    for (const [key, value] of Object.entries(nodeHeaders)) {
+        if (value === undefined)
+            continue;
+        headers.set(key, Array.isArray(value) ? value.join(", ") : value);
+    }
+    return headers;
+}
+/**
+ * Express/Connect-compatible middleware that injects `req.locale` and `req.t`
+ * into every request.
+ *
+ * @example
+ * ```ts
+ * import express from "express";
+ * import { betterI18nMiddleware } from "@better-i18n/server/node";
+ * import { i18n } from "./i18n"; // createServerI18n singleton
+ *
+ * const app = express();
+ * app.use(betterI18nMiddleware(i18n));
+ *
+ * app.get("/users/:id", (req, res) => {
+ *   res.json({ error: req.t("errors.notFound") });
+ * });
+ * ```
+ *
+ * TypeScript augmentation (add to a .d.ts file in your project):
+ * ```ts
+ * import { Translator } from "@better-i18n/server";
+ * declare global {
+ *   namespace Express {
+ *     interface Request {
+ *       locale: string;
+ *       t: Translator;
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export function betterI18nMiddleware(i18n) {
+    return async (req, _res, next) => {
+        const headers = fromNodeHeaders(req.headers);
+        const locale = await i18n.detectLocaleFromHeaders(headers);
+        const t = await i18n.getTranslator(locale);
+        req.locale = locale;
+        req.t = t;
+        next();
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +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"}

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+import type { I18nCoreConfig, LanguageOption } from "@better-i18n/core";
+import type { createTranslator } from "use-intl/core";
+/**
+ * Translator function returned by getTranslator()
+ * Thin alias for the use-intl/core createTranslator return type
+ */
+export type Translator = ReturnType<typeof createTranslator>;
+/**
+ * Configuration for createServerI18n() — mirrors I18nCoreConfig exactly
+ */
+export type ServerI18nConfig = I18nCoreConfig;
+/**
+ * Server-side i18n instance returned by createServerI18n()
+ */
+export interface ServerI18n {
+    /**
+     * Resolved configuration
+     */
+    config: I18nCoreConfig;
+    /**
+     * Get a translator function for the given locale.
+     * Messages are fetched and cached via TtlCache.
+     */
+    getTranslator(locale: string, namespace?: string): Promise<Translator>;
+    /**
+     * Detect the best-matching locale from Web Standards Headers object.
+     * Uses Accept-Language header and falls back to defaultLocale.
+     */
+    detectLocaleFromHeaders(headers: Headers): Promise<string>;
+    /**
+     * Get available locale codes from the CDN manifest
+     */
+    getLocales(): Promise<string[]>;
+    /**
+     * Get language options with metadata (for responses, UI, etc.)
+     */
+    getLanguages(): Promise<LanguageOption[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,MAAM,EAAE,cAAc,CAAC;IAEvB;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvE;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAE3D;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhC;;OAEG;IACH,YAAY,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;CAC3C"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/accept-language.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Parse an RFC 5646 Accept-Language header value into a prioritized list of language tags.
+ *
+ * @example
+ * parseAcceptLanguage("tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7")
+ * // → ["tr-TR", "tr", "en-US", "en"]
+ *
+ * parseAcceptLanguage("*")
+ * // → []
+ *
+ * parseAcceptLanguage(null)
+ * // → []
+ */
+export declare function parseAcceptLanguage(header: string | null | undefined): string[];
+/**
+ * Find the best matching locale from a parsed Accept-Language list against available locales.
+ * Matching strategy (in order):
+ * 1. Exact match: "tr-TR" → "tr-TR"
+ * 2. Base language match: "tr-TR" → "tr"
+ * 3. Region expansion: "tr" matches "tr-TR" (first available variant)
+ *
+ * Returns null if no match found.
+ */
+export declare function matchLocale(languages: string[], availableLocales: string[]): string | null;
+//# sourceMappingURL=accept-language.d.ts.map

package/dist/utils/accept-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept-language.d.ts","sourceRoot":"","sources":["../../src/utils/accept-language.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAqB/E;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EAAE,EACnB,gBAAgB,EAAE,MAAM,EAAE,GACzB,MAAM,GAAG,IAAI,CAiBf"}

package/dist/utils/accept-language.js

@@ -0,0 +1,58 @@
+/**
+ * Parse an RFC 5646 Accept-Language header value into a prioritized list of language tags.
+ *
+ * @example
+ * parseAcceptLanguage("tr-TR,tr;q=0.9,en-US;q=0.8,en;q=0.7")
+ * // → ["tr-TR", "tr", "en-US", "en"]
+ *
+ * parseAcceptLanguage("*")
+ * // → []
+ *
+ * parseAcceptLanguage(null)
+ * // → []
+ */
+export function parseAcceptLanguage(header) {
+    if (!header)
+        return [];
+    return (header
+        .split(",")
+        .map((entry) => {
+        const [tag, qPart] = entry.trim().split(";");
+        const language = tag?.trim();
+        if (!language || language === "*")
+            return null;
+        const q = qPart ? parseFloat(qPart.trim().replace("q=", "")) : 1.0;
+        const quality = Number.isNaN(q) ? 1.0 : q;
+        return { language, quality };
+    })
+        .filter((item) => item !== null)
+        // Stable sort: higher quality first; equal quality preserves original order
+        .sort((a, b) => b.quality - a.quality)
+        .map((item) => item.language));
+}
+/**
+ * Find the best matching locale from a parsed Accept-Language list against available locales.
+ * Matching strategy (in order):
+ * 1. Exact match: "tr-TR" → "tr-TR"
+ * 2. Base language match: "tr-TR" → "tr"
+ * 3. Region expansion: "tr" matches "tr-TR" (first available variant)
+ *
+ * Returns null if no match found.
+ */
+export function matchLocale(languages, availableLocales) {
+    for (const lang of languages) {
+        // 1. Exact match
+        if (availableLocales.includes(lang))
+            return lang;
+        // 2. Base language match (strip region subtag)
+        const base = lang.split("-")[0];
+        if (base && availableLocales.includes(base))
+            return base;
+        // 3. Region expansion: find first available locale that starts with base
+        const expanded = availableLocales.find((l) => l === base || l.startsWith(`${base}-`));
+        if (expanded)
+            return expanded;
+    }
+    return null;
+}
+//# sourceMappingURL=accept-language.js.map

package/dist/utils/accept-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accept-language.js","sourceRoot":"","sources":["../../src/utils/accept-language.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAiC;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvB,OAAO,CACL,MAAM;SACH,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAE/C,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAE1C,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,IAAI,EAAiD,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;QAC/E,4EAA4E;SAC3E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;SACrC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAChC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CACzB,SAAmB,EACnB,gBAA0B;IAE1B,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC7B,iBAAiB;QACjB,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAEjD,+CAA+C;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,IAAI,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAEzD,yEAAyE;QACzE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAC9C,CAAC;QACF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@better-i18n/server",
+  "version": "0.2.0",
+  "description": "Framework-agnostic server-side i18n for Better i18n (Hono, Express, Fastify)",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/better-i18n/better-i18n.git",
+    "directory": "packages/server"
+  },
+  "bugs": {
+    "url": "https://github.com/better-i18n/better-i18n/issues"
+  },
+  "homepage": "https://github.com/better-i18n/better-i18n/tree/main/packages/server",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./dist/index.js"
+    },
+    "./hono": {
+      "types": "./dist/hono.d.ts",
+      "bun": "./src/hono.ts",
+      "default": "./dist/hono.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "bun": "./src/node.ts",
+      "default": "./dist/node.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "i18n",
+    "localization",
+    "internationalization",
+    "hono",
+    "express",
+    "fastify",
+    "server",
+    "middleware"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "bun run build",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@better-i18n/core": "0.2.0",
+    "use-intl": ">=4.0.0"
+  },
+  "peerDependencies": {
+    "hono": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "hono": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "hono": "^4.0.0",
+    "typescript": "~5.9.2",
+    "vitest": "^3.0.0"
+  }
+}