@escapenavigator/utils 1.10.145 → 1.10.147

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

@@ -1,85 +1,20 @@
 /**
- * Конвертер 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 их не использовал в шаблонах.
- *
- * Преобразование чистое и идемпотентное: повторный вызов на той же
- * строке даёт тот же результат.
+ * Нормализатор устаревших block-variable чипов в `EmailContentJsonV2`
+ * (Maily/TipTap) документах.
+ *
+ * Раньше здесь жил полноценный конвертер legacy HTML (`feedbackText`) →
+ * v2 (`convertLegacyHtmlToEmailContent`). Он удалён: маркетинг мигрирует
+ * на `marketing-automation` «как есть» на v1 (legacy `feedbackText`), а
+ * переход на v2 идёт через базовый `createDefaultEmailContent`, а НЕ через
+ * авто-конвертацию старого HTML.
+ *
+ * Что осталось — `migratePhotosToImage`: идемпотентная нормализация уже
+ * сохранённых v2-доков (legacy `{photos}`-chip → редактируемая image-нода,
+ * выпиленный `{servicesList}` → удаление). Нужна и фронту
+ * (`hydrateEmailLocales` при открытии редактора), и бэку
+ * (`v2-renderer.util.ts` как последний рубеж перед отправкой).
  */
 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:
@@ -89,9 +24,7 @@ export type ConvertLegacyHtmlOptions = {
  *     выпилена; см. `isServicesListVariableNode` и factory `() => []`
  *     в `LEGACY_BLOCK_VARIABLE_REPLACERS`).
  *
- * Используется во всех трёх каналах:
- *   - финальный шаг `convertLegacyHtmlToEmailContent` — гарантия для
- *     свежих конверсий из legacy HTML;
+ * Используется в двух каналах:
  *   - `hydrateEmailLocales` на фронте — лечит уже-сохранённые
  *     contentJson при открытии формы;
  *   - `renderEmailV2Local` на бэке — последний рубеж перед send,
@@ -104,11 +37,11 @@ export type ConvertLegacyHtmlOptions = {
  *
  * Правила обхода:
  *   1. Top-level `variable[id ∈ matchLegacyBlockVariable]` или
- *      `htmlCodeBlock` с такой variable внутри (артефакт `promoteBlockHtmlVariables`)
- *      — заменяются полностью на соответствующий block-узел.
+ *      `htmlCodeBlock` с такой variable внутри — заменяются полностью
+ *      на соответствующий block-узел.
  *   2. `paragraph` с единственным непустым ребёнком-legacy-variable —
- *      целиком заменяется на block-узел (image/repeat — block-level,
- *      жить inline в параграфе не могут).
+ *      целиком заменяется на block-узел (image — block-level, жить
+ *      inline в параграфе не может).
  *   3. Variable посреди смешанного параграфа — оставляем как есть:
  *      это пользовательский кейс, безопаснее не ломать layout.
  *   4. Внутрь `section`/`repeat`/`for`/`show` и т.п. block-контейнеров
@@ -119,31 +52,5 @@ export type ConvertLegacyHtmlOptions = {
  *   с такими 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, };
+export { BLOCK_HTML_PLACEHOLDERS, isBlockHtmlPlaceholder, isKnownPlaceholder, KNOWN_PLACEHOLDERS, LEGACY_TO_NAMESPACED_ID_MAP, normalizePlaceholderId, } from './placeholders';