@zoxllc/shopify-checkout-extensions 0.0.8 → 0.2.0

package/dist/lineItem/FixedItemDiscount.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixedItemDiscount = void 0;
+class FixedItemDiscount {
+    amount;
+    appliesToEachItem;
+    message;
+    constructor(amount, appliesToEachItem, message) {
+        this.amount = amount;
+        this.appliesToEachItem = appliesToEachItem;
+        this.message = message;
+    }
+    apply(items) {
+        const targets = items.map(({ lineItem, maxDiscounts }) => {
+            const variant = lineItem.merchandise;
+            return {
+                productVariant: {
+                    id: variant.id,
+                    quantity: maxDiscounts == 0 ? undefined : maxDiscounts,
+                },
+            };
+        });
+        return {
+            targets,
+            value: {
+                fixedAmount: {
+                    amount: this.amount,
+                    appliesToEachItem: this.appliesToEachItem,
+                },
+            },
+            message: this.message,
+        };
+    }
+}
+exports.FixedItemDiscount = FixedItemDiscount;

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/dist/lineItem/PercentageDiscount.d.ts

@@ -0,0 +1,8 @@
+import type { Discount, ApplyDiscount, DiscountInterface } from '../common/DiscountInterface';
+export declare class PercentageDiscount implements DiscountInterface {
+    discount: number;
+    message?: string;
+    constructor(percentage: number, message?: string);
+    apply(items: ApplyDiscount[]): Discount;
+}
+//# sourceMappingURL=PercentageDiscount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PercentageDiscount.d.ts","sourceRoot":"","sources":["../../src/lineItem/PercentageDiscount.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAErC,qBAAa,kBACX,YAAW,iBAAiB;IAE5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;gBAEL,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAKhD,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,QAAQ;CAyBxC"}

package/dist/lineItem/PercentageDiscount.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PercentageDiscount = void 0;
+class PercentageDiscount {
+    discount;
+    message;
+    constructor(percentage, message) {
+        this.discount = percentage;
+        this.message = message;
+    }
+    apply(items) {
+        const targets = items.map(({ lineItem, maxDiscounts }) => {
+            const variant = lineItem.merchandise;
+            return {
+                productVariant: {
+                    id: variant.id,
+                    quantity: maxDiscounts == 0 ? undefined : maxDiscounts,
+                },
+            };
+        });
+        return {
+            targets,
+            value: {
+                percentage: {
+                    value: this.discount,
+                },
+            },
+            message: this.message,
+        };
+    }
+}
+exports.PercentageDiscount = PercentageDiscount;