@parv0888/scheme-engine 0.1.0

package/dist/calculators/discount-application.d.ts

@@ -0,0 +1,44 @@
+import { SchemeCategory } from "../types/enums";
+import type { AppliedSchemeEntry, AppliedDiscountResult } from "../types/applied-scheme";
+export interface DiscountApplicationInput {
+    /** Schemes already applied/matched for this line item (typically one entry per scheme, or per batch for batch-priced companies). */
+    appliedSchemes: AppliedSchemeEntry[];
+    /** Base monetary value used as the starting point for % discount calculations (usually `unit price × billed quantity`, excluding free qty). */
+    baseValue: number;
+    /** Billed quantity for the line (saleable quantity that contributes to value/discount), excluding free qty. */
+    quantity: number;
+    /** Free quantity given via FOC/product schemes (used for some effective discount computations). */
+    freeQty: number;
+    /** Product MRP (Maximum Retail Price) used for MRP-based discount schemes. */
+    mrp: number;
+    /** Selling price used for discount calculations (typically PTR/ex-tax unit price for this line). */
+    price: number;
+    /** Whether we’re computing primary or secondary scheme discount totals. */
+    schemeCategory: SchemeCategory;
+    /** If true, successive discounts are applied on the reduced base (gross-total chaining) rather than original base value. */
+    useGrossTotalForSuccessiveDiscounts: boolean;
+    /** Company-level behavior: Product payout schemes can be treated as unitary (discount distribution instead of adding free item value). */
+    companyUsesUnitaryProductScheme?: boolean;
+    /** Company-level behavior: same SKU can be split into multiple pricing batches; discount must be computed per-batch to avoid double counting. */
+    companyUsesPricingBatchNumberInDms?: boolean;
+    /** Company-level behavior: toggles alternate bottler flows where some payout rules differ. */
+    enableBottlerCompanyFlows?: boolean;
+}
+/**
+ * Calculate the total primary or secondary discount value from applied schemes.
+ * Pure function — returns results without mutating the input.
+ *
+ * Bug 7 fix: Clamps negative discount values to 0.
+ * Bug 5 fix: Returns warning when MRP < price causes zero-out.
+ */
+export declare function calculateAppliedDiscountValues(input: DiscountApplicationInput): AppliedDiscountResult;
+interface RecalcResult {
+    discountPercent: number;
+}
+/**
+ * Recalculates perUnit discount percentage based on updated net prices.
+ * Pure function – returns new percent, caller decides where to assign.
+ */
+export declare function recalculateSchemePercentage(scheme: AppliedSchemeEntry, tempBaseValue?: number): RecalcResult;
+export {};
+//# sourceMappingURL=discount-application.d.ts.map

package/dist/calculators/discount-application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discount-application.d.ts","sourceRoot":"","sources":["../../src/calculators/discount-application.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAgD,MAAM,gBAAgB,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAyB,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAKhH,MAAM,WAAW,wBAAwB;IACvC,oIAAoI;IACpI,cAAc,EAAE,kBAAkB,EAAE,CAAC;IAErC,+IAA+I;IAC/I,SAAS,EAAE,MAAM,CAAC;IAElB,+GAA+G;IAC/G,QAAQ,EAAE,MAAM,CAAC;IAEjB,mGAAmG;IACnG,OAAO,EAAE,MAAM,CAAC;IAEhB,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;IAEZ,oGAAoG;IACpG,KAAK,EAAE,MAAM,CAAC;IAEd,2EAA2E;IAC3E,cAAc,EAAE,cAAc,CAAC;IAE/B,4HAA4H;IAC5H,mCAAmC,EAAE,OAAO,CAAC;IAE7C,0IAA0I;IAC1I,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAE1C,iJAAiJ;IACjJ,kCAAkC,CAAC,EAAE,OAAO,CAAC;IAE7C,8FAA8F;IAC9F,yBAAyB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,wBAAwB,GAC9B,qBAAqB,CAkJvB;AAID,UAAU,YAAY;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,YAAY,CAmDd"}

package/dist/calculators/discount-application.js

@@ -0,0 +1,174 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateAppliedDiscountValues = calculateAppliedDiscountValues;
+exports.recalculateSchemePercentage = recalculateSchemePercentage;
+const enums_1 = require("../types/enums");
+const math_1 = require("../helpers/math");
+const payout_type_checks_1 = require("../helpers/payout-type-checks");
+/**
+ * Calculate the total primary or secondary discount value from applied schemes.
+ * Pure function — returns results without mutating the input.
+ *
+ * Bug 7 fix: Clamps negative discount values to 0.
+ * Bug 5 fix: Returns warning when MRP < price causes zero-out.
+ */
+function calculateAppliedDiscountValues(input) {
+    const { appliedSchemes, baseValue, quantity, freeQty, mrp, price, schemeCategory, useGrossTotalForSuccessiveDiscounts, companyUsesUnitaryProductScheme = false, companyUsesPricingBatchNumberInDms = false, enableBottlerCompanyFlows = false, } = input;
+    const isPrimary = schemeCategory === enums_1.SchemeCategory.PRIMARY;
+    const discountKey = isPrimary ? "primaryDiscountValue" : "secondaryDiscountValue";
+    const percentKey = isPrimary ? "primaryDiscountPercent" : "secondaryDiscountPercent";
+    let tempBaseValue = baseValue;
+    let totalDiscount = 0;
+    const warnings = [];
+    const filtered = appliedSchemes.filter((s) => s.schemeType === schemeCategory);
+    for (const scheme of filtered) {
+        // Pricing-batch companies may split the same SKU into multiple batches,
+        // each with its own discount percent. In those cases we must compute
+        // discount values on the batch quantity instead of applying each entry
+        // on the full item quantity/baseValue (which would double-count).
+        const batchQtyRaw = companyUsesPricingBatchNumberInDms
+            ? (typeof scheme.remainingQuantity === "number" ? scheme.remainingQuantity : scheme.cases)
+            : undefined;
+        const batchQty = typeof batchQtyRaw === "number" && batchQtyRaw > 0 ? batchQtyRaw : null;
+        const effectiveQty = batchQty ?? quantity;
+        const effectivePrice = typeof scheme.price === "number" && scheme.price > 0 ? scheme.price : price;
+        const effectiveBaseValue = batchQty ? effectivePrice * effectiveQty : baseValue;
+        // Recalculate PerUnit percentages if recalculation data present
+        if (scheme.recalculateSchemeData) {
+            const recalced = recalculateSchemePercentage(scheme, tempBaseValue);
+            if (isPrimary) {
+                scheme.primaryDiscountPercent = recalced.discountPercent;
+            }
+            else {
+                scheme.secondaryDiscountPercent = recalced.discountPercent;
+            }
+        }
+        const currentPercent = scheme[percentKey] || 0;
+        let currentValue = 0;
+        // Skip: FIXED_DISCOUNT already has value set
+        if (scheme.schemePayoutType === enums_1.SchemePayoutType.FIXED_DISCOUNT) {
+            currentValue = scheme[discountKey] || 0;
+        }
+        // Skip: PRODUCT + unitary scheme
+        else if (scheme.schemePayoutType === enums_1.SchemePayoutType.PRODUCT &&
+            companyUsesUnitaryProductScheme) {
+            continue;
+        }
+        // FOC-type schemes
+        else if ((0, payout_type_checks_1.isFocTypePayoutScheme)(scheme.schemePayoutType)) {
+            const totalQty = quantity + freeQty;
+            if (totalQty > 0) {
+                currentValue = (scheme.freeQty * tempBaseValue) / totalQty;
+            }
+            // Zero out for pricing batch companies
+            if ((scheme.schemePayoutType === enums_1.SchemePayoutType.PRODUCT ||
+                scheme.schemePayoutType === enums_1.SchemePayoutType.FOC ||
+                scheme.schemePayoutType === enums_1.SchemePayoutType.FOC_SLAB) &&
+                companyUsesPricingBatchNumberInDms) {
+                currentValue = 0;
+                if (isPrimary) {
+                    scheme.primaryDiscountPercent = 0;
+                }
+                else {
+                    scheme.secondaryDiscountPercent = 0;
+                }
+            }
+        }
+        // MRP percentage discount
+        else if ((0, payout_type_checks_1.isPercentDiscountOnMRPTypePayoutScheme)(scheme.schemePayoutType) &&
+            !enableBottlerCompanyFlows) {
+            const discountedPrice = mrp - (mrp * currentPercent) / 100;
+            if (discountedPrice < effectivePrice) {
+                const rawValue = effectiveBaseValue - discountedPrice * effectiveQty;
+                currentValue = (0, math_1.clampNonNegative)(Number((0, math_1.formatPrice)(rawValue)));
+            }
+            else {
+                // Bug 5: MRP discount silently zeroes out when MRP < price
+                if (isPrimary) {
+                    scheme.primaryDiscountPercent = 0;
+                }
+                else {
+                    scheme.secondaryDiscountPercent = 0;
+                }
+                warnings.push(`MRP discount zeroed out: discountedPrice (${discountedPrice}) >= price (${effectivePrice}) for scheme ${scheme.schemeId}`);
+                currentValue = 0;
+            }
+        }
+        // Markup discount
+        else if (scheme.isMarkup) {
+            currentValue = (0, math_1.calculateMarkupDiscount)(tempBaseValue, currentPercent);
+        }
+        // Default: percentage-based discount
+        else {
+            currentValue = (0, math_1.calculateDiscount)(tempBaseValue, currentPercent);
+        }
+        // Bug 7 fix: Clamp to non-negative
+        currentValue = (0, math_1.clampNonNegative)(currentValue);
+        if (isPrimary) {
+            scheme.primaryDiscountValue = currentValue;
+        }
+        else {
+            scheme.secondaryDiscountValue = currentValue;
+        }
+        totalDiscount += currentValue;
+        if (useGrossTotalForSuccessiveDiscounts) {
+            tempBaseValue -= currentValue;
+        }
+    }
+    // Calculate effective percent
+    const effectivePercent = filtered.length === 1
+        ? filtered[0][percentKey]
+        : baseValue > 0
+            ? (totalDiscount / baseValue) * 100
+            : 0;
+    return {
+        discountValue: totalDiscount,
+        discountPercent: effectivePercent || 0,
+        clampedToZero: false,
+        warnings,
+    };
+}
+/**
+ * Recalculates perUnit discount percentage based on updated net prices.
+ * Pure function – returns new percent, caller decides where to assign.
+ */
+function recalculateSchemePercentage(scheme, tempBaseValue) {
+    if (scheme.schemePayoutType !== enums_1.SchemePayoutType.PERUNIT || !scheme.recalculateSchemeData) {
+        const isPrimary = scheme.schemeType === enums_1.SchemeCategory.PRIMARY;
+        return {
+            discountPercent: isPrimary
+                ? scheme.primaryDiscountPercent
+                : scheme.secondaryDiscountPercent,
+        };
+    }
+    const data = scheme.recalculateSchemeData;
+    const { discountAmountOfPerUnit, totalTaxPercentage, usesStdUnit, usesSuperUnit, usesAdditionalUnit, compareValue, calculationOnCompleteNumber, additionalCalculationLogic, } = data;
+    // Approximate net prices proportional to tempBaseValue
+    // The caller should provide more precise values via the recalculateSchemeData
+    // For now, derive from the available data
+    const quantity = scheme.productId ? 1 : 1; // quantity is per-item
+    const netPrice = tempBaseValue ? tempBaseValue / (quantity || 1) : 0;
+    // These are rough approximations — the real recalculation happens
+    // when the caller sets up properly via RecalculateSchemeData
+    let finalNetPrice = netPrice;
+    if (usesStdUnit) {
+        // The calling code should compute actual stdUnitNetPrice * factor
+        finalNetPrice = netPrice;
+    }
+    else if (usesSuperUnit) {
+        finalNetPrice = netPrice;
+    }
+    else if (usesAdditionalUnit) {
+        finalNetPrice = netPrice;
+    }
+    const discountAmountPreTax = discountAmountOfPerUnit / (1 + totalTaxPercentage / 100);
+    let itemDiscountPercent;
+    if (additionalCalculationLogic === enums_1.AdditionalCalculationLogic.DISCOUNT_VALUE_SUBTRACTED_FROM_PRICE) {
+        itemDiscountPercent = ((discountAmountPreTax || 0) * 100) / (finalNetPrice || 1);
+    }
+    else {
+        itemDiscountPercent = ((discountAmountOfPerUnit ?? 0) / (finalNetPrice || 1)) * 100;
+    }
+    return { discountPercent: itemDiscountPercent };
+}
+//# sourceMappingURL=discount-application.js.map

package/dist/calculators/discount-application.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discount-application.js","sourceRoot":"","sources":["../../src/calculators/discount-application.ts"],"names":[],"mappings":"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"}

package/dist/calculators/index.d.ts

@@ -0,0 +1,65 @@
+import type { Scheme } from "../types/scheme";
+import type { SchemeSlabResult } from "../types/applied-scheme";
+import type { QualifierItem } from "../helpers/qualifier-checks";
+import type { PerUnitPriceProps } from "../types/item-props";
+import type { BasketItem } from "./payout-types/basket";
+import type { Basket } from "../types/scheme";
+export interface CalculateSchemeSlabInput {
+    /** Full scheme configuration as received from DB/API. */
+    scheme: Scheme;
+    /** Precomputed metric used to match slabs (qty/amount/units depending on scheme.constraintType). */
+    compareValue: number;
+    /** Precomputed total amount for the qualifying set (usually sum of price×qty). */
+    totalAmount: number;
+    /** Items that are considered applicable for this scheme (after applicability filtering). */
+    applicableProducts: QualifierItem[];
+    /** Whether calculation should use MRP billing payouts (use slab.mrpPayout instead of slab.payout). */
+    isMrpBilling: boolean;
+    /** Product MRP used by PercentageDiscountOnMRP schemes. */
+    productMrp: number;
+    /** Product PTR/ex-tax unit price used by PercentageDiscountOnMRP schemes. */
+    productPtr: number;
+    /** Total tax % used to convert MRP-inclusive prices to ex-tax values when needed. */
+    totalTaxPercentage: number;
+    /** Net price inputs used by PerUnitDiscount schemes (supports std/super/additional unit calculations). */
+    perUnitPrices: PerUnitPriceProps;
+    /** Price of the free/payout product when the company distributes unitary product scheme value as discount. */
+    focProductPrice?: number;
+    /** Basket definitions (groups of product IDs) referenced by basket slabs. */
+    baskets?: Basket[];
+    /** Actual basket-selected items for this order/cart (used to qualify and apply basket schemes). */
+    selectedItems?: BasketItem[];
+    /** Company rule: treat PRODUCT payout schemes as unitary discount distribution. */
+    companyUsesUnitaryProductScheme?: boolean;
+    /** Company rule: interpret step FOC logic in DMS-specific way. */
+    companyUsesStepfocSchemeInDms?: boolean;
+    /** Feature toggle: enable alternate continuous scheme logic for some FOC flows. */
+    applyContinuousSchemeLogic?: boolean;
+    /** Feature toggle: enable step-multiplier scheme logic for some FOC flows. */
+    applyStepMultiplierSchemeLogic?: boolean;
+    /** Buyer type flag used by some company flows (retailer vs other). */
+    isBuyerRetailer?: boolean;
+}
+/**
+ * Master dispatcher: routes to the correct payout-type calculator.
+ *
+ * This is the primary public API for scheme calculation. Given a scheme
+ * and pre-computed aggregates, it returns a pure SchemeSlabResult that
+ * the caller can use to update item state.
+ */
+export declare function calculateSchemeSlabResult(input: CalculateSchemeSlabInput): SchemeSlabResult;
+export { calculateDiscountPayout } from "./payout-types/discount";
+export { calculateMrpPercentageDiscountPayout } from "./payout-types/mrp-percentage";
+export { calculatePerUnitPayout } from "./payout-types/per-unit";
+export { calculateFixedDiscountPayout } from "./payout-types/fixed-discount";
+export { calculateFocPayout } from "./payout-types/foc";
+export { calculateProductPayout } from "./payout-types/product";
+export { calculateProductSchemeNewPayout } from "./payout-types/product-new";
+export { calculateBasketPayout } from "./payout-types/basket";
+export { calculateCouponPayout } from "./payout-types/coupon";
+export { calculateTopupPayout } from "./payout-types/topup";
+export { calculateArticlePayout } from "./payout-types/article";
+export { calculateNlpPayout } from "./payout-types/nlp";
+export { findMatchingSlab, findInterpolationSlabs } from "./slab-matcher";
+export { calculateAppliedDiscountValues, recalculateSchemePercentage } from "./discount-application";
+//# sourceMappingURL=index.d.ts.map

package/dist/calculators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/calculators/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAgB9C,MAAM,WAAW,wBAAwB;IACvC,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,oGAAoG;IACpG,YAAY,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,kBAAkB,EAAE,aAAa,EAAE,CAAC;IACpC,sGAAsG;IACtG,YAAY,EAAE,OAAO,CAAC;IAGtB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,kBAAkB,EAAE,MAAM,CAAC;IAG3B,0GAA0G;IAC1G,aAAa,EAAE,iBAAiB,CAAC;IAGjC,8GAA8G;IAC9G,eAAe,CAAC,EAAE,MAAM,CAAC;IAGzB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mGAAmG;IACnG,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAG7B,mFAAmF;IACnF,+BAA+B,CAAC,EAAE,OAAO,CAAC;IAC1C,kEAAkE;IAClE,6BAA6B,CAAC,EAAE,OAAO,CAAC;IACxC,mFAAmF;IACnF,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC,8EAA8E;IAC9E,8BAA8B,CAAC,EAAE,OAAO,CAAC;IACzC,sEAAsE;IACtE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AA8BD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,wBAAwB,GAAG,gBAAgB,CAmI3F;AAGD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,OAAO,EAAE,8BAA8B,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/calculators/index.js

@@ -0,0 +1,196 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recalculateSchemePercentage = exports.calculateAppliedDiscountValues = exports.findInterpolationSlabs = exports.findMatchingSlab = exports.calculateNlpPayout = exports.calculateArticlePayout = exports.calculateTopupPayout = exports.calculateCouponPayout = exports.calculateBasketPayout = exports.calculateProductSchemeNewPayout = exports.calculateProductPayout = exports.calculateFocPayout = exports.calculateFixedDiscountPayout = exports.calculatePerUnitPayout = exports.calculateMrpPercentageDiscountPayout = exports.calculateDiscountPayout = void 0;
+exports.calculateSchemeSlabResult = calculateSchemeSlabResult;
+const enums_1 = require("../types/enums");
+const applied_scheme_1 = require("../types/applied-scheme");
+const discount_1 = require("./payout-types/discount");
+const mrp_percentage_1 = require("./payout-types/mrp-percentage");
+const per_unit_1 = require("./payout-types/per-unit");
+const fixed_discount_1 = require("./payout-types/fixed-discount");
+const foc_1 = require("./payout-types/foc");
+const product_1 = require("./payout-types/product");
+const product_new_1 = require("./payout-types/product-new");
+const basket_1 = require("./payout-types/basket");
+const coupon_1 = require("./payout-types/coupon");
+const topup_1 = require("./payout-types/topup");
+const article_1 = require("./payout-types/article");
+const nlp_1 = require("./payout-types/nlp");
+/**
+ * Detects if a scheme is a GST Claim scheme based on naming conventions.
+ */
+function isGstClaimScheme(scheme) {
+    const GSTSchemeName = "GST Claim";
+    const hasGstBase = scheme.name.toLowerCase().trim() === GSTSchemeName.toLowerCase().trim() &&
+        (scheme.schemeSubType2 || "").toLowerCase().trim() ===
+            enums_1.SchemeSubType2.NON_CLAIMABLE.toLowerCase().trim() &&
+        scheme.payoutCalculationType.toLowerCase().trim() ===
+            enums_1.SchemePayoutCalculationType.CONTINUOUS &&
+        scheme.payoutType.toLowerCase().trim() ===
+            enums_1.SchemePayoutType.DISCOUNT.toLowerCase().trim();
+    const isPrimaryGstScheme = scheme.category === "Primary" &&
+        scheme.schemeSubType.toLowerCase().trim() ===
+            enums_1.SchemeSubType.NON_EXTENDABLE.toLowerCase().trim();
+    const isSecondaryGstScheme = scheme.category === "Secondary" &&
+        scheme.schemeSubType.toLowerCase().trim() ===
+            enums_1.SchemeSubType.EXTENDABLE.toLowerCase().trim();
+    return hasGstBase && (isPrimaryGstScheme || isSecondaryGstScheme);
+}
+/**
+ * Master dispatcher: routes to the correct payout-type calculator.
+ *
+ * This is the primary public API for scheme calculation. Given a scheme
+ * and pre-computed aggregates, it returns a pure SchemeSlabResult that
+ * the caller can use to update item state.
+ */
+function calculateSchemeSlabResult(input) {
+    const { scheme } = input;
+    const payoutType = scheme.payoutType;
+    switch (payoutType) {
+        case enums_1.SchemePayoutType.DISCOUNT:
+            return (0, discount_1.calculateDiscountPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                isGstClaimScheme: isGstClaimScheme(scheme),
+            });
+        case enums_1.SchemePayoutType.PERCENTAGE_DISCOUNT_ON_MRP:
+            return (0, mrp_percentage_1.calculateMrpPercentageDiscountPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                productMrp: input.productMrp,
+                productPtr: input.productPtr,
+                totalTaxPercentage: input.totalTaxPercentage,
+            });
+        case enums_1.SchemePayoutType.PERUNIT:
+            return (0, per_unit_1.calculatePerUnitPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                totalTaxPercentage: input.totalTaxPercentage,
+                perUnitPrices: input.perUnitPrices,
+            });
+        case enums_1.SchemePayoutType.FIXED_DISCOUNT:
+            return (0, fixed_discount_1.calculateFixedDiscountPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                totalAmount: input.totalAmount,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                itemBaseValues: [],
+            });
+        case enums_1.SchemePayoutType.FOC:
+        case enums_1.SchemePayoutType.FOC_SLAB:
+            return (0, foc_1.calculateFocPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                companyUsesStepfocSchemeInDms: input.companyUsesStepfocSchemeInDms,
+                applyContinuousSchemeLogic: input.applyContinuousSchemeLogic,
+                applyStepMultiplierSchemeLogic: input.applyStepMultiplierSchemeLogic,
+            });
+        case enums_1.SchemePayoutType.PRODUCT:
+            return (0, product_1.calculateProductPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                totalAmount: input.totalAmount,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                focProductPrice: input.focProductPrice,
+                companyUsesUnitaryProductScheme: input.companyUsesUnitaryProductScheme,
+            });
+        case enums_1.SchemePayoutType.PRODUCT_SCHEME_NEW:
+            return (0, product_new_1.calculateProductSchemeNewPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                totalAmount: input.totalAmount,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                focProductPrice: input.focProductPrice,
+                companyUsesUnitaryProductScheme: input.companyUsesUnitaryProductScheme,
+            });
+        case enums_1.SchemePayoutType.BASKET:
+            return (0, basket_1.calculateBasketPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                applicableProducts: input.applicableProducts,
+                baskets: input.baskets || [],
+                selectedItems: input.selectedItems || [],
+                isMrpBilling: input.isMrpBilling,
+            });
+        case enums_1.SchemePayoutType.COUPON:
+            return (0, coupon_1.calculateCouponPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                totalAmount: input.totalAmount,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+            });
+        case enums_1.SchemePayoutType.TOPUP:
+            return (0, topup_1.calculateTopupPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+            });
+        case enums_1.SchemePayoutType.ARTICLE:
+            return (0, article_1.calculateArticlePayout)({
+                scheme,
+                compareValue: input.compareValue,
+                totalAmount: input.totalAmount,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+            });
+        case enums_1.SchemePayoutType.NLP:
+            return (0, nlp_1.calculateNlpPayout)({
+                scheme,
+                compareValue: input.compareValue,
+                totalAmount: input.totalAmount,
+                applicableProducts: input.applicableProducts,
+                isMrpBilling: input.isMrpBilling,
+                productPtr: input.productPtr,
+            });
+        default: {
+            const result = (0, applied_scheme_1.createEmptySlabResult)(payoutType);
+            result.warnings.push(`Payout type not matching: ${payoutType}`);
+            return result;
+        }
+    }
+}
+// ─── Re-exports ─────────────────────────────────────────────────
+var discount_2 = require("./payout-types/discount");
+Object.defineProperty(exports, "calculateDiscountPayout", { enumerable: true, get: function () { return discount_2.calculateDiscountPayout; } });
+var mrp_percentage_2 = require("./payout-types/mrp-percentage");
+Object.defineProperty(exports, "calculateMrpPercentageDiscountPayout", { enumerable: true, get: function () { return mrp_percentage_2.calculateMrpPercentageDiscountPayout; } });
+var per_unit_2 = require("./payout-types/per-unit");
+Object.defineProperty(exports, "calculatePerUnitPayout", { enumerable: true, get: function () { return per_unit_2.calculatePerUnitPayout; } });
+var fixed_discount_2 = require("./payout-types/fixed-discount");
+Object.defineProperty(exports, "calculateFixedDiscountPayout", { enumerable: true, get: function () { return fixed_discount_2.calculateFixedDiscountPayout; } });
+var foc_2 = require("./payout-types/foc");
+Object.defineProperty(exports, "calculateFocPayout", { enumerable: true, get: function () { return foc_2.calculateFocPayout; } });
+var product_2 = require("./payout-types/product");
+Object.defineProperty(exports, "calculateProductPayout", { enumerable: true, get: function () { return product_2.calculateProductPayout; } });
+var product_new_2 = require("./payout-types/product-new");
+Object.defineProperty(exports, "calculateProductSchemeNewPayout", { enumerable: true, get: function () { return product_new_2.calculateProductSchemeNewPayout; } });
+var basket_2 = require("./payout-types/basket");
+Object.defineProperty(exports, "calculateBasketPayout", { enumerable: true, get: function () { return basket_2.calculateBasketPayout; } });
+var coupon_2 = require("./payout-types/coupon");
+Object.defineProperty(exports, "calculateCouponPayout", { enumerable: true, get: function () { return coupon_2.calculateCouponPayout; } });
+var topup_2 = require("./payout-types/topup");
+Object.defineProperty(exports, "calculateTopupPayout", { enumerable: true, get: function () { return topup_2.calculateTopupPayout; } });
+var article_2 = require("./payout-types/article");
+Object.defineProperty(exports, "calculateArticlePayout", { enumerable: true, get: function () { return article_2.calculateArticlePayout; } });
+var nlp_2 = require("./payout-types/nlp");
+Object.defineProperty(exports, "calculateNlpPayout", { enumerable: true, get: function () { return nlp_2.calculateNlpPayout; } });
+var slab_matcher_1 = require("./slab-matcher");
+Object.defineProperty(exports, "findMatchingSlab", { enumerable: true, get: function () { return slab_matcher_1.findMatchingSlab; } });
+Object.defineProperty(exports, "findInterpolationSlabs", { enumerable: true, get: function () { return slab_matcher_1.findInterpolationSlabs; } });
+var discount_application_1 = require("./discount-application");
+Object.defineProperty(exports, "calculateAppliedDiscountValues", { enumerable: true, get: function () { return discount_application_1.calculateAppliedDiscountValues; } });
+Object.defineProperty(exports, "recalculateSchemePercentage", { enumerable: true, get: function () { return discount_application_1.recalculateSchemePercentage; } });
+//# sourceMappingURL=index.js.map

package/dist/calculators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/calculators/index.ts"],"names":[],"mappings":"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"}

package/dist/calculators/payout-types/article.d.ts

@@ -0,0 +1,23 @@
+import type { Scheme } from "../../types/scheme";
+import type { SchemeSlabResult } from "../../types/applied-scheme";
+import type { QualifierItem } from "../../helpers/qualifier-checks";
+export interface ArticleCalculatorInput {
+    scheme: Scheme;
+    compareValue: number;
+    totalAmount: number;
+    applicableProducts: QualifierItem[];
+    isMrpBilling: boolean;
+}
+/**
+ * Article payout type.
+ *
+ * Semantics (from golden fixtures): payout is a per-unit value.
+ * - STEP: discountValue = payout × slab.constraint × floor(compareValue / slab.constraint)
+ * - CONTINUOUS: discountValue = payout × compareValue
+ *
+ * Returns discountPercent as an effective % on totalAmount so downstream logic can
+ * derive an amount consistently.
+ */
+export declare function calculateArticlePayout(): SchemeSlabResult;
+export declare function calculateArticlePayout(input: ArticleCalculatorInput): SchemeSlabResult;
+//# sourceMappingURL=article.d.ts.map

package/dist/calculators/payout-types/article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.d.ts","sourceRoot":"","sources":["../../../src/calculators/payout-types/article.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAMnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAEpE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,aAAa,EAAE,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAAC;AAC3D,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,gBAAgB,CAAC"}

package/dist/calculators/payout-types/article.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateArticlePayout = calculateArticlePayout;
+const enums_1 = require("../../types/enums");
+const applied_scheme_1 = require("../../types/applied-scheme");
+const calc_type_checks_1 = require("../../helpers/calc-type-checks");
+const constraint_checks_1 = require("../../helpers/constraint-checks");
+const slab_matcher_1 = require("../slab-matcher");
+function calculateArticlePayout(input) {
+    if (!input) {
+        const result = (0, applied_scheme_1.createEmptySlabResult)(enums_1.SchemePayoutType.ARTICLE);
+        result.warnings.push("Article payout type is not yet implemented");
+        return result;
+    }
+    const { scheme, compareValue, totalAmount, applicableProducts } = input;
+    const result = (0, applied_scheme_1.createEmptySlabResult)(enums_1.SchemePayoutType.ARTICLE);
+    if (!(0, constraint_checks_1.isValidConstraintType)(scheme.constraintType)) {
+        result.warnings.push(`Invalid constraint type: ${scheme.constraintType}`);
+        return result;
+    }
+    const slabs = [...scheme.slabs].sort((a, b) => b.constraint - a.constraint);
+    if (slabs.length === 0) {
+        result.warnings.push("Slab list is empty");
+        return result;
+    }
+    const matcherParams = {
+        slabs,
+        compareValue,
+        applicableProducts,
+        payoutType: enums_1.SchemePayoutType.ARTICLE,
+        discountOn: scheme.discountOn ?? null,
+    };
+    const payoutCalcType = scheme.payoutCalculationType;
+    if ((0, calc_type_checks_1.isPayoutCalcTypeStep)(payoutCalcType)) {
+        const match = (0, slab_matcher_1.findMatchingSlab)(matcherParams);
+        if (!match)
+            return result;
+        const { slab } = match;
+        let stepMultiplier = 0;
+        if (slab.constraint > 0) {
+            stepMultiplier = Math.floor(compareValue / slab.constraint);
+        }
+        const discountValue = slab.payout * slab.constraint * stepMultiplier;
+        let effectivePercent = 0;
+        if (totalAmount > 0) {
+            effectivePercent = (discountValue / totalAmount) * 100;
+        }
+        result.matched = true;
+        result.matchedSlabId = slab.id;
+        result.discountPercent = effectivePercent;
+        result.targetMethod = "setDiscountScheme";
+        return result;
+    }
+    if ((0, calc_type_checks_1.isPayoutCalcTypeContinuous)(payoutCalcType)) {
+        const match = (0, slab_matcher_1.findMatchingSlab)(matcherParams);
+        if (!match)
+            return result;
+        const { slab } = match;
+        const discountValue = slab.payout * compareValue;
+        let effectivePercent = 0;
+        if (totalAmount > 0) {
+            effectivePercent = (discountValue / totalAmount) * 100;
+        }
+        result.matched = true;
+        result.matchedSlabId = slab.id;
+        result.discountPercent = effectivePercent;
+        result.targetMethod = "setDiscountScheme";
+        return result;
+    }
+    result.warnings.push(`No matching calculation type found: ${payoutCalcType}`);
+    return result;
+}
+//# sourceMappingURL=article.js.map

package/dist/calculators/payout-types/article.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.js","sourceRoot":"","sources":["../../../src/calculators/payout-types/article.ts"],"names":[],"mappings":"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"}