@shopify/hydrogen 2026.4.5 → 2026.10.0-preview.2

package/dist/core/collection/url.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.mjs","names":[],"sources":["../../../src/core/collection/url.ts"],"sourcesContent":["import type { ProductFilter } from \"../../../vendor/standard-events\";\nimport type { ProductCollectionSortKeys } from \"../../graphql/generated/storefront-api-types\";\nimport type { CollectionState } from \"./state\";\n\n/**\n * Parsed collection URL parameters — the subset of {@link CollectionState}\n * that is derived from the URL query string.\n */\nexport interface CollectionParams {\n  filters: ProductFilter[];\n  sortKey: ProductCollectionSortKeys | undefined;\n  reverse: boolean;\n}\n\nconst SORT_BY_DESCENDING_SUFFIX = \"-descending\";\nconst SORT_BY_ASCENDING_SUFFIX = \"-ascending\";\nconst PAGINATION_CURSOR_PARAMS: readonly string[] = [\"before\", \"after\"];\n\nconst SORT_KEY_TO_SORT_BY: Record<string, string> = {\n  BEST_SELLING: \"best-selling\",\n  CREATED: \"created\",\n  PRICE: \"price\",\n  TITLE: \"title\",\n  MANUAL: \"manual\",\n  ID: \"id\",\n  RELEVANCE: \"relevance\",\n  COLLECTION_DEFAULT: \"collection-default\",\n};\n\nconst SORT_BY_TO_SORT_KEY: Record<string, ProductCollectionSortKeys> = Object.fromEntries(\n  Object.entries(SORT_KEY_TO_SORT_BY).map(([key, value]) => [\n    value,\n    key as ProductCollectionSortKeys,\n  ]),\n);\n\nconst STANDARD_EVENTS_COLLECTION_SORT_KEY: Record<string, ProductCollectionSortKeys> = {\n  \"best-selling\": \"BEST_SELLING\",\n  \"created-ascending\": \"CREATED\",\n  \"created-descending\": \"CREATED\",\n  \"price-ascending\": \"PRICE\",\n  \"price-descending\": \"PRICE\",\n  \"title-ascending\": \"TITLE\",\n  \"title-descending\": \"TITLE\",\n  manual: \"MANUAL\",\n};\n\n/**\n * Extracts collection state from URL search params.\n *\n * Handles Liquid-compatible filter keys (`filter.p.*`, `filter.v.*`)\n * and the `sort_by` param (with optional `-descending`/`-ascending` suffix).\n *\n * @param searchParams - URL search params to parse\n */\nexport function parseCollectionParams(searchParams: URLSearchParams): CollectionParams {\n  const filters = parseProductFilters(searchParams);\n  const sortKey = parseCollectionSortKey(searchParams);\n  const rawSortBy = searchParams.get(\"sort_by\");\n  const reverse = rawSortBy?.endsWith(SORT_BY_DESCENDING_SUFFIX) ?? false;\n\n  return { filters, sortKey, reverse };\n}\n\n/**\n * Serializes collection state into URL search params using Liquid-compatible keys.\n *\n * Only emits store-owned keys (`filter.*`, `sort_by`).\n * Omits `sort_by` when `sortKey` is `undefined` (collection default).\n *\n * @param state - The filter/sort slice of collection state\n */\nexport function serializeCollectionParams(\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): URLSearchParams {\n  const params = new URLSearchParams();\n\n  for (const filter of state.filters) {\n    serializeFilter(params, filter);\n  }\n\n  if (state.sortKey) {\n    params.set(\"sort_by\", getSortByValue(state.sortKey, state.reverse));\n  }\n\n  return params;\n}\n\n/** Returns `true` when the param key is owned by the collection store. */\nexport function isStoreOwnedParam(key: string): boolean {\n  return key === \"sort_by\" || key.startsWith(\"filter.\");\n}\n\n/** Normalizes a router search string for comparison (strips a leading `?`). */\nexport function normalizeCollectionSearch(search: string): string {\n  return search.startsWith(\"?\") ? search.slice(1) : search;\n}\n\n/**\n * Merges store-owned params from `state` into `existing`, preserving\n * unrelated keys (e.g. `grid`, `view`) already present in the URL. Collection\n * pagination cursors (`before`, `after`) are cleared so changed browse intent\n * starts from the first page.\n */\nexport function mergeCollectionParams(\n  existing: URLSearchParams,\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): URLSearchParams {\n  const merged = new URLSearchParams(existing);\n\n  for (const key of Array.from(merged.keys())) {\n    if (isStoreOwnedParam(key)) {\n      merged.delete(key);\n    }\n  }\n\n  clearPaginationCursors(merged);\n\n  for (const [key, value] of serializeCollectionParams(state)) {\n    merged.append(key, value);\n  }\n\n  return merged;\n}\n\n/** Returns `true` when two router search strings describe the same collection filters and sort. */\nexport function collectionSearchEqual(a: string, b: string): boolean {\n  const parsedA = parseCollectionParams(new URLSearchParams(normalizeCollectionSearch(a)));\n  const parsedB = parseCollectionParams(new URLSearchParams(normalizeCollectionSearch(b)));\n\n  return (\n    parsedA.sortKey === parsedB.sortKey &&\n    parsedA.reverse === parsedB.reverse &&\n    filtersEqual(parsedA.filters, parsedB.filters)\n  );\n}\n\n/** Returns `true` when URL params and collection browse state describe the same filters and sort. */\nexport function collectionParamsMatchState(\n  searchParams: URLSearchParams,\n  state: Pick<CollectionState, \"filters\" | \"sortKey\" | \"reverse\">,\n): boolean {\n  const parsed = parseCollectionParams(searchParams);\n\n  return (\n    parsed.sortKey === state.sortKey &&\n    parsed.reverse === state.reverse &&\n    filtersEqual(parsed.filters, state.filters)\n  );\n}\n\n/**\n * Builds a URL query string with the given filter removed from the current params.\n *\n * Clears pagination cursors so the changed filter state starts from its first page.\n * Returns `\"?\"` when removing the filter leaves no params. Useful for\n * rendering \"remove filter\" links without updating store state.\n */\nexport function getFilterRemovalUrl(currentParams: URLSearchParams, filter: ProductFilter): string {\n  const result = new URLSearchParams(currentParams);\n  removeFilterParams(result, filter);\n  clearPaginationCursors(result);\n  const serialized = result.toString();\n  return serialized ? `?${serialized}` : \"?\";\n}\n\n/** Returns `true` when the sort key supports ascending/descending direction suffixes. */\nexport function isDirectionalSortKey(sortKey: ProductCollectionSortKeys): boolean {\n  return sortKey === \"PRICE\" || sortKey === \"TITLE\" || sortKey === \"CREATED\" || sortKey === \"ID\";\n}\n\n/**\n * Converts a Storefront API sort key and direction into the Liquid-compatible\n * `sort_by` param value (e.g. `\"price-ascending\"`, `\"best-selling\"`).\n *\n * Direction suffixes are only appended for sort keys that support them\n * (`PRICE`, `TITLE`, `CREATED`, `ID`). Others (like `BEST_SELLING`) return\n * the base value regardless of the `reverse` flag.\n *\n * @param sortKey - Storefront API `ProductCollectionSortKeys` enum value\n * @param reverse - `true` for descending, `false` for ascending\n */\nexport function getSortByValue(sortKey: ProductCollectionSortKeys, reverse: boolean): string {\n  const base = SORT_KEY_TO_SORT_BY[sortKey] ?? sortKey.toLowerCase();\n\n  if (!isDirectionalSortKey(sortKey)) return base;\n\n  return reverse ? `${base}-descending` : `${base}-ascending`;\n}\n\n/**\n * Parses a Liquid-compatible `sort_by` value back into the Storefront API\n * sort key and direction. Inverse of {@link getSortByValue}.\n *\n * @param value - A `sort_by` param value (e.g. `\"price-ascending\"`, `\"best-selling\"`)\n */\nexport function parseSortByValue(value: string): {\n  sortKey: ProductCollectionSortKeys | undefined;\n  reverse: boolean;\n} {\n  if (value.endsWith(SORT_BY_DESCENDING_SUFFIX)) {\n    const base = value.slice(0, -SORT_BY_DESCENDING_SUFFIX.length);\n    return { sortKey: SORT_BY_TO_SORT_KEY[base], reverse: true };\n  }\n\n  if (value.endsWith(SORT_BY_ASCENDING_SUFFIX)) {\n    const base = value.slice(0, -SORT_BY_ASCENDING_SUFFIX.length);\n    return { sortKey: SORT_BY_TO_SORT_KEY[base], reverse: false };\n  }\n\n  return { sortKey: SORT_BY_TO_SORT_KEY[value], reverse: false };\n}\n\n/**\n * Mirrors `parseProductFilters` from storefront-standard-events.\n *\n * Keep this local because Hydrogen only vendors Standard Events\n * declarations, so importing CollectionUpdateEvent would require runtime JS.\n */\nfunction parseProductFilters(searchParams: URLSearchParams): ProductFilter[] {\n  const filters: ProductFilter[] = [];\n  const price: ProductFilter[\"price\"] = {};\n  const minPrice = searchParams.get(\"filter.v.price.gte\");\n  const maxPrice = searchParams.get(\"filter.v.price.lte\");\n\n  if (minPrice) price.min = parseLocalizedNumber(minPrice);\n  if (maxPrice) price.max = parseLocalizedNumber(maxPrice);\n  if (price.min !== undefined || price.max !== undefined) filters.push({ price });\n\n  const availability = searchParams.getAll(\"filter.v.availability\");\n  const inStock = availability.includes(\"1\");\n  const outOfStock = availability.includes(\"0\");\n  if (inStock && !outOfStock) filters.push({ available: true });\n  if (outOfStock && !inStock) filters.push({ available: false });\n\n  for (const productType of searchParams.getAll(\"filter.p.product_type\")) {\n    filters.push({ productType });\n  }\n\n  for (const productVendor of searchParams.getAll(\"filter.p.vendor\")) {\n    filters.push({ productVendor });\n  }\n\n  for (const tag of searchParams.getAll(\"filter.p.tag\")) {\n    filters.push({ tag });\n  }\n\n  for (const [key, value] of searchParams) {\n    let match: RegExpMatchArray | null;\n\n    if ((match = key.match(/^filter\\.v\\.option\\.(.+)$/))) {\n      filters.push({ variantOption: { name: decodeFilterKeyPart(match[1]), value } });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.p\\.m\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        productMetafield: {\n          namespace: decodeFilterKeyPart(match[1]),\n          key: decodeFilterKeyPart(match[2]),\n          value,\n        },\n      });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.v\\.m\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        variantMetafield: {\n          namespace: decodeFilterKeyPart(match[1]),\n          key: decodeFilterKeyPart(match[2]),\n          value,\n        },\n      });\n      continue;\n    }\n\n    if ((match = key.match(/^filter\\.v\\.t\\.([^.]+)\\.(.+)$/))) {\n      filters.push({\n        taxonomyMetafield: {\n          key: `${decodeFilterKeyPart(match[1])}.${decodeFilterKeyPart(match[2])}`,\n          value,\n        },\n      });\n    }\n  }\n\n  return filters;\n}\n\n/** Mirrors `getCollectionSortKey` from storefront-standard-events. */\nfunction parseCollectionSortKey(\n  searchParams: URLSearchParams,\n): ProductCollectionSortKeys | undefined {\n  const rawSortBy = searchParams.get(\"sort_by\");\n  return rawSortBy ? STANDARD_EVENTS_COLLECTION_SORT_KEY[rawSortBy] : undefined;\n}\n\nfunction parseLocalizedNumber(value: string): number {\n  try {\n    const locale = typeof window !== \"undefined\" ? window.Shopify?.locale : undefined;\n    const parts = new Intl.NumberFormat(locale ?? \"en\").formatToParts(1234.5);\n    const group = parts.find((part) => part.type === \"group\")?.value ?? \",\";\n    const decimal = parts.find((part) => part.type === \"decimal\")?.value ?? \".\";\n    const normalized = value.split(group).join(\"\").replace(decimal, \".\");\n    const number = Number(normalized);\n    if (!Number.isNaN(number)) return number;\n  } catch {}\n\n  return Number(value.replace(/[^\\d.]/g, \"\")) || 0;\n}\n\nfunction decodeFilterKeyPart(value: string): string {\n  return decodeURIComponent(value.replace(/\\+/g, \" \"));\n}\n\nfunction getFilterParamEntries(filter: ProductFilter): Array<{ key: string; value: string }> {\n  const entries: Array<{ key: string; value: string }> = [];\n\n  if (filter.available != null) {\n    entries.push({ key: \"filter.v.availability\", value: filter.available ? \"1\" : \"0\" });\n  }\n\n  if (filter.price) {\n    if (filter.price.min != null) {\n      entries.push({ key: \"filter.v.price.gte\", value: String(filter.price.min) });\n    }\n    if (filter.price.max != null) {\n      entries.push({ key: \"filter.v.price.lte\", value: String(filter.price.max) });\n    }\n  }\n\n  if (filter.productType != null) {\n    entries.push({ key: \"filter.p.product_type\", value: filter.productType });\n  }\n\n  if (filter.productVendor != null) {\n    entries.push({ key: \"filter.p.vendor\", value: filter.productVendor });\n  }\n\n  if (filter.tag != null) {\n    entries.push({ key: \"filter.p.tag\", value: filter.tag });\n  }\n\n  if (filter.variantOption) {\n    entries.push({\n      key: `filter.v.option.${encodeURIComponent(filter.variantOption.name)}`,\n      value: filter.variantOption.value ?? \"\",\n    });\n  }\n\n  if (filter.productMetafield) {\n    const { namespace, key, value } = filter.productMetafield;\n    entries.push({\n      key: `filter.p.m.${encodeURIComponent(namespace)}.${encodeURIComponent(key)}`,\n      value: value ?? \"\",\n    });\n  }\n\n  if (filter.variantMetafield) {\n    const { namespace, key, value } = filter.variantMetafield;\n    entries.push({\n      key: `filter.v.m.${encodeURIComponent(namespace)}.${encodeURIComponent(key)}`,\n      value: value ?? \"\",\n    });\n  }\n\n  if (filter.taxonomyMetafield) {\n    const fullKey = filter.taxonomyMetafield.key;\n    const dotIdx = fullKey.indexOf(\".\");\n    const ns = dotIdx >= 0 ? fullKey.slice(0, dotIdx) : fullKey;\n    const k = dotIdx >= 0 ? fullKey.slice(dotIdx + 1) : \"\";\n    entries.push({\n      key: `filter.v.t.${encodeURIComponent(ns)}.${encodeURIComponent(k)}`,\n      value: filter.taxonomyMetafield.value,\n    });\n  }\n\n  if (filter.category) {\n    entries.push({ key: \"filter.p.category\", value: filter.category.id });\n  }\n\n  return entries;\n}\n\nfunction serializeFilter(params: URLSearchParams, filter: ProductFilter): void {\n  for (const { key, value } of getFilterParamEntries(filter)) {\n    params.append(key, value);\n  }\n}\n\nfunction removeFilterParams(params: URLSearchParams, filter: ProductFilter): void {\n  for (const { key, value } of getFilterParamEntries(filter)) {\n    removeParamValue(params, key, value);\n  }\n}\n\nfunction clearPaginationCursors(params: URLSearchParams): void {\n  for (const key of PAGINATION_CURSOR_PARAMS) {\n    params.delete(key);\n  }\n}\n\n/** Compares two individual {@link ProductFilter} objects for semantic equality. */\nexport function filterEquals(a: ProductFilter, b: ProductFilter): boolean {\n  const kindA = filterKind(a);\n  const kindB = filterKind(b);\n  if (kindA !== kindB || kindA == null) return false;\n\n  switch (kindA) {\n    case \"tag\":\n      return a.tag === b.tag;\n    case \"available\":\n      return a.available === b.available;\n    case \"price\":\n      return priceRangeEquals(a.price, b.price);\n    case \"productType\":\n      return a.productType === b.productType;\n    case \"productVendor\":\n      return a.productVendor === b.productVendor;\n    case \"variantOption\": {\n      const aOpt = a.variantOption;\n      const bOpt = b.variantOption;\n      if (aOpt == null || bOpt == null) return false;\n      return aOpt.name === bOpt.name && (aOpt.value ?? \"\") === (bOpt.value ?? \"\");\n    }\n    case \"productMetafield\": {\n      const aMeta = a.productMetafield;\n      const bMeta = b.productMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return metafieldEquals(aMeta, bMeta);\n    }\n    case \"variantMetafield\": {\n      const aMeta = a.variantMetafield;\n      const bMeta = b.variantMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return metafieldEquals(aMeta, bMeta);\n    }\n    case \"taxonomyMetafield\": {\n      const aMeta = a.taxonomyMetafield;\n      const bMeta = b.taxonomyMetafield;\n      if (aMeta == null || bMeta == null) return false;\n      return aMeta.key === bMeta.key && aMeta.value === bMeta.value;\n    }\n    case \"category\": {\n      const aCat = a.category;\n      const bCat = b.category;\n      if (aCat == null || bCat == null) return false;\n      return aCat.id === bCat.id;\n    }\n  }\n}\n\n/** Returns `true` when `input` (a Storefront API filter JSON string) matches an active filter. */\nexport function isFilterInputActive(activeFilters: ProductFilter[], input: string): boolean {\n  let parsed: ProductFilter;\n  try {\n    parsed = JSON.parse(input) as ProductFilter;\n  } catch {\n    return false;\n  }\n  return activeFilters.some((filter) => filterEquals(filter, parsed));\n}\n\nfunction filterKind(\n  filter: ProductFilter,\n):\n  | \"tag\"\n  | \"available\"\n  | \"price\"\n  | \"productType\"\n  | \"productVendor\"\n  | \"variantOption\"\n  | \"productMetafield\"\n  | \"variantMetafield\"\n  | \"taxonomyMetafield\"\n  | \"category\"\n  | null {\n  if (filter.tag != null) return \"tag\";\n  if (filter.available != null) return \"available\";\n  if (filter.price != null) return \"price\";\n  if (filter.productType != null) return \"productType\";\n  if (filter.productVendor != null) return \"productVendor\";\n  if (filter.variantOption != null) return \"variantOption\";\n  if (filter.productMetafield != null) return \"productMetafield\";\n  if (filter.variantMetafield != null) return \"variantMetafield\";\n  if (filter.taxonomyMetafield != null) return \"taxonomyMetafield\";\n  if (filter.category != null) return \"category\";\n  return null;\n}\n\nfunction priceRangeEquals(a: ProductFilter[\"price\"], b: ProductFilter[\"price\"]): boolean {\n  if (a == null || b == null) return a === b;\n  return a.min === b.min && a.max === b.max;\n}\n\nfunction metafieldEquals(\n  a: { namespace: string; key: string; value?: string },\n  b: { namespace: string; key: string; value?: string },\n): boolean {\n  return a.namespace === b.namespace && a.key === b.key && (a.value ?? \"\") === (b.value ?? \"\");\n}\n\nfunction filtersEqual(a: ProductFilter[], b: ProductFilter[]): boolean {\n  if (a.length !== b.length) return false;\n\n  const remaining = [...b];\n  for (const filter of a) {\n    const index = remaining.findIndex((candidate) => filterEquals(filter, candidate));\n    if (index === -1) return false;\n    remaining.splice(index, 1);\n  }\n\n  return true;\n}\n\nfunction removeParamValue(params: URLSearchParams, name: string, value: string): void {\n  const remaining = params.getAll(name).filter((v) => v !== value);\n  params.delete(name);\n  for (const v of remaining) {\n    params.append(name, v);\n  }\n}\n"],"mappings":"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"}

package/dist/core/constants.d.mts

@@ -0,0 +1,5 @@
+//#region src/core/constants.d.ts
+declare const CUSTOMER_ACCOUNT_API_VERSION = "2026-04";
+//#endregion
+export { CUSTOMER_ACCOUNT_API_VERSION };
+//# sourceMappingURL=constants.d.mts.map

package/dist/core/constants.mjs

@@ -0,0 +1,8 @@
+//#region src/core/constants.ts
+const STOREFRONT_API_VERSION = "2026-04";
+const CUSTOMER_ACCOUNT_API_VERSION = "2026-04";
+const DEFAULT_TIMEOUT_IN_MS = 3e4;
+
+//#endregion
+export { CUSTOMER_ACCOUNT_API_VERSION, DEFAULT_TIMEOUT_IN_MS, STOREFRONT_API_VERSION };
+//# sourceMappingURL=constants.mjs.map

package/dist/core/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","names":[],"sources":["../../src/core/constants.ts"],"sourcesContent":["export const STOREFRONT_API_VERSION = \"2026-04\";\nexport const CUSTOMER_ACCOUNT_API_VERSION = \"2026-04\";\nexport const DEFAULT_TIMEOUT_IN_MS = 30_000;\n"],"mappings":";AAAA,MAAa,yBAAyB;AACtC,MAAa,+BAA+B;AAC5C,MAAa,wBAAwB"}

package/dist/core/headers.mjs

@@ -0,0 +1,43 @@
+//#region src/core/headers.ts
+const CACHE_CONTROL_HEADER = "Cache-Control";
+const CONSENT_MANAGEMENT_HEADER = "Shopify-Storefront-Consent-Management";
+const HYDROGEN_VERSION_HEADER = "X-Hydrogen-Version";
+const SERVER_TIMING_HEADER = "Server-Timing";
+const SURROGATE_CONTROL_HEADER = "Surrogate-Control";
+const REQUEST_GROUP_ID_HEADER = "Custom-Storefront-Request-Group-ID";
+const SDK_VARIANT_HEADER = "X-SDK-Variant";
+const SDK_VARIANT_SOURCE_HEADER = "X-SDK-Variant-Source";
+const SDK_VERSION_HEADER = "X-SDK-Version";
+const SHOPIFY_STOREFRONT_ORIGIN_HEADER = "Sec-Shopify-Storefront-Origin";
+const STOREFRONT_ID_HEADER = "Shopify-Storefront-Id";
+const SHOPIFY_STOREFRONT_S_HEADER = "Shopify-Storefront-S";
+const SHOPIFY_STOREFRONT_Y_HEADER = "Shopify-Storefront-Y";
+const SHOPIFY_UNIQUE_TOKEN_HEADER = "X-Shopify-UniqueToken";
+const SHOPIFY_VISIT_TOKEN_HEADER = "X-Shopify-VisitToken";
+const STOREFRONT_ACCESS_TOKEN_HEADER = "X-Shopify-Storefront-Access-Token";
+const STOREFRONT_BUYER_IP_HEADER = "Shopify-Storefront-Buyer-IP";
+const STOREFRONT_PRIVATE_TOKEN_HEADER = "Shopify-Storefront-Private-Token";
+const STOREFRONT_URL_HEADER = "x-storefront-url";
+function defineHeaderList(...headerNames) {
+	return headerNames;
+}
+function extractHeaders(getter, allowlist) {
+	return allowlist.reduce((acc, key) => {
+		const value = getter(key);
+		if (value != null) acc.push([key, value]);
+		return acc;
+	}, []);
+}
+function applyPrivateResponseCacheHeaders(headers) {
+	headers.set(CACHE_CONTROL_HEADER, "private, no-store, max-age=0, must-revalidate");
+	for (const header of Array.from(headers.keys())) if (/^(?:.+-)?cdn-cache-control$/i.test(header) || header.toLowerCase() === "Surrogate-Control".toLowerCase()) headers.delete(header);
+}
+const COMMON_PROXY_HEADER_ALLOWLIST = defineHeaderList("accept", "accept-encoding", "accept-language", "content-type", "cookie", "origin", "referer", "user-agent");
+const SFAPI_REQUEST_HEADER_ALLOWLIST = defineHeaderList(...COMMON_PROXY_HEADER_ALLOWLIST, "content-length", "access-control-request-headers", "access-control-request-method", STOREFRONT_ACCESS_TOKEN_HEADER, STOREFRONT_PRIVATE_TOKEN_HEADER, SHOPIFY_UNIQUE_TOKEN_HEADER, SHOPIFY_VISIT_TOKEN_HEADER);
+const MCP_REQUEST_HEADER_ALLOWLIST = defineHeaderList(...COMMON_PROXY_HEADER_ALLOWLIST);
+const AJAX_API_REQUEST_HEADER_ALLOWLIST = defineHeaderList(...COMMON_PROXY_HEADER_ALLOWLIST, "content-length", "x-requested-with");
+const PROXY_REQUEST_HEADER_DENYLIST = defineHeaderList("cf-connecting-ip", "connection", "content-length", "host", "keep-alive", "proxy-authenticate", "proxy-authorization", "te", "trailer", "transfer-encoding", "upgrade");
+
+//#endregion
+export { AJAX_API_REQUEST_HEADER_ALLOWLIST, CONSENT_MANAGEMENT_HEADER, HYDROGEN_VERSION_HEADER, MCP_REQUEST_HEADER_ALLOWLIST, PROXY_REQUEST_HEADER_DENYLIST, REQUEST_GROUP_ID_HEADER, SDK_VARIANT_HEADER, SDK_VARIANT_SOURCE_HEADER, SDK_VERSION_HEADER, SERVER_TIMING_HEADER, SFAPI_REQUEST_HEADER_ALLOWLIST, SHOPIFY_STOREFRONT_ORIGIN_HEADER, SHOPIFY_STOREFRONT_S_HEADER, SHOPIFY_STOREFRONT_Y_HEADER, SHOPIFY_UNIQUE_TOKEN_HEADER, SHOPIFY_VISIT_TOKEN_HEADER, STOREFRONT_ACCESS_TOKEN_HEADER, STOREFRONT_BUYER_IP_HEADER, STOREFRONT_ID_HEADER, STOREFRONT_PRIVATE_TOKEN_HEADER, STOREFRONT_URL_HEADER, applyPrivateResponseCacheHeaders, extractHeaders };
+//# sourceMappingURL=headers.mjs.map

package/dist/core/headers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.mjs","names":[],"sources":["../../src/core/headers.ts"],"sourcesContent":["export const CACHE_CONTROL_HEADER = \"Cache-Control\";\nexport const CONSENT_MANAGEMENT_HEADER = \"Shopify-Storefront-Consent-Management\";\nexport const HYDROGEN_VERSION_HEADER = \"X-Hydrogen-Version\";\nexport const SERVER_TIMING_HEADER = \"Server-Timing\";\nexport const SURROGATE_CONTROL_HEADER = \"Surrogate-Control\";\nexport const REQUEST_GROUP_ID_HEADER = \"Custom-Storefront-Request-Group-ID\";\nexport const SDK_VARIANT_HEADER = \"X-SDK-Variant\";\nexport const SDK_VARIANT_SOURCE_HEADER = \"X-SDK-Variant-Source\";\nexport const SDK_VERSION_HEADER = \"X-SDK-Version\";\nexport const SHOPIFY_STOREFRONT_ORIGIN_HEADER = \"Sec-Shopify-Storefront-Origin\";\nexport const STOREFRONT_ID_HEADER = \"Shopify-Storefront-Id\";\nexport const SHOPIFY_STOREFRONT_S_HEADER = \"Shopify-Storefront-S\";\nexport const SHOPIFY_STOREFRONT_Y_HEADER = \"Shopify-Storefront-Y\";\nexport const SHOPIFY_UNIQUE_TOKEN_HEADER = \"X-Shopify-UniqueToken\";\nexport const SHOPIFY_VISIT_TOKEN_HEADER = \"X-Shopify-VisitToken\";\nexport const STOREFRONT_ACCESS_TOKEN_HEADER = \"X-Shopify-Storefront-Access-Token\";\nexport const STOREFRONT_BUYER_IP_HEADER = \"Shopify-Storefront-Buyer-IP\";\nexport const STOREFRONT_PRIVATE_TOKEN_HEADER = \"Shopify-Storefront-Private-Token\";\nexport const STOREFRONT_URL_HEADER = \"x-storefront-url\";\n\nexport type StandardHeaderName =\n  | \"accept\"\n  | \"accept-encoding\"\n  | \"accept-language\"\n  | \"access-control-request-headers\"\n  | \"access-control-request-method\"\n  | typeof CACHE_CONTROL_HEADER\n  | \"cf-connecting-ip\"\n  | \"connection\"\n  | \"content-length\"\n  | \"content-type\"\n  | \"cookie\"\n  | \"host\"\n  | \"keep-alive\"\n  | \"origin\"\n  | \"proxy-authenticate\"\n  | \"proxy-authorization\"\n  | \"referer\"\n  | typeof SERVER_TIMING_HEADER\n  | typeof SURROGATE_CONTROL_HEADER\n  | \"te\"\n  | \"trailer\"\n  | \"transfer-encoding\"\n  | \"upgrade\"\n  | \"user-agent\"\n  | \"x-requested-with\";\n\nexport type ShopifyHeaderName =\n  | typeof CONSENT_MANAGEMENT_HEADER\n  | typeof HYDROGEN_VERSION_HEADER\n  | typeof REQUEST_GROUP_ID_HEADER\n  | typeof SDK_VARIANT_HEADER\n  | typeof SDK_VARIANT_SOURCE_HEADER\n  | typeof SDK_VERSION_HEADER\n  | typeof SHOPIFY_STOREFRONT_ORIGIN_HEADER\n  | typeof SHOPIFY_STOREFRONT_S_HEADER\n  | typeof SHOPIFY_STOREFRONT_Y_HEADER\n  | typeof SHOPIFY_UNIQUE_TOKEN_HEADER\n  | typeof SHOPIFY_VISIT_TOKEN_HEADER\n  | typeof STOREFRONT_ACCESS_TOKEN_HEADER\n  | typeof STOREFRONT_BUYER_IP_HEADER\n  | typeof STOREFRONT_ID_HEADER\n  | typeof STOREFRONT_PRIVATE_TOKEN_HEADER\n  | typeof STOREFRONT_URL_HEADER;\n\ntype KnownHeaderName = StandardHeaderName | ShopifyHeaderName;\n\nexport function defineHeaderList<const HeaderNames extends readonly KnownHeaderName[]>(\n  ...headerNames: HeaderNames\n): HeaderNames {\n  return headerNames;\n}\n\nexport function extractHeaders(\n  getter: (key: string) => string | null,\n  allowlist: readonly string[],\n): [string, string][] {\n  return allowlist.reduce<[string, string][]>((acc, key) => {\n    const value = getter(key);\n    if (value != null) acc.push([key, value]);\n    return acc;\n  }, []);\n}\n\nexport function applyPrivateResponseCacheHeaders(headers: Headers): void {\n  headers.set(CACHE_CONTROL_HEADER, \"private, no-store, max-age=0, must-revalidate\");\n  for (const header of Array.from(headers.keys())) {\n    if (\n      /^(?:.+-)?cdn-cache-control$/i.test(header) ||\n      header.toLowerCase() === SURROGATE_CONTROL_HEADER.toLowerCase()\n    ) {\n      headers.delete(header);\n    }\n  }\n}\n\nconst COMMON_PROXY_HEADER_ALLOWLIST = defineHeaderList(\n  \"accept\",\n  \"accept-encoding\",\n  \"accept-language\",\n  \"content-type\",\n  \"cookie\",\n  \"origin\",\n  \"referer\",\n  \"user-agent\",\n);\n\nexport const SFAPI_REQUEST_HEADER_ALLOWLIST = defineHeaderList(\n  ...COMMON_PROXY_HEADER_ALLOWLIST,\n  \"content-length\",\n  \"access-control-request-headers\",\n  \"access-control-request-method\",\n  STOREFRONT_ACCESS_TOKEN_HEADER,\n  STOREFRONT_PRIVATE_TOKEN_HEADER,\n  SHOPIFY_UNIQUE_TOKEN_HEADER,\n  SHOPIFY_VISIT_TOKEN_HEADER,\n);\n\nexport const MCP_REQUEST_HEADER_ALLOWLIST = defineHeaderList(...COMMON_PROXY_HEADER_ALLOWLIST);\n\nexport const AJAX_API_REQUEST_HEADER_ALLOWLIST = defineHeaderList(\n  ...COMMON_PROXY_HEADER_ALLOWLIST,\n  \"content-length\",\n  \"x-requested-with\",\n);\n\n// Hop-by-hop headers must not be forwarded by proxies. `host` and\n// `content-length` are also removed so fetch can derive them for the upstream\n// request. See https://www.rfc-editor.org/rfc/rfc9110.html#section-7.6.1\nexport const PROXY_REQUEST_HEADER_DENYLIST = defineHeaderList(\n  \"cf-connecting-ip\",\n  \"connection\",\n  \"content-length\",\n  \"host\",\n  \"keep-alive\",\n  \"proxy-authenticate\",\n  \"proxy-authorization\",\n  \"te\",\n  \"trailer\",\n  \"transfer-encoding\",\n  \"upgrade\",\n);\n"],"mappings":";AAAA,MAAa,uBAAuB;AACpC,MAAa,4BAA4B;AACzC,MAAa,0BAA0B;AACvC,MAAa,uBAAuB;AACpC,MAAa,2BAA2B;AACxC,MAAa,0BAA0B;AACvC,MAAa,qBAAqB;AAClC,MAAa,4BAA4B;AACzC,MAAa,qBAAqB;AAClC,MAAa,mCAAmC;AAChD,MAAa,uBAAuB;AACpC,MAAa,8BAA8B;AAC3C,MAAa,8BAA8B;AAC3C,MAAa,8BAA8B;AAC3C,MAAa,6BAA6B;AAC1C,MAAa,iCAAiC;AAC9C,MAAa,6BAA6B;AAC1C,MAAa,kCAAkC;AAC/C,MAAa,wBAAwB;AAiDrC,SAAgB,iBACd,GAAG,aACU;AACb,QAAO;;AAGT,SAAgB,eACd,QACA,WACoB;AACpB,QAAO,UAAU,QAA4B,KAAK,QAAQ;EACxD,MAAM,QAAQ,OAAO,IAAI;AACzB,MAAI,SAAS,KAAM,KAAI,KAAK,CAAC,KAAK,MAAM,CAAC;AACzC,SAAO;IACN,EAAE,CAAC;;AAGR,SAAgB,iCAAiC,SAAwB;AACvE,SAAQ,IAAI,sBAAsB,gDAAgD;AAClF,MAAK,MAAM,UAAU,MAAM,KAAK,QAAQ,MAAM,CAAC,CAC7C,KACE,+BAA+B,KAAK,OAAO,IAC3C,OAAO,aAAa,yBAA8B,aAAa,CAE/D,SAAQ,OAAO,OAAO;;AAK5B,MAAM,gCAAgC,iBACpC,UACA,mBACA,mBACA,gBACA,UACA,UACA,WACA,aACD;AAED,MAAa,iCAAiC,iBAC5C,GAAG,+BACH,kBACA,kCACA,iCACA,gCACA,iCACA,6BACA,2BACD;AAED,MAAa,+BAA+B,iBAAiB,GAAG,8BAA8B;AAE9F,MAAa,oCAAoC,iBAC/C,GAAG,+BACH,kBACA,mBACD;AAKD,MAAa,gCAAgC,iBAC3C,oBACA,cACA,kBACA,QACA,cACA,sBACA,uBACA,MACA,WACA,qBACA,UACD"}

package/dist/core/index.d.mts

@@ -0,0 +1,56 @@
+import { Cache, CacheOptions, CachingStrategy } from "./cache/strategies.mjs";
+import { CacheInstance, createRunWithCache } from "./cache/run-with-cache.mjs";
+import { ProductCollectionSortKeys } from "../graphql/generated/storefront-api-types.mjs";
+import { I18nConfig, ShopifyRequestContext, ShopifyRequestContextWithBuyerIp, createShopifyRequestContext } from "./request-context.mjs";
+import { InferResult, InferVariables } from "../graphql/type-resolver.mjs";
+import { AnyStorefrontQueryString, StorefrontQueryString, gql } from "../graphql/graphql.mjs";
+import { ClientType, CreateStorefrontClientArgs, GqlRestParam, GraphQLFormattedError, PrivateClientOptions, PrivateNoBuyerContextClientOptions, PrivateNoBuyerContextStorefrontClient, PrivateStorefrontClient, PublicClientOptions, PublicStorefrontClient, RequestScopedPrivateStorefrontClient, StorefrontApi, StorefrontClient, StorefrontClientOptions, StorefrontGraphql, StorefrontGraphqlOptions, StorefrontGraphqlResult } from "../client/types.mjs";
+import { createStorefrontClient } from "../client/client.mjs";
+import { ShopifyRouteTemplates } from "./standard-routes/types.mjs";
+import { createShopifyRouteTemplates } from "./standard-routes/build.mjs";
+import { RedirectOptions, handleShopifyRedirects } from "./request-routing/handle-shopify-redirects.mjs";
+import { CallableRouteHandler, ShopifyRedirectStatus, ShopifyRouteError, ShopifyRouteErrorResult, ShopifyRouteHandler, ShopifyRouteHandlerContext, ShopifyRouteHandlerGroup, ShopifyRouteHandlerResult, ShopifyRouteJsonResult, ShopifyRouteRedirectResult } from "./request-routing/route-types.mjs";
+import { handleShopifyRoutes } from "./request-routing/handle-shopify-routes.mjs";
+import { createShopifyRouteHandler } from "./request-routing/registered-routes.mjs";
+import { createFetchWithCache } from "./cache/fetch-with-cache.mjs";
+import { StorefrontApiError, StorefrontTimeoutError } from "../client/errors.mjs";
+import { ProductFilter } from "../vendor/standard-events.mjs";
+import { Attribute, CartCost, CartData, CartErrorGroup, CartErrorState, CartLine, CartLineConnection, CartLineCost, CartLineMerchandise, CartNetworkEntry, CartPending, CartState, CartUserError, CartWarning, DiscountCode, EMPTY_CART_DATA, EMPTY_CART_STATE, createEmptyCartErrors, createEmptyErrorGroup } from "./cart/state.mjs";
+import { CartNetworkError, CartStore, CreateCartStoreOptions, STANDARD_ACTION_TIMEOUT_IN_MS, configureCartEndpoint, createCartStore } from "./cart/cart.mjs";
+import { trackCartAnalytics } from "./analytics/cart-tracker.mjs";
+import { AnalyticsEvent, AnalyticsEventName } from "./analytics/events.mjs";
+import { ShopifyGlobal } from "../globals.mjs";
+import { ShopifyRoutesOptions, ShopifyScriptTagDescriptor, ShopifyScriptTagDescriptors, ShopifyScriptTagsOptions, ShopifyScriptsAnalyticsConfig, ShopifyScriptsI18n, ShopifyScriptsOptions, ShopifyScriptsShop } from "./shopify-scripts/types.mjs";
+import { AnalyticsCart, AnalyticsCartLine, AnalyticsEventMap, CartLineUpdatePayload, CartUpdatePayload, CartViewPayload, CollectionViewPayload, ConsentConfig, EventPayloads, OtherData, PageViewPayload, PayloadFor, ProductPayload, ProductViewPayload, SearchViewPayload, ShopAnalytics, StorefrontAnalytics, StorefrontAnalyticsConfig, StorefrontAnalyticsDestination, StorefrontAnalyticsDestinationSetupContext } from "./analytics/types.mjs";
+import { CartFormRegister, QuantityInputAttributes, SetButtonAttributes, createCartFormRegister } from "./cart/form.mjs";
+import { attachQuantityInput } from "./cart/attach-quantity-input.mjs";
+import { CartAction, CartAttributeInput, CartLineAddInput, CartLineUpdateInput, parseCartRequest } from "./cart/actions.mjs";
+import { cartQueries } from "./cart/queries.mjs";
+import { createCartCookie } from "./cart/cookie.mjs";
+import { CartDataFromQuery, CartResult, getCart, getCartId } from "./cart/get-cart.mjs";
+import { CartDataFromHandlers, CartError, CartErrorCode, CartGetData, CartGetHandler, CartGetResult, CartPostHandler, CartPostResult, CartServerHandlers, CartServerHandlersWithCustomerSession, CreateCartServerHandlersOptions, createCartServerHandlers } from "./cart/server-handlers.mjs";
+import { DEFAULT_MINIMUM_QUANTITY, NO_QUANTITY_LIMIT, sanitizeQuantity } from "./cart/quantity.mjs";
+import { initializeShopifyScripts } from "./shopify-scripts/initialize.mjs";
+import { getShopifyScriptTags, renderShopifyScriptTags } from "./shopify-scripts/index.mjs";
+import { AvailableFilter, AvailableFilterValue, CollectionState, FilterPresentation, FilterType, createInitialCollectionState } from "./collection/state.mjs";
+import { CollectionData, CollectionStore, CreateCollectionStoreOptions, createCollectionStore } from "./collection/collection.mjs";
+import { CollectionReconciler, ReconcilerCallbacks, createCollectionReconciler } from "./collection/reconciler.mjs";
+import { CollectionParams, filterEquals, getFilterRemovalUrl, getSortByValue, isFilterInputActive, normalizeCollectionSearch, parseCollectionParams, parseSortByValue, serializeCollectionParams } from "./collection/url.mjs";
+import { ProductInput, ProductOptionInput, ProductOptionValueInput, ProductVariantFrom, ProductVariantInput, SelectedOption, VariantOptionState, VariantOptionValueState } from "./product/state.mjs";
+import { CreateProductFormStoreOptions, ProductFormErrors, ProductFormOptions, ProductFormStore, ProductFormStoreState, ValidProductSelectionResult, VariantSelectionResult, canAddToCart, createProductFormStore, findCartLineByMerchandiseId, getSelectedVariant } from "./product/product-form.mjs";
+import { getSelectedProductOptions } from "./product/options.mjs";
+import { ProductSelectionLinkStyle, buildProductSelectionSearchParams } from "./product/url.mjs";
+import { ProductAddToCartProps, ProductFormRegister, ProductMerchandiseIdProps, ProductOptionValueProps, ProductQuantityDefaultProps, ProductQuantityProps, createProductFormRegister } from "./product/form.mjs";
+import { SHOP_PAY_BUTTON_TAG_NAME, ShopPayButtonOptions, createShopPayButton, defineShopPayButton, getShopPayButtonUrl, renderShopPayButton } from "./shop-pay/shop-pay.mjs";
+import { PredictiveSearchFormAttributes, PredictiveSearchFormRegister, PredictiveSearchQueryInputAttributes, createPredictiveSearchFormRegister, getPredictiveSearchFormAttributes, readPredictiveSearchFormTerm } from "./predictive-search/form.mjs";
+import { CreatePredictiveSearchQueriesOptions, PredictiveSearchFragments, makePredictiveSearchQueries } from "./predictive-search/queries.mjs";
+import { PredictiveSearchData, QueryPredictiveSearchOptions, queryPredictiveSearch } from "./predictive-search/search.mjs";
+import { CreatePredictiveSearchServerHandlersOptions, createPredictiveSearchServerHandlers } from "./predictive-search/server-handlers.mjs";
+import { CreatePredictiveSearchStoreOptions, PredictiveSearchState, PredictiveSearchStatus, PredictiveSearchStore, createPredictiveSearchStore } from "./predictive-search/store.mjs";
+import { PredictiveSearchArticleItem, PredictiveSearchCollectionItem, PredictiveSearchItem, PredictiveSearchItemUrlOptions, PredictiveSearchPageItem, PredictiveSearchProductItem, PredictiveSearchQueryItem, PredictiveSearchQueryItemUrlOptions, PredictiveSearchResourceItem, getPredictiveSearchItemUrl, getSearchResultUrl } from "./predictive-search/url.mjs";
+import { FormatMoneyOptions, FormattedMoney, FormattedMoneyRange, MoneyV2 } from "./money/types.mjs";
+import { formatMoney } from "./money/format.mjs";
+import { flattenConnection } from "./analytics/utils/flatten-connection.mjs";
+import { HydrogenLogger, LogContext, LogLevel } from "./logging/types.mjs";
+import { ConfigureLoggingOptions, configureLogging } from "./logging/logging.mjs";
+export { type AnalyticsCart, type AnalyticsCartLine, AnalyticsEvent, type AnalyticsEventMap, type AnalyticsEventName, type AnyStorefrontQueryString, type Attribute, type AvailableFilter, type AvailableFilterValue, Cache, type CacheInstance, type CacheOptions, type CachingStrategy, type CallableRouteHandler, type CartAction, type CartAttributeInput, type CartCost, type CartData, type CartDataFromHandlers, type CartDataFromQuery, type CartError, type CartErrorCode, type CartErrorGroup, type CartErrorState, type CartFormRegister, type CartGetData, type CartGetHandler, type CartGetResult, type CartLine, type CartLineAddInput, type CartLineConnection, type CartLineCost, type CartLineMerchandise, type CartLineUpdateInput, type CartLineUpdatePayload, type CartNetworkEntry, CartNetworkError, type CartPending, type CartPostHandler, type CartPostResult, type CartResult, type CartServerHandlers, type CartServerHandlersWithCustomerSession, type CartState, type CartStore, type CartUpdatePayload, type CartUserError, type CartViewPayload, type CartWarning, type ClientType, type CollectionData, type CollectionParams, type CollectionReconciler, type CollectionState, type CollectionStore, type CollectionViewPayload, type ConfigureLoggingOptions, type ConsentConfig, type CreateCartServerHandlersOptions, type CreateCartStoreOptions, type CreateCollectionStoreOptions, type CreatePredictiveSearchQueriesOptions, type CreatePredictiveSearchServerHandlersOptions, type CreatePredictiveSearchStoreOptions, type CreateProductFormStoreOptions, type CreateStorefrontClientArgs, DEFAULT_MINIMUM_QUANTITY, type DiscountCode, EMPTY_CART_DATA, EMPTY_CART_STATE, type EventPayloads, type FilterPresentation, type FilterType, type FormatMoneyOptions, type FormattedMoney, type FormattedMoneyRange, type GqlRestParam, type GraphQLFormattedError, type HydrogenLogger, type I18nConfig, type InferResult, type InferVariables, type LogContext, type LogLevel, type MoneyV2, NO_QUANTITY_LIMIT, type OtherData, type PageViewPayload, type PayloadFor, type PredictiveSearchArticleItem, type PredictiveSearchCollectionItem, type PredictiveSearchData, type PredictiveSearchFormAttributes, type PredictiveSearchFormRegister, type PredictiveSearchFragments, type PredictiveSearchItem, type PredictiveSearchItemUrlOptions, type PredictiveSearchPageItem, type PredictiveSearchProductItem, type PredictiveSearchQueryInputAttributes, type PredictiveSearchQueryItem, type PredictiveSearchQueryItemUrlOptions, type PredictiveSearchResourceItem, type PredictiveSearchState, type PredictiveSearchStatus, type PredictiveSearchStore, type PrivateClientOptions, type PrivateNoBuyerContextClientOptions, type PrivateNoBuyerContextStorefrontClient, type PrivateStorefrontClient, type ProductAddToCartProps, type ProductCollectionSortKeys, type ProductFilter, type ProductFormErrors, type ProductFormOptions, type ProductFormRegister, type ProductFormStore, type ProductFormStoreState, type ProductInput, type ProductMerchandiseIdProps, type ProductOptionInput, type ProductOptionValueInput, type ProductOptionValueProps, type ProductPayload, type ProductQuantityDefaultProps, type ProductQuantityProps, type ProductSelectionLinkStyle, type ProductVariantFrom, type ProductVariantInput, type ProductViewPayload, type PublicClientOptions, type PublicStorefrontClient, type QuantityInputAttributes, type QueryPredictiveSearchOptions, type ReconcilerCallbacks, type RedirectOptions, type RequestScopedPrivateStorefrontClient, SHOP_PAY_BUTTON_TAG_NAME, STANDARD_ACTION_TIMEOUT_IN_MS, type SearchViewPayload, type SelectedOption, type SetButtonAttributes, type ShopAnalytics, type ShopPayButtonOptions, type ShopifyGlobal, type ShopifyRedirectStatus, type ShopifyRequestContext, type ShopifyRequestContextWithBuyerIp, type ShopifyRouteError, type ShopifyRouteErrorResult, type ShopifyRouteHandler, type ShopifyRouteHandlerContext, type ShopifyRouteHandlerGroup, type ShopifyRouteHandlerResult, type ShopifyRouteJsonResult, type ShopifyRouteRedirectResult, type ShopifyRouteTemplates, type ShopifyRoutesOptions, type ShopifyScriptTagDescriptor, type ShopifyScriptTagDescriptors, type ShopifyScriptTagsOptions, type ShopifyScriptsAnalyticsConfig, type ShopifyScriptsI18n, type ShopifyScriptsOptions, type ShopifyScriptsShop, type StorefrontAnalytics, type StorefrontAnalyticsConfig, type StorefrontAnalyticsDestination, type StorefrontAnalyticsDestinationSetupContext, type StorefrontApi, StorefrontApiError, type StorefrontClient, type StorefrontClientOptions, type StorefrontGraphql, type StorefrontGraphqlOptions, type StorefrontGraphqlResult, type StorefrontQueryString, StorefrontTimeoutError, type ValidProductSelectionResult, type VariantOptionState, type VariantOptionValueState, type VariantSelectionResult, attachQuantityInput, buildProductSelectionSearchParams, canAddToCart, cartQueries, configureCartEndpoint, configureLogging, createCartCookie, createCartFormRegister, createCartServerHandlers, createCartStore, createCollectionReconciler, createCollectionStore, createEmptyCartErrors, createEmptyErrorGroup, createFetchWithCache, createInitialCollectionState, createPredictiveSearchFormRegister, createPredictiveSearchServerHandlers, createPredictiveSearchStore, createProductFormRegister, createProductFormStore, createRunWithCache, createShopPayButton, createShopifyRequestContext, createShopifyRouteHandler, createShopifyRouteTemplates, createStorefrontClient, defineShopPayButton, filterEquals, findCartLineByMerchandiseId, flattenConnection, formatMoney, getCart, getCartId, getFilterRemovalUrl, getPredictiveSearchFormAttributes, getPredictiveSearchItemUrl, getSearchResultUrl, getSelectedProductOptions, getSelectedVariant, getShopPayButtonUrl, getShopifyScriptTags, getSortByValue, gql, handleShopifyRedirects, handleShopifyRoutes, initializeShopifyScripts, isFilterInputActive, makePredictiveSearchQueries, normalizeCollectionSearch, parseCartRequest, parseCollectionParams, parseSortByValue, queryPredictiveSearch, readPredictiveSearchFormTerm, renderShopPayButton, renderShopifyScriptTags, sanitizeQuantity, serializeCollectionParams, trackCartAnalytics };

package/dist/core/index.mjs

@@ -0,0 +1,45 @@
+import { createShopifyRouteTemplates } from "./standard-routes/build.mjs";
+import { configureLogging } from "./logging/logging.mjs";
+import { gql } from "../graphql/graphql.mjs";
+import { handleShopifyRedirects } from "./request-routing/handle-shopify-redirects.mjs";
+import { Cache } from "./cache/strategies.mjs";
+import { createRunWithCache } from "./cache/run-with-cache.mjs";
+import { createFetchWithCache } from "./cache/fetch-with-cache.mjs";
+import { StorefrontApiError, StorefrontTimeoutError } from "../client/errors.mjs";
+import { createStorefrontClient } from "../client/client.mjs";
+import { buildProductSelectionSearchParams } from "./product/url.mjs";
+import { createCartCookie } from "./cart/cookie.mjs";
+import { cartQueries } from "./cart/queries.mjs";
+import { getCart, getCartId } from "./cart/get-cart.mjs";
+import { createShopifyRouteHandler } from "./request-routing/registered-routes.mjs";
+import { handleShopifyRoutes } from "./request-routing/handle-shopify-routes.mjs";
+import { createShopifyRequestContext } from "./request-context.mjs";
+import { AnalyticsEvent } from "./analytics/events.mjs";
+import { flattenConnection } from "./analytics/utils/flatten-connection.mjs";
+import { trackCartAnalytics } from "./analytics/cart-tracker.mjs";
+import { initializeShopifyScripts } from "./shopify-scripts/initialize.mjs";
+import { getShopifyScriptTags, renderShopifyScriptTags } from "./shopify-scripts/index.mjs";
+import { createCartFormRegister } from "./cart/form.mjs";
+import { DEFAULT_MINIMUM_QUANTITY, NO_QUANTITY_LIMIT, sanitizeQuantity } from "./cart/quantity.mjs";
+import { EMPTY_CART_DATA, EMPTY_CART_STATE, createEmptyCartErrors, createEmptyErrorGroup } from "./cart/state.mjs";
+import { CartNetworkError, STANDARD_ACTION_TIMEOUT_IN_MS, configureCartEndpoint, createCartStore } from "./cart/cart.mjs";
+import { attachQuantityInput } from "./cart/attach-quantity-input.mjs";
+import { parseCartRequest } from "./cart/actions.mjs";
+import { createCartServerHandlers } from "./cart/server-handlers.mjs";
+import { createInitialCollectionState } from "./collection/state.mjs";
+import { filterEquals, getFilterRemovalUrl, getSortByValue, isFilterInputActive, normalizeCollectionSearch, parseCollectionParams, parseSortByValue, serializeCollectionParams } from "./collection/url.mjs";
+import { createCollectionStore } from "./collection/collection.mjs";
+import { createCollectionReconciler } from "./collection/reconciler.mjs";
+import { getSelectedProductOptions } from "./product/options.mjs";
+import { canAddToCart, createProductFormStore, findCartLineByMerchandiseId, getSelectedVariant } from "./product/product-form.mjs";
+import { createProductFormRegister } from "./product/form.mjs";
+import { SHOP_PAY_BUTTON_TAG_NAME, createShopPayButton, defineShopPayButton, getShopPayButtonUrl, renderShopPayButton } from "./shop-pay/shop-pay.mjs";
+import { createPredictiveSearchFormRegister, getPredictiveSearchFormAttributes, readPredictiveSearchFormTerm } from "./predictive-search/form.mjs";
+import { makePredictiveSearchQueries } from "./predictive-search/queries.mjs";
+import { queryPredictiveSearch } from "./predictive-search/search.mjs";
+import { createPredictiveSearchServerHandlers } from "./predictive-search/server-handlers.mjs";
+import { createPredictiveSearchStore } from "./predictive-search/store.mjs";
+import { getPredictiveSearchItemUrl, getSearchResultUrl } from "./predictive-search/url.mjs";
+import { formatMoney } from "./money/format.mjs";
+
+export { AnalyticsEvent, Cache, CartNetworkError, DEFAULT_MINIMUM_QUANTITY, EMPTY_CART_DATA, EMPTY_CART_STATE, NO_QUANTITY_LIMIT, SHOP_PAY_BUTTON_TAG_NAME, STANDARD_ACTION_TIMEOUT_IN_MS, StorefrontApiError, StorefrontTimeoutError, attachQuantityInput, buildProductSelectionSearchParams, canAddToCart, cartQueries, configureCartEndpoint, configureLogging, createCartCookie, createCartFormRegister, createCartServerHandlers, createCartStore, createCollectionReconciler, createCollectionStore, createEmptyCartErrors, createEmptyErrorGroup, createFetchWithCache, createInitialCollectionState, createPredictiveSearchFormRegister, createPredictiveSearchServerHandlers, createPredictiveSearchStore, createProductFormRegister, createProductFormStore, createRunWithCache, createShopPayButton, createShopifyRequestContext, createShopifyRouteHandler, createShopifyRouteTemplates, createStorefrontClient, defineShopPayButton, filterEquals, findCartLineByMerchandiseId, flattenConnection, formatMoney, getCart, getCartId, getFilterRemovalUrl, getPredictiveSearchFormAttributes, getPredictiveSearchItemUrl, getSearchResultUrl, getSelectedProductOptions, getSelectedVariant, getShopPayButtonUrl, getShopifyScriptTags, getSortByValue, gql, handleShopifyRedirects, handleShopifyRoutes, initializeShopifyScripts, isFilterInputActive, makePredictiveSearchQueries, normalizeCollectionSearch, parseCartRequest, parseCollectionParams, parseSortByValue, queryPredictiveSearch, readPredictiveSearchFormTerm, renderShopPayButton, renderShopifyScriptTags, sanitizeQuantity, serializeCollectionParams, trackCartAnalytics };

package/dist/core/logging/logging.d.mts

@@ -0,0 +1,21 @@
+import { HydrogenLogger, LogLevel } from "./types.mjs";
+
+//#region src/core/logging/logging.d.ts
+type ConfigureLoggingOptions = {
+  /** Receives all entries at or above `level`. Defaults to the built-in console logger. */logger?: HydrogenLogger; /** Minimum severity forwarded to the logger. Defaults to `"info"`. */
+  level?: LogLevel;
+};
+/**
+ * Configures logging for every Hydrogen helper in this JavaScript context.
+ * Call it once at startup (app entry on the browser, module init on the
+ * server) before Hydrogen helpers run.
+ *
+ * Reconfiguring with different options applies the new options (last call
+ * wins). Inline bootstrap scripts that Hydrogen serializes into HTML
+ * (analytics, consent) run outside the app bundle and always write to the
+ * console with the standard prefix; they cannot receive a custom logger.
+ */
+declare function configureLogging(options: ConfigureLoggingOptions): void;
+//#endregion
+export { ConfigureLoggingOptions, configureLogging };
+//# sourceMappingURL=logging.d.mts.map

package/dist/core/logging/logging.mjs

@@ -0,0 +1,99 @@
+import { DEFAULT_LOG_LEVEL, isLevelEnabled } from "./types.mjs";
+
+//#region src/core/logging/logging.ts
+const CONSOLE_METHODS = {
+	trace: "debug",
+	debug: "debug",
+	info: "info",
+	warn: "warn",
+	error: "error",
+	fatal: "error"
+};
+function formatLogPrefix(level, scope) {
+	return `[hydrogen:${level}:${scope}]`;
+}
+function writeToConsole(level, message, context) {
+	const { scope, error, ...rest } = context ?? {};
+	const args = [scope ? `${formatLogPrefix(level, scope)} ${message}` : message];
+	if (error !== void 0) args.push(error);
+	if (Object.keys(rest).length > 0) args.push(rest);
+	console[CONSOLE_METHODS[level]](...args);
+}
+/**
+* Built-in sink: writes `[hydrogen:<level>:<scope>] <message>` to a
+* level-specific `console` method, followed by `context.error` and any extra
+* context fields. `trace` uses `console.debug`; `fatal` uses `console.error`.
+*/
+const consoleLogger = {
+	trace: (message, context) => writeToConsole("trace", message, context),
+	debug: (message, context) => writeToConsole("debug", message, context),
+	info: (message, context) => writeToConsole("info", message, context),
+	warn: (message, context) => writeToConsole("warn", message, context),
+	error: (message, context) => writeToConsole("error", message, context),
+	fatal: (message, context) => writeToConsole("fatal", message, context)
+};
+const state = {
+	logger: consoleLogger,
+	level: DEFAULT_LOG_LEVEL
+};
+/**
+* Configures logging for every Hydrogen helper in this JavaScript context.
+* Call it once at startup (app entry on the browser, module init on the
+* server) before Hydrogen helpers run.
+*
+* Reconfiguring with different options applies the new options (last call
+* wins). Inline bootstrap scripts that Hydrogen serializes into HTML
+* (analytics, consent) run outside the app bundle and always write to the
+* console with the standard prefix; they cannot receive a custom logger.
+*/
+function configureLogging(options) {
+	const logger = options.logger ?? consoleLogger;
+	const level = options.level ?? "info";
+	state.logger = logger;
+	state.level = level;
+}
+function emit(scope, level, message, context) {
+	if (!isLevelEnabled(level, state.level)) return;
+	try {
+		state.logger[level](message, {
+			...context,
+			scope
+		});
+	} catch (error) {
+		reportLoggerFailure(error, {
+			level,
+			scope,
+			message,
+			context
+		});
+	}
+}
+function reportLoggerFailure(error, failedEntry) {
+	if (state.logger === consoleLogger) return;
+	const fallbackContext = {
+		scope: "logging",
+		error,
+		originalLevel: failedEntry.level,
+		originalScope: failedEntry.scope,
+		originalMessage: failedEntry.message
+	};
+	if (failedEntry.context !== void 0) fallbackContext.originalContext = failedEntry.context;
+	try {
+		consoleLogger.error("configured logger failed", fallbackContext);
+	} catch {}
+}
+/** @internal Returns the lazily-resolved scoped logger for a Hydrogen subsystem. */
+function getLogger(scope) {
+	return {
+		trace: (message, context) => emit(scope, "trace", message, context),
+		debug: (message, context) => emit(scope, "debug", message, context),
+		info: (message, context) => emit(scope, "info", message, context),
+		warn: (message, context) => emit(scope, "warn", message, context),
+		error: (message, context) => emit(scope, "error", message, context),
+		fatal: (message, context) => emit(scope, "fatal", message, context)
+	};
+}
+
+//#endregion
+export { configureLogging, consoleLogger, getLogger };
+//# sourceMappingURL=logging.mjs.map

package/dist/core/logging/logging.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.mjs","names":[],"sources":["../../../src/core/logging/logging.ts"],"sourcesContent":["import {\n  DEFAULT_LOG_LEVEL,\n  isLevelEnabled,\n  type HydrogenLogger,\n  type LogContext,\n  type LogLevel,\n  type LogSeverity,\n} from \"./types\";\n\nconst CONSOLE_METHODS: Record<LogSeverity, \"debug\" | \"info\" | \"warn\" | \"error\"> = {\n  // `console.trace` prints a stack trace for every call, which is too noisy\n  // for level-gated trace logs; route it to `console.debug` instead.\n  trace: \"debug\",\n  debug: \"debug\",\n  info: \"info\",\n  warn: \"warn\",\n  error: \"error\",\n  fatal: \"error\",\n};\n\nexport function formatLogPrefix(level: LogSeverity, scope: string): string {\n  return `[hydrogen:${level}:${scope}]`;\n}\n\nfunction writeToConsole(level: LogSeverity, message: string, context?: LogContext): void {\n  const { scope, error, ...rest } = context ?? {};\n  const prefixed = scope ? `${formatLogPrefix(level, scope)} ${message}` : message;\n  const args: unknown[] = [prefixed];\n  if (error !== undefined) args.push(error);\n  if (Object.keys(rest).length > 0) args.push(rest);\n\n  // oxlint-disable-next-line no-console -- The built-in sink is the one sanctioned console call site.\n  console[CONSOLE_METHODS[level]](...args);\n}\n\n/**\n * Built-in sink: writes `[hydrogen:<level>:<scope>] <message>` to a\n * level-specific `console` method, followed by `context.error` and any extra\n * context fields. `trace` uses `console.debug`; `fatal` uses `console.error`.\n */\nexport const consoleLogger: HydrogenLogger = {\n  trace: (message, context) => writeToConsole(\"trace\", message, context),\n  debug: (message, context) => writeToConsole(\"debug\", message, context),\n  info: (message, context) => writeToConsole(\"info\", message, context),\n  warn: (message, context) => writeToConsole(\"warn\", message, context),\n  error: (message, context) => writeToConsole(\"error\", message, context),\n  fatal: (message, context) => writeToConsole(\"fatal\", message, context),\n};\n\nexport type ConfigureLoggingOptions = {\n  /** Receives all entries at or above `level`. Defaults to the built-in console logger. */\n  logger?: HydrogenLogger;\n  /** Minimum severity forwarded to the logger. Defaults to `\"info\"`. */\n  level?: LogLevel;\n};\n\ntype LoggingState = {\n  logger: HydrogenLogger;\n  level: LogLevel;\n};\n\nconst state: LoggingState = {\n  logger: consoleLogger,\n  level: DEFAULT_LOG_LEVEL,\n};\n\n/**\n * Configures logging for every Hydrogen helper in this JavaScript context.\n * Call it once at startup (app entry on the browser, module init on the\n * server) before Hydrogen helpers run.\n *\n * Reconfiguring with different options applies the new options (last call\n * wins). Inline bootstrap scripts that Hydrogen serializes into HTML\n * (analytics, consent) run outside the app bundle and always write to the\n * console with the standard prefix; they cannot receive a custom logger.\n */\nexport function configureLogging(options: ConfigureLoggingOptions): void {\n  const logger = options.logger ?? consoleLogger;\n  const level = options.level ?? DEFAULT_LOG_LEVEL;\n\n  state.logger = logger;\n  state.level = level;\n}\n\n/** @internal */\nexport function resetLoggingForTests(): void {\n  state.logger = consoleLogger;\n  state.level = DEFAULT_LOG_LEVEL;\n}\n\n/**\n * Scoped logger used by Hydrogen internals. Entries are level-gated and\n * tagged with `scope`, then forwarded to the configured sink. Resolution is\n * lazy: `configureLogging` affects loggers obtained before or after the call.\n */\ntype ScopedLogContext = Omit<LogContext, \"scope\"> & { scope?: never };\n\ntype ScopedLogger = Record<LogSeverity, (message: string, context?: ScopedLogContext) => void>;\n\nfunction emit(scope: string, level: LogSeverity, message: string, context?: LogContext): void {\n  if (!isLevelEnabled(level, state.level)) return;\n\n  try {\n    state.logger[level](message, { ...context, scope });\n  } catch (error) {\n    reportLoggerFailure(error, { level, scope, message, context });\n  }\n}\n\ntype FailedLogEntry = {\n  level: LogSeverity;\n  scope: string;\n  message: string;\n  context?: LogContext;\n};\n\nfunction reportLoggerFailure(error: unknown, failedEntry: FailedLogEntry): void {\n  if (state.logger === consoleLogger) return;\n\n  const fallbackContext: LogContext = {\n    scope: \"logging\",\n    error,\n    originalLevel: failedEntry.level,\n    originalScope: failedEntry.scope,\n    originalMessage: failedEntry.message,\n  };\n  if (failedEntry.context !== undefined) fallbackContext.originalContext = failedEntry.context;\n\n  try {\n    consoleLogger.error(\"configured logger failed\", fallbackContext);\n  } catch {\n    // Logging failures must never change the runtime path that triggered the log.\n  }\n}\n\n/** @internal Returns the lazily-resolved scoped logger for a Hydrogen subsystem. */\nexport function getLogger(scope: string): ScopedLogger {\n  return {\n    trace: (message, context) => emit(scope, \"trace\", message, context),\n    debug: (message, context) => emit(scope, \"debug\", message, context),\n    info: (message, context) => emit(scope, \"info\", message, context),\n    warn: (message, context) => emit(scope, \"warn\", message, context),\n    error: (message, context) => emit(scope, \"error\", message, context),\n    fatal: (message, context) => emit(scope, \"fatal\", message, context),\n  };\n}\n"],"mappings":";;;AASA,MAAM,kBAA4E;CAGhF,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,SAAgB,gBAAgB,OAAoB,OAAuB;AACzE,QAAO,aAAa,MAAM,GAAG,MAAM;;AAGrC,SAAS,eAAe,OAAoB,SAAiB,SAA4B;CACvF,MAAM,EAAE,OAAO,OAAO,GAAG,SAAS,WAAW,EAAE;CAE/C,MAAM,OAAkB,CADP,QAAQ,GAAG,gBAAgB,OAAO,MAAM,CAAC,GAAG,YAAY,QACvC;AAClC,KAAI,UAAU,OAAW,MAAK,KAAK,MAAM;AACzC,KAAI,OAAO,KAAK,KAAK,CAAC,SAAS,EAAG,MAAK,KAAK,KAAK;AAGjD,SAAQ,gBAAgB,QAAQ,GAAG,KAAK;;;;;;;AAQ1C,MAAa,gBAAgC;CAC3C,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,OAAO,SAAS,YAAY,eAAe,QAAQ,SAAS,QAAQ;CACpE,OAAO,SAAS,YAAY,eAAe,QAAQ,SAAS,QAAQ;CACpE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACtE,QAAQ,SAAS,YAAY,eAAe,SAAS,SAAS,QAAQ;CACvE;AAcD,MAAM,QAAsB;CAC1B,QAAQ;CACR,OAAO;CACR;;;;;;;;;;;AAYD,SAAgB,iBAAiB,SAAwC;CACvE,MAAM,SAAS,QAAQ,UAAU;CACjC,MAAM,QAAQ,QAAQ;AAEtB,OAAM,SAAS;AACf,OAAM,QAAQ;;AAkBhB,SAAS,KAAK,OAAe,OAAoB,SAAiB,SAA4B;AAC5F,KAAI,CAAC,eAAe,OAAO,MAAM,MAAM,CAAE;AAEzC,KAAI;AACF,QAAM,OAAO,OAAO,SAAS;GAAE,GAAG;GAAS;GAAO,CAAC;UAC5C,OAAO;AACd,sBAAoB,OAAO;GAAE;GAAO;GAAO;GAAS;GAAS,CAAC;;;AAWlE,SAAS,oBAAoB,OAAgB,aAAmC;AAC9E,KAAI,MAAM,WAAW,cAAe;CAEpC,MAAM,kBAA8B;EAClC,OAAO;EACP;EACA,eAAe,YAAY;EAC3B,eAAe,YAAY;EAC3B,iBAAiB,YAAY;EAC9B;AACD,KAAI,YAAY,YAAY,OAAW,iBAAgB,kBAAkB,YAAY;AAErF,KAAI;AACF,gBAAc,MAAM,4BAA4B,gBAAgB;SAC1D;;;AAMV,SAAgB,UAAU,OAA6B;AACrD,QAAO;EACL,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,OAAO,SAAS,YAAY,KAAK,OAAO,QAAQ,SAAS,QAAQ;EACjE,OAAO,SAAS,YAAY,KAAK,OAAO,QAAQ,SAAS,QAAQ;EACjE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACnE,QAAQ,SAAS,YAAY,KAAK,OAAO,SAAS,SAAS,QAAQ;EACpE"}

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

@@ -0,0 +1,40 @@
+//#region src/core/logging/types.d.ts
+/**
+ * Logging contract for `@shopify/hydrogen` runtime failures.
+ *
+ * The interface is intentionally minimal and structural: any logger with these
+ * level methods can receive Hydrogen entries. Hydrogen never depends on a
+ * specific logging library.
+ */
+/** Log severities, ordered. `silent` disables all output. */
+type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal" | "silent";
+/**
+ * Structured details attached to a log entry. `scope` names the Hydrogen
+ * subsystem (`cart`, `analytics`, `shop-pay`, ...). `error` carries the caught
+ * value when the entry reports a failure.
+ */
+type LogContext = {
+  scope?: string;
+  error?: unknown;
+  [key: string]: unknown;
+};
+type LogFn = (message: string, context?: LogContext) => void;
+/**
+ * Sink that receives Hydrogen log entries. Pass your own logger to
+ * `configureLogging`, or rely on the built-in console logger.
+ *
+ * Messages arrive unprefixed; `context.scope` identifies the subsystem so
+ * custom sinks control their own formatting. The built-in console logger
+ * formats entries as `[hydrogen:<level>:<scope>] <message>`.
+ */
+interface HydrogenLogger {
+  trace: LogFn;
+  debug: LogFn;
+  info: LogFn;
+  warn: LogFn;
+  error: LogFn;
+  fatal: LogFn;
+}
+//#endregion
+export { HydrogenLogger, LogContext, LogLevel };
+//# sourceMappingURL=types.d.mts.map

package/dist/core/logging/types.mjs

@@ -0,0 +1,18 @@
+//#region src/core/logging/types.ts
+const DEFAULT_LOG_LEVEL = "info";
+const LOG_LEVEL_VALUES = {
+	trace: 10,
+	debug: 20,
+	info: 30,
+	warn: 40,
+	error: 50,
+	fatal: 60,
+	silent: Number.POSITIVE_INFINITY
+};
+function isLevelEnabled(level, threshold) {
+	return LOG_LEVEL_VALUES[level] >= LOG_LEVEL_VALUES[threshold];
+}
+
+//#endregion
+export { DEFAULT_LOG_LEVEL, isLevelEnabled };
+//# sourceMappingURL=types.mjs.map

package/dist/core/logging/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","names":[],"sources":["../../../src/core/logging/types.ts"],"sourcesContent":["/**\n * Logging contract for `@shopify/hydrogen` runtime failures.\n *\n * The interface is intentionally minimal and structural: any logger with these\n * level methods can receive Hydrogen entries. Hydrogen never depends on a\n * specific logging library.\n */\n\n/** Log severities, ordered. `silent` disables all output. */\nexport type LogLevel = \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\" | \"silent\";\n\n/**\n * Structured details attached to a log entry. `scope` names the Hydrogen\n * subsystem (`cart`, `analytics`, `shop-pay`, ...). `error` carries the caught\n * value when the entry reports a failure.\n */\nexport type LogContext = {\n  scope?: string;\n  error?: unknown;\n  [key: string]: unknown;\n};\n\ntype LogFn = (message: string, context?: LogContext) => void;\n\n/**\n * Sink that receives Hydrogen log entries. Pass your own logger to\n * `configureLogging`, or rely on the built-in console logger.\n *\n * Messages arrive unprefixed; `context.scope` identifies the subsystem so\n * custom sinks control their own formatting. The built-in console logger\n * formats entries as `[hydrogen:<level>:<scope>] <message>`.\n */\nexport interface HydrogenLogger {\n  trace: LogFn;\n  debug: LogFn;\n  info: LogFn;\n  warn: LogFn;\n  error: LogFn;\n  fatal: LogFn;\n}\n\nexport const DEFAULT_LOG_LEVEL: LogLevel = \"info\";\n\nconst LOG_LEVEL_VALUES: Record<LogLevel, number> = {\n  trace: 10,\n  debug: 20,\n  info: 30,\n  warn: 40,\n  error: 50,\n  fatal: 60,\n  silent: Number.POSITIVE_INFINITY,\n};\n\n/** Severity actually emitted by a log entry (everything except `silent`). */\nexport type LogSeverity = Exclude<LogLevel, \"silent\">;\n\nexport function isLevelEnabled(level: LogSeverity, threshold: LogLevel): boolean {\n  return LOG_LEVEL_VALUES[level] >= LOG_LEVEL_VALUES[threshold];\n}\n"],"mappings":";AAyCA,MAAa,oBAA8B;AAE3C,MAAM,mBAA6C;CACjD,OAAO;CACP,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACP,QAAQ,OAAO;CAChB;AAKD,SAAgB,eAAe,OAAoB,WAA8B;AAC/E,QAAO,iBAAiB,UAAU,iBAAiB"}

package/dist/core/money/cache.mjs

@@ -0,0 +1,25 @@
+//#region src/core/money/cache.ts
+/**
+* Module-scoped cache for Intl.NumberFormat instances.
+*
+* Constructing an Intl.NumberFormat is expensive — it resolves the locale
+* chain, loads currency data, and builds the formatting pattern. The
+* .format() call on an existing instance is cheap by comparison.
+*
+* In a storefront, the same locale + currency + options combination is
+* hit repeatedly (every cart line, every product in a collection grid),
+* so reusing instances avoids redundant construction.
+*/
+const formatterCache = /* @__PURE__ */ new Map();
+function getFormatter(locale, options) {
+	const key = `${locale}:${JSON.stringify(options)}`;
+	let formatter = formatterCache.get(key);
+	if (formatter) return formatter;
+	formatter = new Intl.NumberFormat(locale, options);
+	formatterCache.set(key, formatter);
+	return formatter;
+}
+
+//#endregion
+export { getFormatter };
+//# sourceMappingURL=cache.mjs.map

package/dist/core/money/cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.mjs","names":[],"sources":["../../../src/core/money/cache.ts"],"sourcesContent":["/**\n * Module-scoped cache for Intl.NumberFormat instances.\n *\n * Constructing an Intl.NumberFormat is expensive — it resolves the locale\n * chain, loads currency data, and builds the formatting pattern. The\n * .format() call on an existing instance is cheap by comparison.\n *\n * In a storefront, the same locale + currency + options combination is\n * hit repeatedly (every cart line, every product in a collection grid),\n * so reusing instances avoids redundant construction.\n */\nconst formatterCache = new Map<string, Intl.NumberFormat>();\n\nexport function getFormatter(locale: string, options: Intl.NumberFormatOptions): Intl.NumberFormat {\n  const key = `${locale}:${JSON.stringify(options)}`;\n\n  let formatter = formatterCache.get(key);\n  if (formatter) return formatter;\n\n  formatter = new Intl.NumberFormat(locale, options);\n  formatterCache.set(key, formatter);\n  return formatter;\n}\n"],"mappings":";;;;;;;;;;;;AAWA,MAAM,iCAAiB,IAAI,KAAgC;AAE3D,SAAgB,aAAa,QAAgB,SAAsD;CACjG,MAAM,MAAM,GAAG,OAAO,GAAG,KAAK,UAAU,QAAQ;CAEhD,IAAI,YAAY,eAAe,IAAI,IAAI;AACvC,KAAI,UAAW,QAAO;AAEtB,aAAY,IAAI,KAAK,aAAa,QAAQ,QAAQ;AAClD,gBAAe,IAAI,KAAK,UAAU;AAClC,QAAO"}

package/dist/core/money/format.d.mts

@@ -0,0 +1,15 @@
+import { FormatMoneyOptions, FormattedMoney, FormattedMoneyRange, MoneyV2 } from "./types.mjs";
+
+//#region src/core/money/format.d.ts
+/**
+ * Format a MoneyV2 value or a same-currency range of MoneyV2 values for display.
+ *
+ * Returns an object that stringifies to the locale-formatted price via
+ * toString(). Structured fields on single prices are computed lazily when
+ * accessed, so the common string path stays cheap.
+ */
+declare function formatMoney(money: MoneyV2, options: FormatMoneyOptions): FormattedMoney;
+declare function formatMoney(money: readonly MoneyV2[], options: FormatMoneyOptions): FormattedMoneyRange;
+//#endregion
+export { formatMoney };
+//# sourceMappingURL=format.d.mts.map