@shopify/hydrogen-react 2025.5.0 → 2025.7.1

package/dist/types/index.d.cts

@@ -32,6 +32,7 @@ export { ShopPayButton } from './ShopPayButton.js';
 export type { StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, } from './storefront-api-response.types.js';
 export type { StorefrontClientProps } from './storefront-client.js';
 export { createStorefrontClient } from './storefront-client.js';
+export { getTrackingValues, SHOPIFY_UNIQUE_TOKEN_HEADER, SHOPIFY_VISIT_TOKEN_HEADER, } from './tracking-utils.js';
 export { useMoney } from './useMoney.js';
 export { useSelectedOptionInUrlParam } from './useSelectedOptionInUrlParam.js';
 export { useShopifyCookies } from './useShopifyCookies.js';

package/dist/types/index.d.ts

@@ -32,6 +32,7 @@ export { ShopPayButton } from './ShopPayButton.js';
 export type { StorefrontApiResponse, StorefrontApiResponseError, StorefrontApiResponseOk, StorefrontApiResponseOkPartial, StorefrontApiResponsePartial, } from './storefront-api-response.types.js';
 export type { StorefrontClientProps } from './storefront-client.js';
 export { createStorefrontClient } from './storefront-client.js';
+export { getTrackingValues, SHOPIFY_UNIQUE_TOKEN_HEADER, SHOPIFY_VISIT_TOKEN_HEADER, } from './tracking-utils.js';
 export { useMoney } from './useMoney.js';
 export { useSelectedOptionInUrlParam } from './useSelectedOptionInUrlParam.js';
 export { useShopifyCookies } from './useShopifyCookies.js';

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-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2025-04/objects/Product#field-encodedvariantavailability)
+ * @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)
  * @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-04/objects/Product#field-encodedvariantexistence) or [product.encodedVariantAvailability](/docs/api/storefront/2025-04/objects/Product#field-encodedvariantavailability)
+ * @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)
  * @returns Decoded option value combinations
  */
 export declare function decodeEncodedVariant(encodedVariantField: EncodedVariantField): DecodedOptionValues;

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

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

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-04
+ * Based on Storefront API 2025-07
  * 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
  */
@@ -708,7 +708,7 @@ export type CartBuyerIdentity = {
    * The rank of the preferences is determined by the order of the addresses in the array. Preferences
    * can be used to populate relevant fields in the checkout flow.
    *
-   * As of the `2025-04` release, `buyerIdentity.deliveryAddressPreferences` is deprecated.
+   * As of the `2025-01` release, `buyerIdentity.deliveryAddressPreferences` is deprecated.
    * Delivery addresses are now part of the `CartDelivery` object and managed with three new mutations:
    * - `cartDeliveryAddressAdd`
    * - `cartDeliveryAddressUpdate`
@@ -1307,6 +1307,10 @@ export type CartErrorCode =
   | 'ADDRESS_FIELD_IS_REQUIRED'
   /** The specified address field is too long. */
   | 'ADDRESS_FIELD_IS_TOO_LONG'
+  /** Buyer cannot purchase for company location. */
+  | 'BUYER_CANNOT_PURCHASE_FOR_COMPANY_LOCATION'
+  /** The cart is too large to save. */
+  | 'CART_TOO_LARGE'
   /** The input value is invalid. */
   | 'INVALID'
   /** Company location not found or not allowed. */
@@ -1325,6 +1329,8 @@ export type CartErrorCode =
   | 'INVALID_METAFIELDS'
   /** The payment wasn't valid. */
   | 'INVALID_PAYMENT'
+  /** The payment is invalid. Deferred payment is required. */
+  | 'INVALID_PAYMENT_DEFERRED_PAYMENT_REQUIRED'
   /** Cannot update payment on an empty cart */
   | 'INVALID_PAYMENT_EMPTY_CART'
   /** The given zip code is invalid for the provided country. */
@@ -1347,16 +1353,46 @@ export type CartErrorCode =
   | 'NOTE_TOO_LONG'
   /** Only one delivery address can be selected. */
   | 'ONLY_ONE_DELIVERY_ADDRESS_CAN_BE_SELECTED'
+  /** Credit card has expired. */
+  | 'PAYMENTS_CREDIT_CARD_BASE_EXPIRED'
+  /** Credit card gateway is not supported. */
+  | 'PAYMENTS_CREDIT_CARD_BASE_GATEWAY_NOT_SUPPORTED'
+  /** Credit card error. */
+  | 'PAYMENTS_CREDIT_CARD_GENERIC'
+  /** Credit card month is invalid. */
+  | 'PAYMENTS_CREDIT_CARD_MONTH_INCLUSION'
+  /** Credit card number is invalid. */
+  | 'PAYMENTS_CREDIT_CARD_NUMBER_INVALID'
+  /** Credit card number format is invalid. */
+  | 'PAYMENTS_CREDIT_CARD_NUMBER_INVALID_FORMAT'
+  /** Credit card verification value is blank. */
+  | 'PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_BLANK'
+  /** Credit card verification value is invalid for card type. */
+  | 'PAYMENTS_CREDIT_CARD_VERIFICATION_VALUE_INVALID_FOR_CARD_TYPE'
+  /** Credit card has expired. */
+  | 'PAYMENTS_CREDIT_CARD_YEAR_EXPIRED'
+  /** Credit card expiry year is invalid. */
+  | 'PAYMENTS_CREDIT_CARD_YEAR_INVALID_EXPIRY_YEAR'
+  /** The payment method is not applicable. */
+  | 'PAYMENT_METHOD_NOT_APPLICABLE'
   /** The payment method is not supported. */
   | 'PAYMENT_METHOD_NOT_SUPPORTED'
+  /** The delivery group is in a pending state. */
+  | 'PENDING_DELIVERY_GROUPS'
   /** The given province cannot be found. */
   | 'PROVINCE_NOT_FOUND'
+  /** Selling plan is not applicable. */
+  | 'SELLING_PLAN_NOT_APPLICABLE'
+  /** An error occurred while saving the cart. */
+  | 'SERVICE_UNAVAILABLE'
   /** Too many delivery addresses on Cart. */
   | 'TOO_MANY_DELIVERY_ADDRESSES'
   /** A general error occurred during address validation. */
   | 'UNSPECIFIED_ADDRESS_ERROR'
   /** Validation failed. */
   | 'VALIDATION_CUSTOM'
+  /** Variant can only be purchased with a selling plan. */
+  | 'VARIANT_REQUIRES_SELLING_PLAN'
   /** The given zip code is unsupported. */
   | 'ZIP_CODE_NOT_SUPPORTED';
 
@@ -1759,6 +1795,17 @@ export type CartPrepareForCompletionResult =
   | CartStatusReady
   | CartThrottled;
 
+/** Return type for `cartRemovePersonalData` mutation. */
+export type CartRemovePersonalDataPayload = {
+  __typename?: 'CartRemovePersonalDataPayload';
+  /** 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>;
+};
+
 /**
  * A selectable delivery address for a cart.
  *
@@ -1862,6 +1909,8 @@ export type CartSubmitForCompletionResult =
  */
 export type CartThrottled = {
   __typename?: 'CartThrottled';
+  /** The result of cart preparation for completion. */
+  cart?: Maybe<Cart>;
   /** The polling delay. */
   pollAfter: Scalars['DateTime']['output'];
 };
@@ -1901,6 +1950,30 @@ export type CartWarning = {
 
 /** The code for the cart warning. */
 export type CartWarningCode =
+  /** The discount code cannot be honored. */
+  | 'DISCOUNT_CODE_NOT_HONOURED'
+  /** The discount is currently inactive. */
+  | 'DISCOUNT_CURRENTLY_INACTIVE'
+  /** The customer is not eligible for this discount. */
+  | 'DISCOUNT_CUSTOMER_NOT_ELIGIBLE'
+  /** The customer's discount usage limit has been reached. */
+  | 'DISCOUNT_CUSTOMER_USAGE_LIMIT_REACHED'
+  /** An eligible customer is missing for this discount. */
+  | 'DISCOUNT_ELIGIBLE_CUSTOMER_MISSING'
+  /** The purchase type is incompatible with this discount. */
+  | 'DISCOUNT_INCOMPATIBLE_PURCHASE_TYPE'
+  /** The discount was not found. */
+  | 'DISCOUNT_NOT_FOUND'
+  /** There are no entitled line items for this discount. */
+  | 'DISCOUNT_NO_ENTITLED_LINE_ITEMS'
+  /** There are no entitled shipping lines for this discount. */
+  | 'DISCOUNT_NO_ENTITLED_SHIPPING_LINES'
+  /** The purchase is not in range for this discount. */
+  | 'DISCOUNT_PURCHASE_NOT_IN_RANGE'
+  /** The quantity is not in range for this discount. */
+  | 'DISCOUNT_QUANTITY_NOT_IN_RANGE'
+  /** The discount usage limit has been reached. */
+  | 'DISCOUNT_USAGE_LIMIT_REACHED'
   /** A delivery address with the same details already exists on this cart. */
   | 'DUPLICATE_DELIVERY_ADDRESS'
   /** The merchandise does not have enough stock. */
@@ -2272,9 +2345,14 @@ export type Country = {
   availableLanguages: Array<Language>;
   /** The currency of the country. */
   currency: Currency;
+  /** The default language for the country. */
+  defaultLanguage: Language;
   /** The ISO code of the country. */
   isoCode: CountryCode;
-  /** The market that includes this country. */
+  /**
+   * The market that includes this country.
+   * @deprecated This `market` field will be removed in a future version of the API.
+   */
   market?: Maybe<Market>;
   /** The name of the country. */
   name: Scalars['String']['output'];
@@ -3980,6 +4058,15 @@ export type Image = {
    * @deprecated Use `url` instead.
    */
   src: Scalars['URL']['output'];
+  /**
+   * The ThumbHash of the image.
+   *
+   * Useful to display placeholder images while the original image is loading.
+   *
+   * See https://evanw.github.io/thumbhash/ for details on how to use it.
+   *
+   */
+  thumbhash?: Maybe<Scalars['String']['output']>;
   /**
    * The location of the transformed image as a URL.
    *
@@ -4422,7 +4509,10 @@ export type Localization = {
   country: Country;
   /** The language of the active localized experience. Use the `@inContext` directive to change this value. */
   language: Language;
-  /** The market including the country of the active localized experience. Use the `@inContext` directive to change this value. */
+  /**
+   * The market including the country of the active localized experience. Use the `@inContext` directive to change this value.
+   * @deprecated This `market` field will be removed in a future version of the API.
+   */
   market: Market;
 };
 
@@ -4944,6 +5034,8 @@ export type MetafieldReferencesArgs = {
 
 /** Possible error codes that can be returned by `MetafieldDeleteUserError`. */
 export type MetafieldDeleteErrorCode =
+  /** The current app is not authorized to perform this action. */
+  | 'APP_NOT_AUTHORIZED'
   /** The owner ID is invalid. */
   | 'INVALID_OWNER'
   /** Metafield not found. */
@@ -5053,6 +5145,8 @@ export type MetafieldsSetUserError = DisplayableError & {
 
 /** Possible error codes that can be returned by `MetafieldsSetUserError`. */
 export type MetafieldsSetUserErrorCode =
+  /** The current app is not authorized to perform this action. */
+  | 'APP_NOT_AUTHORIZED'
   /** The input value is blank. */
   | 'BLANK'
   /** The input value isn't included in the list. */
@@ -5278,6 +5372,8 @@ export type Mutation = {
   cartPaymentUpdate?: Maybe<CartPaymentUpdatePayload>;
   /** Prepare the cart for cart checkout completion. */
   cartPrepareForCompletion?: Maybe<CartPrepareForCompletionPayload>;
+  /** Removes personally identifiable information from the cart. */
+  cartRemovePersonalData?: Maybe<CartRemovePersonalDataPayload>;
   /** Update the selected delivery options for a delivery group. */
   cartSelectedDeliveryOptionsUpdate?: Maybe<CartSelectedDeliveryOptionsUpdatePayload>;
   /** Submit the cart for checkout completion. */
@@ -5458,6 +5554,11 @@ export type MutationCartPrepareForCompletionArgs = {
   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 MutationCartRemovePersonalDataArgs = {
+  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 MutationCartSelectedDeliveryOptionsUpdateArgs = {
   cartId: Scalars['ID']['input'];
@@ -5572,8 +5673,8 @@ export type MutationShopPayPaymentRequestSessionSubmitArgs = {
 /**
  * An object with an ID field to support global identification, in accordance with the
  * [Relay specification](https://relay.dev/graphql/objectidentification.htm#sec-Node-Interface).
- * This interface is used by the [node](https://shopify.dev/api/admin-graphql/unstable/queries/node)
- * and [nodes](https://shopify.dev/api/admin-graphql/unstable/queries/nodes) queries.
+ * This interface is used by the [node](/docs/api/storefront/latest/queries/node)
+ * and [nodes](/docs/api/storefront/latest/queries/nodes) queries.
  *
  */
 export type Node = {
@@ -7924,6 +8025,8 @@ export type Shop = HasMetafields &
     __typename?: 'Shop';
     /** The shop's branding configuration. */
     brand?: Maybe<Brand>;
+    /** The URL for the customer account (only present if shop has a customer account vanity domain). */
+    customerAccountUrl?: Maybe<Scalars['String']['output']>;
     /** A description of the shop. */
     description?: Maybe<Scalars['String']['output']>;
     /** A globally-unique ID. */
@@ -8681,9 +8784,13 @@ export type SubmissionErrorCode =
   | 'PAYMENTS_SHOPIFY_PAYMENTS_REQUIRED'
   | 'PAYMENTS_UNACCEPTABLE_PAYMENT_AMOUNT'
   | 'PAYMENTS_WALLET_CONTENT_MISSING'
+  /** Redirect to checkout required to complete this action. */
+  | 'REDIRECT_TO_CHECKOUT_REQUIRED'
   | 'TAXES_DELIVERY_GROUP_ID_NOT_FOUND'
   | 'TAXES_LINE_ID_NOT_FOUND'
-  | 'TAXES_MUST_BE_DEFINED';
+  | 'TAXES_MUST_BE_DEFINED'
+  /** Validation failed. */
+  | 'VALIDATION_CUSTOM';
 
 /** Cart submit for checkout completion is successful. */
 export type SubmitAlreadyAccepted = {
@@ -8786,8 +8893,12 @@ export type UnitPriceMeasurement = {
 export type UnitPriceMeasurementMeasuredType =
   /** Unit of measurements representing areas. */
   | 'AREA'
+  /** Unit of measurements representing counts. */
+  | 'COUNT'
   /** Unit of measurements representing lengths. */
   | 'LENGTH'
+  /** The type of measurement is unknown. Upgrade to the latest version of the API to resolve this type. */
+  | 'UNKNOWN'
   /** Unit of measurements representing volumes. */
   | 'VOLUME'
   /** Unit of measurements representing weights. */
@@ -8799,12 +8910,26 @@ export type UnitPriceMeasurementMeasuredUnit =
   | 'CL'
   /** 100 centimeters equals 1 meter. */
   | 'CM'
+  /** Imperial system unit of volume (U.S. customary unit). */
+  | 'FLOZ'
+  /** 1 foot equals 12 inches. */
+  | 'FT'
+  /** Imperial system unit of area. */
+  | 'FT2'
   /** Metric system unit of weight. */
   | 'G'
+  /** 1 gallon equals 128 fluid ounces (U.S. customary unit). */
+  | 'GAL'
+  /** Imperial system unit of length. */
+  | 'IN'
+  /** 1 item, a unit of count. */
+  | 'ITEM'
   /** 1 kilogram equals 1000 grams. */
   | 'KG'
   /** Metric system unit of volume. */
   | 'L'
+  /** Imperial system unit of weight. */
+  | 'LB'
   /** Metric system unit of length. */
   | 'M'
   /** Metric system unit of area. */
@@ -8816,7 +8941,17 @@ export type UnitPriceMeasurementMeasuredUnit =
   /** 1000 milliliters equals 1 liter. */
   | 'ML'
   /** 1000 millimeters equals 1 meter. */
-  | 'MM';
+  | 'MM'
+  /** 16 ounces equals 1 pound. */
+  | 'OZ'
+  /** 1 pint equals 16 fluid ounces (U.S. customary unit). */
+  | 'PT'
+  /** 1 quart equals 32 fluid ounces (U.S. customary unit). */
+  | 'QT'
+  /** The unit of measurement is unknown. Upgrade to the latest version of the API to resolve this unit. */
+  | 'UNKNOWN'
+  /** 1 yard equals 36 inches. */
+  | 'YD';
 
 /** Systems of weights and measures. */
 export type UnitSystem =

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

@@ -0,0 +1,21 @@
+/** Storefront API header for VisitToken */
+export declare const SHOPIFY_VISIT_TOKEN_HEADER = "X-Shopify-VisitToken";
+/** Storefront API header for UniqueToken */
+export declare const SHOPIFY_UNIQUE_TOKEN_HEADER = "X-Shopify-UniqueToken";
+type TrackingValues = {
+    /** Identifier for the unique user. Equivalent to the deprecated _shopify_y cookie */
+    uniqueToken: string;
+    /** Identifier for the current visit. Equivalent to the deprecated _shopify_s cookie */
+    visitToken: string;
+    /** Represents the consent given by the user or the default region consent configured in Admin */
+    consent: string;
+};
+export declare const cachedTrackingValues: {
+    current: null | TrackingValues;
+};
+/**
+ * Retrieves user session tracking values for analytics
+ * and marketing from the browser environment.
+ */
+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/2025-04/objects/cart). */
+    /** An object with fields that correspond to the Storefront API's [Cart object](https://shopify.dev/api/storefront/2025-07/objects/cart). */
     data?: PartialDeep<CartType, {
         recurseIntoArrays: true;
     }>;
-    /** A fragment used to query the Storefront API's [Cart object](https://shopify.dev/api/storefront/2025-04/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-07/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-04/objects/Cart)
+ * See [cart API graphql mutations](https://shopify.dev/api/storefront/2025-07/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-04/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-07/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

@@ -1,4 +1,16 @@
-import { CurrencyCode, MoneyV2 } from './storefront-api-types.js';
+import { CurrencyCode as StorefrontApiCurrencyCode, MoneyV2 as StorefrontApiMoneyV2 } from './storefront-api-types.js';
+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).
+ * 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).
+ * This union type ensures useMoney works with data from either API.
+ */
+type CurrencyCode = StorefrontApiCurrencyCode | CustomerAccountApiCurrencyCode;
 export type UseMoneyValue = {
     /**
      * The currency code from the `MoneyV2` object.
@@ -47,7 +59,8 @@ export type UseMoneyValue = {
     withoutTrailingZerosAndCurrency: string;
 };
 /**
- * The `useMoney` hook takes a [MoneyV2 object](https://shopify.dev/api/storefront/reference/common-objects/moneyv2) and returns a
+ * 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
  * 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`
@@ -98,3 +111,4 @@ export type UseMoneyValue = {
  * ```
  */
 export declare function useMoney(money: MoneyV2): UseMoneyValue;
+export {};

package/dist/types/useShopifyCookies.d.ts

@@ -1,4 +1,4 @@
-type UseShopifyCookiesOptions = {
+type UseShopifyCookiesOptions = CoreShopifyCookiesOptions & {
     /**
      * If set to `false`, Shopify cookies will be removed.
      * If set to `true`, Shopify unique user token cookie will have cookie expiry of 1 year.
@@ -13,6 +13,32 @@ type UseShopifyCookiesOptions = {
      * The checkout domain of the shop. Defaults to empty string. If set, the cookie domain will check if it can be set with the checkout domain.
      */
     checkoutDomain?: string;
+    /**
+     * If set to `true`, it skips modifying the deprecated shopify_y and shopify_s cookies.
+     */
+    ignoreDeprecatedCookies?: boolean;
+};
+/**
+ * Sets the `shopify_y` and `shopify_s` cookies in the browser based on user consent
+ * for backward compatibility support.
+ *
+ * If `fetchTrackingValues` is true, it makes a request to Storefront API
+ * to fetch or refresh Shopiy analytics and marketing cookies and tracking values.
+ * Generally speaking, this should only be needed if you're not using Hydrogen's
+ * built-in analytics components and hooks that already handle this automatically.
+ * For example, set it to `true` if you are using `hydrogen-react` only with
+ * a different framework and still need to make a same-domain request to
+ * Storefront API to set cookies.
+ *
+ * If `ignoreDeprecatedCookies` is true, it skips setting the deprecated cookies entirely.
+ * 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.
+ */
+export declare function useShopifyCookies(options?: UseShopifyCookiesOptions): boolean;
+type CoreShopifyCookiesOptions = {
+    storefrontAccessToken?: string;
+    fetchTrackingValues?: boolean;
+    checkoutDomain?: string;
 };
-export declare function useShopifyCookies(options?: UseShopifyCookiesOptions): void;
 export {};