@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/development/core/shopify-scripts/constants.mjs

@@ -0,0 +1,19 @@
+//#region src/core/shopify-scripts/constants.ts
+const SHOPIFY_CDN_ORIGIN = "https://cdn.shopify.com";
+const SHOPIFY_SHOP_APP_ORIGIN = "https://shop.app";
+const SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/standard-actions.js`;
+const SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/standard-events.js`;
+const SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/standard-events-inspector.js`;
+const SHOPIFY_STOREFRONT_WEBMCP_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/webmcp.js`;
+const SHOPIFY_INBOX_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/web-components/agent.js`;
+const SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/analytics/shopify.js`;
+const SHOPIFY_PERF_KIT_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/shopifycloud/perf-kit/shopify-perf-kit-spa.min.js?v2`;
+const SHOPIFY_CONSENT_API_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/shopifycloud/consent-tracking-api/v0.2/consent-tracking-api.js`;
+const SHOPIFY_PRIVACY_BANNER_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/shopifycloud/privacy-banner/storefront-banner.js`;
+const SHOPIFY_CONSENT_SCRIPT_ID = "shopify-consent";
+const SHOPIFY_PERF_KIT_SCRIPT_ID = "shopify-perfkit";
+const VISITOR_CONSENT_COLLECTED_EVENT = "visitorConsentCollected";
+
+//#endregion
+export { SHOPIFY_CDN_ORIGIN, SHOPIFY_CONSENT_API_SCRIPT, SHOPIFY_CONSENT_SCRIPT_ID, SHOPIFY_INBOX_SCRIPT, SHOPIFY_PERF_KIT_SCRIPT, SHOPIFY_PERF_KIT_SCRIPT_ID, SHOPIFY_PRIVACY_BANNER_SCRIPT, SHOPIFY_SHOP_APP_ORIGIN, SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT, SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT, SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT, SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT, SHOPIFY_STOREFRONT_WEBMCP_SCRIPT, VISITOR_CONSENT_COLLECTED_EVENT };
+//# sourceMappingURL=constants.mjs.map

package/dist/development/core/shopify-scripts/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/constants.ts"],"sourcesContent":["export const SHOPIFY_CDN_ORIGIN = \"https://cdn.shopify.com\";\nexport const SHOPIFY_SHOP_APP_ORIGIN = \"https://shop.app\";\nexport const SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/standard-actions.js`;\nexport const SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/standard-events.js`;\nexport const SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/standard-events-inspector.js`;\nexport const SHOPIFY_STOREFRONT_WEBMCP_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/webmcp.js`;\nexport const SHOPIFY_INBOX_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/web-components/agent.js`;\n\nexport const SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/storefront/analytics/shopify.js`;\n\nexport const SHOPIFY_PERF_KIT_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/shopifycloud/perf-kit/shopify-perf-kit-spa.min.js?v2`;\nexport const SHOPIFY_CONSENT_API_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/shopifycloud/consent-tracking-api/v0.2/consent-tracking-api.js`;\nexport const SHOPIFY_PRIVACY_BANNER_SCRIPT = `${SHOPIFY_CDN_ORIGIN}/shopifycloud/privacy-banner/storefront-banner.js`;\n\nexport const SHOPIFY_CONSENT_SCRIPT_ID = \"shopify-consent\";\nexport const SHOPIFY_PERF_KIT_SCRIPT_ID = \"shopify-perfkit\";\n\nexport const VISITOR_CONSENT_COLLECTED_EVENT = \"visitorConsentCollected\";\n"],"mappings":";AAAA,MAAa,qBAAqB;AAClC,MAAa,0BAA0B;AACvC,MAAa,6CAA6C,GAAG,mBAAmB;AAChF,MAAa,4CAA4C,GAAG,mBAAmB;AAC/E,MAAa,sDAAsD,GAAG,mBAAmB;AACzF,MAAa,mCAAmC,GAAG,mBAAmB;AACtE,MAAa,uBAAuB,GAAG,mBAAmB;AAE1D,MAAa,sCAAsC,GAAG,mBAAmB;AAEzE,MAAa,0BAA0B,GAAG,mBAAmB;AAC7D,MAAa,6BAA6B,GAAG,mBAAmB;AAChE,MAAa,gCAAgC,GAAG,mBAAmB;AAEnE,MAAa,4BAA4B;AACzC,MAAa,6BAA6B;AAE1C,MAAa,kCAAkC"}

package/dist/development/core/shopify-scripts/deprecated-cookies.mjs

@@ -0,0 +1,97 @@
+import { VISITOR_CONSENT_COLLECTED_EVENT } from "./constants.mjs";
+import { findWritableCookieDomain } from "./utils/cookie-domain.mjs";
+import { getTrackingValues } from "./utils/tracking-values.mjs";
+import { buildUUID } from "./utils/uuid.mjs";
+
+//#region src/core/shopify-scripts/deprecated-cookies.ts
+/**
+* @deprecated This module manages the legacy `_shopify_y` and `_shopify_s`
+* JavaScript-visible cookies. Modern Shopify storefronts use http-only cookies
+* set by the Storefront API via the SFAPI proxy. This module exists only for
+* backward compatibility with downstream systems that may still read these
+* JS cookies directly.
+*
+* To remove: delete this file and remove the ShopifyScripts startup call.
+*/
+const SHOPIFY_Y = "_shopify_y";
+const SHOPIFY_S = "_shopify_s";
+const LONG_TERM_EXPIRY_IN_SECONDS = 3600 * 24 * 360;
+const SHORT_TERM_EXPIRY_IN_SECONDS = 1800;
+/**
+* Computes the cookie domain as the broadest wildcard domain the browser will
+* accept for the consent domain. Returns empty string for localhost or when
+* probing fails (cookies use current domain).
+*
+* @deprecated Part of legacy cookie management.
+*/
+function computeCookieDomain(consentDomain) {
+	if (typeof window === "undefined") return "";
+	return findWritableCookieDomain(consentDomain || window.location.host);
+}
+function setCookie(name, value, maxAgeInSeconds, domain) {
+	const parts = [`${name}=${encodeURIComponent(value)}`];
+	parts.push(`max-age=${maxAgeInSeconds}`);
+	parts.push("path=/");
+	parts.push("SameSite=Lax");
+	if (domain) parts.push(`domain=${domain}`);
+	document.cookie = parts.join("; ");
+}
+/**
+* @deprecated Sets or removes the legacy `_shopify_y` and `_shopify_s` cookies
+* based on the current consent state and tracking values.
+*/
+function updateCookies(hasConsent, domain) {
+	if (hasConsent) {
+		const trackingValues = getTrackingValues();
+		if ((trackingValues.uniqueToken || trackingValues.visitToken || "").startsWith("00000000-")) return;
+		setCookie(SHOPIFY_Y, trackingValues.uniqueToken || buildUUID(), LONG_TERM_EXPIRY_IN_SECONDS, domain);
+		setCookie(SHOPIFY_S, trackingValues.visitToken || buildUUID(), SHORT_TERM_EXPIRY_IN_SECONDS, domain);
+	} else {
+		setCookie(SHOPIFY_Y, "", 0, domain);
+		setCookie(SHOPIFY_S, "", 0, domain);
+	}
+}
+function hasAnalyticsConsent() {
+	try {
+		return (window.Shopify?.customerPrivacy)?.analyticsProcessingAllowed?.() ?? false;
+	} catch {
+		return false;
+	}
+}
+function isConsentLoaded() {
+	return window.Shopify?.customerPrivacy?.consentStatus === "loaded";
+}
+function getConsentDomain() {
+	return window.Shopify?.customerPrivacy?.config?.consentDomain;
+}
+let didInitializeDeprecatedCookies = false;
+const noOpCleanup = () => {};
+/**
+* @deprecated Starts page-lifetime legacy cookie management from ShopifyScripts.
+*/
+function initializeDeprecatedCookies() {
+	if (typeof window === "undefined" || typeof document === "undefined") return noOpCleanup;
+	if (didInitializeDeprecatedCookies) return noOpCleanup;
+	didInitializeDeprecatedCookies = true;
+	const domain = computeCookieDomain(getConsentDomain());
+	const syncConsent = () => {
+		updateCookies(hasAnalyticsConsent(), domain);
+	};
+	document.addEventListener(VISITOR_CONSENT_COLLECTED_EVENT, syncConsent);
+	if (isConsentLoaded()) syncConsent();
+	const syncPageView = () => {
+		if (hasAnalyticsConsent()) updateCookies(true, domain);
+	};
+	const subscribeToAnalytics = () => {
+		const subscribe = window.Shopify?.analytics?.subscribe;
+		if (typeof subscribe !== "function") return false;
+		subscribe("page_viewed", syncPageView);
+		return true;
+	};
+	if (!subscribeToAnalytics() && document.readyState === "loading") document.addEventListener("DOMContentLoaded", subscribeToAnalytics, { once: true });
+	return noOpCleanup;
+}
+
+//#endregion
+export { initializeDeprecatedCookies };
+//# sourceMappingURL=deprecated-cookies.mjs.map

package/dist/development/core/shopify-scripts/deprecated-cookies.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-cookies.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/deprecated-cookies.ts"],"sourcesContent":["/**\n * @deprecated This module manages the legacy `_shopify_y` and `_shopify_s`\n * JavaScript-visible cookies. Modern Shopify storefronts use http-only cookies\n * set by the Storefront API via the SFAPI proxy. This module exists only for\n * backward compatibility with downstream systems that may still read these\n * JS cookies directly.\n *\n * To remove: delete this file and remove the ShopifyScripts startup call.\n */\n\nimport { VISITOR_CONSENT_COLLECTED_EVENT } from \"./constants\";\nimport { findWritableCookieDomain } from \"./utils/cookie-domain\";\nimport { getTrackingValues } from \"./utils/tracking-values\";\nimport { buildUUID } from \"./utils/uuid\";\n\nconst SHOPIFY_Y = \"_shopify_y\";\nconst SHOPIFY_S = \"_shopify_s\";\n\nconst LONG_TERM_EXPIRY_IN_SECONDS = 60 * 60 * 24 * 360;\nconst SHORT_TERM_EXPIRY_IN_SECONDS = 60 * 30;\n\n/**\n * Computes the cookie domain as the broadest wildcard domain the browser will\n * accept for the consent domain. Returns empty string for localhost or when\n * probing fails (cookies use current domain).\n *\n * @deprecated Part of legacy cookie management.\n */\nexport function computeCookieDomain(consentDomain?: string): string {\n  if (typeof window === \"undefined\") return \"\";\n\n  return findWritableCookieDomain(consentDomain || window.location.host);\n}\n\nfunction setCookie(name: string, value: string, maxAgeInSeconds: number, domain: string): void {\n  const parts = [`${name}=${encodeURIComponent(value)}`];\n  parts.push(`max-age=${maxAgeInSeconds}`);\n  parts.push(\"path=/\");\n  parts.push(\"SameSite=Lax\");\n  if (domain) parts.push(`domain=${domain}`);\n  document.cookie = parts.join(\"; \");\n}\n\n/**\n * @deprecated Sets or removes the legacy `_shopify_y` and `_shopify_s` cookies\n * based on the current consent state and tracking values.\n */\nfunction updateCookies(hasConsent: boolean, domain: string): void {\n  if (hasConsent) {\n    const trackingValues = getTrackingValues();\n    const tokenValue = trackingValues.uniqueToken || trackingValues.visitToken || \"\";\n    if (tokenValue.startsWith(\"00000000-\")) return;\n\n    setCookie(\n      SHOPIFY_Y,\n      trackingValues.uniqueToken || buildUUID(),\n      LONG_TERM_EXPIRY_IN_SECONDS,\n      domain,\n    );\n    setCookie(\n      SHOPIFY_S,\n      trackingValues.visitToken || buildUUID(),\n      SHORT_TERM_EXPIRY_IN_SECONDS,\n      domain,\n    );\n  } else {\n    setCookie(SHOPIFY_Y, \"\", 0, domain);\n    setCookie(SHOPIFY_S, \"\", 0, domain);\n  }\n}\n\nfunction hasAnalyticsConsent(): boolean {\n  try {\n    const privacy = window.Shopify?.customerPrivacy;\n    return privacy?.analyticsProcessingAllowed?.() ?? false;\n  } catch {\n    return false;\n  }\n}\n\nfunction isConsentLoaded(): boolean {\n  return window.Shopify?.customerPrivacy?.consentStatus === \"loaded\";\n}\n\nfunction getConsentDomain(): string | undefined {\n  return window.Shopify?.customerPrivacy?.config?.consentDomain;\n}\n\nlet didInitializeDeprecatedCookies = false;\nconst noOpCleanup = () => {};\n\n/**\n * @deprecated Starts page-lifetime legacy cookie management from ShopifyScripts.\n */\nexport function initializeDeprecatedCookies(): () => void {\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") return noOpCleanup;\n  if (didInitializeDeprecatedCookies) return noOpCleanup;\n\n  didInitializeDeprecatedCookies = true;\n  const domain = computeCookieDomain(getConsentDomain());\n\n  const syncConsent = () => {\n    updateCookies(hasAnalyticsConsent(), domain);\n  };\n\n  document.addEventListener(VISITOR_CONSENT_COLLECTED_EVENT, syncConsent);\n  if (isConsentLoaded()) syncConsent();\n\n  const syncPageView = () => {\n    if (hasAnalyticsConsent()) {\n      updateCookies(true, domain);\n    }\n  };\n\n  const subscribeToAnalytics = () => {\n    const subscribe = window.Shopify?.analytics?.subscribe;\n    if (typeof subscribe !== \"function\") return false;\n\n    subscribe(\"page_viewed\", syncPageView);\n    return true;\n  };\n\n  if (!subscribeToAnalytics() && document.readyState === \"loading\") {\n    // The bus is inline today, but if it moves to a module/defer script it will\n    // still be available before DOMContentLoaded.\n    document.addEventListener(\"DOMContentLoaded\", subscribeToAnalytics, { once: true });\n  }\n\n  return noOpCleanup;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,MAAM,YAAY;AAClB,MAAM,YAAY;AAElB,MAAM,8BAA8B,OAAU,KAAK;AACnD,MAAM,+BAA+B;;;;;;;;AASrC,SAAgB,oBAAoB,eAAgC;AAClE,KAAI,OAAO,WAAW,YAAa,QAAO;AAE1C,QAAO,yBAAyB,iBAAiB,OAAO,SAAS,KAAK;;AAGxE,SAAS,UAAU,MAAc,OAAe,iBAAyB,QAAsB;CAC7F,MAAM,QAAQ,CAAC,GAAG,KAAK,GAAG,mBAAmB,MAAM,GAAG;AACtD,OAAM,KAAK,WAAW,kBAAkB;AACxC,OAAM,KAAK,SAAS;AACpB,OAAM,KAAK,eAAe;AAC1B,KAAI,OAAQ,OAAM,KAAK,UAAU,SAAS;AAC1C,UAAS,SAAS,MAAM,KAAK,KAAK;;;;;;AAOpC,SAAS,cAAc,YAAqB,QAAsB;AAChE,KAAI,YAAY;EACd,MAAM,iBAAiB,mBAAmB;AAE1C,OADmB,eAAe,eAAe,eAAe,cAAc,IAC/D,WAAW,YAAY,CAAE;AAExC,YACE,WACA,eAAe,eAAe,WAAW,EACzC,6BACA,OACD;AACD,YACE,WACA,eAAe,cAAc,WAAW,EACxC,8BACA,OACD;QACI;AACL,YAAU,WAAW,IAAI,GAAG,OAAO;AACnC,YAAU,WAAW,IAAI,GAAG,OAAO;;;AAIvC,SAAS,sBAA+B;AACtC,KAAI;AAEF,UADgB,OAAO,SAAS,kBAChB,8BAA8B,IAAI;SAC5C;AACN,SAAO;;;AAIX,SAAS,kBAA2B;AAClC,QAAO,OAAO,SAAS,iBAAiB,kBAAkB;;AAG5D,SAAS,mBAAuC;AAC9C,QAAO,OAAO,SAAS,iBAAiB,QAAQ;;AAGlD,IAAI,iCAAiC;AACrC,MAAM,oBAAoB;;;;AAK1B,SAAgB,8BAA0C;AACxD,KAAI,OAAO,WAAW,eAAe,OAAO,aAAa,YAAa,QAAO;AAC7E,KAAI,+BAAgC,QAAO;AAE3C,kCAAiC;CACjC,MAAM,SAAS,oBAAoB,kBAAkB,CAAC;CAEtD,MAAM,oBAAoB;AACxB,gBAAc,qBAAqB,EAAE,OAAO;;AAG9C,UAAS,iBAAiB,iCAAiC,YAAY;AACvE,KAAI,iBAAiB,CAAE,cAAa;CAEpC,MAAM,qBAAqB;AACzB,MAAI,qBAAqB,CACvB,eAAc,MAAM,OAAO;;CAI/B,MAAM,6BAA6B;EACjC,MAAM,YAAY,OAAO,SAAS,WAAW;AAC7C,MAAI,OAAO,cAAc,WAAY,QAAO;AAE5C,YAAU,eAAe,aAAa;AACtC,SAAO;;AAGT,KAAI,CAAC,sBAAsB,IAAI,SAAS,eAAe,UAGrD,UAAS,iBAAiB,oBAAoB,sBAAsB,EAAE,MAAM,MAAM,CAAC;AAGrF,QAAO"}

package/dist/development/core/shopify-scripts/global.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/development/core/shopify-scripts/global.mjs

@@ -0,0 +1,86 @@
+import { matchStandardRouteUrl } from "../standard-routes/match.mjs";
+import { resolveStandardRouteUrl } from "../standard-routes/redirects.mjs";
+import { SHOPIFY_API_PROXY_PREFIX, isHydrogenServerHandoffPath } from "../url.mjs";
+import { asInlineScript } from "./utils/inline-script.mjs";
+
+//#region src/core/shopify-scripts/global.ts
+const initializeShopifyGlobal = (scriptData) => decodeURIComponent("(function()%7Bfunction%20e(e)%7Blet%20t%3Dwindow%2Cn%3DObject.assign(t.Shopify%3F%3F%3D%7B%7D%2Ce%2C%7Bcomponents%3A%7Bconfig%3A%7BstoreDomain%3Awindow.location.origin%2Ccountry%3Ae.country%2Clanguage%3Ae.locale%7D%7D%7D)%3Bn.customerPrivacy.config.consentDomain%3Dwindow.location.host%7De(__SHOPIFY_SCRIPT_DATA__)%7D)()%3B").replace("__SHOPIFY_SCRIPT_DATA__", () => (JSON.stringify(scriptData) ?? "undefined").replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029"));
+const DEFAULT_COUNTRY = "US";
+const DEFAULT_LOCALE = "en";
+const DEFAULT_ROUTES_ROOT = "/";
+/**
+* Returns the browser's `window.Shopify` object, creating it when needed.
+*
+* This is SSR-safe and returns `undefined` outside the browser.
+*/
+function getShopifyGlobal() {
+	if (typeof window === "undefined") return void 0;
+	const shopifyWindow = window;
+	return shopifyWindow.Shopify ??= {};
+}
+/**
+* Configures Shopify runtime routing hooks used by storefront scripts.
+*
+* This is SSR-safe and no-ops outside the browser.
+*/
+function configureShopifyRouting({ navigate, routes }) {
+	const shopify = getShopifyGlobal();
+	if (!shopify) return;
+	const getRouteOptions = (url) => ({
+		baseUrl: window.location.href,
+		pathPrefix: shopify.routes?.root,
+		routeTemplates: routes ?? {},
+		url
+	});
+	shopify.routes ??= {};
+	shopify.routes.match = (url) => matchStandardRouteUrl(getRouteOptions(url));
+	shopify.routes.resolve = (url) => resolveStandardRouteUrl(getRouteOptions(url));
+	const navigateTo = navigate ?? documentNavigate;
+	shopify.routes.navigate = (url) => {
+		if (shouldHandoff(url)) return documentNavigate(url);
+		return navigateTo(shopify.routes?.resolve?.(url) ?? url);
+	};
+	shopify.navigate = shopify.routes.navigate;
+}
+function documentNavigate(url) {
+	window.location.assign(url);
+}
+function shouldHandoff(url) {
+	try {
+		const parsedUrl = new URL(url, window.location.href);
+		return parsedUrl.origin === window.location.origin && isHydrogenServerHandoffPath(parsedUrl.pathname);
+	} catch {
+		return false;
+	}
+}
+function getShopifyRoutesRoot(pathPrefix) {
+	const normalizedPathPrefix = pathPrefix?.trim().replace(/^\/+/, "").replace(/\/+$/, "") ?? "";
+	return normalizedPathPrefix ? `/${normalizedPathPrefix}/` : DEFAULT_ROUTES_ROOT;
+}
+function normalizeMyshopifyDomain(domain) {
+	return domain.trim().replace(/^https?:\/\//i, "").replace(/\/+$/, "");
+}
+/**
+* Builds the inline bootstrap script that initializes `window.Shopify` for storefront scripts.
+*/
+function getShopifyGlobalBootstrapScript({ i18n, shop }) {
+	const config = {
+		country: i18n?.country ?? DEFAULT_COUNTRY,
+		...i18n?.currency !== void 0 ? { currency: { active: i18n.currency.toUpperCase() } } : {},
+		locale: (i18n?.language ?? DEFAULT_LOCALE).toLowerCase(),
+		routes: {
+			root: getShopifyRoutesRoot(i18n?.pathPrefix),
+			apiProxyPrefix: SHOPIFY_API_PROXY_PREFIX
+		},
+		shop: normalizeMyshopifyDomain(shop.myshopifyDomain),
+		customerPrivacy: {
+			config: { isHeadless: true },
+			consentStatus: "pending"
+		}
+	};
+	return asInlineScript(initializeShopifyGlobal)(config);
+}
+
+//#endregion
+export { configureShopifyRouting, getShopifyGlobal, getShopifyGlobalBootstrapScript };
+//# sourceMappingURL=global.mjs.map

package/dist/development/core/shopify-scripts/global.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"global.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/global.ts"],"sourcesContent":["import type { ShopifyGlobal } from \"../../globals\";\nimport type { I18nConfig } from \"../request-context\";\nimport {\n  matchStandardRouteUrl,\n  resolveStandardRouteUrl,\n  type ShopifyRouteTemplates,\n} from \"../standard-routes/index\";\nimport { SHOPIFY_API_PROXY_PREFIX, isHydrogenServerHandoffPath } from \"../url\";\nimport initializeShopifyGlobal from \"./global-script\" with { type: \"script\" };\nimport type { ShopifyScriptsI18n } from \"./types\";\nimport type { ShopifyScriptsShop } from \"./types\";\nimport { asInlineScript } from \"./utils/inline-script\";\n\nexport type ShopifyGlobalConfig = {\n  country: I18nConfig[\"country\"];\n  currency?: NonNullable<ShopifyGlobal[\"currency\"]>;\n  locale: Lowercase<I18nConfig[\"language\"]>;\n  customerPrivacy: {\n    config: NonNullable<ShopifyGlobal[\"customerPrivacy\"][\"config\"]>;\n    consentStatus: NonNullable<ShopifyGlobal[\"customerPrivacy\"][\"consentStatus\"]>;\n  };\n  routes: {\n    root: string;\n    apiProxyPrefix: string;\n  };\n  shop: string;\n};\n\nexport type IncompleteCustomerPrivacy = Partial<\n  Omit<ShopifyGlobal[\"customerPrivacy\"], \"config\">\n> & {\n  config?: Partial<NonNullable<ShopifyGlobal[\"customerPrivacy\"][\"config\"]>>;\n};\n\nexport type IncompleteShopifyGlobal = Partial<Omit<ShopifyGlobal, \"customerPrivacy\" | \"routes\">> & {\n  customerPrivacy?: IncompleteCustomerPrivacy;\n  routes?: Partial<ShopifyGlobal[\"routes\"]> & Record<string, unknown>;\n  [key: string]: unknown;\n};\n\nconst DEFAULT_COUNTRY: ShopifyGlobalConfig[\"country\"] = \"US\";\nconst DEFAULT_LOCALE: ShopifyGlobalConfig[\"locale\"] = \"en\";\nconst DEFAULT_ROUTES_ROOT: ShopifyGlobalConfig[\"routes\"][\"root\"] = \"/\";\n\n/**\n * Returns the browser's `window.Shopify` object, creating it when needed.\n *\n * This is SSR-safe and returns `undefined` outside the browser.\n */\nexport function getShopifyGlobal(): IncompleteShopifyGlobal | undefined {\n  if (typeof window === \"undefined\") return undefined;\n\n  const shopifyWindow: { Shopify?: IncompleteShopifyGlobal } = window;\n  return (shopifyWindow.Shopify ??= {});\n}\n\n/**\n * Configures Shopify runtime routing hooks used by storefront scripts.\n *\n * This is SSR-safe and no-ops outside the browser.\n */\nexport function configureShopifyRouting({\n  navigate,\n  routes,\n}: {\n  navigate?: ShopifyGlobal[\"routes\"][\"navigate\"];\n  routes?: ShopifyRouteTemplates;\n}) {\n  const shopify = getShopifyGlobal();\n  if (!shopify) return;\n\n  const getRouteOptions = (url: string) => ({\n    baseUrl: window.location.href,\n    pathPrefix: shopify.routes?.root,\n    routeTemplates: routes ?? {},\n    url,\n  });\n\n  shopify.routes ??= {};\n  shopify.routes.match = (url) => matchStandardRouteUrl(getRouteOptions(url));\n  shopify.routes.resolve = (url) => resolveStandardRouteUrl(getRouteOptions(url));\n\n  const navigateTo = navigate ?? documentNavigate;\n  shopify.routes.navigate = (url) => {\n    if (shouldHandoff(url)) {\n      return documentNavigate(url);\n    }\n\n    return navigateTo(shopify.routes?.resolve?.(url) ?? url);\n  };\n  // Deprecated, kept for temporary backwards compat with WebMCP\n  shopify.navigate = shopify.routes.navigate;\n}\n\nfunction documentNavigate(url: string): void {\n  window.location.assign(url);\n}\n\nfunction shouldHandoff(url: string): boolean {\n  try {\n    const parsedUrl = new URL(url, window.location.href);\n\n    return (\n      parsedUrl.origin === window.location.origin && isHydrogenServerHandoffPath(parsedUrl.pathname)\n    );\n  } catch {\n    return false;\n  }\n}\n\nfunction getShopifyRoutesRoot(pathPrefix: I18nConfig[\"pathPrefix\"]): string {\n  const normalizedPathPrefix = pathPrefix?.trim().replace(/^\\/+/, \"\").replace(/\\/+$/, \"\") ?? \"\";\n\n  return normalizedPathPrefix ? `/${normalizedPathPrefix}/` : DEFAULT_ROUTES_ROOT;\n}\n\nfunction normalizeMyshopifyDomain(domain: string): string {\n  return domain\n    .trim()\n    .replace(/^https?:\\/\\//i, \"\")\n    .replace(/\\/+$/, \"\");\n}\n\n/**\n * Builds the inline bootstrap script that initializes `window.Shopify` for storefront scripts.\n */\nexport function getShopifyGlobalBootstrapScript({\n  i18n,\n  shop,\n}: {\n  i18n?: ShopifyScriptsI18n;\n  shop: ShopifyScriptsShop;\n}): string {\n  const config: ShopifyGlobalConfig = {\n    country: i18n?.country ?? DEFAULT_COUNTRY,\n    ...(i18n?.currency !== undefined ? { currency: { active: i18n.currency.toUpperCase() } } : {}),\n    // oxlint-disable-next-line typescript/consistent-type-assertions\n    locale: (i18n?.language ?? DEFAULT_LOCALE).toLowerCase() as Lowercase<\n      ShopifyGlobalConfig[\"locale\"]\n    >,\n    routes: {\n      root: getShopifyRoutesRoot(i18n?.pathPrefix),\n      apiProxyPrefix: SHOPIFY_API_PROXY_PREFIX,\n    },\n    shop: normalizeMyshopifyDomain(shop.myshopifyDomain),\n    customerPrivacy: {\n      config: {\n        isHeadless: true,\n      },\n      consentStatus: \"pending\",\n    },\n  };\n\n  return asInlineScript(initializeShopifyGlobal)(config);\n}\n"],"mappings":";;;;;;AAQA,MAAM,2BAAyB,eAAe,mBAAsB,sUAAS,CAAA,QAAA,kCAAA,KAAA,UAAA,WAAA,IAAA,aAAA,QAAA,MAAA,UAAA,CAAA,QAAA,WAAA,UAAA,CAAA,QAAA,WAAA,UAAA,CAAA;AAgC7E,MAAM,kBAAkD;AACxD,MAAM,iBAAgD;AACtD,MAAM,sBAA6D;;;;;;AAOnE,SAAgB,mBAAwD;AACtE,KAAI,OAAO,WAAW,YAAa,QAAO;CAE1C,MAAM,gBAAuD;AAC7D,QAAQ,cAAc,YAAY,EAAE;;;;;;;AAQtC,SAAgB,wBAAwB,EACtC,UACA,UAIC;CACD,MAAM,UAAU,kBAAkB;AAClC,KAAI,CAAC,QAAS;CAEd,MAAM,mBAAmB,SAAiB;EACxC,SAAS,OAAO,SAAS;EACzB,YAAY,QAAQ,QAAQ;EAC5B,gBAAgB,UAAU,EAAE;EAC5B;EACD;AAED,SAAQ,WAAW,EAAE;AACrB,SAAQ,OAAO,SAAS,QAAQ,sBAAsB,gBAAgB,IAAI,CAAC;AAC3E,SAAQ,OAAO,WAAW,QAAQ,wBAAwB,gBAAgB,IAAI,CAAC;CAE/E,MAAM,aAAa,YAAY;AAC/B,SAAQ,OAAO,YAAY,QAAQ;AACjC,MAAI,cAAc,IAAI,CACpB,QAAO,iBAAiB,IAAI;AAG9B,SAAO,WAAW,QAAQ,QAAQ,UAAU,IAAI,IAAI,IAAI;;AAG1D,SAAQ,WAAW,QAAQ,OAAO;;AAGpC,SAAS,iBAAiB,KAAmB;AAC3C,QAAO,SAAS,OAAO,IAAI;;AAG7B,SAAS,cAAc,KAAsB;AAC3C,KAAI;EACF,MAAM,YAAY,IAAI,IAAI,KAAK,OAAO,SAAS,KAAK;AAEpD,SACE,UAAU,WAAW,OAAO,SAAS,UAAU,4BAA4B,UAAU,SAAQ;SAEzF;AACN,SAAO;;;AAIX,SAAS,qBAAqB,YAA8C;CAC1E,MAAM,uBAAuB,YAAY,MAAM,CAAC,QAAQ,QAAQ,GAAG,CAAC,QAAQ,QAAQ,GAAG,IAAI;AAE3F,QAAO,uBAAuB,IAAI,qBAAqB,KAAK;;AAG9D,SAAS,yBAAyB,QAAwB;AACxD,QAAO,OACJ,MAAK,CACL,QAAQ,iBAAiB,GAAE,CAC3B,QAAQ,QAAQ,GAAG;;;;;AAMxB,SAAgB,gCAAgC,EAC9C,MACA,QAIS;CACT,MAAM,SAA8B;EAClC,SAAS,MAAM,WAAW;EAC1B,GAAI,MAAM,aAAa,SAAY,EAAE,UAAU,EAAE,QAAQ,KAAK,SAAS,aAAa,EAAE,EAAE,GAAG,EAAE;EAE7F,SAAS,MAAM,YAAY,gBAAgB,aAAa;EAGxD,QAAQ;GACN,MAAM,qBAAqB,MAAM,WAAW;GAC5C,gBAAgB;GACjB;EACD,MAAM,yBAAyB,KAAK,gBAAgB;EACpD,iBAAiB;GACf,QAAQ,EACN,YAAY,MACb;GACD,eAAe;GAChB;EACF;AAED,QAAO,eAAe,wBAAwB,CAAC,OAAO"}

package/dist/development/core/shopify-scripts/index.d.mts

@@ -0,0 +1,27 @@
+import { ShopifyRoutesOptions, ShopifyScriptTagDescriptor, ShopifyScriptTagDescriptors, ShopifyScriptTagsOptions, ShopifyScriptsAnalyticsConfig, ShopifyScriptsI18n, ShopifyScriptsOptions, ShopifyScriptsShop } from "./types.mjs";
+import { initializeShopifyScripts } from "./initialize.mjs";
+//#region src/core/shopify-scripts/index.d.ts
+/**
+ * Returns grouped Shopify storefront script/link descriptors for SSR frameworks and bindings.
+ *
+ * Framework bindings wrap this with `initializeShopifyScripts()` to form their `ShopifyScripts`
+ * component. Frameworks without a binding can render these descriptors during SSR and call
+ * `initializeShopifyScripts()` during browser hydration.
+ */
+declare function getShopifyScriptTags({
+  analytics,
+  consent,
+  debug,
+  i18n,
+  nonce,
+  shop,
+  shopifyAnalytics,
+  inbox
+}: ShopifyScriptTagsOptions): ShopifyScriptTagDescriptors;
+/**
+ * Renders all Shopify storefront script/link descriptors to HTML strings.
+ */
+declare function renderShopifyScriptTags(options: ShopifyScriptTagsOptions): string[];
+//#endregion
+export { getShopifyScriptTags, renderShopifyScriptTags };
+//# sourceMappingURL=index.d.mts.map

package/dist/development/core/shopify-scripts/index.mjs

@@ -0,0 +1,145 @@
+import { getShopifyAnalyticsBusScript, getShopifyAnalyticsConfig } from "./analytics.mjs";
+import { SHOPIFY_CDN_ORIGIN, SHOPIFY_CONSENT_API_SCRIPT, SHOPIFY_CONSENT_SCRIPT_ID, SHOPIFY_INBOX_SCRIPT, SHOPIFY_PERF_KIT_SCRIPT, SHOPIFY_PRIVACY_BANNER_SCRIPT, SHOPIFY_SHOP_APP_ORIGIN, SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT, SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT, SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT, SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT, SHOPIFY_STOREFRONT_WEBMCP_SCRIPT, VISITOR_CONSENT_COLLECTED_EVENT } from "./constants.mjs";
+import { getShopifyConsentTrackingScript } from "./consent.mjs";
+import { getShopifyGlobal, getShopifyGlobalBootstrapScript } from "./global.mjs";
+import { getPerfKitScript } from "./perfkit.mjs";
+import { renderShopifyScriptTag } from "./render.mjs";
+import { initializeShopifyScripts } from "./initialize.mjs";
+
+//#region src/core/shopify-scripts/index.ts
+/**
+* Returns grouped Shopify storefront script/link descriptors for SSR frameworks and bindings.
+*
+* Framework bindings wrap this with `initializeShopifyScripts()` to form their `ShopifyScripts`
+* component. Frameworks without a binding can render these descriptors during SSR and call
+* `initializeShopifyScripts()` during browser hydration.
+*/
+function getShopifyScriptTags({ analytics, consent, debug, i18n, nonce, shop, shopifyAnalytics = true, inbox = false }) {
+	const nonceAttributes = nonce !== void 0 ? { nonce } : void 0;
+	const analyticsConfig = getShopifyAnalyticsConfig({
+		analytics,
+		consent,
+		shop
+	});
+	const links = [
+		{
+			tagName: "link",
+			attributes: {
+				rel: "preconnect",
+				href: SHOPIFY_CDN_ORIGIN
+			}
+		},
+		{
+			tagName: "link",
+			attributes: {
+				rel: "preconnect",
+				href: SHOPIFY_SHOP_APP_ORIGIN
+			}
+		},
+		{
+			tagName: "link",
+			attributes: {
+				rel: "prefetch",
+				as: "script",
+				href: SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,
+				crossorigin: "anonymous"
+			}
+		}
+	];
+	const scripts = [{
+		tagName: "script",
+		attributes: {
+			id: "shopify-global-bootstrap",
+			...nonceAttributes
+		},
+		innerHTML: getShopifyGlobalBootstrapScript({
+			i18n,
+			shop
+		})
+	}, {
+		tagName: "script",
+		attributes: {
+			id: "shopify-standard-actions",
+			type: "module",
+			crossorigin: "anonymous",
+			...nonceAttributes,
+			src: SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT
+		}
+	}];
+	if (debug?.standardEventsInspector) scripts.push({
+		tagName: "script",
+		attributes: {
+			id: "shopify-standard-events-inspector",
+			defer: true,
+			crossorigin: "anonymous",
+			...nonceAttributes,
+			src: SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT
+		}
+	});
+	if (inbox) scripts.push({
+		tagName: "script",
+		attributes: {
+			id: "shopify-inbox",
+			type: "module",
+			async: true,
+			crossorigin: "anonymous",
+			...nonceAttributes,
+			src: SHOPIFY_INBOX_SCRIPT
+		}
+	});
+	scripts.push({
+		tagName: "script",
+		attributes: {
+			id: SHOPIFY_CONSENT_SCRIPT_ID,
+			async: true,
+			crossorigin: "anonymous",
+			...nonceAttributes,
+			src: consent?.mode === "default-banner" ? SHOPIFY_PRIVACY_BANNER_SCRIPT : SHOPIFY_CONSENT_API_SCRIPT
+		}
+	});
+	scripts.push({
+		tagName: "script",
+		attributes: {
+			id: "shopify-consent-bootstrap",
+			...nonceAttributes
+		},
+		innerHTML: getShopifyConsentTrackingScript(consent)
+	});
+	scripts.push({
+		tagName: "script",
+		attributes: {
+			id: "shopify-analytics-bus",
+			...nonceAttributes
+		},
+		innerHTML: getShopifyAnalyticsBusScript(analyticsConfig)
+	});
+	if (shopifyAnalytics) scripts.push({
+		tagName: "script",
+		attributes: {
+			id: "shopify-storefront-analytics",
+			async: true,
+			crossorigin: "anonymous",
+			...nonceAttributes,
+			src: SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT
+		}
+	});
+	const perfKitScript = getPerfKitScript(shop, nonceAttributes);
+	if (perfKitScript) scripts.push(perfKitScript);
+	return {
+		links,
+		scripts,
+		get tags() {
+			return [...links, ...scripts];
+		}
+	};
+}
+/**
+* Renders all Shopify storefront script/link descriptors to HTML strings.
+*/
+function renderShopifyScriptTags(options) {
+	return getShopifyScriptTags(options).tags.map(renderShopifyScriptTag);
+}
+
+//#endregion
+export { getShopifyScriptTags, renderShopifyScriptTags };
+//# sourceMappingURL=index.mjs.map

package/dist/development/core/shopify-scripts/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/index.ts"],"sourcesContent":["import { getShopifyAnalyticsBusScript, getShopifyAnalyticsConfig } from \"./analytics\";\nimport { getShopifyConsentTrackingScript } from \"./consent\";\nimport {\n  SHOPIFY_CONSENT_API_SCRIPT,\n  SHOPIFY_CDN_ORIGIN,\n  SHOPIFY_CONSENT_SCRIPT_ID,\n  SHOPIFY_PRIVACY_BANNER_SCRIPT,\n  SHOPIFY_SHOP_APP_ORIGIN,\n  SHOPIFY_INBOX_SCRIPT,\n  SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n} from \"./constants\";\nimport { getShopifyGlobalBootstrapScript } from \"./global\";\nimport { getPerfKitScript } from \"./perfkit\";\nimport { renderShopifyScriptTag } from \"./render\";\nimport type {\n  ShopifyLinkDescriptor,\n  ShopifyScriptDescriptor,\n  ShopifyScriptTagDescriptors,\n  ShopifyScriptTagsOptions,\n} from \"./types\";\n\nexport {\n  SHOPIFY_CDN_ORIGIN,\n  SHOPIFY_CONSENT_API_SCRIPT,\n  SHOPIFY_PERF_KIT_SCRIPT,\n  SHOPIFY_PRIVACY_BANNER_SCRIPT,\n  SHOPIFY_SHOP_APP_ORIGIN,\n  SHOPIFY_INBOX_SCRIPT,\n  SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n  SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n  SHOPIFY_STOREFRONT_WEBMCP_SCRIPT,\n  VISITOR_CONSENT_COLLECTED_EVENT,\n} from \"./constants\";\nexport { getShopifyGlobal, getShopifyGlobalBootstrapScript } from \"./global\";\nexport { initializeShopifyScripts } from \"./initialize\";\nexport { renderShopifyScriptTag } from \"./render\";\nexport type {\n  ShopifyScriptsAnalyticsConfig,\n  ShopifyRoutesOptions,\n  ShopifyScriptTagDescriptor,\n  ShopifyScriptTagDescriptors,\n  ShopifyScriptTagsOptions,\n  ShopifyScriptsOptions,\n  ShopifyScriptsI18n,\n  ShopifyScriptsShop,\n} from \"./types\";\n\n/**\n * Returns grouped Shopify storefront script/link descriptors for SSR frameworks and bindings.\n *\n * Framework bindings wrap this with `initializeShopifyScripts()` to form their `ShopifyScripts`\n * component. Frameworks without a binding can render these descriptors during SSR and call\n * `initializeShopifyScripts()` during browser hydration.\n */\nexport function getShopifyScriptTags({\n  analytics,\n  consent,\n  debug,\n  i18n,\n  nonce,\n  shop,\n  shopifyAnalytics = true,\n  inbox = false,\n}: ShopifyScriptTagsOptions): ShopifyScriptTagDescriptors {\n  const nonceAttributes = nonce !== undefined ? { nonce } : undefined;\n  const analyticsConfig = getShopifyAnalyticsConfig({ analytics, consent, shop });\n\n  const links: ShopifyLinkDescriptor[] = [\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"preconnect\",\n        href: SHOPIFY_CDN_ORIGIN,\n      },\n    },\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"preconnect\",\n        href: SHOPIFY_SHOP_APP_ORIGIN,\n      },\n    },\n    {\n      tagName: \"link\",\n      attributes: {\n        rel: \"prefetch\",\n        as: \"script\",\n        href: SHOPIFY_STOREFRONT_STANDARD_EVENTS_SCRIPT,\n        crossorigin: \"anonymous\",\n      },\n    },\n  ];\n  const scripts: ShopifyScriptDescriptor[] = [\n    {\n      tagName: \"script\",\n      attributes: { id: \"shopify-global-bootstrap\", ...nonceAttributes },\n      innerHTML: getShopifyGlobalBootstrapScript({ i18n, shop }),\n    },\n    {\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-standard-actions\",\n        type: \"module\",\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_STANDARD_ACTIONS_SCRIPT,\n      },\n    },\n  ];\n\n  if (__DEV__ && debug?.standardEventsInspector) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-standard-events-inspector\",\n        defer: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_STANDARD_EVENTS_INSPECTOR_SCRIPT,\n      },\n    });\n  }\n\n  if (inbox) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-inbox\",\n        type: \"module\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_INBOX_SCRIPT,\n      },\n    });\n  }\n\n  // Keep this async consent library immediately before the inline consent bootstrap.\n  // Parser-inserted async scripts execute in a later task, so the following inline\n  // script can attach a load listener before the library runs.\n  scripts.push({\n    tagName: \"script\",\n    attributes: {\n      id: SHOPIFY_CONSENT_SCRIPT_ID,\n      async: true,\n      crossorigin: \"anonymous\",\n      ...nonceAttributes,\n      src:\n        consent?.mode === \"default-banner\"\n          ? SHOPIFY_PRIVACY_BANNER_SCRIPT\n          : SHOPIFY_CONSENT_API_SCRIPT,\n    },\n  });\n  // This must run immediately after the consent library tag so it can find that\n  // tag and attach its load listener before consent-tracking-api/privacy-banner executes.\n  scripts.push({\n    tagName: \"script\",\n    attributes: { id: \"shopify-consent-bootstrap\", ...nonceAttributes },\n    innerHTML: getShopifyConsentTrackingScript(consent),\n  });\n\n  // This must run after getShopifyConsentTrackingScript because that script\n  // temporarily annotates visitorConsentCollected events for the analytics bus.\n  scripts.push({\n    tagName: \"script\",\n    attributes: { id: \"shopify-analytics-bus\", ...nonceAttributes },\n    innerHTML: getShopifyAnalyticsBusScript(analyticsConfig),\n  });\n\n  if (shopifyAnalytics) {\n    scripts.push({\n      tagName: \"script\",\n      attributes: {\n        id: \"shopify-storefront-analytics\",\n        async: true,\n        crossorigin: \"anonymous\",\n        ...nonceAttributes,\n        src: SHOPIFY_STOREFRONT_ANALYTICS_SCRIPT,\n      },\n    });\n  }\n\n  const perfKitScript = getPerfKitScript(shop, nonceAttributes);\n  if (perfKitScript) {\n    scripts.push(perfKitScript);\n  }\n\n  return {\n    links,\n    scripts,\n    get tags() {\n      return [...links, ...scripts];\n    },\n  };\n}\n\n/**\n * Renders all Shopify storefront script/link descriptors to HTML strings.\n */\nexport function renderShopifyScriptTags(options: ShopifyScriptTagsOptions): string[] {\n  return getShopifyScriptTags(options).tags.map(renderShopifyScriptTag);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA0DA,SAAgB,qBAAqB,EACnC,WACA,SACA,OACA,MACA,OACA,MACA,mBAAmB,MACnB,QAAQ,SACgD;CACxD,MAAM,kBAAkB,UAAU,SAAY,EAAE,OAAO,GAAG;CAC1D,MAAM,kBAAkB,0BAA0B;EAAE;EAAW;EAAS;EAAM,CAAC;CAE/E,MAAM,QAAiC;EACrC;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,MAAM;IACP;GACF;EACD;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,MAAM;IACP;GACF;EACD;GACE,SAAS;GACT,YAAY;IACV,KAAK;IACL,IAAI;IACJ,MAAM;IACN,aAAa;IACd;GACF;EACF;CACD,MAAM,UAAqC,CACzC;EACE,SAAS;EACT,YAAY;GAAE,IAAI;GAA4B,GAAG;GAAiB;EAClE,WAAW,gCAAgC;GAAE;GAAM;GAAM,CAAC;EAC3D,EACD;EACE,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CACF;AAED,KAAe,OAAO,wBACpB,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;AAGJ,KAAI,MACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,MAAM;GACN,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;AAMJ,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,OAAO;GACP,aAAa;GACb,GAAG;GACH,KACE,SAAS,SAAS,mBACd,gCACA;GACP;EACF,CAAC;AAGF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GAAE,IAAI;GAA6B,GAAG;GAAiB;EACnE,WAAW,gCAAgC,QAAQ;EACpD,CAAC;AAIF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GAAE,IAAI;GAAyB,GAAG;GAAiB;EAC/D,WAAW,6BAA6B,gBAAgB;EACzD,CAAC;AAEF,KAAI,iBACF,SAAQ,KAAK;EACX,SAAS;EACT,YAAY;GACV,IAAI;GACJ,OAAO;GACP,aAAa;GACb,GAAG;GACH,KAAK;GACN;EACF,CAAC;CAGJ,MAAM,gBAAgB,iBAAiB,MAAM,gBAAgB;AAC7D,KAAI,cACF,SAAQ,KAAK,cAAc;AAG7B,QAAO;EACL;EACA;EACA,IAAI,OAAO;AACT,UAAO,CAAC,GAAG,OAAO,GAAG,QAAQ;;EAEhC;;;;;AAMH,SAAgB,wBAAwB,SAA6C;AACnF,QAAO,qBAAqB,QAAQ,CAAC,KAAK,IAAI,uBAAuB"}

package/dist/development/core/shopify-scripts/initialize.d.mts

@@ -0,0 +1,18 @@
+import { InitializeShopifyScriptsOptions } from "./types.mjs";
+
+//#region src/core/shopify-scripts/initialize.d.ts
+/**
+ * Initializes Shopify browser script behavior for frameworks without a Hydrogen binding.
+ *
+ * This is the browser hydration half of `getShopifyScriptTags()`: framework bindings combine both
+ * into a `ShopifyScripts` component, while custom integrations can render script tags during SSR
+ * and call this helper from their browser lifecycle.
+ */
+declare function initializeShopifyScripts({
+  navigate,
+  routes,
+  webMcp
+}: InitializeShopifyScriptsOptions): Promise<boolean | void>;
+//#endregion
+export { initializeShopifyScripts };
+//# sourceMappingURL=initialize.d.mts.map

package/dist/development/core/shopify-scripts/initialize.mjs

@@ -0,0 +1,27 @@
+import { configureShopifyRouting } from "./global.mjs";
+import { initializeDeprecatedCookies } from "./deprecated-cookies.mjs";
+import { initializeShopifyPageViewEvents } from "./page-view.mjs";
+import { loadShopifyWebMcpTools } from "./webmcp.mjs";
+
+//#region src/core/shopify-scripts/initialize.ts
+/**
+* Initializes Shopify browser script behavior for frameworks without a Hydrogen binding.
+*
+* This is the browser hydration half of `getShopifyScriptTags()`: framework bindings combine both
+* into a `ShopifyScripts` component, while custom integrations can render script tags during SSR
+* and call this helper from their browser lifecycle.
+*/
+function initializeShopifyScripts({ navigate, routes, webMcp = true }) {
+	configureShopifyRouting({
+		navigate,
+		routes
+	});
+	initializeDeprecatedCookies();
+	initializeShopifyPageViewEvents();
+	if (!webMcp) return Promise.resolve();
+	return loadShopifyWebMcpTools();
+}
+
+//#endregion
+export { initializeShopifyScripts };
+//# sourceMappingURL=initialize.mjs.map

package/dist/development/core/shopify-scripts/initialize.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/initialize.ts"],"sourcesContent":["import { initializeDeprecatedCookies } from \"./deprecated-cookies\";\nimport { configureShopifyRouting } from \"./global\";\nimport { initializeShopifyPageViewEvents } from \"./page-view\";\nimport type { InitializeShopifyScriptsOptions } from \"./types\";\nimport { loadShopifyWebMcpTools } from \"./webmcp\";\n\n/**\n * Initializes Shopify browser script behavior for frameworks without a Hydrogen binding.\n *\n * This is the browser hydration half of `getShopifyScriptTags()`: framework bindings combine both\n * into a `ShopifyScripts` component, while custom integrations can render script tags during SSR\n * and call this helper from their browser lifecycle.\n */\nexport function initializeShopifyScripts({\n  navigate,\n  routes,\n  webMcp = true,\n}: InitializeShopifyScriptsOptions): Promise<boolean | void> {\n  configureShopifyRouting({ navigate, routes });\n  initializeDeprecatedCookies();\n  initializeShopifyPageViewEvents();\n\n  if (!webMcp) return Promise.resolve();\n\n  return loadShopifyWebMcpTools();\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,yBAAyB,EACvC,UACA,QACA,SAAS,QACkD;AAC3D,yBAAwB;EAAE;EAAU;EAAQ,CAAC;AAC7C,8BAA6B;AAC7B,kCAAiC;AAEjC,KAAI,CAAC,OAAQ,QAAO,QAAQ,SAAS;AAErC,QAAO,wBAAwB"}

package/dist/development/core/shopify-scripts/page-view.mjs

@@ -0,0 +1,49 @@
+import { SHOPIFY_PERF_KIT_SCRIPT_ID } from "./constants.mjs";
+import { observeNavigation } from "./utils/navigation.mjs";
+
+//#region src/core/shopify-scripts/page-view.ts
+let cleanupPageViewEvents;
+const getPageKey = () => `${window.location.pathname}${window.location.search}`;
+const getPageTemplate = (url = window.location.href) => window.Shopify?.routes?.match?.(url)?.pageTemplateName ?? "unknown";
+const importStandardEventsFromCDN = () => import("https://cdn.shopify.com/storefront/standard-events.js");
+function initializeShopifyPageViewEvents(importStandardEvents = importStandardEventsFromCDN) {
+	if (cleanupPageViewEvents) return cleanupPageViewEvents;
+	document.getElementById(SHOPIFY_PERF_KIT_SCRIPT_ID)?.setAttribute("data-page-type", getPageTemplate());
+	const standardEventsPromise = importStandardEvents().catch(() => void 0);
+	let lastPageKey = getPageKey();
+	let scheduledNavigation;
+	const emitPageView = () => {
+		const page = {
+			template: getPageTemplate(),
+			title: document.title,
+			url: window.location.href
+		};
+		standardEventsPromise.then((StandardEvents) => {
+			if (!StandardEvents) return;
+			document.dispatchEvent(new StandardEvents.PageViewEvent({ page }));
+		});
+	};
+	const stopObservingNavigation = observeNavigation(() => {
+		const pageKey = getPageKey();
+		if (pageKey === lastPageKey) return;
+		lastPageKey = pageKey;
+		if (scheduledNavigation !== void 0) cancelAnimationFrame(scheduledNavigation);
+		scheduledNavigation = requestAnimationFrame(() => {
+			scheduledNavigation = void 0;
+			emitPageView();
+		});
+	});
+	if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", emitPageView, { once: true });
+	else emitPageView();
+	cleanupPageViewEvents = () => {
+		document.removeEventListener("DOMContentLoaded", emitPageView);
+		stopObservingNavigation();
+		if (scheduledNavigation !== void 0) cancelAnimationFrame(scheduledNavigation);
+		cleanupPageViewEvents = void 0;
+	};
+	return cleanupPageViewEvents;
+}
+
+//#endregion
+export { initializeShopifyPageViewEvents };
+//# sourceMappingURL=page-view.mjs.map

package/dist/development/core/shopify-scripts/page-view.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-view.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/page-view.ts"],"sourcesContent":["import type * as StandardEventsModule from \"../../../vendor/standard-events\";\nimport { SHOPIFY_PERF_KIT_SCRIPT_ID } from \"./constants\";\nimport { observeNavigation } from \"./utils/navigation\";\n\nlet cleanupPageViewEvents: (() => void) | undefined;\n\nconst getPageKey = () => `${window.location.pathname}${window.location.search}`;\nconst getPageTemplate = (url = window.location.href) =>\n  window.Shopify?.routes?.match?.(url)?.pageTemplateName ?? \"unknown\";\n\n// Keep this URL inline so consumer bundlers such as Vite recognize it as an external import.\nconst importStandardEventsFromCDN: () => Promise<\n  Pick<typeof StandardEventsModule, \"PageViewEvent\">\n> = () =>\n  // @ts-expect-error CDN package without automatic types\n  import(\"https://cdn.shopify.com/storefront/standard-events.js\");\n\nexport function initializeShopifyPageViewEvents(\n  importStandardEvents = importStandardEventsFromCDN,\n) {\n  if (cleanupPageViewEvents) return cleanupPageViewEvents;\n\n  // Update the PerfKit script with the current page type since it\n  // might miss the initial page view if it was loaded after the script.\n  document\n    .getElementById(SHOPIFY_PERF_KIT_SCRIPT_ID)\n    ?.setAttribute(\"data-page-type\", getPageTemplate());\n\n  const standardEventsPromise = importStandardEvents().catch(() => undefined);\n  let lastPageKey = getPageKey();\n  let scheduledNavigation: number | undefined;\n\n  const emitPageView = () => {\n    const page = {\n      template: getPageTemplate(),\n      title: document.title,\n      url: window.location.href,\n    } satisfies StandardEventsModule.PageViewEvent[\"page\"];\n\n    void standardEventsPromise.then((StandardEvents) => {\n      if (!StandardEvents) return;\n      document.dispatchEvent(new StandardEvents.PageViewEvent({ page }));\n    });\n  };\n\n  const stopObservingNavigation = observeNavigation(() => {\n    const pageKey = getPageKey();\n    if (pageKey === lastPageKey) return;\n\n    lastPageKey = pageKey;\n    if (scheduledNavigation !== undefined) {\n      cancelAnimationFrame(scheduledNavigation);\n    }\n    scheduledNavigation = requestAnimationFrame(() => {\n      scheduledNavigation = undefined;\n      emitPageView();\n    });\n  });\n\n  if (document.readyState === \"loading\") {\n    document.addEventListener(\"DOMContentLoaded\", emitPageView, { once: true });\n  } else {\n    emitPageView();\n  }\n\n  cleanupPageViewEvents = () => {\n    document.removeEventListener(\"DOMContentLoaded\", emitPageView);\n    stopObservingNavigation();\n    if (scheduledNavigation !== undefined) cancelAnimationFrame(scheduledNavigation);\n    cleanupPageViewEvents = undefined;\n  };\n\n  return cleanupPageViewEvents;\n}\n"],"mappings":";;;;AAIA,IAAI;AAEJ,MAAM,mBAAmB,GAAG,OAAO,SAAS,WAAW,OAAO,SAAS;AACvE,MAAM,mBAAmB,MAAM,OAAO,SAAS,SAC7C,OAAO,SAAS,QAAQ,QAAQ,IAAI,EAAE,oBAAoB;AAG5D,MAAM,oCAIJ,OAAO;AAET,SAAgB,gCACd,uBAAuB,6BACvB;AACA,KAAI,sBAAuB,QAAO;AAIlC,UACG,eAAe,2BAA2B,EACzC,aAAa,kBAAkB,iBAAiB,CAAC;CAErD,MAAM,wBAAwB,sBAAsB,CAAC,YAAY,OAAU;CAC3E,IAAI,cAAc,YAAY;CAC9B,IAAI;CAEJ,MAAM,qBAAqB;EACzB,MAAM,OAAO;GACX,UAAU,iBAAiB;GAC3B,OAAO,SAAS;GAChB,KAAK,OAAO,SAAS;GACtB;AAED,EAAK,sBAAsB,MAAM,mBAAmB;AAClD,OAAI,CAAC,eAAgB;AACrB,YAAS,cAAc,IAAI,eAAe,cAAc,EAAE,MAAM,CAAC,CAAC;IAClE;;CAGJ,MAAM,0BAA0B,wBAAwB;EACtD,MAAM,UAAU,YAAY;AAC5B,MAAI,YAAY,YAAa;AAE7B,gBAAc;AACd,MAAI,wBAAwB,OAC1B,sBAAqB,oBAAoB;AAE3C,wBAAsB,4BAA4B;AAChD,yBAAsB;AACtB,iBAAc;IACd;GACF;AAEF,KAAI,SAAS,eAAe,UAC1B,UAAS,iBAAiB,oBAAoB,cAAc,EAAE,MAAM,MAAM,CAAC;KAE3E,eAAc;AAGhB,+BAA8B;AAC5B,WAAS,oBAAoB,oBAAoB,aAAa;AAC9D,2BAAyB;AACzB,MAAI,wBAAwB,OAAW,sBAAqB,oBAAoB;AAChF,0BAAwB;;AAG1B,QAAO"}

package/dist/development/core/shopify-scripts/perfkit.mjs

@@ -0,0 +1,33 @@
+import { SHOPIFY_PERF_KIT_SCRIPT, SHOPIFY_PERF_KIT_SCRIPT_ID } from "./constants.mjs";
+
+//#region src/core/shopify-scripts/perfkit.ts
+const SHOPIFY_SHOP_ID_PATTERN = /^\d+$/;
+function getPerfKitScript(shop, extraAttributes) {
+	if (!shop.storefrontId) return;
+	const shopId = parseNumericShopId(shop.shopId);
+	if (!shopId) return;
+	return {
+		tagName: "script",
+		attributes: {
+			id: SHOPIFY_PERF_KIT_SCRIPT_ID,
+			...extraAttributes,
+			async: true,
+			src: SHOPIFY_PERF_KIT_SCRIPT,
+			"data-application": "hydrogen",
+			"data-shop-id": shopId,
+			"data-storefront-id": shop.storefrontId,
+			"data-monorail-region": "global",
+			"data-spa-mode": "true",
+			"data-resource-timing-sampling-rate": "10"
+		}
+	};
+}
+function parseNumericShopId(shopId) {
+	const parsedShopId = shopId.split("/").pop();
+	if (!parsedShopId) return;
+	return SHOPIFY_SHOP_ID_PATTERN.test(parsedShopId) ? parsedShopId : void 0;
+}
+
+//#endregion
+export { getPerfKitScript };
+//# sourceMappingURL=perfkit.mjs.map

package/dist/development/core/shopify-scripts/perfkit.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"perfkit.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/perfkit.ts"],"sourcesContent":["import { SHOPIFY_PERF_KIT_SCRIPT, SHOPIFY_PERF_KIT_SCRIPT_ID } from \"./constants\";\nimport type {\n  ShopifyScriptDescriptor,\n  ShopifyScriptsShop,\n  ShopifyScriptTagAttributes,\n} from \"./types\";\n\nconst SHOPIFY_SHOP_ID_PATTERN = /^\\d+$/;\n\nexport function getPerfKitScript(\n  shop: ShopifyScriptsShop,\n  extraAttributes?: Pick<ShopifyScriptTagAttributes, \"nonce\">,\n): ShopifyScriptDescriptor | undefined {\n  if (!shop.storefrontId) return;\n\n  const shopId = parseNumericShopId(shop.shopId);\n  if (!shopId) return;\n\n  return {\n    tagName: \"script\",\n    attributes: {\n      id: SHOPIFY_PERF_KIT_SCRIPT_ID,\n      ...extraAttributes,\n      async: true,\n      src: SHOPIFY_PERF_KIT_SCRIPT,\n      \"data-application\": \"hydrogen\",\n      \"data-shop-id\": shopId,\n      \"data-storefront-id\": shop.storefrontId,\n      \"data-monorail-region\": \"global\",\n      \"data-spa-mode\": \"true\",\n      \"data-resource-timing-sampling-rate\": \"10\",\n    },\n  };\n}\n\nfunction parseNumericShopId(shopId: ShopifyScriptsShop[\"shopId\"]): string | undefined {\n  const parsedShopId = shopId.split(\"/\").pop();\n  if (!parsedShopId) return;\n\n  return SHOPIFY_SHOP_ID_PATTERN.test(parsedShopId) ? parsedShopId : undefined;\n}\n"],"mappings":";;;AAOA,MAAM,0BAA0B;AAEhC,SAAgB,iBACd,MACA,iBACqC;AACrC,KAAI,CAAC,KAAK,aAAc;CAExB,MAAM,SAAS,mBAAmB,KAAK,OAAO;AAC9C,KAAI,CAAC,OAAQ;AAEb,QAAO;EACL,SAAS;EACT,YAAY;GACV,IAAI;GACJ,GAAG;GACH,OAAO;GACP,KAAK;GACL,oBAAoB;GACpB,gBAAgB;GAChB,sBAAsB,KAAK;GAC3B,wBAAwB;GACxB,iBAAiB;GACjB,sCAAsC;GACvC;EACF;;AAGH,SAAS,mBAAmB,QAA0D;CACpF,MAAM,eAAe,OAAO,MAAM,IAAI,CAAC,KAAK;AAC5C,KAAI,CAAC,aAAc;AAEnB,QAAO,wBAAwB,KAAK,aAAa,GAAG,eAAe"}

package/dist/development/core/shopify-scripts/render.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/development/core/shopify-scripts/render.mjs

@@ -0,0 +1,23 @@
+//#region src/core/shopify-scripts/render.ts
+/**
+* Renders a Shopify script/link descriptor to an HTML string.
+*/
+function renderShopifyScriptTag({ tagName, attributes, innerHTML }) {
+	const serializedAttributes = Object.entries(attributes ?? {}).map(renderHtmlAttribute).filter((attribute) => Boolean(attribute)).join(" ");
+	const openingTag = serializedAttributes ? `<${tagName} ${serializedAttributes}>` : `<${tagName}>`;
+	if (tagName === "link") return openingTag;
+	return `${openingTag}${innerHTML ?? ""}<\/script>`;
+}
+function renderHtmlAttribute([name, value]) {
+	if (value === false) return;
+	const serializedName = name.toLowerCase();
+	if (value === true) return serializedName;
+	return `${serializedName}="${escapeHtmlAttribute(value)}"`;
+}
+function escapeHtmlAttribute(value) {
+	return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;");
+}
+
+//#endregion
+export { renderShopifyScriptTag };
+//# sourceMappingURL=render.mjs.map

package/dist/development/core/shopify-scripts/render.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.mjs","names":[],"sources":["../../../../src/core/shopify-scripts/render.ts"],"sourcesContent":["import type { ShopifyAttributeValue, ShopifyScriptTagDescriptor } from \"./types\";\n\n/**\n * Renders a Shopify script/link descriptor to an HTML string.\n */\nexport function renderShopifyScriptTag({\n  tagName,\n  attributes,\n  innerHTML,\n}: ShopifyScriptTagDescriptor): string {\n  const serializedAttributes = Object.entries(attributes ?? {})\n    .map(renderHtmlAttribute)\n    .filter((attribute): attribute is string => Boolean(attribute))\n    .join(\" \");\n  const openingTag = serializedAttributes ? `<${tagName} ${serializedAttributes}>` : `<${tagName}>`;\n\n  if (tagName === \"link\") return openingTag;\n\n  return `${openingTag}${innerHTML ?? \"\"}</script>`;\n}\n\nfunction renderHtmlAttribute([name, value]: [string, ShopifyAttributeValue]): string | undefined {\n  if (value === false) return;\n\n  const serializedName = name.toLowerCase();\n  if (value === true) return serializedName;\n\n  return `${serializedName}=\"${escapeHtmlAttribute(value)}\"`;\n}\n\nfunction escapeHtmlAttribute(value: string): string {\n  return value.replace(/&/g, \"&amp;\").replace(/\"/g, \"&quot;\");\n}\n"],"mappings":";;;;AAKA,SAAgB,uBAAuB,EACrC,SACA,YACA,aACqC;CACrC,MAAM,uBAAuB,OAAO,QAAQ,cAAc,EAAE,CAAC,CAC1D,IAAI,oBAAoB,CACxB,QAAQ,cAAmC,QAAQ,UAAU,CAAC,CAC9D,KAAK,IAAI;CACZ,MAAM,aAAa,uBAAuB,IAAI,QAAQ,GAAG,qBAAqB,KAAK,IAAI,QAAQ;AAE/F,KAAI,YAAY,OAAQ,QAAO;AAE/B,QAAO,GAAG,aAAa,aAAa,GAAG;;AAGzC,SAAS,oBAAoB,CAAC,MAAM,QAA6D;AAC/F,KAAI,UAAU,MAAO;CAErB,MAAM,iBAAiB,KAAK,aAAa;AACzC,KAAI,UAAU,KAAM,QAAO;AAE3B,QAAO,GAAG,eAAe,IAAI,oBAAoB,MAAM,CAAC;;AAG1D,SAAS,oBAAoB,OAAuB;AAClD,QAAO,MAAM,QAAQ,MAAM,QAAQ,CAAC,QAAQ,MAAM,SAAS"}