@escapenavigator/utils 1.10.133 → 1.10.134

package/dist/email-builder/from-html.test.js

@@ -0,0 +1,753 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const email_builder_1 = require("@escapenavigator/types/dist/email-builder");
+const from_html_1 = require("./from-html");
+/**
+ * Хелпер: достаёт `doc.content` без верхнего `image` (логотип) — он
+ * в тестах редко интересен и только засоряет матчеры. Если логотип
+ * не передавался — возвращает массив как есть.
+ */
+const docBody = (result) => {
+    const content = result.doc.content || [];
+    if (content[0] && content[0].type === 'image') {
+        return content.slice(1);
+    }
+    return content;
+};
+describe('convertLegacyHtmlToEmailContent', () => {
+    describe('базовый каркас', () => {
+        it('возвращает валидный v2-doc для пустого ввода', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('');
+            expect(result.version).toBe(email_builder_1.EMAIL_CONTENT_VERSION_V2);
+            expect(result.doc.type).toBe('doc');
+            expect(result.doc.content).toEqual([]);
+            expect(result.theme).toBeDefined();
+        });
+        it('возвращает валидный v2-doc для null/undefined', () => {
+            const a = (0, from_html_1.convertLegacyHtmlToEmailContent)(null);
+            const b = (0, from_html_1.convertLegacyHtmlToEmailContent)(undefined);
+            expect(a.doc.content).toEqual([]);
+            expect(b.doc.content).toEqual([]);
+        });
+        it('вставляет logo-ноду первой если задан logo', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Привет</p>', {
+                logo: 'https://cdn.example.com/logo.png',
+            });
+            const content = result.doc.content || [];
+            expect(content[0]).toMatchObject({
+                type: 'image',
+                attrs: { src: 'https://cdn.example.com/logo.png', alignment: 'left' },
+            });
+        });
+        it('не вставляет logo-ноду если не задан', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Привет</p>');
+            const content = result.doc.content || [];
+            expect(content[0].type).toBe('paragraph');
+        });
+    });
+    describe('параграфы и текст', () => {
+        it('конвертит один параграф', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Привет, мир!</p>');
+            expect(docBody(result)).toEqual([
+                {
+                    type: 'paragraph',
+                    attrs: { textAlign: 'left' },
+                    content: [{ type: 'text', text: 'Привет, мир!' }],
+                },
+            ]);
+        });
+        it('конвертит несколько параграфов', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Один</p><p>Два</p>');
+            const body = docBody(result);
+            expect(body).toHaveLength(2);
+            expect(body[0].content).toEqual([
+                { type: 'text', text: 'Один' },
+            ]);
+        });
+        it('схлопывает пустые параграфы <p></p>', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>А</p><p></p><p>Б</p>');
+            expect(docBody(result)).toHaveLength(2);
+        });
+        it('схлопывает <p><br></p>', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>А</p><p><br></p><p>Б</p>');
+            expect(docBody(result)).toHaveLength(2);
+        });
+        it('конвертит <br> в hardBreak в составе параграфа', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Один<br>Два</p>');
+            const body = docBody(result);
+            expect(body[0].content).toEqual([
+                { type: 'text', text: 'Один' },
+                { type: 'hardBreak' },
+                { type: 'text', text: 'Два' },
+            ]);
+        });
+        it('декодирует HTML-сущности и nbsp', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Кавычки: &quot;тест&quot; &amp; nbsp:&nbsp;конец</p>');
+            const body = docBody(result);
+            expect(body[0].content[0].text).toBe('Кавычки: "тест" & nbsp: конец');
+        });
+    });
+    describe('inline-форматирование', () => {
+        it('конвертит <strong> в bold mark', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Обычный <strong>жирный</strong> текст</p>');
+            const body = docBody(result);
+            const content = body[0].content;
+            expect(content).toEqual([
+                { type: 'text', text: 'Обычный ' },
+                { type: 'text', text: 'жирный', marks: [{ type: 'bold' }] },
+                { type: 'text', text: ' текст' },
+            ]);
+        });
+        it('конвертит <em>/<i> в italic, <u> в underline, <s> в strike', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p><em>a</em><i>b</i><u>c</u><s>d</s></p>');
+            const content = docBody(result)[0].content;
+            expect(content.map((n) => n.marks[0].type)).toEqual([
+                'italic',
+                'italic',
+                'underline',
+                'strike',
+            ]);
+        });
+        it('накапливает marks при вложенности', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p><strong><em>оба</em></strong></p>');
+            const content = docBody(result)[0].content;
+            expect(content[0].marks.map((m) => m.type).sort()).toEqual(['bold', 'italic']);
+        });
+    });
+    describe('ссылки', () => {
+        it('конвертит <a> в link-mark с href/target/rel', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Жми <a href="https://example.com" target="_blank">тут</a>.</p>');
+            const content = docBody(result)[0].content;
+            const linkNode = content.find((n) => n.marks?.[0]?.type === 'link');
+            expect(linkNode).toBeDefined();
+            expect(linkNode?.marks?.[0].attrs).toMatchObject({
+                href: 'https://example.com',
+                target: '_blank',
+            });
+        });
+    });
+    describe('плоские плейсхолдеры {var}', () => {
+        it('превращает {clientName} в variable-ноду (с маппингом в client.firstName)', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Привет, {clientName}!</p>', {
+                labels: { 'client.firstName': 'Имя клиента' },
+            });
+            const content = docBody(result)[0].content;
+            expect(content).toEqual([
+                { type: 'text', text: 'Привет, ' },
+                {
+                    type: 'variable',
+                    attrs: {
+                        id: 'client.firstName',
+                        label: 'Имя клиента',
+                        fallback: null,
+                        required: false,
+                        hideDefaultValue: false,
+                    },
+                },
+                { type: 'text', text: '!' },
+            ]);
+        });
+        it('использует normalized id как label, если labels не передан', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{questroomTitle}</p>');
+            const content = docBody(result)[0]
+                .content;
+            expect(content[0].attrs.label).toBe('questroom.title');
+        });
+        it('обрабатывает несколько токенов в одном параграфе (id маппятся)', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{clientName} на {date} в {address}</p>');
+            const content = docBody(result)[0].content;
+            const vars = content.filter((n) => n.type === 'variable').map((n) => n.attrs?.id);
+            expect(vars).toEqual(['client.firstName', 'order.date', 'location.address']);
+        });
+    });
+    describe('maily-style плейсхолдеры {{var}}', () => {
+        it('{{profileTitle}} без inlineValues остаётся как `variable` без маппинга', () => {
+            /*
+             * `profileTitle` намеренно ВЫПИЛЕН из `LEGACY_TO_NAMESPACED_ID_MAP`:
+             * пользователь редактирует название компании руками прямо в
+             * шаблоне (мы убрали `profile.title` из declare()-стека всех
+             * скоупов). Без inlineValues конвертер оставляет токен как
+             * `variable`-ноду с flat-id `profileTitle` — рендер на проде
+             * вернёт пустую строку, и юзер увидит «дыру», после чего
+             * вручную заменит на нужный текст.
+             */
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Команда {{profileTitle}}</p>');
+            const content = docBody(result)[0].content;
+            const v = content.find((n) => n.type === 'variable');
+            expect(v?.attrs?.id).toBe('profileTitle');
+        });
+        it('{{profileTitle}} с inlineValues заменяется на text-ноду с буквальным значением', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Команда {{profileTitle}}</p>', {
+                inlineValues: { profileTitle: 'Escape Quest Moscow' },
+            });
+            const content = docBody(result)[0].content;
+            // Один text-узел со склеенным контентом — паттерн backfill'а
+            // в `AdminMarketingEmailsRefillService`.
+            expect(content.every((n) => n.type === 'text')).toBe(true);
+            expect(content.map((n) => n.text).join('')).toBe('Команда Escape Quest Moscow');
+        });
+        it('поддерживает inline-fallback {{X|"default"}}, маппит id', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{{clientName|"гость"}}</p>');
+            const content = docBody(result)[0].content;
+            expect(content[0].attrs).toMatchObject({ id: 'client.firstName', fallback: 'гость' });
+        });
+    });
+    describe('IF-блоки {{#if X}}…{{/if}}', () => {
+        it('оборачивает содержимое в section с showIfKey', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>А</p>{{#if promocode}}<p>Промо: {promocode}</p>{{/if}}<p>Б</p>');
+            const body = docBody(result);
+            const section = body.find((n) => n.type === 'section');
+            expect(section).toBeDefined();
+            expect(section.attrs.showIfKey).toBe('promocode.code');
+            expect(section.content).toHaveLength(1);
+        });
+        it('распаковывает IF, разорванный по нескольким параграфам (как в crm-crosssales.json)', () => {
+            // Реальный кейс из переводов: открывающий и закрывающий
+            // {{#if}}/{{/if}} лежат каждый в своём <p></p>
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{{#if howToFindLocation}}</p><p>{howToFindLocation}</p><p>{{/if}}</p>');
+            const body = docBody(result);
+            const section = body.find((n) => n.type === 'section');
+            expect(section).toBeDefined();
+            expect(section.attrs.showIfKey).toBe('location.howToFind');
+            // Внутри секции — параграф с variable нодой
+            const innerParagraph = section.content[0];
+            expect(innerParagraph.content[0].type).toBe('variable');
+        });
+        it('поддерживает вложенные IF-блоки', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('{{#if A}}<p>A</p>{{#if B}}<p>B</p>{{/if}}{{/if}}');
+            const body = docBody(result);
+            const outer = body[0];
+            expect(outer.type).toBe('section');
+            expect(outer.attrs.showIfKey).toBe('A');
+            const inner = outer.content.find((n) => n.type === 'section');
+            expect(inner?.attrs?.showIfKey).toBe('B');
+        });
+    });
+    describe('кнопка бронирования {{#manageBooking}}…{{/manageBooking}}', () => {
+        it('превращается в button-ноду с isUrlVariable=true', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{{#manageBooking}}Управлять бронью{{/manageBooking}}</p>');
+            const body = docBody(result);
+            // Кнопка извлекается из inline-контекста как самостоятельный блок —
+            // см. собирание content в parent <p>. Здесь её формат проверяем.
+            const findButton = (nodes) => {
+                for (const n of nodes) {
+                    if (n.type === 'button')
+                        return n;
+                    const children = n.content;
+                    if (children) {
+                        const found = findButton(children);
+                        if (found)
+                            return found;
+                    }
+                }
+                return null;
+            };
+            const button = findButton(body);
+            expect(button).toBeDefined();
+            expect(button.attrs).toMatchObject({
+                text: 'Управлять бронью',
+                url: 'bookingManagementLink',
+                isUrlVariable: true,
+            });
+            // Дефолты variant/alignment/borderRadius/padding явно НЕ
+            // зашиваем — Maily-button-extension сам подставит их через
+            // schema (left/filled/smooth/null), и bubble-menu toolbar
+            // тогда корректно `updateAttributes`-ит при кликах юзера.
+            expect(button.attrs.alignment).toBeUndefined();
+            expect(button.attrs.paddingTop).toBeUndefined();
+        });
+    });
+    describe('блочные HTML-плейсхолдеры (orderDetailsHtml/photos)', () => {
+        /*
+         * Block-payload канал выпилен (см. `BLOCK_HTML_PLACEHOLDERS = {}`
+         * в `placeholders.ts`). Legacy-плейсхолдеры теперь:
+         *
+         *   - `photos` — конвертится в редактируемую `image`-ноду с
+         *     `src: 'photos'` (см. отдельный test ниже);
+         *   - `orderDetailsHtml` — на проде не использовался, оставляем
+         *     как обычную `variable`-ноду (на рендере получит пустую
+         *     строку, пользователь увидит дыру и поправит шаблон).
+         *
+         * (`servicesList` выпилен целиком — отдельный describe ниже
+         * проверяет, что variable-чип и обёртка-параграф удаляются.)
+         *
+         * Эти тесты следят, чтобы у нас НЕ появился случайно
+         * htmlCodeBlock-promote обратно (мы его удалили).
+         */
+        it('{orderDetailsHtml} остаётся inline variable-нодой (block-promote выпилен)', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Заказ:</p><p>{orderDetailsHtml}</p><p>Спасибо</p>');
+            const body = docBody(result);
+            // Никаких htmlCodeBlock — только три параграфа подряд.
+            expect(body.every((n) => n.type === 'paragraph')).toBe(true);
+            const middleParagraph = body[1];
+            expect(middleParagraph.content[0].type).toBe('variable');
+            expect(middleParagraph.content[0].attrs?.id).toBe('orderDetailsHtml');
+        });
+        it('inline {orderDetailsHtml} не разрывает родительский параграф', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Заказ: {orderDetailsHtml} спасибо за бронь.</p>');
+            const body = docBody(result);
+            // Раньше делили на paragraph + htmlCodeBlock + paragraph.
+            // Теперь — один параграф, переменная внутри inline.
+            expect(body).toHaveLength(1);
+            expect(body[0].type).toBe('paragraph');
+        });
+        it('оставляет {website} как inline variable (не блочный)', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Сайт: {website}</p>');
+            const body = docBody(result);
+            // Один параграф, htmlCodeBlock не порождаем
+            expect(body).toHaveLength(1);
+            expect(body[0].type).toBe('paragraph');
+            const content = body[0].content;
+            expect(content.find((n) => n.type === 'variable')?.attrs?.id).toBe('location.site');
+        });
+    });
+    describe('изображения', () => {
+        it('конвертит <img> в image-ноду', () => {
+            const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Фото:</p><img src="https://cdn.example.com/p.jpg" alt="Фото"/>');
+            const body = docBody(result);
+            const image = body.find((n) => n.type === 'image');
+            expect(image).toBeDefined();
+            expect(image.attrs).toMatchObject({
+                src: 'https://cdn.example.com/p.jpg',
+                alt: 'Фото',
+            });
+        });
+    });
+});
+describe('headings (<h1>/<h2>/<h3>)', () => {
+    it('конвертит <h3>X</h3> в heading-ноду с level=3', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<h3>Дата игры:</h3><p>{date}</p>');
+        const body = docBody(result);
+        expect(body[0].type).toBe('heading');
+        expect(body[0].attrs).toMatchObject({ level: 3, textAlign: 'left' });
+        expect(body[0].content?.[0].text).toBe('Дата игры:');
+        // следующий параграф остался обычным
+        expect(body[1].type).toBe('paragraph');
+    });
+    it('поддерживает уровни 1/2/3', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<h1>A</h1><h2>B</h2><h3>C</h3>');
+        const body = docBody(result);
+        expect(body.map((n) => [n.type, n.attrs?.level])).toEqual([
+            ['heading', 1],
+            ['heading', 2],
+            ['heading', 3],
+        ]);
+    });
+    it('переменные внутри heading маппятся через idMap', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<h3>{questroomTitle}</h3>');
+        const body = docBody(result);
+        expect(body[0].type).toBe('heading');
+        expect(body[0].content?.[0].attrs?.id).toBe('questroom.title');
+    });
+    it('пустой <h3></h3> отбрасывается (как пустой параграф)', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<h3></h3><p>X</p>');
+        const body = docBody(result);
+        expect(body).toHaveLength(1);
+        expect(body[0].type).toBe('paragraph');
+    });
+    it('<h4>-<h6> уходят в transparent (Maily их не поддерживает)', () => {
+        // Текст внутри h4 должен попасть в выход как обычный параграф
+        // (transparent fallback раскрывает содержимое).
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<h4>X</h4>');
+        const body = docBody(result);
+        // Не должно быть heading-ноды
+        expect(body.every((n) => n.type !== 'heading')).toBe(true);
+    });
+});
+describe('маппинг flat-id\u0432 в namespaced (LEGACY_TO_NAMESPACED_ID_MAP)', () => {
+    it('маппит {clientName} в client.firstName в variable-ноде', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Привет, {clientName}!</p>');
+        const body = (result.doc.content || []);
+        const v = body[0]?.content?.find((n) => n.attrs?.id);
+        expect(v?.attrs?.id).toBe('client.firstName');
+    });
+    it('маппит все известные legacy-id-в namespaced', () => {
+        const html = '<p>{questroomTitle} {discount} {website} {phone}</p>';
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)(html);
+        const ids = ((result.doc.content?.[0]).content ||
+            [])
+            .filter((n) => n.attrs?.id)
+            .map((n) => n.attrs.id);
+        expect(ids).toEqual([
+            'questroom.title',
+            'promocode.discount',
+            'location.site',
+            'location.phone',
+        ]);
+    });
+    it('оставляет unknown id как есть (не в карте)', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{xyzCustom}</p>');
+        const ids = ((result.doc.content?.[0]).content ||
+            [])
+            .filter((n) => n.attrs?.id)
+            .map((n) => n.attrs.id);
+        expect(ids).toEqual(['xyzCustom']);
+    });
+    it('оставляет block-payload id flat — у них нет namespaced версии', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Detail:</p><p>{orderDetailsHtml}</p>');
+        // Block-payload var оборачивается в htmlCodeBlock; id внутри —
+        // тот же flat (`orderDetailsHtml`), потому что block-payload'ы
+        // не имеют резолверов (значение собирается отдельным HTML-шагом).
+        const findVar = (nodes) => {
+            for (const n of nodes) {
+                if (n.type === 'variable')
+                    return n.attrs;
+                const children = n.content;
+                if (children) {
+                    const found = findVar(children);
+                    if (found)
+                        return found;
+                }
+            }
+            return null;
+        };
+        expect(findVar(result.doc.content || [])?.id).toBe('orderDetailsHtml');
+    });
+    it('опция idMap=null отключает маппинг (для ad-hoc преобразований)', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{clientName}</p>', { idMap: null });
+        const ids = ((result.doc.content?.[0]).content ||
+            [])
+            .filter((n) => n.attrs?.id)
+            .map((n) => n.attrs.id);
+        expect(ids).toEqual(['clientName']);
+    });
+    it('кастомная idMap имеет приоритет над дефолтной', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{clientName}</p>', {
+            idMap: { clientName: 'custom.name' },
+        });
+        const ids = ((result.doc.content?.[0]).content ||
+            [])
+            .filter((n) => n.attrs?.id)
+            .map((n) => n.attrs.id);
+        expect(ids).toEqual(['custom.name']);
+    });
+    it('обновляет label при маппинге (берёт label по новому id)', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{clientName}</p>', {
+            labels: { 'client.firstName': 'Имя клиента' },
+        });
+        const v = ((result.doc.content?.[0]).content || []).find((n) => n.attrs?.id);
+        expect(v?.attrs?.label).toBe('Имя клиента');
+    });
+    it('переменная внутри section/if тоже маппится', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('{{#if discount}}<p>{discount}</p>{{/if}}');
+        const section = result.doc.content?.[0];
+        const inner = section.content[0].content.find((n) => n.attrs?.id);
+        expect(inner?.attrs?.id).toBe('promocode.discount');
+    });
+    it('LEGACY_TO_NAMESPACED_ID_MAP содержит все ключевые маппинги', () => {
+        // Защита от случайного удаления записей из карты — без них
+        // мигрированные шаблоны сломаются на v2-render.
+        expect(from_html_1.LEGACY_TO_NAMESPACED_ID_MAP.clientName).toBe('client.firstName');
+        expect(from_html_1.LEGACY_TO_NAMESPACED_ID_MAP.questroomTitle).toBe('questroom.title');
+        expect(from_html_1.LEGACY_TO_NAMESPACED_ID_MAP.promocode).toBe('promocode.code');
+        // `profileTitle` намеренно НЕ в карте — пользователь сам впишет
+        // название компании прямо в текст шаблона. См. `inlineValues`-
+        // ветку в `convertLegacyHtmlToEmailContent`.
+        expect(from_html_1.LEGACY_TO_NAMESPACED_ID_MAP.profileTitle).toBeUndefined();
+        expect(from_html_1.LEGACY_TO_NAMESPACED_ID_MAP.howToFindLocation).toBe('location.howToFind');
+    });
+});
+describe('findUnknownPlaceholders', () => {
+    it('возвращает пустой массив для известных плейсхолдеров', () => {
+        const html = '<p>{clientName} {questroomTitle} {{profileTitle}}</p>';
+        expect((0, from_html_1.findUnknownPlaceholders)(html)).toEqual([]);
+    });
+    it('находит неизвестный {firstName} (опечатка вместо clientName)', () => {
+        const html = '<p>{firstName}!</p>';
+        expect((0, from_html_1.findUnknownPlaceholders)(html)).toEqual(['firstName']);
+    });
+    it('игнорирует управляющие конструкции', () => {
+        const html = '<p>{{#if promocode}}{promocode}{{/if}}</p>';
+        expect((0, from_html_1.findUnknownPlaceholders)(html)).toEqual([]);
+    });
+    it('игнорирует namespaced (client.firstName) - предполагается что разработчик знает что делает', () => {
+        const html = '<p>{{client.firstName}}</p>';
+        expect((0, from_html_1.findUnknownPlaceholders)(html)).toEqual([]);
+    });
+    it('сортирует и дедуплицирует', () => {
+        const html = '<p>{xxx} {aaa} {xxx}</p>';
+        expect((0, from_html_1.findUnknownPlaceholders)(html)).toEqual(['aaa', 'xxx']);
+    });
+});
+describe('snapshot: реальные шаблоны из crm-crosssales/ru.json', () => {
+    /*
+     * Кейсы подсмотрены в `packages/api/translations/ru/crm-crosssales.json`.
+     * Это **дефолтные тексты**, которыми проинициализированы шаблоны у
+     * новых профилей. Если конвертер не падает на них — высокая
+     * вероятность, что он справится и с пользовательскими модификациями
+     * (они изменяют тексты, но не структуру).
+     */
+    it('crossSale.text — заголовок + {{#if}}-блоки + переменные', () => {
+        const html = '<p><strong>Здравствуйте, {clientName}!</strong></p>' +
+            '<p><br></p>' +
+            '<p>Спасибо, что посетили наш эскейп-рум "{questroomTitle}".</p>' +
+            '<p><br></p>' +
+            '<p>{{#if gameResult}}</p>' +
+            '<p>Поздравляем — <strong>{gameResult} мин</strong>!</p>' +
+            '<p>{{/if}}</p>' +
+            '<p>{{#if photos}}</p>' +
+            '<p>А вот фото: {photos}</p>' +
+            '<p>{{/if}}</p>' +
+            '<p>Сайт: {website}. Промокод: <strong>{promocode}</strong>, скидка <strong>{discount}</strong> до {validity}.</p>' +
+            '<p>С уважением,</p>' +
+            '<p>Команда {{profileTitle}}</p>';
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)(html);
+        const body = docBody(result);
+        // Структура должна содержать минимум: paragraph + 2 section'а + paragraph(финал)
+        const types = body.map((n) => n.type);
+        // Двумя section'ами обернуты gameResult и photos
+        const sections = types.filter((t) => t === 'section');
+        expect(sections.length).toBe(2);
+        /*
+         * `{photos}` теперь конвертится в `image`-ноду с
+         * `isSrcVariable: true, src: 'photos'` (а не в `htmlCodeBlock`,
+         * как раньше). Это даёт пользователю редактируемую картинку
+         * в Maily вместо raw-HTML галереи, см. комментарий в
+         * `from-html.ts → photoFirstImageNode`.
+         */
+        const photosSection = body.find((n) => n.attrs?.showIfKey === 'photos');
+        const photosImage = photosSection.content.find((n) => n.type === 'image');
+        expect(photosImage).toBeDefined();
+        expect(photosImage?.attrs).toMatchObject({
+            src: 'photos',
+            isSrcVariable: true,
+        });
+    });
+    it('{photos} в legacy → image-нода с переменным src (photos)', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Фото команды: {photos}</p>');
+        const body = docBody(result);
+        const image = body.find((n) => n.type === 'image');
+        expect(image).toBeDefined();
+        expect(image.attrs).toMatchObject({
+            src: 'photos',
+            isSrcVariable: true,
+            alignment: 'center',
+        });
+        // htmlCodeBlock больше не должен порождаться для photos
+        const htmlBlock = body.find((n) => n.type === 'htmlCodeBlock');
+        expect(htmlBlock).toBeUndefined();
+    });
+    it('customClientBooking — kнопка бронирования + orderDetailsHtml', () => {
+        const html = '<p>{clientName}, благодарим за бронирование «{questroomTitle}»!</p>' +
+            '{orderDetailsHtml}' +
+            '<p>{{#manageBooking}}Управлять бронью{{/manageBooking}}</p>';
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)(html);
+        const body = docBody(result);
+        const findOfType = (nodes, type) => {
+            for (const n of nodes) {
+                if (n.type === type)
+                    return n;
+                const children = n.content;
+                if (children) {
+                    const found = findOfType(children, type);
+                    if (found)
+                        return found;
+                }
+            }
+            return null;
+        };
+        expect(findOfType(body, 'htmlCodeBlock')).toBeDefined();
+        expect(findOfType(body, 'button')).toBeDefined();
+    });
+});
+describe('migratePhotosToImage', () => {
+    const wrap = (nodes) => ({
+        version: email_builder_1.EMAIL_CONTENT_VERSION_V2,
+        doc: { type: 'doc', content: nodes },
+        theme: undefined,
+    });
+    it('заменяет top-level variable[id=photos] на image-ноду', () => {
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'variable',
+                attrs: { id: 'photos', label: 'Photos' },
+            },
+        ]));
+        const body = (result.doc.content || []);
+        expect(body).toHaveLength(1);
+        expect(body[0].type).toBe('image');
+        expect(body[0].attrs).toMatchObject({
+            src: 'photos',
+            isSrcVariable: true,
+            width: 200,
+            height: 200,
+        });
+    });
+    it('заменяет paragraph с единственной variable[id=photos] на image-ноду', () => {
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'paragraph',
+                content: [{ type: 'variable', attrs: { id: 'photos' } }],
+            },
+        ]));
+        const body = (result.doc.content || []);
+        expect(body[0].type).toBe('image');
+    });
+    it('заменяет variable[id=order.photoFirst] (legacy backward-compat) на image-ноду', () => {
+        // `order.photoFirst` — переходное имя, могло остаться у разработчиков
+        // в локальных redux-state'ах; нормализатор должен подменить его на
+        // image-узел с `src: 'photos'`, чтобы UI был консистентным.
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'paragraph',
+                content: [{ type: 'variable', attrs: { id: 'order.photoFirst' } }],
+            },
+        ]));
+        const body = (result.doc.content || []);
+        expect(body[0].type).toBe('image');
+        expect(body[0].attrs).toMatchObject({ src: 'photos', isSrcVariable: true });
+    });
+    it('заменяет htmlCodeBlock-обёртку с photos-variable на image', () => {
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'htmlCodeBlock',
+                content: [{ type: 'variable', attrs: { id: 'photos' } }],
+            },
+        ]));
+        const body = (result.doc.content || []);
+        expect(body[0].type).toBe('image');
+    });
+    it('идёт рекурсивно внутрь section и подменяет photos', () => {
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'section',
+                attrs: { showIfKey: 'cond' },
+                content: [
+                    {
+                        type: 'paragraph',
+                        content: [{ type: 'variable', attrs: { id: 'photos' } }],
+                    },
+                ],
+            },
+        ]));
+        const section = (result.doc.content || [])[0];
+        expect(section.content[0].type).toBe('image');
+    });
+    it('идемпотентность: повторный вызов ничего не меняет', () => {
+        const initial = (0, from_html_1.migratePhotosToImage)(wrap([{ type: 'variable', attrs: { id: 'photos' } }]));
+        const repeated = (0, from_html_1.migratePhotosToImage)(initial);
+        expect(repeated).toEqual(initial);
+    });
+    it('не трогает чужие variable (id != photos)', () => {
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'paragraph',
+                content: [{ type: 'variable', attrs: { id: 'client.firstName' } }],
+            },
+        ]));
+        const body = (result.doc.content || [])[0];
+        expect(body.type).toBe('paragraph');
+    });
+    it('не трогает параграф со смешанным контентом (photos + текст)', () => {
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'paragraph',
+                content: [
+                    { type: 'text', text: 'Фото: ' },
+                    { type: 'variable', attrs: { id: 'photos' } },
+                ],
+            },
+        ]));
+        const body = (result.doc.content || [])[0];
+        expect(body.type).toBe('paragraph');
+    });
+    it('удаляет variable[id=servicesList] из doc (функция выпилена)', () => {
+        // `servicesList` больше не разворачивается в `repeat`-ноду —
+        // фича up-sale-листа в письмах выпилена. Нормализатор удаляет
+        // chip из doc'а: parent-параграф, содержащий ТОЛЬКО эту переменную,
+        // тоже отбрасывается (см. `migratePhotosInNodes` → ветка (2)).
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'paragraph',
+                content: [{ type: 'variable', attrs: { id: 'servicesList' } }],
+            },
+        ]));
+        const body = (result.doc.content || []);
+        expect(body.some((n) => n.type === 'repeat')).toBe(false);
+        // Параграф-обёртка тоже схлопывается, чтобы не оставлять
+        // мёртвый пустой блок (`meaningful.length === 1 → factory []`).
+        expect(body).toHaveLength(0);
+    });
+});
+describe('convertLegacyHtmlToEmailContent — {servicesList} (выпилен)', () => {
+    /*
+     * Функция up-sale-листа выпилена из email-системы. legacy токен
+     * `{servicesList}` всё ещё может прийти из старых шаблонов на проде —
+     * проверяем, что конвертер молча его проглатывает (не оставляет
+     * литеральным текстом, не порождает repeat-ноду, не порождает
+     * htmlCodeBlock).
+     */
+    const wrap = (nodes) => ({
+        version: email_builder_1.EMAIL_CONTENT_VERSION_V2,
+        doc: { type: 'doc', content: nodes },
+        theme: undefined,
+    });
+    it('legacy {servicesList} в обёртке `<p>` схлопывается полностью', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{servicesList}</p>');
+        const body = docBody(result);
+        expect(body.some((n) => n.type === 'repeat')).toBe(false);
+        expect(body.some((n) => n.type === 'htmlCodeBlock')).toBe(false);
+        // Параграф-обёртка с единственной servicesList-переменной
+        // выкидывается нормализатором без замены.
+        expect(body).toHaveLength(0);
+    });
+    it('inline {servicesList} вырезается, остальной текст сохраняется', () => {
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>Доп. услуги: {servicesList} спасибо</p>');
+        const body = docBody(result);
+        // Параграф остался, так как есть текст вокруг переменной;
+        // сама `variable[id=servicesList]` внутри не должна доехать
+        // до конвертированного результата.
+        expect(body).toHaveLength(1);
+        expect(body[0].type).toBe('paragraph');
+        const allVarIds = (body[0].content || [])
+            .filter((c) => c.type === 'variable')
+            .map((c) => c.attrs?.id);
+        expect(allVarIds).not.toContain('servicesList');
+    });
+    it('migratePhotosToImage идемпотентен для servicesList (повторный прогон ничего не меняет)', () => {
+        // После первого прогона variable-чип уже удалён, повторный
+        // прогон видит пустой doc и тоже его не трогает. Это важно
+        // для refill-сценария: рефилл может прогнать миграцию повторно,
+        // и она не должна породить никаких новых нод.
+        const once = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>{servicesList}</p>');
+        const twice = (0, from_html_1.migratePhotosToImage)(once);
+        const body = (twice.doc.content || []);
+        expect(body).toHaveLength(0);
+    });
+    it('{{#if servicesList}}…{{/if}} вырезается целиком вместе с заголовком внутри', () => {
+        // Сценарий рефила: в legacy шаблоне жил блок-приглашение
+        // докупить услуги. Сам chip удаляется factory `() => []`, но
+        // section-обёртка с заголовком («Сделайте игру ярче…») при
+        // этом оставалась пустым box'ом — пользователь видел её в
+        // редакторе. Теперь secition тоже схлопывается.
+        const result = (0, from_html_1.convertLegacyHtmlToEmailContent)('<p>До игры:</p>{{#if servicesList}}<p><strong>Сделайте игру ярче</strong></p><p>{servicesList}</p>{{/if}}<p>До встречи!</p>');
+        const body = docBody(result);
+        // Никаких section'ов с showIfKey=servicesList не осталось.
+        expect(body.some((n) => n.type === 'section' && n.attrs?.showIfKey === 'servicesList')).toBe(false);
+        // Соседние параграфы («До игры:» и «До встречи!») сохранились.
+        expect(body.filter((n) => n.type === 'paragraph')).toHaveLength(2);
+    });
+    it('migratePhotosToImage чистит legacy `section[showIfKey=servicesList]` из сохранённого doc', () => {
+        // Прямая проверка нормализатора для случая, когда doc уже
+        // лежит в БД как `section[showIfKey='servicesList']` (на проде
+        // такие шаблоны живут массово). Симметрично factory `() => []`
+        // для самой переменной — обёртка тоже должна исчезнуть.
+        const result = (0, from_html_1.migratePhotosToImage)(wrap([
+            {
+                type: 'section',
+                attrs: { showIfKey: 'servicesList' },
+                content: [
+                    {
+                        type: 'paragraph',
+                        content: [{ type: 'text', text: 'Сделайте игру ярче' }],
+                    },
+                ],
+            },
+            { type: 'paragraph', content: [{ type: 'text', text: 'После' }] },
+        ]));
+        const body = (result.doc.content || []);
+        expect(body.some((n) => n.type === 'section')).toBe(false);
+        expect(body).toHaveLength(1);
+        expect(body[0].type).toBe('paragraph');
+    });
+});