Skip to content

v5.24.0

Choose a tag to compare

@paul-phan paul-phan released this 28 Oct 03:09
· 90 commits to main since this release
d82355c

@weaverse/core, @weaverse/react, @weaverse/hydrogen 5.24.0

Highlights

  • Tell outages apart from missing pages (@weaverse/hydrogen). New opt-in throwPageLoadFailures client option. When it is set, loadPage() rejects with the new exported WeaverseLoadError, whose kind is unavailable, invalid-response or configuration. A storefront can then answer an outage with a retryable 503 instead of a 404 or an empty page. A missing project still resolves to null, and an unassigned page still resolves to a fallback page. (#560, refs #501)
  • Response validation. Successful /project and /project_configs responses are validated. Invalid bodies are never cached. A theme response without a theme field now returns schema defaults marked _loadFailed: true, instead of presenting them as the merchant's settings.

Behaviour changes without the opt-in

  • On the self-hosted cached path (API base on the Weaverse host), an error status for the client's own Builder requests now resolves loadPage() to null instead of the "Please add new section to start." placeholder page.
  • On the cached path, a request that gets no response is reported as a network or timeout error, as on the direct path.
  • A successful response whose body is not JSON is now reported as an invalid response rather than a network error. It keeps the existing single retry on the direct path.

Compatibility

  • @weaverse/hydrogen now declares @shopify/hydrogen >=2025.5 <2026.10.0. Hydrogen 2026.10 removed CacheCustom and createWithCache, which this package imports, so the earlier open range let projects install a Hydrogen version it crashes on at import. Hydrogen 2026.10 support is tracked in #545. (#550)
  • Packages are now built with Vite+ (vp pack), and declarations come from the pinned tsrs compiler instead of tsup/TypeScript. The published entry points, files and runtime exports are unchanged; @weaverse/hydrogen adds WeaverseLoadError and the WeaverseLoadFailureKind type. (#557, #558)

Full Changelog: v5.23.0...v5.24.0