@shopify/hydrogen 2026.1.4 → 2026.4.1

package/dist/development/index.js

@@ -267,7 +267,8 @@ function useCustomerPrivacy(props) {
   useEffect(() => {
     if (observing.current.customerPrivacy) return;
     observing.current.customerPrivacy = true;
-    let customCustomerPrivacy = null;
+    let backendConsentStub = null;
+    let fullCustomerPrivacy = null;
     let customShopify = window.Shopify || void 0;
     Object.defineProperty(window, "Shopify", {
       configurable: true,
@@ -277,15 +278,16 @@ function useCustomerPrivacy(props) {
       set(value) {
         if (typeof value === "object" && value !== null && Object.keys(value).length === 0) {
           customShopify = value;
+          backendConsentStub = { backendConsentEnabled: true };
           Object.defineProperty(window.Shopify, "customerPrivacy", {
             configurable: true,
             get() {
-              return customCustomerPrivacy;
+              return fullCustomerPrivacy ?? backendConsentStub;
             },
             set(value2) {
               if (typeof value2 === "object" && value2 !== null && "setTrackingConsent" in value2) {
                 const customerPrivacy = value2;
-                customCustomerPrivacy = {
+                fullCustomerPrivacy = {
                   ...customerPrivacy,
                   // Note: this method is not used by the privacy-banner,
                   // it bundles its own setTrackingConsent.
@@ -295,7 +297,7 @@ function useCustomerPrivacy(props) {
                 };
                 customShopify = {
                   ...customShopify,
-                  customerPrivacy: customCustomerPrivacy
+                  customerPrivacy: fullCustomerPrivacy
                 };
                 setLoaded.customerPrivacy();
               }
@@ -420,7 +422,8 @@ function overridePrivacyBannerMethods({
 }
 function getCustomerPrivacy() {
   try {
-    return window.Shopify && window.Shopify.customerPrivacy ? window.Shopify?.customerPrivacy : null;
+    const cp = window.Shopify?.customerPrivacy;
+    return cp && "setTrackingConsent" in cp ? cp : null;
   } catch (e) {
     return null;
   }
@@ -434,7 +437,7 @@ function getPrivacyBanner() {
 }
 
 // package.json
-var version = "2026.1.4";
+var version = "2026.4.1";
 
 // src/analytics-manager/ShopifyAnalytics.tsx
 function getCustomerPrivacyRequired() {
@@ -957,7 +960,7 @@ function register(key) {
 }
 function shopifyCanTrack() {
   try {
-    return window.Shopify.customerPrivacy.analyticsProcessingAllowed();
+    return window.Shopify.customerPrivacy?.analyticsProcessingAllowed?.() ?? false;
   } catch (e) {
   }
   return false;
@@ -1830,7 +1833,7 @@ function generateUUID() {
 }
 
 // src/version.ts
-var LIB_VERSION = "2026.1.4";
+var LIB_VERSION = "2026.4.1";
 
 // src/utils/graphql.ts
 function minifyQuery(string) {
@@ -2358,6 +2361,20 @@ function formatAPIResult(data, errors2) {
   };
 }
 
+// src/cart/queries/cart-query-helpers.ts
+function shouldIncludeVisitorConsent(input) {
+  return input?.visitorConsent !== void 0;
+}
+function getInContextVariables(includeVisitorConsent = false) {
+  const base = `$country: CountryCode = ZZ
+    $language: LanguageCode`;
+  return includeVisitorConsent ? `${base}
+    $visitorConsent: VisitorConsent` : base;
+}
+function getInContextDirective(includeVisitorConsent = false) {
+  return includeVisitorConsent ? "@inContext(country: $country, language: $language, visitorConsent: $visitorConsent)" : "@inContext(country: $country, language: $language)";
+}
+
 // src/cart/queries/cartGetDefault.ts
 function cartGetDefault({
   storefront,
@@ -2368,12 +2385,16 @@ function cartGetDefault({
   return async (cartInput) => {
     const cartId = getCartId();
     if (!cartId) return null;
+    const includeVisitorConsent = shouldIncludeVisitorConsent(cartInput);
     const [isCustomerLoggedIn, { cart, errors: errors2 }] = await Promise.all([
       customerAccount ? customerAccount.isLoggedIn() : false,
-      storefront.query(CART_QUERY(cartFragment), {
-        variables: { cartId, ...cartInput },
-        cache: storefront.CacheNone()
-      })
+      storefront.query(
+        CART_QUERY(cartFragment, { includeVisitorConsent }),
+        {
+          variables: { cartId, ...cartInput },
+          cache: storefront.CacheNone()
+        }
+      )
     ]);
     if (isCustomerLoggedIn && cart?.checkoutUrl) {
       const finalCheckoutUrl = new URL(cart.checkoutUrl);
@@ -2383,14 +2404,12 @@ function cartGetDefault({
     return cart || errors2 ? formatAPIResult(cart, errors2) : null;
   };
 }
-var CART_QUERY = (cartFragment = DEFAULT_CART_FRAGMENT) => `#graphql
+var CART_QUERY = (cartFragment = DEFAULT_CART_FRAGMENT, options = {}) => `#graphql
   query CartQuery(
     $cartId: ID!
     $numCartLines: Int = 100
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cart(id: $cartId) {
       ...CartApiQuery
     }
@@ -2544,7 +2563,8 @@ function cartCreateDefault(options) {
     const buyer = options.customerAccount ? await options.customerAccount.getBuyer() : void 0;
     const { cartId, ...restOfOptionalParams } = optionalParams || {};
     const { buyerIdentity, ...restOfInput } = input;
-    const { cartCreate, errors: errors2 } = await options.storefront.mutate(CART_CREATE_MUTATION(options.cartFragment), {
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartCreate, errors: errors2 } = await options.storefront.mutate(CART_CREATE_MUTATION(options.cartFragment, { includeVisitorConsent }), {
       variables: {
         input: {
           ...restOfInput,
@@ -2559,13 +2579,11 @@ function cartCreateDefault(options) {
     return formatAPIResult(cartCreate, errors2);
   };
 }
-var CART_CREATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_CREATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartCreate(
     $input: CartInput!
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartCreate(input: $input) {
       cart {
         ...CartApiMutation
@@ -2587,7 +2605,8 @@ var CART_CREATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
 // src/cart/queries/cartLinesAddDefault.ts
 function cartLinesAddDefault(options) {
   return async (lines, optionalParams) => {
-    const { cartLinesAdd, errors: errors2 } = await options.storefront.mutate(CART_LINES_ADD_MUTATION(options.cartFragment), {
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartLinesAdd, errors: errors2 } = await options.storefront.mutate(CART_LINES_ADD_MUTATION(options.cartFragment, { includeVisitorConsent }), {
       variables: {
         cartId: options.getCartId(),
         lines,
@@ -2597,14 +2616,12 @@ function cartLinesAddDefault(options) {
     return formatAPIResult(cartLinesAdd, errors2);
   };
 }
-var CART_LINES_ADD_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_LINES_ADD_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartLinesAdd(
     $cartId: ID!
     $lines: [CartLineInput!]!
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartLinesAdd(cartId: $cartId, lines: $lines) {
       cart {
         ...CartApiMutation
@@ -2644,24 +2661,26 @@ function throwIfLinesAreOptimistic(type, lines) {
 function cartLinesUpdateDefault(options) {
   return async (lines, optionalParams) => {
     throwIfLinesAreOptimistic("updateLines", lines);
-    const { cartLinesUpdate, errors: errors2 } = await options.storefront.mutate(CART_LINES_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        lines,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartLinesUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_LINES_UPDATE_MUTATION(options.cartFragment, { includeVisitorConsent }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          lines,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartLinesUpdate, errors2);
   };
 }
-var CART_LINES_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_LINES_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartLinesUpdate(
     $cartId: ID!
     $lines: [CartLineUpdateInput!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartLinesUpdate(cartId: $cartId, lines: $lines) {
       cart {
         ...CartApiMutation
@@ -2683,24 +2702,26 @@ var CART_LINES_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#gra
 function cartLinesRemoveDefault(options) {
   return async (lineIds, optionalParams) => {
     throwIfLinesAreOptimistic("removeLines", lineIds);
-    const { cartLinesRemove, errors: errors2 } = await options.storefront.mutate(CART_LINES_REMOVE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        lineIds,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartLinesRemove, errors: errors2 } = await options.storefront.mutate(
+      CART_LINES_REMOVE_MUTATION(options.cartFragment, { includeVisitorConsent }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          lineIds,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartLinesRemove, errors2);
   };
 }
-var CART_LINES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_LINES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartLinesRemove(
     $cartId: ID!
     $lineIds: [ID!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartLinesRemove(cartId: $cartId, lineIds: $lineIds) {
       cart {
         ...CartApiMutation
@@ -2724,24 +2745,28 @@ function cartDiscountCodesUpdateDefault(options) {
     const uniqueCodes = discountCodes.filter((value, index, array) => {
       return array.indexOf(value) === index;
     });
-    const { cartDiscountCodesUpdate, errors: errors2 } = await options.storefront.mutate(CART_DISCOUNT_CODE_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        discountCodes: uniqueCodes,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartDiscountCodesUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_DISCOUNT_CODE_UPDATE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          discountCodes: uniqueCodes,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartDiscountCodesUpdate, errors2);
   };
 }
-var CART_DISCOUNT_CODE_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_DISCOUNT_CODE_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartDiscountCodesUpdate(
     $cartId: ID!
     $discountCodes: [String!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
       ... @defer {
         cart {
@@ -2770,27 +2795,31 @@ function cartBuyerIdentityUpdateDefault(options) {
       });
     }
     const buyer = options.customerAccount ? await options.customerAccount.getBuyer() : void 0;
-    const { cartBuyerIdentityUpdate, errors: errors2 } = await options.storefront.mutate(CART_BUYER_IDENTITY_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        buyerIdentity: {
-          ...buyer,
-          ...buyerIdentity
-        },
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartBuyerIdentityUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_BUYER_IDENTITY_UPDATE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          buyerIdentity: {
+            ...buyer,
+            ...buyerIdentity
+          },
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartBuyerIdentityUpdate, errors2);
   };
 }
-var CART_BUYER_IDENTITY_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_BUYER_IDENTITY_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartBuyerIdentityUpdate(
     $cartId: ID!
     $buyerIdentity: CartBuyerIdentityInput!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {
       cart {
         ...CartApiMutation
@@ -2811,24 +2840,26 @@ var CART_BUYER_IDENTITY_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT)
 // src/cart/queries/cartNoteUpdateDefault.ts
 function cartNoteUpdateDefault(options) {
   return async (note, optionalParams) => {
-    const { cartNoteUpdate, errors: errors2 } = await options.storefront.mutate(CART_NOTE_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        note,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartNoteUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_NOTE_UPDATE_MUTATION(options.cartFragment, { includeVisitorConsent }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          note,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartNoteUpdate, errors2);
   };
 }
-var CART_NOTE_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_NOTE_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartNoteUpdate(
     $cartId: ID!
     $note: String!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartNoteUpdate(cartId: $cartId, note: $note) {
       cart {
         ...CartApiMutation
@@ -2849,24 +2880,28 @@ var CART_NOTE_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#grap
 // src/cart/queries/cartSelectedDeliveryOptionsUpdateDefault.ts
 function cartSelectedDeliveryOptionsUpdateDefault(options) {
   return async (selectedDeliveryOptions, optionalParams) => {
-    const { cartSelectedDeliveryOptionsUpdate, errors: errors2 } = await options.storefront.mutate(CART_SELECTED_DELIVERY_OPTIONS_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        selectedDeliveryOptions,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartSelectedDeliveryOptionsUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_SELECTED_DELIVERY_OPTIONS_UPDATE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          selectedDeliveryOptions,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartSelectedDeliveryOptionsUpdate, errors2);
   };
 }
-var CART_SELECTED_DELIVERY_OPTIONS_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_SELECTED_DELIVERY_OPTIONS_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartSelectedDeliveryOptionsUpdate(
     $cartId: ID!
     $selectedDeliveryOptions: [CartSelectedDeliveryOptionInput!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartSelectedDeliveryOptionsUpdate(cartId: $cartId, selectedDeliveryOptions: $selectedDeliveryOptions) {
       cart {
         ...CartApiMutation
@@ -2887,24 +2922,28 @@ var CART_SELECTED_DELIVERY_OPTIONS_UPDATE_MUTATION = (cartFragment = MINIMAL_CAR
 // src/cart/queries/cartAttributesUpdateDefault.ts
 function cartAttributesUpdateDefault(options) {
   return async (attributes, optionalParams) => {
-    const { cartAttributesUpdate, errors: errors2 } = await options.storefront.mutate(CART_ATTRIBUTES_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: optionalParams?.cartId || options.getCartId(),
-        attributes,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartAttributesUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_ATTRIBUTES_UPDATE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: optionalParams?.cartId || options.getCartId(),
+          attributes,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartAttributesUpdate, errors2);
   };
 }
-var CART_ATTRIBUTES_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_ATTRIBUTES_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartAttributesUpdate(
     $cartId: ID!
     $attributes: [AttributeInput!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartAttributesUpdate(cartId: $cartId, attributes: $attributes) {
       cart {
         ...CartApiMutation
@@ -2932,7 +2971,8 @@ function cartMetafieldsSetDefault(options) {
         ownerId
       })
     );
-    const { cartMetafieldsSet, errors: errors2 } = await options.storefront.mutate(CART_METAFIELD_SET_MUTATION(), {
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartMetafieldsSet, errors: errors2 } = await options.storefront.mutate(CART_METAFIELD_SET_MUTATION({ includeVisitorConsent }), {
       variables: { metafields: metafieldsWithOwnerId, ...optionalParams }
     });
     return formatAPIResult(
@@ -2946,13 +2986,11 @@ function cartMetafieldsSetDefault(options) {
     );
   };
 }
-var CART_METAFIELD_SET_MUTATION = () => `#graphql
+var CART_METAFIELD_SET_MUTATION = (options = {}) => `#graphql
   mutation cartMetafieldsSet(
     $metafields: [CartMetafieldsSetInput!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartMetafieldsSet(metafields: $metafields) {
       userErrors {
         code
@@ -2968,7 +3006,8 @@ var CART_METAFIELD_SET_MUTATION = () => `#graphql
 function cartMetafieldDeleteDefault(options) {
   return async (key, optionalParams) => {
     const ownerId = optionalParams?.cartId || options.getCartId();
-    const { cartMetafieldDelete, errors: errors2 } = await options.storefront.mutate(CART_METAFIELD_DELETE_MUTATION(), {
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartMetafieldDelete, errors: errors2 } = await options.storefront.mutate(CART_METAFIELD_DELETE_MUTATION({ includeVisitorConsent }), {
       variables: {
         input: {
           ownerId,
@@ -2988,13 +3027,11 @@ function cartMetafieldDeleteDefault(options) {
     );
   };
 }
-var CART_METAFIELD_DELETE_MUTATION = () => `#graphql
+var CART_METAFIELD_DELETE_MUTATION = (options = {}) => `#graphql
   mutation cartMetafieldDelete(
     $input: CartMetafieldDeleteInput!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartMetafieldDelete(input: $input) {
       userErrors {
         code
@@ -3008,24 +3045,28 @@ var CART_METAFIELD_DELETE_MUTATION = () => `#graphql
 // src/cart/queries/cartGiftCardCodeUpdateDefault.ts
 function cartGiftCardCodesUpdateDefault(options) {
   return async (giftCardCodes, optionalParams) => {
-    const { cartGiftCardCodesUpdate, errors: errors2 } = await options.storefront.mutate(CART_GIFT_CARD_CODE_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        giftCardCodes,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartGiftCardCodesUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_GIFT_CARD_CODE_UPDATE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          giftCardCodes,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartGiftCardCodesUpdate, errors2);
   };
 }
-var CART_GIFT_CARD_CODE_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_GIFT_CARD_CODE_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartGiftCardCodesUpdate(
     $cartId: ID!
     $giftCardCodes: [String!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartGiftCardCodesUpdate(cartId: $cartId, giftCardCodes: $giftCardCodes) {
       cart {
         ...CartApiMutation
@@ -3083,24 +3124,28 @@ var CART_GIFT_CARD_CODES_ADD_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) =
 // src/cart/queries/cartGiftCardCodesRemoveDefault.ts
 function cartGiftCardCodesRemoveDefault(options) {
   return async (appliedGiftCardIds, optionalParams) => {
-    const { cartGiftCardCodesRemove, errors: errors2 } = await options.storefront.mutate(CART_GIFT_CARD_CODES_REMOVE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        appliedGiftCardIds,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartGiftCardCodesRemove, errors: errors2 } = await options.storefront.mutate(
+      CART_GIFT_CARD_CODES_REMOVE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          appliedGiftCardIds,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartGiftCardCodesRemove, errors2);
   };
 }
-var CART_GIFT_CARD_CODES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_GIFT_CARD_CODES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartGiftCardCodesRemove(
     $cartId: ID!
     $appliedGiftCardIds: [ID!]!
-    $language: LanguageCode
-    $country: CountryCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartGiftCardCodesRemove(cartId: $cartId, appliedGiftCardIds: $appliedGiftCardIds) {
       cart {
         ...CartApiMutation
@@ -3121,24 +3166,28 @@ var CART_GIFT_CARD_CODES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT
 // src/cart/queries/cartDeliveryAddressesAddDefault.tsx
 function cartDeliveryAddressesAddDefault(options) {
   return async (addresses, optionalParams) => {
-    const { cartDeliveryAddressesAdd, errors: errors2 } = await options.storefront.mutate(CART_DELIVERY_ADDRESSES_ADD_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        addresses,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartDeliveryAddressesAdd, errors: errors2 } = await options.storefront.mutate(
+      CART_DELIVERY_ADDRESSES_ADD_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          addresses,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartDeliveryAddressesAdd, errors2);
   };
 }
-var CART_DELIVERY_ADDRESSES_ADD_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_DELIVERY_ADDRESSES_ADD_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartDeliveryAddressesAdd(
     $cartId: ID!
     $addresses: [CartSelectableAddressInput!]!,
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartDeliveryAddressesAdd(addresses: $addresses, cartId: $cartId) {
       cart {
         ...CartApiMutation
@@ -3159,24 +3208,28 @@ var CART_DELIVERY_ADDRESSES_ADD_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT
 // src/cart/queries/cartDeliveryAddressesRemoveDefault.tsx
 function cartDeliveryAddressesRemoveDefault(options) {
   return async (addressIds, optionalParams) => {
-    const { cartDeliveryAddressesRemove, errors: errors2 } = await options.storefront.mutate(CART_DELIVERY_ADDRESSES_REMOVE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        addressIds,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartDeliveryAddressesRemove, errors: errors2 } = await options.storefront.mutate(
+      CART_DELIVERY_ADDRESSES_REMOVE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          addressIds,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartDeliveryAddressesRemove, errors2);
   };
 }
-var CART_DELIVERY_ADDRESSES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_DELIVERY_ADDRESSES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartDeliveryAddressesRemove(
     $cartId: ID!
     $addressIds: [ID!]!,
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartDeliveryAddressesRemove(addressIds: $addressIds, cartId: $cartId) {
       cart {
         ...CartApiMutation
@@ -3197,24 +3250,28 @@ var CART_DELIVERY_ADDRESSES_REMOVE_MUTATION = (cartFragment = MINIMAL_CART_FRAGM
 // src/cart/queries/cartDeliveryAddressesUpdateDefault.tsx
 function cartDeliveryAddressesUpdateDefault(options) {
   return async (addresses, optionalParams) => {
-    const { cartDeliveryAddressesUpdate, errors: errors2 } = await options.storefront.mutate(CART_DELIVERY_ADDRESSES_UPDATE_MUTATION(options.cartFragment), {
-      variables: {
-        cartId: options.getCartId(),
-        addresses,
-        ...optionalParams
+    const includeVisitorConsent = shouldIncludeVisitorConsent(optionalParams);
+    const { cartDeliveryAddressesUpdate, errors: errors2 } = await options.storefront.mutate(
+      CART_DELIVERY_ADDRESSES_UPDATE_MUTATION(options.cartFragment, {
+        includeVisitorConsent
+      }),
+      {
+        variables: {
+          cartId: options.getCartId(),
+          addresses,
+          ...optionalParams
+        }
       }
-    });
+    );
     return formatAPIResult(cartDeliveryAddressesUpdate, errors2);
   };
 }
-var CART_DELIVERY_ADDRESSES_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT) => `#graphql
+var CART_DELIVERY_ADDRESSES_UPDATE_MUTATION = (cartFragment = MINIMAL_CART_FRAGMENT, options = {}) => `#graphql
   mutation cartDeliveryAddressesUpdate(
     $cartId: ID!
     $addresses: [CartSelectableAddressUpdateInput!]!,
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
-  ) @inContext(country: $country, language: $language, visitorConsent: $visitorConsent) {
+    ${getInContextVariables(options.includeVisitorConsent)}
+  ) ${getInContextDirective(options.includeVisitorConsent)} {
     cartDeliveryAddressesUpdate(addresses: $addresses, cartId: $cartId) {
       cart {
         ...CartApiMutation
@@ -3485,7 +3542,7 @@ var hydrogenContext = {
 };
 
 // src/customer/constants.ts
-var DEFAULT_CUSTOMER_API_VERSION = "2026-01";
+var DEFAULT_CUSTOMER_API_VERSION = "2026-04";
 var USER_AGENT = `Shopify Hydrogen ${LIB_VERSION}`;
 var CUSTOMER_API_CLIENT_ID = "30243aa5-17c1-465a-8493-944bcc4e88aa";
 var CUSTOMER_ACCOUNT_SESSION_KEY = "customerAccount";
@@ -3763,15 +3820,15 @@ function ensureLocalRedirectUrl({
   redirectUrl
 }) {
   const fromUrl = requestUrl;
-  const defautlUrl = buildURLObject(requestUrl, defaultUrl);
-  const toUrl = redirectUrl ? buildURLObject(requestUrl, redirectUrl) : defautlUrl;
+  const parsedDefaultUrl = buildURLObject(requestUrl, defaultUrl);
+  const toUrl = redirectUrl ? buildURLObject(requestUrl, redirectUrl) : parsedDefaultUrl;
   if (isLocalPath(requestUrl, toUrl.toString())) {
     return toUrl.toString();
   } else {
     console.warn(
-      `Cross-domain redirects are not supported. Tried to redirect from ${fromUrl} to ${toUrl}. Default url ${defautlUrl} is used instead.`
+      `Cross-domain redirects are not supported. Tried to redirect from ${fromUrl} to ${toUrl}. Default url ${parsedDefaultUrl} is used instead.`
     );
-    return defautlUrl.toString();
+    return parsedDefaultUrl.toString();
   }
 }
 function buildURLObject(requestUrl, relativeOrAbsoluteUrl) {
@@ -4412,8 +4469,7 @@ function createRequestHandler({
   mode,
   poweredByHeader = true,
   getLoadContext,
-  collectTrackingInformation = true,
-  proxyStandardRoutes = true
+  collectTrackingInformation = true
 }) {
   const handleRequest = createRequestHandler$1(build, mode);
   const appendPoweredByHeader = poweredByHeader ? (response) => response.headers.append("powered-by", "Shopify, Hydrogen") : void 0;
@@ -4435,32 +4491,28 @@ function createRequestHandler({
     }
     const context = await getLoadContext?.(request);
     const storefront = context?.storefront || context?.get?.(storefrontContext);
-    if (proxyStandardRoutes) {
-      if (!storefront) {
-        warnOnce(
-          "[h2:createRequestHandler] Storefront instance is required to proxy standard routes."
-        );
-      }
-      if (storefront?.isStorefrontApiUrl(request)) {
-        const response2 = await storefront.forward(request);
-        appendPoweredByHeader?.(response2);
-        return response2;
-      }
-      if (storefront?.isMcpUrl(request)) {
-        const response2 = await storefront.forwardMcp(request);
-        appendPoweredByHeader?.(response2);
-        return response2;
-      }
+    if (!storefront) {
+      throw new Error(
+        "[h2:createRequestHandler] Storefront instance is required in the load context. Make sure to use createHydrogenContext() or provide a storefront instance via getLoadContext."
+      );
+    }
+    if (storefront.isStorefrontApiUrl(request)) {
+      const response2 = await storefront.forward(request);
+      appendPoweredByHeader?.(response2);
+      return response2;
+    }
+    if (storefront.isMcpUrl(request)) {
+      const response2 = await storefront.forwardMcp(request);
+      appendPoweredByHeader?.(response2);
+      return response2;
     }
     const response = await handleRequest(request, context);
-    if (storefront && proxyStandardRoutes) {
-      if (collectTrackingInformation) {
-        storefront.setCollectedSubrequestHeaders(response);
-      }
-      const fetchDest = request.headers.get("sec-fetch-dest");
-      if (fetchDest && fetchDest === "document" || request.headers.get("accept")?.includes("text/html")) {
-        appendServerTimingHeader(response, { [HYDROGEN_SFAPI_PROXY_KEY]: "1" });
-      }
+    if (collectTrackingInformation) {
+      storefront.setCollectedSubrequestHeaders(response);
+    }
+    const fetchDest = request.headers.get("sec-fetch-dest");
+    if (fetchDest && fetchDest === "document" || request.headers.get("accept")?.includes("text/html")) {
+      appendServerTimingHeader(response, { [HYDROGEN_SFAPI_PROXY_KEY]: "1" });
     }
     appendPoweredByHeader?.(response);
     return response;
@@ -6500,14 +6552,14 @@ var QUERIES = {
 //! @see https://shopify.dev/docs/api/storefront/latest/mutations/cartNoteUpdate
 //! @see https://shopify.dev/docs/api/storefront/latest/mutations/cartSelectedDeliveryOptionsUpdate
 //! @see https://shopify.dev/docs/api/storefront/latest/mutations/cartMetafieldsSet
-//! @see https://shopify.dev/docs/api/storefront/2026-01/mutations/cartMetafieldDelete
+//! @see https://shopify.dev/docs/api/storefront/2026-04/mutations/cartMetafieldDelete
 //! @see https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesUpdate
 //! @see https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesAdd
 //! @see https://shopify.dev/docs/api/storefront/latest/mutations/cartGiftCardCodesRemove
 //! @see: https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesAdd
 //! @see: https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesRemove
 //! @see: https://shopify.dev/docs/api/storefront/latest/mutations/cartDeliveryAddressesUpdate
-//! @see: https://shopify.dev/docs/api/storefront/2026-01/mutations/cartDeliveryAddressesReplace
+//! @see: https://shopify.dev/docs/api/storefront/2026-04/mutations/cartDeliveryAddressesReplace
 
 export { Analytics, AnalyticsEvent, CacheCustom, CacheLong, CacheNone, CacheShort, CartForm, InMemoryCache, NonceProvider, OptimisticInput, Pagination, RichText, Script, Seo, ShopPayButton, VariantSelector, cartAttributesUpdateDefault, cartBuyerIdentityUpdateDefault, cartCreateDefault, cartDiscountCodesUpdateDefault, cartGetDefault, cartGetIdDefault, cartGiftCardCodesAddDefault, cartGiftCardCodesRemoveDefault, cartGiftCardCodesUpdateDefault, cartLinesAddDefault, cartLinesRemoveDefault, cartLinesUpdateDefault, cartMetafieldDeleteDefault, cartMetafieldsSetDefault, cartNoteUpdateDefault, cartSelectedDeliveryOptionsUpdateDefault, cartSetIdDefault, changelogHandler, createCartHandler, createContentSecurityPolicy, createCustomerAccountClient, createHydrogenContext, createRequestHandler, createStorefrontClient, createWithCache, formatAPIResult, generateCacheControlHeader, getPaginationVariables, getSelectedProductOptions, getSeoMeta, getShopAnalytics, getSitemap, getSitemapIndex, graphiqlLoader, hydrogenContext, hydrogenPreset, hydrogenRoutes, storefrontRedirect, useAnalytics, useCustomerPrivacy, useNonce, useOptimisticCart, useOptimisticData, useOptimisticVariant };
 //# sourceMappingURL=index.js.map