Versioning & changelog

API versioning

The REST API is versioned in the path: /api/headless/v1/. Breaking changes would ship under a new version segment (/v2/); additive changes (new fields, new endpoints) can appear within v1.

SDK versioning

@kitenzo/core and @kitenzo/react are versioned together and published to npm. Pin a range you’re comfortable with:

{
  "dependencies": {
    "@kitenzo/react": "^0.4.0"
  }
}

Current published version: 0.4.0 (both packages).

Notable changes

0.4.0 (Aug 2026) — Custom-component engine logic moved into the SDK.
0.3.0 (Aug 2026) — Conditions engine exposed through the SDK (evaluateConditions, calculatePriceWithConditions, snapshot.conditions); Shopify Markets localised pricing (countryCode, presentment fields, formatCurrency, resolvePresentmentPricing); option-grid helpers (options / optionValues on the API, resolveVariant & friends); isSatisfied + getSectionLimits / getBundleLimits; AJAX cart transport and the useBundleAjaxCart / useStorefrontBundleCart flow hooks; required products hydrated and appended on submit; product status, tags, descriptionHtml, compareAtPrice; amount-of-one-variant and amount-of-weight limit rules; subscriptions program discovery (sellingPlans, useSellingPlan).
API — cart-ready /configure payload (Jun 2026) — native-bundle responses carry a cart object (line items + the _bundles attribute) so non-JS clients like TapCart custom blocks can write the Shopify cart without reconstructing the encoding.
API — richer products (Jun 2026) — tags and descriptionHtml on the products endpoint.
0.2.6 (Apr 2026) — SDK split into @kitenzo/core (framework-agnostic) and @kitenzo/react (provider, hooks, BundleEmbed); added the bundle embed component for Mode 1.
Headless API — REST endpoints for listing/reading bundles, configuring selections and pricing, with per-key Bearer auth, CORS and rate limiting.