@escapenavigator/utils 2.0.0 → 2.0.3

package/dist/format-promocode-discount/index.d.ts

@@ -0,0 +1,7 @@
+import { PromocodeTypeEnum } from '@escapenavigator/types/dist/promocode/emun/promocode-type.enum';
+/**
+ * Format promocode discount for display.
+ * Fixed amounts are stored in minor units (cents); percent values are stored
+ * as hundredths of a percent (1500 → 15%).
+ */
+export declare const formatPromocodeDiscount: (type: PromocodeTypeEnum, discount: number, currency: string, clientDescription?: string | null) => string;

package/dist/format-promocode-discount/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatPromocodeDiscount = void 0;
+const promocode_type_enum_1 = require("@escapenavigator/types/dist/promocode/emun/promocode-type.enum");
+const format_amount_1 = require("../format-amount");
+/**
+ * Format promocode discount for display.
+ * Fixed amounts are stored in minor units (cents); percent values are stored
+ * as hundredths of a percent (1500 → 15%).
+ */
+const formatPromocodeDiscount = (type, discount, currency, clientDescription) => {
+    if (type === promocode_type_enum_1.PromocodeTypeEnum.PROMOTIONAL) {
+        return clientDescription?.trim() || '—';
+    }
+    if (type === promocode_type_enum_1.PromocodeTypeEnum.FIXED) {
+        return (0, format_amount_1.formatAmount)(discount, currency);
+    }
+    return `${discount / 100}%`;
+};
+exports.formatPromocodeDiscount = formatPromocodeDiscount;

package/dist/get-order-cancelation-state/index.d.ts

@@ -22,6 +22,14 @@ type Props = {
     payed: number;
     minimalPrice: number;
     slotDiscount: number;
+    /**
+     * Суммарная стоимость невозвратных допуслуг заказа (напр. страховка от
+     * отмены). Удерживается венью независимо от штрафа и таймингов отмены,
+     * поэтому вычитается из суммы к возврату (с полом 0). Неоплаченная часть
+     * остаётся долгом клиента и учитывается в total заказа (см. updatePrice),
+     * поэтому здесь в chargeAmount не добавляется.
+     */
+    nonRefundableAmount?: number;
 };
 export declare enum FineDescriptions {
     FINE_TON_SETUP = "descriptionFineNotSetup",
@@ -35,7 +43,7 @@ export declare const isCancelationAllowed: ({ date, minHoursForFreeCanceling, }:
     date: string;
     minHoursForFreeCanceling: number;
 }) => boolean;
-export declare function getOrderCancelationState({ cancelationReason, cancelationRule, cancelationAmount, transactions, date, returnCertificates, forceFine, certificates, minHoursForFreeCanceling, minHoursForFullFine, playersPrice, slotDiscount, payed, minimalPrice, }: Props): {
+export declare function getOrderCancelationState({ cancelationReason, cancelationRule, cancelationAmount, transactions, date, returnCertificates, forceFine, certificates, minHoursForFreeCanceling, minHoursForFullFine, playersPrice, slotDiscount, payed, minimalPrice, nonRefundableAmount, }: Props): {
     fineAmount: number;
     returnAmount: number;
     allowedCancelation: boolean;

package/dist/get-order-cancelation-state/index.js

@@ -22,7 +22,9 @@ var FineDescriptions;
 })(FineDescriptions || (exports.FineDescriptions = FineDescriptions = {}));
 const isCancelationAllowed = ({ date, minHoursForFreeCanceling = 0, }) => (0, date_1.differenceInHours)(new Date(date), new Date()) >= minHoursForFreeCanceling;
 exports.isCancelationAllowed = isCancelationAllowed;
-function getOrderCancelationState({ cancelationReason, cancelationRule, cancelationAmount, transactions, date, returnCertificates, forceFine, certificates, minHoursForFreeCanceling, minHoursForFullFine, playersPrice, slotDiscount = 0, payed, minimalPrice, }) {
+function getOrderCancelationState({ cancelationReason, cancelationRule, cancelationAmount, transactions, date, returnCertificates, forceFine, certificates, minHoursForFreeCanceling, minHoursForFullFine, playersPrice, slotDiscount = 0, payed, minimalPrice, nonRefundableAmount = 0, }) {
+    // Удерживаем стоимость невозвратных услуг из суммы к возврату (пол 0).
+    const withholdNonRefundable = (amount) => Math.max(0, +(amount - nonRefundableAmount).toFixed(0));
     const halfFineCancelation = cancelationRule !== questroom_cancelation_type_enum_1.QuestroomCancelationTypeEnum.NO &&
         cancelationReason !== order_cancel_reson_enum_1.OrderCancelReasonEnum.QUESTROOM &&
         !(0, exports.isCancelationAllowed)({
@@ -69,7 +71,7 @@ function getOrderCancelationState({ cancelationReason, cancelationRule, cancelat
             return {
                 fineAmount: 0,
                 chargeAmount: 0,
-                returnAmount: receivedTransactionsAmount,
+                returnAmount: withholdNonRefundable(receivedTransactionsAmount),
                 allowedCancelation,
                 type: fineAmount ? FineDescriptions.NO_FINE : FineDescriptions.FINE_TON_SETUP,
             };
@@ -78,7 +80,7 @@ function getOrderCancelationState({ cancelationReason, cancelationRule, cancelat
         return {
             fineAmount: 0,
             chargeAmount: 0,
-            returnAmount: receivedTransactionsAmount,
+            returnAmount: withholdNonRefundable(receivedTransactionsAmount),
             allowedCancelation,
             type: autoReturtAvailable ? FineDescriptions.AUTO_RETURN : FineDescriptions.HAND_RETURN,
         };
@@ -96,7 +98,7 @@ function getOrderCancelationState({ cancelationReason, cancelationRule, cancelat
         };
     }
     if (chargeAmount < 0) {
-        const returnAmount = +(chargeAmount * -1).toFixed(0);
+        const returnAmount = withholdNonRefundable(+(chargeAmount * -1).toFixed(0));
         const allowAutoReturn = !slotDiscount && autoReturtAvailable && receivedTransactionsAmount >= returnAmount;
         return {
             type: allowAutoReturn ? FineDescriptions.AUTO_RETURN : FineDescriptions.HAND_RETURN,

package/dist/get-order-cancelation-state/index.test.js

@@ -253,4 +253,96 @@ describe('getOrderCancelationState function', () => {
             allowedCancelation: false,
         });
     });
+    test('should withhold non-refundable amount from return on in-time cancelation', () => {
+        const result = (0, _1.getOrderCancelationState)({
+            cancelationReason: order_cancel_reson_enum_1.OrderCancelReasonEnum.CLIENT,
+            slotDiscount: 0,
+            cancelationAmount: 0,
+            minHoursForFullFine: 0,
+            cancelationRule: questroom_cancelation_type_enum_1.QuestroomCancelationTypeEnum.FULL_PRICE,
+            transactions: [
+                {
+                    amount: 120,
+                    type: transaction_type_enum_1.TransactionTypeEnum.INSIDE,
+                },
+            ],
+            date: (0, date_1.addHours)(new Date(), 50).toISOString(),
+            returnCertificates: true,
+            certificates: [],
+            minHoursForFreeCanceling: 48,
+            playersPrice: 100,
+            payed: 120,
+            minimalPrice: 50,
+            nonRefundableAmount: 20,
+        });
+        expect(result).toEqual({
+            type: 'descriptionFineWithReturn',
+            fineAmount: 0,
+            returnAmount: 100,
+            chargeAmount: 0,
+            allowedCancelation: true,
+        });
+    });
+    test('should withhold non-refundable amount on late cancelation with overpayment', () => {
+        const result = (0, _1.getOrderCancelationState)({
+            cancelationReason: order_cancel_reson_enum_1.OrderCancelReasonEnum.CLIENT,
+            slotDiscount: 0,
+            minHoursForFullFine: 0,
+            cancelationAmount: 0,
+            cancelationRule: questroom_cancelation_type_enum_1.QuestroomCancelationTypeEnum.HALF_PRICE,
+            transactions: [
+                {
+                    amount: 120,
+                    type: transaction_type_enum_1.TransactionTypeEnum.SUCCEEDED,
+                },
+            ],
+            date: new Date().toISOString(),
+            returnCertificates: true,
+            certificates: [],
+            minHoursForFreeCanceling: 48,
+            playersPrice: 100,
+            payed: 120,
+            minimalPrice: 50,
+            nonRefundableAmount: 20,
+        });
+        // fine = 50 (half of quest), refund base = 120 - 50 = 70, minus
+        // non-refundable 20 → 50.
+        expect(result).toEqual({
+            type: 'descriptionFineWithAutoReturn',
+            fineAmount: 50,
+            returnAmount: 50,
+            chargeAmount: 0,
+            allowedCancelation: false,
+        });
+    });
+    test('should floor return at 0 when non-refundable amount exceeds refund', () => {
+        const result = (0, _1.getOrderCancelationState)({
+            cancelationReason: order_cancel_reson_enum_1.OrderCancelReasonEnum.CLIENT,
+            slotDiscount: 0,
+            minHoursForFullFine: 0,
+            cancelationAmount: 0,
+            cancelationRule: questroom_cancelation_type_enum_1.QuestroomCancelationTypeEnum.FULL_PRICE,
+            transactions: [
+                {
+                    amount: 120,
+                    type: transaction_type_enum_1.TransactionTypeEnum.INSIDE,
+                },
+            ],
+            date: (0, date_1.addHours)(new Date(), 50).toISOString(),
+            returnCertificates: true,
+            certificates: [],
+            minHoursForFreeCanceling: 48,
+            playersPrice: 100,
+            payed: 120,
+            minimalPrice: 50,
+            nonRefundableAmount: 200,
+        });
+        expect(result).toEqual({
+            type: 'descriptionFineWithReturn',
+            fineAmount: 0,
+            returnAmount: 0,
+            chargeAmount: 0,
+            allowedCancelation: true,
+        });
+    });
 });

package/dist/mask-contacts.d.ts

@@ -0,0 +1,15 @@
+/** Символ-заполнитель для маскированных контактов клиента. */
+export declare const MASK_CHAR = "\u2022";
+/**
+ * Маскирует email, оставляя первый символ локальной части и домен:
+ * `john.doe@mail.com` → `j•••@mail.com`. Пустые/невалидные значения
+ * возвращаются как есть (нечего маскировать).
+ */
+export declare const maskEmail: (email?: string | null) => string;
+/**
+ * Маскирует телефон, оставляя последние 2 цифры:
+ * `+4915112345678` → `+49•••••••78`-подобный вид. Сохраняет ведущий `+`.
+ */
+export declare const maskPhone: (phone?: string | null) => string;
+/** Похоже ли значение на уже замаскированное (содержит символ-заполнитель). */
+export declare const isMaskedContact: (value?: string | null) => boolean;

package/dist/mask-contacts.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMaskedContact = exports.maskPhone = exports.maskEmail = exports.MASK_CHAR = void 0;
+/** Символ-заполнитель для маскированных контактов клиента. */
+exports.MASK_CHAR = '•';
+/**
+ * Маскирует email, оставляя первый символ локальной части и домен:
+ * `john.doe@mail.com` → `j•••@mail.com`. Пустые/невалидные значения
+ * возвращаются как есть (нечего маскировать).
+ */
+const maskEmail = (email) => {
+    if (!email)
+        return email ?? '';
+    const trimmed = String(email).trim();
+    const at = trimmed.indexOf('@');
+    if (at <= 0) {
+        // Нет валидной локальной части — маскируем целиком.
+        return exports.MASK_CHAR.repeat(Math.max(trimmed.length, 3));
+    }
+    const local = trimmed.slice(0, at);
+    const domain = trimmed.slice(at);
+    const firstChar = local[0];
+    return `${firstChar}${exports.MASK_CHAR.repeat(3)}${domain}`;
+};
+exports.maskEmail = maskEmail;
+/**
+ * Маскирует телефон, оставляя последние 2 цифры:
+ * `+4915112345678` → `+49•••••••78`-подобный вид. Сохраняет ведущий `+`.
+ */
+const maskPhone = (phone) => {
+    if (!phone)
+        return phone ?? '';
+    const trimmed = String(phone).trim();
+    const hasPlus = trimmed.startsWith('+');
+    const digits = trimmed.replace(/\D/g, '');
+    if (digits.length <= 2) {
+        return `${hasPlus ? '+' : ''}${exports.MASK_CHAR.repeat(Math.max(digits.length, 3))}`;
+    }
+    const visible = digits.slice(-2);
+    const maskedCount = digits.length - 2;
+    return `${hasPlus ? '+' : ''}${exports.MASK_CHAR.repeat(maskedCount)}${visible}`;
+};
+exports.maskPhone = maskPhone;
+/** Похоже ли значение на уже замаскированное (содержит символ-заполнитель). */
+const isMaskedContact = (value) => !!value && value.includes(exports.MASK_CHAR);
+exports.isMaskedContact = isMaskedContact;

package/dist/role-contact-permissions.d.ts

@@ -0,0 +1,7 @@
+import { RoleRO } from '@escapenavigator/types/dist/role/role.ro';
+export type RoleContactPermissions = Pick<RoleRO, 'totalAccess' | 'canRevealClientContacts'>;
+/**
+ * Право видеть полные контакты клиента (телефон/email) без маскировки.
+ * Владелец (`totalAccess`) видит всегда; остальным нужен явный флаг.
+ */
+export declare const canRevealClientContacts: (role?: RoleContactPermissions | null) => boolean;

package/dist/role-contact-permissions.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canRevealClientContacts = void 0;
+/**
+ * Право видеть полные контакты клиента (телефон/email) без маскировки.
+ * Владелец (`totalAccess`) видит всегда; остальным нужен явный флаг.
+ */
+const canRevealClientContacts = (role) => !!role?.totalAccess || !!role?.canRevealClientContacts;
+exports.canRevealClientContacts = canRevealClientContacts;

package/dist/sanitize-html.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Единственная точка XSS-санитизации HTML перед `dangerouslySetInnerHTML`.
+ *
+ * `sanitizeQuillHtml` исторически только снимала цвета/пробелы и НЕ была защитой
+ * от XSS (сохраняла `<script>`/`<style>`, не резала `onerror=`/`javascript:`).
+ * Здесь через DOMPurify вырезаем скрипты, inline-обработчики событий и опасные
+ * URL-схемы, оставляя обычное форматирование (Quill-HTML договоров, писем,
+ * контента квестов). `isomorphic-dompurify` работает и в браузере, и в Node
+ * (SSR/тесты), поэтому утилита безопасна в общем пакете.
+ */
+export declare function sanitizeHtml(html: string | null | undefined): string;

package/dist/sanitize-html.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeHtml = sanitizeHtml;
+const isomorphic_dompurify_1 = __importDefault(require("isomorphic-dompurify"));
+/**
+ * Единственная точка XSS-санитизации HTML перед `dangerouslySetInnerHTML`.
+ *
+ * `sanitizeQuillHtml` исторически только снимала цвета/пробелы и НЕ была защитой
+ * от XSS (сохраняла `<script>`/`<style>`, не резала `onerror=`/`javascript:`).
+ * Здесь через DOMPurify вырезаем скрипты, inline-обработчики событий и опасные
+ * URL-схемы, оставляя обычное форматирование (Quill-HTML договоров, писем,
+ * контента квестов). `isomorphic-dompurify` работает и в браузере, и в Node
+ * (SSR/тесты), поэтому утилита безопасна в общем пакете.
+ */
+function sanitizeHtml(html) {
+    if (!html)
+        return '';
+    return isomorphic_dompurify_1.default.sanitize(html, {
+        // Ссылки в контенте открываем в новой вкладке — сохраняем `target`,
+        // а `rel="noopener"` навешиваем хуком ниже.
+        ADD_ATTR: ['target'],
+        // `<style>` НЕ запрещаем: DOMPurify санитизирует CSS (убирает @import,
+        // expression и т.п.), а email-превью на нём держат вёрстку. Режем именно
+        // XSS-векторы: скрипты, встраивания и формы (фишинг).
+        FORBID_TAGS: ['script', 'iframe', 'object', 'embed', 'form'],
+        FORBID_ATTR: ['srcdoc'],
+    });
+}
+// Любой `<a target="_blank">` получает `rel="noopener noreferrer"` — защита от
+// tabnabbing и утечки referrer из пользовательского HTML. Не используем
+// `instanceof Element`: в Node (jsdom через isomorphic-dompurify) глобального
+// `Element` нет, поэтому проверяем `nodeName` и наличие методов.
+isomorphic_dompurify_1.default.addHook('afterSanitizeAttributes', (node) => {
+    const el = node;
+    if (el.nodeName === 'A' &&
+        typeof el.getAttribute === 'function' &&
+        typeof el.setAttribute === 'function' &&
+        el.getAttribute('target') === '_blank') {
+        el.setAttribute('rel', 'noopener noreferrer');
+    }
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "2.0.0",
+  "version": "2.0.3",
   "publishConfig": {
     "access": "public"
   },
@@ -14,11 +14,12 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^2.0.0",
+    "@escapenavigator/types": "^2.0.3",
     "axios": "^0.21.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
     "i18next": "^21.6.4",
+    "isomorphic-dompurify": "^3.18.0",
     "libphonenumber-js": "^1.12.24",
     "quill-delta": "^5.1.0"
   },
@@ -28,5 +29,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "4bc136046ad634699417e72afff25e7b28dfbe7a"
+  "gitHead": "13a7f625f7f30f2ae4fb84b7344ef2c51112e8b5"
 }