ts-client-lib 0.0.7

package/finance/TSBonus.js

@@ -0,0 +1,530 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findSelectionBonuses = exports.findBestDepositBonus = exports.getEligibleBonuses = exports.checkManyBonusEligibility = exports.checkBonusEligibility = exports.BonusEligibility = exports.hasCurrencyCode = exports.assertKnownCurrenciesOnTemplate = exports.assertCoherentMoneyFields = exports.toMoneyJSON = exports.parseMoneyJSON = void 0;
+var TSMoney_1 = require("../entities/TSMoney");
+var TSCurrencies_1 = require("../entities/TSCurrencies");
+var bonus_money_1 = require("./bonus-money");
+var bonus_money_2 = require("./bonus-money");
+Object.defineProperty(exports, "parseMoneyJSON", { enumerable: true, get: function () { return bonus_money_2.parseMoneyJSON; } });
+Object.defineProperty(exports, "toMoneyJSON", { enumerable: true, get: function () { return bonus_money_2.toMoneyJSON; } });
+Object.defineProperty(exports, "assertCoherentMoneyFields", { enumerable: true, get: function () { return bonus_money_2.assertCoherentMoneyFields; } });
+Object.defineProperty(exports, "assertKnownCurrenciesOnTemplate", { enumerable: true, get: function () { return bonus_money_2.assertKnownCurrenciesOnTemplate; } });
+Object.defineProperty(exports, "hasCurrencyCode", { enumerable: true, get: function () { return bonus_money_2.hasCurrencyCode; } });
+// ═══════════════════════════════════════════════════════════════════════════
+// STATIC CLASS
+// ═══════════════════════════════════════════════════════════════════════════
+var BonusEligibility = /** @class */ (function () {
+    function BonusEligibility() {
+    }
+    /** Parse a date value that may be a Date, ISO string, or numeric timestamp string. */
+    BonusEligibility.parseDate = function (value) {
+        if (value instanceof Date)
+            return value;
+        // GraphQL String! scalar serializes Date.valueOf() → numeric timestamp string (e.g. "1770903772810")
+        if (typeof value === 'string') {
+            var num = Number(value);
+            if (!isNaN(num) && num > 1e12)
+                return new Date(num); // ms timestamp
+        }
+        if (typeof value === 'number')
+            return new Date(value);
+        return new Date(value);
+    };
+    // ─────────────────────────────────────────────────────────────────────────
+    // PUBLIC API
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Check eligibility for a single bonus template.
+     */
+    BonusEligibility.check = function (template, context) {
+        if (context === void 0) { context = {}; }
+        if (template.valueMoney || template.maxValueMoney || template.minDepositMoney) {
+            (0, bonus_money_1.assertCoherentMoneyFields)(template);
+        }
+        (0, bonus_money_1.assertKnownCurrenciesOnTemplate)(template);
+        var reasons = [];
+        for (var _i = 0, _a = this.rules; _i < _a.length; _i++) {
+            var rule = _a[_i];
+            if (!rule.check(template, context)) {
+                reasons.push(rule.message(template, context));
+            }
+        }
+        var eligible = reasons.length === 0;
+        var calculatedValue = eligible ? this.calculateValue(template, context) : undefined;
+        var calculatedValueMoney = eligible ? this.calculateValueMoney(template, context) : undefined;
+        var turnoverRequired = eligible ? this.calculateTurnover(template, context) : undefined;
+        var turnoverRequiredMoney = eligible ? this.calculateTurnoverMoney(template, context) : undefined;
+        return {
+            template: template,
+            eligible: eligible,
+            reasons: reasons,
+            calculatedValue: calculatedValue,
+            calculatedValueMoney: calculatedValueMoney,
+            turnoverRequired: turnoverRequired,
+            turnoverRequiredMoney: turnoverRequiredMoney
+        };
+    };
+    /**
+     * Check eligibility for multiple templates.
+     * Returns all results, sorted by priority (highest first).
+     */
+    BonusEligibility.checkMany = function (templates, context) {
+        var _this = this;
+        if (context === void 0) { context = {}; }
+        return templates
+            .map(function (t) { return _this.check(t, context); })
+            .sort(function (a, b) { var _a, _b; return ((_a = b.template.priority) !== null && _a !== void 0 ? _a : 0) - ((_b = a.template.priority) !== null && _b !== void 0 ? _b : 0); });
+    };
+    /**
+     * Get only eligible bonuses from a list.
+     */
+    BonusEligibility.getEligible = function (templates, context) {
+        if (context === void 0) { context = {}; }
+        return this.checkMany(templates, context).filter(function (r) { return r.eligible; });
+    };
+    /**
+     * Find the best bonus for a deposit amount.
+     */
+    BonusEligibility.findBestForDeposit = function (templates, amount, currency, context) {
+        if (context === void 0) { context = {}; }
+        var ctx = __assign(__assign({}, context), { depositAmount: amount, currency: currency });
+        var depositTypes = ['first_deposit', 'reload', 'welcome', 'top_up'];
+        var depositTemplates = templates.filter(function (t) { return depositTypes.indexOf(t.type) !== -1; });
+        var eligible = this.getEligible(depositTemplates, ctx);
+        if (eligible.length === 0)
+            return null;
+        return eligible.sort(function (a, b) { var _a, _b; return ((_a = b.calculatedValue) !== null && _a !== void 0 ? _a : 0) - ((_b = a.calculatedValue) !== null && _b !== void 0 ? _b : 0); })[0];
+    };
+    /**
+     * Find eligible selection/combo bonuses based on selection count.
+     */
+    BonusEligibility.findForSelections = function (templates, selectionCount, context) {
+        if (context === void 0) { context = {}; }
+        var ctx = __assign(__assign({}, context), { selectionCount: selectionCount });
+        var selectionTypes = ['selection', 'combo', 'bundle'];
+        var selectionTemplates = templates.filter(function (t) { return selectionTypes.indexOf(t.type) !== -1; });
+        return this.getEligible(selectionTemplates, ctx);
+    };
+    /**
+     * Check if user qualifies for any bonus of a specific type.
+     */
+    BonusEligibility.hasEligibleOfType = function (templates, type, context) {
+        var _a;
+        if (context === void 0) { context = {}; }
+        var typeTemplates = templates.filter(function (t) { return t.type === type; });
+        var eligible = this.getEligible(typeTemplates, context);
+        return (_a = eligible[0]) !== null && _a !== void 0 ? _a : null;
+    };
+    /**
+     * Group eligible bonuses by type.
+     */
+    BonusEligibility.groupByType = function (templates, context) {
+        if (context === void 0) { context = {}; }
+        var results = this.checkMany(templates, context);
+        var grouped = new Map();
+        for (var _i = 0, results_1 = results; _i < results_1.length; _i++) {
+            var result = results_1[_i];
+            var type = result.template.type;
+            if (!grouped.has(type)) {
+                grouped.set(type, []);
+            }
+            grouped.get(type).push(result);
+        }
+        return grouped;
+    };
+    // ─────────────────────────────────────────────────────────────────────────
+    // CALCULATION HELPERS
+    // ─────────────────────────────────────────────────────────────────────────
+    BonusEligibility.calculateValue = function (template, context) {
+        var _a, _b;
+        var baseAmount = (_b = (_a = context.depositAmount) !== null && _a !== void 0 ? _a : context.activityAmount) !== null && _b !== void 0 ? _b : 0;
+        switch (template.valueType) {
+            case 'fixed':
+                return template.value;
+            case 'percentage': {
+                var calculated = baseAmount * (template.value / 100);
+                return template.maxValue ? Math.min(calculated, template.maxValue) : calculated;
+            }
+            case 'tiered': {
+                var multiplier = this.getTierMultiplier(template, context);
+                return template.value * multiplier;
+            }
+            case 'dynamic': {
+                return this.calculateDynamicValue(template, context);
+            }
+            default:
+                return template.value;
+        }
+    };
+    BonusEligibility.calculateTurnover = function (template, context) {
+        var bonusValue = this.calculateValue(template, context);
+        return bonusValue * template.turnoverMultiplier;
+    };
+    /**
+     * Bonus value as **TSMoney**. `fixed` uses minor integer units; other value types use `fromDecimal`
+     * on the same numeric result as `calculateValue`.
+     */
+    BonusEligibility.calculateValueMoney = function (template, context) {
+        var code = String(template.currency);
+        (0, TSCurrencies_1.resolveCurrency)(code);
+        var raw = this.calculateValue(template, context);
+        switch (template.valueType) {
+            case 'fixed':
+                return TSMoney_1.TSMoney.fromInteger(template.value, code);
+            case 'percentage':
+            case 'tiered':
+            case 'dynamic':
+                return TSMoney_1.TSMoney.fromDecimal(raw, code);
+            default:
+                return TSMoney_1.TSMoney.fromInteger(template.value, code);
+        }
+    };
+    BonusEligibility.calculateTurnoverMoney = function (template, context) {
+        var bonus = this.calculateValueMoney(template, context);
+        return bonus.multiply(template.turnoverMultiplier);
+    };
+    BonusEligibility.getContributionRate = function (template, category) {
+        var _a;
+        if (!template.activityContributions)
+            return 100;
+        return (_a = template.activityContributions[category]) !== null && _a !== void 0 ? _a : 0;
+    };
+    BonusEligibility.calculateTurnoverContribution = function (template, amount, category) {
+        var rate = this.getContributionRate(template, category);
+        return amount * (rate / 100);
+    };
+    // ─────────────────────────────────────────────────────────────────────────
+    // PRIVATE HELPERS
+    // ─────────────────────────────────────────────────────────────────────────
+    BonusEligibility.getTierMultiplier = function (_template, context) {
+        var _a, _b, _c;
+        var tierMultipliers = {
+            'bronze': 1.0,
+            'silver': 1.25,
+            'gold': 1.5,
+            'platinum': 2.0,
+            'diamond': 2.5
+        };
+        return (_c = tierMultipliers[(_b = (_a = context.userTier) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '']) !== null && _c !== void 0 ? _c : 1.0;
+    };
+    BonusEligibility.calculateDynamicValue = function (template, context) {
+        var _a, _b;
+        if (template.type === 'combo' && context.selectionCount) {
+            var baseValue = template.value;
+            var multiplier = (_a = template.comboMultiplier) !== null && _a !== void 0 ? _a : 1.1;
+            var minActions = (_b = template.minActions) !== null && _b !== void 0 ? _b : 3;
+            var extraSelections = Math.max(0, context.selectionCount - minActions);
+            return baseValue * Math.pow(multiplier, extraSelections);
+        }
+        if (template.type === 'streak' && context.consecutiveDays) {
+            return template.value * Math.min(context.consecutiveDays, 7);
+        }
+        return template.value;
+    };
+    // ─────────────────────────────────────────────────────────────────────────
+    // CUSTOM RULE EXTENSION
+    // ─────────────────────────────────────────────────────────────────────────
+    BonusEligibility.addRule = function (rule) {
+        this.rules.push(rule);
+    };
+    BonusEligibility.removeRule = function (name) {
+        var index = this.rules.findIndex(function (r) { return r.name === name; });
+        if (index !== -1) {
+            this.rules.splice(index, 1);
+        }
+    };
+    BonusEligibility.getRuleNames = function () {
+        return this.rules.map(function (r) { return r.name; });
+    };
+    BonusEligibility.rules = [
+        // Active check
+        {
+            name: 'is_active',
+            check: function (t) { return t.isActive === true; },
+            message: function () { return 'Bonus is not active'; }
+        },
+        // Date range
+        {
+            name: 'date_range',
+            check: function (t, c) {
+                var now = c.currentDate || new Date();
+                var from = BonusEligibility.parseDate(t.validFrom);
+                var until = BonusEligibility.parseDate(t.validUntil);
+                return now >= from && now <= until;
+            },
+            message: function (t, c) {
+                var now = c.currentDate || new Date();
+                var from = BonusEligibility.parseDate(t.validFrom);
+                if (now < from)
+                    return "Bonus starts on ".concat(from.toLocaleDateString());
+                return 'Bonus has expired';
+            }
+        },
+        // Currency
+        {
+            name: 'currency',
+            check: function (t, c) {
+                var _a;
+                if (!c.currency)
+                    return true;
+                if (!((_a = t.supportedCurrencies) === null || _a === void 0 ? void 0 : _a.length))
+                    return true;
+                return t.supportedCurrencies.indexOf(c.currency) !== -1;
+            },
+            message: function (t, c) { var _a; return "Currency ".concat(c.currency, " not supported. Supported: ").concat((_a = t.supportedCurrencies) === null || _a === void 0 ? void 0 : _a.join(', ')); }
+        },
+        // Min deposit
+        {
+            name: 'min_deposit',
+            check: function (t, c) {
+                if (!t.minDeposit)
+                    return true;
+                if (!c.depositAmount)
+                    return true;
+                return c.depositAmount >= t.minDeposit;
+            },
+            message: function (t) { return "Minimum deposit of ".concat(t.minDeposit, " ").concat(t.currency, " required"); }
+        },
+        // User tier
+        {
+            name: 'tier',
+            check: function (t, c) {
+                var _a;
+                if (!((_a = t.eligibleTiers) === null || _a === void 0 ? void 0 : _a.length))
+                    return true;
+                if (!c.userTier)
+                    return false;
+                return t.eligibleTiers.indexOf(c.userTier) !== -1;
+            },
+            message: function (t) { var _a; return "Required tier: ".concat((_a = t.eligibleTiers) === null || _a === void 0 ? void 0 : _a.join(' or ')); }
+        },
+        // KYC Tier
+        {
+            name: 'kyc_tier',
+            check: function (t, c) {
+                var _a, _b;
+                if (!t.requiredKYCTier)
+                    return true;
+                if (!c.kycTier)
+                    return false;
+                // Import KYCEligibility for tier comparison would create circular dep
+                // Use simple tier level comparison
+                var tierLevels = {
+                    'none': 0, 'basic': 1, 'standard': 2,
+                    'enhanced': 3, 'full': 4, 'professional': 5
+                };
+                var required = (_a = tierLevels[t.requiredKYCTier]) !== null && _a !== void 0 ? _a : 0;
+                var current = (_b = tierLevels[c.kycTier]) !== null && _b !== void 0 ? _b : 0;
+                return current >= required;
+            },
+            message: function (t) { return "KYC tier '".concat(t.requiredKYCTier, "' or higher required"); }
+        },
+        // Country
+        {
+            name: 'country',
+            check: function (t, c) {
+                var _a, _b;
+                if (!c.country)
+                    return true;
+                if (((_a = t.excludedCountries) === null || _a === void 0 ? void 0 : _a.indexOf(c.country)) !== -1)
+                    return false;
+                if (((_b = t.eligibleCountries) === null || _b === void 0 ? void 0 : _b.length) && t.eligibleCountries.indexOf(c.country) === -1)
+                    return false;
+                return true;
+            },
+            message: function (_t, c) { return "Country ".concat(c.country, " not eligible"); }
+        },
+        // Verification
+        {
+            name: 'verification',
+            check: function (t, c) {
+                if (!t.requiresVerification)
+                    return true;
+                return c.isVerified === true;
+            },
+            message: function () { return 'Account verification required'; }
+        },
+        // Account age
+        {
+            name: 'account_age',
+            check: function (t, c) {
+                if (!t.minAccountAgeDays)
+                    return true;
+                if (c.accountAgeDays === undefined)
+                    return true;
+                return c.accountAgeDays >= t.minAccountAgeDays;
+            },
+            message: function (t) { return "Account must be at least ".concat(t.minAccountAgeDays, " days old"); }
+        },
+        // First deposit (type-specific)
+        {
+            name: 'first_deposit',
+            check: function (t, c) {
+                if (t.type !== 'first_deposit' && t.type !== 'welcome')
+                    return true;
+                return c.isFirstDeposit === true;
+            },
+            message: function () { return 'Only available for first deposit'; }
+        },
+        // First purchase (type-specific)
+        {
+            name: 'first_purchase',
+            check: function (t, c) {
+                if (t.type !== 'first_purchase')
+                    return true;
+                return c.isFirstPurchase === true;
+            },
+            message: function () { return 'Only available for first purchase'; }
+        },
+        // Selection count
+        {
+            name: 'selection_count',
+            check: function (t, c) {
+                var _a, _b, _c;
+                if (['selection', 'combo', 'bundle'].indexOf(t.type) === -1)
+                    return true;
+                var count = (_c = (_a = c.selectionCount) !== null && _a !== void 0 ? _a : (_b = c.selections) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0;
+                if (t.minSelections && count < t.minSelections)
+                    return false;
+                if (t.maxSelections && count > t.maxSelections)
+                    return false;
+                return true;
+            },
+            message: function (t, c) {
+                var _a, _b, _c;
+                var count = (_c = (_a = c.selectionCount) !== null && _a !== void 0 ? _a : (_b = c.selections) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0;
+                if (t.minSelections && count < t.minSelections) {
+                    return "Minimum ".concat(t.minSelections, " selections required (you have ").concat(count, ")");
+                }
+                return "Maximum ".concat(t.maxSelections, " selections allowed (you have ").concat(count, ")");
+            }
+        },
+        // Selection value range
+        {
+            name: 'selection_value_range',
+            check: function (t, c) {
+                var _a;
+                if (['selection', 'combo', 'bundle'].indexOf(t.type) === -1)
+                    return true;
+                if (!((_a = c.selections) === null || _a === void 0 ? void 0 : _a.length))
+                    return true;
+                for (var _i = 0, _b = c.selections; _i < _b.length; _i++) {
+                    var sel = _b[_i];
+                    if (sel.value === undefined)
+                        continue;
+                    if (t.min !== undefined && sel.value < t.min)
+                        return false;
+                    if (t.max !== undefined && sel.value > t.max)
+                        return false;
+                }
+                return true;
+            },
+            message: function (t, c) {
+                if (!c.selections)
+                    return 'Invalid selections';
+                for (var _i = 0, _a = c.selections; _i < _a.length; _i++) {
+                    var sel = _a[_i];
+                    if (sel.value === undefined)
+                        continue;
+                    if (t.min !== undefined && sel.value < t.min) {
+                        return "Selection value ".concat(sel.value, " is below minimum ").concat(t.min);
+                    }
+                    if (t.max !== undefined && sel.value > t.max) {
+                        return "Selection value ".concat(sel.value, " exceeds maximum ").concat(t.max);
+                    }
+                }
+                return 'Selection value out of range';
+            }
+        },
+        // Selection total range
+        {
+            name: 'selection_total_range',
+            check: function (t, c) {
+                var _a;
+                if (['selection', 'combo', 'bundle'].indexOf(t.type) === -1)
+                    return true;
+                var total = c.selectionsTotal;
+                if (total === undefined && ((_a = c.selections) === null || _a === void 0 ? void 0 : _a.length)) {
+                    var isMultiplicative = t.type === 'combo';
+                    if (isMultiplicative) {
+                        total = c.selections.reduce(function (acc, s) { var _a; return acc * ((_a = s.value) !== null && _a !== void 0 ? _a : 1); }, 1);
+                    }
+                    else {
+                        total = c.selections.reduce(function (acc, s) { var _a; return acc + ((_a = s.value) !== null && _a !== void 0 ? _a : 0); }, 0);
+                    }
+                }
+                if (total === undefined)
+                    return true;
+                if (t.minTotal !== undefined && total < t.minTotal)
+                    return false;
+                if (t.maxTotal !== undefined && total > t.maxTotal)
+                    return false;
+                return true;
+            },
+            message: function (t, c) {
+                var _a;
+                var total = c.selectionsTotal;
+                if (total === undefined && ((_a = c.selections) === null || _a === void 0 ? void 0 : _a.length)) {
+                    var isMultiplicative = t.type === 'combo';
+                    if (isMultiplicative) {
+                        total = c.selections.reduce(function (acc, s) { var _a; return acc * ((_a = s.value) !== null && _a !== void 0 ? _a : 1); }, 1);
+                    }
+                    else {
+                        total = c.selections.reduce(function (acc, s) { var _a; return acc + ((_a = s.value) !== null && _a !== void 0 ? _a : 0); }, 0);
+                    }
+                }
+                if (t.minTotal !== undefined && total !== undefined && total < t.minTotal) {
+                    return "Combined total ".concat(total.toFixed(2), " is below minimum ").concat(t.minTotal);
+                }
+                if (t.maxTotal !== undefined && total !== undefined && total > t.maxTotal) {
+                    return "Combined total ".concat(total.toFixed(2), " exceeds maximum ").concat(t.maxTotal);
+                }
+                return 'Combined total out of range';
+            }
+        },
+        // Activity category
+        {
+            name: 'activity_category',
+            check: function (t, c) {
+                var _a;
+                if (!((_a = t.eligibleCategories) === null || _a === void 0 ? void 0 : _a.length))
+                    return true;
+                if (!c.activityCategory)
+                    return true;
+                return t.eligibleCategories.indexOf(c.activityCategory) !== -1;
+            },
+            message: function (t) { var _a; return "Activity category not eligible. Allowed: ".concat((_a = t.eligibleCategories) === null || _a === void 0 ? void 0 : _a.join(', ')); }
+        },
+        // Total uses limit
+        {
+            name: 'total_uses',
+            check: function (t) {
+                if (!t.maxUsesTotal || t.currentUsesTotal === undefined)
+                    return true;
+                return t.currentUsesTotal < t.maxUsesTotal;
+            },
+            message: function () { return 'Bonus no longer available (limit reached)'; }
+        }
+    ];
+    return BonusEligibility;
+}());
+exports.BonusEligibility = BonusEligibility;
+// ═══════════════════════════════════════════════════════════════════════════
+// CONVENIENCE EXPORTS
+// ═══════════════════════════════════════════════════════════════════════════
+exports.checkBonusEligibility = BonusEligibility.check.bind(BonusEligibility);
+exports.checkManyBonusEligibility = BonusEligibility.checkMany.bind(BonusEligibility);
+exports.getEligibleBonuses = BonusEligibility.getEligible.bind(BonusEligibility);
+exports.findBestDepositBonus = BonusEligibility.findBestForDeposit.bind(BonusEligibility);
+exports.findSelectionBonuses = BonusEligibility.findForSelections.bind(BonusEligibility);