@salesforce/storefront-next-runtime 0.3.1 → 0.4.0-alpha.1

package/dist/site-context2.js

@@ -0,0 +1,513 @@
+import { createContext, useContext, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+import { createContext as createContext$1, createCookie } from "react-router";
+
+//#region src/site-context/site-context.tsx
+const SiteContext = createContext(void 0);
+/**
+* Provides the current site context (site, locale, language, currency) to the component tree.
+*
+* Mounted in the template's root.tsx with the resolved values from the
+* loader/middleware. The SDK has no react-i18next dependency, so `language`
+* is passed as a prop from the template.
+*/
+function SiteProvider({ site, locale, language, currency, children }) {
+	const value = useMemo(() => ({
+		site,
+		locale,
+		language,
+		currency
+	}), [
+		site,
+		locale,
+		language,
+		currency
+	]);
+	return /* @__PURE__ */ jsx(SiteContext.Provider, {
+		value,
+		children
+	});
+}
+/**
+* React hook to get the current site context.
+* Returns `{ site, locale, language, currency }`.
+* @throws If called outside of a SiteProvider
+*/
+function useSite() {
+	const value = useContext(SiteContext);
+	if (!value) throw new Error("useSite must be used within a SiteProvider");
+	return value;
+}
+
+//#endregion
+//#region src/site-context/build-url.ts
+/**
+* Parses search config string into key-value pairs, preserving ':param' placeholders.
+* '?lng=:localeId&site=:siteId' → { lng: ':localeId', site: ':siteId' }
+*/
+function parseSearchConfig(search) {
+	const searchParams = new URLSearchParams(search);
+	const result = {};
+	for (const [key, value] of searchParams) result[key] = value;
+	return result;
+}
+/**
+* Extracts parameter names from a prefix string.
+* '/:siteId/:localeId' → ['siteId', 'localeId']
+*/
+function extractPrefixParams(prefix) {
+	const matches = prefix.match(/:(\w+)/g);
+	return matches ? matches.map((m) => m.slice(1)) : [];
+}
+/**
+* Splits a URL string into its component parts.
+* '/product/123?color=red#details' → { pathname: '/product/123', search: 'color=red', hash: '#details' }
+*/
+function decomposeUrl(url) {
+	const hashIdx = url.indexOf("#");
+	const hash = hashIdx >= 0 ? url.slice(hashIdx) : "";
+	const withoutHash = hashIdx >= 0 ? url.slice(0, hashIdx) : url;
+	const searchIdx = withoutHash.indexOf("?");
+	const search = searchIdx >= 0 ? withoutHash.slice(searchIdx + 1) : "";
+	return {
+		pathname: searchIdx >= 0 ? withoutHash.slice(0, searchIdx) : withoutHash,
+		search,
+		hash
+	};
+}
+/**
+* Resolves a prefix template by replacing parameter placeholders with values.
+* ('/:siteId/:localeId', { siteId: 'global', localeId: 'en-GB' }) → '/global/en-GB'
+*/
+function resolvePrefix(prefix, params) {
+	let resolved = prefix;
+	for (const paramName of extractPrefixParams(prefix)) {
+		const value = params[paramName];
+		if (value) resolved = resolved.replace(`:${paramName}`, value);
+	}
+	return resolved;
+}
+/**
+* Strips the URL prefix segments from a pathname based on a prefix pattern.
+* Since all routes are configured with the prefix baked in, segment counting is sufficient.
+*
+* @param pathname - Full pathname (e.g. '/global/en-GB/checkout')
+* @param prefixPattern - URL prefix pattern from config (e.g. '/:siteId/:localeId')
+* @returns Pathname with prefix stripped (e.g. '/checkout'), or original if
+*          the pathname has fewer segments than the prefix
+*
+* @example
+* stripPathPrefix('/global/en-GB/checkout', '/:siteId/:localeId') // → '/checkout'
+* stripPathPrefix('/checkout', '/:siteId/:localeId')              // → '/checkout' (fewer segments → unchanged)
+* stripPathPrefix('/checkout', '')                                 // → '/checkout' (no prefix configured)
+* stripPathPrefix('/', '/:siteId/:localeId')                      // → '/'
+*/
+function stripPathPrefix(pathname, prefixPattern) {
+	if (!prefixPattern) return pathname;
+	const prefixSegmentCount = prefixPattern.split("/").filter(Boolean).length;
+	const pathSegments = pathname.split("/").filter(Boolean);
+	if (pathSegments.length <= prefixSegmentCount) return pathSegments.length === prefixSegmentCount ? "/" : pathname;
+	return `/${pathSegments.slice(prefixSegmentCount).join("/")}`;
+}
+/**
+* Sanitize a resolved prefix from a pathname if present.
+* sanitizePrefix('/global/en-GB/product/123', '/global/en-GB') → '/product/123'
+* sanitizePrefix('/product/123', '/global/en-GB') → '/product/123'   (no-op)
+*/
+function sanitizePrefix(pathname, pathPrefix) {
+	if (!pathPrefix) return pathname;
+	if (pathname === pathPrefix) return "";
+	if (pathname.startsWith(`${pathPrefix}/`)) return pathname.slice(pathPrefix.length);
+	return pathname;
+}
+/**
+* Builds a fully-qualified URL with site context prefix and search params.
+*
+* Only keys defined in urlConfig.search are set by site context. Any other query params
+* already present on the `to` URL (including duplicate keys) are preserved as-is.
+* e.g. to='/api/search?refine=color:blue&refine=size:M', search='?lng=:localeId'
+*   → '/api/search?refine=color:blue&refine=size:M&lng=en-GB'
+*
+* @example
+* buildUrl({ to: '/product/123', urlConfig: { prefix: '/:siteId', search: '?lng=:localeId' }, params: { siteId: 'global', localeId: 'en-GB' } })
+* // → '/global/product/123?lng=en-GB'
+*/
+function buildUrl({ to, urlConfig, params }) {
+	if (!urlConfig) return to;
+	if (!to || to === "#" || to.startsWith("http") || to.startsWith("//")) return to;
+	const { pathname, search: existingSearch, hash } = decomposeUrl(to);
+	const pathPrefix = urlConfig.prefix && urlConfig.prefix !== "/" ? resolvePrefix(urlConfig.prefix, params) : "";
+	const path = pathPrefix ? `${pathPrefix}${sanitizePrefix(pathname, pathPrefix)}` : pathname;
+	const searchParams = new URLSearchParams(existingSearch);
+	if (urlConfig.search) {
+		const searchConfig = parseSearchConfig(urlConfig.search);
+		for (const [queryKey, value] of Object.entries(searchConfig)) if (value.startsWith(":")) {
+			const paramValue = params[value.slice(1)];
+			if (paramValue) searchParams.set(queryKey, paramValue);
+		} else searchParams.set(queryKey, value);
+	}
+	const search = searchParams.toString();
+	return `${path}${search ? `?${search}` : ""}${hash}`;
+}
+
+//#endregion
+//#region src/site-context/utils.ts
+/**
+* Extract a string value from the URL path segment at the given index.
+*/
+function lookupFromPath(pathname, pathIndex) {
+	const pathSegments = pathname.split("/").filter(Boolean);
+	if (pathSegments.length <= pathIndex) return null;
+	return pathSegments[pathIndex];
+}
+/**
+* Detect a string value from cookie using the given cookie parser.
+*
+* Returns a promise that resolves to the cookie value.
+*/
+async function readCookieFromRequest(request, cookie) {
+	const cookies = request.headers.get("Cookie");
+	if (!cookies) return null;
+	return await cookie.parse(cookies);
+}
+
+//#endregion
+//#region src/site-context/site-detection.ts
+/**
+* Detect site reference from cookie.
+*/
+async function readSiteFromCookie(request, cookie) {
+	return readCookieFromRequest(request, cookie);
+}
+/**
+* Get site object using the site id or alias
+* 1. Check siteIdentifier against each site's alias; if matched, return that site.
+* 2. Else check against each site's id; if matched, return that site.
+* 3. If no match, return null.
+*/
+function getSiteFromIdOrAlias(siteIdentifier, sites) {
+	if (!siteIdentifier) return null;
+	return sites.find((site) => site.alias === siteIdentifier || site.id === siteIdentifier) ?? null;
+}
+/**
+* Resolve site using the configured detection order.
+* Returns the first valid site from the first source that yields a valid value.
+*/
+async function resolveSite(request, settings) {
+	const { sites, defaultSiteId, siteDetectionConfig, siteCookie } = settings;
+	const requestUrl = new URL(request.url);
+	const basePathOffset = process.env.MRT_ENV_BASE_PATH ? process.env.MRT_ENV_BASE_PATH.split("/").filter(Boolean).length : 0;
+	const resolvers = {
+		path: () => Promise.resolve(lookupFromPath(requestUrl.pathname, siteDetectionConfig.lookupFromPathIndex + basePathOffset)),
+		querystring: () => Promise.resolve(requestUrl.searchParams.get(siteDetectionConfig.lookupQuerystring)),
+		header: () => Promise.resolve(request.headers.get(siteDetectionConfig.lookupHeader)),
+		cookie: async () => readSiteFromCookie(request, siteCookie)
+	};
+	for (const method of siteDetectionConfig.order) {
+		const resolvedSite = getSiteFromIdOrAlias(await resolvers[method]?.(), sites);
+		if (resolvedSite) return resolvedSite;
+	}
+	const site = getSiteFromIdOrAlias(defaultSiteId, sites);
+	if (!site) throw new Error(`Default site ${defaultSiteId} not found.`);
+	return site;
+}
+
+//#endregion
+//#region src/site-context/configs.ts
+const DEFAULT_CURRENCY_COOKIE_NAME = "currency";
+/**
+* Default site detection configuration
+*/
+const DEFAULT_SITE_DETECTION = {
+	order: [
+		"path",
+		"querystring",
+		"cookie",
+		"header"
+	],
+	lookupFromPathIndex: 0,
+	lookupQuerystring: "site",
+	lookupCookie: "site_id",
+	lookupHeader: "X-Site-Id",
+	caches: ["cookie"]
+};
+/**
+* Default locale detection configuration
+*/
+const DEFAULT_LOCALE_DETECTION = {
+	order: [
+		"path",
+		"querystring",
+		"cookie",
+		"header"
+	],
+	lookupFromPathIndex: 1,
+	lookupQuerystring: "lng",
+	lookupCookie: "lng",
+	lookupHeader: "Accept-Language",
+	caches: ["cookie"]
+};
+
+//#endregion
+//#region src/site-context/cookies.ts
+/**
+* Cookie options for site context cookies (site and locale)
+*/
+const COOKIE_OPTIONS = {
+	path: "/",
+	sameSite: "lax",
+	secure: process.env.NODE_ENV === "production",
+	httpOnly: true
+};
+/**
+* Creates a cookie instance with the given name.
+*
+* @param name - Cookie name
+* @returns Cookie instance configured with site context options
+*/
+function createSiteContextCookie(name, options) {
+	return createCookie(name, {
+		...COOKIE_OPTIONS,
+		...options
+	});
+}
+/**
+* Creates a currency cookie instance with the given name.
+*
+* @param name - Cookie name
+* @returns Cookie instance configured with site context cookie options
+*/
+function createCurrencyCookie(name, options) {
+	return createCookie(name, {
+		...COOKIE_OPTIONS,
+		...options
+	});
+}
+/**
+* WeakMap to pass resolved locale from site context middleware to i18next's findLocale.
+* WeakMap allows garbage collection when requests are done.
+* This is necessary because findLocale() only receives the Request object, not the router context.
+*/
+const requestToLocaleMap = /* @__PURE__ */ new WeakMap();
+
+//#endregion
+//#region src/site-context/locale-detection.ts
+/**
+* Read locale from cookie.
+*/
+async function readLocaleFromCookie(request, cookie) {
+	return readCookieFromRequest(request, cookie);
+}
+/**
+* Get locale object using the locale id or alias.
+* 1. Check localeIdOrAlias against each locale's alias; if matched, return that locale.
+* 2. Else check against each locale's id; if matched, return that locale.
+* 3. If no match, return null (caller should use defaultLocale).
+*
+* @param localeIdentifier - The locale id or alias to get the locale from. Null is allowed because this may come from
+* extrenal sources such as cookies, headers, or query parameters.
+* @param locales - The list of locales to search through.
+* @returns The locale object if found, otherwise null.
+*/
+function getLocaleFromIdOrAlias(localeIdentifier, locales) {
+	if (!localeIdentifier) return null;
+	return locales.find((locale) => locale.alias === localeIdentifier || locale.id === localeIdentifier) ?? null;
+}
+/**
+* Resolve locale using the configured detection order.
+* Returns the first valid locale from the first source that yields a valid value.
+*/
+async function resolveLocale(request, settings, site) {
+	const { defaultLocale, localeDetectionConfig, localeCookie } = settings;
+	const { supportedLocales } = site;
+	let locale = null;
+	const requestUrl = new URL(request.url);
+	const basePathOffset = process.env.MRT_ENV_BASE_PATH ? process.env.MRT_ENV_BASE_PATH.split("/").filter(Boolean).length : 0;
+	const resolvers = {
+		path: () => Promise.resolve(lookupFromPath(requestUrl.pathname, localeDetectionConfig.lookupFromPathIndex + basePathOffset)),
+		querystring: () => Promise.resolve(requestUrl.searchParams.get(localeDetectionConfig.lookupQuerystring)),
+		header: () => Promise.resolve(request.headers.get(localeDetectionConfig.lookupHeader)),
+		cookie: async () => readLocaleFromCookie(request, localeCookie)
+	};
+	for (const method of localeDetectionConfig.order) {
+		const resolvedLocale = getLocaleFromIdOrAlias(await resolvers[method]?.(), supportedLocales);
+		if (resolvedLocale) return resolvedLocale;
+	}
+	if (!locale) locale = getLocaleFromIdOrAlias(defaultLocale, supportedLocales);
+	if (!locale) throw new Error(`Default locale ${defaultLocale} not found in the list of supported locales for site ${site.id}.`);
+	return locale;
+}
+
+//#endregion
+//#region src/site-context/currency-detection.ts
+/**
+* Resolve the currency for the current request.
+*
+* Priority:
+* 1. Cookie (user-selected currency, if valid for this site)
+* 2. Locale's preferred currency (if valid for this site)
+* 3. Site's default currency
+*
+* @param request - Incoming request
+* @param currencyCookie - Cookie instance for reading the currency cookie
+* @param site - Resolved site for this request
+* @param locale - Resolved locale for this request
+* @returns The resolved currency code
+*/
+async function resolveCurrency(request, currencyCookie, site, locale) {
+	const { supportedCurrencies, defaultCurrency } = site;
+	if (!supportedCurrencies || supportedCurrencies.length === 0) throw new Error(`Site "${site.id}" must have supportedCurrencies configured.`);
+	const cookieValue = await readCookieFromRequest(request, currencyCookie);
+	if (typeof cookieValue === "string" && supportedCurrencies.includes(cookieValue)) return cookieValue;
+	if (locale.preferredCurrency && supportedCurrencies.includes(locale.preferredCurrency)) return locale.preferredCurrency;
+	return defaultCurrency;
+}
+
+//#endregion
+//#region src/site-context/middleware.ts
+const siteContext = createContext$1(null);
+/**
+* Resolve site, locale, and currency from a request in one call.
+*
+* This is the recommended public entry point for site-context resolution.
+* It encapsulates the required resolution order (site → locale → currency)
+* so consumers don't need to manage the dependency chain manually.
+*
+* The individual resolvers (`resolveSite`, `resolveLocale`, `resolveCurrency`)
+* are available as advanced utilities for cases that need fine-grained control.
+*
+* @param request - Incoming HTTP request
+* @param settings - Fully resolved site settings (with detection config and cookies)
+* @returns Resolved site, locale, and currency
+*
+* @example
+* ```typescript
+* const { site, locale, currency } = await resolveSiteContext(request, settings);
+* ```
+*/
+async function resolveSiteContext(request, settings) {
+	const site = await resolveSite(request, settings);
+	const locale = await resolveLocale(request, settings, site);
+	return {
+		site,
+		locale,
+		currency: await resolveCurrency(request, settings.currencyCookie, site, locale)
+	};
+}
+/**
+* Helper function to get site context cookies from router context.
+* Useful in server actions and loaders that need to read/set cookies.
+*
+* @param context - Router context provider
+* @returns Object with siteCookie and localeCookie instances, or null if context not set
+*
+* @example
+* ```typescript
+* export const action: ActionFunction = async ({ request, context }) => {
+*     const cookies = getSiteContextCookies(context);
+*     if (cookies) {
+*         const cookieHeader = await cookies.localeCookie.serialize(locale);
+*         // ... use cookieHeader
+*     }
+* };
+* ```
+*/
+function getSiteContextCookies(context) {
+	const siteCtx = context.get(siteContext);
+	if (!siteCtx) return null;
+	return {
+		siteCookie: siteCtx.siteCookie,
+		localeCookie: siteCtx.localeCookie,
+		currencyCookie: siteCtx.currencyCookie
+	};
+}
+/**
+* Helper function to determine if cookies should be set based on:
+* 1. Whether caching is enabled for each cookie type
+* 2. Whether the resolved value differs from the existing cookie
+* 3. Whether cookies were already set by actions/loaders in the response
+*
+* @param request - Incoming request
+* @param response - Response from next()
+* @param settings - Site context settings with cookie instances and detection config
+* @param site - Resolved site for this request
+* @param locale - Resolved locale for this request
+* @param currency - Resolved currency for this request
+* @returns Object with shouldSetSiteCookie, shouldSetLocaleCookie, and shouldSetCurrencyCookie booleans
+*/
+async function shouldSetCookies(request, response, settings, site, locale, currency) {
+	const cacheSite = settings.siteDetectionConfig.caches?.includes("cookie");
+	const cacheLocale = settings.localeDetectionConfig.caches?.includes("cookie");
+	const responseSetCookies = response.headers.getSetCookie?.() || [];
+	const isSettingSiteCookieInResponse = responseSetCookies.some((cookie) => cookie.startsWith(`${settings.siteCookie.name}=`));
+	const isSettingLocaleCookieInResponse = responseSetCookies.some((cookie) => cookie.startsWith(`${settings.localeCookie.name}=`));
+	const isSettingCurrencyCookieInResponse = responseSetCookies.some((cookie) => cookie.startsWith(`${settings.currencyCookie.name}=`));
+	const requestCookieHeader = request.headers.get("Cookie");
+	const [existingSiteCookie, existingLocaleCookie, existingCurrencyCookie] = await Promise.all([
+		settings.siteCookie.parse(requestCookieHeader),
+		settings.localeCookie.parse(requestCookieHeader),
+		settings.currencyCookie.parse(requestCookieHeader)
+	]);
+	return {
+		shouldSetSiteCookie: cacheSite && !isSettingSiteCookieInResponse && existingSiteCookie !== site.id,
+		shouldSetLocaleCookie: cacheLocale && !isSettingLocaleCookieInResponse && existingLocaleCookie !== locale.id,
+		shouldSetCurrencyCookie: !isSettingCurrencyCookieInResponse && existingCurrencyCookie !== currency
+	};
+}
+/**
+* Creates a site context middleware that resolves the current site from
+* the request (path, cookie, header, query, or default) and stores the
+* result in the router context.
+*
+* Does not import or read from app config context; the consumer supplies config.
+*/
+function createSiteContextMiddleware(config) {
+	const siteDetectionConfig = {
+		...DEFAULT_SITE_DETECTION,
+		...config.siteDetectionConfig
+	};
+	const localeDetectionConfig = {
+		...DEFAULT_LOCALE_DETECTION,
+		...config.localeDetectionConfig
+	};
+	const siteCookie = createSiteContextCookie(siteDetectionConfig.lookupCookie, config.cookieOptions);
+	const localeCookie = createSiteContextCookie(localeDetectionConfig.lookupCookie, config.cookieOptions);
+	const currencyCookie = createCurrencyCookie(config.currencyCookieName ?? DEFAULT_CURRENCY_COOKIE_NAME, config.cookieOptions);
+	const settings = {
+		...config,
+		siteDetectionConfig,
+		localeDetectionConfig,
+		siteCookie,
+		localeCookie,
+		currencyCookie
+	};
+	const siteContextMiddleware = async ({ request, context }, next) => {
+		const { site, locale, currency } = await resolveSiteContext(request, settings);
+		context.set(siteContext, {
+			site,
+			locale,
+			currency,
+			siteCookie: settings.siteCookie,
+			localeCookie: settings.localeCookie,
+			currencyCookie: settings.currencyCookie
+		});
+		requestToLocaleMap.set(request, locale.id);
+		const response = await next();
+		const { shouldSetSiteCookie, shouldSetLocaleCookie, shouldSetCurrencyCookie } = await shouldSetCookies(request, response, settings, site, locale, currency);
+		if (!shouldSetSiteCookie && !shouldSetLocaleCookie && !shouldSetCurrencyCookie) return response;
+		const [siteSetCookie, localeSetCookie, currencySetCookie] = await Promise.all([
+			shouldSetSiteCookie ? settings.siteCookie.serialize(site.id, { path: "/" }) : Promise.resolve(null),
+			shouldSetLocaleCookie ? settings.localeCookie.serialize(locale.id, { path: "/" }) : Promise.resolve(null),
+			shouldSetCurrencyCookie ? settings.currencyCookie.serialize(currency) : Promise.resolve(null)
+		]);
+		if (siteSetCookie) response.headers.append("Set-Cookie", siteSetCookie);
+		if (localeSetCookie) response.headers.append("Set-Cookie", localeSetCookie);
+		if (currencySetCookie) response.headers.append("Set-Cookie", currencySetCookie);
+		return response;
+	};
+	return siteContextMiddleware;
+}
+
+//#endregion
+export { requestToLocaleMap as a, sanitizePrefix as c, useSite as d, siteContext as i, stripPathPrefix as l, getSiteContextCookies as n, buildUrl as o, resolveSiteContext as r, resolvePrefix as s, createSiteContextMiddleware as t, SiteProvider as u };
+//# sourceMappingURL=site-context2.js.map

package/dist/site-context2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-context2.js","names":["result: Record<string, string>","resolvers: Record<DetectionMethod, () => Promise<string | null>>","DEFAULT_SITE_DETECTION: Required<DetectionConfig>","DEFAULT_LOCALE_DETECTION: Required<DetectionConfig>","locale: Locale | null","resolvers: Record<DetectionMethod, () => Promise<string | null>>","createContext","siteDetectionConfig: SiteSettings['siteDetectionConfig']","localeDetectionConfig: SiteSettings['localeDetectionConfig']","settings: SiteSettings","siteContextMiddleware: MiddlewareFunction<Response>"],"sources":["../src/site-context/site-context.tsx","../src/site-context/build-url.ts","../src/site-context/utils.ts","../src/site-context/site-detection.ts","../src/site-context/configs.ts","../src/site-context/cookies.ts","../src/site-context/locale-detection.ts","../src/site-context/currency-detection.ts","../src/site-context/middleware.ts"],"sourcesContent":["/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport { createContext, useContext, useMemo, type PropsWithChildren } from 'react';\nimport type { Locale, Site } from './types';\n\n/**\n * The value provided by {@link SiteProvider} and returned by {@link useSite}.\n */\nexport type SiteContextValue = {\n    /**\n     * The resolved site configuration object for the current request.\n     * Contains the site's supported locales, supported currencies, and default values.\n     */\n    site: Site;\n\n    /**\n     * The full locale object from the site's `supportedLocales` list for the current request.\n     * Contains structured locale metadata: `id` (e.g. `\"en-GB\"`), optional `alias` (e.g. `\"en\"`),\n     * and optional `preferredCurrency`.\n     *\n     */\n    locale: Locale;\n\n    /**\n     * The current i18next language string (e.g. `\"en-GB\"`, `\"fr-FR\"`).\n     * This is the value returned by `i18next.language` and drives which translation\n     * namespace is active. Passed as a prop because the SDK has no react-i18next dependency.\n     *\n     * @see {@link SiteContextValue.locale} for the full locale object from site config.\n     */\n    language: string;\n\n    /**\n     * The active currency code for the current session (e.g. `\"USD\"`, `\"GBP\"`).\n     * Resolved from the locale's `preferredCurrency`, a currency cookie, or the site's\n     * `defaultCurrency`.\n     */\n    currency: string;\n};\n\nconst SiteContext = createContext<SiteContextValue | undefined>(undefined);\n\n/**\n * Provides the current site context (site, locale, language, currency) to the component tree.\n *\n * Mounted in the template's root.tsx with the resolved values from the\n * loader/middleware. The SDK has no react-i18next dependency, so `language`\n * is passed as a prop from the template.\n */\nexport function SiteProvider({ site, locale, language, currency, children }: PropsWithChildren<SiteContextValue>) {\n    const value = useMemo(() => ({ site, locale, language, currency }), [site, locale, language, currency]);\n    return <SiteContext.Provider value={value}>{children}</SiteContext.Provider>;\n}\n\n/**\n * React hook to get the current site context.\n * Returns `{ site, locale, language, currency }`.\n * @throws If called outside of a SiteProvider\n */\n// eslint-disable-next-line react-refresh/only-export-components\nexport function useSite(): SiteContextValue {\n    const value = useContext(SiteContext);\n    if (!value) {\n        throw new Error('useSite must be used within a SiteProvider');\n    }\n    return value;\n}\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport type { Url } from '../config/types';\n\n/**\n * Parses search config string into key-value pairs, preserving ':param' placeholders.\n * '?lng=:localeId&site=:siteId' → { lng: ':localeId', site: ':siteId' }\n */\nexport function parseSearchConfig(search: string): Record<string, string> {\n    const searchParams = new URLSearchParams(search);\n    const result: Record<string, string> = {};\n    for (const [key, value] of searchParams) {\n        result[key] = value;\n    }\n    return result;\n}\n\n/**\n * Extracts parameter names from a prefix string.\n * '/:siteId/:localeId' → ['siteId', 'localeId']\n */\nexport function extractPrefixParams(prefix: string): string[] {\n    const matches = prefix.match(/:(\\w+)/g);\n    return matches ? matches.map((m) => m.slice(1)) : [];\n}\n\n/**\n * Splits a URL string into its component parts.\n * '/product/123?color=red#details' → { pathname: '/product/123', search: 'color=red', hash: '#details' }\n */\nexport function decomposeUrl(url: string): { pathname: string; search: string; hash: string } {\n    const hashIdx = url.indexOf('#');\n    const hash = hashIdx >= 0 ? url.slice(hashIdx) : '';\n    const withoutHash = hashIdx >= 0 ? url.slice(0, hashIdx) : url;\n    const searchIdx = withoutHash.indexOf('?');\n    const search = searchIdx >= 0 ? withoutHash.slice(searchIdx + 1) : '';\n    const pathname = searchIdx >= 0 ? withoutHash.slice(0, searchIdx) : withoutHash;\n    return { pathname, search, hash };\n}\n\n/**\n * Resolves a prefix template by replacing parameter placeholders with values.\n * ('/:siteId/:localeId', { siteId: 'global', localeId: 'en-GB' }) → '/global/en-GB'\n */\nexport function resolvePrefix(prefix: string, params: Record<string, string>): string {\n    let resolved = prefix;\n    for (const paramName of extractPrefixParams(prefix)) {\n        const value = params[paramName];\n        if (value) {\n            resolved = resolved.replace(`:${paramName}`, value);\n        }\n    }\n    return resolved;\n}\n\n/**\n * Strips the URL prefix segments from a pathname based on a prefix pattern.\n * Since all routes are configured with the prefix baked in, segment counting is sufficient.\n *\n * @param pathname - Full pathname (e.g. '/global/en-GB/checkout')\n * @param prefixPattern - URL prefix pattern from config (e.g. '/:siteId/:localeId')\n * @returns Pathname with prefix stripped (e.g. '/checkout'), or original if\n *          the pathname has fewer segments than the prefix\n *\n * @example\n * stripPathPrefix('/global/en-GB/checkout', '/:siteId/:localeId') // → '/checkout'\n * stripPathPrefix('/checkout', '/:siteId/:localeId')              // → '/checkout' (fewer segments → unchanged)\n * stripPathPrefix('/checkout', '')                                 // → '/checkout' (no prefix configured)\n * stripPathPrefix('/', '/:siteId/:localeId')                      // → '/'\n */\nexport function stripPathPrefix(pathname: string, prefixPattern: string): string {\n    if (!prefixPattern) return pathname;\n\n    const prefixSegmentCount = prefixPattern.split('/').filter(Boolean).length;\n    const pathSegments = pathname.split('/').filter(Boolean);\n\n    if (pathSegments.length <= prefixSegmentCount) {\n        return pathSegments.length === prefixSegmentCount ? '/' : pathname;\n    }\n\n    return `/${pathSegments.slice(prefixSegmentCount).join('/')}`;\n}\n\n/**\n * Sanitize a resolved prefix from a pathname if present.\n * sanitizePrefix('/global/en-GB/product/123', '/global/en-GB') → '/product/123'\n * sanitizePrefix('/product/123', '/global/en-GB') → '/product/123'   (no-op)\n */\nexport function sanitizePrefix(pathname: string, pathPrefix: string): string {\n    if (!pathPrefix) return pathname;\n    if (pathname === pathPrefix) return '';\n    if (pathname.startsWith(`${pathPrefix}/`)) return pathname.slice(pathPrefix.length);\n    return pathname;\n}\n\n/**\n * Builds a fully-qualified URL with site context prefix and search params.\n *\n * Only keys defined in urlConfig.search are set by site context. Any other query params\n * already present on the `to` URL (including duplicate keys) are preserved as-is.\n * e.g. to='/api/search?refine=color:blue&refine=size:M', search='?lng=:localeId'\n *   → '/api/search?refine=color:blue&refine=size:M&lng=en-GB'\n *\n * @example\n * buildUrl({ to: '/product/123', urlConfig: { prefix: '/:siteId', search: '?lng=:localeId' }, params: { siteId: 'global', localeId: 'en-GB' } })\n * // → '/global/product/123?lng=en-GB'\n */\nexport function buildUrl({\n    to,\n    urlConfig,\n    params,\n}: {\n    to: string;\n    urlConfig?: Url;\n    params: Record<string, string>;\n}): string {\n    if (!urlConfig) return to;\n    if (!to || to === '#' || to.startsWith('http') || to.startsWith('//')) return to;\n\n    const { pathname, search: existingSearch, hash } = decomposeUrl(to);\n\n    const pathPrefix = urlConfig.prefix && urlConfig.prefix !== '/' ? resolvePrefix(urlConfig.prefix, params) : '';\n    // sanitize prefix to make sure there is no prefix duplication at any case\n    const path = pathPrefix ? `${pathPrefix}${sanitizePrefix(pathname, pathPrefix)}` : pathname;\n\n    const searchParams = new URLSearchParams(existingSearch);\n    if (urlConfig.search) {\n        const searchConfig = parseSearchConfig(urlConfig.search);\n        for (const [queryKey, value] of Object.entries(searchConfig)) {\n            if (value.startsWith(':')) {\n                const paramValue = params[value.slice(1)];\n                if (paramValue) {\n                    searchParams.set(queryKey, paramValue);\n                }\n            } else {\n                searchParams.set(queryKey, value);\n            }\n        }\n    }\n\n    const search = searchParams.toString();\n    return `${path}${search ? `?${search}` : ''}${hash}`;\n}\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Cookie } from 'react-router';\n\n/**\n * Extract a string value from the URL path segment at the given index.\n */\nexport function lookupFromPath(pathname: string, pathIndex: number): string | null {\n    const pathSegments = pathname.split('/').filter(Boolean);\n\n    if (pathSegments.length <= pathIndex) return null;\n\n    return pathSegments[pathIndex];\n}\n\n/**\n * Detect a string value from cookie using the given cookie parser.\n *\n * Returns a promise that resolves to the cookie value.\n */\nexport async function readCookieFromRequest(request: Request, cookie: Cookie): Promise<string | null> {\n    const cookies = request.headers.get('Cookie');\n    if (!cookies) return null;\n\n    const cookieValue = await cookie.parse(cookies);\n    return cookieValue;\n}\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Cookie } from 'react-router';\nimport type { Site, SiteSettings, DetectionMethod } from './types';\nimport { readCookieFromRequest, lookupFromPath } from './utils';\n\n/**\n * Detect site reference from cookie.\n */\nexport async function readSiteFromCookie(request: Request, cookie: Cookie): Promise<string | null> {\n    return readCookieFromRequest(request, cookie);\n}\n\n/**\n * Get site object using the site id or alias\n * 1. Check siteIdentifier against each site's alias; if matched, return that site.\n * 2. Else check against each site's id; if matched, return that site.\n * 3. If no match, return null.\n */\nfunction getSiteFromIdOrAlias(siteIdentifier: string | null, sites: Site[]): Site | null {\n    if (!siteIdentifier) return null;\n    return sites.find((site) => site.alias === siteIdentifier || site.id === siteIdentifier) ?? null;\n}\n\n/**\n * Resolve site using the configured detection order.\n * Returns the first valid site from the first source that yields a valid value.\n */\nexport async function resolveSite(request: Request, settings: SiteSettings): Promise<Site> {\n    const { sites, defaultSiteId, siteDetectionConfig, siteCookie } = settings;\n\n    const requestUrl = new URL(request.url);\n\n    // When a base path is configured (e.g., '/shop'), we need to skip its path segments.\n    // React Router handles the base path internally for hooks like useParams or useLocation,\n    // but it does not strip it from request.url. The offset is calculated dynamically from\n    // the number of segments in the base path as future-proof in case we support multi-segment\n    // base paths in the future.\n    const basePathOffset = process.env.MRT_ENV_BASE_PATH\n        ? process.env.MRT_ENV_BASE_PATH.split('/').filter(Boolean).length\n        : 0;\n\n    const resolvers: Record<DetectionMethod, () => Promise<string | null>> = {\n        path: () =>\n            Promise.resolve(\n                lookupFromPath(requestUrl.pathname, siteDetectionConfig.lookupFromPathIndex + basePathOffset)\n            ),\n        querystring: () => Promise.resolve(requestUrl.searchParams.get(siteDetectionConfig.lookupQuerystring)),\n        header: () => Promise.resolve(request.headers.get(siteDetectionConfig.lookupHeader)),\n        cookie: async () => readSiteFromCookie(request, siteCookie),\n    };\n\n    for (const method of siteDetectionConfig.order) {\n        const siteIdOrAlias = await resolvers[method]?.();\n        const resolvedSite = getSiteFromIdOrAlias(siteIdOrAlias, sites);\n        if (resolvedSite) return resolvedSite;\n    }\n\n    // If no site id was found, use the default site id\n    const site = getSiteFromIdOrAlias(defaultSiteId, sites);\n\n    // If default site id is invalid, throw an error\n    if (!site) {\n        throw new Error(`Default site ${defaultSiteId} not found.`);\n    }\n\n    return site;\n}\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { DetectionConfig } from './types';\n\nexport const DEFAULT_CURRENCY_COOKIE_NAME = 'currency';\n\n/**\n * Default site detection configuration\n */\nexport const DEFAULT_SITE_DETECTION: Required<DetectionConfig> = {\n    order: ['path', 'querystring', 'cookie', 'header'],\n    lookupFromPathIndex: 0,\n    lookupQuerystring: 'site',\n    lookupCookie: 'site_id',\n    lookupHeader: 'X-Site-Id',\n    caches: ['cookie'],\n};\n\n/**\n * Default locale detection configuration\n */\nexport const DEFAULT_LOCALE_DETECTION: Required<DetectionConfig> = {\n    order: ['path', 'querystring', 'cookie', 'header'],\n    lookupFromPathIndex: 1,\n    lookupQuerystring: 'lng',\n    lookupCookie: 'lng',\n    lookupHeader: 'Accept-Language',\n    caches: ['cookie'],\n};\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createCookie, type Cookie, type CookieOptions } from 'react-router';\n\n/**\n * Cookie options for site context cookies (site and locale)\n */\nexport const COOKIE_OPTIONS = {\n    path: '/',\n    sameSite: 'lax' as const,\n    secure: process.env.NODE_ENV === 'production',\n    httpOnly: true,\n};\n\n/**\n * Creates a cookie instance with the given name.\n *\n * @param name - Cookie name\n * @returns Cookie instance configured with site context options\n */\nexport function createSiteContextCookie(name: string, options?: CookieOptions): Cookie {\n    return createCookie(name, { ...COOKIE_OPTIONS, ...options });\n}\n\n/**\n * Creates a currency cookie instance with the given name.\n *\n * @param name - Cookie name\n * @returns Cookie instance configured with site context cookie options\n */\nexport function createCurrencyCookie(name: string, options?: CookieOptions): Cookie {\n    return createCookie(name, { ...COOKIE_OPTIONS, ...options });\n}\n\n/**\n * WeakMap to pass resolved locale from site context middleware to i18next's findLocale.\n * WeakMap allows garbage collection when requests are done.\n * This is necessary because findLocale() only receives the Request object, not the router context.\n */\nexport const requestToLocaleMap = new WeakMap<Request, string>();\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Cookie } from 'react-router';\nimport type { DetectionMethod, Locale, SiteSettings, Site } from './types';\nimport { readCookieFromRequest, lookupFromPath } from './utils';\n\n/**\n * Read locale from cookie.\n */\nexport async function readLocaleFromCookie(request: Request, cookie: Cookie): Promise<string | null> {\n    return readCookieFromRequest(request, cookie);\n}\n\n/**\n * Get locale object using the locale id or alias.\n * 1. Check localeIdOrAlias against each locale's alias; if matched, return that locale.\n * 2. Else check against each locale's id; if matched, return that locale.\n * 3. If no match, return null (caller should use defaultLocale).\n *\n * @param localeIdentifier - The locale id or alias to get the locale from. Null is allowed because this may come from\n * extrenal sources such as cookies, headers, or query parameters.\n * @param locales - The list of locales to search through.\n * @returns The locale object if found, otherwise null.\n */\nfunction getLocaleFromIdOrAlias(localeIdentifier: string | undefined | null, locales: Locale[]): Locale | null {\n    if (!localeIdentifier) return null;\n    return locales.find((locale) => locale.alias === localeIdentifier || locale.id === localeIdentifier) ?? null;\n}\n\n/**\n * Resolve locale using the configured detection order.\n * Returns the first valid locale from the first source that yields a valid value.\n */\nexport async function resolveLocale(request: Request, settings: SiteSettings, site: Site): Promise<Locale> {\n    const { defaultLocale, localeDetectionConfig, localeCookie } = settings;\n    const { supportedLocales } = site;\n\n    let locale: Locale | null = null;\n    const requestUrl = new URL(request.url);\n\n    // When a base path is configured (e.g., '/shop'), we need to skip its path segments.\n    // React Router handles the base path internally for hooks like useParams or useLocation,\n    // but it does not strip it from request.url. The offset is calculated dynamically from\n    // the number of segments in the base path as future-proof in case we support multi-segment\n    // base paths in the future.\n    const basePathOffset = process.env.MRT_ENV_BASE_PATH\n        ? process.env.MRT_ENV_BASE_PATH.split('/').filter(Boolean).length\n        : 0;\n\n    const resolvers: Record<DetectionMethod, () => Promise<string | null>> = {\n        path: () =>\n            Promise.resolve(\n                lookupFromPath(requestUrl.pathname, localeDetectionConfig.lookupFromPathIndex + basePathOffset)\n            ),\n        querystring: () => Promise.resolve(requestUrl.searchParams.get(localeDetectionConfig.lookupQuerystring)),\n        header: () => Promise.resolve(request.headers.get(localeDetectionConfig.lookupHeader)),\n        cookie: async () => readLocaleFromCookie(request, localeCookie),\n    };\n\n    for (const method of localeDetectionConfig.order) {\n        const localeIdOrAlias = await resolvers[method]?.();\n        const resolvedLocale = getLocaleFromIdOrAlias(localeIdOrAlias, supportedLocales);\n        if (resolvedLocale) return resolvedLocale;\n    }\n\n    // If no locale was found, use the default locale\n    if (!locale) {\n        locale = getLocaleFromIdOrAlias(defaultLocale, supportedLocales);\n    }\n\n    // If default locale is invalid, throw an error\n    if (!locale) {\n        throw new Error(\n            `Default locale ${defaultLocale} not found in the list of supported locales for site ${site.id}.`\n        );\n    }\n\n    return locale;\n}\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Cookie } from 'react-router';\nimport type { Site, Locale } from './types';\nimport { readCookieFromRequest } from './utils';\n\n/**\n * Resolve the currency for the current request.\n *\n * Priority:\n * 1. Cookie (user-selected currency, if valid for this site)\n * 2. Locale's preferred currency (if valid for this site)\n * 3. Site's default currency\n *\n * @param request - Incoming request\n * @param currencyCookie - Cookie instance for reading the currency cookie\n * @param site - Resolved site for this request\n * @param locale - Resolved locale for this request\n * @returns The resolved currency code\n */\nexport async function resolveCurrency(\n    request: Request,\n    currencyCookie: Cookie,\n    site: Site,\n    locale: Locale\n): Promise<string> {\n    const { supportedCurrencies, defaultCurrency } = site;\n\n    if (!supportedCurrencies || supportedCurrencies.length === 0) {\n        throw new Error(`Site \"${site.id}\" must have supportedCurrencies configured.`);\n    }\n\n    // 1. Try cookie\n    const cookieValue = await readCookieFromRequest(request, currencyCookie);\n    if (typeof cookieValue === 'string' && supportedCurrencies.includes(cookieValue)) {\n        return cookieValue;\n    }\n\n    // 2. Try locale's preferred currency\n    if (locale.preferredCurrency && supportedCurrencies.includes(locale.preferredCurrency)) {\n        return locale.preferredCurrency;\n    }\n\n    // 3. Fall back to site default\n    return defaultCurrency;\n}\n","/**\n * Copyright 2026 Salesforce, Inc.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { createContext, type MiddlewareFunction, type RouterContextProvider } from 'react-router';\nimport { resolveSite } from './site-detection';\nimport type { SiteConfig, SiteContext, SiteSettings, Site, Locale } from './types';\nimport { DEFAULT_SITE_DETECTION, DEFAULT_LOCALE_DETECTION, DEFAULT_CURRENCY_COOKIE_NAME } from './configs';\nimport { createSiteContextCookie, createCurrencyCookie, requestToLocaleMap } from './cookies';\nimport { resolveLocale } from './locale-detection';\nimport { resolveCurrency } from './currency-detection';\n\nexport const siteContext = createContext<SiteContext | null>(null);\n\n/**\n * Resolved site context result from {@link resolveSiteContext}.\n */\nexport type ResolvedSiteContext = {\n    site: Site;\n    locale: Locale;\n    currency: string;\n};\n\n/**\n * Resolve site, locale, and currency from a request in one call.\n *\n * This is the recommended public entry point for site-context resolution.\n * It encapsulates the required resolution order (site → locale → currency)\n * so consumers don't need to manage the dependency chain manually.\n *\n * The individual resolvers (`resolveSite`, `resolveLocale`, `resolveCurrency`)\n * are available as advanced utilities for cases that need fine-grained control.\n *\n * @param request - Incoming HTTP request\n * @param settings - Fully resolved site settings (with detection config and cookies)\n * @returns Resolved site, locale, and currency\n *\n * @example\n * ```typescript\n * const { site, locale, currency } = await resolveSiteContext(request, settings);\n * ```\n */\nexport async function resolveSiteContext(request: Request, settings: SiteSettings): Promise<ResolvedSiteContext> {\n    const site = await resolveSite(request, settings);\n    const locale = await resolveLocale(request, settings, site);\n    const currency = await resolveCurrency(request, settings.currencyCookie, site, locale);\n    return { site, locale, currency };\n}\n\ntype MiddlewareArgs = { request: Request; context: Readonly<RouterContextProvider> };\n\n/**\n * Helper function to get site context cookies from router context.\n * Useful in server actions and loaders that need to read/set cookies.\n *\n * @param context - Router context provider\n * @returns Object with siteCookie and localeCookie instances, or null if context not set\n *\n * @example\n * ```typescript\n * export const action: ActionFunction = async ({ request, context }) => {\n *     const cookies = getSiteContextCookies(context);\n *     if (cookies) {\n *         const cookieHeader = await cookies.localeCookie.serialize(locale);\n *         // ... use cookieHeader\n *     }\n * };\n * ```\n */\nexport function getSiteContextCookies(context: Readonly<RouterContextProvider>) {\n    const siteCtx = context.get(siteContext);\n    if (!siteCtx) return null;\n    return {\n        siteCookie: siteCtx.siteCookie,\n        localeCookie: siteCtx.localeCookie,\n        currencyCookie: siteCtx.currencyCookie,\n    };\n}\n\n/**\n * Helper function to determine if cookies should be set based on:\n * 1. Whether caching is enabled for each cookie type\n * 2. Whether the resolved value differs from the existing cookie\n * 3. Whether cookies were already set by actions/loaders in the response\n *\n * @param request - Incoming request\n * @param response - Response from next()\n * @param settings - Site context settings with cookie instances and detection config\n * @param site - Resolved site for this request\n * @param locale - Resolved locale for this request\n * @param currency - Resolved currency for this request\n * @returns Object with shouldSetSiteCookie, shouldSetLocaleCookie, and shouldSetCurrencyCookie booleans\n */\nasync function shouldSetCookies(\n    request: Request,\n    response: Response,\n    settings: SiteSettings,\n    site: Site,\n    locale: Locale,\n    currency: string\n): Promise<{ shouldSetSiteCookie: boolean; shouldSetLocaleCookie: boolean; shouldSetCurrencyCookie: boolean }> {\n    const cacheSite = settings.siteDetectionConfig.caches?.includes('cookie');\n    const cacheLocale = settings.localeDetectionConfig.caches?.includes('cookie');\n\n    // Check if cookies were already set by actions/loaders in the response.\n    // If they were, we don't want to override them.\n    const responseSetCookies = response.headers.getSetCookie?.() || [];\n    const isSettingSiteCookieInResponse = responseSetCookies.some((cookie) =>\n        cookie.startsWith(`${settings.siteCookie.name}=`)\n    );\n    const isSettingLocaleCookieInResponse = responseSetCookies.some((cookie) =>\n        cookie.startsWith(`${settings.localeCookie.name}=`)\n    );\n    const isSettingCurrencyCookieInResponse = responseSetCookies.some((cookie) =>\n        cookie.startsWith(`${settings.currencyCookie.name}=`)\n    );\n\n    const requestCookieHeader = request.headers.get('Cookie');\n    const [existingSiteCookie, existingLocaleCookie, existingCurrencyCookie] = await Promise.all([\n        settings.siteCookie.parse(requestCookieHeader),\n        settings.localeCookie.parse(requestCookieHeader),\n        settings.currencyCookie.parse(requestCookieHeader),\n    ]);\n\n    // Set cookie if: doesn't exist yet OR resolved value differs from existing.\n    // Skip if an action/loader already set it in the response.\n    return {\n        shouldSetSiteCookie: cacheSite && !isSettingSiteCookieInResponse && existingSiteCookie !== site.id,\n        shouldSetLocaleCookie: cacheLocale && !isSettingLocaleCookieInResponse && existingLocaleCookie !== locale.id,\n        shouldSetCurrencyCookie: !isSettingCurrencyCookieInResponse && existingCurrencyCookie !== currency,\n    };\n}\n\n/**\n * Creates a site context middleware that resolves the current site from\n * the request (path, cookie, header, query, or default) and stores the\n * result in the router context.\n *\n * Does not import or read from app config context; the consumer supplies config.\n */\nexport function createSiteContextMiddleware(config: SiteConfig): MiddlewareFunction<Response> {\n    // Merge config with defaults so every detection option has a value\n    const siteDetectionConfig: SiteSettings['siteDetectionConfig'] = {\n        ...DEFAULT_SITE_DETECTION,\n        ...config.siteDetectionConfig,\n    };\n    const localeDetectionConfig: SiteSettings['localeDetectionConfig'] = {\n        ...DEFAULT_LOCALE_DETECTION,\n        ...config.localeDetectionConfig,\n    };\n\n    // Create cookies based on configured names and optional cookie options\n    const siteCookie = createSiteContextCookie(siteDetectionConfig.lookupCookie, config.cookieOptions);\n    const localeCookie = createSiteContextCookie(localeDetectionConfig.lookupCookie, config.cookieOptions);\n    const currencyCookie = createCurrencyCookie(\n        config.currencyCookieName ?? DEFAULT_CURRENCY_COOKIE_NAME,\n        config.cookieOptions\n    );\n\n    const settings: SiteSettings = {\n        ...config,\n        siteDetectionConfig,\n        localeDetectionConfig,\n        siteCookie,\n        localeCookie,\n        currencyCookie,\n    };\n\n    const siteContextMiddleware: MiddlewareFunction<Response> = async (\n        { request, context }: MiddlewareArgs,\n        next: () => Promise<Response>\n    ): Promise<Response> => {\n        const { site, locale, currency } = await resolveSiteContext(request, settings);\n\n        // Store full Site, Locale, Currency, and Cookie objects in context\n        context.set(siteContext, {\n            site,\n            locale,\n            currency,\n            siteCookie: settings.siteCookie,\n            localeCookie: settings.localeCookie,\n            currencyCookie: settings.currencyCookie,\n        });\n\n        // Store locale in a WeakMap so i18next's findLocale can access it\n        // This is necessary because findLocale only receives Request and cannot access the router context\n        requestToLocaleMap.set(request, locale.id);\n\n        const response = await next();\n\n        // Determine if cookies should be set.\n        // Actions that change currency (or site/locale) set their cookies directly on the response;\n        // shouldSetCookies detects those Set-Cookie headers and skips to avoid overriding.\n        const { shouldSetSiteCookie, shouldSetLocaleCookie, shouldSetCurrencyCookie } = await shouldSetCookies(\n            request,\n            response,\n            settings,\n            site,\n            locale,\n            currency\n        );\n\n        // Early return if no cookies need to be set\n        if (!shouldSetSiteCookie && !shouldSetLocaleCookie && !shouldSetCurrencyCookie) {\n            return response;\n        }\n\n        const [siteSetCookie, localeSetCookie, currencySetCookie] = await Promise.all([\n            shouldSetSiteCookie ? settings.siteCookie.serialize(site.id, { path: '/' }) : Promise.resolve(null),\n            shouldSetLocaleCookie ? settings.localeCookie.serialize(locale.id, { path: '/' }) : Promise.resolve(null),\n            shouldSetCurrencyCookie ? settings.currencyCookie.serialize(currency) : Promise.resolve(null),\n        ]);\n\n        if (siteSetCookie) response.headers.append('Set-Cookie', siteSetCookie);\n        if (localeSetCookie) response.headers.append('Set-Cookie', localeSetCookie);\n        if (currencySetCookie) response.headers.append('Set-Cookie', currencySetCookie);\n\n        return response;\n    };\n\n    return siteContextMiddleware;\n}\n"],"mappings":"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"}