@shopify/hydrogen-react 2026.1.2 → 2026.4.1

package/dist/types/storefront-client.d.ts

@@ -18,6 +18,7 @@ export type StorefrontClientProps = {
  * The `createStorefrontClient()` function creates helpers that enable you to quickly query the Shopify Storefront API.
  *
  * When used on the server, it is recommended to use the `privateStorefrontToken` prop. When used on the client, it is recommended to use the `publicStorefrontToken` prop.
+ * @publicDocs
  */
 export declare function createStorefrontClient({ storeDomain, privateStorefrontToken, publicStorefrontToken, storefrontApiVersion, contentType, }: StorefrontClientProps): StorefrontClientReturn;
 export declare function getPublicTokenHeadersRaw(contentType: 'graphql' | 'json', storefrontApiVersion: string, accessToken: string): {

package/dist/types/tracking-utils.d.ts

@@ -14,8 +14,8 @@ export declare const cachedTrackingValues: {
     current: null | TrackingValues;
 };
 /**
- * Retrieves user session tracking values for analytics
- * and marketing from the browser environment.
+ * Retrieves user session tracking values for analytics and marketing from the browser environment.
+ * @publicDocs
  */
 export declare function getTrackingValues(): TrackingValues;
 export {};

package/dist/types/useCartAPIStateMachine.d.ts

@@ -11,11 +11,11 @@ export declare function useCartAPIStateMachine({ numCartLines, onCartActionEntry
     onCartActionOptimisticUI?: (context: CartMachineContext, event: CartMachineEvent) => Partial<CartMachineContext>;
     /** A callback that is invoked after a Cart API completes. */
     onCartActionComplete?: (context: CartMachineContext, event: CartMachineFetchResultEvent) => void;
-    /** An object with fields that correspond to the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-01/objects/cart). */
+    /** An object with fields that correspond to the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-04/objects/cart). */
     data?: PartialDeep<CartType, {
         recurseIntoArrays: true;
     }>;
-    /** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-01/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
+    /** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-04/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
     cartFragment: string;
     /** The ISO country code for i18n. */
     countryCode?: CountryCode;

package/dist/types/useCartActions.d.ts

@@ -6,12 +6,12 @@ type CartResponse = PartialDeep<CartType, {
 /**
  * The `useCartActions` hook returns helper graphql functions for Storefront Cart API
  *
- * See [cart API graphql mutations](https://shopify.dev/api/storefront/2026-01/objects/Cart)
+ * See [cart API graphql mutations](https://shopify.dev/api/storefront/2026-04/objects/Cart)
  */
 export declare function useCartActions({ numCartLines, cartFragment, countryCode, languageCode, }: {
     /**  Maximum number of cart lines to fetch. Defaults to 250 cart lines. */
     numCartLines?: number;
-    /** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-01/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
+    /** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2026-04/objects/cart) for all queries and mutations. A default value is used if no argument is provided. */
     cartFragment: string;
     /** The ISO country code for i18n. Default to `US` */
     countryCode?: CountryCode;

package/dist/types/useMoney.d.ts

@@ -59,8 +59,8 @@ export type UseMoneyValue = {
     withoutTrailingZerosAndCurrency: string;
 };
 /**
- * The `useMoney` hook takes a [MoneyV2 object from the Storefront API](https://shopify.dev/docs/api/storefront/2026-01/objects/MoneyV2)
- * or a [MoneyV2 object from the Customer Account API](https://shopify.dev/docs/api/customer/2026-01/objects/moneyv2) and returns a
+ * The `useMoney` hook takes a [MoneyV2 object from the Storefront API](https://shopify.dev/docs/api/storefront/2026-04/objects/MoneyV2)
+ * or a [MoneyV2 object from the Customer Account API](https://shopify.dev/docs/api/customer/2026-04/objects/moneyv2) and returns a
  * default-formatted string of the amount with the correct currency indicator, along with some of the parts provided by
  * [Intl.NumberFormat](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat).
  * Uses `locale` from `ShopifyProvider`
@@ -109,6 +109,7 @@ export type UseMoneyValue = {
  * ```ts
  * money.withoutTrailingZerosAndCurrency
  * ```
+ * @publicDocs
  */
 export declare function useMoney(money: MoneyV2): UseMoneyValue;
 export {};

package/dist/types/useSelectedOptionInUrlParam.d.ts

@@ -1,2 +1,3 @@
 import { SelectedOption } from './storefront-api-types.js';
+/** @publicDocs */
 export declare function useSelectedOptionInUrlParam(selectedOptions: Pick<SelectedOption, 'name' | 'value'>[]): null;

package/dist/types/useShopifyCookies.d.ts

@@ -34,6 +34,7 @@ type UseShopifyCookiesOptions = CoreShopifyCookiesOptions & {
  * Useful when you only want to use the newer tracking values and not rely on the deprecated ones.
  *
  * @returns `true` when cookies are set and ready.
+ * @publicDocs
  */
 export declare function useShopifyCookies(options?: UseShopifyCookiesOptions): boolean;
 type CoreShopifyCookiesOptions = {

package/dist/umd/hydrogen-react.dev.js

@@ -252,22 +252,32 @@
     }
     return [];
   }
-  const CartLineAdd = (cartFragment) => (
+  function getInContextVariables(includeVisitorConsent) {
+    const base = `$country: CountryCode = ZZ
+    $language: LanguageCode`;
+    return includeVisitorConsent ? `${base}
+    $visitorConsent: VisitorConsent` : base;
+  }
+  function getInContextDirective(includeVisitorConsent) {
+    return includeVisitorConsent ? `@inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  )` : `@inContext(
+    country: $country
+    language: $language
+  )`;
+  }
+  const CartLineAdd = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartLineAdd(
     $cartId: ID!
     $lines: [CartLineInput!]!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartLinesAdd(cartId: $cartId, lines: $lines) {
       cart {
         ...CartFragment
@@ -278,21 +288,15 @@
   ${cartFragment}
 `
   );
-  const CartCreate = (cartFragment) => (
+  const CartCreate = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartCreate(
     $input: CartInput!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartCreate(input: $input) {
       cart {
         ...CartFragment
@@ -303,22 +307,16 @@
   ${cartFragment}
 `
   );
-  const CartLineRemove = (cartFragment) => (
+  const CartLineRemove = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartLineRemove(
     $cartId: ID!
     $lines: [ID!]!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartLinesRemove(cartId: $cartId, lineIds: $lines) {
       cart {
         ...CartFragment
@@ -329,22 +327,16 @@
   ${cartFragment}
 `
   );
-  const CartLineUpdate = (cartFragment) => (
+  const CartLineUpdate = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartLineUpdate(
     $cartId: ID!
     $lines: [CartLineUpdateInput!]!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartLinesUpdate(cartId: $cartId, lines: $lines) {
       cart {
         ...CartFragment
@@ -355,22 +347,16 @@
   ${cartFragment}
 `
   );
-  const CartNoteUpdate = (cartFragment) => (
+  const CartNoteUpdate = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartNoteUpdate(
     $cartId: ID!
     $note: String!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartNoteUpdate(cartId: $cartId, note: $note) {
       cart {
         ...CartFragment
@@ -381,22 +367,16 @@
   ${cartFragment}
 `
   );
-  const CartBuyerIdentityUpdate = (cartFragment) => (
+  const CartBuyerIdentityUpdate = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartBuyerIdentityUpdate(
     $cartId: ID!
     $buyerIdentity: CartBuyerIdentityInput!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {
       cart {
         ...CartFragment
@@ -407,22 +387,16 @@
   ${cartFragment}
 `
   );
-  const CartAttributesUpdate = (cartFragment) => (
+  const CartAttributesUpdate = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartAttributesUpdate(
     $attributes: [AttributeInput!]!
     $cartId: ID!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartAttributesUpdate(attributes: $attributes, cartId: $cartId) {
       cart {
         ...CartFragment
@@ -433,22 +407,16 @@
   ${cartFragment}
 `
   );
-  const CartDiscountCodesUpdate = (cartFragment) => (
+  const CartDiscountCodesUpdate = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   mutation CartDiscountCodesUpdate(
     $cartId: ID!
     $discountCodes: [String!]!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
       cart {
         ...CartFragment
@@ -459,21 +427,15 @@
   ${cartFragment}
 `
   );
-  const CartQuery = (cartFragment) => (
+  const CartQuery = (cartFragment, options = {}) => (
     /* GraphQL */
     `
   query CartQuery(
     $id: ID!
     $numCartLines: Int = 250
-    $country: CountryCode = ZZ
-    $language: LanguageCode
-    $visitorConsent: VisitorConsent
+    ${getInContextVariables(options.includeVisitorConsent ?? false)}
   )
-  @inContext(
-    country: $country
-    language: $language
-    visitorConsent: $visitorConsent
-  ) {
+  ${getInContextDirective(options.includeVisitorConsent ?? false)} {
     cart(id: $id) {
       ...CartFragment
     }
@@ -587,7 +549,7 @@
   }
 `
   );
-  const SFAPI_VERSION = "2026-01";
+  const SFAPI_VERSION = "2026-04";
   const MOCK_SHOP_DOMAIN = "mock.shop";
   const isMockShop = (domain) => domain.includes(MOCK_SHOP_DOMAIN);
   function createStorefrontClient({
@@ -2283,7 +2245,7 @@ Refer to the authentication https://shopify.dev/api/storefront#authentication do
     }
     return false;
   }
-  const version = "2026.1.2";
+  const version = "2026.4.1";
   const SCHEMA_ID = "custom_storefront_customer_tracking/1.2";
   const PAGE_RENDERED_EVENT_NAME = "page_rendered";
   const COLLECTION_PAGE_RENDERED_EVENT_NAME = "collection_page_rendered";