@escapenavigator/utils 2.0.49 → 2.1.0

package/dist/composition-price.js

@@ -0,0 +1,339 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.legacyCountsFromComposition = exports.legacyFromCategories = exports.compositionFromLegacy = exports.getMaxDiscountedSeats = exports.getCompositionPrice = exports.getCategorySeatPrice = exports.getCategorySeatDiscount = exports.getPerPersonAmount = exports.getLevelAmount = exports.getPricingHeads = exports.getTotalHeads = exports.normalizeComposition = exports.formatCompositionBreakdown = exports.resolveCategories = exports.mergeLegacyCategories = exports.hasExtraCategories = exports.categoriesFromLegacy = exports.baseCategory = void 0;
+const tariff_category_mode_enum_1 = require("@escapenavigator/types/dist/tariff/enum/tariff-category-mode.enum");
+const tariff_reduced_rate_mode_enum_1 = require("@escapenavigator/types/dist/tariff/enum/tariff-reduced-rate-mode.enum");
+const tariff_category_1 = require("@escapenavigator/types/dist/tariff/tariff-category");
+const reduced_price_1 = require("./reduced-price");
+const int = (value) => {
+    const amount = Math.round(Number(value));
+    return Number.isFinite(amount) ? amount : 0;
+};
+const positiveInt = (value) => Math.max(0, int(value));
+/** Базисные пункты скидки: 1% = 100, потолок — 100%. */
+const clampBps = (value) => Math.min(10000, positiveInt(value));
+/**
+ * Базовая категория тарифа: полная доля групповой цены. Ровно одна на тариф —
+ * именно она задаёт «цену за человека», от которой считаются остальные.
+ */
+const baseCategory = (categories) => categories.find((category) => category.mode === tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE);
+exports.baseCategory = baseCategory;
+/**
+ * Категории тарифа, собранные из легаси-полей. Нужны, пока не все тарифы
+ * прошли бэкфилл и пока старые клиенты присылают тариф без `categories`.
+ *
+ * Соответствие точное, поэтому цена не меняется: льготная ставка — это
+ * категория, занимающая место в составе, а детская — надбавка сверх группы.
+ */
+const categoriesFromLegacy = (config) => {
+    const legacy = config.legacy || {};
+    const categories = [
+        {
+            key: tariff_category_1.BASE_CATEGORY_KEY,
+            title: '',
+            mode: tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE,
+            value: 0,
+            countsInPrice: true,
+        },
+    ];
+    const reducedRate = positiveInt(legacy.reducedRate);
+    if (legacy.reducedRateMode && reducedRate > 0) {
+        categories.push({
+            key: tariff_category_1.REDUCED_CATEGORY_KEY,
+            title: legacy.reducedTitle || '',
+            description: legacy.reducedPriceDescription ?? null,
+            mode: legacy.reducedRateMode === tariff_reduced_rate_mode_enum_1.TariffReducedRateModeEnum.DELTA
+                ? tariff_category_mode_enum_1.TariffCategoryModeEnum.DELTA
+                : tariff_category_mode_enum_1.TariffCategoryModeEnum.FIXED,
+            value: reducedRate,
+            countsInPrice: true,
+        });
+    }
+    const childPrice = config.price?.child;
+    if (childPrice !== undefined && childPrice !== null && !Number.isNaN(+childPrice)) {
+        categories.push({
+            key: tariff_category_1.CHILD_CATEGORY_KEY,
+            title: '',
+            description: legacy.childPriceDescription ?? null,
+            mode: tariff_category_mode_enum_1.TariffCategoryModeEnum.FIXED,
+            value: positiveInt(childPrice),
+            countsInPrice: false,
+        });
+    }
+    return categories;
+};
+exports.categoriesFromLegacy = categoriesFromLegacy;
+/**
+ * В тарифе есть строки кроме базовых взрослых: льготные места или надбавка
+ * сверх группы. Для такого состава пикер рисует степперы, а в сумме прячет
+ * «за человека» — она уже стоит на каждой строке.
+ */
+const hasExtraCategories = (categories) => (categories || []).some((category) => category.mode !== tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE);
+exports.hasExtraCategories = hasExtraCategories;
+/**
+ * Дописывает в уже сохранённые категории те строки, которые ещё живут только
+ * в легаси-полях (`price.child`, `reduced*`).
+ *
+ * Нужно рефилу: тариф, который успели открыть в новом редакторе, получил
+ * `[BASE]` и больше не попадает в «пустой список», хотя детская цена на нём
+ * ещё есть. Идемпотентен: уже перенесённые детская/льгота не дублируются.
+ */
+const mergeLegacyCategories = (existing, config) => {
+    const fromLegacy = (0, exports.categoriesFromLegacy)(config);
+    const own = (existing || []).filter((category) => !!category?.key);
+    if (!own.length || !(0, exports.baseCategory)(own))
+        return fromLegacy;
+    const keys = new Set(own.map((category) => category.key));
+    const hasAddOn = own.some((category) => !category.countsInPrice);
+    const hasReduced = own.some((category) => category.countsInPrice && category.mode !== tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE);
+    const extras = fromLegacy.filter((category) => {
+        if (category.mode === tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE)
+            return false;
+        if (keys.has(category.key))
+            return false;
+        if (!category.countsInPrice && hasAddOn)
+            return false;
+        if (category.countsInPrice && hasReduced)
+            return false;
+        return true;
+    });
+    return extras.length ? [...own, ...extras] : own;
+};
+exports.mergeLegacyCategories = mergeLegacyCategories;
+/**
+ * Категории, по которым считать цену: собственные, если тариф уже переведён,
+ * иначе собранные из легаси-полей. Без базовой категории список бессмысленен
+ * (не от чего считать доли) — такой тоже уходит в легаси-ветку.
+ */
+const resolveCategories = (config) => {
+    const own = (config.categories || []).filter((category) => !!category?.key);
+    return own.length && (0, exports.baseCategory)(own) ? own : (0, exports.categoriesFromLegacy)(config);
+};
+exports.resolveCategories = resolveCategories;
+/**
+ * «2 взрослых, 3 студента» — подпись под общим числом человек, когда в тарифе
+ * есть льготные или надбавочные строки. Без них раскладывать нечего.
+ */
+const formatCompositionBreakdown = (composition, categories) => {
+    if (!(0, exports.hasExtraCategories)(categories))
+        return '';
+    return (categories || [])
+        .map((category) => {
+        const count = positiveInt(composition?.[category.key]);
+        const title = category.title?.trim();
+        if (!count || !title)
+            return '';
+        return `${count} ${title}`;
+    })
+        .filter(Boolean)
+        .join(', ');
+};
+exports.formatCompositionBreakdown = formatCompositionBreakdown;
+/** Нормализованный состав: целые неотрицательные числа, лишние ключи выброшены. */
+const normalizeComposition = (composition, categories) => {
+    const counts = {};
+    categories.forEach((category) => {
+        const count = positiveInt(composition?.[category.key]);
+        const max = category.max === null || category.max === undefined ? null : positiveInt(category.max);
+        counts[category.key] = max === null ? count : Math.min(count, max);
+    });
+    return counts;
+};
+exports.normalizeComposition = normalizeComposition;
+/** Гостей всего: и те, что занимают место в сетке, и надбавочные. */
+const getTotalHeads = (composition, categories) => categories.reduce((sum, category) => sum + positiveInt(composition?.[category.key]), 0);
+exports.getTotalHeads = getTotalHeads;
+/** Гостей, определяющих уровень сетки `price[N]`. */
+const getPricingHeads = (composition, categories) => categories.reduce((sum, category) => category.countsInPrice ? sum + positiveInt(composition?.[category.key]) : sum, 0);
+exports.getPricingHeads = getPricingHeads;
+/** Групповая цена уровня. 0 — состав недоступен для брони. */
+const getLevelAmount = (price, heads) => {
+    const amount = Number(price?.[heads]);
+    return Number.isFinite(amount) && amount > 0 ? amount : 0;
+};
+exports.getLevelAmount = getLevelAmount;
+/**
+ * Доля одного гостя в групповой цене. Не округляем: остаток от неровного
+ * деления (108 / 3) уходит в скидку места, а групповой итог остаётся ровно
+ * тем, что стоит в прайсе.
+ */
+const getPerPersonAmount = (price, heads) => {
+    const amount = (0, exports.getLevelAmount)(price, heads);
+    return amount && heads > 0 ? amount / heads : 0;
+};
+exports.getPerPersonAmount = getPerPersonAmount;
+/**
+ * Скидка одного гостя категории от базовой доли.
+ *
+ * Считаем именно скидку, а не цену гостя: групповой итог тогда остаётся
+ * суммой из прайса, а неровное деление не размазывается копейками по головам.
+ */
+const getCategorySeatDiscount = (category, perPerson) => {
+    switch (category.mode) {
+        case tariff_category_mode_enum_1.TariffCategoryModeEnum.DELTA:
+            return positiveInt(category.value);
+        case tariff_category_mode_enum_1.TariffCategoryModeEnum.FIXED:
+            // Ставка задана абсолютом: на больших группах обычная цена сама
+            // опускается до неё — тогда скидки нет.
+            return Math.max(0, Math.round(perPerson - positiveInt(category.value)));
+        case tariff_category_mode_enum_1.TariffCategoryModeEnum.PERCENT:
+            return Math.min(Math.round(perPerson), Math.round((perPerson * clampBps(category.value)) / 10000));
+        default:
+            return 0;
+    }
+};
+exports.getCategorySeatDiscount = getCategorySeatDiscount;
+/** Цена одного гостя категории при текущем составе. */
+const getCategorySeatPrice = (category, perPerson) => {
+    if (category.mode === tariff_category_mode_enum_1.TariffCategoryModeEnum.FIXED)
+        return positiveInt(category.value);
+    if (category.mode === tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE)
+        return Math.round(perPerson);
+    return Math.max(0, Math.round(perPerson) - (0, exports.getCategorySeatDiscount)(category, perPerson));
+};
+exports.getCategorySeatPrice = getCategorySeatPrice;
+/**
+ * Цена игры за состав.
+ *
+ * Сумма = цена уровня по головам, занимающим место, минус скидки этих голов,
+ * плюс надбавочные категории, и всё это не ниже минимальной стоимости игры.
+ */
+const getCompositionPrice = (source) => {
+    const categories = (0, exports.resolveCategories)(source);
+    const counts = (0, exports.normalizeComposition)(source.composition, categories);
+    const pricingHeads = (0, exports.getPricingHeads)(counts, categories);
+    const groupAmount = (0, exports.getLevelAmount)(source.price, pricingHeads);
+    const perPerson = pricingHeads > 0 ? groupAmount / pricingHeads : 0;
+    const addOn = categories.reduce((sum, category) => category.countsInPrice
+        ? sum
+        : sum + counts[category.key] * (0, exports.getCategorySeatPrice)(category, perPerson), 0);
+    // Цены на такой состав нет (или она 0 — «состав недоступен»). Минимальная
+    // стоимость игры к нему не применяется: иначе отключённое число игроков
+    // внезапно начало бы стоить пол выручки.
+    if (groupAmount <= 0)
+        return addOn;
+    const discount = categories.reduce((sum, category) => category.countsInPrice
+        ? sum + counts[category.key] * (0, exports.getCategorySeatDiscount)(category, perPerson)
+        : sum, 0);
+    return (0, reduced_price_1.applyMinGameAmount)(groupAmount - Math.min(discount, groupAmount) + addOn, source);
+};
+exports.getCompositionPrice = getCompositionPrice;
+/**
+ * Сколько гостей категории ещё снижают цену, не упираясь в пол выручки.
+ * Это не лимит выбора — отметить можно больше, цена просто перестанет падать.
+ */
+const getMaxDiscountedSeats = (source, categoryKey) => {
+    const categories = (0, exports.resolveCategories)(source);
+    const category = categories.find((item) => item.key === categoryKey);
+    if (!category?.countsInPrice)
+        return 0;
+    const counts = (0, exports.normalizeComposition)(source.composition, categories);
+    const pricingHeads = (0, exports.getPricingHeads)(counts, categories);
+    const groupAmount = (0, exports.getLevelAmount)(source.price, pricingHeads);
+    if (!groupAmount)
+        return 0;
+    const seatDiscount = (0, exports.getCategorySeatDiscount)(category, groupAmount / pricingHeads);
+    if (!seatDiscount)
+        return 0;
+    const room = groupAmount - (0, reduced_price_1.getMinGameAmount)(source);
+    if (room <= 0)
+        return 0;
+    return Math.min(pricingHeads, Math.floor(room / seatDiscount));
+};
+exports.getMaxDiscountedSeats = getMaxDiscountedSeats;
+/* ------------------------- Легаси-совместимость ------------------------- */
+/**
+ * Состав по категориям из полей старого формата.
+ *
+ * `reducedPlayers` — это часть `players`, поэтому базовой категории достаётся
+ * остаток. Обратное преобразование — `legacyCountsFromComposition`.
+ */
+const compositionFromLegacy = (legacyCounts, categories) => {
+    const players = positiveInt(legacyCounts.players);
+    const reduced = Math.min(positiveInt(legacyCounts.reducedPlayers), players);
+    const base = (0, exports.baseCategory)(categories);
+    const composition = {};
+    categories.forEach((category) => {
+        composition[category.key] = 0;
+    });
+    if (base)
+        composition[base.key] = players - reduced;
+    const reducedCategory = categories.find((category) => category.countsInPrice && category.mode !== tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE);
+    if (reducedCategory)
+        composition[reducedCategory.key] = reduced;
+    const childCategory = categories.find((category) => !category.countsInPrice);
+    if (childCategory)
+        composition[childCategory.key] = positiveInt(legacyCounts.children);
+    return composition;
+};
+exports.compositionFromLegacy = compositionFromLegacy;
+/**
+ * Легаси-поля тарифа, восстановленные из категорий. Обратная операция к
+ * `categoriesFromLegacy`: венью правит тариф уже категориями, а мобильное
+ * приложение и не обновлённые интеграции продолжают читать `price.child` и
+ * `reduced*` — без этой проекции они бы застыли на значениях до перехода.
+ *
+ * Схлопывание с потерями и это нормально: легаси-формат умеет ровно одну
+ * льготную категорию и ровно одну надбавочную. Берём первые — цена там, где
+ * есть `categories`, всё равно считается по ним.
+ */
+const legacyFromCategories = (categories, price) => {
+    const addOn = categories.find((category) => !category.countsInPrice);
+    const reduced = categories.find((category) => category.countsInPrice && category.mode !== tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE);
+    const legacy = {
+        childPrice: addOn ? positiveInt(addOn.value) : null,
+        childPriceDescription: addOn?.description ?? null,
+        reducedRateMode: null,
+        reducedRate: 0,
+        reducedTitle: reduced?.title || null,
+        reducedPriceDescription: reduced?.description ?? null,
+    };
+    if (!reduced)
+        return legacy;
+    if (reduced.mode === tariff_category_mode_enum_1.TariffCategoryModeEnum.FIXED) {
+        legacy.reducedRateMode = tariff_reduced_rate_mode_enum_1.TariffReducedRateModeEnum.FIXED;
+        legacy.reducedRate = positiveInt(reduced.value);
+        return legacy;
+    }
+    legacy.reducedRateMode = tariff_reduced_rate_mode_enum_1.TariffReducedRateModeEnum.DELTA;
+    if (reduced.mode === tariff_category_mode_enum_1.TariffCategoryModeEnum.DELTA) {
+        legacy.reducedRate = positiveInt(reduced.value);
+        return legacy;
+    }
+    // Процент в легаси-формате не выразить. Переводим в фиксированную скидку по
+    // самой большой группе: там доля гостя минимальна, значит и скидка выйдет
+    // наименьшей из возможных — старый клиент недосчитает скидку, но никогда не
+    // продаст игру дешевле, чем задумано.
+    const levels = Object.keys(price || {})
+        .map((key) => +key)
+        .filter((heads) => heads > 0 && (0, exports.getLevelAmount)(price, heads) > 0);
+    const largest = levels.length ? Math.max(...levels) : 0;
+    legacy.reducedRate = largest
+        ? (0, exports.getCategorySeatDiscount)(reduced, (0, exports.getPerPersonAmount)(price, largest))
+        : 0;
+    return legacy;
+};
+exports.legacyFromCategories = legacyFromCategories;
+/**
+ * Поля старого формата из состава по категориям. Нужны, пока их читают не
+ * обновлённые клиенты (мобильное приложение) и вся отчётность по броням.
+ *
+ * На тарифе с несколькими льготными категориями `reducedPlayers` схлопывает
+ * их в одно число: восстановить цену из легаси-полей в таком случае нельзя,
+ * источник истины — `composition` и снимок категорий на брони.
+ */
+const legacyCountsFromComposition = (composition, categories) => {
+    const counts = (0, exports.normalizeComposition)(composition, categories);
+    return categories.reduce((acc, category) => {
+        const count = counts[category.key];
+        if (!category.countsInPrice) {
+            acc.children += count;
+            return acc;
+        }
+        acc.players += count;
+        if (category.mode !== tariff_category_mode_enum_1.TariffCategoryModeEnum.BASE)
+            acc.reducedPlayers += count;
+        return acc;
+    }, { players: 0, children: 0, reducedPlayers: 0 });
+};
+exports.legacyCountsFromComposition = legacyCountsFromComposition;

package/dist/composition-price.spec.d.ts

@@ -0,0 +1 @@
+export {};