feat: update SFAPI and CAAPI to 2025-10

.changeset/api-version-2025-10.md

@@ -0,0 +1,8 @@
+---
+'@shopify/hydrogen': major
+'@shopify/hydrogen-react': major
+'@shopify/cli-hydrogen': patch
+'skeleton': major
+---
+
+Update Storefront API and Customer Account API to version 2025-10

packages/hydrogen-react/codegen.ts

@@ -4,8 +4,8 @@ import {
   customerAccountApiCustomScalars,
 } from './src/codegen.helpers';
 
-const SF_API_VERSION = '2025-07';
-const CA_API_VERSION = '2025-07';
+const SF_API_VERSION = '2025-10';
+const CA_API_VERSION = '2025-10';
 
 const storefrontAPISchema: CodegenConfig['schema'] = {
   [`https://hydrogen-preview.myshopify.com/api/${SF_API_VERSION}/graphql.json`]:

packages/hydrogen-react/docs/generated/generated_static_pages.json

@@ -35,7 +35,7 @@
         "type": "Generic",
         "anchorLink": "authentication",
         "title": "Authentication",
-        "sectionContent": "To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2025-07/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.",
+        "sectionContent": "To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2025-10/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.",
         "sectionCard": [
           {
             "subtitle": "Install",

packages/hydrogen-react/docs/staticPages/hydrogenReact.doc.ts

@@ -41,7 +41,7 @@ const data: LandingTemplateSchema = {
       anchorLink: 'authentication',
       title: 'Authentication',
       sectionContent:
-        'To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2025-07/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.',
+        'To use Hydrogen React, you need to authenticate with and make requests to the [Storefront API](/docs/api/storefront). Hydrogen React includes an [API client](/docs/api/hydrogen-react/2025-10/utilities/createstorefrontclient) to securely handle API queries and mutations.\n\nYou can create and manage Storefront API access tokens by installing the [Headless sales channel](https://apps.shopify.com/headless) on your store.\n\nApps have access to [two kinds of tokens](/docs/api/usage/authentication#access-tokens-for-the-storefront-api): a public API token, which can be used in client-side code, and a private API token, which should only be used in server-side contexts and never exposed publicly.',
       sectionCard: [
         {
           subtitle: 'Install',

packages/hydrogen-react/src/CartLineProvider.tsx

@@ -13,7 +13,7 @@ type CartLinePartialDeep = PartialDeep<
 export const CartLineContext = createContext<CartLinePartialDeep | null>(null);
 
 /**
- * The `useCartLine` hook provides access to the [CartLine object](https://shopify.dev/api/storefront/2025-07/objects/cartline) from the Storefront API. It must be a descendent of a `CartProvider` component.
+ * The `useCartLine` hook provides access to the [CartLine object](https://shopify.dev/api/storefront/2025-10/objects/cartline) from the Storefront API. It must be a descendent of a `CartProvider` component.
  */
 export function useCartLine(): CartLinePartialDeep {
   const context = useContext(CartLineContext);

packages/hydrogen-react/src/CartProvider.stories.tsx

@@ -228,7 +228,7 @@ function CartComponent() {
 const config: ShopifyProviderProps = {
   storeDomain: 'hydrogen-preview.myshopify.com',
   storefrontToken: '3b580e70970c4528da70c98e097c2fa0',
-  storefrontApiVersion: '2025-07',
+  storefrontApiVersion: '2025-10',
   countryIsoCode: 'CA',
   languageIsoCode: 'EN',
 };
@@ -249,7 +249,7 @@ Default.args = {
   numCartLines: 30,
   /** A callback that is invoked when the process to create a cart begins, but before the cart is created in the Storefront API. */
   data: undefined,
-  /** 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: undefined,
   /** A customer access token that's accessible on the server if there's a customer login. */
   customerAccessToken: undefined,

packages/hydrogen-react/src/CartProvider.tsx

@@ -88,9 +88,9 @@ type CartProviderProps = {
   onAttributesUpdateComplete?: () => void;
   /** A callback that is invoked when the process to update the cart discount codes completes */
   onDiscountCodesUpdateComplete?: () => 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;
   /** A customer access token that's accessible on the server if there's a customer login. */
   customerAccessToken?: CartBuyerIdentityInput['customerAccessToken'];

packages/hydrogen-react/src/Image.tsx

@@ -66,7 +66,7 @@ type HydrogenImageBaseProps = {
    * @defaultValue `center`
    */
   crop?: Crop;
-  /** Data mapping to the [Storefront API `Image`](https://shopify.dev/docs/api/storefront/2025-07/objects/Image) object. Must be an Image object.
+  /** Data mapping to the [Storefront API `Image`](https://shopify.dev/docs/api/storefront/2025-10/objects/Image) object. Must be an Image object.
    *
    * @example
    * ```

packages/hydrogen-react/src/ModelViewer.tsx

@@ -23,7 +23,7 @@ type ModelViewerProps = Omit<
   ModelViewerBaseProps;
 
 type ModelViewerBaseProps = {
-  /** An object with fields that correspond to the Storefront API's [Model3D object](https://shopify.dev/api/storefront/2025-07/objects/model3d). */
+  /** An object with fields that correspond to the Storefront API's [Model3D object](https://shopify.dev/api/storefront/2025-10/objects/model3d). */
   data: PartialDeep<Model3d, {recurseIntoArrays: true}>;
   /** The callback to invoke when the 'error' event is triggered. Refer to [error in the <model-viewer> documentation](https://modelviewer.dev/docs/index.html#entrydocs-loading-events-error). */
   onError?: (event: Event) => void;

packages/hydrogen-react/src/Money.tsx

@@ -9,21 +9,21 @@ import type {PartialDeep} from 'type-fest';
 
 /**
  * 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 Money component works with data from either API.
  */
 type MoneyV2 = StorefrontApiMoneyV2 | CustomerAccountApiMoneyV2;
 
 export interface MoneyPropsBase<ComponentGeneric extends React.ElementType> {
   /** An HTML tag or React Component to be rendered as the base element wrapper. The default is `div`. */
   as?: ComponentGeneric;
-  /** An object with fields that correspond to the [Storefront API's MoneyV2 object](https://shopify.dev/docs/api/storefront/2025-07/objects/MoneyV2) or [Customer Account API's MoneyV2 object](https://shopify.dev/docs/api/customer/2025-07/objects/moneyv2). */
+  /** An object with fields that correspond to the [Storefront API's MoneyV2 object](https://shopify.dev/docs/api/storefront/2025-10/objects/MoneyV2) or [Customer Account API's MoneyV2 object](https://shopify.dev/docs/api/customer/2025-10/objects/moneyv2). */
   data: PartialDeep<MoneyV2, {recurseIntoArrays: true}>;
   /** Whether to remove the currency symbol from the output. */
   withoutCurrency?: boolean;
   /** Whether to remove trailing zeros (fractional money) from the output. */
   withoutTrailingZeros?: boolean;
-  /** A [UnitPriceMeasurement object](https://shopify.dev/api/storefront/2025-07/objects/unitpricemeasurement). */
+  /** A [UnitPriceMeasurement object](https://shopify.dev/api/storefront/2025-10/objects/unitpricemeasurement). */
   measurement?: PartialDeep<UnitPriceMeasurement, {recurseIntoArrays: true}>;
   /** Customizes the separator between the money output and the measurement output. Used with the `measurement` prop. Defaults to `'/'`. */
   measurementSeparator?: ReactNode;
@@ -40,8 +40,8 @@ export type MoneyProps<ComponentGeneric extends React.ElementType> =
       : React.ComponentPropsWithoutRef<ComponentGeneric>);
 
 /**
- * The `Money` component renders a string of the [Storefront API's MoneyV2 object](https://shopify.dev/docs/api/storefront/2025-07/objects/MoneyV2)
- * or the [Customer Account API's MoneyV2 object](https://shopify.dev/docs/api/customer/2025-07/objects/moneyv2)
+ * The `Money` component renders a string of the [Storefront API's MoneyV2 object](https://shopify.dev/docs/api/storefront/2025-10/objects/MoneyV2)
+ * or the [Customer Account API's MoneyV2 object](https://shopify.dev/docs/api/customer/2025-10/objects/moneyv2)
  * according to the `locale` in the `ShopifyProvider` component.
  * &nbsp;
  * @see {@link https://shopify.dev/api/hydrogen/components/money}

packages/hydrogen-react/src/ShopPayButton2.example.jsx

@@ -5,7 +5,7 @@ export default function App() {
     <ShopifyProvider
       storeDomain="my-store"
       storefrontToken="abc123"
-      storefrontApiVersion="2025-07"
+      storefrontApiVersion="2025-10"
       countryIsoCode="CA"
       languageIsoCode="EN"
     >

packages/hydrogen-react/src/ShopPayButton2.example.tsx

@@ -5,7 +5,7 @@ export default function App() {
     <ShopifyProvider
       storeDomain="my-store"
       storefrontToken="abc123"
-      storefrontApiVersion="2025-07"
+      storefrontApiVersion="2025-10"
       countryIsoCode="CA"
       languageIsoCode="EN"
     >

packages/hydrogen-react/src/ShopifyProvider.stories.tsx

@@ -51,5 +51,5 @@ export const Default = Template.bind({});
 Default.args = {
   storeDomain: 'notashop.myshopify.com',
   storefrontToken: 'abc123',
-  version: '2025-07',
+  version: '2025-10',
 };

packages/hydrogen-react/src/ShopifyProvider.test.tsx

@@ -11,7 +11,7 @@ import type {PartialDeep} from 'type-fest';
 const SHOPIFY_CONFIG: ShopifyProviderProps = {
   storeDomain: 'https://notashop.myshopify.com',
   storefrontToken: 'abc123',
-  storefrontApiVersion: '2025-07',
+  storefrontApiVersion: '2025-10',
   countryIsoCode: 'CA',
   languageIsoCode: 'EN',
 };
@@ -41,7 +41,7 @@ describe('<ShopifyProvider/>', () => {
       });
 
       expect(result.current.getStorefrontApiUrl()).toBe(
-        'https://notashop.myshopify.com/api/2025-07/graphql.json',
+        'https://notashop.myshopify.com/api/2025-10/graphql.json',
       );
     });
 
@@ -84,7 +84,7 @@ describe('<ShopifyProvider/>', () => {
       ).toEqual({
         'X-SDK-Variant': 'hydrogen-react',
         'X-SDK-Variant-Source': 'react',
-        'X-SDK-Version': '2025-07',
+        'X-SDK-Version': '2025-10',
         'X-Shopify-Storefront-Access-Token': 'abc123',
         'content-type': 'application/json',
       });
@@ -110,7 +110,7 @@ describe('<ShopifyProvider/>', () => {
       ).toEqual({
         'X-SDK-Variant': 'hydrogen-react',
         'X-SDK-Variant-Source': 'react',
-        'X-SDK-Version': '2025-07',
+        'X-SDK-Version': '2025-10',
         'X-Shopify-Storefront-Access-Token': 'newtoken',
         'content-type': 'application/graphql',
       });
@@ -183,7 +183,7 @@ describe('<ShopifyProvider/>', () => {
       });
 
       expect(result.current.getStorefrontApiUrl()).toBe(
-        'https://notashop.myshopify.com/api/2025-07/graphql.json',
+        'https://notashop.myshopify.com/api/2025-10/graphql.json',
       );
     });
 
@@ -203,7 +203,7 @@ describe('<ShopifyProvider/>', () => {
         result.current.getStorefrontApiUrl({
           storeDomain: 'https://test.myshopify.com',
         }),
-      ).toBe('https://test.myshopify.com/api/2025-07/graphql.json');
+      ).toBe('https://test.myshopify.com/api/2025-10/graphql.json');
     });
 
     it(`handles when a '/' is at the end of the url and doesn't add an extra one`, () => {
@@ -219,7 +219,7 @@ describe('<ShopifyProvider/>', () => {
       });
 
       expect(result.current.getStorefrontApiUrl()).toBe(
-        'https://notashop.myshopify.com/api/2025-07/graphql.json',
+        'https://notashop.myshopify.com/api/2025-10/graphql.json',
       );
     });
   });
@@ -233,6 +233,6 @@ export function getShopifyConfig(
     languageIsoCode: config.languageIsoCode ?? 'EN',
     storeDomain: config.storeDomain ?? 'https://notashop.myshopify.io',
     storefrontToken: config.storefrontToken ?? 'abc123',
-    storefrontApiVersion: config.storefrontApiVersion ?? '2025-07',
+    storefrontApiVersion: config.storefrontApiVersion ?? '2025-10',
   };
 }

packages/hydrogen-react/src/Video.tsx

@@ -4,7 +4,7 @@ import type {Video as VideoType} from './storefront-api-types.js';
 import type {PartialDeep} from 'type-fest';
 
 export interface VideoProps {
-  /** An object with fields that correspond to the Storefront API's [Video object](https://shopify.dev/api/storefront/2025-07/objects/video). */
+  /** An object with fields that correspond to the Storefront API's [Video object](https://shopify.dev/api/storefront/2025-10/objects/video). */
   data: PartialDeep<VideoType, {recurseIntoArrays: true}>;
   /** An object of image size options for the video's `previewImage`. Uses `shopifyImageLoader` to generate the `poster` URL. */
   previewImageOptions?: Parameters<typeof shopifyLoader>[0];

packages/hydrogen-react/src/codegen.helpers.ts

@@ -1,6 +1,6 @@
 /**
  * Meant to be used with GraphQL CodeGen to type the Storefront API's custom scalars correctly.
- * Reference for the GraphQL types: https://shopify.dev/docs/api/storefront/2025-07/scalars/HTML
+ * Reference for the GraphQL types: https://shopify.dev/docs/api/storefront/2025-10/scalars/HTML
  * Note: JSON is generated as 'unknown' by default.
  */
 export const storefrontApiCustomScalars = {
@@ -15,7 +15,7 @@ export const storefrontApiCustomScalars = {
 
 /**
  * Meant to be used with GraphQL CodeGen to type the Storefront API's custom scalars correctly.
- * Reference for the GraphQL types: https://shopify.dev/docs/api/customer/2025-07/scalars/HTML
+ * Reference for the GraphQL types: https://shopify.dev/docs/api/customer/2025-10/scalars/HTML
  * Note: JSON is generated as 'unknown' by default.
  */
 export const customerAccountApiCustomScalars = {