Skip to content

Changelog

API 2026-06-16

  • Initial public Checkout API surface: configuration, product availability, prepare/create-intent/update/complete checkout, coupon validation, and AI cart lander reads.

@shoppable/checkout 0.1.0

  • First release of the isomorphic checkout SDK.
  • Resilience: automatic retries with backoff (network/timeout/429/5xx), auto-attached idempotency keys on mutations, configurable timeouts, and AbortSignal support.
  • Granular error types (ShoppableAuthError, ShoppableValidationError, ShoppableRateLimitError, ShoppableServerError, ShoppableNetworkError, ShoppableTimeoutError) carrying status, ref, and requestId.
  • Session lifecycle: inject an existing session token, transparent re-mint and retry on expiry, onSessionToken callback, and getSessionToken().
  • Wire types generated from the OpenAPI spec, guarded by a compile-time contract test so the SDK and API cannot drift.
  • API-version pinning via the Shoppable-Version header (apiVersion option).
  • MIT licensed.