@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/core/shopify-scripts/types.d.mts

@@ -0,0 +1,76 @@
+import { I18nConfig } from "../request-context.mjs";
+import { ShopifyRouteTemplates } from "../standard-routes/types.mjs";
+import { ShopifyGlobal } from "../../globals.mjs";
+import { ConsentConfig, ShopAnalyticsChannel, StorefrontAnalyticsConfig } from "../analytics/types.mjs";
+
+//#region src/core/shopify-scripts/types.d.ts
+type ShopifyScriptsAnalyticsConfig = {
+  channel?: ShopAnalyticsChannel;
+  customData?: StorefrontAnalyticsConfig["customData"];
+};
+type ShopifyScriptsI18n = Pick<I18nConfig, "country" | "language"> & Partial<Pick<I18nConfig, "pathPrefix">> & {
+  currency?: string;
+};
+type ShopifyCrossOrigin = "" | "anonymous" | "use-credentials";
+type ShopifyDataAttributes = {
+  [name: `data-${string}`]: string;
+};
+type ShopifyScriptTagAttributes = ShopifyDataAttributes & Partial<{
+  async: boolean;
+  crossorigin: ShopifyCrossOrigin;
+  defer: boolean;
+  id: string;
+  nonce: string;
+  src: string;
+  type: string;
+}>;
+type ShopifyLinkTagAttributes = Partial<{
+  as: "script";
+  crossorigin: ShopifyCrossOrigin;
+  href: string;
+  rel: "preconnect" | "prefetch";
+}>;
+type ShopifyScriptDescriptor = {
+  tagName: "script";
+  attributes?: ShopifyScriptTagAttributes;
+  innerHTML?: string;
+};
+type ShopifyLinkDescriptor = {
+  tagName: "link";
+  attributes: ShopifyLinkTagAttributes;
+  innerHTML?: never;
+};
+type ShopifyScriptTagDescriptor = ShopifyScriptDescriptor | ShopifyLinkDescriptor;
+type ShopifyScriptTagDescriptors = {
+  /** Link descriptors for framework head APIs that split links from scripts. */readonly links: readonly ShopifyLinkDescriptor[]; /** Script descriptors for framework head APIs that split scripts from links. */
+  readonly scripts: readonly ShopifyScriptDescriptor[]; /** All generated descriptors as a mixed list, with links before scripts. */
+  readonly tags: readonly ShopifyScriptTagDescriptor[];
+};
+type ShopifyScriptsShop = {
+  shopId: string;
+  storefrontId: string; /** The shop's permanent `*.myshopify.com` domain, exposed as `window.Shopify.shop`. */
+  myshopifyDomain: string;
+};
+type ShopifyScriptTagsOptions = {
+  analytics?: ShopifyScriptsAnalyticsConfig;
+  consent?: ConsentConfig;
+  debug?: {
+    /** Loads Shopify's standard events inspector in development builds. */standardEventsInspector?: boolean;
+  };
+  i18n?: ShopifyScriptsI18n; /** Loads Inbox. Render `<shopify-chat>` where you want the chat UI to appear. */
+  inbox?: boolean;
+  nonce?: string;
+  shop: ShopifyScriptsShop;
+  shopifyAnalytics?: boolean;
+};
+type ShopifyRoutesOptions = {
+  navigate?: ShopifyGlobal["routes"]["navigate"];
+  routes?: ShopifyRouteTemplates;
+};
+type InitializeShopifyScriptsOptions = ShopifyRoutesOptions & {
+  webMcp?: boolean;
+};
+type ShopifyScriptsOptions = ShopifyScriptTagsOptions & InitializeShopifyScriptsOptions;
+//#endregion
+export { InitializeShopifyScriptsOptions, ShopifyRoutesOptions, ShopifyScriptTagDescriptor, ShopifyScriptTagDescriptors, ShopifyScriptTagsOptions, ShopifyScriptsAnalyticsConfig, ShopifyScriptsI18n, ShopifyScriptsOptions, ShopifyScriptsShop };
+//# sourceMappingURL=types.d.mts.map

package/dist/core/shopify-scripts/utils/cookie-domain.mjs

@@ -0,0 +1,43 @@
+//#region src/core/shopify-scripts/utils/cookie-domain.ts
+function normalizeHost(host) {
+	return host.replace(/^https?:\/\//, "").split("/")[0]?.split(":")[0]?.replace(/^\./, "").toLowerCase() ?? "";
+}
+function isIpAddress(host) {
+	return /^\d{1,3}(?:\.\d{1,3}){3}$/.test(host) || host.includes(":");
+}
+function canUseDomainCookie(domain) {
+	if (typeof document === "undefined") return false;
+	const name = `hydrogen_domain_probe_${Math.random().toString(36).slice(2)}`;
+	const nameValuePair = `${name}=1`;
+	const cookie = `${nameValuePair}; domain=${domain}; path=/; SameSite=Lax`;
+	const cleanup = `${name}=; domain=${domain}; path=/; max-age=0; SameSite=Lax`;
+	try {
+		document.cookie = cookie;
+		const found = document.cookie.split(";").some((part) => part.trim() === nameValuePair);
+		document.cookie = cleanup;
+		return found;
+	} catch {
+		return false;
+	}
+}
+/**
+* Finds the broadest wildcard cookie domain the current document can set for a
+* host. Browsers reject public suffixes like `.com` and `.co.uk`, so probing is
+* the only reliable way to find the earliest usable wildcard without shipping a
+* public suffix list.
+*/
+function findWritableCookieDomain(host, probe = canUseDomainCookie) {
+	const normalizedHost = normalizeHost(host);
+	if (!normalizedHost || normalizedHost === "localhost" || isIpAddress(normalizedHost)) return "";
+	const parts = normalizedHost.split(".").filter(Boolean);
+	if (parts.length < 2) return "";
+	for (let index = parts.length - 2; index >= 0; index--) {
+		const domain = `.${parts.slice(index).join(".")}`;
+		if (probe(domain)) return domain;
+	}
+	return "";
+}
+
+//#endregion
+export { findWritableCookieDomain };
+//# sourceMappingURL=cookie-domain.mjs.map

package/dist/core/shopify-scripts/utils/cookie-domain.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-domain.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/utils/cookie-domain.ts"],"sourcesContent":["function normalizeHost(host: string): string {\n  const withoutProtocol = host.replace(/^https?:\\/\\//, \"\");\n  return withoutProtocol.split(\"/\")[0]?.split(\":\")[0]?.replace(/^\\./, \"\").toLowerCase() ?? \"\";\n}\n\nfunction isIpAddress(host: string): boolean {\n  return /^\\d{1,3}(?:\\.\\d{1,3}){3}$/.test(host) || host.includes(\":\");\n}\n\nfunction canUseDomainCookie(domain: string): boolean {\n  if (typeof document === \"undefined\") return false;\n\n  const name = `hydrogen_domain_probe_${Math.random().toString(36).slice(2)}`;\n  const value = \"1\";\n  const nameValuePair = `${name}=${value}`;\n  const cookie = `${nameValuePair}; domain=${domain}; path=/; SameSite=Lax`;\n  const cleanup = `${name}=; domain=${domain}; path=/; max-age=0; SameSite=Lax`;\n\n  try {\n    document.cookie = cookie;\n    const found = document.cookie.split(\";\").some((part) => part.trim() === nameValuePair);\n    document.cookie = cleanup;\n    return found;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Finds the broadest wildcard cookie domain the current document can set for a\n * host. Browsers reject public suffixes like `.com` and `.co.uk`, so probing is\n * the only reliable way to find the earliest usable wildcard without shipping a\n * public suffix list.\n */\nexport function findWritableCookieDomain(\n  host: string,\n  probe: (domain: string) => boolean = canUseDomainCookie,\n): string {\n  const normalizedHost = normalizeHost(host);\n  if (!normalizedHost || normalizedHost === \"localhost\" || isIpAddress(normalizedHost)) return \"\";\n\n  const parts = normalizedHost.split(\".\").filter(Boolean);\n  if (parts.length < 2) return \"\";\n\n  for (let index = parts.length - 2; index >= 0; index--) {\n    const domain = `.${parts.slice(index).join(\".\")}`;\n    if (probe(domain)) return domain;\n  }\n\n  return \"\";\n}\n"],"mappings":";AAAA,SAAS,cAAc,MAAsB;AAE3C,QADwB,KAAK,QAAQ,gBAAgB,GAC/B,CAAC,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,QAAQ,OAAO,GAAG,CAAC,aAAa,IAAI;;AAG3F,SAAS,YAAY,MAAuB;AAC1C,QAAO,4BAA4B,KAAK,KAAK,IAAI,KAAK,SAAS,IAAI;;AAGrE,SAAS,mBAAmB,QAAyB;AACnD,KAAI,OAAO,aAAa,YAAa,QAAO;CAE5C,MAAM,OAAO,yBAAyB,KAAK,QAAQ,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE;CAEzE,MAAM,gBAAgB,GAAG,KAAK;CAC9B,MAAM,SAAS,GAAG,cAAc,WAAW,OAAO;CAClD,MAAM,UAAU,GAAG,KAAK,YAAY,OAAO;AAE3C,KAAI;AACF,WAAS,SAAS;EAClB,MAAM,QAAQ,SAAS,OAAO,MAAM,IAAI,CAAC,MAAM,SAAS,KAAK,MAAM,KAAK,cAAc;AACtF,WAAS,SAAS;AAClB,SAAO;SACD;AACN,SAAO;;;;;;;;;AAUX,SAAgB,yBACd,MACA,QAAqC,oBAC7B;CACR,MAAM,iBAAiB,cAAc,KAAK;AAC1C,KAAI,CAAC,kBAAkB,mBAAmB,eAAe,YAAY,eAAe,CAAE,QAAO;CAE7F,MAAM,QAAQ,eAAe,MAAM,IAAI,CAAC,OAAO,QAAQ;AACvD,KAAI,MAAM,SAAS,EAAG,QAAO;AAE7B,MAAK,IAAI,QAAQ,MAAM,SAAS,GAAG,SAAS,GAAG,SAAS;EACtD,MAAM,SAAS,IAAI,MAAM,MAAM,MAAM,CAAC,KAAK,IAAI;AAC/C,MAAI,MAAM,OAAO,CAAE,QAAO;;AAG5B,QAAO"}

package/dist/core/shopify-scripts/utils/inline-script.mjs

@@ -0,0 +1,8 @@
+//#region src/core/shopify-scripts/utils/inline-script.ts
+function asInlineScript(script) {
+	return script;
+}
+
+//#endregion
+export { asInlineScript };
+//# sourceMappingURL=inline-script.mjs.map

package/dist/core/shopify-scripts/utils/inline-script.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline-script.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/utils/inline-script.ts"],"sourcesContent":["type InlineScriptSource = (...args: never[]) => unknown;\n\ntype InlineScriptFactory<T extends InlineScriptSource> = (...args: Parameters<T>) => string;\n\nexport function asInlineScript<T extends InlineScriptSource>(script: T): InlineScriptFactory<T>;\nexport function asInlineScript(script: InlineScriptSource) {\n  return script;\n}\n"],"mappings":";AAKA,SAAgB,eAAe,QAA4B;AACzD,QAAO"}

package/dist/core/shopify-scripts/utils/navigation.mjs

@@ -0,0 +1,46 @@
+//#region src/core/shopify-scripts/utils/navigation.ts
+const navigationCallbacks = /* @__PURE__ */ new Set();
+let stopObservingNavigation;
+function observeNavigation(callback) {
+	navigationCallbacks.add(callback);
+	stopObservingNavigation ??= startObservingNavigation();
+	return () => {
+		navigationCallbacks.delete(callback);
+		if (navigationCallbacks.size > 0) return;
+		stopObservingNavigation?.();
+		stopObservingNavigation = void 0;
+	};
+}
+function startObservingNavigation() {
+	const navigation = Reflect.get(window, "navigation");
+	if (navigation instanceof EventTarget) {
+		navigation.addEventListener("currententrychange", notifyNavigationCallbacks);
+		return () => navigation.removeEventListener("currententrychange", notifyNavigationCallbacks);
+	}
+	const restorePushState = patchHistoryMethod("pushState");
+	const restoreReplaceState = patchHistoryMethod("replaceState");
+	window.addEventListener("popstate", notifyNavigationCallbacks);
+	return () => {
+		restorePushState();
+		restoreReplaceState();
+		window.removeEventListener("popstate", notifyNavigationCallbacks);
+	};
+}
+function notifyNavigationCallbacks() {
+	for (const callback of navigationCallbacks) callback();
+}
+function patchHistoryMethod(method) {
+	const original = window.history[method];
+	const patched = function(data, unused, url) {
+		original.call(this, data, unused, url);
+		notifyNavigationCallbacks();
+	};
+	window.history[method] = patched;
+	return () => {
+		if (window.history[method] === patched) window.history[method] = original;
+	};
+}
+
+//#endregion
+export { observeNavigation };
+//# sourceMappingURL=navigation.mjs.map

package/dist/core/shopify-scripts/utils/navigation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/utils/navigation.ts"],"sourcesContent":["const navigationCallbacks = new Set<() => void>();\nlet stopObservingNavigation: (() => void) | undefined;\n\nexport function observeNavigation(callback: () => void) {\n  navigationCallbacks.add(callback);\n  stopObservingNavigation ??= startObservingNavigation();\n\n  return () => {\n    navigationCallbacks.delete(callback);\n    if (navigationCallbacks.size > 0) return;\n\n    stopObservingNavigation?.();\n    stopObservingNavigation = undefined;\n  };\n}\n\nfunction startObservingNavigation() {\n  const navigation = Reflect.get(window, \"navigation\");\n  if (navigation instanceof EventTarget) {\n    navigation.addEventListener(\"currententrychange\", notifyNavigationCallbacks);\n    return () => navigation.removeEventListener(\"currententrychange\", notifyNavigationCallbacks);\n  }\n\n  const restorePushState = patchHistoryMethod(\"pushState\");\n  const restoreReplaceState = patchHistoryMethod(\"replaceState\");\n  window.addEventListener(\"popstate\", notifyNavigationCallbacks);\n\n  return () => {\n    restorePushState();\n    restoreReplaceState();\n    window.removeEventListener(\"popstate\", notifyNavigationCallbacks);\n  };\n}\n\nfunction notifyNavigationCallbacks() {\n  for (const callback of navigationCallbacks) callback();\n}\n\nfunction patchHistoryMethod(method: \"pushState\" | \"replaceState\") {\n  const original = window.history[method];\n  const patched: History[typeof method] = function (this: History, data, unused, url) {\n    original.call(this, data, unused, url);\n    notifyNavigationCallbacks();\n  };\n\n  window.history[method] = patched;\n\n  return () => {\n    if (window.history[method] === patched) window.history[method] = original;\n  };\n}\n"],"mappings":";AAAA,MAAM,sCAAsB,IAAI,KAAiB;AACjD,IAAI;AAEJ,SAAgB,kBAAkB,UAAsB;AACtD,qBAAoB,IAAI,SAAS;AACjC,6BAA4B,0BAA0B;AAEtD,cAAa;AACX,sBAAoB,OAAO,SAAS;AACpC,MAAI,oBAAoB,OAAO,EAAG;AAElC,6BAA2B;AAC3B,4BAA0B;;;AAI9B,SAAS,2BAA2B;CAClC,MAAM,aAAa,QAAQ,IAAI,QAAQ,aAAa;AACpD,KAAI,sBAAsB,aAAa;AACrC,aAAW,iBAAiB,sBAAsB,0BAA0B;AAC5E,eAAa,WAAW,oBAAoB,sBAAsB,0BAA0B;;CAG9F,MAAM,mBAAmB,mBAAmB,YAAY;CACxD,MAAM,sBAAsB,mBAAmB,eAAe;AAC9D,QAAO,iBAAiB,YAAY,0BAA0B;AAE9D,cAAa;AACX,oBAAkB;AAClB,uBAAqB;AACrB,SAAO,oBAAoB,YAAY,0BAA0B;;;AAIrE,SAAS,4BAA4B;AACnC,MAAK,MAAM,YAAY,oBAAqB,WAAU;;AAGxD,SAAS,mBAAmB,QAAsC;CAChE,MAAM,WAAW,OAAO,QAAQ;CAChC,MAAM,UAAkC,SAAyB,MAAM,QAAQ,KAAK;AAClF,WAAS,KAAK,MAAM,MAAM,QAAQ,IAAI;AACtC,6BAA2B;;AAG7B,QAAO,QAAQ,UAAU;AAEzB,cAAa;AACX,MAAI,OAAO,QAAQ,YAAY,QAAS,QAAO,QAAQ,UAAU"}

package/dist/core/shopify-scripts/utils/tracking-values.mjs

@@ -0,0 +1,65 @@
+//#region src/core/shopify-scripts/utils/tracking-values.ts
+const cachedTrackingValues = { current: null };
+function getTrackingValues() {
+	let trackingValues;
+	if (typeof window !== "undefined" && typeof window.performance !== "undefined") try {
+		const resourceRE = /^https?:\/\/([^/]+)(\/api\/(?:unstable|2\d{3}-\d{2})\/graphql\.json(?=$|\?))?/;
+		const entries = performance.getEntriesByType("resource");
+		let matchedValues;
+		for (let i = entries.length - 1; i >= 0; i--) {
+			const entry = entries[i];
+			if (entry.initiatorType !== "fetch") continue;
+			const currentHost = window.location.host;
+			const match = entry.name.match(resourceRE);
+			if (!match) continue;
+			const [, matchedHost, sfapiPath] = match;
+			if (matchedHost === currentHost || sfapiPath && matchedHost?.endsWith(`.${currentHost}`)) {
+				const values = extractFromPerformanceEntry(entry);
+				if (values) {
+					matchedValues = values;
+					break;
+				}
+			}
+		}
+		if (matchedValues) trackingValues = matchedValues;
+		if (trackingValues) cachedTrackingValues.current = trackingValues;
+		else if (cachedTrackingValues.current) trackingValues = cachedTrackingValues.current;
+		if (!trackingValues) {
+			const navigationEntries = performance.getEntriesByType("navigation")[0];
+			trackingValues = extractFromPerformanceEntry(navigationEntries, false);
+		}
+	} catch {}
+	if (!trackingValues) {
+		const cookie = typeof document !== "undefined" ? document.cookie : "";
+		trackingValues = {
+			uniqueToken: cookie.match(/\b_shopify_y=([^;]+)/)?.[1] || "",
+			visitToken: cookie.match(/\b_shopify_s=([^;]+)/)?.[1] || "",
+			consent: cookie.match(/\b_tracking_consent=([^;]+)/)?.[1] || ""
+		};
+	}
+	return trackingValues;
+}
+function extractFromPerformanceEntry(entry, isConsentRequired = true) {
+	let uniqueToken = "";
+	let visitToken = "";
+	let consent = "";
+	const serverTiming = entry.serverTiming;
+	const minimumEntries = isConsentRequired ? 3 : 2;
+	if (serverTiming && serverTiming.length >= minimumEntries) for (let i = serverTiming.length - 1; i >= 0; i--) {
+		const { name, description } = serverTiming[i];
+		if (!name || !description) continue;
+		if (name === "_y") uniqueToken = description;
+		else if (name === "_s") visitToken = description;
+		else if (name === "_cmp") consent = description;
+		if (uniqueToken && visitToken && consent) break;
+	}
+	return uniqueToken && visitToken && (isConsentRequired ? consent : true) ? {
+		uniqueToken,
+		visitToken,
+		consent
+	} : void 0;
+}
+
+//#endregion
+export { getTrackingValues };
+//# sourceMappingURL=tracking-values.mjs.map

package/dist/core/shopify-scripts/utils/tracking-values.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracking-values.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/utils/tracking-values.ts"],"sourcesContent":["/**\n * Inlined from @shopify/hydrogen-react/tracking-utils.\n * Retrieves user session tracking values from Server-Timing headers\n * and the Performance API.\n */\n\ntype TrackingValues = {\n  uniqueToken: string;\n  visitToken: string;\n  consent: string;\n};\n\nconst cachedTrackingValues: { current: null | TrackingValues } = { current: null };\n\nexport function getTrackingValues(): TrackingValues {\n  // Tracking values are returned in Server-Timing headers from SFAPI responses.\n  // Prefer recent fetch/resource entries, then cached values, then the initial\n  // navigation entry, and finally the deprecated JS-visible cookies.\n  let trackingValues: TrackingValues | undefined;\n\n  if (typeof window !== \"undefined\" && typeof window.performance !== \"undefined\") {\n    try {\n      // Extract host and optionally match the SFAPI GraphQL pathname.\n      const resourceRE =\n        /^https?:\\/\\/([^/]+)(\\/api\\/(?:unstable|2\\d{3}-\\d{2})\\/graphql\\.json(?=$|\\?))?/;\n\n      // Search backwards so the latest matching fetch with complete tracking\n      // values wins. Same-origin fetches cover Hydrogen proxy/server responses;\n      // subdomain SFAPI requests cover direct Storefront API calls.\n      const entries = performance.getEntriesByType(\"resource\") as PerformanceResourceTiming[];\n\n      let matchedValues: TrackingValues | undefined;\n\n      for (let i = entries.length - 1; i >= 0; i--) {\n        const entry = entries[i];\n        if (entry.initiatorType !== \"fetch\") continue;\n\n        const currentHost = window.location.host;\n        const match = entry.name.match(resourceRE);\n        if (!match) continue;\n\n        const [, matchedHost, sfapiPath] = match;\n        const isMatch =\n          matchedHost === currentHost || (sfapiPath && matchedHost?.endsWith(`.${currentHost}`));\n\n        if (isMatch) {\n          const values = extractFromPerformanceEntry(entry);\n          if (values) {\n            matchedValues = values;\n            break;\n          }\n        }\n      }\n\n      if (matchedValues) {\n        trackingValues = matchedValues;\n      }\n\n      // Resource entries have a limited buffer and can be removed over time.\n      // A cached resource entry is newer than the navigation entry.\n      if (trackingValues) {\n        cachedTrackingValues.current = trackingValues;\n      } else if (cachedTrackingValues.current) {\n        trackingValues = cachedTrackingValues.current;\n      }\n\n      if (!trackingValues) {\n        // The document navigation entry can omit _cmp when the server generated\n        // tracking tokens, so only _y and _s are required for this fallback.\n        const navigationEntries = performance.getEntriesByType(\n          \"navigation\",\n        )[0] as PerformanceNavigationTiming;\n        trackingValues = extractFromPerformanceEntry(navigationEntries, false);\n      }\n    } catch {}\n  }\n\n  if (!trackingValues) {\n    const cookie = typeof document !== \"undefined\" ? document.cookie : \"\";\n\n    trackingValues = {\n      uniqueToken: cookie.match(/\\b_shopify_y=([^;]+)/)?.[1] || \"\",\n      visitToken: cookie.match(/\\b_shopify_s=([^;]+)/)?.[1] || \"\",\n      consent: cookie.match(/\\b_tracking_consent=([^;]+)/)?.[1] || \"\",\n    };\n  }\n\n  return trackingValues;\n}\n\nfunction extractFromPerformanceEntry(\n  entry: PerformanceNavigationTiming | PerformanceResourceTiming,\n  isConsentRequired = true,\n): TrackingValues | undefined {\n  let uniqueToken = \"\";\n  let visitToken = \"\";\n  let consent = \"\";\n\n  const serverTiming = entry.serverTiming;\n  const minimumEntries = isConsentRequired ? 3 : 2;\n  if (serverTiming && serverTiming.length >= minimumEntries) {\n    // Iterate backwards since Shopify tracking metrics are usually appended\n    // after framework/server metrics.\n    for (let i = serverTiming.length - 1; i >= 0; i--) {\n      const { name, description } = serverTiming[i];\n      if (!name || !description) continue;\n\n      if (name === \"_y\") uniqueToken = description;\n      else if (name === \"_s\") visitToken = description;\n      else if (name === \"_cmp\") {\n        // Consent value used by consent-tracking-api and privacy-banner scripts.\n        consent = description;\n      }\n\n      if (uniqueToken && visitToken && consent) break;\n    }\n  }\n\n  return uniqueToken && visitToken && (isConsentRequired ? consent : true)\n    ? { uniqueToken, visitToken, consent }\n    : undefined;\n}\n"],"mappings":";AAYA,MAAM,uBAA2D,EAAE,SAAS,MAAM;AAElF,SAAgB,oBAAoC;CAIlD,IAAI;AAEJ,KAAI,OAAO,WAAW,eAAe,OAAO,OAAO,gBAAgB,YACjE,KAAI;EAEF,MAAM,aACJ;EAKF,MAAM,UAAU,YAAY,iBAAiB,WAAW;EAExD,IAAI;AAEJ,OAAK,IAAI,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,KAAK;GAC5C,MAAM,QAAQ,QAAQ;AACtB,OAAI,MAAM,kBAAkB,QAAS;GAErC,MAAM,cAAc,OAAO,SAAS;GACpC,MAAM,QAAQ,MAAM,KAAK,MAAM,WAAW;AAC1C,OAAI,CAAC,MAAO;GAEZ,MAAM,GAAG,aAAa,aAAa;AAInC,OAFE,gBAAgB,eAAgB,aAAa,aAAa,SAAS,IAAI,cAAc,EAE1E;IACX,MAAM,SAAS,4BAA4B,MAAM;AACjD,QAAI,QAAQ;AACV,qBAAgB;AAChB;;;;AAKN,MAAI,cACF,kBAAiB;AAKnB,MAAI,eACF,sBAAqB,UAAU;WACtB,qBAAqB,QAC9B,kBAAiB,qBAAqB;AAGxC,MAAI,CAAC,gBAAgB;GAGnB,MAAM,oBAAoB,YAAY,iBACpC,aACD,CAAC;AACF,oBAAiB,4BAA4B,mBAAmB,MAAM;;SAElE;AAGV,KAAI,CAAC,gBAAgB;EACnB,MAAM,SAAS,OAAO,aAAa,cAAc,SAAS,SAAS;AAEnE,mBAAiB;GACf,aAAa,OAAO,MAAM,uBAAuB,GAAG,MAAM;GAC1D,YAAY,OAAO,MAAM,uBAAuB,GAAG,MAAM;GACzD,SAAS,OAAO,MAAM,8BAA8B,GAAG,MAAM;GAC9D;;AAGH,QAAO;;AAGT,SAAS,4BACP,OACA,oBAAoB,MACQ;CAC5B,IAAI,cAAc;CAClB,IAAI,aAAa;CACjB,IAAI,UAAU;CAEd,MAAM,eAAe,MAAM;CAC3B,MAAM,iBAAiB,oBAAoB,IAAI;AAC/C,KAAI,gBAAgB,aAAa,UAAU,eAGzC,MAAK,IAAI,IAAI,aAAa,SAAS,GAAG,KAAK,GAAG,KAAK;EACjD,MAAM,EAAE,MAAM,gBAAgB,aAAa;AAC3C,MAAI,CAAC,QAAQ,CAAC,YAAa;AAE3B,MAAI,SAAS,KAAM,eAAc;WACxB,SAAS,KAAM,cAAa;WAC5B,SAAS,OAEhB,WAAU;AAGZ,MAAI,eAAe,cAAc,QAAS;;AAI9C,QAAO,eAAe,eAAe,oBAAoB,UAAU,QAC/D;EAAE;EAAa;EAAY;EAAS,GACpC"}

package/dist/core/shopify-scripts/utils/uuid.mjs

@@ -0,0 +1,17 @@
+//#region src/core/shopify-scripts/utils/uuid.ts
+/**
+* Inlined from @shopify/hydrogen-react/analytics-utils.
+* UUID v4 generator for analytics event IDs.
+*/
+const UUID_V4_REPLACE_REGEX = /[018]/g;
+const CRYPTO_RANDOM_VALUES_ARRAY = new Uint8Array(1);
+function buildUUID() {
+	return "10000000-1000-4000-8000-100000000000".replace(UUID_V4_REPLACE_REGEX, (c) => {
+		const randomValue = crypto.getRandomValues(CRYPTO_RANDOM_VALUES_ARRAY)[0];
+		return (+c ^ randomValue & 15 >> +c / 4).toString(16);
+	});
+}
+
+//#endregion
+export { buildUUID };
+//# sourceMappingURL=uuid.mjs.map

package/dist/core/shopify-scripts/utils/uuid.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/utils/uuid.ts"],"sourcesContent":["/**\n * Inlined from @shopify/hydrogen-react/analytics-utils.\n * UUID v4 generator for analytics event IDs.\n */\n\nconst UUID_V4_REPLACE_REGEX = /[018]/g;\nconst CRYPTO_RANDOM_VALUES_ARRAY = new Uint8Array(1);\n\nexport function buildUUID(): string {\n  return \"10000000-1000-4000-8000-100000000000\".replace(UUID_V4_REPLACE_REGEX, (c) => {\n    const randomValue = crypto.getRandomValues(CRYPTO_RANDOM_VALUES_ARRAY)[0];\n    return (+c ^ (randomValue & (15 >> (+c / 4)))).toString(16);\n  });\n}\n"],"mappings":";;;;;AAKA,MAAM,wBAAwB;AAC9B,MAAM,6BAA6B,IAAI,WAAW,EAAE;AAEpD,SAAgB,YAAoB;AAClC,QAAO,uCAAuC,QAAQ,wBAAwB,MAAM;EAClF,MAAM,cAAc,OAAO,gBAAgB,2BAA2B,CAAC;AACvE,UAAQ,CAAC,IAAK,cAAe,MAAO,CAAC,IAAI,GAAM,SAAS,GAAG;GAC3D"}

package/dist/core/shopify-scripts/webmcp.mjs

@@ -0,0 +1,22 @@
+import { getLogger } from "../logging/logging.mjs";
+import { SHOPIFY_STOREFRONT_WEBMCP_SCRIPT } from "./constants.mjs";
+import { loadScript } from "../utils/load-script.mjs";
+
+//#region src/core/shopify-scripts/webmcp.ts
+const log = getLogger("webmcp");
+function loadShopifyWebMcpTools() {
+	if (typeof document !== "undefined" && "modelContext" in document || typeof navigator !== "undefined" && "modelContext" in navigator) return loadScript(SHOPIFY_STOREFRONT_WEBMCP_SCRIPT, {
+		in: "head",
+		attributes: {
+			id: "shopify-webmcp",
+			crossorigin: "anonymous"
+		}
+	}).catch((error) => {
+		log.warn("failed to load Shopify WebMCP", { error });
+	});
+	return Promise.resolve();
+}
+
+//#endregion
+export { loadShopifyWebMcpTools };
+//# sourceMappingURL=webmcp.mjs.map

package/dist/core/shopify-scripts/webmcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp.mjs","names":[],"sources":["../../../src/core/shopify-scripts/webmcp.ts"],"sourcesContent":["import { getLogger } from \"../logging\";\nimport { loadScript } from \"../utils/load-script\";\nimport { SHOPIFY_STOREFRONT_WEBMCP_SCRIPT } from \"./constants\";\n\nconst log = getLogger(\"webmcp\");\n\nexport function loadShopifyWebMcpTools(): Promise<boolean | void> {\n  if (\n    (typeof document !== \"undefined\" && \"modelContext\" in document) ||\n    (typeof navigator !== \"undefined\" && \"modelContext\" in navigator)\n  ) {\n    return loadScript(SHOPIFY_STOREFRONT_WEBMCP_SCRIPT, {\n      in: \"head\",\n      attributes: { id: \"shopify-webmcp\", crossorigin: \"anonymous\" },\n    }).catch((error) => {\n      log.warn(\"failed to load Shopify WebMCP\", { error });\n    });\n  }\n\n  return Promise.resolve();\n}\n"],"mappings":";;;;;AAIA,MAAM,MAAM,UAAU,SAAS;AAE/B,SAAgB,yBAAkD;AAChE,KACG,OAAO,aAAa,eAAe,kBAAkB,YACrD,OAAO,cAAc,eAAe,kBAAkB,UAEvD,QAAO,WAAW,kCAAkC;EAClD,IAAI;EACJ,YAAY;GAAE,IAAI;GAAkB,aAAa;GAAa;EAC/D,CAAC,CAAC,OAAO,UAAU;AAClB,MAAI,KAAK,iCAAiC,EAAE,OAAO,CAAC;GACpD;AAGJ,QAAO,QAAQ,SAAS"}

package/dist/core/standard-routes/build.d.mts

@@ -0,0 +1,34 @@
+import { ShopifyRouteTemplates } from "./types.mjs";
+
+//#region src/core/standard-routes/build.d.ts
+/**
+ * Creates a typed map of custom route templates for Shopify standard storefront routes.
+ *
+ * Use the returned object anywhere Hydrogen needs to understand the app's URL shape for
+ * Shopify resources and utility pages: `handleShopifyRedirects({routeTemplates})`, `ShopifyScripts`
+ * `routes={routeTemplates}`, and predictive search URL helpers.
+ *
+ * Each key represents a Shopify standard route identity, while each value is the app's custom
+ * pathname template. Templates must start with `/` and include the required named handle
+ * placeholders for routes that identify a resource. Do not include an i18n path prefix in the
+ * template; Hydrogen applies `i18n.pathPrefix` separately when resolving routes. Pass an empty
+ * object when the app uses standard storefront routes so there is still one app-owned routing
+ * manifest to update if routes change later. When matching the current page, standard storefront
+ * routes retain their page-template identities even if a configured template resolves another
+ * route to the same pathname.
+ *
+ * @example
+ * ```ts
+ * const routeTemplates = createShopifyRouteTemplates({
+ *   product: "/p/:productHandle",
+ *   collection: "/c/:collectionHandle",
+ *   article: "/journal/:blogHandle/:articleHandle",
+ *   cart: "/basket",
+ *   policy: "/legal/:policyHandle",
+ * });
+ * ```
+ */
+declare function createShopifyRouteTemplates<const TRoutes extends ShopifyRouteTemplates>(routes: TRoutes): TRoutes;
+//#endregion
+export { createShopifyRouteTemplates };
+//# sourceMappingURL=build.d.mts.map

package/dist/core/standard-routes/build.mjs

@@ -0,0 +1,54 @@
+import { DEFAULT_STANDARD_ROUTES, isStandardRouteParamName } from "./defaults.mjs";
+import { prependPathPrefix } from "./path.mjs";
+
+//#region src/core/standard-routes/build.ts
+/**
+* Creates a typed map of custom route templates for Shopify standard storefront routes.
+*
+* Use the returned object anywhere Hydrogen needs to understand the app's URL shape for
+* Shopify resources and utility pages: `handleShopifyRedirects({routeTemplates})`, `ShopifyScripts`
+* `routes={routeTemplates}`, and predictive search URL helpers.
+*
+* Each key represents a Shopify standard route identity, while each value is the app's custom
+* pathname template. Templates must start with `/` and include the required named handle
+* placeholders for routes that identify a resource. Do not include an i18n path prefix in the
+* template; Hydrogen applies `i18n.pathPrefix` separately when resolving routes. Pass an empty
+* object when the app uses standard storefront routes so there is still one app-owned routing
+* manifest to update if routes change later. When matching the current page, standard storefront
+* routes retain their page-template identities even if a configured template resolves another
+* route to the same pathname.
+*
+* @example
+* ```ts
+* const routeTemplates = createShopifyRouteTemplates({
+*   product: "/p/:productHandle",
+*   collection: "/c/:collectionHandle",
+*   article: "/journal/:blogHandle/:articleHandle",
+*   cart: "/basket",
+*   policy: "/legal/:policyHandle",
+* });
+* ```
+*/
+function createShopifyRouteTemplates(routes) {
+	return routes;
+}
+function getStandardRoute(routeTemplates, route, params, options = {}) {
+	return buildStandardRouteTarget(routeTemplates[route] ?? DEFAULT_STANDARD_ROUTES[route][0], params, options.pathPrefix);
+}
+/**
+* Builds a pathname from a route template, handle params, and optional i18n path prefix.
+*/
+function buildStandardRouteTarget(template, params, pathPrefix) {
+	return prependPathPrefix(interpolateRouteTemplate(template, params), pathPrefix);
+}
+function interpolateRouteTemplate(template, params) {
+	return template.replace(/:([A-Za-z][A-Za-z0-9_]*)/g, (placeholder, name) => {
+		if (!isStandardRouteParamName(name)) return placeholder;
+		const value = params[name];
+		return value === void 0 ? placeholder : encodeURIComponent(value);
+	});
+}
+
+//#endregion
+export { buildStandardRouteTarget, createShopifyRouteTemplates, getStandardRoute };
+//# sourceMappingURL=build.mjs.map

package/dist/core/standard-routes/build.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.mjs","names":[],"sources":["../../../src/core/standard-routes/build.ts"],"sourcesContent":["import { DEFAULT_STANDARD_ROUTES, isStandardRouteParamName } from \"./defaults\";\nimport { prependPathPrefix } from \"./path\";\nimport type {\n  ShopifyRouteTemplates,\n  StandardRouteName,\n  StandardRouteOptions,\n  StandardRouteParams,\n  StandardRouteParamsByName,\n} from \"./types\";\n\n/**\n * Creates a typed map of custom route templates for Shopify standard storefront routes.\n *\n * Use the returned object anywhere Hydrogen needs to understand the app's URL shape for\n * Shopify resources and utility pages: `handleShopifyRedirects({routeTemplates})`, `ShopifyScripts`\n * `routes={routeTemplates}`, and predictive search URL helpers.\n *\n * Each key represents a Shopify standard route identity, while each value is the app's custom\n * pathname template. Templates must start with `/` and include the required named handle\n * placeholders for routes that identify a resource. Do not include an i18n path prefix in the\n * template; Hydrogen applies `i18n.pathPrefix` separately when resolving routes. Pass an empty\n * object when the app uses standard storefront routes so there is still one app-owned routing\n * manifest to update if routes change later. When matching the current page, standard storefront\n * routes retain their page-template identities even if a configured template resolves another\n * route to the same pathname.\n *\n * @example\n * ```ts\n * const routeTemplates = createShopifyRouteTemplates({\n *   product: \"/p/:productHandle\",\n *   collection: \"/c/:collectionHandle\",\n *   article: \"/journal/:blogHandle/:articleHandle\",\n *   cart: \"/basket\",\n *   policy: \"/legal/:policyHandle\",\n * });\n * ```\n */\nexport function createShopifyRouteTemplates<const TRoutes extends ShopifyRouteTemplates>(\n  routes: TRoutes,\n): TRoutes {\n  return routes;\n}\n\nexport function getStandardRoute<const TRoute extends StandardRouteName>(\n  routeTemplates: ShopifyRouteTemplates,\n  route: TRoute,\n  params: StandardRouteParamsByName[TRoute],\n  options: StandardRouteOptions = {},\n): string {\n  const target = routeTemplates[route] ?? DEFAULT_STANDARD_ROUTES[route][0];\n\n  return buildStandardRouteTarget(target, params, options.pathPrefix);\n}\n\n/**\n * Builds a pathname from a route template, handle params, and optional i18n path prefix.\n */\nexport function buildStandardRouteTarget(\n  template: string,\n  params: StandardRouteParams,\n  pathPrefix: string | undefined,\n): string {\n  return prependPathPrefix(interpolateRouteTemplate(template, params), pathPrefix);\n}\n\nfunction interpolateRouteTemplate(template: string, params: StandardRouteParams): string {\n  return template.replace(/:([A-Za-z][A-Za-z0-9_]*)/g, (placeholder, name: string) => {\n    if (!isStandardRouteParamName(name)) return placeholder;\n\n    const value = params[name];\n    return value === undefined ? placeholder : encodeURIComponent(value);\n  });\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,SAAgB,4BACd,QACS;AACT,QAAO;;AAGT,SAAgB,iBACd,gBACA,OACA,QACA,UAAgC,EAAE,EAC1B;AAGR,QAAO,yBAFQ,eAAe,UAAU,wBAAwB,OAAO,IAE/B,QAAQ,QAAQ,WAAW;;;;;AAMrE,SAAgB,yBACd,UACA,QACA,YACQ;AACR,QAAO,kBAAkB,yBAAyB,UAAU,OAAO,EAAE,WAAW;;AAGlF,SAAS,yBAAyB,UAAkB,QAAqC;AACvF,QAAO,SAAS,QAAQ,8BAA8B,aAAa,SAAiB;AAClF,MAAI,CAAC,yBAAyB,KAAK,CAAE,QAAO;EAE5C,MAAM,QAAQ,OAAO;AACrB,SAAO,UAAU,SAAY,cAAc,mBAAmB,MAAM;GACpE"}

package/dist/core/standard-routes/defaults.mjs

@@ -0,0 +1,31 @@
+//#region src/core/standard-routes/defaults.ts
+const STANDARD_ROUTE_PARAM_NAMES = [
+	"articleHandle",
+	"blogHandle",
+	"collectionHandle",
+	"pageHandle",
+	"policyHandle",
+	"productHandle"
+];
+const DEFAULT_STANDARD_ROUTES = {
+	product: ["/products/:productHandle"],
+	collection: ["/collections/:collectionHandle"],
+	collectionList: ["/collections", "/products"],
+	page: ["/pages/:pageHandle"],
+	policy: ["/policies/:policyHandle"],
+	blog: ["/blogs/:blogHandle"],
+	article: ["/blogs/:blogHandle/:articleHandle"],
+	productInCollection: ["/collections/:collectionHandle/products/:productHandle"],
+	cart: ["/cart"],
+	search: ["/search"]
+};
+function isStandardRouteParamName(name) {
+	return STANDARD_ROUTE_PARAM_NAMES.some((paramName) => paramName === name);
+}
+function isStandardRouteName(name) {
+	return Object.hasOwn(DEFAULT_STANDARD_ROUTES, name);
+}
+
+//#endregion
+export { DEFAULT_STANDARD_ROUTES, isStandardRouteName, isStandardRouteParamName };
+//# sourceMappingURL=defaults.mjs.map

package/dist/core/standard-routes/defaults.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.mjs","names":[],"sources":["../../../src/core/standard-routes/defaults.ts"],"sourcesContent":["import type { ShopifyRouteTemplates, StandardRouteName, StandardRouteParamName } from \"./types\";\n\ntype DefaultStandardRoutes = {\n  [Route in StandardRouteName]: readonly [\n    NonNullable<ShopifyRouteTemplates[Route]>,\n    ...NonNullable<ShopifyRouteTemplates[Route]>[],\n  ];\n};\n\nconst STANDARD_ROUTE_PARAM_NAMES = [\n  \"articleHandle\",\n  \"blogHandle\",\n  \"collectionHandle\",\n  \"pageHandle\",\n  \"policyHandle\",\n  \"productHandle\",\n] as const satisfies readonly StandardRouteParamName[];\n\nexport const DEFAULT_STANDARD_ROUTES = {\n  product: [\"/products/:productHandle\"],\n  collection: [\"/collections/:collectionHandle\"],\n  collectionList: [\"/collections\", \"/products\"],\n  page: [\"/pages/:pageHandle\"],\n  policy: [\"/policies/:policyHandle\"],\n  blog: [\"/blogs/:blogHandle\"],\n  article: [\"/blogs/:blogHandle/:articleHandle\"],\n  productInCollection: [\"/collections/:collectionHandle/products/:productHandle\"],\n  cart: [\"/cart\"],\n  search: [\"/search\"],\n} as const satisfies DefaultStandardRoutes;\n\nexport function isStandardRouteParamName(name: string): name is StandardRouteParamName {\n  return STANDARD_ROUTE_PARAM_NAMES.some((paramName) => paramName === name);\n}\n\nexport function isStandardRouteName(name: string): name is StandardRouteName {\n  return Object.hasOwn(DEFAULT_STANDARD_ROUTES, name);\n}\n"],"mappings":";AASA,MAAM,6BAA6B;CACjC;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,0BAA0B;CACrC,SAAS,CAAC,2BAA2B;CACrC,YAAY,CAAC,iCAAiC;CAC9C,gBAAgB,CAAC,gBAAgB,YAAY;CAC7C,MAAM,CAAC,qBAAqB;CAC5B,QAAQ,CAAC,0BAA0B;CACnC,MAAM,CAAC,qBAAqB;CAC5B,SAAS,CAAC,oCAAoC;CAC9C,qBAAqB,CAAC,yDAAyD;CAC/E,MAAM,CAAC,QAAQ;CACf,QAAQ,CAAC,UAAU;CACpB;AAED,SAAgB,yBAAyB,MAA8C;AACrF,QAAO,2BAA2B,MAAM,cAAc,cAAc,KAAK;;AAG3E,SAAgB,oBAAoB,MAAyC;AAC3E,QAAO,OAAO,OAAO,yBAAyB,KAAK"}

package/dist/core/standard-routes/match.mjs

@@ -0,0 +1,108 @@
+import { DEFAULT_STANDARD_ROUTES, isStandardRouteName, isStandardRouteParamName } from "./defaults.mjs";
+import { parseSameOriginUrl, stripI18nPathPrefix, stripTrailingSlash } from "./path.mjs";
+import { buildStandardRouteTarget } from "./build.mjs";
+
+//#region src/core/standard-routes/match.ts
+/**
+* Matches a URL against both configured app route templates and standard storefront routes.
+*
+* This powers browser current-page detection, where consumers need to recognize the standard
+* Shopify resource represented by either a custom app URL like `/p/snowboard` or a standard URL
+* like `/products/snowboard`. The root and standard storefront routes retain their page-template
+* identities; configured templates identify otherwise non-standard app paths.
+*/
+function matchStandardRouteUrl({ baseUrl, pathPrefix, routeTemplates, url }) {
+	const parsedUrl = parseSameOriginUrl(url, baseUrl);
+	if (!parsedUrl) return null;
+	if (stripI18nPathPrefix(stripTrailingSlash(parsedUrl.pathname), pathPrefix) === "/") return addStandardRouteContext({
+		route: "index",
+		pageTemplateName: "index",
+		params: {}
+	}, pathPrefix, routeTemplates);
+	const match = matchStandardRouteTemplates(parsedUrl.pathname, pathPrefix, (route) => DEFAULT_STANDARD_ROUTES[route]) ?? matchStandardRouteTemplates(parsedUrl.pathname, pathPrefix, (route) => [routeTemplates[route]]);
+	return match ? addStandardRouteContext(match, pathPrefix, routeTemplates) : null;
+}
+function addStandardRouteContext(match, pathPrefix, routeTemplates) {
+	const standardTemplate = match.route === "index" ? "/" : DEFAULT_STANDARD_ROUTES[match.route][0];
+	const customTemplate = match.route === "index" ? standardTemplate : routeTemplates[match.route] ?? standardTemplate;
+	return {
+		...match,
+		standardPathname: buildStandardRouteTarget(standardTemplate, match.params, pathPrefix),
+		templates: {
+			standard: standardTemplate,
+			custom: customTemplate
+		}
+	};
+}
+/**
+* Iterates over known Shopify route names and tries the templates supplied by the caller.
+*
+* Different callers choose different template sets: redirects only match default Shopify templates
+* for resources with custom app templates, while browser matching tries Shopify defaults before
+* configured app templates.
+*/
+function matchStandardRouteTemplates(pathname, pathPrefix, getTemplatesForRoute) {
+	const normalizedPathname = stripI18nPathPrefix(stripTrailingSlash(pathname), pathPrefix);
+	for (const route in DEFAULT_STANDARD_ROUTES) {
+		if (!isStandardRouteName(route)) continue;
+		for (const template of getTemplatesForRoute(route)) {
+			if (!template) continue;
+			const match = matchRouteTemplate(normalizedPathname, template);
+			if (match) return {
+				route,
+				params: match,
+				pageTemplateName: normalizeStandardRouteTemplateName(route)
+			};
+		}
+	}
+	return null;
+}
+function normalizeStandardRouteTemplateName(route) {
+	if (route === "productInCollection") return "product";
+	if (route === "collectionList") return "list-collections";
+	return route;
+}
+/**
+* Matches a normalized pathname against one route template and returns decoded handle params.
+*/
+function matchRouteTemplate(pathname, template) {
+	const match = templateToPattern(template).exec(pathname);
+	if (!match) return null;
+	const params = {};
+	for (const [name, value] of Object.entries(match.groups ?? {})) {
+		if (!isStandardRouteParamName(name)) continue;
+		params[name] = decodePathSegment(value);
+	}
+	return params;
+}
+/**
+* Converts a route template into a regular expression with named capture groups.
+*
+* Static path text is escaped first so regex metacharacters in templates are treated literally.
+* Then known placeholders such as `:productHandle` become segment-safe captures like
+* `(?<productHandle>[^/]+)`.
+*/
+function templateToPattern(template) {
+	const source = escapeRegExp(stripTrailingSlash(template)).replace(/:([A-Za-z][A-Za-z0-9_]*)/g, (placeholder, name) => isStandardRouteParamName(name) ? `(?<${name}>[^/]+)` : placeholder);
+	return new RegExp(`^${source}$`);
+}
+/**
+* Escapes regex metacharacters so template text can be embedded in a `RegExp` literally.
+*
+* For example, `/products/:productHandle.json` must match a literal `.json` suffix; without
+* escaping, `.` would mean "any character" in the generated regex.
+*/
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function decodePathSegment(segment) {
+	try {
+		return decodeURIComponent(segment);
+	} catch {
+		return segment;
+	}
+}
+
+//#endregion
+export { matchStandardRouteTemplates, matchStandardRouteUrl };
+//# sourceMappingURL=match.mjs.map

package/dist/core/standard-routes/match.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.mjs","names":[],"sources":["../../../src/core/standard-routes/match.ts"],"sourcesContent":["import { buildStandardRouteTarget } from \"./build\";\nimport { DEFAULT_STANDARD_ROUTES, isStandardRouteName, isStandardRouteParamName } from \"./defaults\";\nimport { parseSameOriginUrl, stripI18nPathPrefix, stripTrailingSlash } from \"./path\";\nimport type {\n  ShopifyRouteTemplates,\n  ShopifyPageTemplateName,\n  ShopifyStandardRouteMatch,\n  ShopifyStandardRouteName,\n  StandardRouteName,\n  StandardRouteParams,\n} from \"./types\";\n\n/**\n * Matches a URL against both configured app route templates and standard storefront routes.\n *\n * This powers browser current-page detection, where consumers need to recognize the standard\n * Shopify resource represented by either a custom app URL like `/p/snowboard` or a standard URL\n * like `/products/snowboard`. The root and standard storefront routes retain their page-template\n * identities; configured templates identify otherwise non-standard app paths.\n */\nexport function matchStandardRouteUrl({\n  baseUrl,\n  pathPrefix,\n  routeTemplates,\n  url,\n}: {\n  baseUrl?: string;\n  pathPrefix?: string;\n  routeTemplates: ShopifyRouteTemplates;\n  url: string;\n}): ShopifyStandardRouteMatch | null {\n  const parsedUrl = parseSameOriginUrl(url, baseUrl);\n  if (!parsedUrl) return null;\n\n  const pathname = stripI18nPathPrefix(stripTrailingSlash(parsedUrl.pathname), pathPrefix);\n  if (pathname === \"/\") {\n    return addStandardRouteContext(\n      { route: \"index\", pageTemplateName: \"index\", params: {} },\n      pathPrefix,\n      routeTemplates,\n    );\n  }\n\n  const match =\n    matchStandardRouteTemplates(\n      parsedUrl.pathname,\n      pathPrefix,\n      (route) => DEFAULT_STANDARD_ROUTES[route],\n    ) ??\n    matchStandardRouteTemplates(parsedUrl.pathname, pathPrefix, (route) => [routeTemplates[route]]);\n\n  return match ? addStandardRouteContext(match, pathPrefix, routeTemplates) : null;\n}\n\nfunction addStandardRouteContext(\n  match: Pick<ShopifyStandardRouteMatch, \"pageTemplateName\" | \"params\" | \"route\">,\n  pathPrefix: string | undefined,\n  routeTemplates: ShopifyRouteTemplates,\n): ShopifyStandardRouteMatch {\n  const standardTemplate = match.route === \"index\" ? \"/\" : DEFAULT_STANDARD_ROUTES[match.route][0];\n  const customTemplate =\n    match.route === \"index\" ? standardTemplate : (routeTemplates[match.route] ?? standardTemplate);\n\n  return {\n    ...match,\n    standardPathname: buildStandardRouteTarget(standardTemplate, match.params, pathPrefix),\n    templates: {\n      standard: standardTemplate,\n      custom: customTemplate,\n    },\n  };\n}\n\n/**\n * Iterates over known Shopify route names and tries the templates supplied by the caller.\n *\n * Different callers choose different template sets: redirects only match default Shopify templates\n * for resources with custom app templates, while browser matching tries Shopify defaults before\n * configured app templates.\n */\nexport function matchStandardRouteTemplates(\n  pathname: string,\n  pathPrefix: string | undefined,\n  getTemplatesForRoute: (route: StandardRouteName) => ReadonlyArray<string | undefined>,\n): Pick<\n  ShopifyStandardRouteMatch<StandardRouteName>,\n  \"pageTemplateName\" | \"params\" | \"route\"\n> | null {\n  const normalizedPathname = stripI18nPathPrefix(stripTrailingSlash(pathname), pathPrefix);\n\n  for (const route in DEFAULT_STANDARD_ROUTES) {\n    if (!isStandardRouteName(route)) continue;\n\n    for (const template of getTemplatesForRoute(route)) {\n      if (!template) continue;\n\n      const match = matchRouteTemplate(normalizedPathname, template);\n      if (match) {\n        return {\n          route,\n          params: match,\n          pageTemplateName: normalizeStandardRouteTemplateName(route),\n        };\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Converts a standard route identity to the corresponding page template name.\n * Collection-scoped product URLs still render the `product` template, while\n * the collection-listing route uses the hyphenated `list-collections` name.\n */\nfunction normalizeStandardRouteTemplateName<TRoute extends ShopifyStandardRouteName>(\n  route: TRoute,\n): ShopifyPageTemplateName<TRoute>;\nfunction normalizeStandardRouteTemplateName(\n  route: ShopifyStandardRouteName,\n): ShopifyPageTemplateName {\n  if (route === \"productInCollection\") return \"product\";\n  if (route === \"collectionList\") return \"list-collections\";\n  return route;\n}\n\n/**\n * Matches a normalized pathname against one route template and returns decoded handle params.\n */\nfunction matchRouteTemplate(pathname: string, template: string): StandardRouteParams | null {\n  const match = templateToPattern(template).exec(pathname);\n  if (!match) return null;\n\n  const params: StandardRouteParams = {};\n  for (const [name, value] of Object.entries(match.groups ?? {})) {\n    if (!isStandardRouteParamName(name)) continue;\n\n    params[name] = decodePathSegment(value);\n  }\n\n  return params;\n}\n\n/**\n * Converts a route template into a regular expression with named capture groups.\n *\n * Static path text is escaped first so regex metacharacters in templates are treated literally.\n * Then known placeholders such as `:productHandle` become segment-safe captures like\n * `(?<productHandle>[^/]+)`.\n */\nfunction templateToPattern(template: string): RegExp {\n  const source = escapeRegExp(stripTrailingSlash(template)).replace(\n    /:([A-Za-z][A-Za-z0-9_]*)/g,\n    (placeholder, name: string) =>\n      isStandardRouteParamName(name) ? `(?<${name}>[^/]+)` : placeholder,\n  );\n\n  return new RegExp(`^${source}$`);\n}\n\n/**\n * Escapes regex metacharacters so template text can be embedded in a `RegExp` literally.\n *\n * For example, `/products/:productHandle.json` must match a literal `.json` suffix; without\n * escaping, `.` would mean \"any character\" in the generated regex.\n */\nfunction escapeRegExp(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction decodePathSegment(segment: string): string {\n  try {\n    return decodeURIComponent(segment);\n  } catch {\n    return segment;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAoBA,SAAgB,sBAAsB,EACpC,SACA,YACA,gBACA,OAMmC;CACnC,MAAM,YAAY,mBAAmB,KAAK,QAAQ;AAClD,KAAI,CAAC,UAAW,QAAO;AAGvB,KADiB,oBAAoB,mBAAmB,UAAU,SAAS,EAAE,WACjE,KAAK,IACf,QAAO,wBACL;EAAE,OAAO;EAAS,kBAAkB;EAAS,QAAQ,EAAE;EAAE,EACzD,YACA,eACD;CAGH,MAAM,QACJ,4BACE,UAAU,UACV,aACC,UAAU,wBAAwB,OACpC,IACD,4BAA4B,UAAU,UAAU,aAAa,UAAU,CAAC,eAAe,OAAO,CAAC;AAEjG,QAAO,QAAQ,wBAAwB,OAAO,YAAY,eAAe,GAAG;;AAG9E,SAAS,wBACP,OACA,YACA,gBAC2B;CAC3B,MAAM,mBAAmB,MAAM,UAAU,UAAU,MAAM,wBAAwB,MAAM,OAAO;CAC9F,MAAM,iBACJ,MAAM,UAAU,UAAU,mBAAoB,eAAe,MAAM,UAAU;AAE/E,QAAO;EACL,GAAG;EACH,kBAAkB,yBAAyB,kBAAkB,MAAM,QAAQ,WAAW;EACtF,WAAW;GACT,UAAU;GACV,QAAQ;GACT;EACF;;;;;;;;;AAUH,SAAgB,4BACd,UACA,YACA,sBAIO;CACP,MAAM,qBAAqB,oBAAoB,mBAAmB,SAAS,EAAE,WAAW;AAExF,MAAK,MAAM,SAAS,yBAAyB;AAC3C,MAAI,CAAC,oBAAoB,MAAM,CAAE;AAEjC,OAAK,MAAM,YAAY,qBAAqB,MAAM,EAAE;AAClD,OAAI,CAAC,SAAU;GAEf,MAAM,QAAQ,mBAAmB,oBAAoB,SAAS;AAC9D,OAAI,MACF,QAAO;IACL;IACA,QAAQ;IACR,kBAAkB,mCAAmC,MAAM;IAC5D;;;AAKP,QAAO;;AAWT,SAAS,mCACP,OACyB;AACzB,KAAI,UAAU,sBAAuB,QAAO;AAC5C,KAAI,UAAU,iBAAkB,QAAO;AACvC,QAAO;;;;;AAMT,SAAS,mBAAmB,UAAkB,UAA8C;CAC1F,MAAM,QAAQ,kBAAkB,SAAS,CAAC,KAAK,SAAS;AACxD,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,SAA8B,EAAE;AACtC,MAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,UAAU,EAAE,CAAC,EAAE;AAC9D,MAAI,CAAC,yBAAyB,KAAK,CAAE;AAErC,SAAO,QAAQ,kBAAkB,MAAM;;AAGzC,QAAO;;;;;;;;;AAUT,SAAS,kBAAkB,UAA0B;CACnD,MAAM,SAAS,aAAa,mBAAmB,SAAS,CAAC,CAAC,QACxD,8BACC,aAAa,SACZ,yBAAyB,KAAK,GAAG,MAAM,KAAK,WAAW,YAC1D;AAED,QAAO,IAAI,OAAO,IAAI,OAAO,GAAG;;;;;;;;AASlC,SAAS,aAAa,OAAuB;AAC3C,QAAO,MAAM,QAAQ,uBAAuB,OAAO;;AAGrD,SAAS,kBAAkB,SAAyB;AAClD,KAAI;AACF,SAAO,mBAAmB,QAAQ;SAC5B;AACN,SAAO"}