@escapenavigator/utils 2.0.35 → 2.0.39

package/dist/classify-api-error.d.ts

@@ -23,7 +23,10 @@
  *
  *   skip     → не репортим
  *              304 (etag-success), отменённые axios-запросы (ERR_CANCELED),
- *              401/403 на app/auth (ожидаемый session/role flow).
+ *              401/403 на app/auth (ожидаемый session/role flow), а также
+ *              обрывы связи на стороне клиента: `Network Error`,
+ *              «timeout of 0ms exceeded» и «Request aborted» (запрос умер
+ *              до ответа сервера).
  *
  * Группировка (`fingerprint`) делается так, чтобы все события с одинаковым
  * `apiKey + errorCode` сливались в один issue. Иначе Sentry плодит отдельный

package/dist/classify-api-error.js

@@ -24,7 +24,10 @@
  *
  *   skip     → не репортим
  *              304 (etag-success), отменённые axios-запросы (ERR_CANCELED),
- *              401/403 на app/auth (ожидаемый session/role flow).
+ *              401/403 на app/auth (ожидаемый session/role flow), а также
+ *              обрывы связи на стороне клиента: `Network Error`,
+ *              «timeout of 0ms exceeded» и «Request aborted» (запрос умер
+ *              до ответа сервера).
  *
  * Группировка (`fingerprint`) делается так, чтобы все события с одинаковым
  * `apiKey + errorCode` сливались в один issue. Иначе Sentry плодит отдельный
@@ -78,20 +81,33 @@ const SKIP_AUTH_STATUSES_ON_APPS = new Set(['app', 'auth']);
  */
 const SKIP_NOT_FOUND_API_KEYS = new Set(['login', 'loginSwitch']);
 const isNetworkErrorMessage = (message) => typeof message === 'string' && /network error/i.test(message);
+/**
+ * Сообщения ECONNABORTED, означающие «запрос отменил браузер/ОС», а не
+ * «бэк не ответил за отведённый таймаут». Сконфигурированный таймаут виджета
+ * («timeout of 25000ms exceeded») этому не соответствует и остаётся critical.
+ */
+const isClientAbortMessage = (message) => typeof message === 'string' && /timeout of 0ms|request aborted/i.test(message);
 function classifyApiError(ctx) {
     const { status, code, apiKey, errorCode, originalErrorCode, message, app } = ctx;
     if (code && SKIP_AXIOS_CODES.has(code)) {
         return { severity: 'skip', level: 'info', fingerprint: null, shouldReport: false };
     }
-    // «timeout of 0ms exceeded» — Safari/iOS обрывает XHR при смене сети или
-    // уходе вкладки в фон. Не баг, но полезно для картины мобильной связности.
-    if (code === 'ECONNABORTED' && typeof message === 'string' && /timeout of 0ms/i.test(message)) {
-        return {
-            severity: 'business',
-            level: 'info',
-            fingerprint: ['api', 'mobile-abort', apiKey],
-            shouldReport: true,
-        };
+    // ECONNABORTED, где запрос умер на клиенте, а не на бэке:
+    //
+    //   «timeout of 0ms exceeded» — Safari/iOS обрывает XHR при смене сети или
+    //   уходе вкладки в фон (timeout у запроса не выставлен, обрыв не наш).
+    //   Раньше репортили как business/info «для картины мобильной связности»:
+    //   за месяц это дало десяток issue на 50+ человек
+    //   (ESCAPE-NAVIGATOR-APP-3J/3K/3M/3H/2P/3G/33), в которых ни одного бага.
+    //
+    //   «Request aborted» — axios@0.21 отдаёт это на `xhr.onabort`, то есть
+    //   когда браузер сам убил запрос: пользователь ушёл со страницы, закрыл
+    //   таб или нажал «стоп» до ответа. О здоровье API это не говорит ничего,
+    //   а в Sentry попадало как critical.
+    //
+    // Картину связности всё равно лучше видно по метрикам, а не по issue.
+    if (code === 'ECONNABORTED' && isClientAbortMessage(message)) {
+        return { severity: 'skip', level: 'info', fingerprint: null, shouldReport: false };
     }
     if (typeof status === 'number' && SKIP_HTTP_STATUSES.has(status)) {
         return { severity: 'skip', level: 'info', fingerprint: null, shouldReport: false };
@@ -155,14 +171,15 @@ function classifyApiError(ctx) {
     // code === 'ERR_NETWORK' (axios>=0.27). На проде это почти всегда
     // клиентская связность (мобильный обрыв, смена соты, троттлинг/RKN).
     // На виджете GET'ы уже ретраятся — сюда долетает только финальный фейл.
+    //
+    // Не репортим: за месяц это ~1000 событий в app/widget/auth, разбитых на
+    // десятки issue по apiKey, и ни одно не было багом. Настоящая
+    // недоступность бэка видна иначе и этим фильтром не задета: 5xx и
+    // сработавший таймаут (25s у виджета) выше классифицируются как critical,
+    // а падение домена/сертификата ловится мониторингом со стороны бэкенда.
     const isNetworkError = !status && (code === 'ERR_NETWORK' || (!code && isNetworkErrorMessage(message)));
     if (isNetworkError) {
-        return {
-            severity: 'business',
-            level: 'warning',
-            fingerprint: ['api', 'network', apiKey],
-            shouldReport: true,
-        };
+        return { severity: 'skip', level: 'info', fingerprint: null, shouldReport: false };
     }
     // Сюда падают: какие-то странные кейсы без status/кода/сетевого message.
     // Считаем critical, но без агрессивного группирования — пусть Sentry

package/dist/classify-api-error.spec.js

@@ -43,6 +43,37 @@ describe('classifyApiError', () => {
             const r = (0, classify_api_error_1.classifyApiError)({ ...base, status: 404, app: 'auth' });
             expect(r.shouldReport).toBe(true);
         });
+        it('чистый network error → skip (обрыв связи у клиента)', () => {
+            expect((0, classify_api_error_1.classifyApiError)({ ...base, code: 'ERR_NETWORK' }).shouldReport).toBe(false);
+            expect((0, classify_api_error_1.classifyApiError)({ ...base, message: 'Network Error' }).shouldReport).toBe(false);
+        });
+        it('мобильный обрыв (timeout of 0ms) → skip', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({
+                ...base,
+                code: 'ECONNABORTED',
+                message: 'timeout of 0ms exceeded',
+            });
+            expect(r.severity).toBe('skip');
+            expect(r.shouldReport).toBe(false);
+        });
+        it('уход со страницы до ответа (Request aborted) → skip', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({
+                ...base,
+                code: 'ECONNABORTED',
+                message: 'Request aborted',
+            });
+            expect(r.severity).toBe('skip');
+            expect(r.shouldReport).toBe(false);
+        });
+        it('сработавший таймаут виджета (25s) → НЕ skip, это медленный бэк', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({
+                ...base,
+                code: 'ECONNABORTED',
+                message: 'timeout of 25000ms exceeded',
+            });
+            expect(r.severity).toBe('critical');
+            expect(r.shouldReport).toBe(true);
+        });
         it('5xx на login → НЕ skip (это уже настоящий сбой входа)', () => {
             const r = (0, classify_api_error_1.classifyApiError)({
                 apiKey: 'login',
@@ -99,20 +130,6 @@ describe('classifyApiError', () => {
             expect(r.severity).toBe('business');
             expect(r.fingerprint).toContain('bookingWindowClosed');
         });
-        it('мобильный обрыв (timeout of 0ms) → business/info', () => {
-            const r = (0, classify_api_error_1.classifyApiError)({
-                ...base,
-                code: 'ECONNABORTED',
-                message: 'timeout of 0ms exceeded',
-            });
-            expect(r.severity).toBe('business');
-            expect(r.level).toBe('info');
-            expect(r.fingerprint).toContain('mobile-abort');
-        });
-        it('чистый network error → business', () => {
-            expect((0, classify_api_error_1.classifyApiError)({ ...base, code: 'ERR_NETWORK' }).severity).toBe('business');
-            expect((0, classify_api_error_1.classifyApiError)({ ...base, message: 'Network Error' }).severity).toBe('business');
-        });
     });
     describe('debug (generic 4xx — шум, но репортим info-level)', () => {
         it.each([

package/dist/format-slot-discount/index.d.ts

@@ -0,0 +1,6 @@
+import { SlotDiscountTypeEnum } from '@escapenavigator/types/dist/slot/enum/slot-discount-type.enum';
+/**
+ * Скидка слота для показа: «15%» для процентной и «500 руб.» для фиксированной.
+ * Без знака «минус» — вызывающий сам решает, как её подать.
+ */
+export declare const formatSlotDiscount: (discount: number, discountType: SlotDiscountTypeEnum | string | null | undefined, currency: string) => string;

package/dist/format-slot-discount/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatSlotDiscount = void 0;
+const format_amount_1 = require("../format-amount");
+const get_slot_discount_amount_1 = require("../get-slot-discount-amount");
+/**
+ * Скидка слота для показа: «15%» для процентной и «500 руб.» для фиксированной.
+ * Без знака «минус» — вызывающий сам решает, как её подать.
+ */
+const formatSlotDiscount = (discount, discountType, currency) => {
+    if ((0, get_slot_discount_amount_1.isFixedSlotDiscount)(discountType))
+        return (0, format_amount_1.formatAmount)(discount, currency);
+    return `${discount / 100}%`;
+};
+exports.formatSlotDiscount = formatSlotDiscount;

package/dist/get-order-cancelation-date/index.d.ts

@@ -3,7 +3,8 @@ type Props = {
     utcDate: string;
     minHoursForFreeCanceling: number;
     cancelationRule: QuestroomCancelationTypeEnum;
-    timeZone: string;
+    /** Часовой пояс локации; при отсутствии считаем в UTC (см. ниже). */
+    timeZone?: string;
 };
 export declare function getOrderCancelationDate({ utcDate, minHoursForFreeCanceling, cancelationRule, timeZone, }: Props): {
     orderCancelationDate: Date;

package/dist/get-order-cancelation-date/index.js

@@ -5,7 +5,12 @@ const questroom_cancelation_type_enum_1 = require("@escapenavigator/types/dist/q
 const date_1 = require("../date");
 function getOrderCancelationDate({ utcDate, minHoursForFreeCanceling, cancelationRule, timeZone, }) {
     const minHours = cancelationRule === questroom_cancelation_type_enum_1.QuestroomCancelationTypeEnum.NO ? 0 : minHoursForFreeCanceling;
-    const date = (0, date_1.addHours)((0, date_1.utcToZonedTime)(utcDate, timeZone), minHours * -1);
+    // Локация заказа может быть удалена (`questroom.location === null`), и
+    // тогда часового пояса просто нет. `utcToZonedTime` на undefined даёт
+    // Invalid Date, а `formatDate` на нём кидает — падала вся клиентская
+    // страница заказа (ESCAPE-NAVIGATOR-ORDERS-2D). Дата в UTC хуже
+    // локальной, но лучше пустого экрана.
+    const date = (0, date_1.addHours)((0, date_1.utcToZonedTime)(utcDate, timeZone || 'UTC'), minHours * -1);
     return {
         orderCancelationDate: date,
         orderCancelationHumantDate: (0, date_1.formatDate)(date, 'dd.MM.yyyy, HH:mm'),

package/dist/get-slot-discount-amount.d.ts

@@ -0,0 +1,22 @@
+import { SlotDiscountTypeEnum } from '@escapenavigator/types/dist/slot/enum/slot-discount-type.enum';
+type SlotDiscountType = SlotDiscountTypeEnum | string | null;
+type Params = {
+    /** База начисления скидки в минорных единицах (стоимость игры за игроков). */
+    price: number;
+    /** `slots.discount`: базисные пункты для процента, минорные единицы для фикс. */
+    discount?: number | null;
+    discountType?: SlotDiscountType;
+    /**
+     * Процентная скидка исторически округлялась по-разному: `Math.round` в
+     * расчёте заказа и `Math.floor` в «цене от» для расписания. Параметр
+     * сохраняет это различие, чтобы правки не сдвигали цены на проде.
+     */
+    rounding?: 'round' | 'floor';
+};
+export declare const isFixedSlotDiscount: (discountType?: SlotDiscountType) => boolean;
+/**
+ * Сумма скидки слота в минорных единицах. Никогда не превышает базу, поэтому
+ * итог не уходит в минус даже если фиксированная скидка больше цены игры.
+ */
+export declare const getSlotDiscountAmount: ({ price, discount, discountType, rounding, }: Params) => number;
+export {};

package/dist/get-slot-discount-amount.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSlotDiscountAmount = exports.isFixedSlotDiscount = void 0;
+const slot_discount_type_enum_1 = require("@escapenavigator/types/dist/slot/enum/slot-discount-type.enum");
+const isFixedSlotDiscount = (discountType) => discountType === slot_discount_type_enum_1.SlotDiscountTypeEnum.FIXED;
+exports.isFixedSlotDiscount = isFixedSlotDiscount;
+/**
+ * Сумма скидки слота в минорных единицах. Никогда не превышает базу, поэтому
+ * итог не уходит в минус даже если фиксированная скидка больше цены игры.
+ */
+const getSlotDiscountAmount = ({ price, discount, discountType, rounding = 'round', }) => {
+    const value = discount || 0;
+    const base = price > 0 ? price : 0;
+    if (value <= 0 || !base)
+        return 0;
+    if ((0, exports.isFixedSlotDiscount)(discountType))
+        return Math.min(value, base);
+    const raw = (base * value) / 10000;
+    return Math.min(base, rounding === 'floor' ? Math.floor(raw) : Math.round(raw));
+};
+exports.getSlotDiscountAmount = getSlotDiscountAmount;

package/dist/get-slot-discount-amount.spec.d.ts

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

package/dist/get-slot-discount-amount.spec.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const slot_discount_type_enum_1 = require("@escapenavigator/types/dist/slot/enum/slot-discount-type.enum");
+const get_slot_discount_amount_1 = require("./get-slot-discount-amount");
+describe('getSlotDiscountAmount', () => {
+    it('treats a missing type as percent (слоты до появления поля)', () => {
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: 10000, discount: 1500 })).toBe(1500);
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: 10000, discount: 1500, discountType: null })).toBe(1500);
+    });
+    it('rounds percent by half up and by floor on demand', () => {
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: 3333, discount: 1500 })).toBe(500);
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: 3333, discount: 1500, rounding: 'floor' })).toBe(499);
+    });
+    it('takes a fixed discount as an amount in minor units', () => {
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({
+            price: 10000,
+            discount: 1500,
+            discountType: slot_discount_type_enum_1.SlotDiscountTypeEnum.FIXED,
+        })).toBe(1500);
+    });
+    it('never exceeds the base price', () => {
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({
+            price: 3000,
+            discount: 500000,
+            discountType: slot_discount_type_enum_1.SlotDiscountTypeEnum.FIXED,
+        })).toBe(3000);
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: 3000, discount: 20000 })).toBe(3000);
+    });
+    it('returns 0 for empty input', () => {
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: 0, discount: 1500 })).toBe(0);
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: 10000 })).toBe(0);
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({ price: -100, discount: 1500 })).toBe(0);
+        expect((0, get_slot_discount_amount_1.getSlotDiscountAmount)({
+            price: 10000,
+            discount: -500,
+            discountType: slot_discount_type_enum_1.SlotDiscountTypeEnum.FIXED,
+        })).toBe(0);
+    });
+});

package/dist/index.d.ts

@@ -8,12 +8,14 @@ export * from './convert-to-options';
 export * from './date';
 export * from './enum-to-options';
 export * from './format-flex-duration-label';
+export * from './format-slot-discount';
 export * from './functional-popover-panel-style';
 export * from './get-documents-links';
 export * from './get-full-name';
 export * from './get-handled-error-message';
 export * from './get-order-cancelation-state';
 export * from './get-service-error';
+export * from './get-slot-discount-amount';
 export * from './google-places-link-warnings';
 export * from './google-places-nonquest';
 export * from './image-url';
@@ -29,6 +31,7 @@ export * from './resolve-calendar-location-id';
 export * from './role-chat-permissions';
 export * from './role-comment-permissions';
 export * from './role-export-permissions';
+export * from './role-refund-permissions';
 export * from './serialize-record';
 export * from './serialize-slot';
 export * from './slot-representative-price';

package/dist/index.js

@@ -24,12 +24,14 @@ __exportStar(require("./convert-to-options"), exports);
 __exportStar(require("./date"), exports);
 __exportStar(require("./enum-to-options"), exports);
 __exportStar(require("./format-flex-duration-label"), exports);
+__exportStar(require("./format-slot-discount"), exports);
 __exportStar(require("./functional-popover-panel-style"), exports);
 __exportStar(require("./get-documents-links"), exports);
 __exportStar(require("./get-full-name"), exports);
 __exportStar(require("./get-handled-error-message"), exports);
 __exportStar(require("./get-order-cancelation-state"), exports);
 __exportStar(require("./get-service-error"), exports);
+__exportStar(require("./get-slot-discount-amount"), exports);
 __exportStar(require("./google-places-link-warnings"), exports);
 __exportStar(require("./google-places-nonquest"), exports);
 __exportStar(require("./image-url"), exports);
@@ -45,6 +47,7 @@ __exportStar(require("./resolve-calendar-location-id"), exports);
 __exportStar(require("./role-chat-permissions"), exports);
 __exportStar(require("./role-comment-permissions"), exports);
 __exportStar(require("./role-export-permissions"), exports);
+__exportStar(require("./role-refund-permissions"), exports);
 __exportStar(require("./serialize-record"), exports);
 __exportStar(require("./serialize-slot"), exports);
 __exportStar(require("./slot-representative-price"), exports);

package/dist/package-price/index.d.ts

@@ -0,0 +1,73 @@
+import { PackagePricingModeEnum } from '@escapenavigator/types/dist/packages/package-pricing-mode.enum';
+/**
+ * Единый калькулятор цены пакета. Живёт в utils, потому что одна и та же
+ * формула нужна в трёх местах: витрина виджета (показать «от»), конструктор
+ * (показать итог до брони) и бэкенд (посчитать реальную цену заказа).
+ * Расхождение между ними = клиент видит одну сумму, а платит другую.
+ */
+/** Поля пакета, от которых зависит цена. Ровно то, что нужно калькулятору. */
+export type PackagePricingInput = {
+    pricingMode: PackagePricingModeEnum;
+    price: number;
+    weekendPrice?: number | null;
+    weekendDays?: number[] | null;
+    includedPlayers: number;
+    extraPlayerPrice: number;
+};
+export type PackagePriceBreakdown = {
+    /** Базовая цена пакета на выбранную дату. */
+    base: number;
+    /** Сколько игроков сверх включённых в пакет. */
+    extraPlayers: number;
+    /** Доплата за игроков сверх пакета. */
+    extraPlayersTotal: number;
+    /** Стоимость выбранных платных допов. */
+    addonsTotal: number;
+    /** Итог: base + extraPlayersTotal + addonsTotal. */
+    total: number;
+    /** Цена на человека (для «≈ 1 710 ₽ / чел.»). */
+    perPerson: number;
+    /** Дата попала в «выходные» по настройкам пакета. */
+    isWeekend: boolean;
+};
+/**
+ * Индекс дня недели в проектной нумерации: 0 — понедельник … 6 — воскресенье.
+ * Совпадает с `availableDays` слотов/апселлов и компонентом `DaysOfWeek`,
+ * поэтому НЕ равен `Date.getDay()`.
+ */
+export declare const getProjectWeekday: (date: Date | string) => number;
+export declare const isPackageWeekend: (pkg: Pick<PackagePricingInput, "weekendDays">, date?: Date | string | null) => boolean;
+/** Цена пакета за день без учёта игроков и допов. */
+export declare const getPackageBasePrice: (pkg: PackagePricingInput, date?: Date | string | null) => number;
+/** Диапазон цен пакета по дням недели — для витрины («от / до»). */
+export declare const getPackagePriceRange: (pkg: PackagePricingInput) => {
+    min: number;
+    max: number;
+    hasWeekendPrice: boolean;
+};
+export declare const getPackageExtraPlayers: (pkg: PackagePricingInput, players: number) => number;
+/**
+ * Полный расчёт цены пакета в режиме `fixed`.
+ *
+ * Для `discount`-пакетов возвращает нули по базе: там цену диктуют тарифы
+ * слотов, а пакет умеет только скидку — считать её без состава группы нельзя.
+ */
+export declare const calculatePackagePrice: ({ pkg, date, players, addonsTotal, }: {
+    pkg: PackagePricingInput;
+    date?: Date | string | null;
+    players: number;
+    addonsTotal?: number;
+}) => PackagePriceBreakdown;
+/**
+ * Прайс-мапа `{ игроков: цена }` для заказа-носителя пакета.
+ *
+ * Заказ хранит снимок тарифа в `order.price`, и `getPlayersPrice` берёт из
+ * него значение по текущему числу игроков. Поэтому мы отдаём не одно число,
+ * а карту на весь допустимый диапазон: если менеджер потом поменяет состав,
+ * пересчёт останется по формуле пакета, а не превратится в ноль.
+ */
+export declare const buildPackagePriceMap: ({ pkg, date, maxPlayers, }: {
+    pkg: PackagePricingInput;
+    date?: Date | string | null;
+    maxPlayers: number;
+}) => Record<string, number>;

package/dist/package-price/index.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildPackagePriceMap = exports.calculatePackagePrice = exports.getPackageExtraPlayers = exports.getPackagePriceRange = exports.getPackageBasePrice = exports.isPackageWeekend = exports.getProjectWeekday = void 0;
+const package_pricing_mode_enum_1 = require("@escapenavigator/types/dist/packages/package-pricing-mode.enum");
+const DEFAULT_WEEKEND_DAYS = [5, 6];
+const toNumber = (value) => {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+};
+/**
+ * Индекс дня недели в проектной нумерации: 0 — понедельник … 6 — воскресенье.
+ * Совпадает с `availableDays` слотов/апселлов и компонентом `DaysOfWeek`,
+ * поэтому НЕ равен `Date.getDay()`.
+ */
+const getProjectWeekday = (date) => {
+    const parsed = typeof date === 'string' ? new Date(`${date}T00:00:00`) : date;
+    if (Number.isNaN(parsed.getTime()))
+        return 0;
+    return (parsed.getDay() + 6) % 7;
+};
+exports.getProjectWeekday = getProjectWeekday;
+const isPackageWeekend = (pkg, date) => {
+    if (!date)
+        return false;
+    const weekendDays = pkg.weekendDays?.length ? pkg.weekendDays : DEFAULT_WEEKEND_DAYS;
+    return weekendDays.includes((0, exports.getProjectWeekday)(date));
+};
+exports.isPackageWeekend = isPackageWeekend;
+/** Цена пакета за день без учёта игроков и допов. */
+const getPackageBasePrice = (pkg, date) => {
+    const weekday = Math.max(0, toNumber(pkg.price));
+    const weekend = pkg.weekendPrice == null ? weekday : Math.max(0, toNumber(pkg.weekendPrice));
+    return (0, exports.isPackageWeekend)(pkg, date) ? weekend : weekday;
+};
+exports.getPackageBasePrice = getPackageBasePrice;
+/** Диапазон цен пакета по дням недели — для витрины («от / до»). */
+const getPackagePriceRange = (pkg) => {
+    const weekday = Math.max(0, toNumber(pkg.price));
+    const weekend = pkg.weekendPrice == null ? weekday : Math.max(0, toNumber(pkg.weekendPrice));
+    return {
+        min: Math.min(weekday, weekend),
+        max: Math.max(weekday, weekend),
+        hasWeekendPrice: pkg.weekendPrice != null && weekend !== weekday,
+    };
+};
+exports.getPackagePriceRange = getPackagePriceRange;
+const getPackageExtraPlayers = (pkg, players) => Math.max(0, Math.floor(toNumber(players)) - Math.max(0, Math.floor(toNumber(pkg.includedPlayers))));
+exports.getPackageExtraPlayers = getPackageExtraPlayers;
+/**
+ * Полный расчёт цены пакета в режиме `fixed`.
+ *
+ * Для `discount`-пакетов возвращает нули по базе: там цену диктуют тарифы
+ * слотов, а пакет умеет только скидку — считать её без состава группы нельзя.
+ */
+const calculatePackagePrice = ({ pkg, date, players, addonsTotal = 0, }) => {
+    const isFixed = pkg.pricingMode === package_pricing_mode_enum_1.PackagePricingModeEnum.FIXED;
+    const base = isFixed ? (0, exports.getPackageBasePrice)(pkg, date) : 0;
+    const extraPlayers = isFixed ? (0, exports.getPackageExtraPlayers)(pkg, players) : 0;
+    const extraPlayersTotal = extraPlayers * Math.max(0, toNumber(pkg.extraPlayerPrice));
+    const safeAddons = Math.max(0, toNumber(addonsTotal));
+    const total = base + extraPlayersTotal + safeAddons;
+    const guests = Math.max(1, Math.floor(toNumber(players)));
+    return {
+        base,
+        extraPlayers,
+        extraPlayersTotal,
+        addonsTotal: safeAddons,
+        total,
+        perPerson: Math.round(total / guests),
+        isWeekend: (0, exports.isPackageWeekend)(pkg, date),
+    };
+};
+exports.calculatePackagePrice = calculatePackagePrice;
+/**
+ * Прайс-мапа `{ игроков: цена }` для заказа-носителя пакета.
+ *
+ * Заказ хранит снимок тарифа в `order.price`, и `getPlayersPrice` берёт из
+ * него значение по текущему числу игроков. Поэтому мы отдаём не одно число,
+ * а карту на весь допустимый диапазон: если менеджер потом поменяет состав,
+ * пересчёт останется по формуле пакета, а не превратится в ноль.
+ */
+const buildPackagePriceMap = ({ pkg, date, maxPlayers, }) => {
+    const base = (0, exports.getPackageBasePrice)(pkg, date);
+    const extraPrice = Math.max(0, toNumber(pkg.extraPlayerPrice));
+    const limit = Math.max(1, Math.floor(toNumber(maxPlayers)));
+    const map = {};
+    for (let players = 1; players <= limit; players++) {
+        map[players] = base + (0, exports.getPackageExtraPlayers)(pkg, players) * extraPrice;
+    }
+    return map;
+};
+exports.buildPackagePriceMap = buildPackagePriceMap;

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

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

package/dist/package-price/index.spec.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const package_pricing_mode_enum_1 = require("@escapenavigator/types/dist/packages/package-pricing-mode.enum");
+const _1 = require(".");
+/** «Хит» из витрины: 13 590 в будни, 15 590 в выходные, 8 гостей, +800 за гостя. */
+const hit = {
+    pricingMode: package_pricing_mode_enum_1.PackagePricingModeEnum.FIXED,
+    price: 13590,
+    weekendPrice: 15590,
+    weekendDays: [5, 6],
+    includedPlayers: 8,
+    extraPlayerPrice: 800,
+};
+describe('getProjectWeekday', () => {
+    it('нумерует с понедельника, а не с воскресенья как Date.getDay', () => {
+        expect((0, _1.getProjectWeekday)('2026-08-17')).toBe(0);
+        expect((0, _1.getProjectWeekday)('2026-08-22')).toBe(5);
+        expect((0, _1.getProjectWeekday)('2026-08-23')).toBe(6);
+    });
+});
+describe('isPackageWeekend', () => {
+    it('по умолчанию выходные — суббота и воскресенье', () => {
+        expect((0, _1.isPackageWeekend)({ weekendDays: [] }, '2026-08-22')).toBe(true);
+        expect((0, _1.isPackageWeekend)({ weekendDays: null }, '2026-08-19')).toBe(false);
+    });
+    it('уважает кастомный набор дней', () => {
+        expect((0, _1.isPackageWeekend)({ weekendDays: [4, 5, 6] }, '2026-08-21')).toBe(true);
+    });
+    it('без даты не угадывает', () => {
+        expect((0, _1.isPackageWeekend)(hit, null)).toBe(false);
+    });
+});
+describe('getPackageBasePrice', () => {
+    it('берёт цену выходного дня только в выходные', () => {
+        expect((0, _1.getPackageBasePrice)(hit, '2026-08-19')).toBe(13590);
+        expect((0, _1.getPackageBasePrice)(hit, '2026-08-22')).toBe(15590);
+    });
+    it('без цены выходного дня цена одна на всю неделю', () => {
+        expect((0, _1.getPackageBasePrice)({ ...hit, weekendPrice: null }, '2026-08-22')).toBe(13590);
+    });
+});
+describe('getPackagePriceRange', () => {
+    it('отдаёт диапазон для витрины', () => {
+        expect((0, _1.getPackagePriceRange)(hit)).toEqual({
+            min: 13590,
+            max: 15590,
+            hasWeekendPrice: true,
+        });
+    });
+    it('схлопывает диапазон, когда выходная цена совпадает с будней', () => {
+        expect((0, _1.getPackagePriceRange)({ ...hit, weekendPrice: 13590 })).toEqual({
+            min: 13590,
+            max: 13590,
+            hasWeekendPrice: false,
+        });
+    });
+});
+describe('calculatePackagePrice', () => {
+    it('считает 9 гостей в будни как пакет + одна доплата', () => {
+        expect((0, _1.calculatePackagePrice)({ pkg: hit, date: '2026-08-19', players: 9, addonsTotal: 1000 })).toEqual({
+            base: 13590,
+            extraPlayers: 1,
+            extraPlayersTotal: 800,
+            addonsTotal: 1000,
+            total: 15390,
+            perPerson: 1710,
+            isWeekend: false,
+        });
+    });
+    it('не берёт доплату, пока гостей не больше включённых', () => {
+        const result = (0, _1.calculatePackagePrice)({ pkg: hit, date: '2026-08-19', players: 5 });
+        expect(result.extraPlayers).toBe(0);
+        expect(result.total).toBe(13590);
+    });
+    it('в discount-режиме базы у пакета нет — цену диктуют тарифы слотов', () => {
+        const result = (0, _1.calculatePackagePrice)({
+            pkg: { ...hit, pricingMode: package_pricing_mode_enum_1.PackagePricingModeEnum.DISCOUNT },
+            date: '2026-08-22',
+            players: 12,
+            addonsTotal: 500,
+        });
+        expect(result.base).toBe(0);
+        expect(result.extraPlayersTotal).toBe(0);
+        expect(result.total).toBe(500);
+    });
+});
+describe('buildPackagePriceMap', () => {
+    it('покрывает весь диапазон, чтобы смена состава не обнуляла заказ', () => {
+        const map = (0, _1.buildPackagePriceMap)({ pkg: hit, date: '2026-08-19', maxPlayers: 10 });
+        expect(map[1]).toBe(13590);
+        expect(map[8]).toBe(13590);
+        expect(map[9]).toBe(14390);
+        expect(map[10]).toBe(15190);
+        expect(Object.keys(map)).toHaveLength(10);
+    });
+    it('в выходные строится от выходной цены', () => {
+        const map = (0, _1.buildPackagePriceMap)({ pkg: hit, date: '2026-08-22', maxPlayers: 9 });
+        expect(map[9]).toBe(16390);
+    });
+});

package/dist/role-refund-permissions.d.ts

@@ -0,0 +1,7 @@
+import { RoleRO } from '@escapenavigator/types/dist/role/role.ro';
+export type RoleRefundPermissions = Pick<RoleRO, 'totalAccess' | 'canAddRefunds'>;
+/**
+ * Право оформлять возвраты (в т.ч. Stripe). Владелец (`totalAccess`) —
+ * как будто флаг включён.
+ */
+export declare const canAddRefunds: (role?: RoleRefundPermissions | null) => boolean;

package/dist/role-refund-permissions.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canAddRefunds = void 0;
+/**
+ * Право оформлять возвраты (в т.ч. Stripe). Владелец (`totalAccess`) —
+ * как будто флаг включён.
+ */
+const canAddRefunds = (role) => !!role?.totalAccess || !!role?.canAddRefunds;
+exports.canAddRefunds = canAddRefunds;

package/dist/role-refund-permissions.spec.d.ts

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

package/dist/role-refund-permissions.spec.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const role_refund_permissions_1 = require("./role-refund-permissions");
+describe('canAddRefunds', () => {
+    it('is false without role or flag', () => {
+        expect((0, role_refund_permissions_1.canAddRefunds)()).toBe(false);
+        expect((0, role_refund_permissions_1.canAddRefunds)(null)).toBe(false);
+        expect((0, role_refund_permissions_1.canAddRefunds)({ totalAccess: false, canAddRefunds: false })).toBe(false);
+    });
+    it('is true when flag is on', () => {
+        expect((0, role_refund_permissions_1.canAddRefunds)({ totalAccess: false, canAddRefunds: true })).toBe(true);
+    });
+    it('is true for totalAccess even when flag is off', () => {
+        expect((0, role_refund_permissions_1.canAddRefunds)({ totalAccess: true, canAddRefunds: false })).toBe(true);
+    });
+});

package/dist/serialize-slot.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.serializeSlot = exports.serializeSlotOrderData = void 0;
+const slot_discount_type_enum_1 = require("@escapenavigator/types/dist/slot/enum/slot-discount-type.enum");
 const defailt_rule_1 = require("@escapenavigator/types/dist/slot-rule/defailt-rule");
 const buildRuleSummary = (rule) => {
     const { prepayment, prepaymentType, title, minHoursForBooking, minMinutesForBooking, minHoursForFreeCanceling, cancelationRule, minHoursForFullFine, cancelationAmount, } = rule || defailt_rule_1.defaultRule;
@@ -62,9 +63,16 @@ const serializeSlot = ({ slot, orders = [] }) => ({
     tariff: slot.tariff?.price || slot.tariff || {},
     status: slot.status,
     discount: slot.discount ?? 0,
+    discountType: slot.discountType ?? slot_discount_type_enum_1.SlotDiscountTypeEnum.PERCENT,
     onlyPhone: slot.onlyPhone ?? false,
     forceOnlineBooking: slot.forceOnlineBooking ?? false,
     ignoreResourceLimit: slot.ignoreResourceLimit ?? false,
+    // Пустой список не отдаём вообще: `calendar-day` сериализует до 1000
+    // слотов за раз, и `"excludedUpsellingIds":[]` на каждом — это лишние
+    // десятки килобайт в ответе ради информации «ничего не запрещено».
+    excludedUpsellingIds: slot.excludedUpsellingIds?.length
+        ? slot.excludedUpsellingIds
+        : undefined,
     breakReason: slot.breakReason ?? null,
     availableTeams: slot.availableTeams ?? null,
     numSeatsAvailable: slot.numSeatsAvailable ?? slot.availablePlayers ?? 0,

package/dist/slot-representative-price.d.ts

@@ -1,7 +1,9 @@
+import { SlotDiscountTypeEnum } from '@escapenavigator/types/dist/slot/enum/slot-discount-type.enum';
 type SlotPriceSource = {
     tariff?: unknown;
     basePrice?: number;
     discount?: number;
+    discountType?: SlotDiscountTypeEnum | string | null;
 };
 /**
  * Плоская карта цен из тарифа слота.
@@ -10,6 +12,14 @@ type SlotPriceSource = {
 export declare const getTariffPriceMap: (tariff: unknown) => Record<string, number>;
 /** Минимальная положительная цена из тарифа (без скидки слота). */
 export declare const getTariffBasePrice: (tariff: unknown) => number | null;
+/**
+ * Цена «от» до и после скидки слота. Обе величины нужны расписанию: одну
+ * показываем, вторую зачёркиваем.
+ */
+export declare const getSlotRepresentativePrices: (slot: SlotPriceSource) => {
+    base: number;
+    discounted: number;
+} | null;
 /** Цена «от» для слота в расписании (с учётом скидки слота). */
 export declare const getSlotRepresentativePrice: (slot: SlotPriceSource) => number | null;
 export {};

package/dist/slot-representative-price.js

@@ -1,12 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getSlotRepresentativePrice = exports.getTariffBasePrice = exports.getTariffPriceMap = void 0;
-const applySlotDiscount = (base, discount) => {
-    const value = discount || 0;
-    if (!value)
-        return base;
-    return base - Math.floor((base / 10000) * value);
-};
+exports.getSlotRepresentativePrice = exports.getSlotRepresentativePrices = exports.getTariffBasePrice = exports.getTariffPriceMap = void 0;
+const get_slot_discount_amount_1 = require("./get-slot-discount-amount");
 /**
  * Плоская карта цен из тарифа слота.
  * Принимает и `{ id, price: { "2": 1500 } }` (листинг), и `{ "2": 1500 }` (/slots/details).
@@ -36,13 +31,25 @@ const getTariffBasePrice = (tariff) => {
     return null;
 };
 exports.getTariffBasePrice = getTariffBasePrice;
-/** Цена «от» для слота в расписании (с учётом скидки слота). */
-const getSlotRepresentativePrice = (slot) => {
+/**
+ * Цена «от» до и после скидки слота. Обе величины нужны расписанию: одну
+ * показываем, вторую зачёркиваем.
+ */
+const getSlotRepresentativePrices = (slot) => {
     const base = typeof slot.basePrice === 'number' && slot.basePrice > 0
         ? slot.basePrice
         : (0, exports.getTariffBasePrice)(slot.tariff);
     if (base == null)
         return null;
-    return applySlotDiscount(base, slot.discount);
+    const discountAmount = (0, get_slot_discount_amount_1.getSlotDiscountAmount)({
+        price: base,
+        discount: slot.discount,
+        discountType: slot.discountType,
+        rounding: 'floor',
+    });
+    return { base, discounted: base - discountAmount };
 };
+exports.getSlotRepresentativePrices = getSlotRepresentativePrices;
+/** Цена «от» для слота в расписании (с учётом скидки слота). */
+const getSlotRepresentativePrice = (slot) => (0, exports.getSlotRepresentativePrices)(slot)?.discounted ?? null;
 exports.getSlotRepresentativePrice = getSlotRepresentativePrice;

package/dist/tz-date.d.ts

@@ -6,7 +6,7 @@ type ToUTC = {
     offset?: number;
 };
 type ToZoned = {
-    timeZone: Timezone;
+    timeZone?: Timezone;
     date: string;
     offset?: number;
     format?: string;

package/dist/tz-date.js

@@ -14,9 +14,14 @@ exports.convertDateToZonedDate = convertDateToZonedDate;
 const convertUTCDateToZonedDate = ({ date, timeZone, offset = 0, format = 'dd.MM.yyyy, HH:mm', showTZ = false, }) => {
     if (!date)
         return '';
-    const d = (0, date_1.utcToZonedTime)(date, timeZone);
+    // Часового пояса может не быть (удалённая локация заказа — см.
+    // getOrderCancelationDate): на undefined `utcToZonedTime` даёт Invalid
+    // Date, а `formatDate` на нём кидает и роняет весь экран. Показываем
+    // время в UTC и честно подписываем его в `showTZ`.
+    const tz = timeZone || 'UTC';
+    const d = (0, date_1.utcToZonedTime)(date, tz);
     const dt = (0, date_1.addHours)(d, offset);
     const res = (0, date_1.formatDate)(dt, format);
-    return showTZ ? `${res} (${timeZone})` : res;
+    return showTZ ? `${res} (${tz})` : res;
 };
 exports.convertUTCDateToZonedDate = convertUTCDateToZonedDate;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "2.0.35",
+  "version": "2.0.39",
   "publishConfig": {
     "access": "public"
   },
@@ -14,7 +14,7 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^2.0.33",
+    "@escapenavigator/types": "^2.0.37",
     "axios": "^0.21.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
@@ -29,5 +29,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "2c47385d8e152226b70a9b11213eb511b671ad0f"
+  "gitHead": "a5a2b7072d29242e6477d13cf07022fca9862b8c"
 }