@shopify/hydrogen-react 2025.7.2 → 2025.10.0

package/dist/types/optionValueDecoder.d.ts

@@ -14,7 +14,7 @@ export type IsOptionValueCombinationInEncodedVariant = (targetOptionValueCombina
  * Determine whether an option value combination is present in an encoded option value string. Function is memoized by encodedVariantField.
  *
  * @param targetOptionValueCombination - Indices of option values to look up in the encoded option value string. A partial set of indices may be passed to determine whether a node or any children is present. For example, if a product has 3 options, passing [0] will return true if any option value combination for the first option's option value is present in the encoded string.
- * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2025-07/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2025-07/objects/Product#field-encodedvariantavailability)
+ * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2025-10/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2025-10/objects/Product#field-encodedvariantavailability)
  * @returns - True if a full or partial targetOptionValueIndices is present in the encoded option value string, false otherwise.
  */
 export declare const isOptionValueCombinationInEncodedVariant: IsOptionValueCombinationInEncodedVariant;
@@ -22,7 +22,7 @@ type EncodedVariantField = Product['encodedVariantAvailability'] | Product['enco
 type DecodedOptionValues = number[][];
 /**
  * For an encoded option value string, decode into option value combinations. Entries represent a valid combination formatted as an array of option value positions.
- * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2025-07/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2025-07/objects/Product#field-encodedvariantavailability)
+ * @param encodedVariantField - Encoded option value string from the Storefront API, e.g. [product.encodedVariantExistence](/docs/api/storefront/2025-10/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2025-10/objects/Product#field-encodedvariantavailability)
  * @returns Decoded option value combinations
  */
 export declare function decodeEncodedVariant(encodedVariantField: EncodedVariantField): DecodedOptionValues;

package/dist/types/parse-metafield.d.ts

@@ -1,4 +1,4 @@
-import type { Collection, GenericFile, Metafield as MetafieldBaseType, MoneyV2, Page, Product, ProductVariant } from './storefront-api-types.js';
+import type { Article, Collection, GenericFile, Metafield as MetafieldBaseType, MoneyV2, Page, Product, ProductVariant } from './storefront-api-types.js';
 import type { PartialDeep, Simplify } from 'type-fest';
 import { RootASTNode as RichTextRootASTNode } from './RichText.types.js';
 /**
@@ -17,7 +17,7 @@ export declare function parseMetafield<ReturnGeneric>(metafield: PartialDeep<Met
  * Parses a JSON string while preventing prototype injection attacks.
  */
 export declare function parseJSON(json: string): unknown;
-export declare const allMetafieldTypesArray: readonly ["boolean", "collection_reference", "color", "date", "date_time", "dimension", "file_reference", "json", "money", "rich_text_field", "multi_line_text_field", "number_decimal", "number_integer", "page_reference", "product_reference", "rating", "single_line_text_field", "url", "variant_reference", "volume", "weight", "list.collection_reference", "list.color", "list.date", "list.date_time", "list.dimension", "list.file_reference", "list.number_integer", "list.number_decimal", "list.page_reference", "list.product_reference", "list.rating", "list.single_line_text_field", "list.url", "list.variant_reference", "list.volume", "list.weight"];
+export declare const allMetafieldTypesArray: readonly ["article_reference", "boolean", "collection_reference", "color", "date", "date_time", "dimension", "file_reference", "json", "money", "rich_text_field", "multi_line_text_field", "number_decimal", "number_integer", "page_reference", "product_reference", "rating", "single_line_text_field", "url", "variant_reference", "volume", "weight", "list.article_reference", "list.collection_reference", "list.color", "list.date", "list.date_time", "list.dimension", "list.file_reference", "list.number_integer", "list.number_decimal", "list.page_reference", "list.product_reference", "list.rating", "list.single_line_text_field", "list.url", "list.variant_reference", "list.volume", "list.weight"];
 /** A union of all the supported `metafield.type`s */
 export type MetafieldTypeTypes = (typeof allMetafieldTypesArray)[number];
 /**
@@ -30,6 +30,8 @@ export type MetafieldTypeTypes = (typeof allMetafieldTypesArray)[number];
  * `parsedMetafield.parsedValue`'s type is now `boolean`
  */
 export type ParsedMetafields<ExtraTypeGeneric = void> = {
+    /** A Metafield that's been parsed, with a `parsedValue` of an `Article` object (as defined by the Storefront API) */
+    article_reference: Simplify<ArticleParsedRefMetafield>;
     /** A Metafield that's been parsed, with a `parsedValue` of `boolean` */
     boolean: Simplify<BooleanParsedMetafield>;
     /** A Metafield that's been parsed, with a `parsedValue` of a `Collection` object (as defined by the Storefront API) */
@@ -78,6 +80,8 @@ export type ParsedMetafields<ExtraTypeGeneric = void> = {
     volume: Simplify<MeasurementParsedMetafield>;
     /** A Metafield that's been parsed, with a `parsedValue` of type `Measurement` */
     weight: Simplify<MeasurementParsedMetafield>;
+    /** A Metafield that's been parsed, with a `parsedValue` of an array of `Article` objects (as defined by the Storefront API) */
+    'list.article_reference': Simplify<ArticleListParsedRefMetafield>;
     /** A Metafield that's been parsed, with a `parsedValue` of an array of `Collection` objects (as defined by the Storefront API) */
     'list.collection_reference': Simplify<CollectionListParsedRefMetafield>;
     /** A Metafield that's been parsed, with a `parsedValue` of an array of strings */
@@ -155,6 +159,10 @@ type NumberParsedMetafield = MetafieldBaseType & {
     type: 'number_decimal' | 'number_integer';
     parsedValue: number | null;
 };
+type ArticleParsedRefMetafield = MetafieldBaseType & {
+    type: 'article_reference';
+    parsedValue: Article | null;
+};
 type PageParsedRefMetafield = MetafieldBaseType & {
     type: 'page_reference';
     parsedValue: Page | null;
@@ -175,6 +183,10 @@ type VariantParsedRefMetafield = MetafieldBaseType & {
     type: 'variant_reference';
     parsedValue: ProductVariant | null;
 };
+type ArticleListParsedRefMetafield = MetafieldBaseType & {
+    type: 'list.article_reference';
+    parsedValue: Array<Article> | null;
+};
 type CollectionListParsedRefMetafield = MetafieldBaseType & {
     type: 'list.collection_reference';
     parsedValue: Array<Collection> | null;

package/dist/types/storefront-api-constants.d.ts

@@ -1 +1 @@
-export declare const SFAPI_VERSION = "2025-07";
+export declare const SFAPI_VERSION = "2025-10";

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

@@ -1,6 +1,6 @@
 /**
  * THIS FILE IS AUTO-GENERATED, DO NOT EDIT
- * Based on Storefront API 2025-07
+ * Based on Storefront API 2025-10
  * If changes need to happen to the types defined in this file, then generally the Storefront API needs to update. After it's updated, you can run `npm run graphql-types`.
  * Except custom Scalars, which are defined in the `codegen.ts` file
  */
@@ -780,6 +780,17 @@ export type CartCardSource =
    */
   'SAVED_CREDIT_CARD';
 
+/** Return type for `cartClone` mutation. */
+export type CartClonePayload = {
+  __typename?: 'CartClonePayload';
+  /** The newly created cart without PII. This is a different cart from the source. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+  /** A list of warnings that occurred during the mutation. */
+  warnings: Array<CartWarning>;
+};
+
 /** The discount that has been applied to the cart line using a discount code. */
 export type CartCodeDiscountAllocation = CartDiscountAllocation & {
   __typename?: 'CartCodeDiscountAllocation';
@@ -1059,6 +1070,17 @@ export type CartDeliveryAddressesRemovePayload = {
   warnings: Array<CartWarning>;
 };
 
+/** Return type for `cartDeliveryAddressesReplace` mutation. */
+export type CartDeliveryAddressesReplacePayload = {
+  __typename?: 'CartDeliveryAddressesReplacePayload';
+  /** The updated cart. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+  /** A list of warnings that occurred during the mutation. */
+  warnings: Array<CartWarning>;
+};
+
 /** Return type for `cartDeliveryAddressesUpdate` mutation. */
 export type CartDeliveryAddressesUpdatePayload = {
   __typename?: 'CartDeliveryAddressesUpdatePayload';
@@ -1307,6 +1329,8 @@ export type CartErrorCode =
   | 'ADDRESS_FIELD_IS_REQUIRED'
   /** The specified address field is too long. */
   | 'ADDRESS_FIELD_IS_TOO_LONG'
+  /** Bundles and addons cannot be mixed. */
+  | 'BUNDLES_AND_ADDONS_CANNOT_BE_MIXED'
   /** Buyer cannot purchase for company location. */
   | 'BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION'
   /** The cart is too large to save. */
@@ -1341,6 +1365,8 @@ export type CartErrorCode =
   | 'LESS_THAN'
   /** The quantity must be below the specified maximum for the item. */
   | 'MAXIMUM_EXCEEDED'
+  /** Item cannot be purchased as configured. */
+  | 'MERCHANDISE_NOT_APPLICABLE'
   /** The quantity must be above the specified minimum for the item. */
   | 'MINIMUM_NOT_MET'
   /** The customer access token is required when setting a company location. */
@@ -1353,6 +1379,12 @@ export type CartErrorCode =
   | 'NOTE_TOO_LONG'
   /** Only one delivery address can be selected. */
   | 'ONLY_ONE_DELIVERY_ADDRESS_CAN_BE_SELECTED'
+  /** Parent line nesting is too deep or circular. */
+  | 'PARENT_LINE_NESTING_TOO_DEEP'
+  /** Parent line not found. */
+  | 'PARENT_LINE_NOT_FOUND'
+  /** Nested cartlines are blocked due to an incompatibility. */
+  | 'PARENT_LINE_OPERATION_BLOCKED'
   /** Credit card has expired. */
   | 'PAYMENTS_CREDIT_CARD_BASE_EXPIRED'
   /** Credit card gateway is not supported. */
@@ -1420,6 +1452,17 @@ export type CartFreePaymentMethodInput = {
   billingAddress: MailingAddressInput;
 };
 
+/** Return type for `cartGiftCardCodesAdd` mutation. */
+export type CartGiftCardCodesAddPayload = {
+  __typename?: 'CartGiftCardCodesAddPayload';
+  /** The updated cart. */
+  cart?: Maybe<Cart>;
+  /** The list of errors that occurred from executing the mutation. */
+  userErrors: Array<CartUserError>;
+  /** A list of warnings that occurred during the mutation. */
+  warnings: Array<CartWarning>;
+};
+
 /** Return type for `cartGiftCardCodesRemove` mutation. */
 export type CartGiftCardCodesRemovePayload = {
   __typename?: 'CartGiftCardCodesRemovePayload';
@@ -1530,8 +1573,12 @@ export type CartLine = BaseCartLine &
     estimatedCost: CartLineEstimatedCost;
     /** A globally-unique ID. */
     id: Scalars['ID']['output'];
+    /** The instructions for the line item. */
+    instructions: CartLineInstructions;
     /** The merchandise that the buyer intends to purchase. */
     merchandise: Merchandise;
+    /** The parent of the line item. */
+    parentRelationship?: Maybe<CartLineParentRelationship>;
     /** The quantity of the merchandise that the customer intends to purchase. */
     quantity: Scalars['Int']['output'];
     /** The selling plan associated with the cart line and the effect that each selling plan has on variants when they're purchased. */
@@ -1582,12 +1629,38 @@ export type CartLineInput = {
   attributes?: InputMaybe<Array<AttributeInput>>;
   /** The ID of the merchandise that the buyer intends to purchase. */
   merchandiseId: Scalars['ID']['input'];
+  /** The parent line item of the cart line. */
+  parent?: InputMaybe<CartLineParentInput>;
   /** The quantity of the merchandise. */
   quantity?: InputMaybe<Scalars['Int']['input']>;
   /** The ID of the selling plan that the merchandise is being purchased with. */
   sellingPlanId?: InputMaybe<Scalars['ID']['input']>;
 };
 
+/** Represents instructions for a cart line item. */
+export type CartLineInstructions = {
+  __typename?: 'CartLineInstructions';
+  /** Whether the line item can be removed from the cart. */
+  canRemove: Scalars['Boolean']['output'];
+  /** Whether the line item quantity can be updated. */
+  canUpdateQuantity: Scalars['Boolean']['output'];
+};
+
+/** The parent line item of the cart line. */
+export type CartLineParentInput = {
+  /** The id of the parent line item. */
+  lineId?: InputMaybe<Scalars['ID']['input']>;
+  /** The ID of the parent line merchandise. */
+  merchandiseId?: InputMaybe<Scalars['ID']['input']>;
+};
+
+/** Represents the parent relationship of a cart line. */
+export type CartLineParentRelationship = {
+  __typename?: 'CartLineParentRelationship';
+  /** The parent cart line. */
+  parent: CartLine;
+};
+
 /** The input fields to update a line item on a cart. */
 export type CartLineUpdateInput = {
   /**
@@ -1980,6 +2053,8 @@ export type CartWarningCode =
   | 'MERCHANDISE_NOT_ENOUGH_STOCK'
   /** The merchandise is out of stock. */
   | 'MERCHANDISE_OUT_OF_STOCK'
+  /** Only one-time purchase is available for B2B orders. */
+  | 'MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION'
   /** Gift cards are not available as a payment method. */
   | 'PAYMENTS_GIFT_CARDS_UNAVAILABLE';
 
@@ -4884,7 +4959,10 @@ export type MediaPresentation = Node & {
   __typename?: 'MediaPresentation';
   /** A JSON object representing a presentation view. */
   asJson?: Maybe<Scalars['JSON']['output']>;
-  /** A globally-unique ID. */
+  /**
+   * A globally-unique ID.
+   * @deprecated MediaPresentation IDs are being deprecated. Access the data directly via the asJson field on the Media type.
+   */
   id: Scalars['ID']['output'];
 };
 
@@ -5094,6 +5172,7 @@ export type MetafieldParentResource =
  *
  */
 export type MetafieldReference =
+  | Article
   | Collection
   | GenericFile
   | MediaImage
@@ -5190,7 +5269,7 @@ export type Metaobject = Node &
      *
      */
     seo?: Maybe<MetaobjectSeo>;
-    /** The type of the metaobject. Defines the namespace of its associated metafields. */
+    /** The type of the metaobject. */
     type: Scalars['String']['output'];
     /** The date and time when the metaobject was last updated. */
     updatedAt: Scalars['DateTime']['output'];
@@ -5337,16 +5416,22 @@ export type Mutation = {
    *
    */
   cartBuyerIdentityUpdate?: Maybe<CartBuyerIdentityUpdatePayload>;
+  /** Creates a clone of the specified cart with all personally identifiable information removed. */
+  cartClone?: Maybe<CartClonePayload>;
   /** Creates a new cart. */
   cartCreate?: Maybe<CartCreatePayload>;
   /** Adds delivery addresses to the cart. */
   cartDeliveryAddressesAdd?: Maybe<CartDeliveryAddressesAddPayload>;
   /** Removes delivery addresses from the cart. */
   cartDeliveryAddressesRemove?: Maybe<CartDeliveryAddressesRemovePayload>;
+  /** Replaces delivery addresses on the cart. */
+  cartDeliveryAddressesReplace?: Maybe<CartDeliveryAddressesReplacePayload>;
   /** Updates one or more delivery addresses on a cart. */
   cartDeliveryAddressesUpdate?: Maybe<CartDeliveryAddressesUpdatePayload>;
   /** Updates the discount codes applied to the cart. */
   cartDiscountCodesUpdate?: Maybe<CartDiscountCodesUpdatePayload>;
+  /** Adds gift card codes to the cart without replacing existing ones. */
+  cartGiftCardCodesAdd?: Maybe<CartGiftCardCodesAddPayload>;
   /** Removes the gift card codes applied to the cart. */
   cartGiftCardCodesRemove?: Maybe<CartGiftCardCodesRemovePayload>;
   /** Updates the gift card codes applied to the cart. */
@@ -5468,6 +5553,11 @@ export type MutationCartBuyerIdentityUpdateArgs = {
   cartId: Scalars['ID']['input'];
 };
 
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartCloneArgs = {
+  cartId: Scalars['ID']['input'];
+};
+
 /** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
 export type MutationCartCreateArgs = {
   input?: InputMaybe<CartInput>;
@@ -5485,6 +5575,12 @@ export type MutationCartDeliveryAddressesRemoveArgs = {
   cartId: Scalars['ID']['input'];
 };
 
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartDeliveryAddressesReplaceArgs = {
+  addresses: Array<CartSelectableAddressInput>;
+  cartId: Scalars['ID']['input'];
+};
+
 /** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
 export type MutationCartDeliveryAddressesUpdateArgs = {
   addresses: Array<CartSelectableAddressUpdateInput>;
@@ -5497,6 +5593,12 @@ export type MutationCartDiscountCodesUpdateArgs = {
   discountCodes?: InputMaybe<Array<Scalars['String']['input']>>;
 };
 
+/** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
+export type MutationCartGiftCardCodesAddArgs = {
+  cartId: Scalars['ID']['input'];
+  giftCardCodes: Array<Scalars['String']['input']>;
+};
+
 /** The schema’s entry-point for mutations. This acts as the public, top-level API from which all mutation queries must start. */
 export type MutationCartGiftCardCodesRemoveArgs = {
   appliedGiftCardIds: Array<Scalars['ID']['input']>;
@@ -8588,7 +8690,7 @@ export type SitemapResourceMetaobject = SitemapResourceInterface & {
   handle: Scalars['String']['output'];
   /** The URL handle for accessing pages of this metaobject type in the Online Store. */
   onlineStoreUrlHandle?: Maybe<Scalars['String']['output']>;
-  /** The type of the metaobject. Defines the namespace of its associated metafields. */
+  /** The type of the metaobject. */
   type: Scalars['String']['output'];
   /** The date and time when the resource was updated. */
   updatedAt: Scalars['DateTime']['output'];
@@ -9068,6 +9170,18 @@ export type VideoSource = {
   width: Scalars['Int']['output'];
 };
 
+/** The visitor's consent to data processing purposes for the shop. true means accepting the purposes, false means declining them, and null means that the visitor didn't express a preference. */
+export type VisitorConsent = {
+  /** The visitor accepts or rejects the analytics data processing purpose. */
+  analytics?: InputMaybe<Scalars['Boolean']['input']>;
+  /** The visitor accepts or rejects the first and third party marketing data processing purposes. */
+  marketing?: InputMaybe<Scalars['Boolean']['input']>;
+  /** The visitor accepts or rejects the preferences data processing purpose. */
+  preferences?: InputMaybe<Scalars['Boolean']['input']>;
+  /** The visitor accepts or rejects the sale or sharing of their data with third parties. */
+  saleOfData?: InputMaybe<Scalars['Boolean']['input']>;
+};
+
 /** Units of measurement for weight. */
 export type WeightUnit =
   /** Metric system unit of mass. */

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/2025-07/objects/cart). */
+    /** An object with fields that correspond to the Storefront API's [Cart object](https://shopify.dev/api/storefront/2025-10/objects/cart). */
     data?: PartialDeep<CartType, {
         recurseIntoArrays: true;
     }>;
-    /** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2025-07/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/2025-10/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/2025-07/objects/Cart)
+ * See [cart API graphql mutations](https://shopify.dev/api/storefront/2025-10/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/2025-07/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/2025-10/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

@@ -2,12 +2,12 @@ import { CurrencyCode as StorefrontApiCurrencyCode, MoneyV2 as StorefrontApiMone
 import type { MoneyV2 as CustomerAccountApiMoneyV2, CurrencyCode as CustomerAccountApiCurrencyCode } from './customer-account-api-types.js';
 /**
  * Supports MoneyV2 from both Storefront API and Customer Account API.
- * The APIs may have different CurrencyCode enums (e.g., Customer Account API added USDC in 2025-07, but Storefront API doesn't support USDC in 2025-07).
+ * The APIs may have different CurrencyCode enums (e.g., Customer Account API added USDC in 2025-10, but Storefront API doesn't support USDC in 2025-10).
  * This union type ensures useMoney works with data from either API.
  */
 type MoneyV2 = StorefrontApiMoneyV2 | CustomerAccountApiMoneyV2;
 /**
- * Supports CurrencyCode from both Storefront API and Customer Account API. The APIs may have different CurrencyCode enums (e.g., Customer Account API added USDC in 2025-07, but Storefront API doesn't support USDC in 2025-07).
+ * Supports CurrencyCode from both Storefront API and Customer Account API. The APIs may have different CurrencyCode enums (e.g., Customer Account API added USDC in 2025-10, but Storefront API doesn't support USDC in 2025-10).
  * This union type ensures useMoney works with data from either API.
  */
 type CurrencyCode = StorefrontApiCurrencyCode | CustomerAccountApiCurrencyCode;
@@ -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/2025-07/objects/MoneyV2)
- * or a [MoneyV2 object from the Customer Account API](https://shopify.dev/docs/api/customer/2025-07/objects/moneyv2) and returns a
+ * The `useMoney` hook takes a [MoneyV2 object from the Storefront API](https://shopify.dev/docs/api/storefront/2025-10/objects/MoneyV2)
+ * or a [MoneyV2 object from the Customer Account API](https://shopify.dev/docs/api/customer/2025-10/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`

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

@@ -456,7 +456,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartLinesAdd(cartId: $cartId, lines: $lines) {
       cart {
         ...CartFragment
@@ -475,7 +481,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartCreate(input: $input) {
       cart {
         ...CartFragment
@@ -495,7 +507,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartLinesRemove(cartId: $cartId, lineIds: $lines) {
       cart {
         ...CartFragment
@@ -515,7 +533,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartLinesUpdate(cartId: $cartId, lines: $lines) {
       cart {
         ...CartFragment
@@ -535,7 +559,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartNoteUpdate(cartId: $cartId, note: $note) {
       cart {
         ...CartFragment
@@ -555,7 +585,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartBuyerIdentityUpdate(cartId: $cartId, buyerIdentity: $buyerIdentity) {
       cart {
         ...CartFragment
@@ -575,7 +611,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartAttributesUpdate(attributes: $attributes, cartId: $cartId) {
       cart {
         ...CartFragment
@@ -595,7 +637,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cartDiscountCodesUpdate(cartId: $cartId, discountCodes: $discountCodes) {
       cart {
         ...CartFragment
@@ -614,7 +662,13 @@
     $numCartLines: Int = 250
     $country: CountryCode = ZZ
     $language: LanguageCode
-  ) @inContext(country: $country, language: $language) {
+    $visitorConsent: VisitorConsent
+  )
+  @inContext(
+    country: $country
+    language: $language
+    visitorConsent: $visitorConsent
+  ) {
     cart(id: $id) {
       ...CartFragment
     }
@@ -728,7 +782,7 @@
   }
 `
   );
-  const SFAPI_VERSION = "2025-07";
+  const SFAPI_VERSION = "2025-10";
   const MOCK_SHOP_DOMAIN = "mock.shop";
   const isMockShop = (domain) => domain.includes(MOCK_SHOP_DOMAIN);
   function createStorefrontClient({
@@ -2181,6 +2235,7 @@ Refer to the authentication https://shopify.dev/api/storefront#authentication do
       onClick,
       children,
       accessibleAddingToCartLabel,
+      parent,
       ...passthroughProps
     } = props;
     const { status, linesAdd } = useCart();
@@ -2200,10 +2255,11 @@ Refer to the authentication https://shopify.dev/api/storefront#authentication do
           quantity,
           merchandiseId: variantId || "",
           attributes,
+          parent,
           sellingPlanId
         }
       ]);
-    }, [linesAdd, quantity, variantId, attributes, sellingPlanId]);
+    }, [linesAdd, quantity, variantId, attributes, sellingPlanId, parent]);
     return /* @__PURE__ */ React__namespace.createElement(React__namespace.Fragment, null, /* @__PURE__ */ React__namespace.createElement(
       BaseButton,
       {
@@ -2423,7 +2479,7 @@ Refer to the authentication https://shopify.dev/api/storefront#authentication do
     }
     return false;
   }
-  const version = "2025.7.2";
+  const version = "2025.10.0";
   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";
@@ -4170,6 +4226,7 @@ Refer to the authentication https://shopify.dev/api/storefront#authentication do
           ...metafield,
           parsedValue: metafield.value === "true"
         };
+      case "article_reference":
       case "collection_reference":
       case "file_reference":
       case "page_reference":
@@ -4263,6 +4320,7 @@ Refer to the authentication https://shopify.dev/api/storefront#authentication do
           ...metafield,
           parsedValue: Number(metafield.value)
         };
+      case "list.article_reference":
       case "list.collection_reference":
       case "list.file_reference":
       case "list.page_reference":