@escapenavigator/utils 1.10.132 → 1.10.134

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

@@ -0,0 +1,31 @@
+export declare const BOOKING_LEAD_TIME_MINUTE_STEP = 5;
+/** Максимум в селекте «часы» (7 суток). */
+export declare const BOOKING_LEAD_TIME_MAX_HOURS = 168;
+export declare const BOOKING_LEAD_TIME_MAX_MINUTES: number;
+export type BookingLeadTimeParts = {
+    hours: number;
+    minutes: number;
+};
+export declare const roundBookingLeadMinutesToStep: (totalMinutes: number, step?: number) => number;
+export declare const minutesToBookingLeadParts: (totalMinutes: number) => BookingLeadTimeParts;
+export declare const bookingLeadPartsToMinutes: (hours: number, minutes: number) => number;
+export declare const buildBookingLeadHourOptions: () => Array<{
+    key: number;
+    content: number;
+}>;
+export declare const buildBookingLeadMinuteOptions: () => Array<{
+    key: number;
+    content: number;
+}>;
+type RuleLeadTimeLegacy = {
+    blockingMinutes?: number | null;
+    blockingHours?: number | null;
+    minMinutesForBooking?: number | null;
+    minHoursForBooking?: number | null;
+};
+export declare const resolveBlockingMinutes: (rule?: RuleLeadTimeLegacy | null) => number;
+export declare const resolveMinMinutesForBooking: (rule?: RuleLeadTimeLegacy | null) => number;
+type TranslateFn = (key: string, options?: Record<string, unknown>) => string;
+/** Человекочитаемый интервал до начала игры для таблиц и описаний. */
+export declare const formatBookingLeadTime: (totalMinutes: number, t: TranslateFn) => string;
+export {};

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatBookingLeadTime = exports.resolveMinMinutesForBooking = exports.resolveBlockingMinutes = exports.buildBookingLeadMinuteOptions = exports.buildBookingLeadHourOptions = exports.bookingLeadPartsToMinutes = exports.minutesToBookingLeadParts = exports.roundBookingLeadMinutesToStep = exports.BOOKING_LEAD_TIME_MAX_MINUTES = exports.BOOKING_LEAD_TIME_MAX_HOURS = exports.BOOKING_LEAD_TIME_MINUTE_STEP = void 0;
+exports.BOOKING_LEAD_TIME_MINUTE_STEP = 5;
+/** Максимум в селекте «часы» (7 суток). */
+exports.BOOKING_LEAD_TIME_MAX_HOURS = 168;
+exports.BOOKING_LEAD_TIME_MAX_MINUTES = exports.BOOKING_LEAD_TIME_MAX_HOURS * 60 + 55;
+const roundBookingLeadMinutesToStep = (totalMinutes, step = exports.BOOKING_LEAD_TIME_MINUTE_STEP) => Math.max(0, Math.round(totalMinutes / step) * step);
+exports.roundBookingLeadMinutesToStep = roundBookingLeadMinutesToStep;
+const minutesToBookingLeadParts = (totalMinutes) => {
+    const normalized = (0, exports.roundBookingLeadMinutesToStep)(Math.max(0, totalMinutes || 0));
+    const hours = Math.min(exports.BOOKING_LEAD_TIME_MAX_HOURS, Math.floor(normalized / 60));
+    const minutes = Math.min(55, normalized - hours * 60);
+    return { hours, minutes };
+};
+exports.minutesToBookingLeadParts = minutesToBookingLeadParts;
+const bookingLeadPartsToMinutes = (hours, minutes) => Math.min(exports.BOOKING_LEAD_TIME_MAX_MINUTES, Math.max(0, hours) * 60 + (0, exports.roundBookingLeadMinutesToStep)(minutes));
+exports.bookingLeadPartsToMinutes = bookingLeadPartsToMinutes;
+const buildBookingLeadHourOptions = () => Array.from({ length: exports.BOOKING_LEAD_TIME_MAX_HOURS + 1 }, (_, hours) => ({
+    key: hours,
+    content: hours,
+}));
+exports.buildBookingLeadHourOptions = buildBookingLeadHourOptions;
+const buildBookingLeadMinuteOptions = () => Array.from({ length: 60 / exports.BOOKING_LEAD_TIME_MINUTE_STEP }, (_, i) => {
+    const minutes = i * exports.BOOKING_LEAD_TIME_MINUTE_STEP;
+    return { key: minutes, content: minutes };
+});
+exports.buildBookingLeadMinuteOptions = buildBookingLeadMinuteOptions;
+const resolveBlockingMinutes = (rule) => {
+    if (rule?.blockingMinutes != null)
+        return rule.blockingMinutes;
+    return (rule?.blockingHours ?? 0) * 60;
+};
+exports.resolveBlockingMinutes = resolveBlockingMinutes;
+const resolveMinMinutesForBooking = (rule) => {
+    if (rule?.minMinutesForBooking != null)
+        return rule.minMinutesForBooking;
+    return (rule?.minHoursForBooking ?? 0) * 60;
+};
+exports.resolveMinMinutesForBooking = resolveMinMinutesForBooking;
+/** Человекочитаемый интервал до начала игры для таблиц и описаний. */
+const formatBookingLeadTime = (totalMinutes, t) => {
+    const { hours, minutes } = (0, exports.minutesToBookingLeadParts)(totalMinutes);
+    if (hours > 0 && minutes > 0) {
+        return `${hours} ${t('часов')} ${minutes} ${t('мин')}`;
+    }
+    if (hours > 0) {
+        return `${hours} ${t('часов')}`;
+    }
+    return `${minutes} ${t('мин')}`;
+};
+exports.formatBookingLeadTime = formatBookingLeadTime;

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

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

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

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+describe('booking-lead-time', () => {
+    it('splits and merges hours and minutes', () => {
+        expect((0, index_1.minutesToBookingLeadParts)(90)).toEqual({ hours: 1, minutes: 30 });
+        expect((0, index_1.bookingLeadPartsToMinutes)(1, 30)).toBe(90);
+    });
+    it('rounds to 5-minute step', () => {
+        expect((0, index_1.roundBookingLeadMinutesToStep)(32)).toBe(30);
+        expect((0, index_1.roundBookingLeadMinutesToStep)(33)).toBe(35);
+    });
+    it('resolves minutes with legacy hours fallback', () => {
+        expect((0, index_1.resolveBlockingMinutes)({ blockingHours: 2 })).toBe(120);
+        expect((0, index_1.resolveMinMinutesForBooking)({ minHoursForBooking: 48 })).toBe(2880);
+        expect((0, index_1.resolveBlockingMinutes)({ blockingMinutes: 30, blockingHours: 2 })).toBe(30);
+    });
+});

package/dist/email-builder/from-html.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Конвертер legacy HTML (Quill output, использовавшийся в marketing-
+ * emails: cross-sale, retargeting, up-sale, early-booking, birthday,
+ * birthdayChild, custom-client-booking, scenario-emails) в формат
+ * `EmailContentJsonV2` нового редактора (Maily/TipTap).
+ *
+ * Что обрабатывает:
+ *  - Параграфы `<p>` + переносы `<br>`, схлопывает пустые абзацы
+ *  - Inline-форматирование `<strong>`/`<em>`/`<u>`/`<s>` (marks)
+ *  - Ссылки `<a href="…">` → link-mark
+ *  - Изображения `<img>` → image-нода
+ *  - Плоские плейсхолдеры `{varName}` → `variable`-ноды
+ *  - Maily-style плейсхолдеры `{{varName}}` и `{{varName|"fallback"}}`
+ *    — тоже превращаются в `variable`-ноды (с учётом fallback'а)
+ *  - Управляющие конструкции:
+ *      • `{{#if X}}…{{/if}}` → `section` нода с `showIfKey: 'X'`
+ *      • `{{#manageBooking}}текст{{/manageBooking}}` → `button` нода
+ *        c `isUrlVariable: true, url: 'bookingManagementLink'`
+ *  - Блочные HTML-плейсхолдеры (`orderDetailsHtml`) — выносятся в
+ *    отдельный `htmlCodeBlock` (их значение содержит `<div>`/`<table>`,
+ *    нельзя оставить внутри `<p>`). `servicesList` тут не упоминается:
+ *    функция up-sale-листа в письмах выпилена, см. `isServicesListVariableNode`
+ *  - Цвета/фоны/font-size — выкидываются (как `clearQuill stripColors`)
+ *
+ * Что НЕ обрабатывает (по дизайну):
+ *  - Списки `<ul>`/`<ol>` — в legacy шаблонах не встречаются (Quill в
+ *    нашей конфигурации их не выставлял). Если попадутся — fallback на
+ *    обычный текст; добавим если потребуется по факту.
+ *  - Таблицы — то же самое.
+ *  - Заголовки `<h1>`-`<h6>` — Quill их не использовал в шаблонах.
+ *
+ * Преобразование чистое и идемпотентное: повторный вызов на той же
+ * строке даёт тот же результат.
+ */
+import { EmailContentJsonV2 } from '@escapenavigator/types/dist/email-builder';
+import { BLOCK_HTML_PLACEHOLDERS, isBlockHtmlPlaceholder, isKnownPlaceholder, KNOWN_PLACEHOLDERS, LEGACY_TO_NAMESPACED_ID_MAP, normalizePlaceholderId } from './placeholders';
+/**
+ * Опции конвертера. Все необязательны — поведение «без аргументов»
+ * выдаёт корректный `EmailContentJsonV2` с дефолтной темой и без
+ * логотипа сверху (минимальный набор).
+ */
+export type ConvertLegacyHtmlOptions = {
+    /**
+     * URL логотипа. Если задан — первой нодой в `doc.content` идёт
+     * `image` с точно теми же параметрами, что и `createLogoNode`
+     * (alignment/size/alt). Это нужно, чтобы после миграции v2-доки
+     * визуально совпадали с seed'ом `createDefaultEmailContent` —
+     * пользователь не должен заметить, что шаблон конвертился из
+     * старого формата.
+     */
+    logo?: string | null;
+    /**
+     * Карта человекочитаемых лейблов для `variable.label`. Если для
+     * ключа лейбла нет — будет использоваться сам ID. На бэке миграции
+     * сюда удобно прокидывать резолверовские `declare()` лейблы; на
+     * фронте — `t('crm-crosssales:emailConstructor.<key>.title')`.
+     *
+     * NB: лейблы ищутся по **уже отнормализованному** id (после
+     * `idMap`), так как этот id и попадёт в JSON.
+     */
+    labels?: Readonly<Record<string, string>>;
+    /**
+     * Маппинг flat-id'ов → namespaced. По умолчанию используется
+     * `LEGACY_TO_NAMESPACED_ID_MAP`. Передать `null` чтобы выключить
+     * маппинг (полезно для тестов или ad-hoc конверсий вне marketing-
+     * email пайплайна).
+     */
+    idMap?: Readonly<Record<string, string>> | null;
+    /**
+     * «Зашить» значения некоторых плейсхолдеров прямо в текст вместо
+     * `variable`-ноды. Ключи проверяются **до** маппинга через `idMap`
+     * (по исходному legacy-id, т.к. inline-замена нужна для legacy-
+     * понятий вроде `profileTitle`, у которых больше нет резолвера).
+     *
+     * Пример: `{ profileTitle: 'Escape Quest' }` превратит
+     * `{{profileTitle}}` в обычную текстовую ноду «Escape Quest».
+     * Полезно для бекфилла, когда переменная упразднена, но в шаблонах
+     * она встречается миллион раз — пользователь не должен видеть
+     * пустую дыру или технический id после конверсии.
+     */
+    inlineValues?: Readonly<Record<string, string>>;
+};
+/**
+ * Идемпотентный нормализатор устаревших variable-чипов, у которых
+ * есть выделенное block-представление в Maily:
+ *   - `{photos}` / `{order.photoFirst}` → одна `image`-нода
+ *     (`src = photos`, 200×200);
+ *   - `{servicesList}` → удаляется (функция up-sale-листа в письмах
+ *     выпилена; см. `isServicesListVariableNode` и factory `() => []`
+ *     в `LEGACY_BLOCK_VARIABLE_REPLACERS`).
+ *
+ * Используется во всех трёх каналах:
+ *   - финальный шаг `convertLegacyHtmlToEmailContent` — гарантия для
+ *     свежих конверсий из legacy HTML;
+ *   - `hydrateEmailLocales` на фронте — лечит уже-сохранённые
+ *     contentJson при открытии формы;
+ *   - `renderEmailV2Local` на бэке — последний рубеж перед send,
+ *     спасает scheduled / queue-задачи, идущие в обход UI.
+ *
+ * Имя сохранено по историческим причинам (когда-то функция занималась
+ * только photos). Сейчас правильнее читать его как «migrate legacy
+ * block variables» — добавление новой замены сводится к одной строке
+ * в `LEGACY_BLOCK_VARIABLE_REPLACERS`.
+ *
+ * Правила обхода:
+ *   1. Top-level `variable[id ∈ matchLegacyBlockVariable]` или
+ *      `htmlCodeBlock` с такой variable внутри (артефакт `promoteBlockHtmlVariables`)
+ *      — заменяются полностью на соответствующий block-узел.
+ *   2. `paragraph` с единственным непустым ребёнком-legacy-variable —
+ *      целиком заменяется на block-узел (image/repeat — block-level,
+ *      жить inline в параграфе не могут).
+ *   3. Variable посреди смешанного параграфа — оставляем как есть:
+ *      это пользовательский кейс, безопаснее не ломать layout.
+ *   4. Внутрь `section`/`repeat`/`for`/`show` и т.п. block-контейнеров
+ *      ходим рекурсивно.
+ *
+ * Возвращает НОВЫЙ объект, не мутирует входной. Идемпотентна:
+ *   повторный вызов — no-op (после первой замены variable-чипов
+ *   с такими id уже не остаётся).
+ */
+export declare function migratePhotosToImage(content: EmailContentJsonV2): EmailContentJsonV2;
+/**
+ * Главная точка входа конвертера. Принимает legacy HTML (Quill-style
+ * с плоскими плейсхолдерами и handlebars-блоками) и возвращает готовый
+ * `EmailContentJsonV2`, готовый к сохранению в БД и открытию в
+ * EmailBuilder.
+ *
+ * Идемпотентен: пустой/null/whitespace вход даёт минимальный валидный
+ * `doc` (с логотипом если указан, иначе пустой массив content).
+ *
+ * Шаги обработки (в порядке выполнения):
+ *  1. `preprocessHtml` — text-level замены (`{{#if}}`, `{var}`, ...)
+ *  2. parse через node-html-parser
+ *  3. `walk` — построение TipTap-нод верхнего уровня
+ *  4. `promoteBlockHtmlVariables` — вынос block-payload плейсхолдеров
+ *  5. `normalizeVariableIds` — flat → namespaced id (если включено)
+ *  6. оборачивание в `EmailContentJsonV2` с логотипом и темой
+ */
+export declare function convertLegacyHtmlToEmailContent(html: string | null | undefined, options?: ConvertLegacyHtmlOptions): EmailContentJsonV2;
+/**
+ * Подсчёт неизвестных плейсхолдеров в legacy HTML. Возвращает уникальные
+ * имена `{X}` и `{{X}}`, которые **не входят** в `KNOWN_PLACEHOLDERS`.
+ * Используется до миграции, чтобы найти ручные/опечатанные токены в
+ * шаблонах клиентов и решить, что с ними делать (исправить → конвертим,
+ * проигнорить → оставляем как литеральный текст).
+ */
+export declare function findUnknownPlaceholders(html: string | null | undefined): string[];
+export type { KnownPlaceholder } from './placeholders';
+export { BLOCK_HTML_PLACEHOLDERS, isBlockHtmlPlaceholder, isKnownPlaceholder, KNOWN_PLACEHOLDERS, LEGACY_TO_NAMESPACED_ID_MAP, normalizePlaceholderId, };