@shopify/hydrogen 2026.4.4 → 2026.10.0-preview.1

package/dist/development/core/product/state.d.mts

@@ -0,0 +1,68 @@
+//#region src/core/product/state.d.ts
+interface Money {
+  amount: string;
+  currencyCode: string;
+}
+interface ProductPriceRange {
+  minVariantPrice: Money;
+  maxVariantPrice?: Money;
+}
+interface SelectedOption {
+  name: string;
+  value: string;
+}
+interface ProductVariantInput {
+  id: string;
+  title: string;
+  availableForSale: boolean;
+  selectedOptions: SelectedOption[];
+  price: Money;
+  compareAtPrice?: Money | null;
+  image?: unknown;
+  product?: {
+    handle: string;
+    title?: string | null;
+  } | null;
+  sku?: string | null;
+}
+interface ProductOptionInput<TVariant extends ProductVariantInput = ProductVariantInput> {
+  name: string;
+  optionValues: Array<ProductOptionValueInput<TVariant>>;
+}
+interface ProductOptionValueInput<TVariant extends ProductVariantInput = ProductVariantInput> {
+  name: string;
+  firstSelectableVariant?: TVariant | null;
+  swatch?: unknown;
+}
+interface ProductInput<TVariant extends ProductVariantInput = ProductVariantInput> {
+  id: string;
+  title: string;
+  handle: string;
+  vendor?: string | null;
+  priceRange?: ProductPriceRange;
+  requiresSellingPlan?: boolean | null;
+  encodedVariantExistence?: string | null;
+  encodedVariantAvailability?: string | null;
+  options: ProductOptionInput<TVariant>[];
+  selectedOrFirstAvailableVariant: TVariant | null;
+  adjacentVariants: TVariant[];
+}
+type ProductVariantFrom<TProduct extends ProductInput> = TProduct extends ProductInput<infer TVariant> ? TVariant : ProductVariantInput;
+type ProductOptionValueFrom<TProduct extends ProductInput> = TProduct["options"][number]["optionValues"][number];
+interface VariantOptionValueState<TVariant extends ProductVariantInput = ProductVariantInput, TOptionValue extends ProductOptionValueInput = ProductOptionValueInput> {
+  name: string;
+  swatch?: TOptionValue["swatch"];
+  selected: boolean;
+  exists: boolean;
+  available: boolean;
+  variant: TVariant | null;
+  selectedOptions: SelectedOption[];
+  handle: string;
+}
+interface VariantOptionState<TVariant extends ProductVariantInput = ProductVariantInput, TOptionValue extends ProductOptionValueInput = ProductOptionValueInput> {
+  name: string;
+  values: VariantOptionValueState<TVariant, TOptionValue>[];
+}
+//#endregion
+export { ProductInput, ProductOptionInput, ProductOptionValueFrom, ProductOptionValueInput, ProductVariantFrom, ProductVariantInput, SelectedOption, VariantOptionState, VariantOptionValueState };
+//# sourceMappingURL=state.d.mts.map

package/dist/development/core/request-context.d.mts

@@ -0,0 +1,70 @@
+import { CountryCode, LanguageCode } from "../graphql/generated/customer-account-api-types.mjs";
+import { CountryCode as CountryCode$1, LanguageCode as LanguageCode$1 } from "../graphql/generated/storefront-api-types.mjs";
+
+//#region src/core/request-context.d.ts
+type StorefrontRequest = Pick<Request, "headers"> & Partial<Pick<Request, "method" | "signal" | "url">>;
+type ShopifyLanguageCode = Extract<LanguageCode$1, LanguageCode>;
+type ShopifyCountryCode = Extract<CountryCode$1, CountryCode>;
+type I18nConfig = {
+  language: ShopifyLanguageCode;
+  country: ShopifyCountryCode; /** Optional app route prefix for localized paths, for example "/es-es". */
+  pathPrefix?: string;
+};
+type NormalizedI18nConfig<I18n extends I18nConfig = I18nConfig> = Omit<I18n, "pathPrefix"> & {
+  pathPrefix: string;
+};
+type ShopifyRequestContextInputBase<I18n extends I18nConfig = I18nConfig> = {
+  request: StorefrontRequest;
+  i18n: I18n;
+};
+type ShopifyRequestContextInput<I18n extends I18nConfig = I18nConfig> = ShopifyRequestContextInputBase<I18n> & {
+  buyerIp?: never;
+};
+type ShopifyRequestContextWithBuyerIpInput<I18n extends I18nConfig = I18nConfig> = ShopifyRequestContextInputBase<I18n> & {
+  buyerIp: string;
+};
+type ShopifyRequestContextBase = {
+  /**
+   * Compile-time brand so callers use createShopifyRequestContext().
+   * @internal
+   */
+  readonly __hydrogenShopifyRequestContextBrand: never; /** @internal */
+  cookie?: string; /** @internal */
+  uniqueToken?: string; /** @internal */
+  visitToken?: string; /** @internal */
+  legacyTokens?: boolean; /** @internal */
+  readonly buyerIp?: string; /** @internal */
+  requestGroupId: string; /** @internal */
+  signal?: AbortSignal; /** @internal */
+  url?: string; /** @internal */
+  storefrontOrigin?: string;
+  /**
+   * Apply request-scoped headers required by every Shopify storefront subrequest.
+   * @internal
+   */
+  applyStorefrontRequestHeaders(headers: Headers): void;
+  /**
+   * Capture the first fresh SFAPI response headers for replay onto the final app response.
+   * @internal
+   */
+  captureSubrequestHeaders(headers: Headers): void;
+  /**
+   * Mark the final app response as influenced by private customer state.
+   * @internal
+   */
+  markResponseAsPersonalized(reason: string): void;
+  i18n: NormalizedI18nConfig; /** Return incoming request headers plus request lifecycle headers for proxy/origin handoff. */
+  getForwardedRequestHeaders(): Headers; /** Apply important response headers for the correct functioning of Hydrogen storefronts. */
+  applyResponseHeaders(headers: Headers): void;
+};
+type ShopifyRequestContext<I18n extends I18nConfig = I18nConfig> = ShopifyRequestContextBase & {
+  i18n: NormalizedI18nConfig<I18n>;
+};
+type ShopifyRequestContextWithBuyerIp<I18n extends I18nConfig = I18nConfig> = ShopifyRequestContext<I18n> & {
+  readonly buyerIp: string;
+};
+declare function createShopifyRequestContext<const I18n extends I18nConfig>(input: ShopifyRequestContextWithBuyerIpInput<I18n>): ShopifyRequestContextWithBuyerIp<I18n>;
+declare function createShopifyRequestContext<const I18n extends I18nConfig>(input: ShopifyRequestContextInput<I18n>): ShopifyRequestContext<I18n>;
+//#endregion
+export { I18nConfig, ShopifyRequestContext, ShopifyRequestContextWithBuyerIp, createShopifyRequestContext };
+//# sourceMappingURL=request-context.d.mts.map

package/dist/development/core/request-context.mjs

@@ -0,0 +1,120 @@
+import { normalizePathPrefix } from "./standard-routes/path.mjs";
+import { HYDROGEN_VERSION_HEADER, REQUEST_GROUP_ID_HEADER, SDK_VARIANT_HEADER, SDK_VARIANT_SOURCE_HEADER, SDK_VERSION_HEADER, SERVER_TIMING_HEADER, SHOPIFY_STOREFRONT_ORIGIN_HEADER, SHOPIFY_STOREFRONT_S_HEADER, SHOPIFY_STOREFRONT_Y_HEADER, SHOPIFY_UNIQUE_TOKEN_HEADER, SHOPIFY_VISIT_TOKEN_HEADER, STOREFRONT_URL_HEADER, applyPrivateResponseCacheHeaders } from "./headers.mjs";
+import { STOREFRONT_API_VERSION } from "./constants.mjs";
+
+//#region src/core/request-context.ts
+const UNIQUE_TOKEN_MARKER = "_y";
+const VISIT_TOKEN_MARKER = "_s";
+function createShopifyRequestContext(input) {
+	const { request } = input;
+	if (!input.i18n?.country || !input.i18n?.language) throw new Error("i18n with country and language is required for Shopify request contexts.");
+	if (input.buyerIp !== void 0 && !input.buyerIp) throw new Error("buyerIp must be non-empty when provided");
+	const i18n = normalizeI18n(input.i18n);
+	const cookie = request.headers.get("cookie") || void 0;
+	const url = request.url ?? request.headers.get("x-storefront-url") ?? void 0;
+	const storefrontOrigin = getUrlOrigin(url);
+	const context = {
+		...cookie && { cookie },
+		i18n,
+		...url && { url },
+		...storefrontOrigin && { storefrontOrigin },
+		...input.buyerIp && { buyerIp: input.buyerIp },
+		requestGroupId: request.headers.get("Custom-Storefront-Request-Group-ID") ?? request.headers.get("x-request-id") ?? request.headers.get("request-id") ?? crypto.randomUUID(),
+		...isDocumentRequest(request) && { documentRequest: true },
+		...request.signal && { signal: request.signal }
+	};
+	let capturedSubrequestHeaders;
+	let personalizedResponseReason;
+	if (!cookie || !/\b_shopify_(analytics|marketing)=/.test(cookie)) {
+		const legacyUniqueToken = cookie?.match(/\b_shopify_y=([^;]+)/)?.[1];
+		const legacyVisitToken = cookie?.match(/\b_shopify_s=([^;]+)/)?.[1];
+		const headerUniqueToken = request.headers.get("X-Shopify-UniqueToken") ?? void 0;
+		const headerVisitToken = request.headers.get("X-Shopify-VisitToken") ?? void 0;
+		if (legacyUniqueToken || legacyVisitToken) context.legacyTokens = true;
+		context.uniqueToken = legacyUniqueToken ?? headerUniqueToken ?? crypto.randomUUID();
+		context.visitToken = legacyVisitToken ?? headerVisitToken ?? crypto.randomUUID();
+	}
+	return {
+		...context,
+		getForwardedRequestHeaders() {
+			const headers = new Headers(request.headers);
+			applyStorefrontRequestHeaders(context, headers);
+			if (context.url) headers.set(STOREFRONT_URL_HEADER, context.url);
+			return headers;
+		},
+		applyStorefrontRequestHeaders(headers) {
+			applyStorefrontRequestHeaders(context, headers);
+		},
+		captureSubrequestHeaders(headers) {
+			capturedSubrequestHeaders ??= {
+				serverTiming: headers.get("Server-Timing") ?? "",
+				setCookie: headers.getSetCookie()
+			};
+		},
+		markResponseAsPersonalized(reason) {
+			personalizedResponseReason ??= reason;
+		},
+		applyResponseHeaders(headers) {
+			headers.set("powered-by", "Shopify, Hydrogen");
+			if (capturedSubrequestHeaders) {
+				const existingSetCookies = headers.getSetCookie();
+				for (const value of capturedSubrequestHeaders.setCookie) {
+					if (existingSetCookies.includes(value)) continue;
+					headers.append("set-cookie", value);
+				}
+				const existingServerTiming = headers.get("Server-Timing") ?? "";
+				if (capturedSubrequestHeaders.serverTiming && !hasServerTimingValue(existingServerTiming, capturedSubrequestHeaders.serverTiming)) headers.append(SERVER_TIMING_HEADER, capturedSubrequestHeaders.serverTiming);
+			}
+			if (personalizedResponseReason) applyPrivateResponseCacheHeaders(headers);
+			if (!(headers.get("content-type")?.startsWith("text/html") ?? false) && !context.documentRequest) return;
+			const existing = headers.get("Server-Timing") ?? "";
+			if (context.uniqueToken && !hasServerTimingMetric(existing, UNIQUE_TOKEN_MARKER)) headers.append(SERVER_TIMING_HEADER, `${UNIQUE_TOKEN_MARKER};desc=${context.uniqueToken}`);
+			if (context.visitToken && !hasServerTimingMetric(existing, VISIT_TOKEN_MARKER)) headers.append(SERVER_TIMING_HEADER, `${VISIT_TOKEN_MARKER};desc=${context.visitToken}`);
+		}
+	};
+}
+function normalizeI18n(i18n) {
+	return {
+		...i18n,
+		pathPrefix: normalizePathPrefix(i18n.pathPrefix)
+	};
+}
+function applyStorefrontRequestHeaders(context, headers) {
+	headers.set(SDK_VARIANT_HEADER, "hydrogen");
+	headers.set(SDK_VARIANT_SOURCE_HEADER, "kit");
+	headers.set(SDK_VERSION_HEADER, STOREFRONT_API_VERSION);
+	headers.set(HYDROGEN_VERSION_HEADER, "2026.10.0-preview.1");
+	headers.set(REQUEST_GROUP_ID_HEADER, context.requestGroupId);
+	if (context.cookie) headers.set("cookie", context.cookie);
+	else headers.delete("cookie");
+	if (context.storefrontOrigin) headers.set(SHOPIFY_STOREFRONT_ORIGIN_HEADER, context.storefrontOrigin);
+	else headers.delete(SHOPIFY_STOREFRONT_ORIGIN_HEADER);
+	if (context.uniqueToken) headers.set(SHOPIFY_UNIQUE_TOKEN_HEADER, context.uniqueToken);
+	if (context.visitToken) headers.set(SHOPIFY_VISIT_TOKEN_HEADER, context.visitToken);
+	if (context.legacyTokens && context.uniqueToken) headers.set(SHOPIFY_STOREFRONT_Y_HEADER, context.uniqueToken);
+	if (context.legacyTokens && context.visitToken) headers.set(SHOPIFY_STOREFRONT_S_HEADER, context.visitToken);
+}
+function getUrlOrigin(url) {
+	if (!url) return void 0;
+	try {
+		return new URL(url).origin;
+	} catch {
+		return;
+	}
+}
+function isDocumentRequest(request) {
+	if (request.method && request.method !== "GET" && request.method !== "HEAD") return false;
+	if (request.headers.get("sec-fetch-dest") === "document") return true;
+	return request.headers.get("accept")?.includes("text/html") ?? false;
+}
+function hasServerTimingMetric(value, name) {
+	return value.split(",").some((part) => part.trim().startsWith(`${name};`));
+}
+function hasServerTimingValue(existing, next) {
+	const existingParts = new Set(existing.split(",").map((part) => part.trim()));
+	return next.split(",").every((part) => existingParts.has(part.trim()));
+}
+
+//#endregion
+export { createShopifyRequestContext };
+//# sourceMappingURL=request-context.mjs.map

package/dist/development/core/request-context.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.mjs","names":[],"sources":["../../../src/core/request-context.ts"],"sourcesContent":["import type {\n  CountryCode as CustomerAccountCountryCode,\n  LanguageCode as CustomerAccountLanguageCode,\n} from \"../graphql/generated/customer-account-api-types\";\nimport type {\n  CountryCode as StorefrontCountryCode,\n  LanguageCode as StorefrontLanguageCode,\n} from \"../graphql/generated/storefront-api-types\";\nimport { STOREFRONT_API_VERSION } from \"./constants\";\nimport {\n  applyPrivateResponseCacheHeaders,\n  HYDROGEN_VERSION_HEADER,\n  REQUEST_GROUP_ID_HEADER,\n  SDK_VARIANT_HEADER,\n  SDK_VARIANT_SOURCE_HEADER,\n  SDK_VERSION_HEADER,\n  SERVER_TIMING_HEADER,\n  SHOPIFY_STOREFRONT_ORIGIN_HEADER,\n  SHOPIFY_STOREFRONT_S_HEADER,\n  SHOPIFY_STOREFRONT_Y_HEADER,\n  SHOPIFY_UNIQUE_TOKEN_HEADER,\n  SHOPIFY_VISIT_TOKEN_HEADER,\n  STOREFRONT_URL_HEADER,\n} from \"./headers\";\nimport { normalizePathPrefix } from \"./standard-routes/path\";\n\nconst UNIQUE_TOKEN_MARKER = \"_y\";\nconst VISIT_TOKEN_MARKER = \"_s\";\n\ntype StorefrontRequest = Pick<Request, \"headers\"> &\n  Partial<Pick<Request, \"method\" | \"signal\" | \"url\">>;\n\nexport type ShopifyLanguageCode = Extract<StorefrontLanguageCode, CustomerAccountLanguageCode>;\nexport type ShopifyCountryCode = Extract<StorefrontCountryCode, CustomerAccountCountryCode>;\n\nexport type I18nConfig = {\n  language: ShopifyLanguageCode;\n  country: ShopifyCountryCode;\n  /** Optional app route prefix for localized paths, for example \"/es-es\". */\n  pathPrefix?: string;\n};\n\ntype NormalizedI18nConfig<I18n extends I18nConfig = I18nConfig> = Omit<I18n, \"pathPrefix\"> & {\n  pathPrefix: string;\n};\n\ntype ShopifyRequestContextInputBase<I18n extends I18nConfig = I18nConfig> = {\n  request: StorefrontRequest;\n  i18n: I18n;\n};\n\ntype ShopifyRequestContextInput<I18n extends I18nConfig = I18nConfig> =\n  ShopifyRequestContextInputBase<I18n> & { buyerIp?: never };\n\ntype ShopifyRequestContextWithBuyerIpInput<I18n extends I18nConfig = I18nConfig> =\n  ShopifyRequestContextInputBase<I18n> & { buyerIp: string };\n\ntype ShopifyRequestContextBase = {\n  // -- Private fields --\n  /**\n   * Compile-time brand so callers use createShopifyRequestContext().\n   * @internal\n   */\n  readonly __hydrogenShopifyRequestContextBrand: never;\n  /** @internal */\n  cookie?: string;\n  /** @internal */\n  uniqueToken?: string;\n  /** @internal */\n  visitToken?: string;\n  /** @internal */\n  legacyTokens?: boolean;\n  /** @internal */\n  readonly buyerIp?: string;\n  /** @internal */\n  requestGroupId: string;\n  /** @internal */\n  signal?: AbortSignal;\n  /** @internal */\n  url?: string;\n  /** @internal */\n  storefrontOrigin?: string;\n  /**\n   * Apply request-scoped headers required by every Shopify storefront subrequest.\n   * @internal\n   */\n  applyStorefrontRequestHeaders(headers: Headers): void;\n  /**\n   * Capture the first fresh SFAPI response headers for replay onto the final app response.\n   * @internal\n   */\n  captureSubrequestHeaders(headers: Headers): void;\n  /**\n   * Mark the final app response as influenced by private customer state.\n   * @internal\n   */\n  markResponseAsPersonalized(reason: string): void;\n\n  // -- Public fields --\n  i18n: NormalizedI18nConfig;\n  /** Return incoming request headers plus request lifecycle headers for proxy/origin handoff. */\n  getForwardedRequestHeaders(): Headers;\n  /** Apply important response headers for the correct functioning of Hydrogen storefronts. */\n  applyResponseHeaders(headers: Headers): void;\n};\n\nexport type ShopifyRequestContext<I18n extends I18nConfig = I18nConfig> =\n  ShopifyRequestContextBase & {\n    i18n: NormalizedI18nConfig<I18n>;\n  };\n\nexport type ShopifyRequestContextWithBuyerIp<I18n extends I18nConfig = I18nConfig> =\n  ShopifyRequestContext<I18n> & { readonly buyerIp: string };\n\ntype Context<I18n extends I18nConfig = I18nConfig> = {\n  cookie?: string;\n  uniqueToken?: string;\n  visitToken?: string;\n  legacyTokens?: boolean;\n  buyerIp?: string;\n  requestGroupId: string;\n  signal?: AbortSignal;\n  url?: string;\n  storefrontOrigin?: string;\n  i18n: NormalizedI18nConfig<I18n>;\n  documentRequest?: boolean;\n};\n\nexport function createShopifyRequestContext<const I18n extends I18nConfig>(\n  input: ShopifyRequestContextWithBuyerIpInput<I18n>,\n): ShopifyRequestContextWithBuyerIp<I18n>;\nexport function createShopifyRequestContext<const I18n extends I18nConfig>(\n  input: ShopifyRequestContextInput<I18n>,\n): ShopifyRequestContext<I18n>;\nexport function createShopifyRequestContext<const I18n extends I18nConfig>(\n  input: ShopifyRequestContextInputBase<I18n> & { buyerIp?: string },\n): ShopifyRequestContext<I18n> {\n  const { request } = input;\n\n  if (!input.i18n?.country || !input.i18n?.language) {\n    throw new Error(\"i18n with country and language is required for Shopify request contexts.\");\n  }\n\n  if (input.buyerIp !== undefined && !input.buyerIp) {\n    throw new Error(\"buyerIp must be non-empty when provided\");\n  }\n\n  const i18n = normalizeI18n(input.i18n);\n  const cookie = request.headers.get(\"cookie\") || undefined;\n  const url = request.url ?? request.headers.get(STOREFRONT_URL_HEADER) ?? undefined;\n  const storefrontOrigin = getUrlOrigin(url);\n  const context = {\n    ...(cookie && { cookie }),\n    i18n,\n    ...(url && { url }),\n    ...(storefrontOrigin && { storefrontOrigin }),\n    ...(input.buyerIp && { buyerIp: input.buyerIp }),\n    requestGroupId:\n      request.headers.get(REQUEST_GROUP_ID_HEADER) ??\n      request.headers.get(\"x-request-id\") ??\n      request.headers.get(\"request-id\") ??\n      crypto.randomUUID(),\n    ...(isDocumentRequest(request) && { documentRequest: true }),\n    ...(request.signal && { signal: request.signal }),\n  } as Context<I18n>;\n\n  let capturedSubrequestHeaders:\n    | {\n        serverTiming: string;\n        setCookie: string[];\n      }\n    | undefined;\n  let personalizedResponseReason: string | undefined;\n\n  if (!cookie || !/\\b_shopify_(analytics|marketing)=/.test(cookie)) {\n    const legacyUniqueToken = cookie?.match(/\\b_shopify_y=([^;]+)/)?.[1];\n    const legacyVisitToken = cookie?.match(/\\b_shopify_s=([^;]+)/)?.[1];\n    const headerUniqueToken = request.headers.get(SHOPIFY_UNIQUE_TOKEN_HEADER) ?? undefined;\n    const headerVisitToken = request.headers.get(SHOPIFY_VISIT_TOKEN_HEADER) ?? undefined;\n\n    if (legacyUniqueToken || legacyVisitToken) context.legacyTokens = true;\n\n    context.uniqueToken = legacyUniqueToken ?? headerUniqueToken ?? crypto.randomUUID();\n    context.visitToken = legacyVisitToken ?? headerVisitToken ?? crypto.randomUUID();\n  }\n\n  return {\n    ...context,\n    getForwardedRequestHeaders() {\n      const headers = new Headers(request.headers);\n      applyStorefrontRequestHeaders(context, headers);\n      if (context.url) headers.set(STOREFRONT_URL_HEADER, context.url);\n      return headers;\n    },\n    applyStorefrontRequestHeaders(headers) {\n      applyStorefrontRequestHeaders(context, headers);\n    },\n    captureSubrequestHeaders(headers) {\n      // Capture this the first time we get a fresh response to increase the\n      // chance of returning it from the main server response. The main response\n      // needs headers set at send time, while the body can stream later, so this\n      // may not be used if subrequests finish after the main response is sent.\n      capturedSubrequestHeaders ??= {\n        serverTiming: headers.get(SERVER_TIMING_HEADER) ?? \"\",\n        setCookie: headers.getSetCookie(),\n      };\n    },\n    markResponseAsPersonalized(reason) {\n      personalizedResponseReason ??= reason;\n    },\n    applyResponseHeaders(headers) {\n      headers.set(\"powered-by\", \"Shopify, Hydrogen\");\n\n      if (capturedSubrequestHeaders) {\n        const existingSetCookies = headers.getSetCookie();\n        for (const value of capturedSubrequestHeaders.setCookie) {\n          if (existingSetCookies.includes(value)) continue;\n          headers.append(\"set-cookie\", value);\n        }\n        const existingServerTiming = headers.get(SERVER_TIMING_HEADER) ?? \"\";\n        if (\n          capturedSubrequestHeaders.serverTiming &&\n          !hasServerTimingValue(existingServerTiming, capturedSubrequestHeaders.serverTiming)\n        ) {\n          headers.append(SERVER_TIMING_HEADER, capturedSubrequestHeaders.serverTiming);\n        }\n      }\n\n      if (personalizedResponseReason) {\n        applyPrivateResponseCacheHeaders(headers);\n      }\n\n      // Generated fallback tokens are only for document navigation bootstrap.\n      const isHtmlResponse = headers.get(\"content-type\")?.startsWith(\"text/html\") ?? false;\n      if (!isHtmlResponse && !context.documentRequest) return;\n\n      const existing = headers.get(SERVER_TIMING_HEADER) ?? \"\";\n      if (context.uniqueToken && !hasServerTimingMetric(existing, UNIQUE_TOKEN_MARKER)) {\n        headers.append(SERVER_TIMING_HEADER, `${UNIQUE_TOKEN_MARKER};desc=${context.uniqueToken}`);\n      }\n      if (context.visitToken && !hasServerTimingMetric(existing, VISIT_TOKEN_MARKER)) {\n        headers.append(SERVER_TIMING_HEADER, `${VISIT_TOKEN_MARKER};desc=${context.visitToken}`);\n      }\n    },\n  } as ShopifyRequestContext<I18n>;\n}\n\nfunction normalizeI18n<I18n extends I18nConfig>(i18n: I18n): NormalizedI18nConfig<I18n> {\n  return {\n    ...i18n,\n    pathPrefix: normalizePathPrefix(i18n.pathPrefix),\n  } as NormalizedI18nConfig<I18n>;\n}\n\nfunction applyStorefrontRequestHeaders(context: Context, headers: Headers): void {\n  headers.set(SDK_VARIANT_HEADER, \"hydrogen\");\n  headers.set(SDK_VARIANT_SOURCE_HEADER, \"kit\");\n  headers.set(SDK_VERSION_HEADER, STOREFRONT_API_VERSION);\n  headers.set(HYDROGEN_VERSION_HEADER, __HYDROGEN_VERSION__);\n  headers.set(REQUEST_GROUP_ID_HEADER, context.requestGroupId);\n\n  if (context.cookie) headers.set(\"cookie\", context.cookie);\n  else headers.delete(\"cookie\");\n  if (context.storefrontOrigin) {\n    headers.set(SHOPIFY_STOREFRONT_ORIGIN_HEADER, context.storefrontOrigin);\n  } else headers.delete(SHOPIFY_STOREFRONT_ORIGIN_HEADER);\n\n  if (context.uniqueToken) headers.set(SHOPIFY_UNIQUE_TOKEN_HEADER, context.uniqueToken);\n  if (context.visitToken) headers.set(SHOPIFY_VISIT_TOKEN_HEADER, context.visitToken);\n  if (context.legacyTokens && context.uniqueToken) {\n    headers.set(SHOPIFY_STOREFRONT_Y_HEADER, context.uniqueToken);\n  }\n  if (context.legacyTokens && context.visitToken) {\n    headers.set(SHOPIFY_STOREFRONT_S_HEADER, context.visitToken);\n  }\n}\n\nfunction getUrlOrigin(url: string | undefined): string | undefined {\n  if (!url) return undefined;\n  try {\n    return new URL(url).origin;\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isDocumentRequest(request: StorefrontRequest): boolean {\n  if (request.method && request.method !== \"GET\" && request.method !== \"HEAD\") return false;\n\n  const destination = request.headers.get(\"sec-fetch-dest\");\n  if (destination === \"document\") return true;\n\n  return request.headers.get(\"accept\")?.includes(\"text/html\") ?? false;\n}\n\nfunction hasServerTimingMetric(value: string, name: string): boolean {\n  return value.split(\",\").some((part) => part.trim().startsWith(`${name};`));\n}\n\nfunction hasServerTimingValue(existing: string, next: string): boolean {\n  const existingParts = new Set(existing.split(\",\").map((part) => part.trim()));\n  return next.split(\",\").every((part) => existingParts.has(part.trim()));\n}\n"],"mappings":"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"}

package/dist/development/core/request-routing/handle-shopify-redirects.d.mts

@@ -0,0 +1,17 @@
+import { StorefrontClient } from "../../client/types.mjs";
+import { ShopifyRouteTemplates } from "../standard-routes/types.mjs";
+
+//#region src/core/request-routing/handle-shopify-redirects.d.ts
+type RedirectOptions = {
+  request: Request;
+  storefrontClient: StorefrontClient;
+  routeTemplates: ShopifyRouteTemplates;
+};
+/**
+ * Resolves Shopify redirects after framework routing returns a 404. Matched
+ * responses already include request-context response headers.
+ */
+declare function handleShopifyRedirects(options: RedirectOptions): Promise<Response | null>;
+//#endregion
+export { RedirectOptions, handleShopifyRedirects };
+//# sourceMappingURL=handle-shopify-redirects.d.mts.map

package/dist/development/core/request-routing/handle-shopify-redirects.mjs

@@ -0,0 +1,31 @@
+import { getLogger } from "../logging/logging.mjs";
+import { handleAdminRedirect } from "./interceptors/admin-redirect.mjs";
+import { handleQueryParamRedirect } from "./interceptors/query-param-redirect.mjs";
+import { handleUrlRedirects } from "./interceptors/url-redirects.mjs";
+import { handleStandardRouteRedirects } from "./interceptors/standard-routes.mjs";
+import { safeApplyResponseHeaders } from "./safe-apply-response-headers.mjs";
+
+//#region src/core/request-routing/handle-shopify-redirects.ts
+const log = getLogger("redirects");
+/**
+* Resolves Shopify redirects after framework routing returns a 404. Matched
+* responses already include request-context response headers.
+*/
+async function handleShopifyRedirects(options) {
+	const { request, storefrontClient } = options;
+	let redirect = null;
+	try {
+		redirect = handleAdminRedirect(options);
+		redirect ??= handleStandardRouteRedirects(options);
+		redirect ??= handleQueryParamRedirect(request);
+		redirect ??= await handleUrlRedirects(options);
+	} catch (error) {
+		const url = new URL(request.url);
+		log.error(`failed to resolve Shopify redirects for route ${url.pathname}`, { error });
+	}
+	return redirect ? safeApplyResponseHeaders(redirect, storefrontClient.requestContext) : null;
+}
+
+//#endregion
+export { handleShopifyRedirects };
+//# sourceMappingURL=handle-shopify-redirects.mjs.map

package/dist/development/core/request-routing/handle-shopify-redirects.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-shopify-redirects.mjs","names":[],"sources":["../../../../src/core/request-routing/handle-shopify-redirects.ts"],"sourcesContent":["import type { StorefrontClient } from \"../../client\";\nimport { getLogger } from \"../logging\";\nimport type { ShopifyRouteTemplates } from \"../standard-routes/index\";\nimport { handleAdminRedirect } from \"./interceptors/admin-redirect\";\nimport { handleQueryParamRedirect } from \"./interceptors/query-param-redirect\";\nimport { handleStandardRouteRedirects } from \"./interceptors/standard-routes\";\nimport { handleUrlRedirects } from \"./interceptors/url-redirects\";\nimport { safeApplyResponseHeaders } from \"./safe-apply-response-headers\";\n\nconst log = getLogger(\"redirects\");\n\nexport type RedirectOptions = {\n  request: Request;\n  storefrontClient: StorefrontClient;\n  routeTemplates: ShopifyRouteTemplates;\n};\n\n/**\n * Resolves Shopify redirects after framework routing returns a 404. Matched\n * responses already include request-context response headers.\n */\nexport async function handleShopifyRedirects(options: RedirectOptions): Promise<Response | null> {\n  const { request, storefrontClient } = options;\n  let redirect: Response | null = null;\n\n  try {\n    redirect = handleAdminRedirect(options);\n    redirect ??= handleStandardRouteRedirects(options);\n    redirect ??= handleQueryParamRedirect(request);\n    redirect ??= await handleUrlRedirects(options);\n  } catch (error) {\n    const url = new URL(request.url);\n    log.error(`failed to resolve Shopify redirects for route ${url.pathname}`, { error });\n  }\n\n  return redirect ? safeApplyResponseHeaders(redirect, storefrontClient.requestContext) : null;\n}\n"],"mappings":";;;;;;;;AASA,MAAM,MAAM,UAAU,YAAY;;;;;AAYlC,eAAsB,uBAAuB,SAAoD;CAC/F,MAAM,EAAE,SAAS,qBAAqB;CACtC,IAAI,WAA4B;AAEhC,KAAI;AACF,aAAW,oBAAoB,QAAQ;AACvC,eAAa,6BAA6B,QAAQ;AAClD,eAAa,yBAAyB,QAAQ;AAC9C,eAAa,MAAM,mBAAmB,QAAQ;UACvC,OAAO;EACd,MAAM,MAAM,IAAI,IAAI,QAAQ,IAAI;AAChC,MAAI,MAAM,iDAAiD,IAAI,YAAY,EAAE,OAAO,CAAC;;AAGvF,QAAO,WAAW,yBAAyB,UAAU,iBAAiB,eAAe,GAAG"}

package/dist/development/core/request-routing/handle-shopify-routes.d.mts

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

package/dist/development/core/request-routing/handle-shopify-routes.development.d.mts

@@ -0,0 +1,11 @@
+import { HydrogenRouteHandler } from "./route-types.mjs";
+import { GraphiQLOptions } from "../types.mjs";
+
+//#region src/core/request-routing/handle-shopify-routes.development.d.ts
+type HydrogenRoutesDevOptions = {
+  graphiql?: GraphiQLOptions;
+};
+declare const handleShopifyRoutesDev: HydrogenRouteHandler<HydrogenRoutesDevOptions>;
+//#endregion
+export { handleShopifyRoutesDev };
+//# sourceMappingURL=handle-shopify-routes.development.d.mts.map

package/dist/development/core/request-routing/handle-shopify-routes.development.mjs

@@ -0,0 +1,16 @@
+import { safeApplyResponseHeaders } from "./safe-apply-response-headers.mjs";
+import { handleShopifyRoutes } from "./handle-shopify-routes.mjs";
+import { handleGraphiql } from "./interceptors/graphiql.mjs";
+
+//#region src/core/request-routing/handle-shopify-routes.development.ts
+const handleShopifyRoutesDev = (options) => {
+	const productionResult = handleShopifyRoutes(options);
+	if (productionResult) return productionResult;
+	const graphiqlResult = handleGraphiql(new URL(options.request.url), options);
+	if (!graphiqlResult) return null;
+	return graphiqlResult.then((response) => safeApplyResponseHeaders(response, options.requestContext));
+};
+
+//#endregion
+export { handleShopifyRoutesDev };
+//# sourceMappingURL=handle-shopify-routes.development.mjs.map

package/dist/development/core/request-routing/handle-shopify-routes.development.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-shopify-routes.development.mjs","names":[],"sources":["../../../../src/core/request-routing/handle-shopify-routes.development.ts"],"sourcesContent":["import type { GraphiQLOptions } from \"../types\";\nimport { handleShopifyRoutes } from \"./handle-shopify-routes\";\nimport { handleGraphiql } from \"./interceptors/graphiql\";\nimport type { HydrogenRouteHandler } from \"./route-types\";\nimport { safeApplyResponseHeaders } from \"./safe-apply-response-headers\";\n\ntype HydrogenRoutesDevOptions = {\n  graphiql?: GraphiQLOptions;\n};\n\nexport const handleShopifyRoutesDev: HydrogenRouteHandler<HydrogenRoutesDevOptions> = (options) => {\n  const productionResult = handleShopifyRoutes(options);\n  if (productionResult) return productionResult;\n\n  const graphiqlResult = handleGraphiql(new URL(options.request.url), options);\n  if (!graphiqlResult) return null;\n\n  return graphiqlResult.then((response) =>\n    safeApplyResponseHeaders(response, options.requestContext),\n  );\n};\n"],"mappings":";;;;;AAUA,MAAa,0BAA0E,YAAY;CACjG,MAAM,mBAAmB,oBAAoB,QAAQ;AACrD,KAAI,iBAAkB,QAAO;CAE7B,MAAM,iBAAiB,eAAe,IAAI,IAAI,QAAQ,QAAQ,IAAI,EAAE,QAAQ;AAC5E,KAAI,CAAC,eAAgB,QAAO;AAE5B,QAAO,eAAe,MAAM,aAC1B,yBAAyB,UAAU,QAAQ,eAAe,CAC3D"}

package/dist/development/core/request-routing/handle-shopify-routes.mjs

@@ -0,0 +1,42 @@
+import { safeApplyResponseHeaders } from "./safe-apply-response-headers.mjs";
+import { handleAgentProxy } from "./interceptors/agent-proxy.mjs";
+import { handleAjaxApi } from "./interceptors/ajax-api.mjs";
+import { handleShopifyApiProxy } from "./interceptors/api-proxy.mjs";
+import { handleCheckoutRedirect } from "./interceptors/checkout.mjs";
+import { handleMcpProxy } from "./interceptors/mcp-proxy.mjs";
+import { handleSfapiProxy } from "./interceptors/sfapi-proxy.mjs";
+import { handleWellKnownProxy } from "./interceptors/well-known.mjs";
+import { handleShopifyRouteHandlers } from "./registered-routes.mjs";
+
+//#region src/core/request-routing/handle-shopify-routes.ts
+const SHOPIFY_ROUTE_INTERCEPTORS = [
+	handleShopifyApiProxy,
+	handleSfapiProxy,
+	handleShopifyRouteHandlers,
+	handleCheckoutRedirect,
+	handleWellKnownProxy,
+	handleMcpProxy,
+	handleAgentProxy,
+	handleAjaxApi
+];
+/**
+* Matches a request against Shopify standard routes and any registered handler
+* groups, returning a raw `Response` (redirect or JSON) when one matches, or
+* `null` when none do. Use it as the first step of request handling, before
+* framework routing. Matched responses already include request-context
+* response headers.
+*/
+const handleShopifyRoutes = (options) => {
+	if (options.requestContext !== options.storefrontClient.requestContext) throw new Error("handleShopifyRoutes must receive the same requestContext used by storefrontClient.");
+	const url = new URL(options.request.url);
+	for (const interceptor of SHOPIFY_ROUTE_INTERCEPTORS) {
+		const responsePromise = interceptor(url, options);
+		if (!responsePromise) continue;
+		return responsePromise.then((response) => safeApplyResponseHeaders(response, options.requestContext));
+	}
+	return null;
+};
+
+//#endregion
+export { handleShopifyRoutes };
+//# sourceMappingURL=handle-shopify-routes.mjs.map

package/dist/development/core/request-routing/handle-shopify-routes.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-shopify-routes.mjs","names":[],"sources":["../../../../src/core/request-routing/handle-shopify-routes.ts"],"sourcesContent":["import { handleAgentProxy } from \"./interceptors/agent-proxy\";\nimport { handleAjaxApi } from \"./interceptors/ajax-api\";\nimport { handleShopifyApiProxy } from \"./interceptors/api-proxy\";\nimport { handleCheckoutRedirect } from \"./interceptors/checkout\";\nimport { handleMcpProxy } from \"./interceptors/mcp-proxy\";\nimport { handleSfapiProxy } from \"./interceptors/sfapi-proxy\";\nimport { handleWellKnownProxy } from \"./interceptors/well-known\";\nimport { handleShopifyRouteHandlers } from \"./registered-routes\";\nimport type { HydrogenRouteHandler, HydrogenRouteInterceptor } from \"./route-types\";\nimport { safeApplyResponseHeaders } from \"./safe-apply-response-headers\";\n\nconst SHOPIFY_ROUTE_INTERCEPTORS = [\n  handleShopifyApiProxy,\n  handleSfapiProxy,\n  handleShopifyRouteHandlers,\n  handleCheckoutRedirect,\n  handleWellKnownProxy,\n  handleMcpProxy,\n  handleAgentProxy,\n  handleAjaxApi,\n] satisfies readonly HydrogenRouteInterceptor[];\n\n/**\n * Matches a request against Shopify standard routes and any registered handler\n * groups, returning a raw `Response` (redirect or JSON) when one matches, or\n * `null` when none do. Use it as the first step of request handling, before\n * framework routing. Matched responses already include request-context\n * response headers.\n */\nexport const handleShopifyRoutes: HydrogenRouteHandler = (options) => {\n  if (options.requestContext !== options.storefrontClient.requestContext) {\n    throw new Error(\n      \"handleShopifyRoutes must receive the same requestContext used by storefrontClient.\",\n    );\n  }\n\n  const url = new URL(options.request.url);\n\n  for (const interceptor of SHOPIFY_ROUTE_INTERCEPTORS) {\n    const responsePromise = interceptor(url, options);\n    if (!responsePromise) continue;\n\n    return responsePromise.then((response) =>\n      safeApplyResponseHeaders(response, options.requestContext),\n    );\n  }\n\n  return null;\n};\n"],"mappings":";;;;;;;;;;;AAWA,MAAM,6BAA6B;CACjC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;;AASD,MAAa,uBAA6C,YAAY;AACpE,KAAI,QAAQ,mBAAmB,QAAQ,iBAAiB,eACtD,OAAM,IAAI,MACR,qFACD;CAGH,MAAM,MAAM,IAAI,IAAI,QAAQ,QAAQ,IAAI;AAExC,MAAK,MAAM,eAAe,4BAA4B;EACpD,MAAM,kBAAkB,YAAY,KAAK,QAAQ;AACjD,MAAI,CAAC,gBAAiB;AAEtB,SAAO,gBAAgB,MAAM,aAC3B,yBAAyB,UAAU,QAAQ,eAAe,CAC3D;;AAGH,QAAO"}

package/dist/development/core/request-routing/interceptors/admin-redirect.mjs

@@ -0,0 +1,12 @@
+//#region src/core/request-routing/interceptors/admin-redirect.ts
+function handleAdminRedirect({ request, storefrontClient }) {
+	if (new URL(request.url).pathname !== "/admin") return null;
+	return new Response(null, {
+		status: 301,
+		headers: { location: new URL("/admin", storefrontClient.storeUrl).toString() }
+	});
+}
+
+//#endregion
+export { handleAdminRedirect };
+//# sourceMappingURL=admin-redirect.mjs.map

package/dist/development/core/request-routing/interceptors/admin-redirect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-redirect.mjs","names":[],"sources":["../../../../../src/core/request-routing/interceptors/admin-redirect.ts"],"sourcesContent":["import type { RedirectOptions } from \"../handle-shopify-redirects\";\n\ntype AdminRedirectOptions = Pick<RedirectOptions, \"request\" | \"storefrontClient\">;\n\nexport function handleAdminRedirect({\n  request,\n  storefrontClient,\n}: AdminRedirectOptions): Response | null {\n  const url = new URL(request.url);\n  if (url.pathname !== \"/admin\") return null;\n\n  return new Response(null, {\n    status: 301,\n    headers: { location: new URL(\"/admin\", storefrontClient.storeUrl).toString() },\n  });\n}\n"],"mappings":";AAIA,SAAgB,oBAAoB,EAClC,SACA,oBACwC;AAExC,KAAI,IADY,IAAI,QAAQ,IACrB,CAAC,aAAa,SAAU,QAAO;AAEtC,QAAO,IAAI,SAAS,MAAM;EACxB,QAAQ;EACR,SAAS,EAAE,UAAU,IAAI,IAAI,UAAU,iBAAiB,SAAS,CAAC,UAAU,EAAE;EAC/E,CAAC"}

package/dist/development/core/request-routing/interceptors/agent-proxy.mjs

@@ -0,0 +1,19 @@
+import { AGENT_REQUEST_HEADER_ALLOWLIST, SHOPIFY_CHAT_FRAME_ORIGIN_HEADER } from "../../headers.mjs";
+import { AGENT_BUYER_CLAIMS_RE } from "../../url.mjs";
+import { createProxyInterceptor } from "./proxy.mjs";
+
+//#region src/core/request-routing/interceptors/agent-proxy.ts
+const handleAgentProxy = createProxyInterceptor({
+	match: AGENT_BUYER_CLAIMS_RE,
+	headers: {
+		allow: AGENT_REQUEST_HEADER_ALLOWLIST,
+		prepare(headers, _options, url) {
+			headers.set(SHOPIFY_CHAT_FRAME_ORIGIN_HEADER, url.origin);
+		}
+	},
+	scope: "agent-proxy"
+});
+
+//#endregion
+export { handleAgentProxy };
+//# sourceMappingURL=agent-proxy.mjs.map

package/dist/development/core/request-routing/interceptors/agent-proxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-proxy.mjs","names":[],"sources":["../../../../../src/core/request-routing/interceptors/agent-proxy.ts"],"sourcesContent":["import { AGENT_REQUEST_HEADER_ALLOWLIST, SHOPIFY_CHAT_FRAME_ORIGIN_HEADER } from \"../../headers\";\nimport { AGENT_BUYER_CLAIMS_RE } from \"../../url\";\nimport { createProxyInterceptor } from \"./proxy\";\n\nexport const handleAgentProxy = createProxyInterceptor({\n  match: AGENT_BUYER_CLAIMS_RE,\n  headers: {\n    allow: AGENT_REQUEST_HEADER_ALLOWLIST,\n    prepare(headers, _options, url) {\n      headers.set(SHOPIFY_CHAT_FRAME_ORIGIN_HEADER, url.origin);\n    },\n  },\n  scope: \"agent-proxy\",\n});\n"],"mappings":";;;;;AAIA,MAAa,mBAAmB,uBAAuB;CACrD,OAAO;CACP,SAAS;EACP,OAAO;EACP,QAAQ,SAAS,UAAU,KAAK;AAC9B,WAAQ,IAAI,kCAAkC,IAAI,OAAO;;EAE5D;CACD,OAAO;CACR,CAAC"}

package/dist/development/core/request-routing/interceptors/ajax-api.mjs

@@ -0,0 +1,16 @@
+import { AJAX_API_REQUEST_HEADER_ALLOWLIST } from "../../headers.mjs";
+import { AJAX_CART_RE } from "../../url.mjs";
+import { createProxyInterceptor } from "./proxy.mjs";
+
+//#region src/core/request-routing/interceptors/ajax-api.ts
+const rewriteShopifyJsPathname = (pathname) => pathname.replace(/\.js$/i, ".json");
+const handleAjaxApi = createProxyInterceptor({
+	match: AJAX_CART_RE,
+	headers: { allow: AJAX_API_REQUEST_HEADER_ALLOWLIST },
+	rewritePathname: rewriteShopifyJsPathname,
+	scope: "ajax-api"
+});
+
+//#endregion
+export { handleAjaxApi, rewriteShopifyJsPathname };
+//# sourceMappingURL=ajax-api.mjs.map

package/dist/development/core/request-routing/interceptors/ajax-api.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ajax-api.mjs","names":[],"sources":["../../../../../src/core/request-routing/interceptors/ajax-api.ts"],"sourcesContent":["import { AJAX_API_REQUEST_HEADER_ALLOWLIST } from \"../../headers\";\nimport { AJAX_CART_RE } from \"../../url\";\nimport { createProxyInterceptor } from \"./proxy\";\n\n// Known workaround for Shopify server redirects on `.js` endpoints.\nexport const rewriteShopifyJsPathname = (pathname: string): string =>\n  pathname.replace(/\\.js$/i, \".json\");\n\nexport const handleAjaxApi = createProxyInterceptor({\n  match: AJAX_CART_RE,\n  headers: { allow: AJAX_API_REQUEST_HEADER_ALLOWLIST },\n  rewritePathname: rewriteShopifyJsPathname,\n  scope: \"ajax-api\",\n});\n"],"mappings":";;;;;AAKA,MAAa,4BAA4B,aACvC,SAAS,QAAQ,UAAU,QAAQ;AAErC,MAAa,gBAAgB,uBAAuB;CAClD,OAAO;CACP,SAAS,EAAE,OAAO,mCAAmC;CACrD,iBAAiB;CACjB,OAAO;CACR,CAAC"}

package/dist/development/core/request-routing/interceptors/api-proxy.mjs

@@ -0,0 +1,20 @@
+import { PROXY_REQUEST_HEADER_DENYLIST } from "../../headers.mjs";
+import { SHOPIFY_API_PROXY_PREFIX, SHOPIFY_API_PROXY_RE } from "../../url.mjs";
+import { createProxyInterceptor } from "./proxy.mjs";
+import { rewriteShopifyJsPathname } from "./ajax-api.mjs";
+
+//#region src/core/request-routing/interceptors/api-proxy.ts
+const handleShopifyApiProxy = createProxyInterceptor({
+	match: SHOPIFY_API_PROXY_RE,
+	headers: { deny: PROXY_REQUEST_HEADER_DENYLIST },
+	rewritePathname: (pathname) => {
+		const upstreamPathname = "/" + pathname.slice(SHOPIFY_API_PROXY_PREFIX.length).replace(/^\/+/, "");
+		if (upstreamPathname.startsWith("/cdn/")) throw new Error("CDN proxy is not supported.");
+		return rewriteShopifyJsPathname(upstreamPathname);
+	},
+	scope: "shopify-api-proxy"
+});
+
+//#endregion
+export { handleShopifyApiProxy };
+//# sourceMappingURL=api-proxy.mjs.map

package/dist/development/core/request-routing/interceptors/api-proxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-proxy.mjs","names":[],"sources":["../../../../../src/core/request-routing/interceptors/api-proxy.ts"],"sourcesContent":["import { PROXY_REQUEST_HEADER_DENYLIST } from \"../../headers\";\nimport { SHOPIFY_API_PROXY_PREFIX, SHOPIFY_API_PROXY_RE } from \"../../url\";\nimport { rewriteShopifyJsPathname } from \"./ajax-api\";\nimport { createProxyInterceptor } from \"./proxy\";\n\nexport const handleShopifyApiProxy = createProxyInterceptor({\n  match: SHOPIFY_API_PROXY_RE,\n  headers: { deny: PROXY_REQUEST_HEADER_DENYLIST },\n  rewritePathname: (pathname) => {\n    const upstreamPathname =\n      \"/\" + pathname.slice(SHOPIFY_API_PROXY_PREFIX.length).replace(/^\\/+/, \"\");\n\n    if (upstreamPathname.startsWith(\"/cdn/\")) {\n      throw new Error(\"CDN proxy is not supported.\");\n    }\n\n    return rewriteShopifyJsPathname(upstreamPathname);\n  },\n  scope: \"shopify-api-proxy\",\n});\n"],"mappings":";;;;;;AAKA,MAAa,wBAAwB,uBAAuB;CAC1D,OAAO;CACP,SAAS,EAAE,MAAM,+BAA+B;CAChD,kBAAkB,aAAa;EAC7B,MAAM,mBACJ,MAAM,SAAS,MAAM,yBAAyB,OAAO,CAAC,QAAQ,QAAQ,GAAG;AAE3E,MAAI,iBAAiB,WAAW,QAAQ,CACtC,OAAM,IAAI,MAAM,8BAA8B;AAGhD,SAAO,yBAAyB,iBAAiB;;CAEnD,OAAO;CACR,CAAC"}

package/dist/development/core/request-routing/interceptors/checkout.mjs

@@ -0,0 +1,58 @@
+import { getLogger } from "../../logging/logging.mjs";
+import { CHECKOUT_RE, isHydrogenServerHandoffPath } from "../../url.mjs";
+import { getCart, getCartId } from "../../cart/get-cart.mjs";
+
+//#region src/core/request-routing/interceptors/checkout.ts
+const log = getLogger("checkout");
+const MOCK_SHOP_CART_PERMALINK_ORIGIN = "https://demostore.mock.shop";
+const handleCheckoutRedirect = (url, { request, storefrontClient }) => {
+	if (!isHydrogenServerHandoffPath(url.pathname)) return null;
+	if (request.method !== "GET" && request.method !== "HEAD") return Promise.resolve(new Response("Method Not Allowed", { status: 405 }));
+	return (CHECKOUT_RE.test(url.pathname) ? getCheckoutRedirectUrl(request, storefrontClient) : getCartRedirectUrl(request, storefrontClient)).then((redirectUrl) => {
+		if (redirectUrl.pathname !== "/") {
+			mergeSearchParams(redirectUrl, url.searchParams);
+			redirectUrl.searchParams.set("payment", url.searchParams.get("payment") ?? "shop_pay");
+		}
+		return new Response(null, {
+			status: 302,
+			headers: { location: redirectUrl.toString() }
+		});
+	}).catch((error) => {
+		log.error("checkout redirect request failed", { error });
+		const message = error instanceof Error ? error.message : "Internal redirect error";
+		return new Response(JSON.stringify({ error: message }), {
+			status: 502,
+			headers: { "content-type": "application/json" }
+		});
+	});
+};
+async function getCheckoutRedirectUrl(request, storefrontClient) {
+	const cartId = getCartId(request);
+	if (!cartId) return new URL("/", request.url);
+	const result = await getCart(cartId, storefrontClient);
+	return result.cart?.checkoutUrl ? new URL(result.cart.checkoutUrl) : new URL("/", request.url);
+}
+async function getCartRedirectUrl(request, storefrontClient) {
+	const sourceUrl = new URL(request.url);
+	const redirectUrl = new URL(sourceUrl.pathname, getCartPermalinkOrigin(storefrontClient.storeUrl));
+	const cartId = getCartId(request);
+	if (!cartId) return redirectUrl;
+	try {
+		const result = await getCart(cartId, storefrontClient);
+		if (result.cart?.checkoutUrl) mergeSearchParams(redirectUrl, new URL(result.cart.checkoutUrl).searchParams);
+	} catch (error) {
+		log.warn("checkout redirect could not load cart permalink tracking params", { error });
+	}
+	return redirectUrl;
+}
+function getCartPermalinkOrigin(storeUrl) {
+	const url = new URL(storeUrl);
+	return url.hostname === "mock.shop" ? MOCK_SHOP_CART_PERMALINK_ORIGIN : url.origin;
+}
+function mergeSearchParams(target, source) {
+	for (const [key, value] of source) if (!target.searchParams.has(key)) target.searchParams.append(key, value);
+}
+
+//#endregion
+export { handleCheckoutRedirect };
+//# sourceMappingURL=checkout.mjs.map

package/dist/development/core/request-routing/interceptors/checkout.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.mjs","names":[],"sources":["../../../../../src/core/request-routing/interceptors/checkout.ts"],"sourcesContent":["import type { StorefrontClient } from \"../../../client\";\nimport { getCart, getCartId } from \"../../cart/get-cart\";\nimport { getLogger } from \"../../logging\";\nimport { CHECKOUT_RE, isHydrogenServerHandoffPath } from \"../../url\";\nimport type { HydrogenRouteInterceptor } from \"../route-types\";\n\nconst log = getLogger(\"checkout\");\nconst MOCK_SHOP_CART_PERMALINK_ORIGIN = \"https://demostore.mock.shop\";\n\nexport const handleCheckoutRedirect: HydrogenRouteInterceptor = (\n  url,\n  { request, storefrontClient },\n) => {\n  if (!isHydrogenServerHandoffPath(url.pathname)) {\n    return null;\n  }\n\n  if (request.method !== \"GET\" && request.method !== \"HEAD\") {\n    return Promise.resolve(new Response(\"Method Not Allowed\", { status: 405 }));\n  }\n\n  const redirectUrlPromise = CHECKOUT_RE.test(url.pathname)\n    ? getCheckoutRedirectUrl(request, storefrontClient)\n    : getCartRedirectUrl(request, storefrontClient);\n\n  return redirectUrlPromise\n    .then((redirectUrl) => {\n      if (redirectUrl.pathname !== \"/\") {\n        mergeSearchParams(redirectUrl, url.searchParams);\n        redirectUrl.searchParams.set(\"payment\", url.searchParams.get(\"payment\") ?? \"shop_pay\");\n      }\n\n      return new Response(null, {\n        status: 302,\n        headers: { location: redirectUrl.toString() },\n      });\n    })\n    .catch((error) => {\n      log.error(\"checkout redirect request failed\", { error });\n      const message = error instanceof Error ? error.message : \"Internal redirect error\";\n\n      return new Response(JSON.stringify({ error: message }), {\n        status: 502,\n        headers: { \"content-type\": \"application/json\" },\n      });\n    });\n};\n\nasync function getCheckoutRedirectUrl(\n  request: Request,\n  storefrontClient: StorefrontClient,\n): Promise<URL> {\n  const cartId = getCartId(request);\n  if (!cartId) return new URL(\"/\", request.url);\n\n  const result = await getCart(cartId, storefrontClient);\n  return result.cart?.checkoutUrl ? new URL(result.cart.checkoutUrl) : new URL(\"/\", request.url);\n}\n\nasync function getCartRedirectUrl(\n  request: Request,\n  storefrontClient: StorefrontClient,\n): Promise<URL> {\n  const sourceUrl = new URL(request.url);\n  const redirectUrl = new URL(\n    sourceUrl.pathname,\n    getCartPermalinkOrigin(storefrontClient.storeUrl),\n  );\n\n  const cartId = getCartId(request);\n  if (!cartId) return redirectUrl;\n\n  try {\n    const result = await getCart(cartId, storefrontClient);\n    if (result.cart?.checkoutUrl) {\n      mergeSearchParams(redirectUrl, new URL(result.cart.checkoutUrl).searchParams);\n    }\n  } catch (error) {\n    log.warn(\"checkout redirect could not load cart permalink tracking params\", { error });\n  }\n\n  return redirectUrl;\n}\n\nfunction getCartPermalinkOrigin(storeUrl: string): string {\n  const url = new URL(storeUrl);\n  return url.hostname === \"mock.shop\" ? MOCK_SHOP_CART_PERMALINK_ORIGIN : url.origin;\n}\n\nfunction mergeSearchParams(target: URL, source: URLSearchParams): void {\n  for (const [key, value] of source) {\n    if (!target.searchParams.has(key)) target.searchParams.append(key, value);\n  }\n}\n"],"mappings":";;;;;AAMA,MAAM,MAAM,UAAU,WAAW;AACjC,MAAM,kCAAkC;AAExC,MAAa,0BACX,KACA,EAAE,SAAS,uBACR;AACH,KAAI,CAAC,4BAA4B,IAAI,SAAS,CAC5C,QAAO;AAGT,KAAI,QAAQ,WAAW,SAAS,QAAQ,WAAW,OACjD,QAAO,QAAQ,QAAQ,IAAI,SAAS,sBAAsB,EAAE,QAAQ,KAAK,CAAC,CAAC;AAO7E,SAJ2B,YAAY,KAAK,IAAI,SAAS,GACrD,uBAAuB,SAAS,iBAAiB,GACjD,mBAAmB,SAAS,iBAAiB,EAG9C,MAAM,gBAAgB;AACrB,MAAI,YAAY,aAAa,KAAK;AAChC,qBAAkB,aAAa,IAAI,aAAa;AAChD,eAAY,aAAa,IAAI,WAAW,IAAI,aAAa,IAAI,UAAU,IAAI,WAAW;;AAGxF,SAAO,IAAI,SAAS,MAAM;GACxB,QAAQ;GACR,SAAS,EAAE,UAAU,YAAY,UAAU,EAAE;GAC9C,CAAC;GACF,CACD,OAAO,UAAU;AAChB,MAAI,MAAM,oCAAoC,EAAE,OAAO,CAAC;EACxD,MAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU;AAEzD,SAAO,IAAI,SAAS,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;GACtD,QAAQ;GACR,SAAS,EAAE,gBAAgB,oBAAoB;GAChD,CAAC;GACF;;AAGN,eAAe,uBACb,SACA,kBACc;CACd,MAAM,SAAS,UAAU,QAAQ;AACjC,KAAI,CAAC,OAAQ,QAAO,IAAI,IAAI,KAAK,QAAQ,IAAI;CAE7C,MAAM,SAAS,MAAM,QAAQ,QAAQ,iBAAiB;AACtD,QAAO,OAAO,MAAM,cAAc,IAAI,IAAI,OAAO,KAAK,YAAY,GAAG,IAAI,IAAI,KAAK,QAAQ,IAAI;;AAGhG,eAAe,mBACb,SACA,kBACc;CACd,MAAM,YAAY,IAAI,IAAI,QAAQ,IAAI;CACtC,MAAM,cAAc,IAAI,IACtB,UAAU,UACV,uBAAuB,iBAAiB,SAAS,CAClD;CAED,MAAM,SAAS,UAAU,QAAQ;AACjC,KAAI,CAAC,OAAQ,QAAO;AAEpB,KAAI;EACF,MAAM,SAAS,MAAM,QAAQ,QAAQ,iBAAiB;AACtD,MAAI,OAAO,MAAM,YACf,mBAAkB,aAAa,IAAI,IAAI,OAAO,KAAK,YAAY,CAAC,aAAa;UAExE,OAAO;AACd,MAAI,KAAK,mEAAmE,EAAE,OAAO,CAAC;;AAGxF,QAAO;;AAGT,SAAS,uBAAuB,UAA0B;CACxD,MAAM,MAAM,IAAI,IAAI,SAAS;AAC7B,QAAO,IAAI,aAAa,cAAc,kCAAkC,IAAI;;AAG9E,SAAS,kBAAkB,QAAa,QAA+B;AACrE,MAAK,MAAM,CAAC,KAAK,UAAU,OACzB,KAAI,CAAC,OAAO,aAAa,IAAI,IAAI,CAAE,QAAO,aAAa,OAAO,KAAK,MAAM"}