@cartbase/storefront 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cartbase/storefront",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Storefront SDK + UI component library for Cartbase stores: typed API client, checkout orchestration, cart drawer, product/catalog components, tracking. Source-shipped TypeScript — add it to transpilePackages.",
   "license": "MIT",
   "repository": {

package/src/api/products.ts

@@ -116,6 +116,13 @@ export interface StoreProductVariant {
    * context. Varies by customer group — never cache shared.
    */
   calculated_price: CalculatedPrice | null
+  /**
+   * THE availability predicate, computed server-side (untracked or
+   * backorderable ⇒ true; otherwise kit-aware available stock > 0).
+   * Optional only for wire back-compat with platforms that predate it —
+   * when absent, components fall back to the optimistic legacy behavior.
+   */
+  in_stock?: boolean
 }
 
 export interface StoreProduct {

package/src/products/product-actions.tsx

@@ -14,13 +14,12 @@
  * - `countryCode` (Medusa region routing) is dropped — Cartbase pricing
  *   context travels with the product fetch, and the host's `addToCart`
  *   closes over whatever routing it needs.
- * - Stock: Cartbase's store surface does NOT expose `inventory_quantity`
- *   (availability is a search facet; the server enforces stock at add with
- *   400 `insufficient_inventory`). Managed-inventory variants without an
- *   exposed quantity are treated as in stock optimistically; a thrown
- *   `insufficient_inventory` flips the button to the out-of-stock state.
- *   Richer DTOs that DO carry `inventory_quantity` keep the original
- *   quantity check.
+ * - Stock: the variant DTO carries `in_stock`, computed server-side by THE
+ *   availability predicate — this component only reads it. The server still
+ *   enforces stock at add (400 `insufficient_inventory` flips the button to
+ *   the out-of-stock state). On a legacy wire without the field, managed
+ *   variants fall back to the old optimistic behavior; richer DTOs carrying
+ *   `inventory_quantity` keep the original quantity check.
  *
  * Variant matching is the extracted pure module `./variant-matching`
  * (handles Cartbase's option-value link shape).
@@ -121,10 +120,17 @@ export function ProductActions({
 
   const inStock = useMemo(() => {
     if (!selectedVariant) return false
+    // The server computes THE availability predicate and emits it as
+    // `in_stock` on the variant DTO — read it, never re-derive it here
+    // (the hand-copied clauses this replaced could not see stock levels and
+    // showed an enabled Add to cart on sold-out variants until a 400).
+    if (typeof selectedVariant.in_stock === "boolean") {
+      return selectedVariant.in_stock && !stockExhausted
+    }
+    // Legacy wire (platform predates the field): optimistic fallback — the
+    // server still enforces stock on add.
     if (!selectedVariant.manage_inventory) return true
     if (selectedVariant.allow_backorder) return true
-    // Cartbase wire shape carries no inventory_quantity — optimistic; the
-    // server enforces stock on add. Richer DTOs keep the original check.
     const qty = (selectedVariant as { inventory_quantity?: number })
       .inventory_quantity
     if (qty === undefined) return !stockExhausted