@salesforce/storefront-next-runtime 0.4.1 → 1.0.0-alpha.0

package/dist/schema.d.ts

@@ -4,17 +4,16 @@
  *
  * Generic parameter `App` represents the template's application config shape.
  * The SDK does not prescribe what fields `app` must contain — templates define
- * their own `AppConfig` type with SCAPI credentials, pages, features, etc.
- * and pass it as `BaseConfig<AppConfig>`.
+ * their own `AppConfig` type and pass it as `BaseConfig<AppConfig>`.
  *
- * The SDK accesses specific `app` fields (e.g., `commerce.api.clientId`) at
- * runtime via the middleware validation, not via compile-time type constraints.
+ * Validation of `app` (e.g., required credentials, required collections) is
+ * the template's responsibility, typically handled in its server middleware.
  *
  * @typeParam App - The template's application config shape (defaults to `Record<string, unknown>`)
  *
  * @example
  * // In the template's types file:
- * type AppConfig = { commerce: { api: {...} }; pages: {...}; features: {...} };
+ * type AppConfig = { ... };
  * type Config = BaseConfig<AppConfig>;
  *
  * // In config.server.ts:
@@ -38,23 +37,27 @@ interface DefineConfigOptions {
   /**
    * Config paths that cannot be overridden by environment variables.
    * Paths use double underscore separators and are matched case-insensitively.
+   * Any env var targeting a protected path or a sub-path of it will throw.
    *
-   * @example ['app__engagement'] — prevents PUBLIC__app__engagement__* from being set via env
+   * @example ['app__analytics'] — prevents PUBLIC__app__analytics__* from being set via env
    */
   protectedPaths?: string[];
 }
 /**
  * Define a type-safe storefront configuration with IDE autocomplete.
  *
- * Automatically merges `PUBLIC__` prefixed environment variables into the config
- * at load time. Validates env vars against the base config structure (strict mode —
- * only allows overriding existing paths).
+ * Reads `process.env` at call time and merges any `PUBLIC__`-prefixed
+ * variables into the config (validated against the base config structure —
+ * env vars targeting paths that don't exist in the base config are ignored
+ * with a warning). This is a server-only side effect by design; calling
+ * `defineConfig` from a browser bundle silently no-ops because `PUBLIC__`
+ * vars are not present in the client environment.
  *
  * Environment variables:
  * - `PUBLIC__<path>` (optional): Override any config path using double underscore separators.
- *   e.g. `PUBLIC__app__commerce__api__clientId=abc123` maps to `config.app.commerce.api.clientId`
- * - `PUBLIC__app__pages__cart__quantityUpdateDebounce=1000` maps to a number (optimistic JSON parsing)
- * - `PUBLIC__app__features__socialLogin__providers=["Apple","Google"]` maps to an array
+ *   e.g. `PUBLIC__app__some__nested__value=abc123` maps to `config.app.some.nested.value`
+ * - JSON values are parsed optimistically: numbers, booleans, arrays, and objects all work.
+ *   `PUBLIC__app__features__providers=["A","B"]` parses to an array.
  *
  * @param config - The base configuration object with all defaults
  * @param options - Optional settings (e.g., protectedPaths to prevent env var overrides)
@@ -67,10 +70,9 @@ interface DefineConfigOptions {
  * export default defineConfig({
  *     metadata: { projectName: 'My Store', projectSlug: 'my-store' },
  *     app: {
- *         commerce: { api: { clientId: '', organizationId: '', shortCode: '' }, sites: [] },
- *         defaultSiteId: 'RefArch',
+ *         // template-specific shape
  *     },
- * }, { protectedPaths: ['app__engagement'] });
+ * }, { protectedPaths: ['app__analytics'] });
  */
 declare function defineConfig<T extends BaseConfig>(config: T, options?: DefineConfigOptions): T;
 //#endregion

package/dist/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","names":[],"sources":["../src/config/schema.ts"],"sourcesContent":[],"mappings":";;AAsCA;;;;;;AAeA;AAuCA;;;;;;;;;;;;;KAtDY,uBAAuB,0BAA0B;;;;;;;;;;oBAUrC;;OAEf;;UAGQ,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuCD,uBAAuB,oBAAoB,aAAa,sBAAsB"}
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../src/config/schema.ts"],"sourcesContent":[],"mappings":";;AAqCA;;;;;;AAeA;AA0CA;;;;;;;;;;;;KAzDY,uBAAuB,0BAA0B;;;;;;;;;;oBAUrC;;OAEf;;UAGQ,mBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA0CD,uBAAuB,oBAAoB,aAAa,sBAAsB"}

package/dist/site-context.d.ts

@@ -1,7 +1,7 @@
 import { n as Site$1, r as Url, t as Locale$1 } from "./types.js";
 import { PropsWithChildren } from "react";
-import * as react_jsx_runtime0 from "react/jsx-runtime";
-import * as react_router6 from "react-router";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_router10 from "react-router";
 import { Cookie, CookieOptions, MiddlewareFunction, RouterContextProvider } from "react-router";
 import { RouteConfigEntry } from "@react-router/dev/routes";
 
@@ -102,7 +102,7 @@ declare function SiteProvider({
   language,
   currency,
   children
-}: PropsWithChildren<SiteContextValue>): react_jsx_runtime0.JSX.Element;
+}: PropsWithChildren<SiteContextValue>): react_jsx_runtime2.JSX.Element;
 /**
  * React hook to get the current site context.
  * Returns `{ site, locale, language, currency }`.
@@ -134,31 +134,47 @@ declare function applyUrlConfig(options: {
 //#region src/site-context/build-url.d.ts
 /**
  * Resolves a prefix template by replacing parameter placeholders with values.
- * ('/:siteId/:localeId', { siteId: 'global', localeId: 'en-GB' }) → '/global/en-GB'
+ *
+ * @example
+ * resolvePrefix({ prefix: '/:siteId/:localeId', params: { siteId: 'global', localeId: 'en-GB' } })
+ * // → '/global/en-GB'
  */
-declare function resolvePrefix(prefix: string, params: Record<string, string>): string;
+declare function resolvePrefix({
+  prefix,
+  params
+}: {
+  prefix: string;
+  params: Record<string, string>;
+}): string;
 /**
- * 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.
+ * Strips a URL prefix from a pathname.
  *
- * @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
+ * Accepts either a resolved prefix or a prefix pattern — segments may be
+ * literal strings (must match the pathname exactly) or `:param` placeholders
+ * (match any segment value). Mixed prefixes are supported.
+ *
+ * Returns `''` when the pathname matches the prefix exactly with no remainder
+ * (so concatenating `prefix + result` round-trips the input), `pathname`
+ * unchanged when literal segments don't match or the path is shorter than the
+ * prefix, or the bare remainder otherwise. Callers that need the homepage to
+ * be `'/'` should coerce: `stripPathPrefix(...) || '/'`.
  *
  * @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')                      // → '/'
- */
-declare function stripPathPrefix(pathname: string, prefixPattern: string): string;
-/**
- * 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)
+ * stripPathPrefix({ pathname: '/global/en-GB/checkout', prefix: '/:siteId/:localeId' })   // → '/checkout'
+ * stripPathPrefix({ pathname: '/global/en-GB/checkout', prefix: '/global/en-GB' })        // → '/checkout'
+ * stripPathPrefix({ pathname: '/shop/en-GB/x',          prefix: '/shop/:localeId' })      // → '/x'
+ * stripPathPrefix({ pathname: '/global/en-GB',          prefix: '/:siteId/:localeId' })   // → ''
+ * stripPathPrefix({ pathname: '/checkout',              prefix: '/:siteId/:localeId' })   // → '/checkout'
+ * stripPathPrefix({ pathname: '/other/x',               prefix: '/global/en-GB' })        // → '/other/x'
+ * stripPathPrefix({ pathname: '/x',                     prefix: '' })                     // → '/x'
  */
-declare function sanitizePrefix(pathname: string, pathPrefix: string): string;
+declare function stripPathPrefix({
+  pathname,
+  prefix
+}: {
+  pathname: string;
+  prefix: string;
+}): string;
 /**
  * Builds a fully-qualified URL with site context prefix and search params.
  *
@@ -182,7 +198,7 @@ declare function buildUrl({
 }): string;
 //#endregion
 //#region src/site-context/middleware.d.ts
-declare const siteContext: react_router6.RouterContext<SiteContext | null>;
+declare const siteContext: react_router10.RouterContext<SiteContext | null>;
 /**
  * Resolved site context result from {@link resolveSiteContext}.
  */
@@ -230,9 +246,9 @@ declare function resolveSiteContext(request: Request, settings: SiteSettings): P
  * ```
  */
 declare function getSiteContextCookies(context: Readonly<RouterContextProvider>): {
-  siteCookie: react_router6.Cookie;
-  localeCookie: react_router6.Cookie;
-  currencyCookie: react_router6.Cookie;
+  siteCookie: react_router10.Cookie;
+  localeCookie: react_router10.Cookie;
+  currencyCookie: react_router10.Cookie;
 } | null;
 /**
  * Creates a site context middleware that resolves the current site from
@@ -251,5 +267,5 @@ declare function createSiteContextMiddleware(config: SiteConfig): MiddlewareFunc
  */
 declare const requestToLocaleMap: WeakMap<Request, string>;
 //#endregion
-export { type DetectionConfig, type Locale, type ResolvedSiteContext, type Site, type SiteConfig, type SiteContext, type SiteContextValue, SiteProvider, type SiteSettings, applyUrlConfig, buildUrl, createSiteContextMiddleware, getSiteContextCookies, requestToLocaleMap, resolvePrefix, resolveSiteContext, sanitizePrefix, siteContext, stripPathPrefix, useSite };
+export { type DetectionConfig, type Locale, type ResolvedSiteContext, type Site, type SiteConfig, type SiteContext, type SiteContextValue, SiteProvider, type SiteSettings, applyUrlConfig, buildUrl, createSiteContextMiddleware, getSiteContextCookies, requestToLocaleMap, resolvePrefix, resolveSiteContext, siteContext, stripPathPrefix, useSite };
 //# sourceMappingURL=site-context.d.ts.map

package/dist/site-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"site-context.d.ts","names":[],"sources":["../src/site-context/types.ts","../src/site-context/site-context.tsx","../src/site-context/apply-url-config.ts","../src/site-context/build-url.ts","../src/site-context/middleware.ts","../src/site-context/cookies.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"site-context.d.ts","names":[],"sources":["../src/site-context/types.ts","../src/site-context/site-context.tsx","../src/site-context/apply-url-config.ts","../src/site-context/build-url.ts","../src/site-context/middleware.ts","../src/site-context/cookies.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/site-context.js

@@ -1,4 +1,4 @@
-import { a as requestToLocaleMap, c as sanitizePrefix, d as useSite, i as siteContext, l as stripPathPrefix, n as getSiteContextCookies, o as buildUrl, r as resolveSiteContext, s as resolvePrefix, t as createSiteContextMiddleware, u as SiteProvider } from "./site-context2.js";
+import { a as requestToLocaleMap, c as stripPathPrefix, i as siteContext, l as SiteProvider, n as getSiteContextCookies, o as buildUrl, r as resolveSiteContext, s as resolvePrefix, t as createSiteContextMiddleware, u as useSite } from "./site-context2.js";
 import { t as applyUrlConfig } from "./apply-url-config.js";
 
-export { SiteProvider, applyUrlConfig, buildUrl, createSiteContextMiddleware, getSiteContextCookies, requestToLocaleMap, resolvePrefix, resolveSiteContext, sanitizePrefix, siteContext, stripPathPrefix, useSite };
+export { SiteProvider, applyUrlConfig, buildUrl, createSiteContextMiddleware, getSiteContextCookies, requestToLocaleMap, resolvePrefix, resolveSiteContext, siteContext, stripPathPrefix, useSite };

package/dist/site-context2.js

@@ -77,9 +77,12 @@ function decomposeUrl(url) {
 }
 /**
 * Resolves a prefix template by replacing parameter placeholders with values.
-* ('/:siteId/:localeId', { siteId: 'global', localeId: 'en-GB' }) → '/global/en-GB'
+*
+* @example
+* resolvePrefix({ prefix: '/:siteId/:localeId', params: { siteId: 'global', localeId: 'en-GB' } })
+* // → '/global/en-GB'
 */
-function resolvePrefix(prefix, params) {
+function resolvePrefix({ prefix, params }) {
 	let resolved = prefix;
 	for (const paramName of extractPrefixParams(prefix)) {
 		const value = params[paramName];
@@ -88,37 +91,38 @@ function resolvePrefix(prefix, params) {
 	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.
+* Strips a URL prefix from a pathname.
 *
-* @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
+* Accepts either a resolved prefix or a prefix pattern — segments may be
+* literal strings (must match the pathname exactly) or `:param` placeholders
+* (match any segment value). Mixed prefixes are supported.
+*
+* Returns `''` when the pathname matches the prefix exactly with no remainder
+* (so concatenating `prefix + result` round-trips the input), `pathname`
+* unchanged when literal segments don't match or the path is shorter than the
+* prefix, or the bare remainder otherwise. Callers that need the homepage to
+* be `'/'` should coerce: `stripPathPrefix(...) || '/'`.
 *
 * @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')                      // → '/'
+* stripPathPrefix({ pathname: '/global/en-GB/checkout', prefix: '/:siteId/:localeId' })   // → '/checkout'
+* stripPathPrefix({ pathname: '/global/en-GB/checkout', prefix: '/global/en-GB' })        // → '/checkout'
+* stripPathPrefix({ pathname: '/shop/en-GB/x',          prefix: '/shop/:localeId' })      // → '/x'
+* stripPathPrefix({ pathname: '/global/en-GB',          prefix: '/:siteId/:localeId' })   // → ''
+* stripPathPrefix({ pathname: '/checkout',              prefix: '/:siteId/:localeId' })   // → '/checkout'
+* stripPathPrefix({ pathname: '/other/x',               prefix: '/global/en-GB' })        // → '/other/x'
+* stripPathPrefix({ pathname: '/x',                     prefix: '' })                     // → '/x'
 */
-function stripPathPrefix(pathname, prefixPattern) {
-	if (!prefixPattern) return pathname;
-	const prefixSegmentCount = prefixPattern.split("/").filter(Boolean).length;
+function stripPathPrefix({ pathname, prefix }) {
+	if (!prefix || prefix === "/") return pathname;
+	const prefixSegments = prefix.split("/").filter(Boolean);
 	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;
+	if (pathSegments.length < prefixSegments.length) return pathname;
+	for (let i = 0; i < prefixSegments.length; i++) {
+		const segment = prefixSegments[i];
+		if (!segment.startsWith(":") && segment !== pathSegments[i]) return pathname;
+	}
+	const remaining = pathSegments.slice(prefixSegments.length);
+	return remaining.length === 0 ? "" : `/${remaining.join("/")}`;
 }
 /**
 * Builds a fully-qualified URL with site context prefix and search params.
@@ -136,8 +140,14 @@ 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 pathPrefix = urlConfig.prefix && urlConfig.prefix !== "/" ? resolvePrefix({
+		prefix: urlConfig.prefix,
+		params
+	}) : "";
+	const path = pathPrefix ? `${pathPrefix}${stripPathPrefix({
+		pathname,
+		prefix: pathPrefix
+	})}` : pathname;
 	const searchParams = new URLSearchParams(existingSearch);
 	if (urlConfig.search) {
 		const searchConfig = parseSearchConfig(urlConfig.search);
@@ -509,5 +519,5 @@ function createSiteContextMiddleware(config) {
 }
 
 //#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 };
+export { requestToLocaleMap as a, stripPathPrefix as c, siteContext as i, SiteProvider as l, getSiteContextCookies as n, buildUrl as o, resolveSiteContext as r, resolvePrefix as s, createSiteContextMiddleware as t, useSite as u };
 //# sourceMappingURL=site-context2.js.map

package/dist/site-context2.js.map

@@ -1 +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":";;;;;AAqDA,MAAM,cAAc,cAA4C,OAAU;;;;;;;;AAS1E,SAAgB,aAAa,EAAE,MAAM,QAAQ,UAAU,UAAU,YAAiD;CAC9G,MAAM,QAAQ,eAAe;EAAE;EAAM;EAAQ;EAAU;EAAU,GAAG;EAAC;EAAM;EAAQ;EAAU;EAAS,CAAC;AACvG,QAAO,oBAAC,YAAY;EAAgB;EAAQ;GAAgC;;;;;;;AAShF,SAAgB,UAA4B;CACxC,MAAM,QAAQ,WAAW,YAAY;AACrC,KAAI,CAAC,MACD,OAAM,IAAI,MAAM,6CAA6C;AAEjE,QAAO;;;;;;;;;ACzDX,SAAgB,kBAAkB,QAAwC;CACtE,MAAM,eAAe,IAAI,gBAAgB,OAAO;CAChD,MAAMA,SAAiC,EAAE;AACzC,MAAK,MAAM,CAAC,KAAK,UAAU,aACvB,QAAO,OAAO;AAElB,QAAO;;;;;;AAOX,SAAgB,oBAAoB,QAA0B;CAC1D,MAAM,UAAU,OAAO,MAAM,UAAU;AACvC,QAAO,UAAU,QAAQ,KAAK,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE;;;;;;AAOxD,SAAgB,aAAa,KAAiE;CAC1F,MAAM,UAAU,IAAI,QAAQ,IAAI;CAChC,MAAM,OAAO,WAAW,IAAI,IAAI,MAAM,QAAQ,GAAG;CACjD,MAAM,cAAc,WAAW,IAAI,IAAI,MAAM,GAAG,QAAQ,GAAG;CAC3D,MAAM,YAAY,YAAY,QAAQ,IAAI;CAC1C,MAAM,SAAS,aAAa,IAAI,YAAY,MAAM,YAAY,EAAE,GAAG;AAEnE,QAAO;EAAE,UADQ,aAAa,IAAI,YAAY,MAAM,GAAG,UAAU,GAAG;EACjD;EAAQ;EAAM;;;;;;AAOrC,SAAgB,cAAc,QAAgB,QAAwC;CAClF,IAAI,WAAW;AACf,MAAK,MAAM,aAAa,oBAAoB,OAAO,EAAE;EACjD,MAAM,QAAQ,OAAO;AACrB,MAAI,MACA,YAAW,SAAS,QAAQ,IAAI,aAAa,MAAM;;AAG3D,QAAO;;;;;;;;;;;;;;;;;AAkBX,SAAgB,gBAAgB,UAAkB,eAA+B;AAC7E,KAAI,CAAC,cAAe,QAAO;CAE3B,MAAM,qBAAqB,cAAc,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC;CACpE,MAAM,eAAe,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ;AAExD,KAAI,aAAa,UAAU,mBACvB,QAAO,aAAa,WAAW,qBAAqB,MAAM;AAG9D,QAAO,IAAI,aAAa,MAAM,mBAAmB,CAAC,KAAK,IAAI;;;;;;;AAQ/D,SAAgB,eAAe,UAAkB,YAA4B;AACzE,KAAI,CAAC,WAAY,QAAO;AACxB,KAAI,aAAa,WAAY,QAAO;AACpC,KAAI,SAAS,WAAW,GAAG,WAAW,GAAG,CAAE,QAAO,SAAS,MAAM,WAAW,OAAO;AACnF,QAAO;;;;;;;;;;;;;;AAeX,SAAgB,SAAS,EACrB,IACA,WACA,UAKO;AACP,KAAI,CAAC,UAAW,QAAO;AACvB,KAAI,CAAC,MAAM,OAAO,OAAO,GAAG,WAAW,OAAO,IAAI,GAAG,WAAW,KAAK,CAAE,QAAO;CAE9E,MAAM,EAAE,UAAU,QAAQ,gBAAgB,SAAS,aAAa,GAAG;CAEnE,MAAM,aAAa,UAAU,UAAU,UAAU,WAAW,MAAM,cAAc,UAAU,QAAQ,OAAO,GAAG;CAE5G,MAAM,OAAO,aAAa,GAAG,aAAa,eAAe,UAAU,WAAW,KAAK;CAEnF,MAAM,eAAe,IAAI,gBAAgB,eAAe;AACxD,KAAI,UAAU,QAAQ;EAClB,MAAM,eAAe,kBAAkB,UAAU,OAAO;AACxD,OAAK,MAAM,CAAC,UAAU,UAAU,OAAO,QAAQ,aAAa,CACxD,KAAI,MAAM,WAAW,IAAI,EAAE;GACvB,MAAM,aAAa,OAAO,MAAM,MAAM,EAAE;AACxC,OAAI,WACA,cAAa,IAAI,UAAU,WAAW;QAG1C,cAAa,IAAI,UAAU,MAAM;;CAK7C,MAAM,SAAS,aAAa,UAAU;AACtC,QAAO,GAAG,OAAO,SAAS,IAAI,WAAW,KAAK;;;;;;;;ACrIlD,SAAgB,eAAe,UAAkB,WAAkC;CAC/E,MAAM,eAAe,SAAS,MAAM,IAAI,CAAC,OAAO,QAAQ;AAExD,KAAI,aAAa,UAAU,UAAW,QAAO;AAE7C,QAAO,aAAa;;;;;;;AAQxB,eAAsB,sBAAsB,SAAkB,QAAwC;CAClG,MAAM,UAAU,QAAQ,QAAQ,IAAI,SAAS;AAC7C,KAAI,CAAC,QAAS,QAAO;AAGrB,QADoB,MAAM,OAAO,MAAM,QAAQ;;;;;;;;ACfnD,eAAsB,mBAAmB,SAAkB,QAAwC;AAC/F,QAAO,sBAAsB,SAAS,OAAO;;;;;;;;AASjD,SAAS,qBAAqB,gBAA+B,OAA4B;AACrF,KAAI,CAAC,eAAgB,QAAO;AAC5B,QAAO,MAAM,MAAM,SAAS,KAAK,UAAU,kBAAkB,KAAK,OAAO,eAAe,IAAI;;;;;;AAOhG,eAAsB,YAAY,SAAkB,UAAuC;CACvF,MAAM,EAAE,OAAO,eAAe,qBAAqB,eAAe;CAElE,MAAM,aAAa,IAAI,IAAI,QAAQ,IAAI;CAOvC,MAAM,iBAAiB,QAAQ,IAAI,oBAC7B,QAAQ,IAAI,kBAAkB,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,SACzD;CAEN,MAAMC,YAAmE;EACrE,YACI,QAAQ,QACJ,eAAe,WAAW,UAAU,oBAAoB,sBAAsB,eAAe,CAChG;EACL,mBAAmB,QAAQ,QAAQ,WAAW,aAAa,IAAI,oBAAoB,kBAAkB,CAAC;EACtG,cAAc,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,oBAAoB,aAAa,CAAC;EACpF,QAAQ,YAAY,mBAAmB,SAAS,WAAW;EAC9D;AAED,MAAK,MAAM,UAAU,oBAAoB,OAAO;EAE5C,MAAM,eAAe,qBADC,MAAM,UAAU,WAAW,EACQ,MAAM;AAC/D,MAAI,aAAc,QAAO;;CAI7B,MAAM,OAAO,qBAAqB,eAAe,MAAM;AAGvD,KAAI,CAAC,KACD,OAAM,IAAI,MAAM,gBAAgB,cAAc,aAAa;AAG/D,QAAO;;;;;AC9DX,MAAa,+BAA+B;;;;AAK5C,MAAaC,yBAAoD;CAC7D,OAAO;EAAC;EAAQ;EAAe;EAAU;EAAS;CAClD,qBAAqB;CACrB,mBAAmB;CACnB,cAAc;CACd,cAAc;CACd,QAAQ,CAAC,SAAS;CACrB;;;;AAKD,MAAaC,2BAAsD;CAC/D,OAAO;EAAC;EAAQ;EAAe;EAAU;EAAS;CAClD,qBAAqB;CACrB,mBAAmB;CACnB,cAAc;CACd,cAAc;CACd,QAAQ,CAAC,SAAS;CACrB;;;;;;;ACrBD,MAAa,iBAAiB;CAC1B,MAAM;CACN,UAAU;CACV,QAAQ,QAAQ,IAAI,aAAa;CACjC,UAAU;CACb;;;;;;;AAQD,SAAgB,wBAAwB,MAAc,SAAiC;AACnF,QAAO,aAAa,MAAM;EAAE,GAAG;EAAgB,GAAG;EAAS,CAAC;;;;;;;;AAShE,SAAgB,qBAAqB,MAAc,SAAiC;AAChF,QAAO,aAAa,MAAM;EAAE,GAAG;EAAgB,GAAG;EAAS,CAAC;;;;;;;AAQhE,MAAa,qCAAqB,IAAI,SAA0B;;;;;;;AC9BhE,eAAsB,qBAAqB,SAAkB,QAAwC;AACjG,QAAO,sBAAsB,SAAS,OAAO;;;;;;;;;;;;;AAcjD,SAAS,uBAAuB,kBAA6C,SAAkC;AAC3G,KAAI,CAAC,iBAAkB,QAAO;AAC9B,QAAO,QAAQ,MAAM,WAAW,OAAO,UAAU,oBAAoB,OAAO,OAAO,iBAAiB,IAAI;;;;;;AAO5G,eAAsB,cAAc,SAAkB,UAAwB,MAA6B;CACvG,MAAM,EAAE,eAAe,uBAAuB,iBAAiB;CAC/D,MAAM,EAAE,qBAAqB;CAE7B,IAAIC,SAAwB;CAC5B,MAAM,aAAa,IAAI,IAAI,QAAQ,IAAI;CAOvC,MAAM,iBAAiB,QAAQ,IAAI,oBAC7B,QAAQ,IAAI,kBAAkB,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC,SACzD;CAEN,MAAMC,YAAmE;EACrE,YACI,QAAQ,QACJ,eAAe,WAAW,UAAU,sBAAsB,sBAAsB,eAAe,CAClG;EACL,mBAAmB,QAAQ,QAAQ,WAAW,aAAa,IAAI,sBAAsB,kBAAkB,CAAC;EACxG,cAAc,QAAQ,QAAQ,QAAQ,QAAQ,IAAI,sBAAsB,aAAa,CAAC;EACtF,QAAQ,YAAY,qBAAqB,SAAS,aAAa;EAClE;AAED,MAAK,MAAM,UAAU,sBAAsB,OAAO;EAE9C,MAAM,iBAAiB,uBADC,MAAM,UAAU,WAAW,EACY,iBAAiB;AAChF,MAAI,eAAgB,QAAO;;AAI/B,KAAI,CAAC,OACD,UAAS,uBAAuB,eAAe,iBAAiB;AAIpE,KAAI,CAAC,OACD,OAAM,IAAI,MACN,kBAAkB,cAAc,uDAAuD,KAAK,GAAG,GAClG;AAGL,QAAO;;;;;;;;;;;;;;;;;;;ACzDX,eAAsB,gBAClB,SACA,gBACA,MACA,QACe;CACf,MAAM,EAAE,qBAAqB,oBAAoB;AAEjD,KAAI,CAAC,uBAAuB,oBAAoB,WAAW,EACvD,OAAM,IAAI,MAAM,SAAS,KAAK,GAAG,6CAA6C;CAIlF,MAAM,cAAc,MAAM,sBAAsB,SAAS,eAAe;AACxE,KAAI,OAAO,gBAAgB,YAAY,oBAAoB,SAAS,YAAY,CAC5E,QAAO;AAIX,KAAI,OAAO,qBAAqB,oBAAoB,SAAS,OAAO,kBAAkB,CAClF,QAAO,OAAO;AAIlB,QAAO;;;;;AClCX,MAAa,cAAcC,gBAAkC,KAAK;;;;;;;;;;;;;;;;;;;;AA8BlE,eAAsB,mBAAmB,SAAkB,UAAsD;CAC7G,MAAM,OAAO,MAAM,YAAY,SAAS,SAAS;CACjD,MAAM,SAAS,MAAM,cAAc,SAAS,UAAU,KAAK;AAE3D,QAAO;EAAE;EAAM;EAAQ,UADN,MAAM,gBAAgB,SAAS,SAAS,gBAAgB,MAAM,OAAO;EACrD;;;;;;;;;;;;;;;;;;;;AAuBrC,SAAgB,sBAAsB,SAA0C;CAC5E,MAAM,UAAU,QAAQ,IAAI,YAAY;AACxC,KAAI,CAAC,QAAS,QAAO;AACrB,QAAO;EACH,YAAY,QAAQ;EACpB,cAAc,QAAQ;EACtB,gBAAgB,QAAQ;EAC3B;;;;;;;;;;;;;;;;AAiBL,eAAe,iBACX,SACA,UACA,UACA,MACA,QACA,UAC2G;CAC3G,MAAM,YAAY,SAAS,oBAAoB,QAAQ,SAAS,SAAS;CACzE,MAAM,cAAc,SAAS,sBAAsB,QAAQ,SAAS,SAAS;CAI7E,MAAM,qBAAqB,SAAS,QAAQ,gBAAgB,IAAI,EAAE;CAClE,MAAM,gCAAgC,mBAAmB,MAAM,WAC3D,OAAO,WAAW,GAAG,SAAS,WAAW,KAAK,GAAG,CACpD;CACD,MAAM,kCAAkC,mBAAmB,MAAM,WAC7D,OAAO,WAAW,GAAG,SAAS,aAAa,KAAK,GAAG,CACtD;CACD,MAAM,oCAAoC,mBAAmB,MAAM,WAC/D,OAAO,WAAW,GAAG,SAAS,eAAe,KAAK,GAAG,CACxD;CAED,MAAM,sBAAsB,QAAQ,QAAQ,IAAI,SAAS;CACzD,MAAM,CAAC,oBAAoB,sBAAsB,0BAA0B,MAAM,QAAQ,IAAI;EACzF,SAAS,WAAW,MAAM,oBAAoB;EAC9C,SAAS,aAAa,MAAM,oBAAoB;EAChD,SAAS,eAAe,MAAM,oBAAoB;EACrD,CAAC;AAIF,QAAO;EACH,qBAAqB,aAAa,CAAC,iCAAiC,uBAAuB,KAAK;EAChG,uBAAuB,eAAe,CAAC,mCAAmC,yBAAyB,OAAO;EAC1G,yBAAyB,CAAC,qCAAqC,2BAA2B;EAC7F;;;;;;;;;AAUL,SAAgB,4BAA4B,QAAkD;CAE1F,MAAMC,sBAA2D;EAC7D,GAAG;EACH,GAAG,OAAO;EACb;CACD,MAAMC,wBAA+D;EACjE,GAAG;EACH,GAAG,OAAO;EACb;CAGD,MAAM,aAAa,wBAAwB,oBAAoB,cAAc,OAAO,cAAc;CAClG,MAAM,eAAe,wBAAwB,sBAAsB,cAAc,OAAO,cAAc;CACtG,MAAM,iBAAiB,qBACnB,OAAO,sBAAsB,8BAC7B,OAAO,cACV;CAED,MAAMC,WAAyB;EAC3B,GAAG;EACH;EACA;EACA;EACA;EACA;EACH;CAED,MAAMC,wBAAsD,OACxD,EAAE,SAAS,WACX,SACoB;EACpB,MAAM,EAAE,MAAM,QAAQ,aAAa,MAAM,mBAAmB,SAAS,SAAS;AAG9E,UAAQ,IAAI,aAAa;GACrB;GACA;GACA;GACA,YAAY,SAAS;GACrB,cAAc,SAAS;GACvB,gBAAgB,SAAS;GAC5B,CAAC;AAIF,qBAAmB,IAAI,SAAS,OAAO,GAAG;EAE1C,MAAM,WAAW,MAAM,MAAM;EAK7B,MAAM,EAAE,qBAAqB,uBAAuB,4BAA4B,MAAM,iBAClF,SACA,UACA,UACA,MACA,QACA,SACH;AAGD,MAAI,CAAC,uBAAuB,CAAC,yBAAyB,CAAC,wBACnD,QAAO;EAGX,MAAM,CAAC,eAAe,iBAAiB,qBAAqB,MAAM,QAAQ,IAAI;GAC1E,sBAAsB,SAAS,WAAW,UAAU,KAAK,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,QAAQ,QAAQ,KAAK;GACnG,wBAAwB,SAAS,aAAa,UAAU,OAAO,IAAI,EAAE,MAAM,KAAK,CAAC,GAAG,QAAQ,QAAQ,KAAK;GACzG,0BAA0B,SAAS,eAAe,UAAU,SAAS,GAAG,QAAQ,QAAQ,KAAK;GAChG,CAAC;AAEF,MAAI,cAAe,UAAS,QAAQ,OAAO,cAAc,cAAc;AACvE,MAAI,gBAAiB,UAAS,QAAQ,OAAO,cAAc,gBAAgB;AAC3E,MAAI,kBAAmB,UAAS,QAAQ,OAAO,cAAc,kBAAkB;AAE/E,SAAO;;AAGX,QAAO"}
+{"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 *\n * @example\n * resolvePrefix({ prefix: '/:siteId/:localeId', params: { siteId: 'global', localeId: 'en-GB' } })\n * // → '/global/en-GB'\n */\nexport function resolvePrefix({ prefix, params }: { 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 a URL prefix from a pathname.\n *\n * Accepts either a resolved prefix or a prefix pattern — segments may be\n * literal strings (must match the pathname exactly) or `:param` placeholders\n * (match any segment value). Mixed prefixes are supported.\n *\n * Returns `''` when the pathname matches the prefix exactly with no remainder\n * (so concatenating `prefix + result` round-trips the input), `pathname`\n * unchanged when literal segments don't match or the path is shorter than the\n * prefix, or the bare remainder otherwise. Callers that need the homepage to\n * be `'/'` should coerce: `stripPathPrefix(...) || '/'`.\n *\n * @example\n * stripPathPrefix({ pathname: '/global/en-GB/checkout', prefix: '/:siteId/:localeId' })   // → '/checkout'\n * stripPathPrefix({ pathname: '/global/en-GB/checkout', prefix: '/global/en-GB' })        // → '/checkout'\n * stripPathPrefix({ pathname: '/shop/en-GB/x',          prefix: '/shop/:localeId' })      // → '/x'\n * stripPathPrefix({ pathname: '/global/en-GB',          prefix: '/:siteId/:localeId' })   // → ''\n * stripPathPrefix({ pathname: '/checkout',              prefix: '/:siteId/:localeId' })   // → '/checkout'\n * stripPathPrefix({ pathname: '/other/x',               prefix: '/global/en-GB' })        // → '/other/x'\n * stripPathPrefix({ pathname: '/x',                     prefix: '' })                     // → '/x'\n */\nexport function stripPathPrefix({ pathname, prefix }: { pathname: string; prefix: string }): string {\n    if (!prefix || prefix === '/') return pathname;\n\n    const prefixSegments = prefix.split('/').filter(Boolean);\n    const pathSegments = pathname.split('/').filter(Boolean);\n\n    if (pathSegments.length < prefixSegments.length) return pathname;\n\n    // Literal segments must match exactly; ':param' segments match anything.\n    for (let i = 0; i < prefixSegments.length; i++) {\n        const segment = prefixSegments[i];\n        if (!segment.startsWith(':') && segment !== pathSegments[i]) {\n            return pathname;\n        }\n    }\n\n    const remaining = pathSegments.slice(prefixSegments.length);\n    return remaining.length === 0 ? '' : `/${remaining.join('/')}`;\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 =\n        urlConfig.prefix && urlConfig.prefix !== '/' ? resolvePrefix({ prefix: urlConfig.prefix, params }) : '';\n    const path = pathPrefix ? `${pathPrefix}${stripPathPrefix({ pathname, prefix: 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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"}

package/dist/types.d.ts

@@ -14,6 +14,17 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/**
+ * Baseline configuration shapes for templates that have a notion of sites,
+ * locales, and URL prefixes. These are opt-in helpers, not enforced contracts —
+ * `BaseConfig<App>` is generic over the template's `App` shape, so a template
+ * with a different shopper model (e.g. B2B, OMS-only) can define its own types
+ * and ignore the ones below.
+ *
+ * For richer runtime shapes used by the site context middleware (with
+ * cookie-based detection, site/locale aliases, etc.) see
+ * `@salesforce/storefront-next-runtime/site-context`.
+ */
 type Locale = {
   id: string;
   preferredCurrency: string;
@@ -30,11 +41,16 @@ type Site = {
   supportedLocales: Array<Locale>;
 };
 type Url = {
-  /** URL path prefix using React Router param syntax. e.g. '/:siteId/:localeId' */
+  /**
+   * URL path prefix using React Router param syntax — interpolated by the
+   * template's URL builder. Templates with site/locale routing typically use
+   * something like `'/:siteId/:localeId'`; templates without routing params
+   * can omit this field.
+   */
   prefix?: string;
   /**
-   * Query parameters to append to URLs, using ':param' syntax.
-   * e.g. '?lng=:localeId' or '?lng=:localeId&site=:siteId'
+   * Query parameters to append to URLs, using `:param` syntax — interpolated
+   * by the template's URL builder. Pair shape with `prefix` above.
    */
   search?: string;
   excludeRoutes?: string[];

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/config/types.ts"],"sourcesContent":[],"mappings":";;AAgBA;AAKA;AAYA;;;;;;;;;;;;KAjBY,MAAA;;;;KAKA,IAAA;;;;;;;;;oBASU,MAAM;;KAGhB,GAAA"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../src/config/types.ts"],"sourcesContent":[],"mappings":";;AA4BA;AAKA;AAYA;;;;;;;;;;;;;;;;;;;;;;;KAjBY,MAAA;;;;KAKA,IAAA;;;;;;;;;oBASU,MAAM;;KAGhB,GAAA"}