omni-sync-sdk 0.17.4 → 0.17.5

package/README.md

@@ -601,8 +601,8 @@ interface InventoryInfo {
   reserved: number;
   available: number;
   trackingMode?: 'TRACKED' | 'UNLIMITED' | 'DISABLED';
-  inStock: boolean;      // Pre-calculated - use this for display!
-  canPurchase: boolean;  // Pre-calculated - use this for add-to-cart
+  inStock: boolean; // Pre-calculated - use this for display!
+  canPurchase: boolean; // Pre-calculated - use this for add-to-cart
 }
 ```
 

package/dist/index.d.mts

@@ -187,17 +187,25 @@ interface InventoryInfo {
      * - TRACKED: Normal inventory with quantity tracking
      * - UNLIMITED: Always in stock
      * - DISABLED: Cannot be purchased
+     *
+     * Note: For VARIABLE products, this is aggregated from variants:
+     * - All UNLIMITED → UNLIMITED
+     * - All DISABLED → DISABLED
+     * - Mixed → TRACKED
      */
     trackingMode?: InventoryTrackingMode;
     /**
-     * Whether the item is in stock (available > 0)
-     * Always present in vibe-coded API responses
+     * Whether the item is in stock.
+     * Pre-calculated by backend - USE THIS instead of checking `available > 0`!
+     * For VARIABLE products, true if ANY variant is available.
      */
-    inStock?: boolean;
+    inStock: boolean;
     /**
-     * Whether the item can be purchased (trackingMode !== 'DISABLED')
+     * Whether the item can be purchased.
+     * Pre-calculated by backend - USE THIS for add-to-cart button state!
+     * false if trackingMode is DISABLED or if out of stock.
      */
-    canPurchase?: boolean;
+    canPurchase: boolean;
 }
 /**
  * Check if a product description contains HTML and should be rendered with dangerouslySetInnerHTML

package/dist/index.d.ts

@@ -187,17 +187,25 @@ interface InventoryInfo {
      * - TRACKED: Normal inventory with quantity tracking
      * - UNLIMITED: Always in stock
      * - DISABLED: Cannot be purchased
+     *
+     * Note: For VARIABLE products, this is aggregated from variants:
+     * - All UNLIMITED → UNLIMITED
+     * - All DISABLED → DISABLED
+     * - Mixed → TRACKED
      */
     trackingMode?: InventoryTrackingMode;
     /**
-     * Whether the item is in stock (available > 0)
-     * Always present in vibe-coded API responses
+     * Whether the item is in stock.
+     * Pre-calculated by backend - USE THIS instead of checking `available > 0`!
+     * For VARIABLE products, true if ANY variant is available.
      */
-    inStock?: boolean;
+    inStock: boolean;
     /**
-     * Whether the item can be purchased (trackingMode !== 'DISABLED')
+     * Whether the item can be purchased.
+     * Pre-calculated by backend - USE THIS for add-to-cart button state!
+     * false if trackingMode is DISABLED or if out of stock.
      */
-    canPurchase?: boolean;
+    canPurchase: boolean;
 }
 /**
  * Check if a product description contains HTML and should be rendered with dangerouslySetInnerHTML

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.17.4",
+  "version": "0.17.5",
   "description": "Official SDK for building e-commerce storefronts with OmniSync Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",