@shopify/hydrogen 2026.4.4 → 2026.10.0-preview.1

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"}

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

@@ -0,0 +1,58 @@
+//#region src/core/standard-routes/path.ts
+function prependPathPrefix(pathname, pathPrefix) {
+	const normalizedPathPrefix = normalizePathPrefix(pathPrefix);
+	if (!normalizedPathPrefix) return pathname;
+	return `${normalizedPathPrefix}/${pathname.replace(/^\/+/, "")}`;
+}
+function normalizePathPrefix(pathPrefix) {
+	if (!pathPrefix) return "";
+	const trimmedPathPrefix = pathPrefix.trim().replace(/^\/+|\/+$/g, "");
+	return trimmedPathPrefix ? `/${trimmedPathPrefix}` : "";
+}
+function parseUrl(url, baseUrl) {
+	try {
+		return new URL(url, baseUrl ?? "https://shopify.local");
+	} catch {
+		return null;
+	}
+}
+/**
+* Parses a URL and rejects absolute URLs that do not share `baseUrl`'s origin.
+*
+* Relative URLs are resolved against `baseUrl` when provided, or against a throwaway local origin
+* when no base is available.
+*/
+function parseSameOriginUrl(url, baseUrl) {
+	const parsedUrl = parseUrl(url, baseUrl);
+	if (!parsedUrl) return null;
+	const parsedBaseUrl = baseUrl ? parseUrl(baseUrl, void 0) : null;
+	if (parsedBaseUrl && parsedUrl.origin !== parsedBaseUrl.origin) return null;
+	return parsedUrl;
+}
+function isAbsoluteUrl(url) {
+	return /^[A-Za-z][A-Za-z0-9+.-]*:/.test(url);
+}
+function stripTrailingSlash(pathname) {
+	if (pathname === "/") return pathname;
+	return pathname.replace(/\/+$/, "");
+}
+/**
+* Removes the locale prefix before matching route templates.
+*
+* `ShopifyScripts` stores `routes.root` with a trailing slash, while server i18n uses
+* `pathPrefix`; both are normalized here so `/fr-ca/products/snowboard` can match the same
+* template as `/products/snowboard`.
+*/
+function stripI18nPathPrefix(pathname, pathPrefix) {
+	const normalizedPathPrefix = normalizePathPrefix(pathPrefix);
+	if (!normalizedPathPrefix) return pathname;
+	const lowerPathname = pathname.toLowerCase();
+	const lowerPathPrefix = normalizedPathPrefix.toLowerCase();
+	if (lowerPathname === lowerPathPrefix) return "/";
+	if (!lowerPathname.startsWith(`${lowerPathPrefix}/`)) return pathname;
+	return pathname.slice(normalizedPathPrefix.length) || "/";
+}
+
+//#endregion
+export { isAbsoluteUrl, normalizePathPrefix, parseSameOriginUrl, prependPathPrefix, stripI18nPathPrefix, stripTrailingSlash };
+//# sourceMappingURL=path.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.mjs","names":[],"sources":["../../../src/core/standard-routes/path.ts"],"sourcesContent":["export function prependPathPrefix(pathname: string, pathPrefix: string | undefined): string {\n  const normalizedPathPrefix = normalizePathPrefix(pathPrefix);\n  if (!normalizedPathPrefix) return pathname;\n\n  return `${normalizedPathPrefix}/${pathname.replace(/^\\/+/, \"\")}`;\n}\n\nexport function normalizePathPrefix(pathPrefix: string | undefined): string {\n  if (!pathPrefix) return \"\";\n\n  const trimmedPathPrefix = pathPrefix.trim().replace(/^\\/+|\\/+$/g, \"\");\n  return trimmedPathPrefix ? `/${trimmedPathPrefix}` : \"\";\n}\n\nfunction parseUrl(url: string, baseUrl: string | undefined): URL | null {\n  try {\n    return new URL(url, baseUrl ?? \"https://shopify.local\");\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Parses a URL and rejects absolute URLs that do not share `baseUrl`'s origin.\n *\n * Relative URLs are resolved against `baseUrl` when provided, or against a throwaway local origin\n * when no base is available.\n */\nexport function parseSameOriginUrl(url: string, baseUrl: string | undefined): URL | null {\n  const parsedUrl = parseUrl(url, baseUrl);\n  if (!parsedUrl) return null;\n\n  const parsedBaseUrl = baseUrl ? parseUrl(baseUrl, undefined) : null;\n  if (parsedBaseUrl && parsedUrl.origin !== parsedBaseUrl.origin) return null;\n\n  return parsedUrl;\n}\n\nexport function isAbsoluteUrl(url: string): boolean {\n  return /^[A-Za-z][A-Za-z0-9+.-]*:/.test(url);\n}\n\nexport function stripTrailingSlash(pathname: string): string {\n  if (pathname === \"/\") return pathname;\n  return pathname.replace(/\\/+$/, \"\");\n}\n\n/**\n * Removes the locale prefix before matching route templates.\n *\n * `ShopifyScripts` stores `routes.root` with a trailing slash, while server i18n uses\n * `pathPrefix`; both are normalized here so `/fr-ca/products/snowboard` can match the same\n * template as `/products/snowboard`.\n */\nexport function stripI18nPathPrefix(pathname: string, pathPrefix: string | undefined): string {\n  const normalizedPathPrefix = normalizePathPrefix(pathPrefix);\n  if (!normalizedPathPrefix) return pathname;\n\n  const lowerPathname = pathname.toLowerCase();\n  const lowerPathPrefix = normalizedPathPrefix.toLowerCase();\n\n  if (lowerPathname === lowerPathPrefix) return \"/\";\n  if (!lowerPathname.startsWith(`${lowerPathPrefix}/`)) return pathname;\n\n  return pathname.slice(normalizedPathPrefix.length) || \"/\";\n}\n"],"mappings":";AAAA,SAAgB,kBAAkB,UAAkB,YAAwC;CAC1F,MAAM,uBAAuB,oBAAoB,WAAW;AAC5D,KAAI,CAAC,qBAAsB,QAAO;AAElC,QAAO,GAAG,qBAAqB,GAAG,SAAS,QAAQ,QAAQ,GAAG;;AAGhE,SAAgB,oBAAoB,YAAwC;AAC1E,KAAI,CAAC,WAAY,QAAO;CAExB,MAAM,oBAAoB,WAAW,MAAM,CAAC,QAAQ,cAAc,GAAG;AACrE,QAAO,oBAAoB,IAAI,sBAAsB;;AAGvD,SAAS,SAAS,KAAa,SAAyC;AACtE,KAAI;AACF,SAAO,IAAI,IAAI,KAAK,WAAW,wBAAwB;SACjD;AACN,SAAO;;;;;;;;;AAUX,SAAgB,mBAAmB,KAAa,SAAyC;CACvF,MAAM,YAAY,SAAS,KAAK,QAAQ;AACxC,KAAI,CAAC,UAAW,QAAO;CAEvB,MAAM,gBAAgB,UAAU,SAAS,SAAS,OAAU,GAAG;AAC/D,KAAI,iBAAiB,UAAU,WAAW,cAAc,OAAQ,QAAO;AAEvE,QAAO;;AAGT,SAAgB,cAAc,KAAsB;AAClD,QAAO,4BAA4B,KAAK,IAAI;;AAG9C,SAAgB,mBAAmB,UAA0B;AAC3D,KAAI,aAAa,IAAK,QAAO;AAC7B,QAAO,SAAS,QAAQ,QAAQ,GAAG;;;;;;;;;AAUrC,SAAgB,oBAAoB,UAAkB,YAAwC;CAC5F,MAAM,uBAAuB,oBAAoB,WAAW;AAC5D,KAAI,CAAC,qBAAsB,QAAO;CAElC,MAAM,gBAAgB,SAAS,aAAa;CAC5C,MAAM,kBAAkB,qBAAqB,aAAa;AAE1D,KAAI,kBAAkB,gBAAiB,QAAO;AAC9C,KAAI,CAAC,cAAc,WAAW,GAAG,gBAAgB,GAAG,CAAE,QAAO;AAE7D,QAAO,SAAS,MAAM,qBAAqB,OAAO,IAAI"}

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

@@ -0,0 +1,51 @@
+import { DEFAULT_STANDARD_ROUTES } from "./defaults.mjs";
+import { isAbsoluteUrl, parseSameOriginUrl, stripTrailingSlash } from "./path.mjs";
+import { buildStandardRouteTarget } from "./build.mjs";
+import { matchStandardRouteTemplates } from "./match.mjs";
+
+//#region src/core/standard-routes/redirects.ts
+/**
+* Returns the custom route target for a Shopify standard route pathname.
+*
+* This is used by server redirects: it only matches Shopify's default route shape when the app
+* configured a custom template for that same resource, so standard `/products/...` requests do not
+* redirect unless the app opted into a non-standard product route.
+*/
+function getStandardRouteTarget({ pathname, pathPrefix, routeTemplates }) {
+	const match = matchStandardRouteTemplates(pathname, pathPrefix, (route) => routeTemplates[route] ? DEFAULT_STANDARD_ROUTES[route] : []);
+	if (!match) return null;
+	const target = routeTemplates[match.route];
+	if (!target) return null;
+	return buildStandardRouteTarget(target, match.params, pathPrefix);
+}
+/**
+* Resolves a Shopify standard resource URL to the app's configured route template.
+*
+* Query strings and hashes are preserved. Absolute URLs are only resolved when they share the same
+* origin as `baseUrl`; external URLs are returned unchanged.
+*/
+function resolveStandardRouteUrl({ baseUrl, pathPrefix, routeTemplates, url }) {
+	const parsedUrl = parseSameOriginUrl(url, baseUrl);
+	if (!parsedUrl) return url;
+	const target = getStandardRouteTarget({
+		pathname: parsedUrl.pathname,
+		pathPrefix,
+		routeTemplates
+	});
+	if (!target) return url;
+	const resolvedUrl = `${target}${parsedUrl.search}${parsedUrl.hash}`;
+	return isAbsoluteUrl(url) ? `${parsedUrl.origin}${resolvedUrl}` : resolvedUrl;
+}
+function isStandardRouteSelfRedirect(requestUrl, location) {
+	try {
+		const sourceUrl = new URL(requestUrl);
+		const targetUrl = new URL(location, sourceUrl.origin);
+		return sourceUrl.origin === targetUrl.origin && stripTrailingSlash(sourceUrl.pathname) === stripTrailingSlash(targetUrl.pathname) && sourceUrl.search === targetUrl.search;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { getStandardRouteTarget, isStandardRouteSelfRedirect, resolveStandardRouteUrl };
+//# sourceMappingURL=redirects.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"redirects.mjs","names":[],"sources":["../../../src/core/standard-routes/redirects.ts"],"sourcesContent":["import { buildStandardRouteTarget } from \"./build\";\nimport { DEFAULT_STANDARD_ROUTES } from \"./defaults\";\nimport { matchStandardRouteTemplates } from \"./match\";\nimport { isAbsoluteUrl, parseSameOriginUrl, stripTrailingSlash } from \"./path\";\nimport type { ShopifyRouteTemplates } from \"./types\";\n\n/**\n * Returns the custom route target for a Shopify standard route pathname.\n *\n * This is used by server redirects: it only matches Shopify's default route shape when the app\n * configured a custom template for that same resource, so standard `/products/...` requests do not\n * redirect unless the app opted into a non-standard product route.\n */\nexport function getStandardRouteTarget({\n  pathname,\n  pathPrefix,\n  routeTemplates,\n}: {\n  pathname: string;\n  pathPrefix?: string;\n  routeTemplates: ShopifyRouteTemplates;\n}): string | null {\n  const match = matchStandardRouteTemplates(pathname, pathPrefix, (route) =>\n    routeTemplates[route] ? DEFAULT_STANDARD_ROUTES[route] : [],\n  );\n\n  if (!match) return null;\n\n  const target = routeTemplates[match.route];\n  if (!target) return null;\n\n  return buildStandardRouteTarget(target, match.params, pathPrefix);\n}\n\n/**\n * Resolves a Shopify standard resource URL to the app's configured route template.\n *\n * Query strings and hashes are preserved. Absolute URLs are only resolved when they share the same\n * origin as `baseUrl`; external URLs are returned unchanged.\n */\nexport function resolveStandardRouteUrl({\n  baseUrl,\n  pathPrefix,\n  routeTemplates,\n  url,\n}: {\n  baseUrl?: string;\n  pathPrefix?: string;\n  routeTemplates: ShopifyRouteTemplates;\n  url: string;\n}): string {\n  const parsedUrl = parseSameOriginUrl(url, baseUrl);\n  if (!parsedUrl) return url;\n\n  const target = getStandardRouteTarget({\n    pathname: parsedUrl.pathname,\n    pathPrefix,\n    routeTemplates,\n  });\n\n  if (!target) return url;\n\n  const resolvedUrl = `${target}${parsedUrl.search}${parsedUrl.hash}`;\n\n  return isAbsoluteUrl(url) ? `${parsedUrl.origin}${resolvedUrl}` : resolvedUrl;\n}\n\nexport function isStandardRouteSelfRedirect(requestUrl: string, location: string): boolean {\n  try {\n    const sourceUrl = new URL(requestUrl);\n    const targetUrl = new URL(location, sourceUrl.origin);\n\n    return (\n      sourceUrl.origin === targetUrl.origin &&\n      stripTrailingSlash(sourceUrl.pathname) === stripTrailingSlash(targetUrl.pathname) &&\n      sourceUrl.search === targetUrl.search\n    );\n  } catch {\n    return false;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,uBAAuB,EACrC,UACA,YACA,kBAKgB;CAChB,MAAM,QAAQ,4BAA4B,UAAU,aAAa,UAC/D,eAAe,SAAS,wBAAwB,SAAS,EAAE,CAC5D;AAED,KAAI,CAAC,MAAO,QAAO;CAEnB,MAAM,SAAS,eAAe,MAAM;AACpC,KAAI,CAAC,OAAQ,QAAO;AAEpB,QAAO,yBAAyB,QAAQ,MAAM,QAAQ,WAAW;;;;;;;;AASnE,SAAgB,wBAAwB,EACtC,SACA,YACA,gBACA,OAMS;CACT,MAAM,YAAY,mBAAmB,KAAK,QAAQ;AAClD,KAAI,CAAC,UAAW,QAAO;CAEvB,MAAM,SAAS,uBAAuB;EACpC,UAAU,UAAU;EACpB;EACA;EACD,CAAC;AAEF,KAAI,CAAC,OAAQ,QAAO;CAEpB,MAAM,cAAc,GAAG,SAAS,UAAU,SAAS,UAAU;AAE7D,QAAO,cAAc,IAAI,GAAG,GAAG,UAAU,SAAS,gBAAgB;;AAGpE,SAAgB,4BAA4B,YAAoB,UAA2B;AACzF,KAAI;EACF,MAAM,YAAY,IAAI,IAAI,WAAW;EACrC,MAAM,YAAY,IAAI,IAAI,UAAU,UAAU,OAAO;AAErD,SACE,UAAU,WAAW,UAAU,UAC/B,mBAAmB,UAAU,SAAS,KAAK,mBAAmB,UAAU,SAAS,IACjF,UAAU,WAAW,UAAU;SAE3B;AACN,SAAO"}