intor 2.3.3 → 2.3.5

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

@@ -1,16 +0,0 @@
-import type { IntorResolvedConfig } from "../../../config";
-import type { GenLocale } from "../../../shared/types/generated.types";
-import type { RedirectType } from "next/navigation";
-/**
- * redirect utility.
- *
- * - Wraps Next.js redirect and applies locale-aware navigation.
- * - Automatically prefixes the pathname with the correct locale.
- * - External URLs are redirected directly without modification.
- */
-export declare const redirect: ({ config, locale, url, type, }: {
-    config: IntorResolvedConfig;
-    locale?: GenLocale;
-    url: string;
-    type?: RedirectType | undefined;
-}) => Promise<never>;

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

@@ -1,36 +0,0 @@
-import { redirect as redirect$1 } from 'next/navigation';
-import { getI18nContext } from '../server/get-i18n-context.js';
-import 'intor-translator';
-
-
-
-import '../../../config/constants/cache.constants.js';
-
-
-
-
-import { localizePathname } from '../shared/utils/localize-pathname.js';
-
-/**
- * redirect utility.
- *
- * - Wraps Next.js redirect and applies locale-aware navigation.
- * - Automatically prefixes the pathname with the correct locale.
- * - External URLs are redirected directly without modification.
- */
-const redirect = async ({ config, locale, url, type, }) => {
-    if (url.startsWith("http")) {
-        redirect$1(url);
-    }
-    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);
-};
-
-export { redirect };

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

@@ -1,49 +0,0 @@
-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';
-
-/**
- * Custom hook to get the current pathname in different forms based on the active locale.
- *
- * This hook wraps Next.js `usePathname` and processes the pathname according to the app's
- * locale configuration.
- *
- * @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"
- */
-const usePathname = () => {
-    const { config } = useConfig();
-    const { locale } = useLocale();
-    // 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,
-    });
-    return {
-        localizedPathname: localePrefixedPathname,
-        standardizedPathname,
-        unprefixedPathname,
-    };
-};
-
-export { usePathname };

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

@@ -1,20 +0,0 @@
-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";
-/**
- * useRouter hook.
- *
- * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
- */
-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;
-    }) => void;
-    replace: (href: string, options?: NavigateOptions & {
-        locale?: Locale;
-    }) => void;
-};

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

@@ -1,31 +0,0 @@
-import { useRouter as useRouter$1 } from 'next/navigation';
-import { useLocaleSwitch } from './utils/use-locale-switch.js';
-
-/**
- * useRouter hook.
- *
- * Wraps Next.js useRouter and provides push/replace methods that automatically switch locale.
- */
-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);
-    };
-    // Replace with locale
-    const replaceWithLocale = (href, options) => {
-        const resolvedHref = switchLocale({ href, locale: options?.locale });
-        if (resolvedHref)
-            replace(resolvedHref, options);
-    };
-    return {
-        push: pushWithLocale,
-        replace: replaceWithLocale,
-        ...rest,
-    };
-};
-
-export { useRouter };

package/dist/src/adapters/next/navigation/utils/should-full-reload.d.ts

@@ -1,7 +0,0 @@
-import type { IntorResolvedConfig } from "../../../../config";
-export declare const shouldFullReload: ({ config, targetPathname, locale, currentLocale, }: {
-    config: IntorResolvedConfig;
-    targetPathname: string;
-    locale?: string;
-    currentLocale: string;
-}) => boolean;

package/dist/src/adapters/next/navigation/utils/should-full-reload.js

@@ -1,19 +0,0 @@
-
-import { extractPathname } from '../../../../shared/utils/pathname/extract-pathname.js';
-
-const shouldFullReload = ({ config, targetPathname, locale, currentLocale, }) => {
-    const loader = config.loader;
-    if (!loader || !loader.type)
-        return false;
-    if (loader.type === "remote" && !loader.fullReload)
-        return false;
-    const { maybeLocale, isLocalePrefixed } = extractPathname({
-        config,
-        pathname: targetPathname,
-    });
-    const isDifferentLocale = (locale && locale !== currentLocale) ||
-        (isLocalePrefixed && maybeLocale !== currentLocale);
-    return isDifferentLocale ? true : false;
-};
-
-export { shouldFullReload };

package/dist/src/adapters/next/navigation/utils/use-locale-switch.d.ts

@@ -1,16 +0,0 @@
-import type { Locale } from "intor-translator";
-export declare const useLocaleSwitch: () => {
-    resolveHref: ({ href, locale, }: {
-        href?: string;
-        locale?: Locale;
-    }) => {
-        resolvedHref: string;
-        isExternal: boolean;
-        targetLocale: string;
-        targetPathname: string;
-    };
-    switchLocale: ({ href, locale, }: {
-        href?: string;
-        locale?: Locale;
-    }) => string | undefined;
-};

package/dist/src/adapters/next/navigation/utils/use-locale-switch.js

@@ -1,58 +0,0 @@
-import { usePathname } from '../use-pathname.js';
-import { shouldFullReload } from './should-full-reload.js';
-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 { setLocaleCookieBrowser } from '../../../../shared/utils/client/set-locale-cookie-browser.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';
-
-const useLocaleSwitch = () => {
-    const { config } = useConfig();
-    const { locale: currentLocale, setLocale } = useLocale();
-    const { localizedPathname } = usePathname();
-    // Resolve href
-    const resolveHref = ({ href, locale, }) => {
-        const isLocaleValid = locale && config.supportedLocales?.includes(locale);
-        const targetLocale = isLocaleValid ? locale : currentLocale;
-        const targetPathname = href ?? localizedPathname;
-        const isExternal = targetPathname.startsWith("http");
-        const resolvedHref = !isExternal
-            ? localizePathname({
-                config,
-                pathname: targetPathname,
-                locale: targetLocale,
-            }).localePrefixedPathname
-            : targetPathname;
-        return { resolvedHref, isExternal, targetLocale, targetPathname };
-    };
-    // Switch locale
-    const switchLocale = ({ href, locale, }) => {
-        const { resolvedHref, isExternal, targetLocale, targetPathname } = resolveHref({ href, locale });
-        if (isExternal)
-            return;
-        if (shouldFullReload({ config, targetPathname, locale, currentLocale })) {
-            setLocaleCookieBrowser({ cookie: config.cookie, locale: targetLocale });
-            globalThis.location.href = resolvedHref; // Full reload navigation
-            return;
-        }
-        else {
-            setLocale(targetLocale);
-        }
-        return resolvedHref;
-    };
-    return { resolveHref, switchLocale };
-};
-
-export { useLocaleSwitch };

package/dist/src/adapters/next/proxy/handle-prefix/handle-prefix-all.d.ts

@@ -1,12 +0,0 @@
-import type { IntorResolvedConfig } from "../../../../config";
-import type { NextRequest } from "next/server";
-/**
- * Handle routing for "all" prefix.
- *
- * - If URL has locale prefix → use it and override cookie.
- * - If no prefix and no cookie:
- *   - If redirect disabled → respond directly.
- *   - If redirect enabled → detect initial locale and redirect.
- * - If no prefix but cookie exists → redirect using cookie locale.
- */
-export declare const handlePrefixAll: <Req extends NextRequest = NextRequest>(config: IntorResolvedConfig, request: Req) => Promise<Response>;

package/dist/src/adapters/next/proxy/handle-prefix/handle-prefix-all.js

@@ -1,60 +0,0 @@
-import { createResponse } from '../utils/create-response.js';
-import { determineInitialLocale } from '../utils/determine-initial-locale.js';
-import 'lodash.merge';
-import { extractPathname } from '../../../../shared/utils/pathname/extract-pathname.js';
-
-/**
- * Handle routing for "all" prefix.
- *
- * - If URL has locale prefix → use it and override cookie.
- * - If no prefix and no cookie:
- *   - If redirect disabled → respond directly.
- *   - If redirect enabled → detect initial locale and redirect.
- * - If no prefix but cookie exists → redirect using cookie locale.
- */
-const handlePrefixAll = async (config, request) => {
-    const { cookie, routing } = config;
-    const { maybeLocale, isLocalePrefixed } = extractPathname({
-        config,
-        pathname: request.nextUrl.pathname,
-    });
-    const localeFromCookie = request.cookies.get(cookie.name)?.value;
-    // ▼ URL has a locale prefix, (e.g. https://example.com/en)
-    if (isLocalePrefixed) {
-        // ▶ Go directly and override cookie
-        return createResponse({
-            request,
-            config,
-            locale: maybeLocale,
-            setCookieOptions: { override: true },
-        });
-    }
-    // ▼ URL doesn't have a locale prefix, (e.g. https://example.com/)
-    // No cookie, so is first visit
-    if (!localeFromCookie) {
-        // Not using redirect (Do not set cookie)
-        if (!routing.firstVisit.redirect) {
-            // ▶ Go directly
-            return createResponse({ request, config });
-        }
-        // Decide to use locale from browser or defaultLocale
-        const initialLocale = await determineInitialLocale(config);
-        // Using redirect for the first visit
-        // ▶ Redirect to URL (set cookie for the first visit)
-        return createResponse({
-            request,
-            config,
-            locale: initialLocale, // Use locale from 'browser' | 'default'
-            responseType: "redirect",
-        });
-    }
-    // ▶ Redirect to URL
-    return createResponse({
-        request,
-        config,
-        locale: localeFromCookie, // Use locale from cookie
-        responseType: "redirect",
-    });
-};
-
-export { handlePrefixAll };

package/dist/src/adapters/next/proxy/handle-prefix/handle-prefix-except-default.d.ts

@@ -1,16 +0,0 @@
-import type { IntorResolvedConfig } from "../../../../config";
-import type { NextRequest } from "next/server";
-/**
- * Handle routing for "except-default" prefix.
- *
- * - If URL has a non-default locale prefix → use it and override cookie.
- * - If no prefix and no cookie:
- *   - If redirect disabled → respond directly.
- *   - If redirect enabled:
- *     - If resolved locale is default → respond directly.
- *     - Else → redirect to locale URL.
- * - If no prefix but cookie exists:
- *   - If cookie locale is default → respond directly.
- *   - Else → redirect to locale URL.
- */
-export declare const handlePrefixExceptDefault: <Req extends NextRequest = NextRequest>(config: IntorResolvedConfig, request: Req) => Promise<Response>;

package/dist/src/adapters/next/proxy/handle-prefix/handle-prefix-except-default.js

@@ -1,81 +0,0 @@
-import { createResponse } from '../utils/create-response.js';
-import { determineInitialLocale } from '../utils/determine-initial-locale.js';
-import 'lodash.merge';
-import { extractPathname } from '../../../../shared/utils/pathname/extract-pathname.js';
-
-/**
- * Handle routing for "except-default" prefix.
- *
- * - If URL has a non-default locale prefix → use it and override cookie.
- * - If no prefix and no cookie:
- *   - If redirect disabled → respond directly.
- *   - If redirect enabled:
- *     - If resolved locale is default → respond directly.
- *     - Else → redirect to locale URL.
- * - If no prefix but cookie exists:
- *   - If cookie locale is default → respond directly.
- *   - Else → redirect to locale URL.
- */
-const handlePrefixExceptDefault = async (config, request) => {
-    const { defaultLocale, cookie, routing } = config;
-    const { maybeLocale, isLocalePrefixed } = extractPathname({
-        config,
-        pathname: request.nextUrl.pathname,
-    });
-    const localeFromCookie = request.cookies.get(cookie.name)?.value;
-    // ▼ URL has a locale prefix, and it's not defaultLocale (e.g. https://example.com/zh)
-    if (isLocalePrefixed && maybeLocale !== defaultLocale) {
-        // ▶ Go directly and override cookie
-        return createResponse({
-            request,
-            config,
-            locale: maybeLocale,
-            setCookieOptions: { override: true },
-        });
-    }
-    // ▼ URL doesn't have a locale prefix, (e.g. https://example.com/)
-    // No cookie, so is first visit
-    if (!localeFromCookie) {
-        // Not using redirect (Do not set cookie)
-        if (!routing.firstVisit.redirect) {
-            // ▶ Go directly
-            return createResponse({ request, config });
-        }
-        // Using redirect for the first visit
-        // Decide to use locale from browser or defaultLocale
-        const initialLocale = await determineInitialLocale(config);
-        const isDefaultLocale = initialLocale === defaultLocale;
-        // Is defaultLocale
-        if (isDefaultLocale) {
-            // ▶ Go directly, no prefix (set cookie for the first visit)
-            return createResponse({
-                request,
-                config,
-                locale: defaultLocale,
-            });
-        }
-        // Not defaultLocale
-        // ▶ Redirect to URL (set cookie for the first visit)
-        return createResponse({
-            request,
-            config,
-            locale: initialLocale, // Use locale from 'browser' | 'default'
-            responseType: "redirect",
-        });
-    }
-    // Cookie found (No need to set cookie)
-    const isDefaultLocale = localeFromCookie === defaultLocale;
-    if (isDefaultLocale) {
-        // ▶ Go directly
-        return createResponse({ request, config, locale: localeFromCookie });
-    }
-    // ▶ Redirect to URL
-    return createResponse({
-        request,
-        config,
-        locale: localeFromCookie, // Use locale from cookie
-        responseType: "redirect",
-    });
-};
-
-export { handlePrefixExceptDefault };

package/dist/src/adapters/next/proxy/handle-prefix/handle-prefix-none.d.ts

@@ -1,10 +0,0 @@
-import type { IntorResolvedConfig } from "../../../../config";
-import type { NextRequest } from "next/server";
-/**
- * Handle routing for "none" prefix.
- *
- * Checks cookie for locale. If absent,
- * determines initial locale via config.
- * Returns response with locale.
- */
-export declare const handlePrefixNone: <Req extends NextRequest = NextRequest>(config: IntorResolvedConfig, request: Req) => Promise<Response>;

package/dist/src/adapters/next/proxy/handle-prefix/handle-prefix-none.js

@@ -1,22 +0,0 @@
-import { createResponse } from '../utils/create-response.js';
-import { determineInitialLocale } from '../utils/determine-initial-locale.js';
-
-/**
- * Handle routing for "none" prefix.
- *
- * Checks cookie for locale. If absent,
- * determines initial locale via config.
- * Returns response with locale.
- */
-const handlePrefixNone = async (config, request) => {
-    let locale = request.cookies.get(config.cookie.name)?.value;
-    // No cookie, so is first visit
-    if (!locale) {
-        // Decide to use locale from browser or defaultLocale
-        locale = await determineInitialLocale(config);
-    }
-    // ▶ Go directly (set cookie only for the first time, no override)
-    return createResponse({ request, config, locale });
-};
-
-export { handlePrefixNone };

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

@@ -1,2 +0,0 @@
-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 +0,0 @@
-import type { IntorResolvedConfig } from "../../../config/types/intor-config.types";
-import type { NextRequest } from "next/server";
-/**
- * Handle locale routing based on prefix config
- */
-export declare function intorProxy<Req extends NextRequest = NextRequest>(config: IntorResolvedConfig, request: Req): Promise<Response>;

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

@@ -1,22 +0,0 @@
-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';
-
-/**
- * Handle locale routing based on prefix config
- */
-async function intorProxy(config, request) {
-    const { prefix } = config.routing;
-    // ===== Prefix: none =====
-    if (prefix === "none") {
-        return handlePrefixNone(config, request);
-    }
-    // ===== Prefix: except-default =====
-    if (prefix === "except-default") {
-        return await handlePrefixExceptDefault(config, request);
-    }
-    // ===== Prefix: all =====
-    return await handlePrefixAll(config, request);
-}
-
-export { intorProxy };

package/dist/src/adapters/next/proxy/utils/create-response.d.ts

@@ -1,17 +0,0 @@
-import type { IntorResolvedConfig } from "../../../../config/types/intor-config.types";
-import type { NextRequest } from "next/server";
-import { NextResponse } from "next/server";
-interface CreateResponseOptions<Req extends NextRequest = NextRequest> {
-    request: Req;
-    config: IntorResolvedConfig;
-    locale?: string;
-    responseType?: "next" | "redirect";
-    setCookieOptions?: {
-        override?: boolean;
-    };
-}
-/**
- * Create a Next.js response with locale handling.
- */
-export declare const createResponse: <Req extends NextRequest = NextRequest, Res extends NextResponse = NextResponse>({ request, config, locale, responseType, setCookieOptions, }: CreateResponseOptions<Req>) => Response;
-export {};

package/dist/src/adapters/next/proxy/utils/create-response.js

@@ -1,42 +0,0 @@
-import { NextResponse } from 'next/server';
-import { setLocaleCookieEdge } from './set-locale-cookie-edge.js';
-import { setPathnameHeader } from './set-pathname-header.js';
-import { localizePathname } from '../../shared/utils/localize-pathname.js';
-
-/**
- * Create a Next.js response with locale handling.
- */
-const createResponse = ({ request, config, locale, responseType = "next", setCookieOptions = { override: false }, }) => {
-    const { cookie } = config;
-    const { override } = setCookieOptions;
-    const url = request.nextUrl.clone(); // Clone URL to avoid mutating original
-    // Generate locale-prefixed pathname
-    const { localePrefixedPathname } = localizePathname({
-        config,
-        pathname: url.pathname,
-        locale,
-    });
-    url.pathname = localePrefixedPathname;
-    // Create response based on the responseType
-    const response = responseType === "redirect"
-        ? NextResponse.redirect(url)
-        : NextResponse.next();
-    // Set locale cookie if locale is provided
-    if (locale) {
-        setLocaleCookieEdge({
-            request,
-            response,
-            locale,
-            cookie,
-            override,
-        });
-    }
-    // Set pathname header
-    const finalResponse = setPathnameHeader({
-        request,
-        response: response,
-    });
-    return finalResponse;
-};
-
-export { createResponse };

package/dist/src/adapters/next/proxy/utils/determine-initial-locale.d.ts

@@ -1,8 +0,0 @@
-import type { IntorResolvedConfig } from "../../../../config/types/intor-config.types";
-/**
- * Determine the initial locale for the user.
- *
- * @param config - The resolved configuration object.
- * @returns The initial locale string.
- */
-export declare const determineInitialLocale: (config: IntorResolvedConfig) => Promise<string>;

package/dist/src/adapters/next/proxy/utils/determine-initial-locale.js

@@ -1,28 +0,0 @@
-import { headers } from 'next/headers';
-import 'lodash.merge';
-import { normalizeLocale } from '../../../../shared/utils/locale/normalize-locale.js';
-import { resolvePreferredLocale } from '../../../../shared/utils/locale/resolve-preferred-locale.js';
-
-/**
- * Determine the initial locale for the user.
- *
- * @param config - The resolved configuration object.
- * @returns The initial locale string.
- */
-const determineInitialLocale = async (config) => {
-    const { defaultLocale, supportedLocales, routing } = config;
-    let initialLocale = defaultLocale;
-    // If locale should be determined from browser on first visit
-    if (routing.firstVisit.localeSource === "browser") {
-        const headersStore = await headers();
-        const acceptLanguageHeader = headersStore.get("accept-language") || undefined;
-        // Find the best matching locale from the supported locales
-        const preferredLocale = resolvePreferredLocale(acceptLanguageHeader, supportedLocales);
-        // Normalize the preferred locale or fallback to default
-        initialLocale =
-            normalizeLocale(preferredLocale, supportedLocales) || defaultLocale;
-    }
-    return initialLocale;
-};
-
-export { determineInitialLocale };

package/dist/src/adapters/next/proxy/utils/set-pathname-header.d.ts

@@ -1,12 +0,0 @@
-import type { NextRequest, NextResponse } from "next/server";
-interface SetPathnameHeaderOptions<Req extends NextRequest = NextRequest, Res extends NextResponse = NextResponse> {
-    request: Req;
-    response: Res;
-    key?: string;
-}
-/**
- * Set the pathname in the response header.
- * - For Next.js proxy.
- */
-export declare const setPathnameHeader: <Req extends NextRequest = NextRequest, Res extends NextResponse = NextResponse>({ request, response, key, }: SetPathnameHeaderOptions<Req, Res>) => Response;
-export {};

package/dist/src/adapters/next/proxy/utils/set-pathname-header.js

@@ -1,13 +0,0 @@
-import { PATHNAME_HEADER_NAME } from '../../shared/constants/pathname-header-name.js';
-
-/**
- * Set the pathname in the response header.
- * - For Next.js proxy.
- */
-const setPathnameHeader = ({ request, response, key = PATHNAME_HEADER_NAME, }) => {
-    const pathname = request.nextUrl.pathname;
-    response.headers.set(key, pathname);
-    return response;
-};
-
-export { setPathnameHeader };

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

@@ -1,9 +0,0 @@
-import type { IntorResolvedConfig } from "../../../config/types/intor-config.types";
-import type { I18nContext } from "../../../server/intor/types";
-import type { GenConfigKeys } from "../../../shared/types/generated.types";
-/**
- * Retrieves the i18n context for the current request.
- *
- * Next.js adapter implementation: uses `next/headers` and `next/cookies`.
- */
-export declare const getI18nContext: <CK extends GenConfigKeys = "__default__">(config: IntorResolvedConfig) => Promise<I18nContext>;