@zoxllc/shopify-checkout-extensions 0.1.0 → 0.2.0

package/EXAMPLES.md

@@ -360,6 +360,85 @@ export function run(input) {
 
 ---
 
+## Example 11: Multi-Tier Gift with Purchase
+
+**Use Case:** Offer tiered gifts based on cart spend threshold (e.g., spend $75 get Gift A, $100 get Gift B, $250 get Gift C). Only the highest qualifying tier is applied.
+
+```json
+{
+  "__type": "MultiTierDiscount",
+  "label": "Winter 2025 Tiered GWP",
+  "active": true,
+  "description": "Spend more, get better gifts!",
+  "inputs": [
+    ":all",
+    [],
+    [
+      {
+        "threshold": 75,
+        "discount": {
+          "__type": "PercentageDiscount",
+          "inputs": [100, "Free Colorwheel F&F"]
+        },
+        "productIds": ["6638547533896"],
+        "itemsToDiscount": 1,
+        "label": "Free Colorwheel F&F"
+      },
+      {
+        "threshold": 100,
+        "discount": {
+          "__type": "PercentageDiscount",
+          "inputs": [100, "Free Goldie Mystery ZOX"]
+        },
+        "productIds": ["6640591011912"],
+        "itemsToDiscount": 1,
+        "label": "Free Goldie Mystery ZOX"
+      },
+      {
+        "threshold": 250,
+        "discount": {
+          "__type": "PercentageDiscount",
+          "inputs": [100, "Free Cosmic Drift Daily"]
+        },
+        "productIds": ["6980288053320"],
+        "itemsToDiscount": 1,
+        "label": "Free Cosmic Drift Daily"
+      }
+    ],
+    ["meta-exclude-gift"]
+  ]
+}
+```
+
+**How It Works:**
+- Customer adds items to cart totaling $150
+- Cart subtotal is calculated (excluding items tagged "meta-exclude-gift")
+- Tiers are evaluated from highest to lowest
+- $250 tier doesn't qualify ($150 < $250)
+- $100 tier DOES qualify ($150 >= $100)
+- Product "6640591011912" (Goldie Mystery ZOX) gets 100% discount
+- Lower tiers ($75) are NOT applied
+
+**Key Features:**
+- Automatically excludes gift items from threshold calculation
+- Only applies the highest qualifying tier (no stacking)
+- Supports product IDs or product tags per tier
+- Perfect for seasonal promotions with start/end dates
+
+### MultiTierDiscount Inputs Array:
+1. **QualifierBehavior** - `:all` or `:any`
+2. **Qualifiers Array** - Array of cart-level qualifiers (optional, can be empty `[]`)
+3. **Tiers Array** - Array of tier objects, each containing:
+   - `threshold` - Minimum cart amount to qualify
+   - `discount` - Discount configuration (typically 100% for free gifts)
+   - `productIds` - Array of product IDs to discount (optional)
+   - `productTags` - Array of product tags to discount (optional)
+   - `itemsToDiscount` - Maximum items to discount (optional, defaults to all)
+   - `label` - Display name for the tier (optional)
+4. **Exclude Tags** - Array of product tags to exclude from subtotal calculation (default: `["meta-exclude-gift"]`)
+
+---
+
 ## Tips for Your UI App
 
 1. **Store configurations in your database** with fields:

package/dist/common/CampaignFactory.d.ts

@@ -9,7 +9,7 @@ export type InputConfig = {
     inputs: (boolean | number | string | InputConfig | boolean[] | number[] | string[] | InputConfig[])[];
 };
 export type CampaignInputConfig = InputConfig & {
-    __type: 'BuyXGetY' | 'ConditionalDiscount' | 'ShippingDiscount';
+    __type: 'BuyXGetY' | 'ConditionalDiscount' | 'ShippingDiscount' | 'MultiTierDiscount';
     label: string;
     active: boolean;
     description?: string;

package/dist/common/CampaignFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CampaignFactory.d.ts","sourceRoot":"","sources":["../../src/common/CampaignFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAEV,SAAS,EAIV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAgC5C,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,WAAW,GACX,OAAO,EAAE,GACT,MAAM,EAAE,GACR,MAAM,EAAE,GACR,WAAW,EAAE,CAChB,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,MAAM,EAAE,UAAU,GAAG,qBAAqB,GAAG,kBAAkB,CAAC;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,qBAAa,eAAe;IAC1B,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GACI,QAAQ;IAG/D,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAuB/B,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,WAAW,GAEjB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,GACR,iBAAiB,GACjB,SAAS;CAkHd"}
+{"version":3,"file":"CampaignFactory.d.ts","sourceRoot":"","sources":["../../src/common/CampaignFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAEV,SAAS,EAIV,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAa,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAiC5C,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CACJ,OAAO,GACP,MAAM,GACN,MAAM,GACN,WAAW,GACX,OAAO,EAAE,GACT,MAAM,EAAE,GACR,MAAM,EAAE,GACR,WAAW,EAAE,CAChB,EAAE,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC9C,MAAM,EAAE,UAAU,GAAG,qBAAqB,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,qBAAa,eAAe;IAC1B,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,GACI,QAAQ;IAG/D,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAuB/B,MAAM,CAAC,kBAAkB,CACvB,MAAM,EAAE,WAAW,GAEjB,QAAQ,GACR,SAAS,GACT,WAAW,GACX,UAAU,GACV,QAAQ,GACR,iBAAiB,GACjB,SAAS;CAyHd"}

package/dist/common/CampaignFactory.js

@@ -17,6 +17,7 @@ const ConditionalDiscount_1 = require("../lineItem/ConditionalDiscount");
 const FixedItemDiscount_1 = require("../lineItem/FixedItemDiscount");
 const PercentageDiscount_1 = require("../lineItem/PercentageDiscount");
 const BuyXGetY_1 = require("../lineItem/BuyXGetY");
+const MultiTierDiscount_1 = require("../lineItem/MultiTierDiscount");
 const SubscriptionItemSelector_1 = require("./SubscriptionItemSelector");
 const CountryCodeQualifier_1 = require("./CountryCodeQualifier");
 const RateNameSelector_1 = require("../shipping/RateNameSelector");
@@ -53,6 +54,8 @@ class CampaignFactory {
                 return new BuyXGetY_1.BuyXGetY(args[0], args[1], args[2], args[3], args[4], args[5], args[6], args[7]);
             case 'ShippingDiscount':
                 return new ShippingDiscount_1.ShippingDiscount(args[0], args[1], args[2], args[3]);
+            case 'MultiTierDiscount':
+                return new MultiTierDiscount_1.MultiTierDiscount(args[0], args[1], args[2], args[3]);
             case 'AndSelector':
                 return new AndSelector_1.AndSelector([...args]);
             case 'OrSelector':

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { ConditionalDiscount } from './lineItem/ConditionalDiscount';
 export { BuyXGetY } from './lineItem/BuyXGetY';
 export { ShippingDiscount } from './shipping/ShippingDiscount';
+export { MultiTierDiscount, type Tier } from './lineItem/MultiTierDiscount';
 export { Campaign } from './common/Campaign';
 export { FixedItemDiscount } from './lineItem/FixedItemDiscount';
 export { PercentageDiscount } from './lineItem/PercentageDiscount';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,YAAY,EACZ,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,KAAK,IAAI,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EACL,eAAe,EACf,KAAK,WAAW,EAChB,KAAK,mBAAmB,GACzB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,eAAe,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,GACtB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,eAAe,EACf,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,KAAK,wBAAwB,GAC9B,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACV,YAAY,EACZ,qBAAqB,GACtB,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StringComparisonSchema = exports.NumericalComparisonSchema = exports.QualifierMatchTypeSchema = exports.MatchTypeSchema = exports.QualifierBehaviorSchema = exports.CampaignConfigSchema = exports.ConfigValidator = exports.CampaignFactory = exports.DiscountCart = exports.CountryCodeQualifier = exports.PostCartAmountQualifier = exports.CustomerTagQualifier = exports.CustomerSubscriberQualifier = exports.CustomerEmailQualifier = exports.CartQuantityQualifier = exports.CartHasItemQualifier = exports.CartAmountQualifier = exports.StringComparisonType = exports.NumericalComparisonType = exports.QualifierMatchType = exports.QualifierBehavior = exports.Qualifier = exports.RateNameSelector = exports.SubscriptionItemSelector = exports.SaleItemSelector = exports.ProductTypeSelector = exports.ProductTagSelector = exports.ProductIdSelector = exports.ProductHandleSelector = exports.Selector = exports.OrSelector = exports.AndSelector = exports.FixedDiscount = exports.PercentageDiscount = exports.FixedItemDiscount = exports.Campaign = exports.ShippingDiscount = exports.BuyXGetY = exports.ConditionalDiscount = void 0;
+exports.StringComparisonSchema = exports.NumericalComparisonSchema = exports.QualifierMatchTypeSchema = exports.MatchTypeSchema = exports.QualifierBehaviorSchema = exports.CampaignConfigSchema = exports.ConfigValidator = exports.CampaignFactory = exports.DiscountCart = exports.CountryCodeQualifier = exports.PostCartAmountQualifier = exports.CustomerTagQualifier = exports.CustomerSubscriberQualifier = exports.CustomerEmailQualifier = exports.CartQuantityQualifier = exports.CartHasItemQualifier = exports.CartAmountQualifier = exports.StringComparisonType = exports.NumericalComparisonType = exports.QualifierMatchType = exports.QualifierBehavior = exports.Qualifier = exports.RateNameSelector = exports.SubscriptionItemSelector = exports.SaleItemSelector = exports.ProductTypeSelector = exports.ProductTagSelector = exports.ProductIdSelector = exports.ProductHandleSelector = exports.Selector = exports.OrSelector = exports.AndSelector = exports.FixedDiscount = exports.PercentageDiscount = exports.FixedItemDiscount = exports.Campaign = exports.MultiTierDiscount = exports.ShippingDiscount = exports.BuyXGetY = exports.ConditionalDiscount = void 0;
 // Campaign Types
 var ConditionalDiscount_1 = require("./lineItem/ConditionalDiscount");
 Object.defineProperty(exports, "ConditionalDiscount", { enumerable: true, get: function () { return ConditionalDiscount_1.ConditionalDiscount; } });
@@ -8,6 +8,8 @@ var BuyXGetY_1 = require("./lineItem/BuyXGetY");
 Object.defineProperty(exports, "BuyXGetY", { enumerable: true, get: function () { return BuyXGetY_1.BuyXGetY; } });
 var ShippingDiscount_1 = require("./shipping/ShippingDiscount");
 Object.defineProperty(exports, "ShippingDiscount", { enumerable: true, get: function () { return ShippingDiscount_1.ShippingDiscount; } });
+var MultiTierDiscount_1 = require("./lineItem/MultiTierDiscount");
+Object.defineProperty(exports, "MultiTierDiscount", { enumerable: true, get: function () { return MultiTierDiscount_1.MultiTierDiscount; } });
 var Campaign_1 = require("./common/Campaign");
 Object.defineProperty(exports, "Campaign", { enumerable: true, get: function () { return Campaign_1.Campaign; } });
 // Discount Types

package/dist/lineItem/MultiTierDiscount.d.ts

@@ -0,0 +1,47 @@
+import { Campaign } from '../common/Campaign';
+import type { DiscountCart } from '../common/DiscountCart';
+import type { DiscountInterface } from '../common/DiscountInterface';
+import type { QualifierBehavior, Qualifier } from '../common/Qualifier';
+import type { AndSelector } from '../common/AndSelector';
+import type { OrSelector } from '../common/OrSelector';
+export interface Tier {
+    threshold: number;
+    discount: DiscountInterface;
+    productIds?: string[];
+    productTags?: string[];
+    itemsToDiscount?: number;
+    label?: string;
+}
+/**
+ * MultiTierDiscount - Applies tiered discounts based on cart subtotal
+ *
+ * This campaign evaluates the cart total (excluding gifts) and applies
+ * the discount from the highest qualifying tier.
+ *
+ * Example use case: Tiered gift with purchase
+ * - Spend $75: Get free product A
+ * - Spend $100: Get free product B
+ * - Spend $250: Get free product C
+ *
+ * Only the highest qualifying tier is applied (e.g., if cart is $150,
+ * only the $100 tier applies, not both $75 and $100).
+ */
+export declare class MultiTierDiscount extends Campaign {
+    tiers: Tier[];
+    excludeGiftTags: string[];
+    constructor(behavior: QualifierBehavior, qualifiers: [Qualifier | AndSelector | OrSelector], tiers: Tier[], excludeGiftTags?: string[]);
+    /**
+     * Calculate cart subtotal excluding gift items
+     */
+    private calculateCartSubtotal;
+    /**
+     * Find the highest qualifying tier based on cart subtotal
+     */
+    private findQualifyingTier;
+    /**
+     * Filter line items that match the tier's product criteria
+     */
+    private getApplicableLineItems;
+    run(discountCart: DiscountCart): DiscountCart;
+}
+//# sourceMappingURL=MultiTierDiscount.d.ts.map

package/dist/lineItem/MultiTierDiscount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiTierDiscount.d.ts","sourceRoot":"","sources":["../../src/lineItem/MultiTierDiscount.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,iBAAiB,EACjB,SAAS,EACV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,WAAW,IAAI;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;gBAGxB,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,CAAC,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC,EAClD,KAAK,EAAE,IAAI,EAAE,EACb,eAAe,GAAE,MAAM,EAA0B;IASnD;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+B9B,GAAG,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;CA2E9C"}

package/dist/lineItem/MultiTierDiscount.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiTierDiscount = void 0;
+const Campaign_1 = require("../common/Campaign");
+/**
+ * MultiTierDiscount - Applies tiered discounts based on cart subtotal
+ *
+ * This campaign evaluates the cart total (excluding gifts) and applies
+ * the discount from the highest qualifying tier.
+ *
+ * Example use case: Tiered gift with purchase
+ * - Spend $75: Get free product A
+ * - Spend $100: Get free product B
+ * - Spend $250: Get free product C
+ *
+ * Only the highest qualifying tier is applied (e.g., if cart is $150,
+ * only the $100 tier applies, not both $75 and $100).
+ */
+class MultiTierDiscount extends Campaign_1.Campaign {
+    tiers;
+    excludeGiftTags;
+    constructor(behavior, qualifiers, tiers, excludeGiftTags = ['meta-exclude-gift']) {
+        super(behavior, qualifiers);
+        // Sort tiers by threshold descending (highest first)
+        this.tiers = [...tiers].sort((a, b) => b.threshold - a.threshold);
+        this.excludeGiftTags = excludeGiftTags;
+    }
+    /**
+     * Calculate cart subtotal excluding gift items
+     */
+    calculateCartSubtotal(discountCart) {
+        let subtotal = 0;
+        for (const line of discountCart.cart.lines) {
+            // Check if this item should be excluded from subtotal calculation
+            let isExcludedGift = false;
+            // Type guard: Only ProductVariant has product property
+            if (line.merchandise.__typename === 'ProductVariant') {
+                const variant = line.merchandise;
+                // Check if product has any of the exclude tags
+                isExcludedGift = this.excludeGiftTags.some(tag => variant.product.hasTags.filter((t) => t.hasTag && t.tag === tag).length > 0);
+            }
+            if (isExcludedGift) {
+                continue;
+            }
+            // Add line total to subtotal
+            const lineTotal = parseFloat(String(line.cost.totalAmount.amount));
+            subtotal += lineTotal;
+        }
+        return subtotal;
+    }
+    /**
+     * Find the highest qualifying tier based on cart subtotal
+     */
+    findQualifyingTier(cartSubtotal) {
+        for (const tier of this.tiers) {
+            if (cartSubtotal >= tier.threshold) {
+                return tier;
+            }
+        }
+        return null;
+    }
+    /**
+     * Filter line items that match the tier's product criteria
+     */
+    getApplicableLineItems(discountCart, tier) {
+        return discountCart.cart.lines.filter((line) => {
+            // Type guard: Only ProductVariant has product property
+            if (line.merchandise.__typename !== 'ProductVariant') {
+                return false;
+            }
+            // If tier specifies product IDs, match against those
+            if (tier.productIds && tier.productIds.length > 0) {
+                const productId = line.merchandise.product.id.split('/').pop();
+                return tier.productIds.includes(productId || '');
+            }
+            // If tier specifies product tags, match against those
+            if (tier.productTags && tier.productTags.length > 0) {
+                const variant = line.merchandise;
+                return tier.productTags.some((tag) => variant.product.hasTags.filter((t) => t.hasTag && t.tag === tag).length > 0);
+            }
+            // If no product criteria specified, apply to all items
+            return true;
+        });
+    }
+    run(discountCart) {
+        // First check if cart qualifies for any discount
+        if (!this.qualifies(discountCart)) {
+            return discountCart;
+        }
+        // Calculate cart subtotal (excluding gifts)
+        const cartSubtotal = this.calculateCartSubtotal(discountCart);
+        // Find the highest qualifying tier
+        const qualifyingTier = this.findQualifyingTier(cartSubtotal);
+        if (!qualifyingTier) {
+            // Cart doesn't meet minimum threshold
+            return discountCart;
+        }
+        // Get line items that match this tier's product criteria
+        const applicableLineItems = this.getApplicableLineItems(discountCart, qualifyingTier);
+        if (applicableLineItems.length === 0) {
+            // No matching products found
+            return discountCart;
+        }
+        // Sort by price (ascending) to discount cheapest items first
+        applicableLineItems.sort((a, b) => {
+            const priceA = parseFloat(String(a.cost.amountPerQuantity.amount));
+            const priceB = parseFloat(String(b.cost.amountPerQuantity.amount));
+            return priceA - priceB;
+        });
+        const itemsToApplyDiscounts = [];
+        let remainingDiscounts = qualifyingTier.itemsToDiscount;
+        // Apply discount to matching items up to the limit
+        applicableLineItems.forEach((lineItem) => {
+            if (remainingDiscounts === 0)
+                return;
+            if (remainingDiscounts !== undefined) {
+                // Apply to as many items as possible up to the limit
+                if (lineItem.quantity >= remainingDiscounts) {
+                    itemsToApplyDiscounts.push({
+                        lineItem,
+                        maxDiscounts: remainingDiscounts,
+                    });
+                    remainingDiscounts = 0;
+                }
+                else {
+                    // Apply to all items in this line
+                    itemsToApplyDiscounts.push({
+                        lineItem,
+                        maxDiscounts: lineItem.quantity,
+                    });
+                    remainingDiscounts -= lineItem.quantity;
+                }
+            }
+            else {
+                // No limit, apply to all matching items
+                itemsToApplyDiscounts.push({
+                    lineItem,
+                    maxDiscounts: lineItem.quantity,
+                });
+            }
+        });
+        // Apply the tier's discount to all selected items
+        itemsToApplyDiscounts.forEach((item) => {
+            const discount = qualifyingTier.discount;
+            discount.apply([item]);
+        });
+        return discountCart;
+    }
+}
+exports.MultiTierDiscount = MultiTierDiscount;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zoxllc/shopify-checkout-extensions",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Configuration-driven runtime engine for Shopify checkout extensions - campaigns, discounts, qualifiers, and selectors",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",