@escapenavigator/utils 1.10.132 → 1.10.134

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

@@ -0,0 +1,89 @@
+/**
+ * Реестр плейсхолдеров для legacy marketing-emails. Источник правды:
+ * `HandlerKey` из `packages/app/src/components/quill/get-handlers.tsx`
+ * — список всех ключей, которые пользователь мог вставить через
+ * старый Quill-редактор.
+ *
+ * Зачем дублируется здесь:
+ *  - `HandlerKey` живёт в `@escapenavigator/app` (frontend-only пакет).
+ *    Конвертеру нужен тот же список, но без зависимости от React-стека.
+ *  - Бек-миграция (Nest worker) тоже использует этот список, чтобы
+ *    знать, какие токены превращать в `variable`-ноды.
+ *
+ * Если на фронте появится новый `HandlerKey` — добавь его и сюда.
+ * Тест `from-html.test.ts` явно проверяет, что новые имена не теряются
+ * при конверсии (если ключ не в реестре, токен `{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 type KnownPlaceholder = (typeof KNOWN_PLACEHOLDERS)[number];
+export declare const isKnownPlaceholder: (id: string) => id is KnownPlaceholder;
+/**
+ * Legacy block-HTML плейсхолдеры. Пустой Set — все три удалены:
+ *  - `photos`            — заменился на редактируемую `image`-ноду
+ *                          с `src = photos` (см. `from-html.ts →
+ *                          photoFirstImageNode`). На рендере id `photos`
+ *                          резолвится в URL ПЕРВОЙ фотки игры
+ *                          (`OrderVariableResolver.photos`).
+ *  - `orderDetailsHtml`  — на проде не использовался.
+ *  - `servicesList`      — функция up-sale-листа выпилена; legacy токены
+ *                          из старых шаблонов конвертер превращает в
+ *                          variable-чип, а нормализатор `migratePhotosInNodes`
+ *                          его удаляет (factory `() => []`). См. также
+ *                          `from-html.ts → isServicesListVariableNode`.
+ *
+ * Оставлен пустой экспорт + helper, чтобы внешние потребители
+ * (`from-html.ts`, `v2-renderer.util.ts`, send-pipelines) не падали
+ * на отсутствующий символ при инкрементальном удалении кода.
+ * После полного выпиливания block-payload пути в email.order.service
+ * и v2-renderer — можно удалить и этот файл.
+ *
+ * @deprecated удаляется вместе с block-payload-каналом v2-рендерера.
+ */
+export declare const BLOCK_HTML_PLACEHOLDERS: Set<string>;
+export declare const isBlockHtmlPlaceholder: (_id: string) => boolean;
+/**
+ * Маппинг legacy flat-плейсхолдеров на современные namespaced id'ы,
+ * которыми оперируют резолверы в `packages/api/src/modules/marketing-email-variables/resolvers/`.
+ *
+ * Зачем: конвертер по умолчанию переписывает id'ы в variable-нодах с
+ * `{clientName}` → `client.firstName`, чтобы v2-renderer
+ * (`replaceVars` в `v2-renderer.util.ts`) находил их по тому же ключу,
+ * по которому резолверы возвращают значения. Без этой карты после
+ * миграции все `{var}` в письмах висели бы пустыми.
+ *
+ * Источник правды для целевых id'ов:
+ *  - `client.resolver.ts`, `profile.resolver.ts`, `order.resolver.ts`,
+ *    `questroom.resolver.ts`, `location.resolver.ts`, `promocode.resolver.ts`,
+ *    `booking-link.resolver.ts` — `.declare()` каждого
+ *
+ * Что НЕ маппится (намеренно, остаётся как flat id):
+ *  - `photos`, `orderDetailsHtml` — block-payload плейсхолдеры, у которых
+ *    нет резолвера: значение собирается отдельной HTML-строкой на этапе
+ *    рендеринга (видим как `htmlCodeBlock` в TipTap-doc).
+ *  - `servicesList` — функция выпилена; флэт-id оставлен в `KNOWN_PLACEHOLDERS`,
+ *    чтобы legacy `{servicesList}` распознавался как variable-чип и
+ *    дропался нормализатором, а не оставался литеральным текстом.
+ *  - `bookingManagementLink` — спецзначение, используется в `button.url`
+ *    с `isUrlVariable:true`, никогда как inline-text variable.
+ *  - `manageBooking` — служебная директива `{{#manageBooking}}`, уже
+ *    распакована в `button`-ноду на этапе HTML-parse.
+ *
+ * Спорные кейсы:
+ *  - `website` → `location.site` (а не `profile.site`): в legacy `v2-renderer`
+ *    есть приоритет «если есть location.site, использовать его, иначе
+ *    profile.site». В новой схеме фолбэк делает резолвер. Если у профиля
+ *    нет локации (рассылка) — `location.site` будет пустым; templates
+ *    должны быть defensive (inline fallback или if-block).
+ *  - `prepareInfo` → `questroom.prepareText`: в crm-crosssales.json комментарий
+ *    говорит «из настроек локации», но в текущих резолверах prepare-info
+ *    лежит на квесте (`questroom.prepareText`). Источник правды — резолвер.
+ */
+export declare const LEGACY_TO_NAMESPACED_ID_MAP: Readonly<Record<string, string>>;
+/**
+ * Нормализация id переменной для нового формата. Если id есть в
+ * маппинге — возвращаем namespaced версию; иначе оставляем как есть
+ * (block-payload'ы, неизвестные кастомные токены, токены, которые
+ * пользователь добавил вручную).
+ */
+export declare const normalizePlaceholderId: (id: string) => string;

package/dist/email-builder/placeholders.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Реестр плейсхолдеров для legacy marketing-emails. Источник правды:
+ * `HandlerKey` из `packages/app/src/components/quill/get-handlers.tsx`
+ * — список всех ключей, которые пользователь мог вставить через
+ * старый Quill-редактор.
+ *
+ * Зачем дублируется здесь:
+ *  - `HandlerKey` живёт в `@escapenavigator/app` (frontend-only пакет).
+ *    Конвертеру нужен тот же список, но без зависимости от React-стека.
+ *  - Бек-миграция (Nest worker) тоже использует этот список, чтобы
+ *    знать, какие токены превращать в `variable`-ноды.
+ *
+ * Если на фронте появится новый `HandlerKey` — добавь его и сюда.
+ * Тест `from-html.test.ts` явно проверяет, что новые имена не теряются
+ * при конверсии (если ключ не в реестре, токен `{X}` оставляется в
+ * тексте как есть — это безопаснее, чем терять данные).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizePlaceholderId = exports.LEGACY_TO_NAMESPACED_ID_MAP = exports.isBlockHtmlPlaceholder = exports.BLOCK_HTML_PLACEHOLDERS = exports.isKnownPlaceholder = exports.KNOWN_PLACEHOLDERS = void 0;
+exports.KNOWN_PLACEHOLDERS = [
+    'clientName',
+    'childName',
+    'questroomTitle',
+    'promocode',
+    'discount',
+    'validity',
+    'website',
+    'howToFindLocation',
+    'importantInfo',
+    'prepareInfo',
+    'gameResult',
+    'additionalInfo',
+    'phone',
+    'date',
+    'photos',
+    /*
+     * `servicesList` сознательно оставлен в реестре: функция up-sale-листа
+     * выпилена (см. `from-html.ts → isServicesListVariableNode`), но legacy
+     * HTML-шаблоны на проде до сих пор содержат `{servicesList}`-токен.
+     * Без этой записи `convertLegacyHtmlToEmailContent` оставит токен
+     * как литеральный текст в письме (`{servicesList}` будет видна
+     * клиенту). С записью токен превращается в `variable`-чип, который
+     * нормализатор тут же удаляет из doc'а — итог одинаковый: «пусто».
+     */
+    'servicesList',
+    'address',
+    'profileTitle',
+    'birthday',
+    'currency',
+    'orderDetailsHtml',
+    'bookingManagementLink',
+    'questroomPhoto',
+    'code',
+    'language',
+    'players',
+    'mode',
+    'comment',
+];
+const KNOWN_PLACEHOLDERS_SET = new Set(exports.KNOWN_PLACEHOLDERS);
+const isKnownPlaceholder = (id) => KNOWN_PLACEHOLDERS_SET.has(id);
+exports.isKnownPlaceholder = isKnownPlaceholder;
+/**
+ * Legacy block-HTML плейсхолдеры. Пустой Set — все три удалены:
+ *  - `photos`            — заменился на редактируемую `image`-ноду
+ *                          с `src = photos` (см. `from-html.ts →
+ *                          photoFirstImageNode`). На рендере id `photos`
+ *                          резолвится в URL ПЕРВОЙ фотки игры
+ *                          (`OrderVariableResolver.photos`).
+ *  - `orderDetailsHtml`  — на проде не использовался.
+ *  - `servicesList`      — функция up-sale-листа выпилена; legacy токены
+ *                          из старых шаблонов конвертер превращает в
+ *                          variable-чип, а нормализатор `migratePhotosInNodes`
+ *                          его удаляет (factory `() => []`). См. также
+ *                          `from-html.ts → isServicesListVariableNode`.
+ *
+ * Оставлен пустой экспорт + helper, чтобы внешние потребители
+ * (`from-html.ts`, `v2-renderer.util.ts`, send-pipelines) не падали
+ * на отсутствующий символ при инкрементальном удалении кода.
+ * После полного выпиливания block-payload пути в email.order.service
+ * и v2-renderer — можно удалить и этот файл.
+ *
+ * @deprecated удаляется вместе с block-payload-каналом v2-рендерера.
+ */
+exports.BLOCK_HTML_PLACEHOLDERS = new Set([]);
+const isBlockHtmlPlaceholder = (_id) => false;
+exports.isBlockHtmlPlaceholder = isBlockHtmlPlaceholder;
+/**
+ * Маппинг legacy flat-плейсхолдеров на современные namespaced id'ы,
+ * которыми оперируют резолверы в `packages/api/src/modules/marketing-email-variables/resolvers/`.
+ *
+ * Зачем: конвертер по умолчанию переписывает id'ы в variable-нодах с
+ * `{clientName}` → `client.firstName`, чтобы v2-renderer
+ * (`replaceVars` в `v2-renderer.util.ts`) находил их по тому же ключу,
+ * по которому резолверы возвращают значения. Без этой карты после
+ * миграции все `{var}` в письмах висели бы пустыми.
+ *
+ * Источник правды для целевых id'ов:
+ *  - `client.resolver.ts`, `profile.resolver.ts`, `order.resolver.ts`,
+ *    `questroom.resolver.ts`, `location.resolver.ts`, `promocode.resolver.ts`,
+ *    `booking-link.resolver.ts` — `.declare()` каждого
+ *
+ * Что НЕ маппится (намеренно, остаётся как flat id):
+ *  - `photos`, `orderDetailsHtml` — block-payload плейсхолдеры, у которых
+ *    нет резолвера: значение собирается отдельной HTML-строкой на этапе
+ *    рендеринга (видим как `htmlCodeBlock` в TipTap-doc).
+ *  - `servicesList` — функция выпилена; флэт-id оставлен в `KNOWN_PLACEHOLDERS`,
+ *    чтобы legacy `{servicesList}` распознавался как variable-чип и
+ *    дропался нормализатором, а не оставался литеральным текстом.
+ *  - `bookingManagementLink` — спецзначение, используется в `button.url`
+ *    с `isUrlVariable:true`, никогда как inline-text variable.
+ *  - `manageBooking` — служебная директива `{{#manageBooking}}`, уже
+ *    распакована в `button`-ноду на этапе HTML-parse.
+ *
+ * Спорные кейсы:
+ *  - `website` → `location.site` (а не `profile.site`): в legacy `v2-renderer`
+ *    есть приоритет «если есть location.site, использовать его, иначе
+ *    profile.site». В новой схеме фолбэк делает резолвер. Если у профиля
+ *    нет локации (рассылка) — `location.site` будет пустым; templates
+ *    должны быть defensive (inline fallback или if-block).
+ *  - `prepareInfo` → `questroom.prepareText`: в crm-crosssales.json комментарий
+ *    говорит «из настроек локации», но в текущих резолверах prepare-info
+ *    лежит на квесте (`questroom.prepareText`). Источник правды — резолвер.
+ */
+exports.LEGACY_TO_NAMESPACED_ID_MAP = {
+    clientName: 'client.firstName',
+    childName: 'client.childName',
+    questroomTitle: 'questroom.title',
+    importantInfo: 'questroom.importantInfo',
+    prepareInfo: 'questroom.prepareText',
+    promocode: 'promocode.code',
+    discount: 'promocode.discount',
+    validity: 'promocode.expireDate',
+    website: 'location.site',
+    howToFindLocation: 'location.howToFind',
+    phone: 'location.phone',
+    address: 'location.address',
+    date: 'order.date',
+    gameResult: 'order.result',
+    additionalInfo: 'order.additionalInfo',
+    // Booking-only переменные (см. `OrderBookingVariableResolver`):
+    // в legacy шаблонах попадались редко, но если есть — маппим, чтобы
+    // не потерять смысл. Если письмо НЕ booking-confirmation, рендер
+    // оставит их пустыми (резолвер живёт только в CustomBookingTemplate).
+    players: 'order.players',
+    mode: 'order.mode',
+    /*
+     * Удалённые из declare()-стека, но ВСЁ ЕЩЁ встречающиеся в проде
+     * legacy-шаблонах. Маппим, чтобы конвертер не дропал и не оставлял
+     * как литеральный текст; на рендере они получат пустую строку и
+     * пользователь увидит «дыру», после чего сам поправит шаблон.
+     *
+     * Не пытаемся переадресовать на что-то «похожее» — это потеряло бы
+     * смысл (`order.code` ≠ `bookingManagementLink`).
+     */
+    code: 'order.code',
+    currency: 'order.currency',
+    comment: 'order.comment',
+    birthday: 'client.birthday',
+    questroomPhoto: 'questroom.photo',
+    /*
+     * `profileTitle` → инлайн-замена на буквальное название компании.
+     * Сам маппинг id'а сюда не пишем (мы хотим, чтобы это превратилось
+     * в `text`-ноду, а не в `variable`). Замена реализована через
+     * `inlineValues` в `convertLegacyHtmlToEmailContent`, см.
+     * `from-html.ts`.
+     */
+};
+/**
+ * Нормализация id переменной для нового формата. Если id есть в
+ * маппинге — возвращаем namespaced версию; иначе оставляем как есть
+ * (block-payload'ы, неизвестные кастомные токены, токены, которые
+ * пользователь добавил вручную).
+ */
+const normalizePlaceholderId = (id) => exports.LEGACY_TO_NAMESPACED_ID_MAP[id] ?? id;
+exports.normalizePlaceholderId = normalizePlaceholderId;

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

@@ -0,0 +1,31 @@
+/**
+ * HTML → plain-text utility. Используется в `marketing-email-variables`-
+ * резолверах для полей, которые юзер заполняет через Quill-редактор:
+ * `questroom.importantInfo`, `questroom.prepareText`, `location.howToFind`,
+ * `order.additionalInfo`. Без чистки эти строки приезжают в Maily-render
+ * как HTML-разметка (`<p>`, `<strong>`, `&nbsp;`, `<a>`), а Maily
+ * подставляет variable-значения как текст с экранированием — юзер видит
+ * литеральные `<p>` / `&amp;nbsp;` в письме.
+ *
+ * Стратегия:
+ *   - `<a href="X">Y</a>` → `Y` (ссылку убираем целиком, текст оставляем).
+ *     Пользователь сам делает «очищать ссылки» — см. quill setting'и в
+ *     админке. Здесь backend-safety net на случай legacy/не-cleaned данных.
+ *   - block-теги (`<p>` / `<div>` / `<br>` / `<h*>` / `<li>` / `<tr>`)
+ *     → пробел, чтобы соседние параграфы не слипались.
+ *   - inline-теги (`<strong>` / `<em>` / `<span>` / `<u>`) → убираем,
+ *     контент сохраняем.
+ *   - HTML-entities декодируем (`&nbsp;` → пробел, `&amp;` → `&`, и т.д.).
+ *   - Whitespace runs (включая `\n` / `\t`) сжимаем в один пробел.
+ *
+ * Что НЕ делаем (сознательно):
+ *   - не сохраняем формат (bold/italic): Maily-`variable`-нода рендерит
+ *     значение как plain text, теги внутри значения остаются буквальными.
+ *     Если когда-то понадобится rich-text-подстановка — отдельная история
+ *     (надо конвертить HTML в TipTap-ноды и инлайнить в doc, см.
+ *     `convertLegacyHtmlToEmailContent`).
+ *   - не сохраняем переносы строк: Maily-render не превращает `\n` в
+ *     `<br>` (он эмитит весь текст одним `Fragment`), так что переносы
+ *     визуально не видны. Лучше один параграф, чем «странные» дыры.
+ */
+export declare function stripHtml(input: string | undefined | null): string;

package/dist/email-builder/strip-html.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripHtml = stripHtml;
+/**
+ * HTML → plain-text utility. Используется в `marketing-email-variables`-
+ * резолверах для полей, которые юзер заполняет через Quill-редактор:
+ * `questroom.importantInfo`, `questroom.prepareText`, `location.howToFind`,
+ * `order.additionalInfo`. Без чистки эти строки приезжают в Maily-render
+ * как HTML-разметка (`<p>`, `<strong>`, `&nbsp;`, `<a>`), а Maily
+ * подставляет variable-значения как текст с экранированием — юзер видит
+ * литеральные `<p>` / `&amp;nbsp;` в письме.
+ *
+ * Стратегия:
+ *   - `<a href="X">Y</a>` → `Y` (ссылку убираем целиком, текст оставляем).
+ *     Пользователь сам делает «очищать ссылки» — см. quill setting'и в
+ *     админке. Здесь backend-safety net на случай legacy/не-cleaned данных.
+ *   - block-теги (`<p>` / `<div>` / `<br>` / `<h*>` / `<li>` / `<tr>`)
+ *     → пробел, чтобы соседние параграфы не слипались.
+ *   - inline-теги (`<strong>` / `<em>` / `<span>` / `<u>`) → убираем,
+ *     контент сохраняем.
+ *   - HTML-entities декодируем (`&nbsp;` → пробел, `&amp;` → `&`, и т.д.).
+ *   - Whitespace runs (включая `\n` / `\t`) сжимаем в один пробел.
+ *
+ * Что НЕ делаем (сознательно):
+ *   - не сохраняем формат (bold/italic): Maily-`variable`-нода рендерит
+ *     значение как plain text, теги внутри значения остаются буквальными.
+ *     Если когда-то понадобится rich-text-подстановка — отдельная история
+ *     (надо конвертить HTML в TipTap-ноды и инлайнить в doc, см.
+ *     `convertLegacyHtmlToEmailContent`).
+ *   - не сохраняем переносы строк: Maily-render не превращает `\n` в
+ *     `<br>` (он эмитит весь текст одним `Fragment`), так что переносы
+ *     визуально не видны. Лучше один параграф, чем «странные» дыры.
+ */
+function stripHtml(input) {
+    if (input == null)
+        return '';
+    let s = String(input);
+    if (!s)
+        return '';
+    /*
+     * Ссылки: `<a ...>текст</a>` → `текст`. Atomic-replace, чтобы
+     * после общего `<[^>]+>` strip'а не осталось «голого» URL'а из
+     * `href`. Поддерживаем оба варианта кавычек.
+     */
+    s = s.replace(/<a\b[^>]*>([\s\S]*?)<\/a>/gi, '$1');
+    /*
+     * Block-теги → пробел. `<br>` сюда тоже попадает, потому что в
+     * plain-output мы хотим иметь хотя бы пробел между «строками»
+     * (Maily всё равно склеит, но без пробела получим `Lorem Ipsumis`
+     * вместо `Lorem Ipsum is` если рядом стояли блочные теги).
+     */
+    s = s.replace(/<\/?(p|div|br|h[1-6]|li|tr|ul|ol)\b[^>]*>/gi, ' ');
+    // Все остальные теги — просто убираем, контент сохраняем.
+    s = s.replace(/<[^>]+>/g, '');
+    /*
+     * HTML-entities decode. Делаем явный whitelist популярных вместо
+     * полного html-entities-парсера (лишняя зависимость) — этих
+     * хватает для всех кейсов, которые реально выходят из Quill.
+     */
+    s = s
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&#160;/g, ' ')
+        .replace(/&#xa0;/gi, ' ')
+        .replace(/\u00A0/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&apos;/g, "'");
+    // Сжимаем whitespace runs (включая newlines/tabs) в один пробел.
+    return s.replace(/\s+/g, ' ').trim();
+}

package/dist/email-builder/strip-html.test.d.ts

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

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

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const strip_html_1 = require("./strip-html");
+describe('stripHtml', () => {
+    describe('базовые кейсы', () => {
+        it('возвращает пустую строку для null/undefined/пустого ввода', () => {
+            expect((0, strip_html_1.stripHtml)(null)).toBe('');
+            expect((0, strip_html_1.stripHtml)(undefined)).toBe('');
+            expect((0, strip_html_1.stripHtml)('')).toBe('');
+        });
+        it('plain-текст без HTML отдаёт как есть', () => {
+            expect((0, strip_html_1.stripHtml)('Hello, world')).toBe('Hello, world');
+        });
+        it('тримит ведущие/замыкающие пробелы', () => {
+            expect((0, strip_html_1.stripHtml)('   hello   ')).toBe('hello');
+        });
+    });
+    describe('block-теги (превращаются в пробел)', () => {
+        it('<p>...</p><p>...</p> → "первый второй" с пробелом', () => {
+            expect((0, strip_html_1.stripHtml)('<p>first</p><p>second</p>')).toBe('first second');
+        });
+        it('<br> между словами не склеивает слова', () => {
+            expect((0, strip_html_1.stripHtml)('a<br>b')).toBe('a b');
+        });
+        it('<div> + <h1-6> тоже считаются блочными', () => {
+            expect((0, strip_html_1.stripHtml)('<h1>Title</h1><div>Body</div>')).toBe('Title Body');
+        });
+        it('<ul>/<ol>/<li> сжимаются с пробелами вокруг', () => {
+            expect((0, strip_html_1.stripHtml)('<ul><li>a</li><li>b</li></ul>')).toBe('a b');
+        });
+    });
+    describe('inline-теги (убираются, контент остаётся)', () => {
+        it('<strong>X</strong> → X', () => {
+            expect((0, strip_html_1.stripHtml)('<strong>Bold</strong>')).toBe('Bold');
+        });
+        it('<em>/<span>/<u> аналогично', () => {
+            expect((0, strip_html_1.stripHtml)('<em>i</em><span>s</span><u>u</u>')).toBe('isu');
+        });
+        it('вложенные inline-теги корректно разворачиваются', () => {
+            expect((0, strip_html_1.stripHtml)('<strong><em>Bold italic</em></strong>')).toBe('Bold italic');
+        });
+    });
+    describe('ссылки', () => {
+        it('<a href="X">Y</a> → "Y" (ссылка убирается, текст остаётся)', () => {
+            expect((0, strip_html_1.stripHtml)('Click <a href="https://example.com">here</a>')).toBe('Click here');
+        });
+        it('ссылка с любыми атрибутами тоже схлопывается до текста', () => {
+            const html = '<a href="https://x.com" rel="noopener" target="_blank">link</a>';
+            expect((0, strip_html_1.stripHtml)(html)).toBe('link');
+        });
+        it('пустая ссылка (без текста внутри) исчезает', () => {
+            expect((0, strip_html_1.stripHtml)('a<a href="x"></a>b')).toBe('ab');
+        });
+    });
+    describe('HTML-entities', () => {
+        it('&nbsp; → пробел', () => {
+            expect((0, strip_html_1.stripHtml)('a&nbsp;b')).toBe('a b');
+        });
+        it('&#160; / &#xa0; / NBSP-юникод → пробел', () => {
+            expect((0, strip_html_1.stripHtml)('a&#160;b')).toBe('a b');
+            expect((0, strip_html_1.stripHtml)('a&#xA0;b')).toBe('a b');
+            expect((0, strip_html_1.stripHtml)('a\u00A0b')).toBe('a b');
+        });
+        it('&amp; → &, &lt;/&gt; → </>', () => {
+            expect((0, strip_html_1.stripHtml)('A &amp; B')).toBe('A & B');
+            expect((0, strip_html_1.stripHtml)('&lt;tag&gt;')).toBe('<tag>');
+        });
+        it('&quot; / &#39; / &apos; → " и \'', () => {
+            expect((0, strip_html_1.stripHtml)('&quot;hi&quot; &#39;there&#39; &apos;dude&apos;')).toBe('"hi" \'there\' \'dude\'');
+        });
+    });
+    describe('whitespace', () => {
+        it('множественные пробелы сжимаются в один', () => {
+            expect((0, strip_html_1.stripHtml)('a    b')).toBe('a b');
+        });
+        it('переносы строк и табы — тоже whitespace', () => {
+            expect((0, strip_html_1.stripHtml)('a\n\nb\t\tc')).toBe('a b c');
+        });
+        it('лидирующий/трейлинг nbsp обрезается', () => {
+            expect((0, strip_html_1.stripHtml)('&nbsp;&nbsp;hello&nbsp;&nbsp;')).toBe('hello');
+        });
+    });
+    describe('реалистичные кейсы из Quill', () => {
+        it('Lorem ipsum с &nbsp; внутри слов и <p>-обёрткой', () => {
+            const html = '<p><strong>Lorem&nbsp;Ipsum</strong>&nbsp;is&nbsp;simply&nbsp;dummy&nbsp;text.</p>';
+            expect((0, strip_html_1.stripHtml)(html)).toBe('Lorem Ipsum is simply dummy text.');
+        });
+        it('параграф с inline-ссылкой и форматированием', () => {
+            const html = '<p><strong>Donate:</strong> click <strong><a href="https://www.lipsum.com/donate" rel="noopener noreferrer" target="_blank">here</a></strong> to donate using PayPal.</p>';
+            expect((0, strip_html_1.stripHtml)(html)).toBe('Donate: click here to donate using PayPal.');
+        });
+        it('идемпотентность: повторный strip уже plain-строки ничего не меняет', () => {
+            const once = (0, strip_html_1.stripHtml)('<p>hello&nbsp;world</p>');
+            const twice = (0, strip_html_1.stripHtml)(once);
+            expect(once).toBe('hello world');
+            expect(twice).toBe('hello world');
+        });
+    });
+});

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './agreement-config';
+export * from './booking-lead-time';
 export * from './convert-hhmm-to-minutes';
 export * from './convert-minutes-to-hhmm';
 export * from './convert-to-options';
@@ -19,6 +20,7 @@ export * from './redirect';
 export * from './serialize-record';
 export * from './serialize-slot';
 export * from './slot-representative-price';
+export * from './strip-html-tags';
 export * from './tz-date';
 export * from './user-session-permissions';
 export * from './utm-touchpoints';

package/dist/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./agreement-config"), exports);
+__exportStar(require("./booking-lead-time"), exports);
 __exportStar(require("./convert-hhmm-to-minutes"), exports);
 __exportStar(require("./convert-minutes-to-hhmm"), exports);
 __exportStar(require("./convert-to-options"), exports);
@@ -35,6 +36,7 @@ __exportStar(require("./redirect"), exports);
 __exportStar(require("./serialize-record"), exports);
 __exportStar(require("./serialize-slot"), exports);
 __exportStar(require("./slot-representative-price"), exports);
+__exportStar(require("./strip-html-tags"), exports);
 __exportStar(require("./tz-date"), exports);
 __exportStar(require("./user-session-permissions"), exports);
 __exportStar(require("./utm-touchpoints"), exports);

package/dist/sanitize-quill-html.d.ts

@@ -28,7 +28,23 @@
 export type SanitizeQuillHtmlOptions = {
     /** Снять inline-цвета/фоны и `ql-color-*`/`ql-background-*` классы. */
     stripColors?: boolean;
+    /**
+     * Удалить `<a>`-обёртки, сохранив только текст внутри. Используется
+     * для полей с `noLinks={true}` (`howToFind` / `prepareText` локации,
+     * importantInfo квеста и пр.), где ссылка только мешает: рендерится
+     * в orders/widget на разных темах, ссылается куда попало, ломает
+     * автогенерируемые UTM. Сам ReactQuill кнопку link в toolbar'е
+     * прячет через `noLinks`, но paste из браузера/Word всё равно
+     * протаскивает `<a>` атомарно — этот пост-санитайзер закрывает дыру.
+     */
+    stripLinks?: boolean;
 };
+/**
+ * Удаляет `<a>`-обёртки, сохраняя текст. Поддерживает вложенные форматы
+ * внутри ссылки (`<a><strong>text</strong></a>` → `<strong>text</strong>`).
+ * Идемпотентна: повторный вызов на уже очищенном HTML возвращает то же.
+ */
+export declare function stripQuillLinks(html: string): string;
 export declare function stripQuillColors(html: string): string;
 export declare function normalizeQuillWhitespace(html: string): string;
 export declare function sanitizeQuillHtml(html: string | null | undefined, options?: SanitizeQuillHtmlOptions): string;

package/dist/sanitize-quill-html.js

@@ -27,6 +27,7 @@
  * на стороне клиентских настроек, см. `client-agreement.tsx`).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripQuillLinks = stripQuillLinks;
 exports.stripQuillColors = stripQuillColors;
 exports.normalizeQuillWhitespace = normalizeQuillWhitespace;
 exports.sanitizeQuillHtml = sanitizeQuillHtml;
@@ -47,6 +48,14 @@ function cleanStyleAttribute(style) {
     })
         .join('; ');
 }
+/**
+ * Удаляет `<a>`-обёртки, сохраняя текст. Поддерживает вложенные форматы
+ * внутри ссылки (`<a><strong>text</strong></a>` → `<strong>text</strong>`).
+ * Идемпотентна: повторный вызов на уже очищенном HTML возвращает то же.
+ */
+function stripQuillLinks(html) {
+    return html.replace(/<a\b[^>]*>([\s\S]*?)<\/a>/gi, '$1');
+}
 function stripQuillColors(html) {
     return html
         .replace(/\s*style="([^"]*)"/gi, (_match, styleContent) => {
@@ -98,12 +107,17 @@ function sanitizeQuillHtml(html, options) {
     if (!html)
         return '';
     const stripColors = options?.stripColors ? '1' : '0';
-    const key = `${stripColors}|${html}`;
+    const stripLinks = options?.stripLinks ? '1' : '0';
+    const key = `${stripColors}|${stripLinks}|${html}`;
     const cached = cache.get(key);
     if (cached !== undefined)
         return cached;
-    const colorStripped = options?.stripColors ? stripQuillColors(html) : html;
-    const result = normalizeQuillWhitespace(colorStripped);
+    let intermediate = html;
+    if (options?.stripColors)
+        intermediate = stripQuillColors(intermediate);
+    if (options?.stripLinks)
+        intermediate = stripQuillLinks(intermediate);
+    const result = normalizeQuillWhitespace(intermediate);
     cache.set(key, result);
     return result;
 }

package/dist/sanitize-quill-html.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Узкая проверка опций `sanitizeQuillHtml` (особенно `stripLinks`,
+ * добавленной для полей с `noLinks={true}` в location-форме).
+ *
+ * Полная регрессия `normalizeQuillWhitespace` / `stripQuillColors` —
+ * предмет отдельных рег-тестов; здесь ловим именно регрессию ссылок.
+ */
+export {};