intor 2.3.2 → 2.3.4

package/README.md

@@ -21,3 +21,13 @@ Fast to start, easy to extend, and free from the usual i18n heaviness.
 #### 🍳 Cooking the Intor v2 docs, crafting them to perfection...
 
 </div>
+
+#### load-messages
+
+```plain
+
+[load-messages]
+ |-> load-local-messages -> read-locale-messages -> collect-file-entries & parse-file-entries
+ |-> load-remote-messages -> fetchLocaleMessages
+
+```

package/dist/export/config/index.d.ts

@@ -0,0 +1 @@
+export { defineIntorConfig, type IntorRawConfig, type IntorResolvedConfig, } from "../../src/config";

package/dist/export/config/index.js

@@ -0,0 +1 @@
+export { defineIntorConfig } from '../../src/config/define-intor-config.js';

package/dist/export/index.d.ts

@@ -0,0 +1,4 @@
+export { PREFIX_PLACEHOLDER } from "../src/shared/constants";
+export { localizePathname, } from "../src/shared/utils";
+export { IntorError, IntorErrorCode } from "../src/shared/error";
+export { type TranslatorPlugin, type TranslateHandlers, type FormatHandler, type LoadingHandler, type MissingHandler, type HandlerContext, type TranslateContext, type TranslateHook, type LocaleMessages, } from "intor-translator";

package/dist/export/index.js

@@ -0,0 +1,4 @@
+export { PREFIX_PLACEHOLDER } from '../src/shared/constants/prefix-placeholder.js';
+export { localizePathname } from '../src/shared/utils/pathname/localize-pathname.js';
+export { IntorError, IntorErrorCode } from '../src/shared/error/intor-error.js';
+import 'intor-translator';

package/dist/export/internal/index.d.ts

@@ -0,0 +1 @@
+export type { INTOR_GENERATED_KEY, GenConfigKeys, GenConfig, GenMessages, GenLocale, Key, TranslatorInstance, TranslatorInstanceClient, } from "../../src/shared/types";

package/dist/export/next/index.d.ts

@@ -0,0 +1 @@
+export { Link, usePathname, useRouter, redirect, } from "../../src/adapters/next/navigation";

package/dist/export/next/index.js

@@ -0,0 +1,4 @@
+export { Link } from '../../src/adapters/next/navigation/link.js';
+export { usePathname } from '../../src/adapters/next/navigation/use-pathname.js';
+export { useRouter } from '../../src/adapters/next/navigation/use-router.js';
+export { redirect } from '../../src/adapters/next/navigation/redirect.js';

package/dist/export/next/proxy/index.d.ts

@@ -0,0 +1 @@
+export { intorProxy, intorProxy as intorMiddleware, } from "../../../src/adapters/next/proxy";

package/dist/{exports → export}/next/proxy/index.js

@@ -1,2 +1 @@
 export { intorProxy as intorMiddleware, intorProxy } from '../../../src/adapters/next/proxy/intor-proxy.js';
-export { PATHNAME_HEADER_NAME } from '../../../src/adapters/next/shared/constants/pathname-header-name.js';

package/dist/export/next/server/index.d.ts

@@ -0,0 +1 @@
+export { getLocale, getTranslator } from "../../../src/adapters/next/server";

package/dist/export/next/server/index.js

@@ -0,0 +1,2 @@
+export { getLocale } from '../../../src/adapters/next/server/get-locale.js';
+export { getTranslator } from '../../../src/adapters/next/server/get-translator.js';

package/dist/export/react/index.d.ts

@@ -0,0 +1 @@
+export { IntorProvider, type IntorProviderProps, TranslatorRuntimeProvider, type TranslatorRuntimeProviderProps, useTranslator, getClientLocale, } from "../../src/client/react";

package/dist/export/react/index.js

@@ -0,0 +1,10 @@
+export { IntorProvider } from '../../src/client/react/contexts/intor-provider/intor-provider.js';
+export { TranslatorRuntimeProvider } from '../../src/client/react/contexts/translator-runtime/provider.js';
+import 'react';
+import '../../src/client/react/contexts/translator-runtime/context.js';
+export { useTranslator } from '../../src/client/react/translator/use-translator.js';
+import 'next/navigation';
+import 'react/jsx-runtime';
+import '../../src/client/react/contexts/config/context.js';
+import '../../src/client/react/contexts/locale/context.js';
+export { getClientLocale } from '../../src/client/helpers/get-client-locale.js';

package/dist/export/server/index.d.ts

@@ -0,0 +1 @@
+export { intor, type IntorResult, loadMessages, isValidMessages, type Messages, type MessagesReader, getTranslator, clearLoggerPool, clearMessagesPool, loadLocalMessagesFromUrl, } from "../../src/server";

package/dist/export/server/index.js

@@ -0,0 +1,7 @@
+export { intor } from '../../src/server/intor/intor.js';
+export { loadMessages } from '../../src/server/messages/load-messages.js';
+export { isValidMessages } from '../../src/server/messages/shared/utils/is-valid-messages.js';
+export { getTranslator } from '../../src/server/translator/get-translator.js';
+export { clearLoggerPool } from '../../src/server/shared/logger/global-logger-pool.js';
+export { clearMessagesPool } from '../../src/server/shared/messages/global-messages-pool.js';
+export { loadLocalMessagesFromUrl } from '../../src/server/helpers/local-messages-from-url.js';

package/dist/src/adapters/next/navigation/link.d.ts

@@ -1,16 +1,26 @@
-import type { GenLocale } from "../../../shared/types/generated.types";
+import type { GenConfigKeys, GenLocale } from "../../../shared/types/generated";
 import type { Url } from "next/dist/shared/lib/router/router";
 import type { LinkProps as NextLinkProps } from "next/link";
 import * as React from "react";
-interface LinkProps extends Omit<NextLinkProps, "href">, Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+interface LinkProps<CK extends GenConfigKeys = "__default__"> extends Omit<NextLinkProps, "href">, Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
     href?: Url;
-    locale?: GenLocale;
+    /**
+     * Locale to navigate with.
+     *
+     * If `href` is omitted, the current route is used as the navigation target.
+     */
+    locale?: GenLocale<CK>;
 }
 /**
- * Localized Link component
+ * Locale-aware Link component.
  *
- * - Wraps Next.js Link and handles locale switching.
- * - Full reload occurs only if the locale changes and requires it; otherwise updates context.
+ * Wraps Next.js `Link`
+ *
+ * - Resolves a locale-aware navigation destination
+ * - Preserves external navigation behavior
+ * - Switches locale via client state or full reload when required
+ *
+ * This component is responsible only for executing the resolved target.
  */
-export declare const Link: ({ href, locale, children, onClick, ...props }: LinkProps) => React.JSX.Element;
+export declare const Link: <CK extends GenConfigKeys = "__default__">({ href, locale, children, onClick, ...props }: LinkProps<CK>) => React.JSX.Element;
 export {};

package/dist/src/adapters/next/navigation/link.js

@@ -3,23 +3,49 @@ import { jsx } from 'react/jsx-runtime';
 import { formatUrl } from 'next/dist/shared/lib/router/utils/format-url';
 import NextLink from 'next/link';
 import 'react';
-import { useLocaleSwitch } from './utils/use-locale-switch.js';
+import '../../../client/react/contexts/config/context.js';
+import '../../../client/react/contexts/locale/context.js';
+import '../../../config/constants/cache.constants.js';
+
+
+import '../../../client/react/contexts/messages/context.js';
+import 'intor-translator';
+import '../../../client/react/contexts/translator-runtime/context.js';
+import '../../../client/react/contexts/translator/context.js';
+import { useNavigationTarget } from '../../../client/react/navigation/use-navigation-target.js';
+import { useNavigationStrategy } from '../../../client/react/navigation/use-navigation-strategy.js';
 
 /**
- * Localized Link component
+ * Locale-aware Link component.
+ *
+ * Wraps Next.js `Link`
+ *
+ * - Resolves a locale-aware navigation destination
+ * - Preserves external navigation behavior
+ * - Switches locale via client state or full reload when required
  *
- * - Wraps Next.js Link and handles locale switching.
- * - Full reload occurs only if the locale changes and requires it; otherwise updates context.
+ * This component is responsible only for executing the resolved target.
  */
 const Link = ({ href, locale, children, onClick, ...props }) => {
-    const formatted = typeof href === "string" ? href : href ? formatUrl(href) : undefined;
-    const { resolveHref, switchLocale } = useLocaleSwitch();
-    const { resolvedHref } = resolveHref({ href: formatted, locale });
+    const { resolveNavigation } = useNavigationTarget();
+    const { decideNavigation } = useNavigationStrategy();
+    // Normalize Next.js href input into a string destination
+    const rawDestination = typeof href === "string" ? href : href ? formatUrl(href) : undefined;
+    // Resolve navigation target
+    const target = resolveNavigation({ destination: rawDestination, locale });
     const handleClick = (e) => {
         onClick?.(e);
-        switchLocale({ href: formatted, locale });
+        if (e.defaultPrevented)
+            return;
+        // Decide how this navigation should be executed
+        const { kind } = decideNavigation(target);
+        if (kind === "reload") {
+            e.preventDefault(); // prevent client-side navigation
+            globalThis.location.href = target.destination;
+            return;
+        }
     };
-    return (jsx(NextLink, { href: resolvedHref, onClick: handleClick, ...props, children: children }));
+    return (jsx(NextLink, { href: target.destination, onClick: handleClick, ...props, children: children }));
 };
 
 export { Link };

package/dist/src/adapters/next/navigation/redirect.d.ts

@@ -1,16 +1,18 @@
 import type { IntorResolvedConfig } from "../../../config";
-import type { GenLocale } from "../../../shared/types/generated.types";
+import type { GenConfigKeys, GenLocale } from "../../../shared/types/generated";
 import type { RedirectType } from "next/navigation";
 /**
- * redirect utility.
+ * Locale-aware redirect helper (server-only).
  *
- * - Wraps Next.js redirect and applies locale-aware navigation.
- * - Automatically prefixes the pathname with the correct locale.
- * - External URLs are redirected directly without modification.
+ * Wraps Next.js `redirect`
+ *
+ * - Resolves the effective locale before redirecting
+ * - Applies locale prefix for internal destinations
+ * - Bypasses localization for external destinations
  */
-export declare const redirect: ({ config, locale, url, type, }: {
+export declare const redirect: <CK extends GenConfigKeys = "__default__">({ config, locale, url, type, }: {
     config: IntorResolvedConfig;
-    locale?: GenLocale;
+    locale?: GenLocale<CK>;
     url: string;
     type?: RedirectType | undefined;
-}) => Promise<never>;
+}) => Promise<undefined>;

package/dist/src/adapters/next/navigation/redirect.js

@@ -1,36 +1,37 @@
 import { redirect as redirect$1 } from 'next/navigation';
-import { getI18nContext } from '../server/get-i18n-context.js';
+import { getLocale } from '../server/get-locale.js';
 import 'intor-translator';
 
 
-
 import '../../../config/constants/cache.constants.js';
 
 
+import { localizePathname } from '../../../shared/utils/pathname/localize-pathname.js';
 
-
-import { localizePathname } from '../shared/utils/localize-pathname.js';
+import { isExternalDestination } from '../../../shared/utils/is-external-destination.js';
 
 /**
- * redirect utility.
+ * Locale-aware redirect helper (server-only).
+ *
+ * Wraps Next.js `redirect`
  *
- * - Wraps Next.js redirect and applies locale-aware navigation.
- * - Automatically prefixes the pathname with the correct locale.
- * - External URLs are redirected directly without modification.
+ * - Resolves the effective locale before redirecting
+ * - Applies locale prefix for internal destinations
+ * - Bypasses localization for external destinations
  */
 const redirect = async ({ config, locale, url, type, }) => {
-    if (url.startsWith("http")) {
+    // External destinations bypass app routing entirely
+    const isExternal = isExternalDestination(url);
+    if (isExternal) {
         redirect$1(url);
+        return;
     }
-    const isLocaleValid = locale && config.supportedLocales?.includes(locale);
-    const { locale: detectedLocale } = await getI18nContext(config);
-    // Generate the locale-prefixed pathname
-    const { localePrefixedPathname } = localizePathname({
-        config,
-        pathname: url,
-        locale: isLocaleValid ? locale : detectedLocale,
-    });
-    redirect$1(localePrefixedPathname, type);
+    // Determine locale for this redirect
+    const targetLocale = locale && config.supportedLocales.includes(locale)
+        ? locale
+        : await getLocale(config);
+    const { localizedPathname } = localizePathname(config, url, targetLocale);
+    return redirect$1(localizedPathname, type);
 };
 
 export { redirect };

package/dist/src/adapters/next/navigation/use-pathname.d.ts

@@ -6,12 +6,12 @@
  *
  * @example
  * const { localizedPathname, standardizedPathname, unprefixedPathname } = usePathname();
- * console.log(localizedPathname); // e.g. "/en/about"
- * console.log(standardizedPathname); // e.g. "/{locale}/about"
- * console.log(unprefixedPathname); // e.g. "/about"
+ * // localizedPathname => "/en-US/about"
+ * // standardizedPathname => "/{locale}/about"
+ * // unprefixedPathname => "/about"
  */
 export declare const usePathname: () => {
-    localizedPathname: string;
-    standardizedPathname: string;
     unprefixedPathname: string;
+    standardizedPathname: string;
+    localizedPathname: string;
 };

package/dist/src/adapters/next/navigation/use-pathname.js

@@ -1,20 +1,11 @@
 import { usePathname as usePathname$1 } from 'next/navigation';
-import { localizePathname } from '../shared/utils/localize-pathname.js';
 import 'react/jsx-runtime';
 import 'react';
 import '../../../client/react/contexts/config/context.js';
 import { useConfig } from '../../../client/react/contexts/config/hook.js';
-
-
-
-import '../../../config/constants/cache.constants.js';
-
-
-
-
-import '../../../client/react/contexts/messages/context.js';
 import '../../../client/react/contexts/locale/context.js';
 import { useLocale } from '../../../client/react/contexts/locale/hook.js';
+import { localizePathname } from '../../../shared/utils/pathname/localize-pathname.js';
 
 /**
  * Custom hook to get the current pathname in different forms based on the active locale.
@@ -24,9 +15,9 @@ import { useLocale } from '../../../client/react/contexts/locale/hook.js';
  *
  * @example
  * const { localizedPathname, standardizedPathname, unprefixedPathname } = usePathname();
- * console.log(localizedPathname); // e.g. "/en/about"
- * console.log(standardizedPathname); // e.g. "/{locale}/about"
- * console.log(unprefixedPathname); // e.g. "/about"
+ * // localizedPathname => "/en-US/about"
+ * // standardizedPathname => "/{locale}/about"
+ * // unprefixedPathname => "/about"
  */
 const usePathname = () => {
     const { config } = useConfig();
@@ -34,15 +25,11 @@ const usePathname = () => {
     // Get the raw pathname from the Next.js usePathname hook
     const rawPathname = usePathname$1();
     // Generate the locale-prefixed pathname
-    const { localePrefixedPathname, standardizedPathname, unprefixedPathname } = localizePathname({
-        config,
-        pathname: rawPathname,
-        locale,
-    });
+    const { localizedPathname, standardizedPathname, unprefixedPathname } = localizePathname(config, rawPathname, locale);
     return {
-        localizedPathname: localePrefixedPathname,
-        standardizedPathname,
         unprefixedPathname,
+        standardizedPathname,
+        localizedPathname,
     };
 };
 

package/dist/src/adapters/next/navigation/use-router.d.ts

@@ -1,20 +1,25 @@
-import type { GenLocale } from "../../../shared/types/generated.types";
-import type { Locale } from "intor-translator";
-import type { NavigateOptions } from "next/dist/shared/lib/app-router-context.shared-runtime";
+import type { GenConfigKeys, GenLocale } from "../../../shared/types/generated";
+import type { NavigateOptions, PrefetchOptions } from "next/dist/shared/lib/app-router-context.shared-runtime";
 /**
- * useRouter hook.
+ * Locale-aware router hook.
  *
- * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
+ * Wraps Next.js `useRouter`
+ *
+ * - Resolve locale-aware navigation targets
+ * - Decide execution strategy (client-side vs full reload)
+ * - Preserve correct behavior across navigation types
  */
 export declare const useRouter: () => {
     back(): void;
     forward(): void;
     refresh(): void;
-    prefetch(href: string, options?: import("next/dist/shared/lib/app-router-context.shared-runtime").PrefetchOptions): void;
-    push: (href: string, options?: NavigateOptions & {
-        locale?: GenLocale;
+    push: <CK extends GenConfigKeys = "__default__">(href: string, options?: NavigateOptions & {
+        locale?: GenLocale<CK>;
+    }) => void;
+    replace: <CK extends GenConfigKeys = "__default__">(href: string, options?: NavigateOptions & {
+        locale?: GenLocale<CK>;
     }) => void;
-    replace: (href: string, options?: NavigateOptions & {
-        locale?: Locale;
+    prefetch: <CK extends GenConfigKeys = "__default__">(href: string, options?: PrefetchOptions & {
+        locale?: GenLocale<CK>;
     }) => void;
 };

package/dist/src/adapters/next/navigation/use-router.js

@@ -1,29 +1,63 @@
 import { useRouter as useRouter$1 } from 'next/navigation';
-import { useLocaleSwitch } from './utils/use-locale-switch.js';
+import 'react/jsx-runtime';
+import 'react';
+import '../../../client/react/contexts/config/context.js';
+import '../../../client/react/contexts/locale/context.js';
+import '../../../config/constants/cache.constants.js';
+
+
+import '../../../client/react/contexts/messages/context.js';
+import 'intor-translator';
+import '../../../client/react/contexts/translator-runtime/context.js';
+import '../../../client/react/contexts/translator/context.js';
+import { useNavigationTarget } from '../../../client/react/navigation/use-navigation-target.js';
+import { useNavigationStrategy } from '../../../client/react/navigation/use-navigation-strategy.js';
 
 /**
- * useRouter hook.
+ * Locale-aware router hook.
  *
- * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
+ * Wraps Next.js `useRouter`
+ *
+ * - Resolve locale-aware navigation targets
+ * - Decide execution strategy (client-side vs full reload)
+ * - Preserve correct behavior across navigation types
  */
 const useRouter = () => {
-    const { push, replace, ...rest } = useRouter$1();
-    const { switchLocale } = useLocaleSwitch();
-    // Push with locale
-    const pushWithLocale = (href, options) => {
-        const resolvedHref = switchLocale({ href, locale: options?.locale });
-        if (resolvedHref)
-            push(resolvedHref, options);
+    const { push: nextRouterPush, replace: nextRouterReplace, prefetch: nextRouterPrefetch, ...rest } = useRouter$1();
+    const { resolveNavigation } = useNavigationTarget();
+    const { decideNavigation } = useNavigationStrategy();
+    const push = (href, options) => {
+        const { locale } = options || {};
+        const target = resolveNavigation({ destination: href, locale });
+        const { kind } = decideNavigation(target);
+        if (kind === "reload") {
+            globalThis.location.href = target.destination;
+            return;
+        }
+        nextRouterPush(target.destination, options);
+    };
+    const replace = (href, options) => {
+        const { locale } = options || {};
+        const target = resolveNavigation({ destination: href, locale });
+        const { kind } = decideNavigation(target);
+        if (kind === "reload") {
+            globalThis.location.href = target.destination;
+            return;
+        }
+        nextRouterReplace(target.destination, options);
     };
-    // Replace with locale
-    const replaceWithLocale = (href, options) => {
-        const resolvedHref = switchLocale({ href, locale: options?.locale });
-        if (resolvedHref)
-            replace(resolvedHref, options);
+    const prefetch = (href, options) => {
+        const { locale } = options || {};
+        const target = resolveNavigation({ destination: href, locale });
+        const { kind } = decideNavigation(target);
+        if (kind !== "client")
+            return; // Prefetch only makes sense for client-side navigation
+        nextRouterPrefetch(target.destination, options);
     };
     return {
-        push: pushWithLocale,
-        replace: replaceWithLocale,
+        push,
+        replace,
+        prefetch,
         ...rest,
     };
 };

package/dist/src/adapters/next/proxy/index.d.ts

@@ -1,2 +1 @@
 export { intorProxy } from "./intor-proxy";
-export { PATHNAME_HEADER_NAME } from "../../../adapters/next/shared/constants/pathname-header-name";

package/dist/src/adapters/next/proxy/intor-proxy.d.ts

@@ -1,6 +1,13 @@
-import type { IntorResolvedConfig } from "../../../config/types/intor-config.types";
+import type { IntorResolvedConfig } from "../../../config";
 import type { NextRequest } from "next/server";
 /**
- * Handle locale routing based on prefix config
+ * Next.js routing adapter for Intor.
+ *
+ * Responsibilities:
+ * - Collect locale candidates from request-related sources
+ * - Delegate routing decisions to the routing core
+ * - Apply redirect behavior when required
+ * - Materialize routing decisions into persistent state (cookie)
+ *   with configurable first-visit behavior
  */
-export declare function intorProxy<Req extends NextRequest = NextRequest>(config: IntorResolvedConfig, request: Req): Promise<Response>;
+export declare const intorProxy: (config: IntorResolvedConfig, request: NextRequest) => Promise<Response>;

package/dist/src/adapters/next/proxy/intor-proxy.js

@@ -1,22 +1,44 @@
-import { handlePrefixAll } from './handle-prefix/handle-prefix-all.js';
-import { handlePrefixExceptDefault } from './handle-prefix/handle-prefix-except-default.js';
-import { handlePrefixNone } from './handle-prefix/handle-prefix-none.js';
+import { headers } from 'next/headers';
+import { NextResponse } from 'next/server';
+import { setLocaleCookieEdge } from './utils/set-locale-cookie-edge.js';
+import { resolveRouting } from '../../../routing/resolve-routing.js';
+import { getLocaleFromAcceptLanguage } from '../../../shared/utils/locale/get-locale-from-accept-language.js';
 
 /**
- * Handle locale routing based on prefix config
+ * Next.js routing adapter for Intor.
+ *
+ * Responsibilities:
+ * - Collect locale candidates from request-related sources
+ * - Delegate routing decisions to the routing core
+ * - Apply redirect behavior when required
+ * - Materialize routing decisions into persistent state (cookie)
+ *   with configurable first-visit behavior
  */
-async function intorProxy(config, request) {
-    const { prefix } = config.routing;
-    // ===== Prefix: none =====
-    if (prefix === "none") {
-        return handlePrefixNone(config, request);
+const intorProxy = async (config, request) => {
+    const { defaultLocale, cookie, routing } = config;
+    // locale from accept-language header
+    const headersStore = await headers();
+    const acceptLanguageHeader = headersStore.get("accept-language");
+    const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(config, acceptLanguageHeader || undefined);
+    // Resolve routing decision (locale + pathname)
+    const { locale, localeSource, pathname, shouldRedirect } = resolveRouting(config, request.nextUrl.pathname, {
+        host: request.nextUrl.host,
+        query: Object.fromEntries(request.nextUrl.searchParams.entries()),
+        cookie: request.cookies.get(config.cookie.name)?.value,
+        detected: localeFromAcceptLanguage || defaultLocale,
+    });
+    // Prepare Next.js response (redirect or pass-through)
+    const url = request.nextUrl.clone();
+    url.pathname = pathname;
+    const response = shouldRedirect
+        ? NextResponse.redirect(url)
+        : NextResponse.next();
+    // Persist resolved locale to cookie
+    const isFirstVisit = localeSource === "detected";
+    if (!isFirstVisit || routing.firstVisit.persist) {
+        setLocaleCookieEdge({ response, locale, cookie });
     }
-    // ===== Prefix: except-default =====
-    if (prefix === "except-default") {
-        return await handlePrefixExceptDefault(config, request);
-    }
-    // ===== Prefix: all =====
-    return await handlePrefixAll(config, request);
-}
+    return response;
+};
 
 export { intorProxy };

package/dist/src/adapters/next/proxy/utils/set-locale-cookie-edge.d.ts

@@ -1,15 +1,13 @@
 import type { CookieResolvedOptions } from "../../../../config/types/cookie.types";
-import type { NextRequest, NextResponse } from "next/server";
+import type { NextResponse } from "next/server";
 interface SetLocaleCookieParams {
-    request: NextRequest;
     response: NextResponse;
     cookie: CookieResolvedOptions;
     locale: string;
-    override?: boolean;
 }
 /**
  * Set a locale cookie on the response.
  * - For Next.js proxy.
  */
-export declare function setLocaleCookieEdge({ request, response, cookie, locale, override, }: SetLocaleCookieParams): void;
+export declare function setLocaleCookieEdge({ response, cookie, locale, }: SetLocaleCookieParams): void;
 export {};

package/dist/src/adapters/next/proxy/utils/set-locale-cookie-edge.js

@@ -2,13 +2,8 @@
  * Set a locale cookie on the response.
  * - For Next.js proxy.
  */
-function setLocaleCookieEdge({ request, response, cookie, locale, override = false, // Default to not override existed cookie
- }) {
-    if (!cookie.enabled || !cookie.autoSetCookie)
-        return;
-    const isCookieExists = request.cookies.has(cookie.name);
-    // Cookie already exists and cannot override
-    if (isCookieExists && !override)
+function setLocaleCookieEdge({ response, cookie, locale, }) {
+    if (!cookie.enabled || !cookie.persist)
         return;
     // Set cookie to response
     response.cookies.set(cookie.name, locale, {

package/dist/src/adapters/next/server/get-locale.d.ts

@@ -0,0 +1,6 @@
+import type { IntorResolvedConfig } from "../../../config/types/intor-config.types";
+import type { GenConfigKeys, GenLocale } from "../../../shared/types/generated";
+/**
+ * Get the locale for the current Next.js request.
+ */
+export declare const getLocale: <CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig) => Promise<GenLocale<CK>>;

package/dist/src/adapters/next/server/get-locale.js

@@ -0,0 +1,25 @@
+import { cookies, headers } from 'next/headers';
+import { resolveLocale } from '../../../routing/locale/resolve-locale.js';
+import { getLocaleFromAcceptLanguage } from '../../../shared/utils/locale/get-locale-from-accept-language.js';
+
+/**
+ * Get the locale for the current Next.js request.
+ */
+const getLocale = async (config) => {
+    const { defaultLocale, cookie } = config;
+    // Locale from cookie
+    const cookiesStore = await cookies();
+    const cookieFromLocale = cookiesStore.get(cookie.name)?.value;
+    // locale from accept-language header
+    const headersStore = await headers();
+    const acceptLanguageHeader = headersStore.get("accept-language");
+    const localeFromAcceptLanguage = getLocaleFromAcceptLanguage(config, acceptLanguageHeader || undefined);
+    // Resolve locale and determine which source was used
+    const { locale } = resolveLocale(config, {
+        cookie: { locale: cookieFromLocale },
+        detected: { locale: localeFromAcceptLanguage || defaultLocale },
+    });
+    return locale;
+};
+
+export { getLocale };