@escapenavigator/utils 2.0.15 → 2.0.17

package/dist/city-quest-content.d.ts

@@ -0,0 +1,8 @@
+import type { CityQuestContent, CityQuestRouteEvent, CityQuestStop, LocalizedText } from '@escapenavigator/types/dist/city-quest/city-quest-content';
+/** Patch one stop by id; returns new content reference for jsonb saves. */
+export declare const patchQuestStop: (content: CityQuestContent, stopId: string, patch: Partial<CityQuestStop>) => CityQuestContent;
+/** Patch one route event by id. */
+export declare const patchQuestRouteEvent: (content: CityQuestContent, eventId: string, patch: Partial<CityQuestRouteEvent>) => CityQuestContent;
+/** Add a simple message route event after a stop. */
+export declare const addMessageRouteEvent: (content: CityQuestContent, triggerAfterStopId: string, text: LocalizedText, from?: string) => CityQuestContent;
+export declare const removeQuestRouteEvent: (content: CityQuestContent, eventId: string) => CityQuestContent;

package/dist/city-quest-content.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removeQuestRouteEvent = exports.addMessageRouteEvent = exports.patchQuestRouteEvent = exports.patchQuestStop = void 0;
+/** Patch one stop by id; returns new content reference for jsonb saves. */
+const patchQuestStop = (content, stopId, patch) => ({
+    ...content,
+    stops: (content.stops || []).map((stop) => (stop.id === stopId ? { ...stop, ...patch } : stop)),
+});
+exports.patchQuestStop = patchQuestStop;
+/** Patch one route event by id. */
+const patchQuestRouteEvent = (content, eventId, patch) => ({
+    ...content,
+    route_events: (content.route_events || []).map((event) => event.id === eventId ? { ...event, ...patch } : event),
+});
+exports.patchQuestRouteEvent = patchQuestRouteEvent;
+/** Add a simple message route event after a stop. */
+const addMessageRouteEvent = (content, triggerAfterStopId, text, from) => {
+    const id = `re_${Date.now().toString(36)}`;
+    const event = {
+        id,
+        trigger_after_stop: triggerAfterStopId,
+        type: 'message',
+        content: { from, text },
+    };
+    return {
+        ...content,
+        route_events: [...(content.route_events || []), event],
+    };
+};
+exports.addMessageRouteEvent = addMessageRouteEvent;
+const removeQuestRouteEvent = (content, eventId) => ({
+    ...content,
+    route_events: (content.route_events || []).filter((e) => e.id !== eventId),
+});
+exports.removeQuestRouteEvent = removeQuestRouteEvent;

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

@@ -15,6 +15,10 @@ const formatPromocodeDiscount = (type, discount, currency, clientDescription) =>
     if (type === promocode_type_enum_1.PromocodeTypeEnum.FIXED) {
         return (0, format_amount_1.formatAmount)(discount, currency);
     }
+    // Флеш цена: discount — итоговая цена за игроков, показываем «= 99,99 €».
+    if (type === promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE) {
+        return `= ${(0, format_amount_1.formatAmount)(discount, currency)}`;
+    }
     return `${discount / 100}%`;
 };
 exports.formatPromocodeDiscount = formatPromocodeDiscount;

package/dist/get-promocode-discount.d.ts

@@ -1,10 +1,20 @@
 import { PromocodeTypeEnum } from '@escapenavigator/types/dist/promocode/emun/promocode-type.enum';
-export declare const getPromocodeDiscount: ({ slotId, slotDiscount, total, promocodeType, promocodeDiscount, price, players, children, }: {
+export declare const getPromocodeDiscount: ({ slotId, slotDiscount, slotDiscountAmount, total, promocodeType, promocodeDiscount, price, players, children, }: {
     slotId: number;
     children?: number;
     total: number;
     players: number;
+    /**
+     * Легаси-параметр: часть вызовов передаёт сумму, часть — ставку в bps.
+     * Используется только процентными типами (вычитание из total).
+     */
     slotDiscount: number;
+    /**
+     * Скидка слота строго как СУММА в минорных единицах. Нужна только для
+     * FLASH_PRICE — флеш-цена поглощает слот-скидку, поэтому вычитаем её из
+     * базовой цены за игроков, чтобы итог за игроков был ровно равен флеш-цене.
+     */
+    slotDiscountAmount?: number;
     price: Record<any, any>;
     promocodeDiscount: number;
     promocodeType: PromocodeTypeEnum;

package/dist/get-promocode-discount.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getPromocodeDiscount = void 0;
 const promocode_type_enum_1 = require("@escapenavigator/types/dist/promocode/emun/promocode-type.enum");
 const get_players_price_1 = require("./get-players-price");
-const getPromocodeDiscount = ({ slotId, slotDiscount, total, promocodeType, promocodeDiscount, price, players, children = 0, }) => {
+const getPromocodeDiscount = ({ slotId, slotDiscount, slotDiscountAmount = 0, total, promocodeType, promocodeDiscount, price, players, children = 0, }) => {
     const orderTotal = slotId ? total - slotDiscount : total;
     let amount = 0;
     if (promocodeType === promocode_type_enum_1.PromocodeTypeEnum.PROMOTIONAL)
@@ -14,6 +14,15 @@ const getPromocodeDiscount = ({ slotId, slotDiscount, total, promocodeType, prom
         amount = Math.floor(((0, get_players_price_1.getPlayersPrice)({ price, children, players }) / 10000) * promocodeDiscount);
     if (promocodeType === promocode_type_enum_1.PromocodeTypeEnum.PERCENT_ALL_SUM)
         amount = Math.floor((orderTotal / 10000) * promocodeDiscount);
+    if (promocodeType === promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE) {
+        // «Флеш цена»: promocodeDiscount хранит итоговую цену за игроков.
+        // Скидка = базовая цена за игроков (за вычетом слот-скидки) − флеш-цена.
+        // Если базовая цена уже ниже флеш-цены — скидки нет (не удорожаем).
+        // Доп. услуги и наценка на оплату в формуле не участвуют — идут сверху.
+        const playersPrice = (0, get_players_price_1.getPlayersPrice)({ price, children, players });
+        const playersPriceAfterSlot = playersPrice - (slotId ? slotDiscountAmount : 0);
+        amount = Math.max(0, playersPriceAfterSlot - promocodeDiscount);
+    }
     return amount;
 };
 exports.getPromocodeDiscount = getPromocodeDiscount;

package/dist/get-promocode-discount.spec.d.ts

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

package/dist/get-promocode-discount.spec.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const promocode_type_enum_1 = require("@escapenavigator/types/dist/promocode/emun/promocode-type.enum");
+const get_promocode_discount_1 = require("./get-promocode-discount");
+// Тариф: 2 игрока — 100.00, 4 игрока — 180.00, ребёнок — 20.00 (minor units).
+const price = { 2: 10000, 4: 18000, child: 2000 };
+const base = {
+    slotId: 1,
+    slotDiscount: 0,
+    slotDiscountAmount: 0,
+    total: 10000,
+    players: 2,
+    children: 0,
+    price,
+};
+describe('getPromocodeDiscount / FLASH_PRICE', () => {
+    it('скидка = цена за игроков − флеш-цена', () => {
+        // 2 игрока = 100.00, флеш 79.99 → скидка 20.01
+        const amount = (0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE,
+            promocodeDiscount: 7999,
+        });
+        expect(amount).toBe(2001);
+    });
+    it('пересчитывается от кол-ва игроков (доп. услуги не участвуют)', () => {
+        // 4 игрока = 180.00; total включает допы, но не влияет на флеш
+        const amount = (0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            players: 4,
+            total: 25000,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE,
+            promocodeDiscount: 7999,
+        });
+        expect(amount).toBe(18000 - 7999);
+    });
+    it('учитывает детей в базовой цене', () => {
+        // 2 взрослых + 1 ребёнок = 120.00, флеш 99.99 → скидка 20.01
+        const amount = (0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            children: 1,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE,
+            promocodeDiscount: 9999,
+        });
+        expect(amount).toBe(2001);
+    });
+    it('поглощает слот-скидку: итог за игроков ровно = флеш-цене', () => {
+        // 100.00 − слот-скидка 10.00 = 90.00, флеш 79.99 → скидка 10.01
+        const amount = (0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            slotDiscountAmount: 1000,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE,
+            promocodeDiscount: 7999,
+        });
+        expect(amount).toBe(1001);
+    });
+    it('не удорожает заказ: если базовая цена ниже флеш-цены — скидка 0', () => {
+        const amount = (0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE,
+            promocodeDiscount: 12000,
+        });
+        expect(amount).toBe(0);
+    });
+    it('без слота слот-скидка не вычитается', () => {
+        const amount = (0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            slotId: 0,
+            slotDiscountAmount: 1000,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE,
+            promocodeDiscount: 7999,
+        });
+        expect(amount).toBe(2001);
+    });
+    it('не ломает существующие типы', () => {
+        expect((0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.FIXED,
+            promocodeDiscount: 500,
+        })).toBe(500);
+        expect((0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.PERCENT_BASE_SUM,
+            promocodeDiscount: 1500,
+        })).toBe(1500);
+        expect((0, get_promocode_discount_1.getPromocodeDiscount)({
+            ...base,
+            promocodeType: promocode_type_enum_1.PromocodeTypeEnum.PROMOTIONAL,
+            promocodeDiscount: 1500,
+        })).toBe(0);
+    });
+});

package/dist/google-places-nonquest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Классификатор «это точно не квест» по типам Google Places + имени.
+ *
+ * Дискавери ищет Text Search'ем «escape room …», и в выдачу попадает много
+ * мусора: отели, рестораны, боулинги, музеи, магазины, детсады и т.п. Google
+ * не отдаёт отдельный тип `escape_room`, поэтому позитивно опознать квест по
+ * типам нельзя — но можно отсеять заведомо-не-квесты.
+ *
+ * Правило намеренно консервативное (лучше пропустить мусор, чем выкинуть
+ * настоящий квест): место считается «не квест», только если у него есть
+ * жёстко-негативный тип, при этом НЕТ ни одного «квест-правдоподобного» типа
+ * И имя не содержит ключевых слов (escape/quest/VR/perform/room …).
+ */
+/**
+ * `true`, если место по типам Google заведомо не эскейп-рум / VR / перформанс.
+ * При отсутствии типов или наличии квест-сигналов возвращает `false`
+ * (оставляем на ручную модерацию).
+ */
+export declare const isNonQuestByGoogleTypes: (types?: string[] | null, name?: string | null) => boolean;

package/dist/google-places-nonquest.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * Классификатор «это точно не квест» по типам Google Places + имени.
+ *
+ * Дискавери ищет Text Search'ем «escape room …», и в выдачу попадает много
+ * мусора: отели, рестораны, боулинги, музеи, магазины, детсады и т.п. Google
+ * не отдаёт отдельный тип `escape_room`, поэтому позитивно опознать квест по
+ * типам нельзя — но можно отсеять заведомо-не-квесты.
+ *
+ * Правило намеренно консервативное (лучше пропустить мусор, чем выкинуть
+ * настоящий квест): место считается «не квест», только если у него есть
+ * жёстко-негативный тип, при этом НЕТ ни одного «квест-правдоподобного» типа
+ * И имя не содержит ключевых слов (escape/quest/VR/perform/room …).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isNonQuestByGoogleTypes = void 0;
+/**
+ * Типы, которые встречаются у настоящих квестов / VR / иммерсивных
+ * перформансов. Если хоть один присутствует — место не отсеиваем.
+ */
+const ESCAPE_PLAUSIBLE_TYPES = new Set([
+    'amusement_center',
+    'amusement_park',
+    'video_arcade',
+    'escape_room',
+]);
+/**
+ * Типы, которые у эскейп-румов / VR / перформансов практически не встречаются.
+ * Наличие любого из них (при отсутствии `ESCAPE_PLAUSIBLE_TYPES` и ключевых
+ * слов в имени) — сигнал «не квест».
+ *
+ * Намеренно НЕ включены неоднозначные, часто соседствующие с квестами типы:
+ * `point_of_interest`, `establishment`, `tourist_attraction`, `event_venue`,
+ * `sports_activity_location`, `sports_complex`, `tour_agency`, `travel_agency`
+ * и пр. — они остаются на ручную модерацию.
+ */
+const HARD_NEGATIVE_TYPES = new Set([
+    // проживание
+    'lodging',
+    'hotel',
+    'motel',
+    'resort_hotel',
+    'inn',
+    'guest_house',
+    'bed_and_breakfast',
+    'cottage',
+    'campground',
+    'hostel',
+    'extended_stay_hotel',
+    'ski_resort',
+    'farmstay',
+    'private_guest_room',
+    'guest_room',
+    // еда / напитки
+    'restaurant',
+    'meal_takeaway',
+    'meal_delivery',
+    'cafe',
+    'cafeteria',
+    'coffee_shop',
+    'bakery',
+    'bar',
+    'bar_and_grill',
+    'cocktail_bar',
+    'wine_bar',
+    'pub',
+    'night_club',
+    'dessert_shop',
+    'ice_cream_shop',
+    'confectionery',
+    'donut_shop',
+    'sandwich_shop',
+    'fast_food_restaurant',
+    'diner',
+    'deli',
+    'food_court',
+    'tea_house',
+    'juice_shop',
+    'hookah_bar',
+    'lounge_bar',
+    'food_store',
+    // красота / велнес
+    'spa',
+    'sauna',
+    'public_bath',
+    'massage',
+    'massage_spa',
+    'beauty_salon',
+    'hair_salon',
+    'hair_care',
+    'nail_salon',
+    'barber_shop',
+    'gym',
+    'fitness_center',
+    'swimming_pool',
+    'wellness_center',
+    'yoga_studio',
+    'tanning_studio',
+    // ритейл
+    'store',
+    'shopping_mall',
+    'supermarket',
+    'grocery_store',
+    'convenience_store',
+    'department_store',
+    'market',
+    'wholesaler',
+    // культура / достопримечательности (не квест)
+    'museum',
+    'history_museum',
+    'art_gallery',
+    'historical_landmark',
+    'historical_place',
+    'castle',
+    'monument',
+    'church',
+    'place_of_worship',
+    'mosque',
+    'synagogue',
+    'hindu_temple',
+    'cemetery',
+    'library',
+    // образование
+    'school',
+    'preschool',
+    'primary_school',
+    'secondary_school',
+    'university',
+    'child_care_agency',
+    'educational_institution',
+    // медицина
+    'hospital',
+    'doctor',
+    'dentist',
+    'pharmacy',
+    'drugstore',
+    'clinic',
+    'veterinary_care',
+    'physiotherapist',
+    'medical_lab',
+    // авто
+    'gas_station',
+    'car_repair',
+    'car_dealer',
+    'car_wash',
+    'car_rental',
+    'parking',
+    'electric_vehicle_charging_station',
+    // офис / госуслуги / сервисы
+    'government_office',
+    'local_government_office',
+    'city_hall',
+    'courthouse',
+    'embassy',
+    'police',
+    'fire_station',
+    'post_office',
+    'coworking_space',
+    'corporate_office',
+    'lawyer',
+    'accounting',
+    'insurance_agency',
+    'bank',
+    'atm',
+    'real_estate_agency',
+    'consultant',
+    'manufacturer',
+    'moving_company',
+    'storage',
+    'plumber',
+    'electrician',
+    // природа (не квест)
+    'hiking_area',
+    'farm',
+    'park',
+    'national_park',
+    // специфический спорт / развлечения (не квест / VR / перформанс)
+    'bowling_alley',
+    'miniature_golf_course',
+    'go_karting_venue',
+    'race_course',
+    'golf_course',
+    'paintball_center',
+    'tennis_court',
+    'indoor_playground',
+    'playground',
+]);
+/**
+ * Ключевые слова в имени, которые страхуют от ложного отсева: если Google
+ * ошибочно навесил на квест тип вроде `night_club`/`cafe`/`bar`, но в названии
+ * есть явный маркер — оставляем на модерацию.
+ */
+const QUEST_NAME_HINT = /(escape|quest|квест|puzzle|mystery|riddle|virtual reality|immersi|иммерс|перформанс|perform|sandbox|zero latency|fluchtraum|fluchtspiel|exit game|room|вирт|\bvr\b)/i;
+/** Динамические негативные типы вида `italian_restaurant`, `toy_store`, `gift_shop`. */
+const HARD_NEGATIVE_SUFFIX = /_(restaurant|store|shop)$/;
+const isHardNegativeType = (type) => HARD_NEGATIVE_TYPES.has(type) || HARD_NEGATIVE_SUFFIX.test(type);
+/**
+ * `true`, если место по типам Google заведомо не эскейп-рум / VR / перформанс.
+ * При отсутствии типов или наличии квест-сигналов возвращает `false`
+ * (оставляем на ручную модерацию).
+ */
+const isNonQuestByGoogleTypes = (types, name) => {
+    if (!types || types.length === 0)
+        return false;
+    if (name && QUEST_NAME_HINT.test(name))
+        return false;
+    if (types.some((type) => ESCAPE_PLAUSIBLE_TYPES.has(type)))
+        return false;
+    return types.some(isHardNegativeType);
+};
+exports.isNonQuestByGoogleTypes = isNonQuestByGoogleTypes;

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export * from './agreement-config';
 export * from './booking-lead-time';
 export * from './booking-page-url';
+export * from './city-quest-content';
 export * from './classify-api-error';
 export * from './convert-hhmm-to-minutes';
 export * from './convert-minutes-to-hhmm';
@@ -11,10 +12,11 @@ export * from './format-flex-duration-label';
 export * from './functional-popover-panel-style';
 export * from './get-documents-links';
 export * from './get-full-name';
-export * from './google-places-link-warnings';
 export * from './get-handled-error-message';
 export * from './get-order-cancelation-state';
 export * from './get-service-error';
+export * from './google-places-link-warnings';
+export * from './google-places-nonquest';
 export * from './image-url';
 export * from './is-axios-error';
 export * from './is-network-error';
@@ -26,6 +28,7 @@ export * from './promocode-nominal-rules';
 export * from './redirect';
 export * from './role-chat-permissions';
 export * from './role-export-permissions';
+export * from './route-warnings';
 export * from './serialize-record';
 export * from './serialize-slot';
 export * from './slot-representative-price';

package/dist/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./agreement-config"), exports);
 __exportStar(require("./booking-lead-time"), exports);
 __exportStar(require("./booking-page-url"), exports);
+__exportStar(require("./city-quest-content"), exports);
 __exportStar(require("./classify-api-error"), exports);
 __exportStar(require("./convert-hhmm-to-minutes"), exports);
 __exportStar(require("./convert-minutes-to-hhmm"), exports);
@@ -27,10 +28,11 @@ __exportStar(require("./format-flex-duration-label"), exports);
 __exportStar(require("./functional-popover-panel-style"), exports);
 __exportStar(require("./get-documents-links"), exports);
 __exportStar(require("./get-full-name"), exports);
-__exportStar(require("./google-places-link-warnings"), exports);
 __exportStar(require("./get-handled-error-message"), exports);
 __exportStar(require("./get-order-cancelation-state"), exports);
 __exportStar(require("./get-service-error"), exports);
+__exportStar(require("./google-places-link-warnings"), exports);
+__exportStar(require("./google-places-nonquest"), exports);
 __exportStar(require("./image-url"), exports);
 __exportStar(require("./is-axios-error"), exports);
 __exportStar(require("./is-network-error"), exports);
@@ -42,6 +44,7 @@ __exportStar(require("./promocode-nominal-rules"), exports);
 __exportStar(require("./redirect"), exports);
 __exportStar(require("./role-chat-permissions"), exports);
 __exportStar(require("./role-export-permissions"), exports);
+__exportStar(require("./route-warnings"), exports);
 __exportStar(require("./serialize-record"), exports);
 __exportStar(require("./serialize-slot"), exports);
 __exportStar(require("./slot-representative-price"), exports);

package/dist/route-warnings.d.ts

@@ -0,0 +1,30 @@
+export type RoutePoint = {
+    lat: number;
+    lng: number;
+};
+export type NeighborDistanceWarning = {
+    fromIndex: number;
+    toIndex: number;
+    distanceKm: number;
+    level: 'yellow' | 'red';
+};
+export type RouteWarningsResult = {
+    neighborWarnings: NeighborDistanceWarning[];
+    sequenceWarning: boolean;
+    totalDistanceKm: number;
+    /** Rough walking time in minutes (distance @ 4 km/h + 8 min per stop). */
+    estimatedMinutes: number;
+    nearestNeighborDistanceKm: number;
+};
+/** Haversine distance in kilometres. */
+export declare const haversineKm: (a: RoutePoint, b: RoutePoint) => number;
+/** Greedy nearest-neighbor tour length starting at index 0. */
+export declare const nearestNeighborLengthKm: (points: RoutePoint[]) => number;
+export declare const analyzeRoute: (points: RoutePoint[]) => RouteWarningsResult;
+/** Soft guidance for story length (not blocking). */
+export declare const ROUTE_SOFT_LIMITS: {
+    minSteps: number;
+    maxSteps: number;
+    minTotalKm: number;
+    maxTotalKm: number;
+};

package/dist/route-warnings.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROUTE_SOFT_LIMITS = exports.analyzeRoute = exports.nearestNeighborLengthKm = exports.haversineKm = void 0;
+const EARTH_RADIUS_KM = 6371;
+const WALK_KMH = 4;
+const MINUTES_PER_STOP = 8;
+const YELLOW_KM = 1;
+const RED_KM = 2;
+const SEQUENCE_RATIO = 1.25;
+const TURNBACK_DEG = 135;
+/** Haversine distance in kilometres. */
+const haversineKm = (a, b) => {
+    const toRad = (deg) => (deg * Math.PI) / 180;
+    const dLat = toRad(b.lat - a.lat);
+    const dLng = toRad(b.lng - a.lng);
+    const lat1 = toRad(a.lat);
+    const lat2 = toRad(b.lat);
+    const h = Math.sin(dLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(dLng / 2) ** 2;
+    return 2 * EARTH_RADIUS_KM * Math.asin(Math.min(1, Math.sqrt(h)));
+};
+exports.haversineKm = haversineKm;
+const bearingDeg = (a, b) => {
+    const toRad = (deg) => (deg * Math.PI) / 180;
+    const toDeg = (rad) => (rad * 180) / Math.PI;
+    const lat1 = toRad(a.lat);
+    const lat2 = toRad(b.lat);
+    const dLng = toRad(b.lng - a.lng);
+    const y = Math.sin(dLng) * Math.cos(lat2);
+    const x = Math.cos(lat1) * Math.sin(lat2) - Math.sin(lat1) * Math.cos(lat2) * Math.cos(dLng);
+    return (toDeg(Math.atan2(y, x)) + 360) % 360;
+};
+const angleDiffDeg = (a, b) => {
+    const d = Math.abs(a - b) % 360;
+    return d > 180 ? 360 - d : d;
+};
+/** Greedy nearest-neighbor tour length starting at index 0. */
+const nearestNeighborLengthKm = (points) => {
+    if (points.length < 2)
+        return 0;
+    const remaining = new Set(points.map((_, i) => i));
+    let current = 0;
+    remaining.delete(0);
+    let total = 0;
+    while (remaining.size) {
+        let best = -1;
+        let bestDist = Infinity;
+        remaining.forEach((idx) => {
+            const d = (0, exports.haversineKm)(points[current], points[idx]);
+            if (d < bestDist) {
+                bestDist = d;
+                best = idx;
+            }
+        });
+        total += bestDist;
+        current = best;
+        remaining.delete(best);
+    }
+    return total;
+};
+exports.nearestNeighborLengthKm = nearestNeighborLengthKm;
+const analyzeRoute = (points) => {
+    const neighborWarnings = [];
+    let totalDistanceKm = 0;
+    for (let i = 0; i < points.length - 1; i++) {
+        const distanceKm = (0, exports.haversineKm)(points[i], points[i + 1]);
+        totalDistanceKm += distanceKm;
+        if (distanceKm > RED_KM) {
+            neighborWarnings.push({
+                fromIndex: i,
+                toIndex: i + 1,
+                distanceKm,
+                level: 'red',
+            });
+        }
+        else if (distanceKm > YELLOW_KM) {
+            neighborWarnings.push({
+                fromIndex: i,
+                toIndex: i + 1,
+                distanceKm,
+                level: 'yellow',
+            });
+        }
+    }
+    const nearestNeighborDistanceKm = (0, exports.nearestNeighborLengthKm)(points);
+    let sequenceWarning = false;
+    if (points.length >= 3 && nearestNeighborDistanceKm > 0) {
+        if (totalDistanceKm / nearestNeighborDistanceKm >= SEQUENCE_RATIO) {
+            sequenceWarning = true;
+        }
+    }
+    if (!sequenceWarning && points.length >= 3) {
+        for (let i = 0; i < points.length - 2; i++) {
+            const b1 = bearingDeg(points[i], points[i + 1]);
+            const b2 = bearingDeg(points[i + 1], points[i + 2]);
+            if (angleDiffDeg(b1, b2) > TURNBACK_DEG) {
+                sequenceWarning = true;
+                break;
+            }
+        }
+    }
+    const estimatedMinutes = Math.round((totalDistanceKm / WALK_KMH) * 60 + points.length * MINUTES_PER_STOP);
+    return {
+        neighborWarnings,
+        sequenceWarning,
+        totalDistanceKm,
+        estimatedMinutes,
+        nearestNeighborDistanceKm,
+    };
+};
+exports.analyzeRoute = analyzeRoute;
+/** Soft guidance for story length (not blocking). */
+exports.ROUTE_SOFT_LIMITS = {
+    minSteps: 6,
+    maxSteps: 12,
+    minTotalKm: 2,
+    maxTotalKm: 4,
+};

package/dist/validate-promocode.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.validatePromocode = validatePromocode;
+/* eslint-disable complexity */
+const promocode_type_enum_1 = require("@escapenavigator/types/dist/promocode/emun/promocode-type.enum");
 const date_1 = require("./date");
 const promocode_error_codes_1 = require("./promocode-error-codes");
 function getWeekdayNumber(date) {
@@ -35,7 +37,12 @@ function validatePromocode({ promocode, players, questroomId, timeZone, orderDat
     else if (promocode.applyings > 0) {
         errors.push({ code: promocode_error_codes_1.PromocodeErrorCode.SINGLE_USE });
     }
-    if (!promocode.canUseWithOtherPromocodes && (otherPromocodes.length || slotDiscount)) {
+    // Флеш-цена поглощает слот-скидку (итог за игроков всегда = флеш-цене),
+    // поэтому скидка слота не считается конфликтом — блокируем только
+    // комбинирование с другими промокодами.
+    const slotDiscountConflict = promocode.type === promocode_type_enum_1.PromocodeTypeEnum.FLASH_PRICE ? 0 : slotDiscount;
+    if (!promocode.canUseWithOtherPromocodes &&
+        (otherPromocodes.length || slotDiscountConflict)) {
         errors.push({ code: promocode_error_codes_1.PromocodeErrorCode.NOT_COMBINABLE_WITH_OTHER_DISCOUNTS });
     }
     if (!promocode.canUseWithOtherCertificates && hasCertificates) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "2.0.15",
+  "version": "2.0.17",
   "publishConfig": {
     "access": "public"
   },
@@ -14,7 +14,7 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^2.0.14",
+    "@escapenavigator/types": "^2.0.16",
     "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": "d88028b791bdfcd2cc529f66db490a4bf7761fdd"
+  "gitHead": "758cd8c4842a26ad44e69154e1263dfd0ad4ad9f"
 }