vite-intlayer 9.3.2 → 9.3.3

package/dist/esm/intlayerProxyPlugin.mjs

@@ -1,10 +1,9 @@
 import { createPrimaryInstanceGuard } from "./dedupePlugin.mjs";
+import { createProxyHandler } from "./intlayerProxyHandler.mjs";
 import { getAppLogger } from "@intlayer/config/logger";
 import { getConfiguration } from "@intlayer/config/node";
-import { formatProxyEnabledMessage, getCanonicalPath, getDomainHostname, getDomainOrigin, getInternalPath, getLocaleFromDomain, getLocalizedPath, getRewriteRules, isProxyStorageLocaleEnabled, localeDetector, resolveProxyMode } from "@intlayer/core/localization";
-import { ROUTING_MODE } from "@intlayer/config/defaultValues";
-import { fileURLToPath, parse } from "node:url";
-import { getCookie, getLocaleFromStorageServer, setLocaleInStorageServer } from "@intlayer/core/utils";
+import { formatProxyEnabledMessage, isProxyStorageLocaleEnabled, resolveProxyMode } from "@intlayer/core/localization";
+import { fileURLToPath } from "node:url";
 
 //#region src/intlayerProxyPlugin.ts
 const PROXY_PLUGIN_NAME = "vite-intlayer-middleware-plugin";
@@ -15,40 +14,10 @@ const PROXY_PLUGIN_NAME = "vite-intlayer-middleware-plugin";
 */
 const NITRO_PREVIEW_PLUGIN_NAME = "nitro:preview";
 /**
-* Header Nitro's prerenderer sets on every request it issues to the server it
-* is generating pages from. Its value is the route being generated.
-*/
-const NITRO_PRERENDER_HEADER = "x-nitro-prerender";
-/**
-* Environment flag TanStack Start sets on the build process while it prerenders
-* pages through a Vite preview server. The preview server — and therefore this
-* middleware — runs in that same process, so the flag is readable here.
-*/
-const TANSTACK_PRERENDER_ENV_VAR = "TSS_PRERENDERING";
-/**
-* Detects requests issued by a prerenderer rather than by a real visitor.
-*
-* Prerendered pages are written to disk and then served to every visitor, so
-* their content must depend on the URL alone. Anything client-specific — a
-* locale cookie, a persisted locale on the response — would either be baked
-* into a static file or make the generated page depend on the machine running
-* the build.
-*
-* @param req - The incoming request.
-* @returns `true` when the request comes from a prerender pass.
-*
-* @example
-* ```ts
-* isPrerenderRequest({ headers: { 'x-nitro-prerender': '/about' } }); // true
-* ```
-*/
-const isPrerenderRequest = (req) => Boolean(req.headers[NITRO_PRERENDER_HEADER]) || process.env[TANSTACK_PRERENDER_ENV_VAR] === "true";
-/**
 * Creates a standalone, framework-agnostic locale-routing middleware.
 *
-* This function contains all the locale detection, redirect, and rewrite logic.
-* It is intentionally separated from the Vite plugin so the same handler can be
-* used in every environment:
+* It loads the Intlayer configuration and hands it to the runtime handler in
+* `intlayerProxyHandler`, so it can be used in every environment:
 *
 * - **Dev**: wired up automatically by `intlayerProxy` via `configureServer`
 * - **Preview**: wired up automatically by `intlayerProxy` via `configurePreviewServer`
@@ -65,377 +34,12 @@ const isPrerenderRequest = (req) => Boolean(req.headers[NITRO_PRERENDER_HEADER])
 *
 * @param options - Plugin-specific options, such as path ignoring and Intlayer configuration overrides.
 * @returns A Connect-compatible `(req, res, next) => void` middleware.
-*
 */
-const createIntlayerProxyHandler = (options) => {
-	const { ignore, configOptions, isDevServer = false } = options ?? {};
-	const { internationalization, routing } = getConfiguration(configOptions);
-	const { locales: supportedLocales, defaultLocale } = internationalization;
-	const { basePath = "", mode = ROUTING_MODE, rewrite, domains, enableProxy } = routing;
-	const canUseStorageLocale = isProxyStorageLocaleEnabled(resolveProxyMode(enableProxy), isDevServer);
-	const redirectCounts = /* @__PURE__ */ new Map();
-	const MAX_REDIRECTS = 10;
-	const REDIRECT_TTL_MS = 2e3;
-	const noPrefix = !(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "no-prefix") && mode === "no-prefix" || !(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "search-params") && mode === "search-params";
-	const prefixDefault = !(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "prefix-all") && mode === "prefix-all";
-	const rewriteRules = process.env.INTLAYER_ROUTING_REWRITE_RULES !== "false" ? getRewriteRules(rewrite, "url") : void 0;
-	/**
-	* Extracts the hostname from a request's `Host` header, handling IPv6
-	* literals (`[::1]:5173` → `::1`) that a plain `split(':')` would mangle.
-	*/
-	const getRequestHostname = (req) => {
-		const host = req.headers.host ?? "";
-		const ipv6Match = host.match(/^\[([^\]]+)\]/);
-		if (ipv6Match) return ipv6Match[1];
-		return host.split(":")[0] ?? "";
-	};
-	/**
-	* Retrieves the locale from storage (cookies, localStorage, sessionStorage).
-	*
-	* Returns `undefined` when the stored locale is not allowed to drive locale
-	* resolution (auto mode on a dev/preview server, or a prerender pass, whose
-	* output must stay URL-driven), which makes every caller fall through to
-	* `Accept-Language` detection and then the default locale.
-	*/
-	const getStorageLocale = (req) => {
-		if (!canUseStorageLocale || isPrerenderRequest(req)) return void 0;
-		return getLocaleFromStorageServer({ getCookie: (name) => getCookie(name, req.headers.cookie) });
-	};
-	/**
-	* Appends locale to search params when routing mode is 'search-params'.
-	*/
-	const appendLocaleSearchIfNeeded = (search, locale) => {
-		if (process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "search-params" || mode !== "search-params") return search;
-		const params = new URLSearchParams(search ?? "");
-		params.set("locale", locale);
-		return `?${params.toString()}`;
-	};
-	/**
-	* Checks whether a pathname starts with the given locale as a full path
-	* segment (`/fr` or `/fr/...`). A bare `startsWith('/fr')` would also match
-	* unrelated paths like `/friends`, causing wrong prefix stripping and
-	* self-redirect loops.
-	*/
-	const hasLocaleSegmentPrefix = (pathname, locale) => pathname === `/${locale}` || pathname.startsWith(`/${locale}/`);
-	/**
-	* Extracts the locale from the URL pathname if present as the first segment.
-	* e.g. if pathname is /en/some/page or /en, checks if "en" is in supportedLocales.
-	*/
-	const getPathLocale = (pathname) => {
-		const firstSegment = pathname.split("/").filter(Boolean)[0];
-		if (firstSegment && supportedLocales.includes(firstSegment)) return firstSegment;
-	};
-	/**
-	* Persists the resolved locale onto the outgoing response as a cookie (and
-	* header, per `routing.storage`). Only the cookie survives a client redirect,
-	* so this is what carries an explicitly-selected locale across a
-	* prefix-stripping redirect. Enabled cookie/header targets are resolved by
-	* {@link setLocaleInStorageServer} from the config; disabled ones are no-ops.
-	*/
-	const persistLocaleOnResponse = (res, locale) => {
-		setLocaleInStorageServer(locale, {
-			setCookieStore: (name, value, attributes) => {
-				const parts = [`${name}=${encodeURIComponent(value)}`];
-				if (attributes.path) parts.push(`Path=${attributes.path}`);
-				if (attributes.domain) parts.push(`Domain=${attributes.domain}`);
-				if (typeof attributes.expires === "number") parts.push(`Expires=${new Date(attributes.expires).toUTCString()}`);
-				if (attributes.secure) parts.push("Secure");
-				if (attributes.httpOnly) parts.push("HttpOnly");
-				if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);
-				const cookieString = parts.join("; ");
-				const existing = res.getHeader("Set-Cookie");
-				const cookies = Array.isArray(existing) ? existing.map(String) : existing !== void 0 ? [String(existing)] : [];
-				cookies.push(cookieString);
-				res.setHeader("Set-Cookie", cookies);
-			},
-			setHeader: (name, value) => {
-				res.setHeader(name, value);
-			}
-		});
-	};
-	/**
-	* Identifies the client issuing a request, so redirect-loop tracking is
-	* scoped per client. Without this, concurrent visitors hitting the same
-	* legitimate redirect (e.g. `/` → `/fr/`) would share one counter and trip
-	* the loop detector under normal production traffic.
-	*/
-	const getClientKey = (req) => {
-		const forwardedFor = req.headers["x-forwarded-for"];
-		return (Array.isArray(forwardedFor) ? forwardedFor[0] : forwardedFor)?.split(",")[0]?.trim() || req.socket?.remoteAddress || "unknown";
-	};
-	/**
-	* Strips any origin from a redirect target, keeping only path, search and
-	* hash. Prevents open redirects: user-controlled paths like `//evil.com/x`
-	* would otherwise be echoed verbatim into the `Location` header and be
-	* interpreted by browsers as a protocol-relative cross-origin URL.
-	*/
-	const toSameOriginUrl = (url) => {
-		try {
-			const parsed = new URL(url, "http://intlayer-internal");
-			return `${parsed.pathname}${parsed.search}${parsed.hash}`;
-		} catch {
-			return url;
-		}
-	};
-	/**
-	* Writes a redirect response with the given new URL.
-	*/
-	const redirectUrl = (req, res, newUrl, options) => {
-		const { reason, originalUrl, persistLocale, status = 302, allowCrossOrigin = false } = options ?? {};
-		const targetUrl = allowCrossOrigin ? newUrl : toSameOriginUrl(newUrl);
-		if (originalUrl) {
-			if (originalUrl === targetUrl) {
-				console.error("[REDIRECT LOOP DETECTED!]", {
-					originalUrl,
-					reason
-				});
-				res.writeHead(500, { "Content-Type": "text/plain" });
-				return res.end(`Redirect loop detected: ${originalUrl} redirects to itself`);
-			}
-			const now = Date.now();
-			const trackingKey = `${getClientKey(req)}|${originalUrl} -> ${targetUrl}`;
-			const previousEntry = redirectCounts.get(trackingKey);
-			const count = previousEntry && now - previousEntry.lastSeen < REDIRECT_TTL_MS ? previousEntry.count + 1 : 1;
-			redirectCounts.set(trackingKey, {
-				count,
-				lastSeen: now
-			});
-			if (count > MAX_REDIRECTS) {
-				console.error("[REDIRECT LOOP DETECTED!]", {
-					originalUrl,
-					redirectCount: count,
-					lastRedirectTo: targetUrl,
-					reason
-				});
-				res.writeHead(500, { "Content-Type": "text/plain" });
-				return res.end(`Redirect loop detected: ${count} redirects from ${originalUrl}`);
-			}
-			for (const [entryKey, entry] of redirectCounts) if (now - entry.lastSeen >= REDIRECT_TTL_MS) redirectCounts.delete(entryKey);
-		}
-		if (persistLocale && !isPrerenderRequest(req)) persistLocaleOnResponse(res, persistLocale);
-		res.writeHead(status, { Location: targetUrl });
-		return res.end();
-	};
-	/**
-	* "Rewrite" the request internally by adjusting req.url.
-	* Also sets the locale in the response/request headers via storage to mimic
-	* Next.js's behaviour of propagating the detected locale downstream.
-	*/
-	const rewriteUrl = (req, res, newUrl, locale) => {
-		if (req.url !== newUrl) req.url = newUrl;
-		if (locale) setLocaleInStorageServer(locale, { setHeader: (name, value) => {
-			res.setHeader(name, value);
-			req.headers[name] = value;
-		} });
-	};
-	/**
-	* Constructs a new path string, optionally including a locale prefix, basePath, and search parameters.
-	* - basePath:    (e.g. '/myapp')
-	* - locale:      (e.g. 'en')
-	* - currentPath: (e.g. '/products/shoes')
-	* - search:      (e.g. '?foo=bar')
-	*/
-	const constructPath = (locale, currentPath, search) => {
-		const pathWithoutPrefix = hasLocaleSegmentPrefix(currentPath, locale) ? currentPath.slice(`/${locale}`.length) : currentPath;
-		const cleanBasePath = basePath.startsWith("/") ? basePath : `/${basePath}`;
-		const normalizedBasePath = cleanBasePath.endsWith("/") ? cleanBasePath.slice(0, -1) : cleanBasePath;
-		if (!(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "no-prefix") && mode === "no-prefix" || !(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "search-params") && mode === "search-params") return search ? `${pathWithoutPrefix || "/"}${search}` : pathWithoutPrefix || "/";
-		let newPath = `${normalizedBasePath}${hasLocaleSegmentPrefix(currentPath, locale) ? currentPath : `/${locale}${currentPath}`}`;
-		if (!prefixDefault && locale === defaultLocale) newPath = `${normalizedBasePath}${pathWithoutPrefix || "/"}`;
-		if (newPath.length > 1 && newPath.endsWith("/")) newPath = newPath.slice(0, -1);
-		if (search) newPath += search;
-		return newPath;
-	};
-	/**
-	* If `noPrefix` is true, we never prefix the locale in the URL.
-	* We simply rewrite the request to the same path, but with the best-chosen locale
-	* in a header or search params if desired.
-	*/
-	const handleNoPrefix = ({ req, res, next, originalPath, searchParams, storageLocale, originalUrl }) => {
-		const pathLocale = getPathLocale(originalPath);
-		let locale = storageLocale ?? defaultLocale;
-		if (!storageLocale) locale = localeDetector(req.headers, supportedLocales, defaultLocale);
-		if (!supportedLocales.includes(locale)) locale = defaultLocale;
-		if (pathLocale) {
-			const pathWithoutLocale = originalPath.slice(`/${pathLocale}`.length) || "/";
-			const canonicalPath = getCanonicalPath(pathWithoutLocale, pathLocale, rewriteRules);
-			const search = appendLocaleSearchIfNeeded(searchParams, pathLocale);
-			const redirectPath = search ? `${canonicalPath}${search}` : `${canonicalPath}${searchParams ?? ""}`;
-			return redirectUrl(req, res, redirectPath, {
-				originalUrl,
-				persistLocale: pathLocale
-			});
-		}
-		const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);
-		if (!(process.env.INTLAYER_ROUTING_MODE && process.env.INTLAYER_ROUTING_MODE !== "search-params") && mode === "search-params") {
-			if (new URLSearchParams(searchParams ?? "").get("locale") === locale) {
-				const rewritePath = `${getInternalPath(canonicalPath, locale)}${searchParams ?? ""}`;
-				rewriteUrl(req, res, rewritePath, locale);
-				return next();
-			}
-			const search = appendLocaleSearchIfNeeded(searchParams, locale);
-			const redirectPath = search ? `${originalPath}${search}` : `${originalPath}${searchParams ?? ""}`;
-			return redirectUrl(req, res, redirectPath, { originalUrl });
-		}
-		const internalPath = getInternalPath(canonicalPath, locale);
-		const search = appendLocaleSearchIfNeeded(searchParams, locale);
-		const rewritePath = search ? `${internalPath}${search}` : `${internalPath}${searchParams ?? ""}`;
-		rewriteUrl(req, res, rewritePath, locale);
-		return next();
-	};
-	/**
-	* The main prefix logic.
-	*/
-	const handlePrefix = ({ req, res, next, originalPath, searchParams, pathLocale, storageLocale, originalUrl }) => {
-		if (!pathLocale) {
-			handleMissingPathLocale({
-				req,
-				res,
-				next,
-				originalPath,
-				searchParams,
-				storageLocale,
-				originalUrl
-			});
-			return;
-		}
-		handleExistingPathLocale({
-			req,
-			res,
-			next,
-			originalPath,
-			searchParams,
-			pathLocale,
-			originalUrl
-		});
-	};
-	/**
-	* Handles requests where the locale is missing from the URL pathname.
-	* Detects a locale from storage / headers / default, then either redirects or rewrites.
-	*/
-	const handleMissingPathLocale = ({ req, res, next, originalPath, searchParams, storageLocale, originalUrl }) => {
-		let locale = storageLocale ?? localeDetector(req.headers, supportedLocales, defaultLocale);
-		if (!supportedLocales.includes(locale)) locale = defaultLocale;
-		const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);
-		const targetLocalizedPathResult = getLocalizedPath(canonicalPath, locale, rewriteRules);
-		const targetLocalizedPath = typeof targetLocalizedPathResult === "string" ? targetLocalizedPathResult : targetLocalizedPathResult.path;
-		const search = appendLocaleSearchIfNeeded(searchParams, locale);
-		const newPath = constructPath(locale, targetLocalizedPath, search);
-		if (prefixDefault || locale !== defaultLocale) return redirectUrl(req, res, newPath, { originalUrl });
-		rewriteUrl(req, res, `${canonicalPath}${searchParams}`, locale);
-		return next();
-	};
-	/**
-	* Handles requests where the locale prefix is present in the pathname.
-	*/
-	const handleExistingPathLocale = ({ req, res, next, originalPath, searchParams, pathLocale, originalUrl }) => {
-		const rawPath = originalPath.slice(`/${pathLocale}`.length) || "/";
-		const canonicalPath = getCanonicalPath(rawPath, pathLocale, rewriteRules);
-		if (canonicalPath !== rawPath) {
-			const newPath = searchParams ? `${originalPath}${searchParams}` : originalPath;
-			rewriteUrl(req, res, newPath, pathLocale);
-			return next();
-		}
-		handleDefaultLocaleRedirect({
-			req,
-			res,
-			next,
-			searchParams,
-			pathLocale,
-			canonicalPath,
-			originalUrl
-		});
-	};
-	/**
-	* If the path locale is the default locale but we don't want to prefix the default, remove it.
-	*/
-	const handleDefaultLocaleRedirect = ({ req, res, next, searchParams, pathLocale, canonicalPath, originalUrl }) => {
-		if (!prefixDefault && pathLocale === defaultLocale) {
-			const targetLocalizedPathResult = getLocalizedPath(canonicalPath, pathLocale, rewriteRules);
-			const targetLocalizedPath = typeof targetLocalizedPathResult === "string" ? targetLocalizedPathResult : targetLocalizedPathResult.path;
-			const cleanBasePath = basePath.startsWith("/") ? basePath : `/${basePath}`;
-			const normalizedBasePath = cleanBasePath.endsWith("/") ? cleanBasePath.slice(0, -1) : cleanBasePath;
-			let finalPath = targetLocalizedPath;
-			if (finalPath.startsWith("/")) finalPath = finalPath.slice(1);
-			const fullPath = `${normalizedBasePath}/${finalPath}`.replace(/\/+/g, "/");
-			return redirectUrl(req, res, fullPath + (searchParams ?? ""), {
-				originalUrl,
-				persistLocale: pathLocale
-			});
-		}
-		const internalUrl = getInternalPath(canonicalPath, pathLocale);
-		const newPath = searchParams ? `${internalUrl}${searchParams}` : internalUrl;
-		rewriteUrl(req, res, newPath, pathLocale);
-		return next();
-	};
-	return (req, res, next) => {
-		const parsedUrl = parse(req.url ?? "/", true);
-		const originalPath = parsedUrl.pathname ?? "/";
-		const searchParams = parsedUrl.search ?? "";
-		const pathLocale = getPathLocale(originalPath);
-		if ((ignore?.(req) ?? false) || originalPath.startsWith("/node_modules") || originalPath.startsWith("/@") || originalPath.startsWith("/_")) return next();
-		if (originalPath.match(/\.[a-zA-Z0-9]+$/)) {
-			if (pathLocale) req.url = `${originalPath.slice(`/${pathLocale}`.length) || "/"}${searchParams}`;
-			return next();
-		}
-		const storageLocale = getStorageLocale(req);
-		const effectiveStorageLocale = pathLocale && supportedLocales.includes(pathLocale) ? pathLocale : storageLocale;
-		const originalUrl = req.url;
-		if (process.env.INTLAYER_ROUTING_DOMAINS !== "false" && !noPrefix && pathLocale && domains) {
-			const localeDomain = domains[pathLocale];
-			if (localeDomain) {
-				const reqHost = getRequestHostname(req);
-				if (getDomainHostname(localeDomain) !== reqHost) {
-					const rawPath = originalPath.slice(`/${pathLocale}`.length) || "/";
-					const targetOrigin = getDomainOrigin(localeDomain);
-					redirectUrl(req, res, `${targetOrigin}${rawPath}${searchParams}`, {
-						reason: "domain-routing",
-						originalUrl,
-						status: 301,
-						allowCrossOrigin: true
-					});
-					return;
-				}
-			}
-		}
-		if (process.env.INTLAYER_ROUTING_DOMAINS !== "false" && !noPrefix && !pathLocale) {
-			const reqHost = getRequestHostname(req);
-			const domainLocale = getLocaleFromDomain(reqHost, domains);
-			if (domainLocale) {
-				const canonicalPath = getCanonicalPath(originalPath, domainLocale, rewriteRules);
-				if (!prefixDefault && domainLocale === defaultLocale) {
-					rewriteUrl(req, res, `${canonicalPath}${searchParams}`, domainLocale);
-					return next();
-				}
-				const internalPath = getInternalPath(canonicalPath, domainLocale);
-				rewriteUrl(req, res, searchParams ? `${internalPath}${searchParams}` : internalPath, domainLocale);
-				return next();
-			}
-		}
-		if (noPrefix) {
-			handleNoPrefix({
-				req,
-				res,
-				next,
-				originalPath,
-				searchParams,
-				storageLocale: effectiveStorageLocale,
-				originalUrl
-			});
-			return;
-		}
-		handlePrefix({
-			req,
-			res,
-			next,
-			originalPath,
-			searchParams,
-			pathLocale,
-			storageLocale: effectiveStorageLocale,
-			originalUrl
-		});
-	};
-};
+const createIntlayerProxyHandler = (options) => createProxyHandler({
+	configuration: getConfiguration(options?.configOptions),
+	ignore: options?.ignore,
+	isDevServer: options?.isDevServer ?? false
+});
 /**
 * Vite plugin that provides locale-based routing middleware for **all environments**:
 * development, preview, and production SSR (Nitro / TanStack Start).

package/dist/esm/intlayerProxyPlugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"intlayerProxyPlugin.mjs","names":[],"sources":["../../src/intlayerProxyPlugin.ts"],"sourcesContent":["import type { IncomingMessage, ServerResponse } from 'node:http';\nimport { fileURLToPath, parse } from 'node:url';\nimport { ROUTING_MODE } from '@intlayer/config/defaultValues';\nimport { getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  formatProxyEnabledMessage,\n  getCanonicalPath,\n  getDomainHostname,\n  getDomainOrigin,\n  getInternalPath,\n  getLocaleFromDomain,\n  getLocalizedPath,\n  getRewriteRules,\n  isProxyStorageLocaleEnabled,\n  localeDetector,\n  resolveProxyMode,\n} from '@intlayer/core/localization';\nimport {\n  getCookie,\n  getLocaleFromStorageServer,\n  setLocaleInStorageServer,\n} from '@intlayer/core/utils';\nimport type { Locale } from '@intlayer/types/allLocales';\n/* @ts-ignore - Vite types error */\nimport type { Connect, Plugin } from 'vite';\nimport { createPrimaryInstanceGuard } from './dedupePlugin';\n\nconst PROXY_PLUGIN_NAME = 'vite-intlayer-middleware-plugin';\n\n/**\n * Name of the Vite plugin `nitro/vite` registers in preview mode. It mounts the\n * built Nitro server — which already carries the Intlayer proxy as a Nitro\n * middleware — inside the Vite preview server.\n */\nconst NITRO_PREVIEW_PLUGIN_NAME = 'nitro:preview';\n\n/**\n * Header Nitro's prerenderer sets on every request it issues to the server it\n * is generating pages from. Its value is the route being generated.\n */\nconst NITRO_PRERENDER_HEADER = 'x-nitro-prerender';\n\n/**\n * Environment flag TanStack Start sets on the build process while it prerenders\n * pages through a Vite preview server. The preview server — and therefore this\n * middleware — runs in that same process, so the flag is readable here.\n */\nconst TANSTACK_PRERENDER_ENV_VAR = 'TSS_PRERENDERING';\n\n/**\n * Detects requests issued by a prerenderer rather than by a real visitor.\n *\n * Prerendered pages are written to disk and then served to every visitor, so\n * their content must depend on the URL alone. Anything client-specific — a\n * locale cookie, a persisted locale on the response — would either be baked\n * into a static file or make the generated page depend on the machine running\n * the build.\n *\n * @param req - The incoming request.\n * @returns `true` when the request comes from a prerender pass.\n *\n * @example\n * ```ts\n * isPrerenderRequest({ headers: { 'x-nitro-prerender': '/about' } }); // true\n * ```\n */\nconst isPrerenderRequest = (req: IncomingMessage): boolean =>\n  Boolean(req.headers[NITRO_PRERENDER_HEADER]) ||\n  process.env[TANSTACK_PRERENDER_ENV_VAR] === 'true';\n\nexport type IntlayerProxyPluginOptions = {\n  /**\n   * A function that allows you to ignore specific requests from the intlayer proxy.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ ignore: (req) => req.url?.startsWith('/api') }) ],\n   * });\n   * ```\n   *\n   * @param req - The incoming request.\n   * @returns A boolean value indicating whether to ignore the request.\n   */\n  ignore?: (req: IncomingMessage) => boolean | undefined;\n  /**\n   * Optional Intlayer configuration overrides forwarded to `getConfiguration`.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ configOptions: { override: { ... } } }) ],\n   * });\n   * ```\n   */\n  configOptions?: GetConfigurationOptions;\n  /**\n   * Whether a development or preview server is serving the app.\n   *\n   * Set internally by the plugin from `configureServer` /\n   * `configurePreviewServer`. It only matters in the proxy's auto mode, where\n   * a dev server keeps locale routing URL-driven by ignoring the stored locale\n   * as a redirect source.\n   *\n   * Defaults to `false` so that mounting `createIntlayerProxyHandler()`\n   * manually — the documented production Nitro setup — keeps full behaviour.\n   *\n   * @default false\n   */\n  isDevServer?: boolean;\n};\n\n/**\n * A Node.js-compatible Connect middleware function.\n * Compatible with Vite dev/preview server, Node.js http, Express, and h3's\n * `fromNodeMiddleware` wrapper for Nitro/TanStack Start production use.\n */\ntype NodeMiddleware = (\n  req: IncomingMessage,\n  res: ServerResponse<IncomingMessage>,\n  next: () => void\n) => void;\n\n/**\n * Creates a standalone, framework-agnostic locale-routing middleware.\n *\n * This function contains all the locale detection, redirect, and rewrite logic.\n * It is intentionally separated from the Vite plugin so the same handler can be\n * used in every environment:\n *\n * - **Dev**: wired up automatically by `intlayerProxy` via `configureServer`\n * - **Preview**: wired up automatically by `intlayerProxy` via `configurePreviewServer`\n * - **Production (Nitro / TanStack Start)**: create `server/middleware/intlayerProxy.ts`:\n *\n * @example\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(createIntlayerProxyHandler());\n * ```\n *\n * @param options - Plugin-specific options, such as path ignoring and Intlayer configuration overrides.\n * @returns A Connect-compatible `(req, res, next) => void` middleware.\n *\n */\nexport const createIntlayerProxyHandler = (\n  options?: IntlayerProxyPluginOptions\n): NodeMiddleware => {\n  const { ignore, configOptions, isDevServer = false } = options ?? {};\n  const intlayerConfig = getConfiguration(configOptions);\n\n  const { internationalization, routing } = intlayerConfig;\n  const { locales: supportedLocales, defaultLocale } = internationalization;\n\n  const {\n    basePath = '',\n    mode = ROUTING_MODE,\n    rewrite,\n    domains,\n    enableProxy,\n  } = routing;\n\n  // In auto mode a dev/preview server ignores the stored locale when resolving\n  // which locale a request maps to, so a lingering cookie cannot keep pulling\n  // navigation to another locale while developing. Prefix redirects, locale\n  // persistence and `Accept-Language` detection are unaffected.\n  const canUseStorageLocale = isProxyStorageLocaleEnabled(\n    resolveProxyMode(enableProxy),\n    isDevServer\n  );\n\n  type RedirectCounter = { count: number; lastSeen: number };\n  const redirectCounts = new Map<string, RedirectCounter>();\n  const MAX_REDIRECTS = 10;\n  const REDIRECT_TTL_MS = 2_000;\n\n  // Derived flags from routing.mode\n  const noPrefix =\n    (!(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'no-prefix'\n    ) &&\n      mode === 'no-prefix') ||\n    (!(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n    ) &&\n      mode === 'search-params');\n  const prefixDefault =\n    !(\n      process.env.INTLAYER_ROUTING_MODE &&\n      process.env.INTLAYER_ROUTING_MODE !== 'prefix-all'\n    ) && mode === 'prefix-all';\n\n  const rewriteRules =\n    process.env.INTLAYER_ROUTING_REWRITE_RULES !== 'false'\n      ? getRewriteRules(rewrite, 'url')\n      : undefined;\n\n  /**\n   * Extracts the hostname from a request's `Host` header, handling IPv6\n   * literals (`[::1]:5173` → `::1`) that a plain `split(':')` would mangle.\n   */\n  const getRequestHostname = (req: IncomingMessage): string => {\n    const host = req.headers.host ?? '';\n    const ipv6Match = host.match(/^\\[([^\\]]+)\\]/);\n    if (ipv6Match) return ipv6Match[1]!;\n    return host.split(':')[0] ?? '';\n  };\n\n  /* --------------------------------------------------------------------\n   *                     Helper & Utility Functions\n   * --------------------------------------------------------------------\n   */\n\n  /**\n   * Retrieves the locale from storage (cookies, localStorage, sessionStorage).\n   *\n   * Returns `undefined` when the stored locale is not allowed to drive locale\n   * resolution (auto mode on a dev/preview server, or a prerender pass, whose\n   * output must stay URL-driven), which makes every caller fall through to\n   * `Accept-Language` detection and then the default locale.\n   */\n  const getStorageLocale = (req: IncomingMessage): Locale | undefined => {\n    if (!canUseStorageLocale || isPrerenderRequest(req)) return undefined;\n\n    const locale = getLocaleFromStorageServer({\n      getCookie: (name: string) => getCookie(name, req.headers.cookie),\n    });\n    return locale;\n  };\n\n  /**\n   * Appends locale to search params when routing mode is 'search-params'.\n   */\n  const appendLocaleSearchIfNeeded = (\n    search: string | undefined,\n    locale: Locale\n  ): string | undefined => {\n    if (\n      (process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params') ||\n      mode !== 'search-params'\n    )\n      return search;\n\n    const params = new URLSearchParams(search ?? '');\n\n    params.set('locale', locale);\n\n    return `?${params.toString()}`;\n  };\n\n  /**\n   * Checks whether a pathname starts with the given locale as a full path\n   * segment (`/fr` or `/fr/...`). A bare `startsWith('/fr')` would also match\n   * unrelated paths like `/friends`, causing wrong prefix stripping and\n   * self-redirect loops.\n   */\n  const hasLocaleSegmentPrefix = (pathname: string, locale: Locale): boolean =>\n    pathname === `/${locale}` || pathname.startsWith(`/${locale}/`);\n\n  /**\n   * Extracts the locale from the URL pathname if present as the first segment.\n   * e.g. if pathname is /en/some/page or /en, checks if \"en\" is in supportedLocales.\n   */\n  const getPathLocale = (pathname: string): Locale | undefined => {\n    const segments = pathname.split('/').filter(Boolean);\n    const firstSegment = segments[0];\n    if (firstSegment && supportedLocales.includes(firstSegment as Locale)) {\n      return firstSegment as Locale;\n    }\n    return undefined;\n  };\n\n  /**\n   * Persists the resolved locale onto the outgoing response as a cookie (and\n   * header, per `routing.storage`). Only the cookie survives a client redirect,\n   * so this is what carries an explicitly-selected locale across a\n   * prefix-stripping redirect. Enabled cookie/header targets are resolved by\n   * {@link setLocaleInStorageServer} from the config; disabled ones are no-ops.\n   */\n  const persistLocaleOnResponse = (\n    res: ServerResponse<IncomingMessage>,\n    locale: Locale\n  ) => {\n    setLocaleInStorageServer(locale, {\n      setCookieStore: (name, value, attributes) => {\n        const parts: string[] = [`${name}=${encodeURIComponent(value)}`];\n        if (attributes.path) parts.push(`Path=${attributes.path}`);\n        if (attributes.domain) parts.push(`Domain=${attributes.domain}`);\n        if (typeof attributes.expires === 'number')\n          parts.push(`Expires=${new Date(attributes.expires).toUTCString()}`);\n        if (attributes.secure) parts.push('Secure');\n        if (attributes.httpOnly) parts.push('HttpOnly');\n        if (attributes.sameSite) parts.push(`SameSite=${attributes.sameSite}`);\n\n        const cookieString = parts.join('; ');\n        const existing = res.getHeader('Set-Cookie');\n        const cookies = Array.isArray(existing)\n          ? existing.map(String)\n          : existing !== undefined\n            ? [String(existing)]\n            : [];\n        cookies.push(cookieString);\n        res.setHeader('Set-Cookie', cookies);\n      },\n      setHeader: (name: string, value: string) => {\n        res.setHeader(name, value);\n      },\n    });\n  };\n\n  /**\n   * Identifies the client issuing a request, so redirect-loop tracking is\n   * scoped per client. Without this, concurrent visitors hitting the same\n   * legitimate redirect (e.g. `/` → `/fr/`) would share one counter and trip\n   * the loop detector under normal production traffic.\n   */\n  const getClientKey = (req: IncomingMessage): string => {\n    const forwardedFor = req.headers['x-forwarded-for'];\n    const forwardedIp = (\n      Array.isArray(forwardedFor) ? forwardedFor[0] : forwardedFor\n    )\n      ?.split(',')[0]\n      ?.trim();\n\n    return forwardedIp || req.socket?.remoteAddress || 'unknown';\n  };\n\n  /**\n   * Strips any origin from a redirect target, keeping only path, search and\n   * hash. Prevents open redirects: user-controlled paths like `//evil.com/x`\n   * would otherwise be echoed verbatim into the `Location` header and be\n   * interpreted by browsers as a protocol-relative cross-origin URL.\n   */\n  const toSameOriginUrl = (url: string): string => {\n    try {\n      const parsed = new URL(url, 'http://intlayer-internal');\n      return `${parsed.pathname}${parsed.search}${parsed.hash}`;\n    } catch {\n      return url;\n    }\n  };\n\n  type RedirectOptions = {\n    /** Human-readable reason logged when a redirect loop is detected. */\n    reason?: string;\n    /** The URL of the incoming request, used for redirect-loop tracking. */\n    originalUrl?: string;\n    /**\n     * When provided, the locale is persisted (cookie/header, per config) on\n     * the redirect response so the follow-up request resolves the same locale.\n     */\n    persistLocale?: Locale;\n    /**\n     * HTTP status for the redirect. Defaults to 302: locale redirects depend\n     * on mutable state (cookie, Accept-Language) and must not be cached by\n     * the browser as permanent. Domain-routing redirects pass 301 explicitly.\n     */\n    status?: number;\n    /**\n     * Allows a cross-origin `Location` target. Only the domain-routing\n     * redirect sets this; all other targets are sanitized to same-origin.\n     */\n    allowCrossOrigin?: boolean;\n  };\n\n  /**\n   * Writes a redirect response with the given new URL.\n   */\n  const redirectUrl = (\n    req: IncomingMessage,\n    res: ServerResponse<IncomingMessage>,\n    newUrl: string,\n    options?: RedirectOptions\n  ) => {\n    const {\n      reason,\n      originalUrl,\n      persistLocale,\n      status = 302,\n      allowCrossOrigin = false,\n    } = options ?? {};\n\n    const targetUrl = allowCrossOrigin ? newUrl : toSameOriginUrl(newUrl);\n\n    if (originalUrl) {\n      if (originalUrl === targetUrl) {\n        console.error('[REDIRECT LOOP DETECTED!]', { originalUrl, reason });\n        res.writeHead(500, { 'Content-Type': 'text/plain' });\n        return res.end(\n          `Redirect loop detected: ${originalUrl} redirects to itself`\n        );\n      }\n\n      const now = Date.now();\n      const trackingKey = `${getClientKey(req)}|${originalUrl} -> ${targetUrl}`;\n      const previousEntry = redirectCounts.get(trackingKey);\n      const count =\n        previousEntry && now - previousEntry.lastSeen < REDIRECT_TTL_MS\n          ? previousEntry.count + 1\n          : 1;\n\n      redirectCounts.set(trackingKey, { count, lastSeen: now });\n\n      if (count > MAX_REDIRECTS) {\n        console.error('[REDIRECT LOOP DETECTED!]', {\n          originalUrl,\n          redirectCount: count,\n          lastRedirectTo: targetUrl,\n          reason,\n        });\n        res.writeHead(500, { 'Content-Type': 'text/plain' });\n        return res.end(\n          `Redirect loop detected: ${count} redirects from ${originalUrl}`\n        );\n      }\n\n      for (const [entryKey, entry] of redirectCounts) {\n        if (now - entry.lastSeen >= REDIRECT_TTL_MS)\n          redirectCounts.delete(entryKey);\n      }\n    }\n\n    // A prerendered response is stored as a static file and replayed to every\n    // visitor, so persisting the locale on it would hand the locale of the\n    // build machine to everyone hitting that page.\n    if (persistLocale && !isPrerenderRequest(req)) {\n      persistLocaleOnResponse(res, persistLocale);\n    }\n\n    res.writeHead(status, { Location: targetUrl });\n    return res.end();\n  };\n\n  /**\n   * \"Rewrite\" the request internally by adjusting req.url.\n   * Also sets the locale in the response/request headers via storage to mimic\n   * Next.js's behaviour of propagating the detected locale downstream.\n   */\n  const rewriteUrl = (\n    req: Connect.IncomingMessage,\n    res: ServerResponse<IncomingMessage>,\n    newUrl: string,\n    locale?: Locale\n  ) => {\n    if (req.url !== newUrl) {\n      req.url = newUrl;\n    }\n    if (locale) {\n      setLocaleInStorageServer(locale, {\n        setHeader: (name: string, value: string) => {\n          res.setHeader(name, value);\n          req.headers[name] = value;\n        },\n      });\n    }\n  };\n\n  /**\n   * Constructs a new path string, optionally including a locale prefix, basePath, and search parameters.\n   * - basePath:    (e.g. '/myapp')\n   * - locale:      (e.g. 'en')\n   * - currentPath: (e.g. '/products/shoes')\n   * - search:      (e.g. '?foo=bar')\n   */\n  const constructPath = (\n    locale: Locale,\n    currentPath: string,\n    search?: string\n  ) => {\n    // Strip any incoming locale prefix to avoid double-prefixing\n    const pathWithoutPrefix = hasLocaleSegmentPrefix(currentPath, locale)\n      ? currentPath.slice(`/${locale}`.length)\n      : currentPath;\n\n    // Ensure basePath always starts with '/' and has no trailing slash\n    const cleanBasePath = basePath.startsWith('/') ? basePath : `/${basePath}`;\n    const normalizedBasePath = cleanBasePath.endsWith('/')\n      ? cleanBasePath.slice(0, -1)\n      : cleanBasePath;\n\n    // In 'search-params' and 'no-prefix' modes, do not prefix the path with the locale\n    if (\n      (!(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'no-prefix'\n      ) &&\n        mode === 'no-prefix') ||\n      (!(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n      ) &&\n        mode === 'search-params')\n    ) {\n      const newPath = search\n        ? `${pathWithoutPrefix || '/'}${search}`\n        : pathWithoutPrefix || '/';\n      return newPath;\n    }\n\n    // Check if path already starts with locale to avoid double-prefixing\n    const pathWithLocalePrefix = hasLocaleSegmentPrefix(currentPath, locale)\n      ? currentPath\n      : `/${locale}${currentPath}`;\n\n    let newPath = `${normalizedBasePath}${pathWithLocalePrefix}`;\n\n    // Special case: if prefixDefault is false and locale is defaultLocale, remove the locale prefix\n    if (!prefixDefault && locale === defaultLocale) {\n      newPath = `${normalizedBasePath}${pathWithoutPrefix || '/'}`;\n    }\n\n    // Never emit a trailing slash (`/fr/` for the root path): the framework's\n    // trailing-slash normalisation would redirect it back and forth with this\n    // proxy, creating an infinite redirect loop.\n    if (newPath.length > 1 && newPath.endsWith('/')) {\n      newPath = newPath.slice(0, -1);\n    }\n\n    // Append search parameters if provided\n    if (search) {\n      newPath += search;\n    }\n\n    return newPath;\n  };\n\n  /* --------------------------------------------------------------------\n   *               Handlers that mirror Next.js style logic\n   * --------------------------------------------------------------------\n   */\n\n  /**\n   * If `noPrefix` is true, we never prefix the locale in the URL.\n   * We simply rewrite the request to the same path, but with the best-chosen locale\n   * in a header or search params if desired.\n   */\n  const handleNoPrefix = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    const pathLocale = getPathLocale(originalPath);\n\n    // Determine the best locale: prefer cookie/storage, fall back to Accept-Language detection\n    let locale = storageLocale ?? defaultLocale;\n\n    // Use localeDetector if no storage locale is available\n    if (!storageLocale) {\n      const detectedLocale = localeDetector(\n        req.headers as Record<string, string>,\n        supportedLocales,\n        defaultLocale\n      );\n      locale = detectedLocale as Locale;\n    }\n\n    // Guard against a stale/unsupported locale coming from storage or detection\n    if (!supportedLocales.includes(locale)) {\n      locale = defaultLocale;\n    }\n\n    if (pathLocale) {\n      const pathWithoutLocale =\n        originalPath.slice(`/${pathLocale}`.length) || '/';\n\n      const canonicalPath = getCanonicalPath(\n        pathWithoutLocale,\n        pathLocale,\n        rewriteRules\n      );\n\n      const search = appendLocaleSearchIfNeeded(searchParams, pathLocale);\n\n      const redirectPath = search\n        ? `${canonicalPath}${search}`\n        : `${canonicalPath}${searchParams ?? ''}`;\n\n      // Persist the explicitly-requested locale: stripping the prefix drops\n      // the only locale signal from the URL, so without this the follow-up\n      // request would fall back to cookie / Accept-Language detection and\n      // could resolve a different locale.\n      return redirectUrl(req, res, redirectPath, {\n        originalUrl,\n        persistLocale: pathLocale,\n      });\n    }\n\n    const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);\n\n    // In search-params mode, we need to redirect to add the locale search param\n    if (\n      !(\n        process.env.INTLAYER_ROUTING_MODE &&\n        process.env.INTLAYER_ROUTING_MODE !== 'search-params'\n      ) &&\n      mode === 'search-params'\n    ) {\n      // Check if locale search param already exists and matches the detected locale\n      const existingSearchParams = new URLSearchParams(searchParams ?? '');\n      const existingLocale = existingSearchParams.get('locale');\n\n      if (existingLocale === locale) {\n        // Rewrite internally — URL stays the same in the browser, but the framework\n        // sees /[locale]/path so the [locale] route param is populated correctly.\n        // getInternalPath collapses the root path to `/${locale}` — a trailing\n        // slash (`/fr/`) would trigger the framework's trailing-slash\n        // normalisation redirect and loop with this proxy.\n        const internalPath = getInternalPath(canonicalPath, locale);\n        const rewritePath = `${internalPath}${searchParams ?? ''}`;\n\n        rewriteUrl(req, res, rewritePath, locale);\n        return next();\n      }\n\n      // Locale param missing or doesn't match — redirect to add/update it (URL changes in browser)\n      const search = appendLocaleSearchIfNeeded(searchParams, locale);\n      const redirectPath = search\n        ? `${originalPath}${search}`\n        : `${originalPath}${searchParams ?? ''}`;\n\n      return redirectUrl(req, res, redirectPath, { originalUrl });\n    }\n\n    // For no-prefix mode (not search-params), add locale prefix internally for routing\n    // so the framework can match the [locale] route param without exposing it in the URL.\n    // getInternalPath collapses the root path to `/${locale}` — a trailing slash\n    // (`/fr/`) would trigger the framework's trailing-slash normalisation\n    // redirect and loop with this proxy.\n    const internalPath = getInternalPath(canonicalPath, locale);\n\n    const search = appendLocaleSearchIfNeeded(searchParams, locale);\n    const rewritePath = search\n      ? `${internalPath}${search}`\n      : `${internalPath}${searchParams ?? ''}`;\n\n    // Rewrite internally — URL stays the same in the browser\n    rewriteUrl(req, res, rewritePath, locale);\n\n    return next();\n  };\n\n  /**\n   * The main prefix logic.\n   */\n  const handlePrefix = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    pathLocale,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    pathLocale?: Locale;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    if (!pathLocale) {\n      handleMissingPathLocale({\n        req,\n        res,\n        next,\n        originalPath,\n        searchParams,\n        storageLocale,\n        originalUrl,\n      });\n      return;\n    }\n\n    handleExistingPathLocale({\n      req,\n      res,\n      next,\n      originalPath,\n      searchParams,\n      pathLocale,\n      originalUrl,\n    });\n  };\n\n  /**\n   * Handles requests where the locale is missing from the URL pathname.\n   * Detects a locale from storage / headers / default, then either redirects or rewrites.\n   */\n  const handleMissingPathLocale = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    storageLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    storageLocale?: Locale;\n    originalUrl?: string;\n  }) => {\n    // Choose the best locale: cookie/storage → Accept-Language detection → defaultLocale\n    let locale = (storageLocale ??\n      localeDetector(\n        req.headers as Record<string, string>,\n        supportedLocales,\n        defaultLocale\n      )) as Locale;\n\n    // If still invalid, fall back to defaultLocale\n    if (!supportedLocales.includes(locale)) {\n      locale = defaultLocale;\n    }\n\n    // Resolve to canonical path.\n    // If user visits /a-propos (implied 'fr'), this resolves to /about\n    const canonicalPath = getCanonicalPath(originalPath, locale, rewriteRules);\n\n    // Determine target localized path for redirection.\n    // /about + 'fr' → /a-propos\n    const targetLocalizedPathResult = getLocalizedPath(\n      canonicalPath,\n      locale,\n      rewriteRules\n    );\n    const targetLocalizedPath =\n      typeof targetLocalizedPathResult === 'string'\n        ? targetLocalizedPathResult\n        : targetLocalizedPathResult.path;\n\n    // Construct new path, preserving original search params\n    const search = appendLocaleSearchIfNeeded(searchParams, locale);\n    const newPath = constructPath(locale, targetLocalizedPath, search);\n\n    // If we always prefix default or if this is not the default locale,\n    // do a redirect so the user sees the locale in the URL\n    if (prefixDefault || locale !== defaultLocale) {\n      return redirectUrl(req, res, newPath, { originalUrl });\n    }\n\n    // If we do NOT prefix the default locale, pass through the canonical path unchanged.\n    // Rewriting to `/${locale}${canonicalPath}` (e.g. /en/) causes TanStack Start to issue a\n    // trailing-slash normalisation redirect (/en/ → /en), which the proxy then strips back to /,\n    // creating an infinite redirect loop.\n    // Because {-$locale} is an optional segment, the framework matches the un-prefixed URL with\n    // locale=undefined and falls back to defaultLocale via `params.locale ?? defaultLocale`.\n    // searchParams MUST be preserved here — dropping them causes the framework (e.g. TanStack Start) to\n    // see a URL with no search params, trigger a validateSearch normalisation redirect to the prefixed URL\n    // (e.g. /en?page=1&...), which the middleware then strips back to /?..., creating an infinite loop.\n    rewriteUrl(req, res, `${canonicalPath}${searchParams}`, locale);\n    return next();\n  };\n\n  /**\n   * Handles requests where the locale prefix is present in the pathname.\n   */\n  const handleExistingPathLocale = ({\n    req,\n    res,\n    next,\n    originalPath,\n    searchParams,\n    pathLocale,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    originalPath: string;\n    searchParams: string;\n    pathLocale: Locale;\n    originalUrl?: string;\n  }) => {\n    const rawPath = originalPath.slice(`/${pathLocale}`.length) || '/';\n\n    // Identify the canonical path (internal path).\n    // Ex: /a-propos (from URL) → /about (canonical)\n    const canonicalPath = getCanonicalPath(rawPath, pathLocale, rewriteRules);\n\n    // When rewrite rules are configured and the URL is already a valid localized pretty URL\n    // (e.g. /fr/essais which maps to canonical /fr/tests), do NOT redirect to canonical.\n    //\n    // Why: the SPA router (Solid, React Router, Vue Router…) is expected to define routes using\n    // the localized paths (e.g. <Route path=\"/essais\">) so the browser URL must stay as-is.\n    // A 301 redirect to canonical would:\n    //  1. Change the browser URL to the canonical form (/fr/tests)\n    //  2. Break subsequent client-side navigation because <A> links produced by getLocalizedUrl\n    //     point back to the localized URL (/fr/essais) which then has no matching route.\n    //\n    // We set the locale header and call next() so the server serves the page at the pretty URL.\n    if (canonicalPath !== rawPath) {\n      const newPath = searchParams\n        ? `${originalPath}${searchParams}`\n        : originalPath;\n      rewriteUrl(req, res, newPath, pathLocale);\n      return next();\n    }\n\n    handleDefaultLocaleRedirect({\n      req,\n      res,\n      next,\n      searchParams,\n      pathLocale,\n      canonicalPath,\n      originalUrl,\n    });\n  };\n\n  /**\n   * If the path locale is the default locale but we don't want to prefix the default, remove it.\n   */\n  const handleDefaultLocaleRedirect = ({\n    req,\n    res,\n    next,\n    searchParams,\n    pathLocale,\n    canonicalPath,\n    originalUrl,\n  }: {\n    req: Connect.IncomingMessage;\n    res: ServerResponse<IncomingMessage>;\n    next: Connect.NextFunction;\n    searchParams: string;\n    pathLocale: Locale;\n    canonicalPath: string;\n    originalUrl?: string;\n  }) => {\n    // If we don't prefix the default locale AND the path locale IS the default → strip the prefix\n    if (!prefixDefault && pathLocale === defaultLocale) {\n      const targetLocalizedPathResult = getLocalizedPath(\n        canonicalPath,\n        pathLocale,\n        rewriteRules\n      );\n      const targetLocalizedPath =\n        typeof targetLocalizedPathResult === 'string'\n          ? targetLocalizedPathResult\n          : targetLocalizedPathResult.path;\n\n      // Construct path without prefix\n      const cleanBasePath = basePath.startsWith('/')\n        ? basePath\n        : `/${basePath}`;\n      const normalizedBasePath = cleanBasePath.endsWith('/')\n        ? cleanBasePath.slice(0, -1)\n        : cleanBasePath;\n\n      let finalPath = targetLocalizedPath;\n      if (finalPath.startsWith('/')) finalPath = finalPath.slice(1);\n\n      const fullPath = `${normalizedBasePath}/${finalPath}`.replace(\n        /\\/+/g,\n        '/'\n      );\n\n      // Persist the explicitly-requested default locale. Stripping the prefix\n      // (e.g. /es → /) drops the only locale signal from the URL, so without\n      // this the follow-up request to the canonical path would fall back to\n      // Accept-Language detection and could resolve a different locale.\n      return redirectUrl(req, res, fullPath + (searchParams ?? ''), {\n        originalUrl,\n        persistLocale: pathLocale,\n      });\n    }\n\n    // If we do prefix the default or pathLocale !== default, keep as-is\n    // but rewrite to canonical internally.\n    // Never emit a trailing slash (`/fr/` for the bare `/fr` URL): rewriting\n    // `/fr` to `/fr/` makes the framework issue a trailing-slash normalisation\n    // redirect back to `/fr`, which this proxy rewrites again — an infinite\n    // redirect loop. `getInternalPath` collapses the root path to `/${locale}`.\n    const internalUrl = getInternalPath(canonicalPath, pathLocale);\n    const newPath = searchParams\n      ? `${internalUrl}${searchParams}`\n      : internalUrl;\n\n    rewriteUrl(req, res, newPath, pathLocale);\n    return next();\n  };\n\n  return (req, res, next) => {\n    // Parse original URL for path and query\n    const parsedUrl = parse(req.url ?? '/', true);\n    const originalPath = parsedUrl.pathname ?? '/';\n    const searchParams = parsedUrl.search ?? '';\n\n    // Check if there's a locale prefix in the path FIRST\n    const pathLocale = getPathLocale(originalPath);\n\n    // Bypass special Vite/server endpoints and node_modules\n    if (\n      // Custom ignore function\n      (ignore?.(req) ?? false) ||\n      originalPath.startsWith('/node_modules') ||\n      /**\n       * /^@vite/            # HMR client and helpers\n       * /^@fs/              # file-system import serving\n       * /^@id/              # virtual module ids\n       * /^@tanstack/start-router-manifest # Tanstack Start Router manifest\n       */\n      originalPath.startsWith('/@') ||\n      /**\n       * /^__vite_ping$      # health ping\n       * /^__open-in-editor$\n       * /^__manifest$       # Remix/RR7 lazyRouteDiscovery\n       */\n      originalPath.startsWith('/_')\n    ) {\n      return next();\n    }\n\n    // Static file requests (e.g. /assets/video.mp4): bypass locale routing.\n    // If the URL carries a locale prefix (e.g. /fr/assets/video.mp4),\n    // rewrite the request internally to the unprefixed path (/assets/video.mp4)\n    // so the file can be served correctly from the public directory.\n    if (originalPath.match(/\\.[a-zA-Z0-9]+$/)) {\n      if (pathLocale) {\n        const pathWithoutLocale =\n          originalPath.slice(`/${pathLocale}`.length) || '/';\n        req.url = `${pathWithoutLocale}${searchParams}`;\n      }\n      return next();\n    }\n\n    // Attempt to read the locale from storage (cookies, localStorage, etc.)\n    const storageLocale = getStorageLocale(req);\n\n    // CRITICAL FIX: If there's a valid pathLocale, it takes precedence over storage\n    // This prevents race conditions when cookies are stale during locale switches\n    const effectiveStorageLocale =\n      pathLocale && supportedLocales.includes(pathLocale)\n        ? pathLocale\n        : storageLocale;\n\n    // Store original URL for redirect tracking\n    const originalUrl = req.url;\n\n    // Domain routing: if the path locale is mapped to a different domain, redirect there.\n    // e.g. intlayer.org/zh/about → https://intlayer.zh/about\n    if (\n      process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n      !noPrefix &&\n      pathLocale &&\n      domains\n    ) {\n      const localeDomain = domains[pathLocale as keyof typeof domains];\n      if (localeDomain) {\n        const reqHost = getRequestHostname(req);\n        const domainHost = getDomainHostname(localeDomain);\n        if (domainHost !== reqHost) {\n          const rawPath = originalPath.slice(`/${pathLocale}`.length) || '/';\n          const targetOrigin = getDomainOrigin(localeDomain);\n          // Domain mapping is stable config, so a cacheable 301 is intended\n          // here — unlike locale-detection redirects, which use 302.\n          redirectUrl(req, res, `${targetOrigin}${rawPath}${searchParams}`, {\n            reason: 'domain-routing',\n            originalUrl,\n            status: 301,\n            allowCrossOrigin: true,\n          });\n          return;\n        }\n      }\n    }\n\n    // Domain routing: if the current hostname is exclusively mapped to one locale,\n    // treat it as that locale without a URL prefix.\n    // e.g. intlayer.zh/about → internally rewrite to /zh/about\n    if (\n      process.env.INTLAYER_ROUTING_DOMAINS !== 'false' &&\n      !noPrefix &&\n      !pathLocale\n    ) {\n      const reqHost = getRequestHostname(req);\n      const domainLocale = getLocaleFromDomain(reqHost, domains);\n      if (domainLocale) {\n        const canonicalPath = getCanonicalPath(\n          originalPath,\n          domainLocale,\n          rewriteRules\n        );\n\n        // Default locale without forced prefixing: pass the canonical path\n        // through unchanged, mirroring handleMissingPathLocale. Rewriting `/`\n        // to `/en/` makes TanStack Start issue a trailing-slash normalisation\n        // redirect (/en/ → /en), whose prefix the proxy then strips back to /,\n        // creating an infinite redirect loop.\n        if (!prefixDefault && domainLocale === defaultLocale) {\n          rewriteUrl(\n            req as Connect.IncomingMessage,\n            res,\n            `${canonicalPath}${searchParams}`,\n            domainLocale\n          );\n          return next();\n        }\n\n        // Never emit a trailing slash (`/zh/`): the framework would redirect\n        // it to `/zh`, which this proxy rewrites to `/zh/` again — a loop.\n        const internalPath = getInternalPath(canonicalPath, domainLocale);\n\n        rewriteUrl(\n          req as Connect.IncomingMessage,\n          res,\n          searchParams ? `${internalPath}${searchParams}` : internalPath,\n          domainLocale\n        );\n        return next();\n      }\n    }\n\n    if (noPrefix) {\n      handleNoPrefix({\n        req: req as Connect.IncomingMessage,\n        res,\n        next,\n        originalPath,\n        searchParams,\n        storageLocale: effectiveStorageLocale,\n        originalUrl,\n      });\n      return;\n    }\n\n    handlePrefix({\n      req: req as Connect.IncomingMessage,\n      res,\n      next,\n      originalPath,\n      searchParams,\n      pathLocale,\n      storageLocale: effectiveStorageLocale,\n      originalUrl,\n    });\n  };\n};\n\n/**\n * Vite plugin that provides locale-based routing middleware for **all environments**:\n * development, preview, and production SSR (Nitro / TanStack Start).\n *\n * - **Dev** (`vite dev`): registered via `configureServer`.\n * - **Preview** (`vite preview`): registered via `configurePreviewServer`.\n * - **Production Nitro** (`vite build`): automatically injected via the `.nitro` module\n *   property that `nitro/vite` reads and pushes into `nitroConfig.modules`. The module\n *   registers `intlayerNitroHandler` as a Nitro server middleware — no extra user config\n *   needed.\n *\n * If you need custom config options or an `ignore` predicate in production, bypass\n * auto-injection and create a server middleware file manually:\n *\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(\n *   createIntlayerProxyHandler({\n *     ignore: (req) => req.url?.startsWith('/api'),\n *     configOptions: myConfig,\n *   })\n * );\n * ```\n *\n * @param options - Plugin-specific options, like ignoring certain paths and Intlayer configuration overrides.\n * @returns A Vite plugin.\n *\n * @example\n * ```ts\n * import { intlayerProxy } from 'vite-intlayer';\n *\n * export default defineConfig({\n *   plugins: [intlayerProxy()],\n * });\n * ```\n *\n * @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (unset by default, which selects auto mode). Registering it separately as shown below is now optional.\n */\nexport const intlayerProxy = (options?: IntlayerProxyPluginOptions): Plugin => {\n  // Dev and preview servers run the same handler; both are \"dev servers\" as far\n  // as auto mode is concerned, so a single instance covers both hooks.\n  const handler = createIntlayerProxyHandler({ ...options, isDevServer: true });\n  const intlayerConfig = getConfiguration(options?.configOptions);\n  const logger = getAppLogger(intlayerConfig);\n\n  // Both hooks below serve a dev or preview server, hence the hard-coded true.\n  const isStorageLocaleSuppressed = !isProxyStorageLocaleEnabled(\n    resolveProxyMode(intlayerConfig.routing.enableProxy),\n    true\n  );\n\n  /**\n   * Logs that the proxy is serving requests, spelling out when auto mode has\n   * suppressed the stored locale so the reported state matches the behaviour.\n   */\n  const logProxyEnabled = () =>\n    logger(formatProxyEnabledMessage(isStorageLocaleSuppressed), {\n      level: 'info',\n    });\n\n  // Ensures the proxy registers its middleware only once, even when it is\n  // registered both via `intlayer()` (which now bundles it) and a manual\n  // `intlayerProxy()` call.\n  const guard = createPrimaryInstanceGuard(PROXY_PLUGIN_NAME);\n\n  // Set during `configResolved`: `nitro/vite` serves the *built* Nitro server\n  // from inside the preview server, and that build already carries the proxy as\n  // a Nitro middleware (see `nitroModule` below).\n  let isNitroServingPreview = false;\n\n  /**\n   * Nitro module injected automatically by `nitro/vite`.\n   *\n   * When a Vite plugin carries a `.nitro` property, `nitro/vite` pushes it into\n   * `nitroConfig.modules` during the build phase. The module's `setup` hook adds\n   * our locale-routing handler to Nitro's server pipeline, making locale detection\n   * work in production SSR builds (TanStack Start, Nuxt, etc.) without any extra\n   * user configuration.\n   *\n   * @see https://github.com/nitrojs/nitro (nitro/vite source, line ~402)\n   */\n  const nitroModule = {\n    name: 'intlayer-proxy',\n    setup(nitro: {\n      options: {\n        dev: boolean;\n        handlers: {\n          route: string;\n          handler: string;\n          middleware: boolean;\n        }[];\n      };\n    }) {\n      // In dev mode, locale routing is already handled by configureServer (Vite dev server).\n      // The Nitro dev server uses h3 v2's Web Fetch API event model which is incompatible\n      // with fromNodeMiddleware (h3 v1) and would cause double-execution anyway.\n      // Only inject for production builds where Nitro is the actual HTTP server.\n      if (nitro.options.dev) return;\n\n      const handlerPath = fileURLToPath(\n        new URL('./intlayerNitroHandler.mjs', import.meta.url)\n      );\n\n      // Skip if an identical handler was already registered by another instance\n      // (e.g. both `intlayer()` and a manual `intlayerProxy()`).\n      const alreadyRegistered = nitro.options.handlers.some(\n        (existingHandler) => existingHandler.handler === handlerPath\n      );\n      if (alreadyRegistered) return;\n\n      nitro.options.handlers.push({\n        route: '/**',\n        handler: handlerPath,\n        middleware: true,\n      });\n    },\n  };\n\n  const plugin = {\n    name: PROXY_PLUGIN_NAME,\n    // Decide whether this is the primary instance before registering middleware.\n    configResolved: (config: { plugins: readonly { name: string }[] }) => {\n      guard.resolve(config);\n      isNitroServingPreview = config.plugins.some(\n        (registeredPlugin) =>\n          registeredPlugin.name === NITRO_PREVIEW_PLUGIN_NAME\n      );\n    },\n    // Injected into nitroConfig.modules by the `nitro/vite` plugin so the\n    // locale-routing middleware is registered in the production Nitro server.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nitro: nitroModule as any,\n    // Vite dev server\n    configureServer: (server) => {\n      if (!guard.isPrimary) return;\n      logProxyEnabled();\n      server.middlewares.use(handler);\n    },\n    // Vite preview server\n    configurePreviewServer: (server) => {\n      if (!guard.isPrimary) return;\n      // With Nitro, the preview server forwards every request to the built\n      // Nitro server, whose pipeline already starts with this proxy. Adding a\n      // second layer here would run locale resolution twice on the same\n      // request: the first pass rewrites `req.url` (and the locale request\n      // header), the second pass reads that rewritten URL as if it came from\n      // the browser and can redirect it back — the redirect ping-pong that\n      // shows up as \"max redirects reached\" while prerendering.\n      if (isNitroServingPreview) return;\n      logProxyEnabled();\n      server.middlewares.use(handler);\n    },\n  } as Plugin;\n\n  // Register the plugin object so the dedupe guard can identify the primary\n  // instance by reference during `configResolved`.\n  guard.setPlugin(plugin);\n\n  return plugin;\n};\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intlayerMiddleware = intlayerProxy;\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intLayerMiddlewarePlugin = intlayerProxy;\n"],"mappings":"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"}
+{"version":3,"file":"intlayerProxyPlugin.mjs","names":[],"sources":["../../src/intlayerProxyPlugin.ts"],"sourcesContent":["import type { IncomingMessage } from 'node:http';\nimport { fileURLToPath } from 'node:url';\nimport { getAppLogger } from '@intlayer/config/logger';\nimport {\n  type GetConfigurationOptions,\n  getConfiguration,\n} from '@intlayer/config/node';\nimport {\n  formatProxyEnabledMessage,\n  isProxyStorageLocaleEnabled,\n  resolveProxyMode,\n} from '@intlayer/core/localization';\n/* @ts-ignore - Vite types error */\nimport type { Plugin } from 'vite';\nimport { createPrimaryInstanceGuard } from './dedupePlugin';\nimport {\n  createProxyHandler,\n  type NodeMiddleware,\n} from './intlayerProxyHandler';\n\nconst PROXY_PLUGIN_NAME = 'vite-intlayer-middleware-plugin';\n\n/**\n * Name of the Vite plugin `nitro/vite` registers in preview mode. It mounts the\n * built Nitro server — which already carries the Intlayer proxy as a Nitro\n * middleware — inside the Vite preview server.\n */\nconst NITRO_PREVIEW_PLUGIN_NAME = 'nitro:preview';\n\nexport type IntlayerProxyPluginOptions = {\n  /**\n   * A function that allows you to ignore specific requests from the intlayer proxy.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ ignore: (req) => req.url?.startsWith('/api') }) ],\n   * });\n   * ```\n   *\n   * @param req - The incoming request.\n   * @returns A boolean value indicating whether to ignore the request.\n   */\n  ignore?: (req: IncomingMessage) => boolean | undefined;\n  /**\n   * Optional Intlayer configuration overrides forwarded to `getConfiguration`.\n   *\n   * @example\n   * ```ts\n   * export default defineConfig({\n   *   plugins: [ intlayerProxy({ configOptions: { override: { ... } } }) ],\n   * });\n   * ```\n   */\n  configOptions?: GetConfigurationOptions;\n  /**\n   * Whether a development or preview server is serving the app.\n   *\n   * Set internally by the plugin from `configureServer` /\n   * `configurePreviewServer`. It only matters in the proxy's auto mode, where\n   * a dev server keeps locale routing URL-driven by ignoring the stored locale\n   * as a redirect source.\n   *\n   * Defaults to `false` so that mounting `createIntlayerProxyHandler()`\n   * manually — the documented production Nitro setup — keeps full behaviour.\n   *\n   * @default false\n   */\n  isDevServer?: boolean;\n};\n\n/**\n * Creates a standalone, framework-agnostic locale-routing middleware.\n *\n * It loads the Intlayer configuration and hands it to the runtime handler in\n * `intlayerProxyHandler`, so it can be used in every environment:\n *\n * - **Dev**: wired up automatically by `intlayerProxy` via `configureServer`\n * - **Preview**: wired up automatically by `intlayerProxy` via `configurePreviewServer`\n * - **Production (Nitro / TanStack Start)**: create `server/middleware/intlayerProxy.ts`:\n *\n * @example\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(createIntlayerProxyHandler());\n * ```\n *\n * @param options - Plugin-specific options, such as path ignoring and Intlayer configuration overrides.\n * @returns A Connect-compatible `(req, res, next) => void` middleware.\n */\nexport const createIntlayerProxyHandler = (\n  options?: IntlayerProxyPluginOptions\n): NodeMiddleware =>\n  createProxyHandler({\n    configuration: getConfiguration(options?.configOptions),\n    ignore: options?.ignore,\n    isDevServer: options?.isDevServer ?? false,\n  });\n\n/**\n * Vite plugin that provides locale-based routing middleware for **all environments**:\n * development, preview, and production SSR (Nitro / TanStack Start).\n *\n * - **Dev** (`vite dev`): registered via `configureServer`.\n * - **Preview** (`vite preview`): registered via `configurePreviewServer`.\n * - **Production Nitro** (`vite build`): automatically injected via the `.nitro` module\n *   property that `nitro/vite` reads and pushes into `nitroConfig.modules`. The module\n *   registers `intlayerNitroHandler` as a Nitro server middleware — no extra user config\n *   needed.\n *\n * If you need custom config options or an `ignore` predicate in production, bypass\n * auto-injection and create a server middleware file manually:\n *\n * ```ts\n * // server/middleware/intlayerProxy.ts\n * import { fromNodeMiddleware } from 'h3';\n * import { createIntlayerProxyHandler } from 'vite-intlayer';\n *\n * export default fromNodeMiddleware(\n *   createIntlayerProxyHandler({\n *     ignore: (req) => req.url?.startsWith('/api'),\n *     configOptions: myConfig,\n *   })\n * );\n * ```\n *\n * @param options - Plugin-specific options, like ignoring certain paths and Intlayer configuration overrides.\n * @returns A Vite plugin.\n *\n * @example\n * ```ts\n * import { intlayerProxy } from 'vite-intlayer';\n *\n * export default defineConfig({\n *   plugins: [intlayerProxy()],\n * });\n * ```\n *\n * @deprecated Since Intlayer v9, `intlayerProxy()` is bundled directly into the `intlayer()` plugin and enabled by default through the `routing.enableProxy` option (unset by default, which selects auto mode). Registering it separately as shown below is now optional.\n */\nexport const intlayerProxy = (options?: IntlayerProxyPluginOptions): Plugin => {\n  // Dev and preview servers run the same handler; both are \"dev servers\" as far\n  // as auto mode is concerned, so a single instance covers both hooks.\n  const handler = createIntlayerProxyHandler({ ...options, isDevServer: true });\n  const intlayerConfig = getConfiguration(options?.configOptions);\n  const logger = getAppLogger(intlayerConfig);\n\n  // Both hooks below serve a dev or preview server, hence the hard-coded true.\n  const isStorageLocaleSuppressed = !isProxyStorageLocaleEnabled(\n    resolveProxyMode(intlayerConfig.routing.enableProxy),\n    true\n  );\n\n  /**\n   * Logs that the proxy is serving requests, spelling out when auto mode has\n   * suppressed the stored locale so the reported state matches the behaviour.\n   */\n  const logProxyEnabled = () =>\n    logger(formatProxyEnabledMessage(isStorageLocaleSuppressed), {\n      level: 'info',\n    });\n\n  // Ensures the proxy registers its middleware only once, even when it is\n  // registered both via `intlayer()` (which now bundles it) and a manual\n  // `intlayerProxy()` call.\n  const guard = createPrimaryInstanceGuard(PROXY_PLUGIN_NAME);\n\n  // Set during `configResolved`: `nitro/vite` serves the *built* Nitro server\n  // from inside the preview server, and that build already carries the proxy as\n  // a Nitro middleware (see `nitroModule` below).\n  let isNitroServingPreview = false;\n\n  /**\n   * Nitro module injected automatically by `nitro/vite`.\n   *\n   * When a Vite plugin carries a `.nitro` property, `nitro/vite` pushes it into\n   * `nitroConfig.modules` during the build phase. The module's `setup` hook adds\n   * our locale-routing handler to Nitro's server pipeline, making locale detection\n   * work in production SSR builds (TanStack Start, Nuxt, etc.) without any extra\n   * user configuration.\n   *\n   * @see https://github.com/nitrojs/nitro (nitro/vite source, line ~402)\n   */\n  const nitroModule = {\n    name: 'intlayer-proxy',\n    setup(nitro: {\n      options: {\n        dev: boolean;\n        handlers: {\n          route: string;\n          handler: string;\n          middleware: boolean;\n        }[];\n      };\n    }) {\n      // In dev mode, locale routing is already handled by configureServer (Vite dev server).\n      // The Nitro dev server uses h3 v2's Web Fetch API event model which is incompatible\n      // with fromNodeMiddleware (h3 v1) and would cause double-execution anyway.\n      // Only inject for production builds where Nitro is the actual HTTP server.\n      if (nitro.options.dev) return;\n\n      const handlerPath = fileURLToPath(\n        new URL('./intlayerNitroHandler.mjs', import.meta.url)\n      );\n\n      // Skip if an identical handler was already registered by another instance\n      // (e.g. both `intlayer()` and a manual `intlayerProxy()`).\n      const alreadyRegistered = nitro.options.handlers.some(\n        (existingHandler) => existingHandler.handler === handlerPath\n      );\n      if (alreadyRegistered) return;\n\n      nitro.options.handlers.push({\n        route: '/**',\n        handler: handlerPath,\n        middleware: true,\n      });\n    },\n  };\n\n  const plugin = {\n    name: PROXY_PLUGIN_NAME,\n    // Decide whether this is the primary instance before registering middleware.\n    configResolved: (config: { plugins: readonly { name: string }[] }) => {\n      guard.resolve(config);\n      isNitroServingPreview = config.plugins.some(\n        (registeredPlugin) =>\n          registeredPlugin.name === NITRO_PREVIEW_PLUGIN_NAME\n      );\n    },\n    // Injected into nitroConfig.modules by the `nitro/vite` plugin so the\n    // locale-routing middleware is registered in the production Nitro server.\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    nitro: nitroModule as any,\n    // Vite dev server\n    configureServer: (server) => {\n      if (!guard.isPrimary) return;\n      logProxyEnabled();\n      server.middlewares.use(handler);\n    },\n    // Vite preview server\n    configurePreviewServer: (server) => {\n      if (!guard.isPrimary) return;\n      // With Nitro, the preview server forwards every request to the built\n      // Nitro server, whose pipeline already starts with this proxy. Adding a\n      // second layer here would run locale resolution twice on the same\n      // request: the first pass rewrites `req.url` (and the locale request\n      // header), the second pass reads that rewritten URL as if it came from\n      // the browser and can redirect it back — the redirect ping-pong that\n      // shows up as \"max redirects reached\" while prerendering.\n      if (isNitroServingPreview) return;\n      logProxyEnabled();\n      server.middlewares.use(handler);\n    },\n  } as Plugin;\n\n  // Register the plugin object so the dedupe guard can identify the primary\n  // instance by reference during `configResolved`.\n  guard.setPlugin(plugin);\n\n  return plugin;\n};\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intlayerMiddleware = intlayerProxy;\n\n/**\n * @deprecated Rename to intlayerProxy instead\n *\n * A Vite plugin that integrates a logic similar to the Next.js intlayer middleware.\n *\n * ```ts\n * // Example usage of the plugin in a Vite configuration\n * export default defineConfig({\n *   plugins: [ intlayerMiddleware() ],\n * });\n * ```\n */\nexport const intLayerMiddlewarePlugin = intlayerProxy;\n"],"mappings":";;;;;;;;AAoBA,MAAM,oBAAoB;;;;;;AAO1B,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;AAkElC,MAAa,8BACX,YAEA,mBAAmB;CACjB,eAAe,iBAAiB,SAAS,aAAa;CACtD,QAAQ,SAAS;CACjB,aAAa,SAAS,eAAe;AACvC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2CH,MAAa,iBAAiB,YAAiD;CAG7E,MAAM,UAAU,2BAA2B;EAAE,GAAG;EAAS,aAAa;CAAK,CAAC;CAC5E,MAAM,iBAAiB,iBAAiB,SAAS,aAAa;CAC9D,MAAM,SAAS,aAAa,cAAc;CAG1C,MAAM,4BAA4B,CAAC,4BACjC,iBAAiB,eAAe,QAAQ,WAAW,GACnD,IACF;;;;;CAMA,MAAM,wBACJ,OAAO,0BAA0B,yBAAyB,GAAG,EAC3D,OAAO,OACT,CAAC;CAKH,MAAM,QAAQ,2BAA2B,iBAAiB;CAK1D,IAAI,wBAAwB;CAkD5B,MAAM,SAAS;EACb,MAAM;EAEN,iBAAiB,WAAqD;GACpE,MAAM,QAAQ,MAAM;GACpB,wBAAwB,OAAO,QAAQ,MACpC,qBACC,iBAAiB,SAAS,yBAC9B;EACF;EAIA,OAAO;GAjDP,MAAM;GACN,MAAM,OASH;IAKD,IAAI,MAAM,QAAQ,KAAK;IAEvB,MAAM,cAAc,cAClB,IAAI,IAAI,8BAA8B,YAAY,GAAG,CACvD;IAOA,IAH0B,MAAM,QAAQ,SAAS,MAC9C,oBAAoB,gBAAgB,YAAY,WAE/B,GAAG;IAEvB,MAAM,QAAQ,SAAS,KAAK;KAC1B,OAAO;KACP,SAAS;KACT,YAAY;IACd,CAAC;GACH;EAgBiB;EAEjB,kBAAkB,WAAW;GAC3B,IAAI,CAAC,MAAM,WAAW;GACtB,gBAAgB;GAChB,OAAO,YAAY,IAAI,OAAO;EAChC;EAEA,yBAAyB,WAAW;GAClC,IAAI,CAAC,MAAM,WAAW;GAQtB,IAAI,uBAAuB;GAC3B,gBAAgB;GAChB,OAAO,YAAY,IAAI,OAAO;EAChC;CACF;CAIA,MAAM,UAAU,MAAM;CAEtB,OAAO;AACT;;;;;;;;;;;;;AAcA,MAAa,qBAAqB;;;;;;;;;;;;;AAclC,MAAa,2BAA2B"}

package/dist/types/index.d.ts

@@ -1,7 +1,9 @@
 import { IntlayerCompilerOptions, intlayerCompiler } from "./IntlayerCompilerPlugin.js";
+import { ChunkingContext, DictionaryModule, ModuleGraphNode, createDictionaryModuleParser, intlayerChunk, resolveBoundaries, toBoundaryName } from "./intlayerChunkPlugin.js";
 import { intlayerMinify } from "./intlayerMinifyPlugin.js";
 import { intlayerOptimize } from "./intlayerOptimizePlugin.js";
 import { IntlayerProxyPluginOptions, createIntlayerProxyHandler, intLayerMiddlewarePlugin, intlayerMiddleware, intlayerProxy } from "./intlayerProxyPlugin.js";
 import { IntlayerPluginOptions, intLayerPlugin, intlayer, intlayerPlugin } from "./intlayerPlugin.js";
+import { intlayerPreload } from "./intlayerPreloadPlugin.js";
 import { intlayerPrune } from "./intlayerPrunePlugin.js";
-export { IntlayerCompilerOptions, IntlayerPluginOptions, IntlayerProxyPluginOptions, createIntlayerProxyHandler, intLayerMiddlewarePlugin, intLayerPlugin, intlayer, intlayerCompiler, intlayerMiddleware, intlayerMinify, intlayerOptimize, intlayerPlugin, intlayerProxy, intlayerPrune };
+export { ChunkingContext, DictionaryModule, IntlayerCompilerOptions, IntlayerPluginOptions, IntlayerProxyPluginOptions, ModuleGraphNode, createDictionaryModuleParser, createIntlayerProxyHandler, intLayerMiddlewarePlugin, intLayerPlugin, intlayer, intlayerChunk, intlayerCompiler, intlayerMiddleware, intlayerMinify, intlayerOptimize, intlayerPlugin, intlayerPreload, intlayerProxy, intlayerPrune, resolveBoundaries, toBoundaryName };