[2025-10 SFAPI/CAAPI] Update API version to 2025-10

[juanpprieto]

Overview

Update Storefront API and Customer Account API from version 2025-07 to 2025-10 across the Hydrogen monorepo.

API Version

• Version: 2025-10
• Previous Version: 2025-07
• APIs: Storefront GraphQL API + Customer Account API
• Type: Version Update
• Action Required: Yes

Changes Made

Version constants updated

• packages/hydrogen-react/src/storefront-api-constants.ts - SFAPI_VERSION
• packages/hydrogen/src/customer/constants.ts - DEFAULT_CUSTOMER_API_VERSION
• packages/hydrogen-react/codegen.ts - SF_API_VERSION and CA_API_VERSION

Types regenerated

• Generated new GraphQL types from 2025-10 schemas
• Updated storefront-api-types.d.ts
• Updated customer-account-api-types.d.ts
• Updated schema JSON files

Documentation updated

• Rebuilt documentation with new API version
• Regenerated skeleton template types
• Updated all hardcoded API version references in docs, examples, and tests

Packages built

• Built hydrogen-react package
• Built all packages in monorepo
• Verified type resolution

Changeset created

Version bumps:

• @shopify/hydrogen: major
• @shopify/hydrogen-react: major
• @shopify/cli-hydrogen: patch
• skeleton: major

Related API Changes

This update enables support for new 2025-10 features tracked in separate issues:

• [2025-10 SFAPI] Add support for gift card addition without replacement #3271 - Gift card addition
• [2025-10 SFAPI] Add cartDeliveryAddressesReplace mutation #3272 - Delivery addresses replace
• [2025-10 SFAPI] BREAKING: cartDeliveryAddressesUpdate supports empty array to clear addresses #3273 - Delivery addresses breaking change (P0)
• [2025-10 SFAPI] Add @inContext visitorConsent support for privacy-compliant checkouts #3274 - Visitor consent
• [2025-10 SFAPI/CAAPI] Add support for nested cart lines #3275 - Nested cart lines
• [2025-10 SFAPI] Add MERCHANDISE_SELLING_PLAN_NOT_APPLICABLE_ON_COMPANY_LOCATION warning support #3276 - Selling plan warning
• [2025-10 SFAPI] Cart mutations return MERCHANDISE_NOT_APPLICABLE error #3277 - Merchandise error
• [2025-10 SFAPI] Image alt text translation support #3278 - Image alt translation
• [2025-10 CAAPI] Store credit support for company locations #3279 - Store credit
• [2025-10 CAAPI] Payment schedule balance and due status fields #3280 - Payment schedule fields

Validation Required

Run validation suite

• npm run typecheck - verify no type errors
• npm test - verify all tests pass
• npm run lint - verify no lint issues

Verify skeleton builds

• cd templates/skeleton && npm run build
• Check for any codegen or build errors

Priority

P0 - Foundation for all other 2025-10 features