@shopify/hydrogen 2026.4.4 → 2026.10.0-preview.1

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

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

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

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

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

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

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

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

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

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

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