@escapenavigator/utils 1.10.133 → 1.10.135

package/dist/promocode-nominal-rules.js

@@ -2,7 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.findNominalRule = findNominalRule;
 exports.isPromocodeApplicableToNominal = isPromocodeApplicableToNominal;
+exports.getCertificateMode = getCertificateMode;
 exports.resolveEffectiveNominalDiscount = resolveEffectiveNominalDiscount;
+exports.resolveEffectiveNominalBonus = resolveEffectiveNominalBonus;
+const promocode_certificate_mode_enum_1 = require("@escapenavigator/types/dist/promocode/emun/promocode-certificate-mode.enum");
 /**
  * Поиск правила промокода для конкретного номинала. Возвращает запись из
  * `certificateNominalRules` или `null`, если правила нет.
@@ -15,7 +18,7 @@ function findNominalRule(promocode, nominalId) {
 /**
  * Применим ли промокод к данному номиналу: scope охватывает сертификаты и есть
  * явное правило для `nominal.id`. Если правил нет — промокод к номиналу не
- * применяется (магазин показывает базовую скидку номинала).
+ * применяется (магазин показывает базовую скидку номинала и не начисляет бонус).
  */
 function isPromocodeApplicableToNominal(promocode, nominal) {
     if (!promocode?.availableForCertificates)
@@ -23,17 +26,45 @@ function isPromocodeApplicableToNominal(promocode, nominal) {
     return findNominalRule(promocode, nominal.id) !== null;
 }
 /**
- * Эффективная скидка номинала с учётом промокода (если он применим).
+ * Режим действия для сертификатов с дефолтом в `DISCOUNT` для старых промокодов
+ * без поля `certificateMode`.
+ */
+function getCertificateMode(promocode) {
+    return promocode?.certificateMode ?? promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.DISCOUNT;
+}
+/**
+ * Эффективная скидка номинала на цену покупки сертификата.
  * Возвращает значение в минимальных единицах валюты.
  *
- * - Промокод применим к номиналу → скидка из правила.
- * - Иначе — базовый `nominal.discount` (или 0).
+ * - Промокод применим к номиналу и режим = `DISCOUNT` → значение из правила.
+ * - Режим = `BONUS` или промокод не применим → базовый `nominal.discount` (или 0).
+ *
+ * Помните: для режима `BONUS` цена не уменьшается, бонус начисляется отдельно
+ * (см. `resolveEffectiveNominalBonus`).
  */
 function resolveEffectiveNominalDiscount(promocode, nominal) {
-    const rule = isPromocodeApplicableToNominal(promocode, nominal)
-        ? findNominalRule(promocode, nominal.id)
-        : null;
+    const applicable = isPromocodeApplicableToNominal(promocode, nominal);
+    const isDiscountMode = getCertificateMode(promocode) === promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.DISCOUNT;
+    const rule = applicable && isDiscountMode ? findNominalRule(promocode, nominal.id) : null;
     if (rule)
         return Math.max(0, rule.discount || 0);
     return Math.max(0, nominal.discount || 0);
 }
+/**
+ * Эффективный бонус к балансу сертификата от промокода.
+ * Возвращает значение в минимальных единицах валюты.
+ *
+ * - Промокод применим к номиналу и режим = `BONUS` → значение из правила.
+ * - В остальных случаях → 0.
+ *
+ * Бонус НЕ уменьшает цену покупки — он прибавляется к усваиваемому
+ * балансу сертификата (`nominal + bonus - usedAmount`).
+ */
+function resolveEffectiveNominalBonus(promocode, nominal) {
+    if (!isPromocodeApplicableToNominal(promocode, nominal))
+        return 0;
+    if (getCertificateMode(promocode) !== promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.BONUS)
+        return 0;
+    const rule = findNominalRule(promocode, nominal.id);
+    return Math.max(0, rule?.discount || 0);
+}

package/dist/promocode-nominal-rules.spec.js

@@ -1,9 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const promocode_certificate_mode_enum_1 = require("@escapenavigator/types/dist/promocode/emun/promocode-certificate-mode.enum");
 const promocode_nominal_rules_1 = require("./promocode-nominal-rules");
 const baseNominal = { id: 10, discount: 500 };
-const promocodeWithRule = {
+const promocodeDiscountWithRule = {
     availableForCertificates: true,
+    certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.DISCOUNT,
+    certificateNominalRules: [
+        { nominalId: 10, discount: 1500 },
+        { nominalId: 20, discount: 700 },
+    ],
+};
+const promocodeLegacyNoMode = {
+    availableForCertificates: true,
+    certificateNominalRules: [{ nominalId: 10, discount: 1500 }],
+};
+const promocodeBonusWithRule = {
+    availableForCertificates: true,
+    certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.BONUS,
     certificateNominalRules: [
         { nominalId: 10, discount: 1500 },
         { nominalId: 20, discount: 700 },
@@ -11,21 +25,23 @@ const promocodeWithRule = {
 };
 const promocodeWithoutRule = {
     availableForCertificates: true,
+    certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.DISCOUNT,
     certificateNominalRules: [{ nominalId: 99, discount: 1500 }],
 };
 const promocodeBookingsOnly = {
     availableForCertificates: false,
+    certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.DISCOUNT,
     certificateNominalRules: [{ nominalId: 10, discount: 1500 }],
 };
 describe('findNominalRule', () => {
     it('returns rule when nominal matches', () => {
-        expect((0, promocode_nominal_rules_1.findNominalRule)(promocodeWithRule, 10)).toEqual({
+        expect((0, promocode_nominal_rules_1.findNominalRule)(promocodeDiscountWithRule, 10)).toEqual({
             nominalId: 10,
             discount: 1500,
         });
     });
     it('returns null when nominal not in rules', () => {
-        expect((0, promocode_nominal_rules_1.findNominalRule)(promocodeWithRule, 999)).toBeNull();
+        expect((0, promocode_nominal_rules_1.findNominalRule)(promocodeDiscountWithRule, 999)).toBeNull();
     });
     it('returns null on empty/missing data', () => {
         expect((0, promocode_nominal_rules_1.findNominalRule)(null, 10)).toBeNull();
@@ -36,7 +52,10 @@ describe('findNominalRule', () => {
 });
 describe('isPromocodeApplicableToNominal', () => {
     it('true only when scope=certificates and rule exists', () => {
-        expect((0, promocode_nominal_rules_1.isPromocodeApplicableToNominal)(promocodeWithRule, baseNominal)).toBe(true);
+        expect((0, promocode_nominal_rules_1.isPromocodeApplicableToNominal)(promocodeDiscountWithRule, baseNominal)).toBe(true);
+    });
+    it('true for bonus-mode promocodes when scope=certificates and rule exists', () => {
+        expect((0, promocode_nominal_rules_1.isPromocodeApplicableToNominal)(promocodeBonusWithRule, baseNominal)).toBe(true);
     });
     it('false when no rule for nominal', () => {
         expect((0, promocode_nominal_rules_1.isPromocodeApplicableToNominal)(promocodeWithoutRule, baseNominal)).toBe(false);
@@ -49,8 +68,14 @@ describe('isPromocodeApplicableToNominal', () => {
     });
 });
 describe('resolveEffectiveNominalDiscount', () => {
-    it('returns rule discount when applicable', () => {
-        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalDiscount)(promocodeWithRule, baseNominal)).toBe(1500);
+    it('returns rule discount when applicable and mode=discount', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalDiscount)(promocodeDiscountWithRule, baseNominal)).toBe(1500);
+    });
+    it('returns rule discount for legacy promocode without certificateMode (defaults to DISCOUNT)', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalDiscount)(promocodeLegacyNoMode, baseNominal)).toBe(1500);
+    });
+    it('returns base discount (not rule) when mode=bonus', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalDiscount)(promocodeBonusWithRule, baseNominal)).toBe(500);
     });
     it('returns base nominal discount when no rule', () => {
         expect((0, promocode_nominal_rules_1.resolveEffectiveNominalDiscount)(promocodeWithoutRule, baseNominal)).toBe(500);
@@ -62,6 +87,7 @@ describe('resolveEffectiveNominalDiscount', () => {
     it('clamps negative rule discount to 0', () => {
         expect((0, promocode_nominal_rules_1.resolveEffectiveNominalDiscount)({
             availableForCertificates: true,
+            certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.DISCOUNT,
             certificateNominalRules: [{ nominalId: 10, discount: -50 }],
         }, baseNominal)).toBe(0);
     });
@@ -72,3 +98,39 @@ describe('resolveEffectiveNominalDiscount', () => {
         expect((0, promocode_nominal_rules_1.resolveEffectiveNominalDiscount)(null, { id: 10 })).toBe(0);
     });
 });
+describe('resolveEffectiveNominalBonus', () => {
+    it('returns rule value when applicable and mode=bonus', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)(promocodeBonusWithRule, baseNominal)).toBe(1500);
+    });
+    it('returns 0 when mode=discount', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)(promocodeDiscountWithRule, baseNominal)).toBe(0);
+    });
+    it('returns 0 for legacy promocode without certificateMode (defaults to DISCOUNT)', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)(promocodeLegacyNoMode, baseNominal)).toBe(0);
+    });
+    it('returns 0 when no rule for nominal', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)({
+            availableForCertificates: true,
+            certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.BONUS,
+            certificateNominalRules: [{ nominalId: 99, discount: 1500 }],
+        }, baseNominal)).toBe(0);
+    });
+    it('returns 0 when scope excludes certificates', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)({
+            availableForCertificates: false,
+            certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.BONUS,
+            certificateNominalRules: [{ nominalId: 10, discount: 1500 }],
+        }, baseNominal)).toBe(0);
+    });
+    it('returns 0 on missing promocode', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)(null, baseNominal)).toBe(0);
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)(undefined, baseNominal)).toBe(0);
+    });
+    it('clamps negative rule value to 0', () => {
+        expect((0, promocode_nominal_rules_1.resolveEffectiveNominalBonus)({
+            availableForCertificates: true,
+            certificateMode: promocode_certificate_mode_enum_1.PromocodeCertificateModeEnum.BONUS,
+            certificateNominalRules: [{ nominalId: 10, discount: -100 }],
+        }, baseNominal)).toBe(0);
+    });
+});

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 {};

package/dist/sanitize-quill-html.test.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Узкая проверка опций `sanitizeQuillHtml` (особенно `stripLinks`,
+ * добавленной для полей с `noLinks={true}` в location-форме).
+ *
+ * Полная регрессия `normalizeQuillWhitespace` / `stripQuillColors` —
+ * предмет отдельных рег-тестов; здесь ловим именно регрессию ссылок.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const sanitize_quill_html_1 = require("./sanitize-quill-html");
+describe('stripQuillLinks', () => {
+    it('убирает `<a>`-обёртку, оставляет текст', () => {
+        const html = 'click <a href="https://example.com">here</a> to donate';
+        expect((0, sanitize_quill_html_1.stripQuillLinks)(html)).toBe('click here to donate');
+    });
+    it('поддерживает вложенные форматы внутри ссылки', () => {
+        const html = '<strong><a href="https://x.com" rel="noopener" target="_blank">here</a></strong>';
+        expect((0, sanitize_quill_html_1.stripQuillLinks)(html)).toBe('<strong>here</strong>');
+    });
+    it('обрабатывает несколько ссылок', () => {
+        const html = '<a href="a">one</a> and <a href="b">two</a>';
+        expect((0, sanitize_quill_html_1.stripQuillLinks)(html)).toBe('one and two');
+    });
+    it('идемпотентна', () => {
+        const html = 'click <a href="x">here</a>';
+        expect((0, sanitize_quill_html_1.stripQuillLinks)((0, sanitize_quill_html_1.stripQuillLinks)(html))).toBe((0, sanitize_quill_html_1.stripQuillLinks)(html));
+    });
+    it('игнорирует пустой ввод', () => {
+        expect((0, sanitize_quill_html_1.stripQuillLinks)('')).toBe('');
+    });
+});
+describe('sanitizeQuillHtml — combo `stripLinks` + nbsp + colors', () => {
+    it('по умолчанию ссылки сохраняет, &nbsp; нормализует', () => {
+        const html = '<p><a href="x">link</a>&nbsp;text</p>';
+        expect((0, sanitize_quill_html_1.sanitizeQuillHtml)(html)).toBe('<p><a href="x">link</a> text</p>');
+    });
+    it('`stripLinks: true` убирает ссылку, оставляет текст и нормализует пробелы', () => {
+        const html = '<p>click <a href="https://x">here</a>&nbsp;to&nbsp;donate</p>';
+        expect((0, sanitize_quill_html_1.sanitizeQuillHtml)(html, { stripLinks: true })).toBe('<p>click here to donate</p>');
+    });
+    it('`stripColors: true` + `stripLinks: true` чистит и цвет, и ссылку', () => {
+        const html = '<p style="color: red;"><a href="x" style="color: red;">link</a> text</p>';
+        const result = (0, sanitize_quill_html_1.sanitizeQuillHtml)(html, { stripColors: true, stripLinks: true });
+        expect(result).not.toContain('<a');
+        expect(result).not.toContain('color');
+        expect(result).toContain('link');
+    });
+    it('кеш разделяет результаты для разных опций', () => {
+        const html = '<a href="x">y</a>';
+        const withLinks = (0, sanitize_quill_html_1.sanitizeQuillHtml)(html);
+        const stripped = (0, sanitize_quill_html_1.sanitizeQuillHtml)(html, { stripLinks: true });
+        expect(withLinks).toContain('<a');
+        expect(stripped).not.toContain('<a');
+        // Повторный вызов с теми же опциями возвращает тот же результат
+        expect((0, sanitize_quill_html_1.sanitizeQuillHtml)(html, { stripLinks: true })).toBe(stripped);
+    });
+    it('пустой/null/undefined ввод → пустая строка', () => {
+        expect((0, sanitize_quill_html_1.sanitizeQuillHtml)('', { stripLinks: true })).toBe('');
+        expect((0, sanitize_quill_html_1.sanitizeQuillHtml)(null, { stripLinks: true })).toBe('');
+        expect((0, sanitize_quill_html_1.sanitizeQuillHtml)(undefined, { stripLinks: true })).toBe('');
+    });
+});
+describe('stripQuillColors smoke', () => {
+    it('убирает inline color/background style', () => {
+        const html = '<p style="color: red; background: yellow;">text</p>';
+        const result = (0, sanitize_quill_html_1.stripQuillColors)(html);
+        expect(result).not.toContain('color');
+        expect(result).not.toContain('background');
+        expect(result).toContain('text');
+    });
+});

package/dist/strip-html-tags.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Убираем HTML-теги из строки и схлопываем пробелы.
+ *
+ * Используется, когда поле раньше редактировалось через Quill (и в БД мог
+ * попасть HTML), а теперь рендерится в обычном `<Textarea>`/inline-тексте.
+ * Если не вычистить, пользователь видит `<p>текст</p>` буквально (см. `teaser`
+ * в форме редактирования квеста: на момент миграции с Quill на Textarea в
+ * локалях остались записи с открывающими/закрывающими тегами).
+ *
+ * Функция чистая и идемпотентная: повторный вызов на уже очищенной строке
+ * возвращает её же.
+ */
+export declare function stripHtmlTags(text: string | null | undefined): string;

package/dist/strip-html-tags.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripHtmlTags = stripHtmlTags;
+/**
+ * Убираем HTML-теги из строки и схлопываем пробелы.
+ *
+ * Используется, когда поле раньше редактировалось через Quill (и в БД мог
+ * попасть HTML), а теперь рендерится в обычном `<Textarea>`/inline-тексте.
+ * Если не вычистить, пользователь видит `<p>текст</p>` буквально (см. `teaser`
+ * в форме редактирования квеста: на момент миграции с Quill на Textarea в
+ * локалях остались записи с открывающими/закрывающими тегами).
+ *
+ * Функция чистая и идемпотентная: повторный вызов на уже очищенной строке
+ * возвращает её же.
+ */
+function stripHtmlTags(text) {
+    if (!text)
+        return '';
+    return text
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&nbsp;|&#160;|&#xa0;|\u00A0/gi, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "1.10.133",
+  "version": "1.10.135",
   "publishConfig": {
     "access": "public"
   },
@@ -14,11 +14,12 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^1.10.129",
+    "@escapenavigator/types": "^1.10.131",
     "axios": "^0.21.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
     "i18next": "^21.6.4",
+    "node-html-parser": "^7.1.0",
     "quill-delta": "^5.1.0"
   },
   "devDependencies": {
@@ -27,5 +28,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "25c61a2bd7e70a03406358540c8b2b7b2d76bd3a"
+  "gitHead": "cb2f3ab38ef5b8b2a38ab5b2c485e484a0cf9414"
 }