@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/core/analytics/cart-tracker.mjs

@@ -0,0 +1,144 @@
+import { AnalyticsEvent } from "./events.mjs";
+import { flattenConnection } from "./utils/flatten-connection.mjs";
+
+//#region src/core/analytics/cart-tracker.ts
+function trackCartAnalytics(store) {
+	const analytics = getGlobalAnalytics();
+	const state = {
+		prevCart: toAnalyticsCart(store.getState()),
+		lastEventId: null
+	};
+	if (state.prevCart) syncShopifyCurrency(state.prevCart);
+	return store.subscribe((cartState) => {
+		const cart = toAnalyticsCart(cartState);
+		if (!cart) return;
+		trackCartChange(analytics, state, cart);
+	});
+}
+function trackCartChange(analytics, state, cart) {
+	if (!cart || !cart.updatedAt) return;
+	syncShopifyCurrency(cart);
+	if (cart.updatedAt === state.prevCart?.updatedAt) return;
+	let cartLastUpdatedAt;
+	try {
+		cartLastUpdatedAt = JSON.parse(localStorage.getItem("cartLastUpdatedAt") || "");
+	} catch {
+		cartLastUpdatedAt = null;
+	}
+	if (cart.id === cartLastUpdatedAt?.id && cart.updatedAt === cartLastUpdatedAt?.updatedAt) {
+		state.prevCart = cart;
+		return;
+	}
+	if (cart.updatedAt === state.lastEventId) return;
+	state.lastEventId = cart.updatedAt;
+	const config = analytics.getConfig();
+	const payload = {
+		eventTimestamp: Date.now(),
+		cart,
+		prevCart: state.prevCart,
+		shop: config.shop,
+		customData: config.customData
+	};
+	analytics.publish(AnalyticsEvent.CART_UPDATED, payload);
+	try {
+		localStorage.setItem("cartLastUpdatedAt", JSON.stringify({
+			id: cart.id,
+			updatedAt: cart.updatedAt
+		}));
+	} catch {}
+	const previousCartLines = flattenConnection(state.prevCart?.lines);
+	const currentCartLines = flattenConnection(cart.lines);
+	previousCartLines.forEach((prevLine) => {
+		const matchedLineId = currentCartLines.filter((line) => prevLine.id === line.id);
+		if (matchedLineId.length === 1) {
+			const matchedLine = matchedLineId[0];
+			if (prevLine.quantity < matchedLine.quantity) analytics.publish(AnalyticsEvent.PRODUCT_ADD_TO_CART, {
+				...payload,
+				prevLine,
+				currentLine: matchedLine
+			});
+			else if (prevLine.quantity > matchedLine.quantity) analytics.publish(AnalyticsEvent.PRODUCT_REMOVED_FROM_CART, {
+				...payload,
+				prevLine,
+				currentLine: matchedLine
+			});
+		} else analytics.publish(AnalyticsEvent.PRODUCT_REMOVED_FROM_CART, {
+			...payload,
+			prevLine
+		});
+	});
+	currentCartLines.forEach((line) => {
+		const matchedLineId = previousCartLines.filter((previousLine) => line.id === previousLine.id);
+		if (!matchedLineId || matchedLineId.length === 0) analytics.publish(AnalyticsEvent.PRODUCT_ADD_TO_CART, {
+			...payload,
+			currentLine: line
+		});
+	});
+	state.prevCart = cart;
+}
+function getGlobalAnalytics() {
+	const analytics = typeof window !== "undefined" ? window.Shopify?.analytics : void 0;
+	if (!analytics) throw new Error("Shopify analytics bus is not available. Render ShopifyScripts before calling trackCartAnalytics().");
+	return analytics;
+}
+function toAnalyticsCart(state) {
+	const cart = state.data;
+	if (!cart.id || hasPendingCartWork(state)) return null;
+	return {
+		id: cart.id,
+		updatedAt: getCartUpdatedAt(cart),
+		cost: cart.cost,
+		lines: { nodes: cart.lines.nodes.flatMap((line) => {
+			const merchandise = line.merchandise;
+			if (!merchandise) return [];
+			const product = merchandise.product;
+			const productId = typeof product.id === "string" ? product.id : "";
+			const vendor = typeof product.vendor === "string" ? product.vendor : "";
+			const productType = typeof product.productType === "string" ? product.productType : void 0;
+			return [{
+				id: line.id,
+				quantity: line.quantity,
+				merchandise: {
+					id: merchandise.id,
+					title: merchandise.title ?? product.title,
+					price: line.cost.amountPerQuantity,
+					sku: typeof merchandise.sku === "string" ? merchandise.sku : null,
+					product: {
+						id: productId,
+						title: product.title,
+						vendor,
+						productType,
+						handle: product.handle
+					}
+				}
+			}];
+		}) }
+	};
+}
+function hasPendingCartWork({ pending, revalidating }) {
+	const hasPendingCost = pending.cost ?? (pending.lines.size > 0 || pending.discountCodes.size > 0);
+	return revalidating === true || hasPendingCost || pending.note || pending.attributes;
+}
+function getCartUpdatedAt(cart) {
+	return typeof cart.updatedAt === "string" ? cart.updatedAt : (/* @__PURE__ */ new Date()).toISOString();
+}
+function syncShopifyCurrency(cart) {
+	if (typeof window === "undefined") return;
+	const currencyCode = getCartCurrencyCode(cart);
+	if (!currencyCode) return;
+	const normalizedCurrencyCode = currencyCode.toUpperCase();
+	const shopifyWindow = window;
+	const shopify = shopifyWindow.Shopify ??= {};
+	if (shopify.currency?.active === normalizedCurrencyCode) return;
+	shopify.currency = { active: normalizedCurrencyCode };
+}
+function getCartCurrencyCode(cart) {
+	return nonEmptyCurrencyCode(cart.cost?.totalAmount?.currencyCode) ?? nonEmptyCurrencyCode(cart.cost?.subtotalAmount?.currencyCode) ?? flattenConnection(cart.lines).find((line) => line.merchandise.price.currencyCode)?.merchandise.price.currencyCode;
+}
+function nonEmptyCurrencyCode(currencyCode) {
+	return currencyCode || void 0;
+}
+
+//#endregion
+export { trackCartAnalytics };
+//# sourceMappingURL=cart-tracker.mjs.map

package/dist/core/analytics/cart-tracker.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cart-tracker.mjs","names":[],"sources":["../../../src/core/analytics/cart-tracker.ts"],"sourcesContent":["import type { CartStore } from \"../cart/cart\";\nimport type { CartData, CartState } from \"../cart/state\";\nimport { AnalyticsEvent } from \"./events\";\nimport type {\n  AnalyticsCart,\n  AnalyticsCartLine,\n  CartUpdatePayload,\n  StorefrontAnalytics,\n} from \"./types\";\nimport { flattenConnection } from \"./utils/flatten-connection\";\n\ntype CartTrackerAnalytics = Pick<StorefrontAnalytics, \"publish\" | \"getConfig\">;\ntype CartAnalyticsStore = Pick<CartStore, \"getState\" | \"subscribe\">;\n\ntype CartStorage = {\n  updatedAt: string;\n  id: string;\n};\n\ntype CartTrackerState = {\n  prevCart: AnalyticsCart | null;\n  lastEventId: string | null;\n};\n\nexport function trackCartAnalytics(store: CartAnalyticsStore): () => void {\n  const analytics = getGlobalAnalytics();\n  const state: CartTrackerState = {\n    prevCart: toAnalyticsCart(store.getState()),\n    lastEventId: null,\n  };\n\n  if (state.prevCart) syncShopifyCurrency(state.prevCart);\n\n  return store.subscribe((cartState) => {\n    const cart = toAnalyticsCart(cartState);\n    if (!cart) return;\n\n    trackCartChange(analytics, state, cart);\n  });\n}\n\nfunction trackCartChange(\n  analytics: CartTrackerAnalytics,\n  state: CartTrackerState,\n  cart: AnalyticsCart,\n): void {\n  if (!cart || !cart.updatedAt) return;\n\n  syncShopifyCurrency(cart);\n\n  if (cart.updatedAt === state.prevCart?.updatedAt) return;\n\n  let cartLastUpdatedAt: CartStorage | null;\n  try {\n    cartLastUpdatedAt = JSON.parse(localStorage.getItem(\"cartLastUpdatedAt\") || \"\");\n  } catch {\n    cartLastUpdatedAt = null;\n  }\n\n  if (cart.id === cartLastUpdatedAt?.id && cart.updatedAt === cartLastUpdatedAt?.updatedAt) {\n    state.prevCart = cart;\n    return;\n  }\n\n  if (cart.updatedAt === state.lastEventId) return;\n  state.lastEventId = cart.updatedAt;\n\n  const config = analytics.getConfig();\n  const payload: CartUpdatePayload = {\n    eventTimestamp: Date.now(),\n    cart,\n    prevCart: state.prevCart,\n    shop: config.shop,\n    customData: config.customData,\n  };\n\n  analytics.publish(AnalyticsEvent.CART_UPDATED, payload);\n\n  try {\n    localStorage.setItem(\n      \"cartLastUpdatedAt\",\n      JSON.stringify({ id: cart.id, updatedAt: cart.updatedAt }),\n    );\n  } catch {\n    // Safari private browsing or storage quota exceeded; analytics\n    // deduplication will rely on in-memory prevCart only for this session.\n  }\n\n  const previousCartLines = flattenConnection<AnalyticsCartLine>(state.prevCart?.lines);\n  const currentCartLines = flattenConnection<AnalyticsCartLine>(cart.lines);\n\n  previousCartLines.forEach((prevLine) => {\n    const matchedLineId = currentCartLines.filter((line) => prevLine.id === line.id);\n    if (matchedLineId.length === 1) {\n      const matchedLine = matchedLineId[0];\n      if (prevLine.quantity < matchedLine.quantity) {\n        analytics.publish(AnalyticsEvent.PRODUCT_ADD_TO_CART, {\n          ...payload,\n          prevLine,\n          currentLine: matchedLine,\n        });\n      } else if (prevLine.quantity > matchedLine.quantity) {\n        analytics.publish(AnalyticsEvent.PRODUCT_REMOVED_FROM_CART, {\n          ...payload,\n          prevLine,\n          currentLine: matchedLine,\n        });\n      }\n    } else {\n      analytics.publish(AnalyticsEvent.PRODUCT_REMOVED_FROM_CART, {\n        ...payload,\n        prevLine,\n      });\n    }\n  });\n\n  currentCartLines.forEach((line) => {\n    const matchedLineId = previousCartLines.filter((previousLine) => line.id === previousLine.id);\n    if (!matchedLineId || matchedLineId.length === 0) {\n      analytics.publish(AnalyticsEvent.PRODUCT_ADD_TO_CART, {\n        ...payload,\n        currentLine: line,\n      });\n    }\n  });\n\n  state.prevCart = cart;\n}\n\nfunction getGlobalAnalytics(): CartTrackerAnalytics {\n  const analytics = typeof window !== \"undefined\" ? window.Shopify?.analytics : undefined;\n  if (!analytics) {\n    throw new Error(\n      \"Shopify analytics bus is not available. Render ShopifyScripts before calling trackCartAnalytics().\",\n    );\n  }\n\n  return analytics;\n}\n\nfunction toAnalyticsCart(state: CartState): AnalyticsCart | null {\n  const cart = state.data;\n  if (!cart.id || hasPendingCartWork(state)) return null;\n\n  return {\n    id: cart.id,\n    updatedAt: getCartUpdatedAt(cart),\n    cost: cart.cost,\n    lines: {\n      nodes: cart.lines.nodes.flatMap((line): AnalyticsCartLine[] => {\n        const merchandise = line.merchandise;\n        if (!merchandise) return [];\n\n        const product = merchandise.product;\n        const productId = typeof product.id === \"string\" ? product.id : \"\";\n        const vendor = typeof product.vendor === \"string\" ? product.vendor : \"\";\n        const productType =\n          typeof product.productType === \"string\" ? product.productType : undefined;\n\n        return [\n          {\n            id: line.id,\n            quantity: line.quantity,\n            merchandise: {\n              id: merchandise.id,\n              title: merchandise.title ?? product.title,\n              price: line.cost.amountPerQuantity,\n              sku: typeof merchandise.sku === \"string\" ? merchandise.sku : null,\n              product: {\n                id: productId,\n                title: product.title,\n                vendor,\n                productType,\n                handle: product.handle,\n              },\n            },\n          },\n        ];\n      }),\n    },\n  };\n}\n\nfunction hasPendingCartWork({ pending, revalidating }: CartState): boolean {\n  const hasPendingCost = pending.cost ?? (pending.lines.size > 0 || pending.discountCodes.size > 0);\n  return revalidating === true || hasPendingCost || pending.note || pending.attributes;\n}\n\nfunction getCartUpdatedAt(cart: CartData): string {\n  return typeof cart.updatedAt === \"string\" ? cart.updatedAt : new Date().toISOString();\n}\n\nfunction syncShopifyCurrency(cart: AnalyticsCart): void {\n  if (typeof window === \"undefined\") return;\n\n  const currencyCode = getCartCurrencyCode(cart);\n  if (!currencyCode) return;\n\n  const normalizedCurrencyCode = currencyCode.toUpperCase();\n  const shopifyWindow: { Shopify?: { currency?: { active: string } } } = window;\n  const shopify = (shopifyWindow.Shopify ??= {});\n  if (shopify.currency?.active === normalizedCurrencyCode) return;\n\n  shopify.currency = { active: normalizedCurrencyCode };\n}\n\nfunction getCartCurrencyCode(cart: AnalyticsCart): string | undefined {\n  return (\n    nonEmptyCurrencyCode(cart.cost?.totalAmount?.currencyCode) ??\n    nonEmptyCurrencyCode(cart.cost?.subtotalAmount?.currencyCode) ??\n    flattenConnection<AnalyticsCartLine>(cart.lines).find(\n      (line) => line.merchandise.price.currencyCode,\n    )?.merchandise.price.currencyCode\n  );\n}\n\nfunction nonEmptyCurrencyCode(currencyCode: string | undefined): string | undefined {\n  return currencyCode || undefined;\n}\n"],"mappings":"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"}

package/dist/core/analytics/events.d.mts

@@ -0,0 +1,15 @@
+//#region src/core/analytics/events.d.ts
+declare const AnalyticsEvent: {
+  PAGE_VIEWED: "page_viewed";
+  PRODUCT_VIEWED: "product_viewed";
+  COLLECTION_VIEWED: "collection_viewed";
+  CART_VIEWED: "cart_viewed";
+  SEARCH_VIEWED: "search_viewed";
+  CART_UPDATED: "cart_updated";
+  PRODUCT_ADD_TO_CART: "product_added_to_cart";
+  PRODUCT_REMOVED_FROM_CART: "product_removed_from_cart";
+};
+type AnalyticsEventName = (typeof AnalyticsEvent)[keyof typeof AnalyticsEvent];
+//#endregion
+export { AnalyticsEvent, AnalyticsEventName };
+//# sourceMappingURL=events.d.mts.map

package/dist/core/analytics/events.mjs

@@ -0,0 +1,15 @@
+//#region src/core/analytics/events.ts
+const AnalyticsEvent = {
+	PAGE_VIEWED: "page_viewed",
+	PRODUCT_VIEWED: "product_viewed",
+	COLLECTION_VIEWED: "collection_viewed",
+	CART_VIEWED: "cart_viewed",
+	SEARCH_VIEWED: "search_viewed",
+	CART_UPDATED: "cart_updated",
+	PRODUCT_ADD_TO_CART: "product_added_to_cart",
+	PRODUCT_REMOVED_FROM_CART: "product_removed_from_cart"
+};
+
+//#endregion
+export { AnalyticsEvent };
+//# sourceMappingURL=events.mjs.map

package/dist/core/analytics/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","names":[],"sources":["../../../src/core/analytics/events.ts"],"sourcesContent":["export const AnalyticsEvent = {\n  PAGE_VIEWED: \"page_viewed\" as const,\n  PRODUCT_VIEWED: \"product_viewed\" as const,\n  COLLECTION_VIEWED: \"collection_viewed\" as const,\n  CART_VIEWED: \"cart_viewed\" as const,\n  SEARCH_VIEWED: \"search_viewed\" as const,\n\n  CART_UPDATED: \"cart_updated\" as const,\n  PRODUCT_ADD_TO_CART: \"product_added_to_cart\" as const,\n  PRODUCT_REMOVED_FROM_CART: \"product_removed_from_cart\" as const,\n};\n\nexport type AnalyticsEventName = (typeof AnalyticsEvent)[keyof typeof AnalyticsEvent];\n"],"mappings":";AAAA,MAAa,iBAAiB;CAC5B,aAAa;CACb,gBAAgB;CAChB,mBAAmB;CACnB,aAAa;CACb,eAAe;CAEf,cAAc;CACd,qBAAqB;CACrB,2BAA2B;CAC5B"}

package/dist/core/analytics/index.d.mts

@@ -0,0 +1,3 @@
+import { trackCartAnalytics } from "./cart-tracker.mjs";
+import { AnalyticsEvent, AnalyticsEventName } from "./events.mjs";
+import { AnalyticsCart, AnalyticsCartLine, AnalyticsEventMap, CartLineUpdatePayload, CartUpdatePayload, CartViewPayload, CollectionViewPayload, ConsentConfig, EventPayloads, OtherData, PageViewPayload, PayloadFor, ProductPayload, ProductViewPayload, SearchViewPayload, ShopAnalytics, StorefrontAnalytics, StorefrontAnalyticsConfig, StorefrontAnalyticsDestination, StorefrontAnalyticsDestinationSetupContext } from "./types.mjs";

package/dist/core/analytics/types.d.mts

@@ -0,0 +1,143 @@
+import { AnalyticsEventName } from "./events.mjs";
+import { ShopifyScriptsShop } from "../shopify-scripts/types.mjs";
+
+//#region src/core/analytics/types.d.ts
+type ShopAnalyticsBase = Pick<ShopifyScriptsShop, "shopId">;
+type ShopAnalyticsChannel = "hydrogen" | "headless";
+type ShopAnalytics = (ShopAnalyticsBase & {
+  channel: "hydrogen";
+  storefrontId: ShopifyScriptsShop["storefrontId"];
+}) | (ShopAnalyticsBase & {
+  channel: "headless";
+  storefrontId?: never;
+});
+type ConsentConfig = {
+  mode?: "default-banner" | "custom-banner" | "no-banner";
+};
+type AnalyticsCartLine = {
+  id: string;
+  quantity: number;
+  merchandise: {
+    id: string;
+    title: string;
+    price: {
+      amount: string;
+      currencyCode?: string;
+    };
+    sku?: string | null;
+    product: {
+      id: string;
+      title: string;
+      vendor: string;
+      productType?: string;
+      handle?: string;
+    };
+  };
+};
+type AnalyticsCart = {
+  id: string;
+  updatedAt: string;
+  cost?: {
+    subtotalAmount?: {
+      currencyCode?: string;
+    };
+    totalAmount?: {
+      currencyCode?: string;
+    };
+  };
+  lines: {
+    nodes?: AnalyticsCartLine[];
+    edges?: Array<{
+      node: AnalyticsCartLine;
+    }>;
+  };
+  [key: string]: unknown;
+};
+type OtherData = {
+  [key: string]: unknown;
+};
+type BasePayload = {
+  shop?: ShopAnalytics | null;
+  customData?: Record<string, unknown>;
+};
+type UrlPayload = {
+  url?: string;
+};
+type ProductPayload = {
+  id: string;
+  title: string;
+  price: string;
+  vendor: string;
+  variantId: string;
+  variantTitle: string;
+  quantity: number;
+  sku?: string | null;
+  productType?: string;
+};
+type ProductsPayload = {
+  products: Array<ProductPayload & OtherData>;
+};
+type CollectionPayload = {
+  collection: {
+    id: string;
+    handle: string;
+  };
+};
+type SearchPayload = {
+  searchTerm: string;
+  searchResults?: unknown;
+};
+type CartPayload = {
+  cart: AnalyticsCart | null;
+};
+type CartChangePayload = CartPayload & {
+  prevCart: AnalyticsCart | null;
+};
+type CartLinePayload = {
+  prevLine?: AnalyticsCartLine;
+  currentLine?: AnalyticsCartLine;
+};
+type PageViewPayload = UrlPayload & BasePayload;
+type ProductViewPayload = ProductsPayload & UrlPayload & BasePayload;
+type CollectionViewPayload = CollectionPayload & UrlPayload & BasePayload;
+type CartViewPayload = CartPayload & UrlPayload & BasePayload;
+type SearchViewPayload = SearchPayload & UrlPayload & BasePayload;
+type CartUpdatePayload = CartChangePayload & BasePayload & OtherData;
+type CartLineUpdatePayload = CartLinePayload & CartChangePayload & BasePayload & OtherData;
+type EventPayloads = PageViewPayload | ProductViewPayload | CollectionViewPayload | CartViewPayload | SearchViewPayload | CartUpdatePayload | CartLineUpdatePayload;
+interface AnalyticsEventMap {
+  page_viewed: PageViewPayload;
+  product_viewed: ProductViewPayload;
+  collection_viewed: CollectionViewPayload;
+  cart_viewed: CartViewPayload;
+  search_viewed: SearchViewPayload;
+  cart_updated: CartUpdatePayload;
+  product_added_to_cart: CartLineUpdatePayload;
+  product_removed_from_cart: CartLineUpdatePayload;
+}
+/** Resolves the payload type for a supported analytics event name. */
+type PayloadFor<E extends AnalyticsEventName> = AnalyticsEventMap[E];
+type PublishPayloadArgs<E extends AnalyticsEventName> = {} extends PayloadFor<E> ? [payload?: PayloadFor<E>] : [payload: PayloadFor<E>];
+type StorefrontAnalyticsConfig = {
+  shop: ShopAnalytics | null;
+  consent: ConsentConfig;
+  customData?: Record<string, unknown>;
+};
+type StorefrontAnalyticsDestinationSetupContext = {
+  subscribe: <E extends AnalyticsEventName>(event: E, callback: (payload: PayloadFor<E>) => void) => () => void;
+  getConfig: () => StorefrontAnalyticsConfig;
+};
+type StorefrontAnalyticsDestination = {
+  name: string;
+  setup: (context: StorefrontAnalyticsDestinationSetupContext) => void | (() => void) | Promise<void | (() => void)>;
+};
+type StorefrontAnalytics = {
+  publish: <E extends AnalyticsEventName>(event: E, ...payload: PublishPayloadArgs<E>) => void; /** Listen for live analytics events. Destination integrations should use `addDestination()`. */
+  subscribe: <E extends AnalyticsEventName>(event: E, callback: (payload: PayloadFor<E>) => void) => () => void;
+  addDestination: (destination: StorefrontAnalyticsDestination) => () => void;
+  destroy: () => void;
+  getConfig: () => StorefrontAnalyticsConfig;
+};
+//#endregion
+export { AnalyticsCart, AnalyticsCartLine, AnalyticsEventMap, CartLineUpdatePayload, CartUpdatePayload, CartViewPayload, CollectionViewPayload, ConsentConfig, EventPayloads, OtherData, PageViewPayload, PayloadFor, ProductPayload, ProductViewPayload, SearchViewPayload, ShopAnalytics, ShopAnalyticsChannel, StorefrontAnalytics, StorefrontAnalyticsConfig, StorefrontAnalyticsDestination, StorefrontAnalyticsDestinationSetupContext };
+//# sourceMappingURL=types.d.mts.map

package/dist/core/analytics/utils/flatten-connection.d.mts

@@ -0,0 +1,19 @@
+//#region src/core/analytics/utils/flatten-connection.d.ts
+/**
+ * Normalizes Shopify's GraphQL connection format into a flat array.
+ *
+ * Shopify's Storefront API returns list fields (like cart `lines`) in a
+ * "connection" wrapper — either `{ nodes: [...] }` or `{ edges: [{ node: ... }] }`.
+ * Hydrogen queries typically use `nodes`, but queries written with the `edges`
+ * pattern are supported too.
+ */
+type Connection<T> = {
+  nodes?: T[];
+  edges?: Array<{
+    node: T;
+  }>;
+};
+declare function flattenConnection<T>(connection?: Connection<T> | null): T[];
+//#endregion
+export { flattenConnection };
+//# sourceMappingURL=flatten-connection.d.mts.map

package/dist/core/analytics/utils/flatten-connection.mjs

@@ -0,0 +1,25 @@
+import { getLogger } from "../../logging/logging.mjs";
+
+//#region src/core/analytics/utils/flatten-connection.ts
+/**
+* Normalizes Shopify's GraphQL connection format into a flat array.
+*
+* Shopify's Storefront API returns list fields (like cart `lines`) in a
+* "connection" wrapper — either `{ nodes: [...] }` or `{ edges: [{ node: ... }] }`.
+* Hydrogen queries typically use `nodes`, but queries written with the `edges`
+* pattern are supported too.
+*/
+const log = getLogger("analytics");
+function flattenConnection(connection) {
+	if (!connection) {
+		if (connection === null) log.warn("received null connection; expected an object with `nodes` or `edges`");
+		return [];
+	}
+	if ("nodes" in connection && connection.nodes) return connection.nodes;
+	if ("edges" in connection && Array.isArray(connection.edges)) return connection.edges.map((edge) => edge.node);
+	return [];
+}
+
+//#endregion
+export { flattenConnection };
+//# sourceMappingURL=flatten-connection.mjs.map

package/dist/core/analytics/utils/flatten-connection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-connection.mjs","names":[],"sources":["../../../../src/core/analytics/utils/flatten-connection.ts"],"sourcesContent":["/**\n * Normalizes Shopify's GraphQL connection format into a flat array.\n *\n * Shopify's Storefront API returns list fields (like cart `lines`) in a\n * \"connection\" wrapper — either `{ nodes: [...] }` or `{ edges: [{ node: ... }] }`.\n * Hydrogen queries typically use `nodes`, but queries written with the `edges`\n * pattern are supported too.\n */\n\nimport { getLogger } from \"../../logging\";\n\nconst log = getLogger(\"analytics\");\n\ntype Connection<T> = {\n  nodes?: T[];\n  edges?: Array<{ node: T }>;\n};\n\nexport function flattenConnection<T>(connection?: Connection<T> | null): T[] {\n  if (!connection) {\n    if (connection === null) {\n      log.warn(\"received null connection; expected an object with `nodes` or `edges`\");\n    }\n    return [];\n  }\n\n  if (\"nodes\" in connection && connection.nodes) {\n    return connection.nodes;\n  }\n\n  if (\"edges\" in connection && Array.isArray(connection.edges)) {\n    return connection.edges.map((edge) => edge.node);\n  }\n\n  return [];\n}\n"],"mappings":";;;;;;;;;;;AAWA,MAAM,MAAM,UAAU,YAAY;AAOlC,SAAgB,kBAAqB,YAAwC;AAC3E,KAAI,CAAC,YAAY;AACf,MAAI,eAAe,KACjB,KAAI,KAAK,uEAAuE;AAElF,SAAO,EAAE;;AAGX,KAAI,WAAW,cAAc,WAAW,MACtC,QAAO,WAAW;AAGpB,KAAI,WAAW,cAAc,MAAM,QAAQ,WAAW,MAAM,CAC1D,QAAO,WAAW,MAAM,KAAK,SAAS,KAAK,KAAK;AAGlD,QAAO,EAAE"}

package/dist/core/cache/cache-status.mjs

@@ -0,0 +1,17 @@
+//#region src/core/cache/cache-status.ts
+const HYDROGEN_CACHE_STATUS_PRODUCT = "Hydrogen";
+function getHydrogenCacheStatus(headers) {
+	const cacheStatus = headers.get("cache-status");
+	if (!cacheStatus) return void 0;
+	for (const member of cacheStatus.split(",")) {
+		const [product, ...parameters] = member.split(";").map((part) => part.trim());
+		if (product !== "Hydrogen") continue;
+		if (parameters.includes("hit")) return "hit";
+		if (parameters.some((parameter) => parameter.startsWith("fwd=bypass"))) return "bypass";
+		if (parameters.some((parameter) => parameter.startsWith("fwd="))) return "miss";
+	}
+}
+
+//#endregion
+export { HYDROGEN_CACHE_STATUS_PRODUCT, getHydrogenCacheStatus };
+//# sourceMappingURL=cache-status.mjs.map

package/dist/core/cache/cache-status.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-status.mjs","names":[],"sources":["../../../src/core/cache/cache-status.ts"],"sourcesContent":["export const HYDROGEN_CACHE_STATUS_PRODUCT = \"Hydrogen\";\n\ntype HydrogenCacheStatus = \"hit\" | \"miss\" | \"bypass\";\n\nexport function getHydrogenCacheStatus(headers: Headers): HydrogenCacheStatus | undefined {\n  const cacheStatus = headers.get(\"cache-status\");\n  if (!cacheStatus) return undefined;\n\n  for (const member of cacheStatus.split(\",\")) {\n    const [product, ...parameters] = member.split(\";\").map((part) => part.trim());\n    if (product !== HYDROGEN_CACHE_STATUS_PRODUCT) continue;\n\n    if (parameters.includes(\"hit\")) return \"hit\";\n    if (parameters.some((parameter) => parameter.startsWith(\"fwd=bypass\"))) return \"bypass\";\n    if (parameters.some((parameter) => parameter.startsWith(\"fwd=\"))) return \"miss\";\n  }\n\n  return undefined;\n}\n"],"mappings":";AAAA,MAAa,gCAAgC;AAI7C,SAAgB,uBAAuB,SAAmD;CACxF,MAAM,cAAc,QAAQ,IAAI,eAAe;AAC/C,KAAI,CAAC,YAAa,QAAO;AAEzB,MAAK,MAAM,UAAU,YAAY,MAAM,IAAI,EAAE;EAC3C,MAAM,CAAC,SAAS,GAAG,cAAc,OAAO,MAAM,IAAI,CAAC,KAAK,SAAS,KAAK,MAAM,CAAC;AAC7E,MAAI,uBAA2C;AAE/C,MAAI,WAAW,SAAS,MAAM,CAAE,QAAO;AACvC,MAAI,WAAW,MAAM,cAAc,UAAU,WAAW,aAAa,CAAC,CAAE,QAAO;AAC/E,MAAI,WAAW,MAAM,cAAc,UAAU,WAAW,OAAO,CAAC,CAAE,QAAO"}

package/dist/core/cache/fetch-with-cache.d.mts

@@ -0,0 +1,43 @@
+import { CacheKey } from "./key.mjs";
+import { CachingStrategy } from "./strategies.mjs";
+import { CreateRunWithCacheOptions, RunWithCache } from "./run-with-cache.mjs";
+
+//#region src/core/cache/fetch-with-cache.d.ts
+type MaybePromise<T> = T | Promise<T>;
+type FetchInput = Parameters<typeof fetch>[0];
+type FetchInit = Parameters<typeof fetch>[1];
+type FetchCacheResponseContext = {
+  ok: boolean;
+  status: number;
+  statusText: string;
+  headers: Headers;
+  url: string;
+  text(): Promise<string>;
+  json?: () => Promise<unknown>;
+};
+type FetchCacheOptions = {
+  key: CacheKey;
+  strategy: CachingStrategy;
+  annotateCacheStatus?: boolean;
+  /**
+   * Runs only for OK responses with text-serializable bodies. Non-OK responses
+   * and binary/streaming responses are never cached.
+   */
+  shouldCacheResponse?: (context: FetchCacheResponseContext) => MaybePromise<boolean>;
+};
+type FetchWithCache = {
+  (input: FetchInput, init?: FetchInit): Promise<Response>;
+  (input: FetchInput, init: FetchInit | undefined, options: FetchCacheOptions): Promise<Response>;
+};
+type CreateFetchWithCacheOptions = (CreateRunWithCacheOptions | {
+  runWithCache: RunWithCache;
+}) & {
+  fetch?: typeof fetch;
+};
+declare function createFetchWithCache({
+  fetch: customFetch,
+  ...options
+}: CreateFetchWithCacheOptions): FetchWithCache;
+//#endregion
+export { createFetchWithCache };
+//# sourceMappingURL=fetch-with-cache.d.mts.map

package/dist/core/cache/fetch-with-cache.mjs

@@ -0,0 +1,188 @@
+import { HYDROGEN_CACHE_STATUS_PRODUCT } from "./cache-status.mjs";
+import { NO_STORE } from "./strategies.mjs";
+import { StaleFallbackDisabledError, createRunWithCache } from "./run-with-cache.mjs";
+
+//#region src/core/cache/fetch-with-cache.ts
+const excludedCachedResponseHeaders = new Set(["set-cookie", "server-timing"]);
+const staleIfErrorStatuses = new Set([
+	500,
+	502,
+	503,
+	504
+]);
+var UnserializableResponseError = class extends StaleFallbackDisabledError {
+	constructor() {
+		super("Response body is not serializable for cache.");
+	}
+};
+var StaleFallbackEligibleResponseError = class extends Error {
+	constructor() {
+		super("Origin returned an unserializable response eligible for stale-if-error fallback.");
+	}
+};
+var ServerResponseError = class extends Error {
+	response;
+	constructor(response) {
+		super("Origin returned a response eligible for stale-if-error fallback.");
+		this.response = response;
+	}
+};
+function createFetchWithCache({ fetch: customFetch, ...options }) {
+	const resolvedFetch = customFetch ?? globalThis.fetch;
+	const runWithCache = "runWithCache" in options ? options.runWithCache : createRunWithCache(options);
+	return async function fetchWithCache(input, init, cacheOptions) {
+		if (!cacheOptions) return resolvedFetch(input, init);
+		if (cacheOptions.strategy.mode === "no-store") return annotateResponse(await resolvedFetch(input, init), getCacheStatusHeader("fwd=bypass"), cacheOptions);
+		let passthroughResponse;
+		let result;
+		try {
+			result = await runWithCache({
+				key: cacheOptions.key,
+				strategy: cacheOptions.strategy
+			}, async () => {
+				const response = await resolvedFetch(input, init);
+				if (!response.ok) {
+					if (isStaleIfErrorStatus(response.status)) {
+						if (!canSerializeBodyAsText(response)) {
+							passthroughResponse = response;
+							throw new StaleFallbackEligibleResponseError();
+						}
+						throw new ServerResponseError(await serializeResponse(response, {
+							cacheable: false,
+							fallbackOnError: true
+						}));
+					}
+					return {
+						data: await serializeResponse(response, {
+							cacheable: false,
+							fallbackOnError: true
+						}),
+						shouldCache: false
+					};
+				}
+				if (!canSerializeBodyAsText(response)) {
+					passthroughResponse = response;
+					throw new UnserializableResponseError();
+				}
+				const bodyReader = createBodyReader(response);
+				if (!await shouldCacheResponse(response, bodyReader, cacheOptions)) return {
+					data: await serializeResponse(response, {
+						bodyReader,
+						cacheable: false,
+						fallbackOnError: true
+					}),
+					shouldCache: false
+				};
+				const data = await serializeResponse(response, {
+					bodyReader,
+					cacheable: true,
+					fallbackOnError: true
+				});
+				return {
+					data,
+					shouldCache: data.cacheable
+				};
+			});
+		} catch (error) {
+			if (error instanceof ServerResponseError) return annotateResponse(fromSerializableResponse(error.response), getCacheStatusHeader("fwd=bypass"), cacheOptions);
+			if (error instanceof UnserializableResponseError) return annotateResponse(passthroughResponse ?? await resolvedFetch(input, init), getCacheStatusHeader("fwd=bypass"), cacheOptions);
+			if (error instanceof StaleFallbackEligibleResponseError) return annotateResponse(passthroughResponse ?? await resolvedFetch(input, init), getCacheStatusHeader("fwd=bypass"), cacheOptions);
+			throw error;
+		}
+		return annotateResponse(fromSerializableResponse(result.data), result.cacheStatus === "hit" ? getCacheStatusHeader("hit") : getNonHitCacheStatusHeader(result.data.cacheable, result.cacheStatus), cacheOptions);
+	};
+}
+function shouldCacheResponse(response, bodyReader, options) {
+	const context = {
+		ok: response.ok,
+		status: response.status,
+		statusText: response.statusText,
+		headers: new Headers(response.headers),
+		url: response.url,
+		text: bodyReader.text
+	};
+	if (isJsonResponse(response)) context.json = bodyReader.json;
+	return options.shouldCacheResponse?.(context) ?? true;
+}
+function createBodyReader(response) {
+	let bodyText;
+	let bodyJson;
+	const text = () => {
+		bodyText ??= response.text();
+		return bodyText;
+	};
+	return {
+		text,
+		json() {
+			bodyJson ??= text().then((value) => JSON.parse(value));
+			return bodyJson;
+		}
+	};
+}
+async function serializeResponse(response, { bodyReader, cacheable, fallbackOnError = false }) {
+	if (!canSerializeBodyAsText(response)) return emptySerializableResponse(response);
+	try {
+		return {
+			body: await (bodyReader ?? createBodyReader(response)).text(),
+			cacheable,
+			headers: getSerializableHeaders(response.headers, cacheable),
+			status: response.status,
+			statusText: response.statusText
+		};
+	} catch (error) {
+		if (!fallbackOnError) throw error;
+		return emptySerializableResponse(response);
+	}
+}
+function fromSerializableResponse(response) {
+	return new Response(response.body, {
+		headers: response.headers,
+		status: response.status,
+		statusText: response.statusText
+	});
+}
+function emptySerializableResponse(response) {
+	return {
+		body: "",
+		cacheable: false,
+		headers: [],
+		status: response.status,
+		statusText: response.statusText
+	};
+}
+function getSerializableHeaders(headers, cacheable) {
+	if (!cacheable) return [...headers];
+	return [...headers].filter(([key]) => !excludedCachedResponseHeaders.has(key.toLowerCase()));
+}
+function annotateResponse(response, cacheStatus, options) {
+	if (options.annotateCacheStatus === false) return response;
+	const headers = new Headers(response.headers);
+	headers.append("Cache-Status", cacheStatus);
+	return new Response(response.body, {
+		headers,
+		status: response.status,
+		statusText: response.statusText
+	});
+}
+function getNonHitCacheStatusHeader(shouldCache, cacheStatus) {
+	if (cacheStatus === "bypass") return getCacheStatusHeader("fwd=bypass");
+	return shouldCache ? getCacheStatusHeader("fwd=uri-miss; stored") : getCacheStatusHeader("fwd=bypass");
+}
+function getCacheStatusHeader(value) {
+	return `${HYDROGEN_CACHE_STATUS_PRODUCT}; ${value}`;
+}
+function isJsonResponse(response) {
+	return response.headers.get("content-type")?.toLowerCase().includes("json") ?? false;
+}
+function isStaleIfErrorStatus(status) {
+	return staleIfErrorStatuses.has(status);
+}
+function canSerializeBodyAsText(response) {
+	if (response.body == null) return true;
+	const contentType = response.headers.get("content-type");
+	return contentType != null && /\b(json|text|xml|html|graphql|javascript)\b/i.test(contentType);
+}
+
+//#endregion
+export { createFetchWithCache };
+//# sourceMappingURL=fetch-with-cache.mjs.map