@better-i18n/next 0.5.2 → 0.5.3

package/dist/client.d.ts

@@ -0,0 +1,99 @@
+import { type ReactNode } from "react";
+import type { LanguageOption, Messages } from "@better-i18n/core";
+import type { I18nConfig } from "./types.js";
+export interface BetterI18nProviderProps {
+    /** Initial locale from server (getLocale()) */
+    locale: string;
+    /** Initial messages from server (getMessages()) */
+    messages: Messages;
+    /** i18n config — only project and defaultLocale are required */
+    config: I18nConfig;
+    children: ReactNode;
+}
+/**
+ * Provider that wraps `NextIntlClientProvider` and enables instant locale
+ * switching without a server round-trip.
+ *
+ * When `useSetLocale()` is called inside this provider, it:
+ * 1. Sets a cookie (for server-side persistence on next navigation)
+ * 2. Fetches new messages from CDN on the client
+ * 3. Re-renders the tree with new locale + messages instantly
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { BetterI18nProvider } from '@better-i18n/next/client'
+ *
+ * export default async function RootLayout({ children }) {
+ *   const locale = await getLocale()
+ *   const messages = await getMessages()
+ *
+ *   return (
+ *     <BetterI18nProvider
+ *       locale={locale}
+ *       messages={messages}
+ *       config={{ project: 'acme/dashboard', defaultLocale: 'en' }}
+ *     >
+ *       {children}
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ * ```
+ */
+export declare function BetterI18nProvider({ locale: initialLocale, messages: initialMessages, config, children, }: BetterI18nProviderProps): import("react/jsx-runtime").JSX.Element;
+export type UseManifestLanguagesResult = {
+    languages: LanguageOption[];
+    isLoading: boolean;
+    error: Error | null;
+};
+/**
+ * React hook to fetch manifest languages on the client
+ *
+ * Uses `createI18nCore` from `@better-i18n/core` internally with
+ * request deduplication to prevent duplicate fetches.
+ *
+ * @example
+ * ```tsx
+ * const { languages, isLoading, error } = useManifestLanguages({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ * })
+ *
+ * if (isLoading) return <Spinner />
+ * if (error) return <Error message={error.message} />
+ *
+ * return (
+ *   <select>
+ *     {languages.map(lang => (
+ *       <option key={lang.code} value={lang.code}>
+ *         {lang.nativeName || lang.name || lang.code}
+ *       </option>
+ *     ))}
+ *   </select>
+ * )
+ * ```
+ */
+export declare const useManifestLanguages: (config: I18nConfig) => UseManifestLanguagesResult;
+/**
+ * React hook that returns a function to switch the active locale.
+ *
+ * - **With `BetterI18nProvider`**: Fetches new messages client-side from CDN
+ *   and updates the UI instantly — no page refresh needed.
+ * - **Without provider (standalone)**: Pass a config object. Sets a cookie and
+ *   calls `router.refresh()` for a soft server re-render.
+ *
+ * @example With provider (recommended — instant switching)
+ * ```tsx
+ * // Wrap your layout with BetterI18nProvider, then:
+ * const setLocale = useSetLocale()
+ * <button onClick={() => setLocale('tr')}>Türkçe</button>
+ * ```
+ *
+ * @example Standalone (soft refresh)
+ * ```tsx
+ * const setLocale = useSetLocale({ project: 'acme/dashboard', defaultLocale: 'en' })
+ * <button onClick={() => setLocale('tr')}>Türkçe</button>
+ * ```
+ */
+export declare function useSetLocale(config?: I18nConfig): (locale: string) => void;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAU7C,MAAM,WAAW,uBAAuB;IACtC,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,QAAQ,EAAE,QAAQ,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,eAAe,EACzB,MAAM,EACN,QAAQ,GACT,EAAE,uBAAuB,2CAqDzB;AAID,MAAM,MAAM,0BAA0B,GAAG;IACvC,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,UAAU,KAAG,0BAuFzD,CAAC;AAIF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAkB1E"}

package/dist/client.js

@@ -0,0 +1,230 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useEffect, useMemo, useState, } from "react";
+import { useRouter } from "next/navigation";
+import { NextIntlClientProvider } from "next-intl";
+import { createI18nCore, parseProject } from "@better-i18n/core";
+import { normalizeConfig } from "./config.js";
+const BetterI18nContext = createContext(null);
+/**
+ * Provider that wraps `NextIntlClientProvider` and enables instant locale
+ * switching without a server round-trip.
+ *
+ * When `useSetLocale()` is called inside this provider, it:
+ * 1. Sets a cookie (for server-side persistence on next navigation)
+ * 2. Fetches new messages from CDN on the client
+ * 3. Re-renders the tree with new locale + messages instantly
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { BetterI18nProvider } from '@better-i18n/next/client'
+ *
+ * export default async function RootLayout({ children }) {
+ *   const locale = await getLocale()
+ *   const messages = await getMessages()
+ *
+ *   return (
+ *     <BetterI18nProvider
+ *       locale={locale}
+ *       messages={messages}
+ *       config={{ project: 'acme/dashboard', defaultLocale: 'en' }}
+ *     >
+ *       {children}
+ *     </BetterI18nProvider>
+ *   )
+ * }
+ * ```
+ */
+export function BetterI18nProvider({ locale: initialLocale, messages: initialMessages, config, children, }) {
+    const normalized = useMemo(() => normalizeConfig(config), [
+        config.project,
+        config.defaultLocale,
+        config.cookieName,
+        config.cdnBaseUrl,
+    ]);
+    const [locale, setLocaleState] = useState(initialLocale);
+    const [messages, setMessages] = useState(initialMessages);
+    // Sync with server-provided values when they change (e.g. navigation to a new page)
+    useEffect(() => {
+        setLocaleState(initialLocale);
+        setMessages(initialMessages);
+    }, [initialLocale, initialMessages]);
+    const setLocale = useCallback(async (newLocale) => {
+        if (newLocale === locale)
+            return;
+        // 1. Set cookie for server-side persistence
+        document.cookie = `${normalized.cookieName}=${newLocale}; path=/; max-age=31536000; samesite=lax`;
+        // 2. Fetch new messages from CDN
+        const { workspaceId, projectSlug } = parseProject(normalized.project);
+        const cdnBase = normalized.cdnBaseUrl || "https://cdn.better-i18n.com";
+        const url = `${cdnBase}/${workspaceId}/${projectSlug}/${newLocale}/translations.json`;
+        try {
+            const res = await fetch(url);
+            if (!res.ok)
+                throw new Error(`HTTP ${res.status}`);
+            const newMessages = await res.json();
+            // 3. Instant client-side update — no server round-trip
+            setLocaleState(newLocale);
+            setMessages(newMessages);
+        }
+        catch (err) {
+            console.error("[better-i18n] Client-side locale switch failed, falling back to refresh:", err);
+            // Fallback: let the server handle it
+            window.location.reload();
+        }
+    }, [locale, normalized]);
+    return (_jsx(BetterI18nContext.Provider, { value: { setLocale }, children: _jsx(NextIntlClientProvider, { locale: locale, messages: messages, children: children }) }));
+}
+// Client-side request deduplication cache
+const clientCache = new Map();
+const getCacheKey = (project, cdnBaseUrl) => `${cdnBaseUrl || "https://cdn.better-i18n.com"}|${project}`;
+/**
+ * React hook to fetch manifest languages on the client
+ *
+ * Uses `createI18nCore` from `@better-i18n/core` internally with
+ * request deduplication to prevent duplicate fetches.
+ *
+ * @example
+ * ```tsx
+ * const { languages, isLoading, error } = useManifestLanguages({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ * })
+ *
+ * if (isLoading) return <Spinner />
+ * if (error) return <Error message={error.message} />
+ *
+ * return (
+ *   <select>
+ *     {languages.map(lang => (
+ *       <option key={lang.code} value={lang.code}>
+ *         {lang.nativeName || lang.name || lang.code}
+ *       </option>
+ *     ))}
+ *   </select>
+ * )
+ * ```
+ */
+export const useManifestLanguages = (config) => {
+    const normalized = useMemo(() => normalizeConfig(config), [
+        config.project,
+        config.defaultLocale,
+        config.cdnBaseUrl,
+        config.debug,
+        config.logLevel,
+    ]);
+    const i18nCore = useMemo(() => createI18nCore({
+        project: normalized.project,
+        defaultLocale: normalized.defaultLocale,
+        cdnBaseUrl: normalized.cdnBaseUrl,
+        debug: normalized.debug,
+        logLevel: normalized.logLevel,
+    }), [normalized]);
+    const cacheKey = getCacheKey(normalized.project, normalized.cdnBaseUrl);
+    const cached = clientCache.get(cacheKey);
+    const [languages, setLanguages] = useState(cached?.data ?? []);
+    const [isLoading, setIsLoading] = useState(!cached?.data);
+    const [error, setError] = useState(cached?.error ?? null);
+    useEffect(() => {
+        let isMounted = true;
+        const run = async () => {
+            const entry = clientCache.get(cacheKey) ?? {};
+            // Return cached data if available
+            if (entry.data) {
+                if (isMounted) {
+                    setLanguages(entry.data);
+                    setIsLoading(false);
+                }
+                return;
+            }
+            // Deduplicate in-flight requests
+            if (!entry.promise) {
+                entry.promise = i18nCore
+                    .getLanguages()
+                    .then((langs) => {
+                    clientCache.set(cacheKey, { data: langs });
+                    return langs;
+                })
+                    .catch((err) => {
+                    const error = err instanceof Error ? err : new Error(String(err));
+                    clientCache.set(cacheKey, { error });
+                    throw error;
+                });
+                clientCache.set(cacheKey, entry);
+            }
+            try {
+                const langs = await entry.promise;
+                if (isMounted) {
+                    setLanguages(langs);
+                    setError(null);
+                }
+            }
+            catch (err) {
+                if (isMounted) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            finally {
+                if (isMounted) {
+                    setIsLoading(false);
+                }
+            }
+        };
+        run();
+        return () => {
+            isMounted = false;
+        };
+    }, [cacheKey, i18nCore]);
+    return { languages, isLoading, error };
+};
+// ─── useSetLocale ────────────────────────────────────────────────────
+/**
+ * React hook that returns a function to switch the active locale.
+ *
+ * - **With `BetterI18nProvider`**: Fetches new messages client-side from CDN
+ *   and updates the UI instantly — no page refresh needed.
+ * - **Without provider (standalone)**: Pass a config object. Sets a cookie and
+ *   calls `router.refresh()` for a soft server re-render.
+ *
+ * @example With provider (recommended — instant switching)
+ * ```tsx
+ * // Wrap your layout with BetterI18nProvider, then:
+ * const setLocale = useSetLocale()
+ * <button onClick={() => setLocale('tr')}>Türkçe</button>
+ * ```
+ *
+ * @example Standalone (soft refresh)
+ * ```tsx
+ * const setLocale = useSetLocale({ project: 'acme/dashboard', defaultLocale: 'en' })
+ * <button onClick={() => setLocale('tr')}>Türkçe</button>
+ * ```
+ */
+export function useSetLocale(config) {
+    const ctx = useContext(BetterI18nContext);
+    // If BetterI18nProvider is in the tree, use instant client-side switching
+    if (ctx) {
+        return ctx.setLocale;
+    }
+    // Standalone fallback: cookie + router.refresh()
+    if (!config) {
+        throw new Error("[better-i18n] useSetLocale() requires either a <BetterI18nProvider> ancestor " +
+            "or a config argument. Use useSetLocale({ project, defaultLocale }) for standalone mode.");
+    }
+    // eslint-disable-next-line react-hooks/rules-of-hooks
+    return useStandaloneSetLocale(config);
+}
+/** Internal standalone hook — cookie + router.refresh() */
+function useStandaloneSetLocale(config) {
+    const normalized = useMemo(() => normalizeConfig(config), [
+        config.project,
+        config.defaultLocale,
+        config.cookieName,
+    ]);
+    const router = useRouter();
+    return useCallback((locale) => {
+        document.cookie = `${normalized.cookieName}=${locale}; path=/; max-age=31536000; samesite=lax`;
+        router.refresh();
+    }, [normalized.cookieName, router]);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,12 @@
+import { parseProject } from "@better-i18n/core";
+import type { I18nConfig, NormalizedConfig } from "./types.js";
+export { parseProject };
+/**
+ * Normalize Next.js i18n config with defaults
+ */
+export declare const normalizeConfig: (config: I18nConfig) => NormalizedConfig;
+/**
+ * Get the project base URL on CDN
+ */
+export declare const getProjectBaseUrl: (config: NormalizedConfig) => string;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe,GAAI,QAAQ,UAAU,KAAG,gBAoBpD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,gBAAgB,KAAG,MAC9B,CAAC"}

package/dist/config.js

@@ -0,0 +1,31 @@
+import { parseProject, getProjectBaseUrl as coreGetProjectBaseUrl, normalizeConfig as coreNormalizeConfig, } from "@better-i18n/core";
+// Re-export parseProject from core
+export { parseProject };
+/**
+ * Normalize Next.js i18n config with defaults
+ */
+export const normalizeConfig = (config) => {
+    // Use core normalization for base config
+    const coreConfig = coreNormalizeConfig({
+        project: config.project,
+        defaultLocale: config.defaultLocale,
+        cdnBaseUrl: config.cdnBaseUrl,
+        manifestCacheTtlMs: config.manifestCacheTtlMs,
+        debug: config.debug,
+        logLevel: config.logLevel,
+        fetch: config.fetch,
+    });
+    // Add Next.js-specific defaults
+    return {
+        ...coreConfig,
+        localePrefix: config.localePrefix ?? "as-needed",
+        cookieName: config.cookieName ?? "locale",
+        manifestRevalidateSeconds: config.manifestRevalidateSeconds ?? 3600,
+        messagesRevalidateSeconds: config.messagesRevalidateSeconds ?? 30,
+    };
+};
+/**
+ * Get the project base URL on CDN
+ */
+export const getProjectBaseUrl = (config) => coreGetProjectBaseUrl(config);
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,iBAAiB,IAAI,qBAAqB,EAC1C,eAAe,IAAI,mBAAmB,GACvC,MAAM,mBAAmB,CAAC;AAG3B,mCAAmC;AACnC,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAkB,EAAoB,EAAE;IACtE,yCAAyC;IACzC,MAAM,UAAU,GAAG,mBAAmB,CAAC;QACrC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,kBAAkB,EAAE,MAAM,CAAC,kBAAkB;QAC7C,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;KACpB,CAAC,CAAC;IAEH,gCAAgC;IAChC,OAAO;QACL,GAAG,UAAU;QACb,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,WAAW;QAChD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,QAAQ;QACzC,yBAAyB,EAAE,MAAM,CAAC,yBAAyB,IAAI,IAAI;QACnE,yBAAyB,EAAE,MAAM,CAAC,yBAAyB,IAAI,EAAE;KAClE,CAAC;AACJ,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,MAAwB,EAAU,EAAE,CACpE,qBAAqB,CAAC,MAAM,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,69 @@
+import type { I18nConfig } from "./types.js";
+import { createBetterI18nMiddleware, composeMiddleware, type MiddlewareCallback } from "./middleware.js";
+/**
+ * Create a complete i18n setup for Next.js
+ *
+ * @example
+ * ```ts
+ * // i18n/config.ts
+ * import { createI18n } from '@better-i18n/next'
+ *
+ * export const i18n = createI18n({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ *   localePrefix: 'always',
+ * })
+ *
+ * // i18n/request.ts
+ * export default i18n.requestConfig
+ *
+ * // middleware.ts (simple)
+ * export default i18n.middleware
+ *
+ * // middleware.ts (with auth - Clerk-style)
+ * export default i18n.betterMiddleware(async (request, { locale }) => {
+ *   if (needsLogin) {
+ *     return NextResponse.redirect(new URL(`/${locale}/login`, request.url));
+ *   }
+ * });
+ * ```
+ */
+export declare const createI18n: (config: I18nConfig) => {
+    config: import("./types.js").NormalizedConfig;
+    requestConfig: (params: import("next-intl/server").GetRequestConfigParams) => import("next-intl/server").RequestConfig | Promise<import("next-intl/server").RequestConfig>;
+    /** @deprecated Use betterMiddleware() for Clerk-style callback support */
+    middleware: (request: import("next/server.js").NextRequest) => Promise<import("next/server.js").NextResponse<unknown>>;
+    proxy: (request: import("next/server.js").NextRequest) => Promise<import("next/server.js").NextResponse<unknown>>;
+    getManifest: (options?: {
+        forceRefresh?: boolean;
+    }) => Promise<import("@better-i18n/core").ManifestResponse>;
+    getLocales: () => Promise<string[]>;
+    getMessages: (locale: string) => Promise<import("@better-i18n/core").Messages>;
+    /**
+     * Create middleware with optional Clerk-style callback for auth integration
+     *
+     * @example Simple usage
+     * ```ts
+     * export default i18n.betterMiddleware();
+     * ```
+     *
+     * @example With auth callback
+     * ```ts
+     * export default i18n.betterMiddleware(async (request, { locale, response }) => {
+     *   if (needsLogin) {
+     *     return NextResponse.redirect(new URL(`/${locale}/login`, request.url));
+     *   }
+     *   // Return nothing = i18n response is used (headers preserved!)
+     * });
+     * ```
+     */
+    betterMiddleware: (callback?: MiddlewareCallback) => (request: import("next/server.js").NextRequest) => Promise<import("next/server.js").NextResponse>;
+};
+export { createBetterI18nMiddleware, composeMiddleware };
+export type { MiddlewareContext, MiddlewareCallback } from "./middleware.js";
+export { createNextI18nCore } from "./server.js";
+export { BetterI18nProvider, useManifestLanguages, useSetLocale } from "./client.js";
+export type { BetterI18nProviderProps } from "./client.js";
+export type { I18nConfig, LanguageOption, Locale, LocalePrefix, LogLevel, ManifestLanguage, ManifestResponse, Messages, } from "./types.js";
+export type { I18nMiddlewareConfig } from "@better-i18n/core";
+//# 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":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,OAAO,EAGL,0BAA0B,EAC1B,iBAAiB,EACjB,KAAK,kBAAkB,EACxB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,UAAU,GAAI,QAAQ,UAAU;;;IAOzC,0EAA0E;;;;oBA0D1E,CAAC;;;;IAnDD;;;;;;;;;;;;;;;;;OAiBG;kCAC2B,kBAAkB;CAgBnD,CAAC;AAGF,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAG7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrF,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,YAAY,EACV,UAAU,EACV,cAAc,EACd,MAAM,EACN,YAAY,EACZ,QAAQ,EACR,gBAAgB,EAChB,gBAAgB,EAChB,QAAQ,GACT,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,82 @@
+import { normalizeConfig } from "./config.js";
+import { createNextI18nCore, createNextIntlRequestConfig, } from "./server.js";
+import { createI18nMiddleware, createI18nProxy, createBetterI18nMiddleware, composeMiddleware, } from "./middleware.js";
+/**
+ * Create a complete i18n setup for Next.js
+ *
+ * @example
+ * ```ts
+ * // i18n/config.ts
+ * import { createI18n } from '@better-i18n/next'
+ *
+ * export const i18n = createI18n({
+ *   project: 'acme/dashboard',
+ *   defaultLocale: 'en',
+ *   localePrefix: 'always',
+ * })
+ *
+ * // i18n/request.ts
+ * export default i18n.requestConfig
+ *
+ * // middleware.ts (simple)
+ * export default i18n.middleware
+ *
+ * // middleware.ts (with auth - Clerk-style)
+ * export default i18n.betterMiddleware(async (request, { locale }) => {
+ *   if (needsLogin) {
+ *     return NextResponse.redirect(new URL(`/${locale}/login`, request.url));
+ *   }
+ * });
+ * ```
+ */
+export const createI18n = (config) => {
+    const normalized = normalizeConfig(config);
+    const i18n = createNextI18nCore(normalized);
+    return {
+        config: normalized,
+        requestConfig: createNextIntlRequestConfig(normalized),
+        /** @deprecated Use betterMiddleware() for Clerk-style callback support */
+        middleware: createI18nMiddleware(normalized),
+        proxy: createI18nProxy(normalized),
+        getManifest: i18n.getManifest,
+        getLocales: i18n.getLocales,
+        getMessages: i18n.getMessages,
+        /**
+         * Create middleware with optional Clerk-style callback for auth integration
+         *
+         * @example Simple usage
+         * ```ts
+         * export default i18n.betterMiddleware();
+         * ```
+         *
+         * @example With auth callback
+         * ```ts
+         * export default i18n.betterMiddleware(async (request, { locale, response }) => {
+         *   if (needsLogin) {
+         *     return NextResponse.redirect(new URL(`/${locale}/login`, request.url));
+         *   }
+         *   // Return nothing = i18n response is used (headers preserved!)
+         * });
+         * ```
+         */
+        betterMiddleware: (callback) => {
+            return createBetterI18nMiddleware({
+                project: normalized.project,
+                defaultLocale: normalized.defaultLocale,
+                localePrefix: normalized.localePrefix,
+                detection: {
+                    cookie: true,
+                    browserLanguage: true,
+                    cookieName: normalized.cookieName,
+                },
+            }, callback);
+        },
+    };
+};
+// Modern standalone middleware exports
+export { createBetterI18nMiddleware, composeMiddleware };
+// Core instance factory
+export { createNextI18nCore } from "./server.js";
+// Client hooks & provider
+export { BetterI18nProvider, useManifestLanguages, useSetLocale } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,kBAAkB,EAClB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,0BAA0B,EAC1B,iBAAiB,GAElB,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,MAAkB,EAAE,EAAE;IAC/C,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAE5C,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,aAAa,EAAE,2BAA2B,CAAC,UAAU,CAAC;QACtD,0EAA0E;QAC1E,UAAU,EAAE,oBAAoB,CAAC,UAAU,CAAC;QAC5C,KAAK,EAAE,eAAe,CAAC,UAAU,CAAC;QAClC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAE7B;;;;;;;;;;;;;;;;;WAiBG;QACH,gBAAgB,EAAE,CAAC,QAA6B,EAAE,EAAE;YAClD,OAAO,0BAA0B,CAC/B;gBACE,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,aAAa,EAAE,UAAU,CAAC,aAAa;gBACvC,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,SAAS,EAAE;oBACT,MAAM,EAAE,IAAI;oBACZ,eAAe,EAAE,IAAI;oBACrB,UAAU,EAAE,UAAU,CAAC,UAAU;iBAClC;aACF,EACD,QAAQ,CACT,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,uCAAuC;AACvC,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,CAAC;AAGzD,wBAAwB;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,0BAA0B;AAC1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,78 @@
+import { NextRequest, NextResponse } from "next/server";
+import type { I18nMiddlewareConfig } from "@better-i18n/core";
+import type { I18nConfig } from "./types.js";
+/**
+ * Context passed to the middleware callback (Clerk-style pattern)
+ */
+export interface MiddlewareContext {
+    /** Detected locale from the request */
+    locale: string;
+    /** The i18n response with headers already set - can be modified */
+    response: NextResponse;
+}
+/**
+ * Callback function for Clerk-style middleware composition
+ *
+ * @param request - The incoming Next.js request
+ * @param context - Contains locale and response from i18n middleware
+ * @returns NextResponse to short-circuit (e.g., redirect), or void to continue with i18n response
+ */
+export type MiddlewareCallback = (request: NextRequest, context: MiddlewareContext) => Promise<NextResponse | void> | NextResponse | void;
+/**
+ * Legacy Next-intl based middleware
+ */
+export declare const createI18nMiddleware: (config: I18nConfig) => (request: NextRequest) => Promise<NextResponse<unknown>>;
+export declare const createI18nProxy: (config: I18nConfig) => (request: NextRequest) => Promise<NextResponse<unknown>>;
+/**
+ * Modern composable middleware for Better i18n (Clerk-style pattern)
+ *
+ * Delegates to next-intl's middleware internally to ensure full compatibility
+ * with `getRequestConfig({ requestLocale })` while keeping our compose-friendly
+ * API and custom locale detection options.
+ *
+ * @example Simple usage (no callback)
+ * ```ts
+ * export default createBetterI18nMiddleware({
+ *   project: "acme/dashboard",
+ *   defaultLocale: "en",
+ *   localePrefix: "always",
+ * });
+ * ```
+ *
+ * @example With callback (Clerk-style - recommended for auth)
+ * ```ts
+ * export default createBetterI18nMiddleware({
+ *   project: "acme/dashboard",
+ *   defaultLocale: "en",
+ *   localePrefix: "always",
+ * }, async (request, { locale, response }) => {
+ *   // Auth logic here - locale and response are available
+ *   if (needsLogin) {
+ *     return NextResponse.redirect(new URL(`/${locale}/login`, request.url));
+ *   }
+ *   // Return nothing = i18n response is used (headers preserved!)
+ * });
+ * ```
+ */
+export declare function createBetterI18nMiddleware(config: I18nMiddlewareConfig, callback?: MiddlewareCallback): (request: NextRequest) => Promise<NextResponse>;
+/**
+ * Helper to compose multiple Next.js middleware
+ *
+ * @deprecated Use `createBetterI18nMiddleware` with a callback instead (Clerk-style pattern).
+ * The callback approach is more reliable and gives you access to the detected locale.
+ *
+ * @example Migration
+ * ```ts
+ * // Before (deprecated):
+ * export default composeMiddleware(i18nMiddleware, authMiddleware);
+ *
+ * // After (recommended):
+ * export default createBetterI18nMiddleware(config, async (req, { locale, response }) => {
+ *   // Auth logic here
+ * });
+ * ```
+ *
+ * @see https://github.com/better-i18n/better-i18n#middleware-composition
+ */
+export declare function composeMiddleware(...middlewares: Array<(req: NextRequest) => Promise<NextResponse>>): (request: NextRequest) => Promise<NextResponse>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAExD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAI9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,iBAAiB,KACvB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,UAAU,MAIpB,SAAS,WAAW,mCAYtD,CAAC;AAEF,eAAO,MAAM,eAAe,WAlBiB,UAAU,MAIpB,SAAS,WAAW,mCAcJ,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,oBAAoB,EAC5B,QAAQ,CAAC,EAAE,kBAAkB,IAkBf,SAAS,WAAW,KAAG,OAAO,CAAC,YAAY,CAAC,CA+E3D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,WAAW,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,WAAW,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC,IAUpD,SAAS,WAAW,KAAG,OAAO,CAAC,YAAY,CAAC,CA0B3D"}