@zoxllc/shopify-checkout-extensions 0.1.0 → 0.2.1

package/EXAMPLES.md

@@ -360,6 +360,159 @@ export function run(input) {
 
 ---
 
+## Example 11: Multi-Tier Gift with Purchase (Cumulative)
+
+**Use Case:** Offer cumulative tiered gifts based on cart spend threshold. All qualifying tiers are applied (stackTiers: true).
+
+```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"],
+    true
+  ]
+}
+```
+
+**How It Works (stackTiers: true):**
+- Customer adds items to cart totaling $150
+- Cart subtotal is calculated (excluding items tagged "meta-exclude-gift")
+- All qualifying tiers are found:
+  - $75 tier qualifies ($150 >= $75)
+  - $100 tier qualifies ($150 >= $100)
+  - $250 tier doesn't qualify ($150 < $250)
+- Products get 100% discount:
+  - "6638547533896" (Colorwheel F&F) - from $75 tier
+  - "6640591011912" (Goldie Mystery ZOX) - from $100 tier
+- Customer receives BOTH gifts (cumulative/stacking)
+
+---
+
+## Example 12: Multi-Tier Bundle Upgrade (Highest Only)
+
+**Use Case:** Offer tiered bundle upgrades where higher spend gets a better bundle product. Only the highest qualifying tier is applied (stackTiers: false).
+
+```json
+{
+  "__type": "MultiTierDiscount",
+  "label": "Spring Bundle Upgrade",
+  "active": true,
+  "description": "Spend more, get a better bundle!",
+  "inputs": [
+    ":all",
+    [],
+    [
+      {
+        "threshold": 75,
+        "discount": {
+          "__type": "PercentageDiscount",
+          "inputs": [100, "Free Starter Bundle"]
+        },
+        "productIds": ["1111111111111"],
+        "itemsToDiscount": 1,
+        "label": "Free Starter Bundle"
+      },
+      {
+        "threshold": 150,
+        "discount": {
+          "__type": "PercentageDiscount",
+          "inputs": [100, "Free Premium Bundle"]
+        },
+        "productIds": ["2222222222222"],
+        "itemsToDiscount": 1,
+        "label": "Free Premium Bundle"
+      },
+      {
+        "threshold": 300,
+        "discount": {
+          "__type": "PercentageDiscount",
+          "inputs": [100, "Free Deluxe Bundle"]
+        },
+        "productIds": ["3333333333333"],
+        "itemsToDiscount": 1,
+        "label": "Free Deluxe Bundle"
+      }
+    ],
+    ["meta-exclude-gift"],
+    false
+  ]
+}
+```
+
+**How It Works (stackTiers: false):**
+- Customer adds items to cart totaling $200
+- Cart subtotal is calculated (excluding items tagged "meta-exclude-gift")
+- Highest qualifying tier is selected:
+  - $75 tier qualifies ($200 >= $75)
+  - $150 tier qualifies ($200 >= $150) ✓ HIGHEST
+  - $300 tier doesn't qualify ($200 < $300)
+- Only the Premium Bundle gets 100% discount:
+  - "2222222222222" (Premium Bundle) - from $150 tier
+- Customer receives ONLY the Premium Bundle (not the Starter Bundle)
+
+---
+
+**Key Features:**
+- Automatically excludes gift items from threshold calculation
+- **stackTiers: true** - Applies ALL qualifying tiers (cumulative)
+- **stackTiers: false** - Applies ONLY the highest qualifying tier
+- 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"]`)
+5. **Stack Tiers** - Boolean (default: `true`)
+   - `true` - Apply all qualifying tiers (cumulative GWP)
+   - `false` - Apply only highest tier (bundle upgrades)
+
+---
+
 ## 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;CA0Hd"}

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], args[4]);
             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,51 @@
+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
+ * discounts based on the stackTiers configuration:
+ *
+ * - stackTiers: true (default) - Applies ALL qualifying tiers (cumulative)
+ *   Example: Spend $150 → Get products from both $75 and $100 tiers
+ *
+ * - stackTiers: false - Applies ONLY the highest qualifying tier
+ *   Example: Spend $150 → Get product from $100 tier only
+ *
+ * Use cases:
+ * - Cumulative GWP: Spend more, get more gifts (stackTiers: true)
+ * - Bundle upgrades: Spend more, get better bundle (stackTiers: false)
+ */
+export declare class MultiTierDiscount extends Campaign {
+    tiers: Tier[];
+    excludeGiftTags: string[];
+    stackTiers: boolean;
+    constructor(behavior: QualifierBehavior, qualifiers: [Qualifier | AndSelector | OrSelector], tiers: Tier[], excludeGiftTags?: string[], stackTiers?: boolean);
+    /**
+     * Calculate cart subtotal excluding gift items
+     */
+    private calculateCartSubtotal;
+    /**
+     * Find all qualifying tiers based on cart subtotal
+     * Returns tiers in descending order by threshold (highest first)
+     */
+    private findQualifyingTiers;
+    /**
+     * 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;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,UAAU,EAAE,OAAO,CAAC;gBAGlB,QAAQ,EAAE,iBAAiB,EAC3B,UAAU,EAAE,CAAC,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC,EAClD,KAAK,EAAE,IAAI,EAAE,EACb,eAAe,GAAE,MAAM,EAA0B,EACjD,UAAU,GAAE,OAAc;IAU5B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+B9B,GAAG,CAAC,YAAY,EAAE,YAAY,GAAG,YAAY;CAqF9C"}

package/dist/lineItem/MultiTierDiscount.js

@@ -0,0 +1,159 @@
+"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
+ * discounts based on the stackTiers configuration:
+ *
+ * - stackTiers: true (default) - Applies ALL qualifying tiers (cumulative)
+ *   Example: Spend $150 → Get products from both $75 and $100 tiers
+ *
+ * - stackTiers: false - Applies ONLY the highest qualifying tier
+ *   Example: Spend $150 → Get product from $100 tier only
+ *
+ * Use cases:
+ * - Cumulative GWP: Spend more, get more gifts (stackTiers: true)
+ * - Bundle upgrades: Spend more, get better bundle (stackTiers: false)
+ */
+class MultiTierDiscount extends Campaign_1.Campaign {
+    tiers;
+    excludeGiftTags;
+    stackTiers;
+    constructor(behavior, qualifiers, tiers, excludeGiftTags = ['meta-exclude-gift'], stackTiers = true) {
+        super(behavior, qualifiers);
+        // Sort tiers by threshold descending (highest first)
+        this.tiers = [...tiers].sort((a, b) => b.threshold - a.threshold);
+        this.excludeGiftTags = excludeGiftTags;
+        this.stackTiers = stackTiers;
+    }
+    /**
+     * 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 all qualifying tiers based on cart subtotal
+     * Returns tiers in descending order by threshold (highest first)
+     */
+    findQualifyingTiers(cartSubtotal) {
+        return this.tiers.filter(tier => cartSubtotal >= tier.threshold);
+    }
+    /**
+     * 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 qualifying tiers based on stackTiers configuration
+        const allQualifyingTiers = this.findQualifyingTiers(cartSubtotal);
+        if (allQualifyingTiers.length === 0) {
+            // Cart doesn't meet minimum threshold
+            return discountCart;
+        }
+        // Select tiers to apply based on stackTiers configuration
+        // Note: allQualifyingTiers is sorted by threshold descending (from constructor)
+        // so allQualifyingTiers[0] is the highest qualifying tier
+        const tiersToApply = this.stackTiers
+            ? allQualifyingTiers // Apply all qualifying tiers (cumulative)
+            : [allQualifyingTiers[0]]; // Apply only highest tier
+        // Apply each selected tier
+        for (const tier of tiersToApply) {
+            // Get line items that match this tier's product criteria
+            const applicableLineItems = this.getApplicableLineItems(discountCart, tier);
+            if (applicableLineItems.length === 0) {
+                // No matching products found for this tier
+                continue;
+            }
+            // 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 = tier.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 = tier.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.1",
   "description": "Configuration-driven runtime engine for Shopify checkout extensions - campaigns, discounts, qualifiers, and selectors",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",