@escapenavigator/utils 2.0.39 → 2.0.41

package/dist/booking-page-url/index.d.ts

@@ -19,6 +19,18 @@ export type BuildBookingPageUrlOptions = {
     lang?: string;
     tracking?: BookingTrackingParams;
     consent?: BookingConsentParams;
+    /**
+     * Промокод, который виджет применит сам при открытии страницы
+     * (`PromocodeProvider` читает `?promocode=` и валидирует его через
+     * `resolvePromocode`). Нужен для писем: клиенту не приходится
+     * копировать код руками — он уже в корзине.
+     */
+    promocode?: string;
+    /**
+     * Дата, на которой откроется расписание (`YYYY-MM-DD`). Читается
+     * провайдером слотов виджета как `?initialDate=`.
+     */
+    initialDate?: string;
 };
 /**
  * Собирает tracking-параметры из URLSearchParams (или строки query).

package/dist/booking-page-url/index.js

@@ -67,7 +67,7 @@ function appendBookingParamsToUrl(baseUrl, options) {
  * `{ordersDomain}/booking/{widgetUuid}` + testMode/lang/tracking/consent.
  */
 function buildBookingPageUrl(options) {
-    const { ordersDomain, widgetUuid, testMode, lang, tracking, consent } = options;
+    const { ordersDomain, widgetUuid, testMode, lang, tracking, consent, promocode, initialDate } = options;
     const base = `${normalizeOrdersDomain(ordersDomain)}/booking/${encodeURIComponent(widgetUuid)}`;
     const url = new URL(base);
     if (testMode) {
@@ -76,6 +76,12 @@ function buildBookingPageUrl(options) {
     if (lang) {
         url.searchParams.set('lang', lang);
     }
+    if (promocode?.trim()) {
+        url.searchParams.set('promocode', promocode.trim());
+    }
+    if (initialDate?.trim()) {
+        url.searchParams.set('initialDate', initialDate.trim());
+    }
     return appendBookingParamsToUrl(url.toString(), { tracking, consent });
 }
 /**

package/dist/booking-page-url/index.test.js

@@ -32,4 +32,29 @@ describe('buildBookingPageUrl', () => {
         });
         expect(url).toBe('https://orders.escapenavigator.com/booking/W123?testMode=true&lang=de&utm_medium=email');
     });
+    it('carries the promocode so the widget applies it on open', () => {
+        const url = (0, index_1.buildBookingPageUrl)({
+            ordersDomain: 'https://orders.example.com',
+            widgetUuid: 'W1',
+            promocode: '  SUMMER25  ',
+        });
+        expect(url).toContain('promocode=SUMMER25');
+    });
+    it('carries initialDate to preselect the schedule day', () => {
+        const url = (0, index_1.buildBookingPageUrl)({
+            ordersDomain: 'https://orders.example.com',
+            widgetUuid: 'W1',
+            initialDate: '2026-09-01',
+        });
+        expect(url).toContain('initialDate=2026-09-01');
+    });
+    it('omits blank promocode and initialDate', () => {
+        const url = (0, index_1.buildBookingPageUrl)({
+            ordersDomain: 'https://orders.example.com',
+            widgetUuid: 'W1',
+            promocode: '   ',
+            initialDate: '',
+        });
+        expect(url).toBe('https://orders.example.com/booking/W1');
+    });
 });

package/dist/email-builder/placeholders.d.ts

@@ -15,7 +15,7 @@
  * при конверсии (если ключ не в реестре, токен `{X}` оставляется в
  * тексте как есть — это безопаснее, чем терять данные).
  */
-export declare const KNOWN_PLACEHOLDERS: readonly ["clientName", "childName", "questroomTitle", "promocode", "discount", "validity", "website", "howToFindLocation", "importantInfo", "prepareInfo", "gameResult", "additionalInfo", "phone", "date", "photos", "servicesList", "address", "profileTitle", "birthday", "currency", "orderDetailsHtml", "bookingManagementLink", "questroomPhoto", "code", "language", "players", "mode", "comment"];
+export declare const KNOWN_PLACEHOLDERS: readonly ["clientName", "childName", "questroomTitle", "promocode", "discount", "validity", "website", "howToFindLocation", "importantInfo", "prepareInfo", "gameResult", "additionalInfo", "phone", "date", "photos", "servicesList", "address", "profileTitle", "birthday", "currency", "orderDetailsHtml", "bookingManagementLink", "bookingDeepLink", "questroomPhoto", "code", "language", "players", "mode", "comment"];
 export type KnownPlaceholder = (typeof KNOWN_PLACEHOLDERS)[number];
 export declare const isKnownPlaceholder: (id: string) => id is KnownPlaceholder;
 /**

package/dist/email-builder/placeholders.js

@@ -48,6 +48,7 @@ exports.KNOWN_PLACEHOLDERS = [
     'currency',
     'orderDetailsHtml',
     'bookingManagementLink',
+    'bookingDeepLink',
     'questroomPhoto',
     'code',
     'language',

package/dist/index.d.ts

@@ -37,6 +37,7 @@ export * from './serialize-slot';
 export * from './slot-representative-price';
 export * from './strip-html-tags';
 export * from './tz-date';
+export * from './upselling-lead-time';
 export * from './user-session-permissions';
 export * from './utm-touchpoints';
 export * from './validate-by-dto';

package/dist/index.js

@@ -53,6 +53,7 @@ __exportStar(require("./serialize-slot"), exports);
 __exportStar(require("./slot-representative-price"), exports);
 __exportStar(require("./strip-html-tags"), exports);
 __exportStar(require("./tz-date"), exports);
+__exportStar(require("./upselling-lead-time"), exports);
 __exportStar(require("./user-session-permissions"), exports);
 __exportStar(require("./utm-touchpoints"), exports);
 __exportStar(require("./validate-by-dto"), exports);

package/dist/serialize-slot.js

@@ -70,9 +70,7 @@ const serializeSlot = ({ slot, orders = [] }) => ({
     // Пустой список не отдаём вообще: `calendar-day` сериализует до 1000
     // слотов за раз, и `"excludedUpsellingIds":[]` на каждом — это лишние
     // десятки килобайт в ответе ради информации «ничего не запрещено».
-    excludedUpsellingIds: slot.excludedUpsellingIds?.length
-        ? slot.excludedUpsellingIds
-        : undefined,
+    excludedUpsellingIds: slot.excludedUpsellingIds?.length ? slot.excludedUpsellingIds : undefined,
     breakReason: slot.breakReason ?? null,
     availableTeams: slot.availableTeams ?? null,
     numSeatsAvailable: slot.numSeatsAvailable ?? slot.availablePlayers ?? 0,

package/dist/upselling-lead-time/index.d.ts

@@ -0,0 +1,36 @@
+type Props = {
+    /** `upsellings.minMinutesBeforeStart`: `0`/пусто — услуга без ограничения. */
+    minMinutesBeforeStart?: number | null;
+    /** Дата слота `yyyy-MM-dd`. */
+    date: string;
+    /** Начало слота `HH:mm`. */
+    start: string;
+    /** Таймзона локации квеста, а не браузера клиента. */
+    timeZone?: string | null;
+    /** Точка отсчёта «сейчас»; параметр ради тестов. */
+    now?: Date;
+};
+/**
+ * Успевает ли клиент заказать доп. услугу онлайн: у услуг с подготовкой
+ * (актёр, торт) венью выставляет запас времени, за который персонал ещё
+ * можно найти.
+ *
+ * Момент старта слота считается строго по таймзоне локации квеста — иначе
+ * клиент из другого часового пояса увидел бы другой набор услуг. Ровно на
+ * границе (осталось точно `minMinutesBeforeStart`) услуга ещё доступна.
+ *
+ * Как и `applyTimingStatus` в slot.service, при неизвестной таймзоне ничего
+ * не запрещаем: тихо потерять услугу из-за orphan-локации хуже, чем отдать
+ * её на пару часов дольше положенного.
+ */
+export declare const isUpsellingLeadTimeSatisfied: ({ minMinutesBeforeStart, date, start, timeZone, now, }: Props) => boolean;
+/**
+ * То же правило для вызовов, у которых момент старта игры уже посчитан в UTC
+ * (`orders.utcDate`), — тогда таймзона локации не нужна.
+ */
+export declare const isUpsellingLeadTimeSatisfiedAt: ({ minMinutesBeforeStart, slotStartUtc, now, }: {
+    minMinutesBeforeStart?: number | null;
+    slotStartUtc: Date | string;
+    now?: Date;
+}) => boolean;
+export {};

package/dist/upselling-lead-time/index.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUpsellingLeadTimeSatisfiedAt = exports.isUpsellingLeadTimeSatisfied = void 0;
+const date_timezone_1 = require("../date-timezone");
+const MINUTE_IN_MS = 60 * 1000;
+/**
+ * Успевает ли клиент заказать доп. услугу онлайн: у услуг с подготовкой
+ * (актёр, торт) венью выставляет запас времени, за который персонал ещё
+ * можно найти.
+ *
+ * Момент старта слота считается строго по таймзоне локации квеста — иначе
+ * клиент из другого часового пояса увидел бы другой набор услуг. Ровно на
+ * границе (осталось точно `minMinutesBeforeStart`) услуга ещё доступна.
+ *
+ * Как и `applyTimingStatus` в slot.service, при неизвестной таймзоне ничего
+ * не запрещаем: тихо потерять услугу из-за orphan-локации хуже, чем отдать
+ * её на пару часов дольше положенного.
+ */
+const isUpsellingLeadTimeSatisfied = ({ minMinutesBeforeStart, date, start, timeZone, now = new Date(), }) => {
+    if (!minMinutesBeforeStart || minMinutesBeforeStart <= 0)
+        return true;
+    if (!timeZone)
+        return true;
+    // Локальные компоненты даты сохраняются при переводе в UTC ниже; проверяем
+    // до конвертации, потому что на невалидной дате она бросает, а фильтр
+    // услуг вызывается на рендере виджета.
+    const wallClock = new Date(`${date}T${start}`);
+    if (Number.isNaN(wallClock.getTime()))
+        return true;
+    return (0, exports.isUpsellingLeadTimeSatisfiedAt)({
+        minMinutesBeforeStart,
+        slotStartUtc: (0, date_timezone_1.zonedTimeToUtc)(wallClock, timeZone),
+        now,
+    });
+};
+exports.isUpsellingLeadTimeSatisfied = isUpsellingLeadTimeSatisfied;
+/**
+ * То же правило для вызовов, у которых момент старта игры уже посчитан в UTC
+ * (`orders.utcDate`), — тогда таймзона локации не нужна.
+ */
+const isUpsellingLeadTimeSatisfiedAt = ({ minMinutesBeforeStart, slotStartUtc, now = new Date(), }) => {
+    if (!minMinutesBeforeStart || minMinutesBeforeStart <= 0)
+        return true;
+    const slotStartUtcMs = new Date(slotStartUtc).getTime();
+    if (!Number.isFinite(slotStartUtcMs))
+        return true;
+    return now.getTime() <= slotStartUtcMs - minMinutesBeforeStart * MINUTE_IN_MS;
+};
+exports.isUpsellingLeadTimeSatisfiedAt = isUpsellingLeadTimeSatisfiedAt;

package/dist/upselling-lead-time/index.test.d.ts

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

package/dist/upselling-lead-time/index.test.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+// Игра 20 августа в 18:00 по Москве = 15:00 UTC.
+const slot = { date: '2026-08-20', start: '18:00', timeZone: 'Europe/Moscow' };
+const at = (iso) => new Date(iso);
+describe('isUpsellingLeadTimeSatisfied', () => {
+    it('услуга без запаса времени доступна всегда', () => {
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({
+            ...slot,
+            minMinutesBeforeStart: 0,
+            now: at('2026-08-20T14:59:00Z'),
+        })).toBe(true);
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({ ...slot, now: at('2026-08-20T14:59:00Z') })).toBe(true);
+    });
+    it('за 48 часов до игры услуга ещё доступна', () => {
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({
+            ...slot,
+            minMinutesBeforeStart: 48 * 60,
+            now: at('2026-08-18T10:00:00Z'),
+        })).toBe(true);
+    });
+    it('ровно на границе услуга ещё доступна, минутой позже — нет', () => {
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({
+            ...slot,
+            minMinutesBeforeStart: 48 * 60,
+            now: at('2026-08-18T15:00:00Z'),
+        })).toBe(true);
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({
+            ...slot,
+            minMinutesBeforeStart: 48 * 60,
+            now: at('2026-08-18T15:01:00Z'),
+        })).toBe(false);
+    });
+    it('считает от таймзоны локации, а не от времени клиента', () => {
+        // Клиент в Магадане (UTC+11) видит на часах 02:00 21 августа, но до
+        // московской игры остаётся меньше 48 часов — услуга недоступна.
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({
+            ...slot,
+            timeZone: 'Asia/Magadan',
+            minMinutesBeforeStart: 48 * 60,
+            now: at('2026-08-18T15:00:00Z'),
+        })).toBe(false);
+    });
+    it('при неизвестной таймзоне ничего не запрещает', () => {
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({
+            ...slot,
+            timeZone: undefined,
+            minMinutesBeforeStart: 48 * 60,
+            now: at('2026-08-20T14:00:00Z'),
+        })).toBe(true);
+    });
+    it('битую дату слота не превращает в запрет', () => {
+        expect((0, index_1.isUpsellingLeadTimeSatisfied)({
+            ...slot,
+            date: 'не дата',
+            minMinutesBeforeStart: 48 * 60,
+            now: at('2026-08-20T14:00:00Z'),
+        })).toBe(true);
+    });
+});
+describe('isUpsellingLeadTimeSatisfiedAt', () => {
+    const slotStartUtc = '2026-08-20T15:00:00.000Z';
+    it('сравнивает с уже посчитанным UTC-моментом старта', () => {
+        expect((0, index_1.isUpsellingLeadTimeSatisfiedAt)({
+            minMinutesBeforeStart: 120,
+            slotStartUtc,
+            now: at('2026-08-20T13:00:00Z'),
+        })).toBe(true);
+        expect((0, index_1.isUpsellingLeadTimeSatisfiedAt)({
+            minMinutesBeforeStart: 120,
+            slotStartUtc,
+            now: at('2026-08-20T13:00:01Z'),
+        })).toBe(false);
+    });
+    it('после старта игры услуга с запасом времени недоступна', () => {
+        expect((0, index_1.isUpsellingLeadTimeSatisfiedAt)({
+            minMinutesBeforeStart: 30,
+            slotStartUtc,
+            now: at('2026-08-21T00:00:00Z'),
+        })).toBe(false);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "2.0.39",
+  "version": "2.0.41",
   "publishConfig": {
     "access": "public"
   },
@@ -14,7 +14,7 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^2.0.37",
+    "@escapenavigator/types": "^2.0.39",
     "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": "a5a2b7072d29242e6477d13cf07022fca9862b8c"
+  "gitHead": "e5b9a5cb3f13b9e80c896a40ac0cdde88ff9b7b0"
 }