[2026-04] Storefront & Customer Account API version update#3651
Merged
itsjustriley merged 4 commits intomainfrom Apr 9, 2026
Merged
[2026-04] Storefront & Customer Account API version update#3651itsjustriley merged 4 commits intomainfrom
itsjustriley merged 4 commits intomainfrom
Conversation
Contributor
|
Oxygen deployed a preview of your
Learn more about Hydrogen's GitHub integration. |
itsjustriley
force-pushed
the
2026-04-sfapi-caapi-update
branch
from
7d65a9d to
1eaa732
Compare
fredericoo
reviewed
Apr 7, 2026
andguy95
approved these changes
Apr 8, 2026
Update Storefront API and Customer Account API from 2026-01 to 2026-04. Why: Quarterly API version update for the Hydrogen 2026.4 release. The 2026-04 API version introduces: - JSON metafield write size limit (128KB for new apps) - New MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR cart error code How: Updated version constants in 3 files, regenerated GraphQL types and schemas from the new API endpoints, updated all hardcoded version references in JSDoc comments, doc files, tests, stories, and examples. No breaking schema changes affect Hydrogen's queries — skeleton codegen produces identical output. Tracking issues: Shopify/developer-tools-team#1189, #1190 Parent issue: Shopify/developer-tools-team#1178 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Per CLAUDE.md bundling chain rules, any skeleton bump requires bumping cli-hydrogen AND create-hydrogen. The 2026-01 API update precedent (commit d46c886) confirms this pattern. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
…trings
Changeset paragraphs clarified to be accurate for merchant-facing docs:
- 128KB metafield limit: explicitly states the limit is enforced by the
Storefront API, not Hydrogen, to prevent merchants from filing bugs
against Hydrogen for API-level behaviour
- MERCHANDISE_LINE_TRANSFORMERS_RUN_ERROR: reworded to avoid internal
Shopify jargon ("Cart Transform Function") and added actionability
("you may want to add handling for this new code")
Test files: replaced hardcoded '2026-04' version strings with SFAPI_VERSION
constant in assertions that verify SDK-reported version. This prevents
the same manual-update churn on the next quarterly API bump.
- storefront-client.test.ts: X-SDK-Version assertion in getPrivateTokenHeaders
- ShopifyProvider.test.tsx: getShopifyConfig helper default (intentional
test inputs in SHOPIFY_CONFIG are left as literals)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…RSION Three X-SDK-Version assertions in getPrivateTokenHeaders (allows overrides) and getPublicTokenHeaders (generates headers, allows overrides) still used the literal '2026-04'. All four assertions use generateConfig without specifying storefrontApiVersion, so the SDK falls back to SFAPI_VERSION — making the constant the semantically correct reference in all cases. Caught during consensus review (john-ousterhout, gray-verification-guardian). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
itsjustriley
force-pushed
the
2026-04-sfapi-caapi-update
branch
from
2247ca6 to
a614ba2
Compare
Merged
This was referenced Apr 9, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Updated Storefront API and Customer Account API from version 2026-01 to 2026-04 for the Hydrogen 2026.4 release.
Part of https://github.com/Shopify/developer-tools-team/issues/1178.
API Changes Overview
MERCHANDISE_LINE_TRANSFORMERS_RUN_ERRORcart error codeJSON metafield 128KB limit
cartMetafieldsSetis a passthrough — no code changes needed, but documented in changeset for merchant awarenessNew cart error code
MERCHANDISE_LINE_TRANSFORMERS_RUN_ERRORreplaces genericINVALIDfor Cart Transform Function failuresChanges Made
storefront-api-constants.ts,customer/constants.ts,codegen.ts)2026-01version references in JSDoc comments, doc files, tests, stories, and examples (33 files)Validation Status
init.test.ts > typechecks the project— caused by@types/nodededup issue, fixed by fix: pin @types/node to deduplicate Vite type resolutions #3650Test plan
npm run typecheckpassesnpm run lintpassesnpm run testpasses (except pre-existing init.test.ts failure)npm run build:pkgsucceeds🤖 Generated with Claude Code