omni-sync-sdk 0.17.2 → 0.17.4

package/README.md

@@ -20,21 +20,21 @@ yarn add omni-sync-sdk
 
 The SDK exports these utility functions for common UI tasks:
 
-| Function                                       | Purpose                                | Example                                        |
-| ---------------------------------------------- | -------------------------------------- | ---------------------------------------------- |
-| `formatPrice(amount, currency?, locale?)`      | Format prices for display              | `formatPrice(99.99, 'USD')` → `$99.99`         |
-| `getPriceDisplay(amount, currency?, locale?)`  | Alias for `formatPrice`                | Same as above                                  |
-| `getDescriptionContent(product)`               | Get product description (HTML or text) | `getDescriptionContent(product)`               |
-| `isHtmlDescription(product)`                   | Check if description is HTML           | `isHtmlDescription(product)` → `true/false`    |
-| `getStockStatus(inventory)`                    | Get human-readable stock status        | `getStockStatus(inventory)` → `"In Stock"`     |
-| `getProductPrice(product)`                     | Get effective price (handles sales)    | `getProductPrice(product)` → `29.99`           |
-| `getProductPriceInfo(product)`                 | Get price + sale info + discount %     | `{ price, isOnSale, discountPercent }`         |
-| `getVariantPrice(variant, basePrice)`          | Get variant price with fallback        | `getVariantPrice(variant, '29.99')` → `34.99`  |
-| `getCartTotals(cart, shippingPrice?)`          | Calculate cart subtotal/discount/total | `{ subtotal, discount, shipping, total }`      |
-| `getCartItemName(item)`                        | Get name from nested cart item         | `getCartItemName(item)` → `"Blue T-Shirt"`     |
-| `getCartItemImage(item)`                       | Get image URL from cart item           | `getCartItemImage(item)` → `"https://..."`     |
-| `getVariantOptions(variant)`                   | Get variant attributes as array        | `[{ name: "Color", value: "Red" }]`            |
-| `isCouponApplicableToProduct(coupon, product)` | Check if coupon applies                | `isCouponApplicableToProduct(coupon, product)` |
+| Function                                       | Purpose                                | Example                                                |
+| ---------------------------------------------- | -------------------------------------- | ------------------------------------------------------ |
+| `formatPrice(amount, { currency?, locale? })`  | Format prices for display              | `formatPrice("99.99", { currency: 'USD' })` → `$99.99` |
+| `getPriceDisplay(amount, currency?, locale?)`  | Alias for `formatPrice`                | Same as above                                          |
+| `getDescriptionContent(product)`               | Get product description (HTML or text) | `getDescriptionContent(product)`                       |
+| `isHtmlDescription(product)`                   | Check if description is HTML           | `isHtmlDescription(product)` → `true/false`            |
+| `getStockStatus(inventory)`                    | Get human-readable stock status        | `getStockStatus(inventory)` → `"In Stock"`             |
+| `getProductPrice(product)`                     | Get effective price (handles sales)    | `getProductPrice(product)` → `29.99`                   |
+| `getProductPriceInfo(product)`                 | Get price + sale info + discount %     | `{ price, isOnSale, discountPercent }`                 |
+| `getVariantPrice(variant, basePrice)`          | Get variant price with fallback        | `getVariantPrice(variant, '29.99')` → `34.99`          |
+| `getCartTotals(cart, shippingPrice?)`          | Calculate cart subtotal/discount/total | `{ subtotal, discount, shipping, total }`              |
+| `getCartItemName(item)`                        | Get name from nested cart item         | `getCartItemName(item)` → `"Blue T-Shirt"`             |
+| `getCartItemImage(item)`                       | Get image URL from cart item           | `getCartItemImage(item)` → `"https://..."`             |
+| `getVariantOptions(variant)`                   | Get variant attributes as array        | `[{ name: "Color", value: "Red" }]`                    |
+| `isCouponApplicableToProduct(coupon, product)` | Check if coupon applies                | `isCouponApplicableToProduct(coupon, product)`         |
 
 ```typescript
 import {
@@ -49,7 +49,7 @@ import {
 } from 'omni-sync-sdk';
 
 // Format price for display
-const priceText = formatPrice(product.basePrice, 'USD'); // "$99.99"
+const priceText = formatPrice(product.basePrice, { currency: 'USD' }); // "$99.99"
 
 // Get product description (handles HTML vs plain text)
 const description = getDescriptionContent(product);
@@ -600,6 +600,9 @@ interface InventoryInfo {
   total: number;
   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
 }
 ```
 
@@ -2466,11 +2469,13 @@ export default function ProductPage({ params }: { params: { slug: string } }) {
           {adding ? 'Adding...' : 'Add to Cart'}
         </button>
 
-        {/* Stock Status */}
+        {/* Stock Status - use inStock which handles UNLIMITED variants */}
         {product.inventory && (
           <p className="mt-4 text-sm">
-            {product.inventory.available > 0
-              ? `${product.inventory.available} in stock`
+            {product.inventory.inStock
+              ? (product.inventory.trackingMode === 'UNLIMITED'
+                  ? 'In Stock'
+                  : `${product.inventory.available} in stock`)
               : 'Out of stock'}
           </p>
         )}

package/dist/index.js

@@ -3503,12 +3503,22 @@ function getStockStatus(inventory, options) {
   if (inventory.trackingMode === "UNLIMITED") {
     return options?.unlimitedText ?? options?.inStockText ?? "In Stock";
   }
+  if (inventory.inStock === true) {
+    const available2 = inventory.available;
+    const lowStockThreshold2 = options?.lowStockThreshold ?? 0;
+    if (inventory.trackingMode === "TRACKED" && lowStockThreshold2 > 0 && available2 > 0 && available2 <= lowStockThreshold2) {
+      return options?.lowStockText ?? "Low Stock";
+    }
+    return options?.inStockText ?? "In Stock";
+  }
+  if (inventory.inStock === false) {
+    return options?.outOfStockText ?? "Out of Stock";
+  }
   const available = inventory.available;
-  const inStock = inventory.inStock ?? available > 0;
-  const lowStockThreshold = options?.lowStockThreshold ?? 0;
-  if (!inStock || available <= 0) {
+  if (available <= 0) {
     return options?.outOfStockText ?? "Out of Stock";
   }
+  const lowStockThreshold = options?.lowStockThreshold ?? 0;
   if (lowStockThreshold > 0 && available <= lowStockThreshold) {
     return options?.lowStockText ?? "Low Stock";
   }

package/dist/index.mjs

@@ -3466,12 +3466,22 @@ function getStockStatus(inventory, options) {
   if (inventory.trackingMode === "UNLIMITED") {
     return options?.unlimitedText ?? options?.inStockText ?? "In Stock";
   }
+  if (inventory.inStock === true) {
+    const available2 = inventory.available;
+    const lowStockThreshold2 = options?.lowStockThreshold ?? 0;
+    if (inventory.trackingMode === "TRACKED" && lowStockThreshold2 > 0 && available2 > 0 && available2 <= lowStockThreshold2) {
+      return options?.lowStockText ?? "Low Stock";
+    }
+    return options?.inStockText ?? "In Stock";
+  }
+  if (inventory.inStock === false) {
+    return options?.outOfStockText ?? "Out of Stock";
+  }
   const available = inventory.available;
-  const inStock = inventory.inStock ?? available > 0;
-  const lowStockThreshold = options?.lowStockThreshold ?? 0;
-  if (!inStock || available <= 0) {
+  if (available <= 0) {
     return options?.outOfStockText ?? "Out of Stock";
   }
+  const lowStockThreshold = options?.lowStockThreshold ?? 0;
   if (lowStockThreshold > 0 && available <= lowStockThreshold) {
     return options?.lowStockText ?? "Low Stock";
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.17.2",
+  "version": "0.17.4",
   "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",
@@ -16,14 +16,6 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint \"src/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build"
-  },
   "keywords": [
     "omni-sync",
     "e-commerce",
@@ -72,5 +64,12 @@
     "typescript": {
       "optional": true
     }
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}