omni-sync-sdk 0.17.4 → 0.18.0

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

@@ -113,17 +113,27 @@ interface CustomerProfile {
     updatedAt: string;
 }
 interface ProductMetafield {
+    id?: string;
+    definitionId?: string;
+    /** Key from definition (alias: definitionKey) */
     key: string;
+    /** Alias for key from backend */
+    definitionKey?: string;
     value: string;
+    /** Display name (maps to definitionName in backend) */
     name?: string;
+    /** Alias for name from backend */
+    definitionName?: string;
     type?: string;
+    /** Variant ID if this metafield is variant-specific */
+    variantId?: string | null;
 }
 interface Product {
     id: string;
     name: string;
     slug?: string | null;
     description?: string | null;
-    descriptionFormat?: 'text' | 'html' | 'markdown';
+    descriptionFormat?: 'text' | 'html' | 'markdown' | null;
     sku: string;
     /** Base price as string (e.g., "29.99"). Use parseFloat() for calculations. */
     basePrice: string;
@@ -131,16 +141,57 @@ interface Product {
     salePrice?: string | null;
     /** Cost price as string. Use parseFloat() for calculations. */
     costPrice?: string | null;
-    status: 'active' | 'draft' | 'archived';
+    status?: string | null;
     type: 'SIMPLE' | 'VARIABLE';
     isDownloadable?: boolean;
     images?: ProductImage[];
     inventory?: InventoryInfo | null;
     variants?: ProductVariant[];
-    categories?: string[];
+    /** Categories as objects with id and name */
+    categories?: Array<{
+        id: string;
+        name: string;
+    }>;
+    /** Brands as objects with id and name */
+    brands?: Array<{
+        id: string;
+        name: string;
+    }>;
     tags?: string[];
     metafields?: ProductMetafield[];
     channels?: Record<string, Record<string, unknown>>;
+    /** Shopify product ID (admin mode only) */
+    shopifyProductId?: string | null;
+    /** Whether product needs sync to platforms (admin mode only) */
+    needsSync?: boolean;
+    /** Last sync timestamp (admin mode only) */
+    lastSyncedAt?: string | null;
+    /** Menu/display order */
+    menuOrder?: number | null;
+    /** Full attribute options for variant selection (admin mode only) */
+    productAttributeOptions?: Array<{
+        id: string;
+        attributeId: string;
+        attributeOptionId: string;
+        platform: string;
+        attribute: {
+            id: string;
+            name: string;
+        } | null;
+        attributeOption: {
+            id: string;
+            name: string;
+            value?: string | null;
+        } | null;
+    }>;
+    /** Vibe-coded sites this product is published to (admin mode only) */
+    vibeCodedPublishes?: Array<{
+        connection: {
+            id: string;
+            name: string;
+            connectionId: string;
+        };
+    }>;
     createdAt: string;
     updatedAt: string;
 }
@@ -153,6 +204,8 @@ interface ProductImage {
 }
 interface ProductVariant {
     id: string;
+    /** Parent product ID */
+    productId: string;
     sku?: string | null;
     name?: string | null;
     /** Variant price as string. Use parseFloat() for calculations. */
@@ -160,16 +213,16 @@ interface ProductVariant {
     /** Variant sale price as string. Use parseFloat() for calculations. */
     salePrice?: string | null;
     /** Variant attributes (e.g., { "Color": "Red", "Size": "M" }) */
-    attributes?: Record<string, unknown>;
+    attributes?: Record<string, unknown> | null;
     inventory?: InventoryInfo | null;
     /** Variant image URL or image object */
-    image?: string | {
-        url: string;
-    } | null;
+    image?: unknown | null;
     /** Display position/order for sorting variants */
-    position?: number;
+    position: number;
     /** Variant status */
-    status?: 'active' | 'draft' | 'archived';
+    status?: string | null;
+    createdAt: string;
+    updatedAt: string;
 }
 /**
  * Inventory tracking mode determines how stock is managed:
@@ -180,24 +233,32 @@ interface ProductVariant {
 type InventoryTrackingMode = 'TRACKED' | 'UNLIMITED' | 'DISABLED';
 interface InventoryInfo {
     total: number;
-    reserved?: number;
+    reserved: number;
     available: number;
     /**
      * Inventory tracking mode
      * - 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
@@ -664,6 +725,23 @@ interface SyncJob {
     message?: string;
 }
 type ConnectorPlatform = 'SHOPIFY' | 'TIKTOK' | 'META' | 'WOOCOMMERCE' | 'CUSTOM';
+/**
+ * Reference to an entity with ID and name.
+ * Used for products, categories, and other related entities.
+ */
+interface EntityRef {
+    id: string;
+    name: string;
+}
+/**
+ * Customer targeting restrictions for coupons.
+ */
+interface CustomerRestrictionsDto {
+    type: 'all' | 'emails' | 'customers' | 'segments';
+    emails?: string[];
+    customerIds?: string[];
+    segmentIds?: string[];
+}
 type CouponType = 'PERCENTAGE' | 'FIXED_AMOUNT' | 'FREE_SHIPPING' | 'BUY_X_GET_Y';
 type CouponStatus = 'ACTIVE' | 'SCHEDULED' | 'EXPIRED' | 'DISABLED';
 interface Coupon {
@@ -672,38 +750,56 @@ interface Coupon {
     title?: string | null;
     description?: string | null;
     type: CouponType;
-    value: number;
+    /** Coupon value as string (Decimal). Use parseFloat() for calculations. */
+    value: string;
     startsAt?: string | null;
     endsAt?: string | null;
     status: CouponStatus;
     usageLimit?: number | null;
     usageLimitPerCustomer?: number | null;
     usageCount: number;
-    minimumOrderAmount?: number | null;
-    maximumDiscount?: number | null;
+    /** Minimum order amount as string (Decimal). Use parseFloat() for calculations. */
+    minimumOrderAmount?: string | null;
+    /** Maximum discount amount as string (Decimal). Use parseFloat() for calculations. */
+    maximumDiscount?: string | null;
     conditions?: Record<string, unknown> | null;
     /**
-     * Product IDs this coupon applies to.
+     * Products this coupon applies to.
      * If set, coupon only applies to these specific products.
+     * Returns objects with id and name from backend.
      */
-    applicableProducts?: string[] | null;
+    applicableProducts?: EntityRef[] | null;
     /**
-     * Product IDs excluded from this coupon.
+     * Products excluded from this coupon.
      * These products will not receive the discount even if in applicable categories.
+     * Returns objects with id and name from backend.
      */
-    excludedProducts?: string[] | null;
+    excludedProducts?: EntityRef[] | null;
     /**
-     * Category IDs this coupon applies to.
+     * Categories this coupon applies to.
      * If set, coupon only applies to products in these categories.
+     * Returns objects with id and name from backend.
      */
-    applicableCategories?: string[] | null;
+    applicableCategories?: EntityRef[] | null;
     /**
-     * Category IDs excluded from this coupon.
+     * Categories excluded from this coupon.
      * Products in these categories will not receive the discount.
+     * Returns objects with id and name from backend.
      */
-    excludedCategories?: string[] | null;
+    excludedCategories?: EntityRef[] | null;
     combinesWithOther: boolean;
     freeShipping: boolean;
+    combinesWithOrderDiscounts?: boolean | null;
+    combinesWithProductDiscounts?: boolean | null;
+    combinesWithShippingDiscounts?: boolean | null;
+    customerRestrictions?: CustomerRestrictionsDto | null;
+    minimumQuantity?: number | null;
+    /** Whether coupon needs sync to platforms */
+    needsSync?: boolean;
+    /** Last sync timestamp */
+    lastSyncedAt?: string | null;
+    /** Per-platform channel overrides */
+    channels?: Record<string, Record<string, unknown>> | null;
     shopifyCouponId?: string | null;
     woocommerceCouponId?: string | null;
     tiktokCouponId?: string | null;
@@ -725,14 +821,17 @@ interface CreateCouponDto {
     title?: string;
     description?: string;
     type: CouponType;
-    value: number;
+    /** Coupon value - accepts number or string (will be converted to Decimal) */
+    value: number | string;
     startsAt?: string;
     endsAt?: string;
     status?: CouponStatus;
     usageLimit?: number;
     usageLimitPerCustomer?: number;
-    minimumOrderAmount?: number;
-    maximumDiscount?: number;
+    /** Minimum order amount - accepts number or string */
+    minimumOrderAmount?: number | string;
+    /** Maximum discount amount - accepts number or string */
+    maximumDiscount?: number | string;
     conditions?: Record<string, unknown>;
     /** Product IDs this coupon applies to */
     applicableProducts?: string[];
@@ -744,6 +843,11 @@ interface CreateCouponDto {
     excludedCategories?: string[];
     combinesWithOther?: boolean;
     freeShipping?: boolean;
+    combinesWithOrderDiscounts?: boolean;
+    combinesWithProductDiscounts?: boolean;
+    combinesWithShippingDiscounts?: boolean;
+    customerRestrictions?: CustomerRestrictionsDto;
+    minimumQuantity?: number;
     /** Platforms to publish this coupon to */
     platforms?: ConnectorPlatform[];
 }
@@ -752,14 +856,17 @@ interface UpdateCouponDto {
     title?: string;
     description?: string;
     type?: CouponType;
-    value?: number;
+    /** Coupon value - accepts number or string (will be converted to Decimal) */
+    value?: number | string;
     startsAt?: string | null;
     endsAt?: string | null;
     status?: CouponStatus;
     usageLimit?: number | null;
     usageLimitPerCustomer?: number | null;
-    minimumOrderAmount?: number | null;
-    maximumDiscount?: number | null;
+    /** Minimum order amount - accepts number or string */
+    minimumOrderAmount?: number | string | null;
+    /** Maximum discount amount - accepts number or string */
+    maximumDiscount?: number | string | null;
     conditions?: Record<string, unknown> | null;
     applicableProducts?: string[] | null;
     excludedProducts?: string[] | null;
@@ -767,6 +874,11 @@ interface UpdateCouponDto {
     excludedCategories?: string[] | null;
     combinesWithOther?: boolean;
     freeShipping?: boolean;
+    combinesWithOrderDiscounts?: boolean | null;
+    combinesWithProductDiscounts?: boolean | null;
+    combinesWithShippingDiscounts?: boolean | null;
+    customerRestrictions?: CustomerRestrictionsDto | null;
+    minimumQuantity?: number | null;
 }
 /**
  * Validation warning returned when syncing coupons to platforms

package/dist/index.d.ts

@@ -113,17 +113,27 @@ interface CustomerProfile {
     updatedAt: string;
 }
 interface ProductMetafield {
+    id?: string;
+    definitionId?: string;
+    /** Key from definition (alias: definitionKey) */
     key: string;
+    /** Alias for key from backend */
+    definitionKey?: string;
     value: string;
+    /** Display name (maps to definitionName in backend) */
     name?: string;
+    /** Alias for name from backend */
+    definitionName?: string;
     type?: string;
+    /** Variant ID if this metafield is variant-specific */
+    variantId?: string | null;
 }
 interface Product {
     id: string;
     name: string;
     slug?: string | null;
     description?: string | null;
-    descriptionFormat?: 'text' | 'html' | 'markdown';
+    descriptionFormat?: 'text' | 'html' | 'markdown' | null;
     sku: string;
     /** Base price as string (e.g., "29.99"). Use parseFloat() for calculations. */
     basePrice: string;
@@ -131,16 +141,57 @@ interface Product {
     salePrice?: string | null;
     /** Cost price as string. Use parseFloat() for calculations. */
     costPrice?: string | null;
-    status: 'active' | 'draft' | 'archived';
+    status?: string | null;
     type: 'SIMPLE' | 'VARIABLE';
     isDownloadable?: boolean;
     images?: ProductImage[];
     inventory?: InventoryInfo | null;
     variants?: ProductVariant[];
-    categories?: string[];
+    /** Categories as objects with id and name */
+    categories?: Array<{
+        id: string;
+        name: string;
+    }>;
+    /** Brands as objects with id and name */
+    brands?: Array<{
+        id: string;
+        name: string;
+    }>;
     tags?: string[];
     metafields?: ProductMetafield[];
     channels?: Record<string, Record<string, unknown>>;
+    /** Shopify product ID (admin mode only) */
+    shopifyProductId?: string | null;
+    /** Whether product needs sync to platforms (admin mode only) */
+    needsSync?: boolean;
+    /** Last sync timestamp (admin mode only) */
+    lastSyncedAt?: string | null;
+    /** Menu/display order */
+    menuOrder?: number | null;
+    /** Full attribute options for variant selection (admin mode only) */
+    productAttributeOptions?: Array<{
+        id: string;
+        attributeId: string;
+        attributeOptionId: string;
+        platform: string;
+        attribute: {
+            id: string;
+            name: string;
+        } | null;
+        attributeOption: {
+            id: string;
+            name: string;
+            value?: string | null;
+        } | null;
+    }>;
+    /** Vibe-coded sites this product is published to (admin mode only) */
+    vibeCodedPublishes?: Array<{
+        connection: {
+            id: string;
+            name: string;
+            connectionId: string;
+        };
+    }>;
     createdAt: string;
     updatedAt: string;
 }
@@ -153,6 +204,8 @@ interface ProductImage {
 }
 interface ProductVariant {
     id: string;
+    /** Parent product ID */
+    productId: string;
     sku?: string | null;
     name?: string | null;
     /** Variant price as string. Use parseFloat() for calculations. */
@@ -160,16 +213,16 @@ interface ProductVariant {
     /** Variant sale price as string. Use parseFloat() for calculations. */
     salePrice?: string | null;
     /** Variant attributes (e.g., { "Color": "Red", "Size": "M" }) */
-    attributes?: Record<string, unknown>;
+    attributes?: Record<string, unknown> | null;
     inventory?: InventoryInfo | null;
     /** Variant image URL or image object */
-    image?: string | {
-        url: string;
-    } | null;
+    image?: unknown | null;
     /** Display position/order for sorting variants */
-    position?: number;
+    position: number;
     /** Variant status */
-    status?: 'active' | 'draft' | 'archived';
+    status?: string | null;
+    createdAt: string;
+    updatedAt: string;
 }
 /**
  * Inventory tracking mode determines how stock is managed:
@@ -180,24 +233,32 @@ interface ProductVariant {
 type InventoryTrackingMode = 'TRACKED' | 'UNLIMITED' | 'DISABLED';
 interface InventoryInfo {
     total: number;
-    reserved?: number;
+    reserved: number;
     available: number;
     /**
      * Inventory tracking mode
      * - 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
@@ -664,6 +725,23 @@ interface SyncJob {
     message?: string;
 }
 type ConnectorPlatform = 'SHOPIFY' | 'TIKTOK' | 'META' | 'WOOCOMMERCE' | 'CUSTOM';
+/**
+ * Reference to an entity with ID and name.
+ * Used for products, categories, and other related entities.
+ */
+interface EntityRef {
+    id: string;
+    name: string;
+}
+/**
+ * Customer targeting restrictions for coupons.
+ */
+interface CustomerRestrictionsDto {
+    type: 'all' | 'emails' | 'customers' | 'segments';
+    emails?: string[];
+    customerIds?: string[];
+    segmentIds?: string[];
+}
 type CouponType = 'PERCENTAGE' | 'FIXED_AMOUNT' | 'FREE_SHIPPING' | 'BUY_X_GET_Y';
 type CouponStatus = 'ACTIVE' | 'SCHEDULED' | 'EXPIRED' | 'DISABLED';
 interface Coupon {
@@ -672,38 +750,56 @@ interface Coupon {
     title?: string | null;
     description?: string | null;
     type: CouponType;
-    value: number;
+    /** Coupon value as string (Decimal). Use parseFloat() for calculations. */
+    value: string;
     startsAt?: string | null;
     endsAt?: string | null;
     status: CouponStatus;
     usageLimit?: number | null;
     usageLimitPerCustomer?: number | null;
     usageCount: number;
-    minimumOrderAmount?: number | null;
-    maximumDiscount?: number | null;
+    /** Minimum order amount as string (Decimal). Use parseFloat() for calculations. */
+    minimumOrderAmount?: string | null;
+    /** Maximum discount amount as string (Decimal). Use parseFloat() for calculations. */
+    maximumDiscount?: string | null;
     conditions?: Record<string, unknown> | null;
     /**
-     * Product IDs this coupon applies to.
+     * Products this coupon applies to.
      * If set, coupon only applies to these specific products.
+     * Returns objects with id and name from backend.
      */
-    applicableProducts?: string[] | null;
+    applicableProducts?: EntityRef[] | null;
     /**
-     * Product IDs excluded from this coupon.
+     * Products excluded from this coupon.
      * These products will not receive the discount even if in applicable categories.
+     * Returns objects with id and name from backend.
      */
-    excludedProducts?: string[] | null;
+    excludedProducts?: EntityRef[] | null;
     /**
-     * Category IDs this coupon applies to.
+     * Categories this coupon applies to.
      * If set, coupon only applies to products in these categories.
+     * Returns objects with id and name from backend.
      */
-    applicableCategories?: string[] | null;
+    applicableCategories?: EntityRef[] | null;
     /**
-     * Category IDs excluded from this coupon.
+     * Categories excluded from this coupon.
      * Products in these categories will not receive the discount.
+     * Returns objects with id and name from backend.
      */
-    excludedCategories?: string[] | null;
+    excludedCategories?: EntityRef[] | null;
     combinesWithOther: boolean;
     freeShipping: boolean;
+    combinesWithOrderDiscounts?: boolean | null;
+    combinesWithProductDiscounts?: boolean | null;
+    combinesWithShippingDiscounts?: boolean | null;
+    customerRestrictions?: CustomerRestrictionsDto | null;
+    minimumQuantity?: number | null;
+    /** Whether coupon needs sync to platforms */
+    needsSync?: boolean;
+    /** Last sync timestamp */
+    lastSyncedAt?: string | null;
+    /** Per-platform channel overrides */
+    channels?: Record<string, Record<string, unknown>> | null;
     shopifyCouponId?: string | null;
     woocommerceCouponId?: string | null;
     tiktokCouponId?: string | null;
@@ -725,14 +821,17 @@ interface CreateCouponDto {
     title?: string;
     description?: string;
     type: CouponType;
-    value: number;
+    /** Coupon value - accepts number or string (will be converted to Decimal) */
+    value: number | string;
     startsAt?: string;
     endsAt?: string;
     status?: CouponStatus;
     usageLimit?: number;
     usageLimitPerCustomer?: number;
-    minimumOrderAmount?: number;
-    maximumDiscount?: number;
+    /** Minimum order amount - accepts number or string */
+    minimumOrderAmount?: number | string;
+    /** Maximum discount amount - accepts number or string */
+    maximumDiscount?: number | string;
     conditions?: Record<string, unknown>;
     /** Product IDs this coupon applies to */
     applicableProducts?: string[];
@@ -744,6 +843,11 @@ interface CreateCouponDto {
     excludedCategories?: string[];
     combinesWithOther?: boolean;
     freeShipping?: boolean;
+    combinesWithOrderDiscounts?: boolean;
+    combinesWithProductDiscounts?: boolean;
+    combinesWithShippingDiscounts?: boolean;
+    customerRestrictions?: CustomerRestrictionsDto;
+    minimumQuantity?: number;
     /** Platforms to publish this coupon to */
     platforms?: ConnectorPlatform[];
 }
@@ -752,14 +856,17 @@ interface UpdateCouponDto {
     title?: string;
     description?: string;
     type?: CouponType;
-    value?: number;
+    /** Coupon value - accepts number or string (will be converted to Decimal) */
+    value?: number | string;
     startsAt?: string | null;
     endsAt?: string | null;
     status?: CouponStatus;
     usageLimit?: number | null;
     usageLimitPerCustomer?: number | null;
-    minimumOrderAmount?: number | null;
-    maximumDiscount?: number | null;
+    /** Minimum order amount - accepts number or string */
+    minimumOrderAmount?: number | string | null;
+    /** Maximum discount amount - accepts number or string */
+    maximumDiscount?: number | string | null;
     conditions?: Record<string, unknown> | null;
     applicableProducts?: string[] | null;
     excludedProducts?: string[] | null;
@@ -767,6 +874,11 @@ interface UpdateCouponDto {
     excludedCategories?: string[] | null;
     combinesWithOther?: boolean;
     freeShipping?: boolean;
+    combinesWithOrderDiscounts?: boolean | null;
+    combinesWithProductDiscounts?: boolean | null;
+    combinesWithShippingDiscounts?: boolean | null;
+    customerRestrictions?: CustomerRestrictionsDto | null;
+    minimumQuantity?: number | null;
 }
 /**
  * Validation warning returned when syncing coupons to platforms

package/dist/index.js

@@ -3606,19 +3606,24 @@ function getVariantOptions(variant) {
   return Object.entries(variant.attributes).filter(([, value]) => typeof value === "string").map(([name, value]) => ({ name, value }));
 }
 function isCouponApplicableToProduct(coupon, productId, productCategoryIds) {
-  if (coupon.excludedProducts?.includes(productId)) {
+  const getIds = (refs) => refs?.map((ref) => ref.id) ?? [];
+  const excludedProductIds = getIds(coupon.excludedProducts);
+  const excludedCategoryIds = getIds(coupon.excludedCategories);
+  const applicableProductIds = getIds(coupon.applicableProducts);
+  const applicableCategoryIds = getIds(coupon.applicableCategories);
+  if (excludedProductIds.includes(productId)) {
     return false;
   }
-  if (coupon.excludedCategories?.some((cat) => productCategoryIds.includes(cat))) {
+  if (excludedCategoryIds.some((catId) => productCategoryIds.includes(catId))) {
     return false;
   }
-  if (coupon.applicableProducts && coupon.applicableProducts.length > 0) {
-    if (!coupon.applicableProducts.includes(productId)) {
+  if (applicableProductIds.length > 0) {
+    if (!applicableProductIds.includes(productId)) {
       return false;
     }
   }
-  if (coupon.applicableCategories && coupon.applicableCategories.length > 0) {
-    if (!coupon.applicableCategories.some((cat) => productCategoryIds.includes(cat))) {
+  if (applicableCategoryIds.length > 0) {
+    if (!applicableCategoryIds.some((catId) => productCategoryIds.includes(catId))) {
       return false;
     }
   }

package/dist/index.mjs

@@ -3569,19 +3569,24 @@ function getVariantOptions(variant) {
   return Object.entries(variant.attributes).filter(([, value]) => typeof value === "string").map(([name, value]) => ({ name, value }));
 }
 function isCouponApplicableToProduct(coupon, productId, productCategoryIds) {
-  if (coupon.excludedProducts?.includes(productId)) {
+  const getIds = (refs) => refs?.map((ref) => ref.id) ?? [];
+  const excludedProductIds = getIds(coupon.excludedProducts);
+  const excludedCategoryIds = getIds(coupon.excludedCategories);
+  const applicableProductIds = getIds(coupon.applicableProducts);
+  const applicableCategoryIds = getIds(coupon.applicableCategories);
+  if (excludedProductIds.includes(productId)) {
     return false;
   }
-  if (coupon.excludedCategories?.some((cat) => productCategoryIds.includes(cat))) {
+  if (excludedCategoryIds.some((catId) => productCategoryIds.includes(catId))) {
     return false;
   }
-  if (coupon.applicableProducts && coupon.applicableProducts.length > 0) {
-    if (!coupon.applicableProducts.includes(productId)) {
+  if (applicableProductIds.length > 0) {
+    if (!applicableProductIds.includes(productId)) {
       return false;
     }
   }
-  if (coupon.applicableCategories && coupon.applicableCategories.length > 0) {
-    if (!coupon.applicableCategories.some((cat) => productCategoryIds.includes(cat))) {
+  if (applicableCategoryIds.length > 0) {
+    if (!applicableCategoryIds.some((catId) => productCategoryIds.includes(catId))) {
       return false;
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.17.4",
+  "version": "0.18.0",
   "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,6 +16,14 @@
     "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",
@@ -64,12 +72,5 @@
     "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"
   }
-}
+}