@escapenavigator/utils 1.10.135 → 1.10.137

package/dist/classify-api-error.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Единая классификация ошибок HTTP для Sentry-репорта во всех фронтах
+ * (`app`, `orders`, `widget`, `auth`).
+ *
+ * Цель: вместо «5xx → шлём, всё остальное → молчим» получить понятную
+ * таксономию, по которой можно фильтровать issue в Sentry-UI и группировать
+ * однотипные бизнес-инциденты.
+ *
+ *   critical → level=error,   tag severity=critical
+ *              5xx, network/timeout онлайн, внутренние ошибки бэка
+ *              без бизнес-кода. Всегда баг — наш или upstream.
+ *
+ *   business → level=warning, tag severity=business
+ *              4xx с конкретным `errorCode` (SLOT_TAKEN, PROMO_INVALID,
+ *              ALREADY_PAID, ...). Не баг сам по себе, но если по одному
+ *              endpoint+code за день копится много событий — повод проверить
+ *              UX или валидацию на бэке.
+ *
+ *   debug    → level=info,    tag severity=debug
+ *              4xx с generic кодом (BAD_REQUEST, INTERNAL_ERROR, DEFAULT)
+ *              без бизнес-смысла, либо валидации форм. Шум, но иногда
+ *              полезно посмотреть.
+ *
+ *   skip     → не репортим
+ *              401/403 (handled через onUnauthorized + редирект на /auth),
+ *              304 (etag-success), отменённые axios-запросы (ERR_CANCELED).
+ *
+ * Группировка (`fingerprint`) делается так, чтобы все события с одинаковым
+ * `apiKey + errorCode` сливались в один issue. Иначе Sentry плодит отдельный
+ * issue под каждое сообщение от бэка («Слот занят на 19:00» vs «Слот занят
+ * на 20:00»), и в дашборде каша.
+ */
+export type ApiErrorSeverity = 'critical' | 'business' | 'debug' | 'skip';
+export type SentryLevel = 'fatal' | 'error' | 'warning' | 'info' | 'debug' | 'log';
+export type ApiErrorClassificationContext = {
+    apiKey: string;
+    method?: string;
+    url?: string;
+    status?: number;
+    /** Сетевой код axios (ECONNABORTED, ERR_CANCELED, ECONNRESET, ...) */
+    code?: string;
+    /** Бизнес-код из тела 4xx-ответа (ErrorData.errorCode) */
+    errorCode?: string;
+    /** Изначальный бизнес-код до маппинга (originalErrorCode) */
+    originalErrorCode?: string;
+};
+export type ApiErrorClassification = {
+    severity: ApiErrorSeverity;
+    /** Sentry level: для skip — не используется. */
+    level: SentryLevel;
+    /**
+     * Группа для fingerprint в Sentry. `null` означает «оставить дефолтный
+     * fingerprint Sentry» (только для уникальных-навсегда событий).
+     */
+    fingerprint: string[] | null;
+    /** Удобный shorthand: `severity !== 'skip'`. */
+    shouldReport: boolean;
+};
+export declare function classifyApiError(ctx: ApiErrorClassificationContext): ApiErrorClassification;

package/dist/classify-api-error.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * Единая классификация ошибок HTTP для Sentry-репорта во всех фронтах
+ * (`app`, `orders`, `widget`, `auth`).
+ *
+ * Цель: вместо «5xx → шлём, всё остальное → молчим» получить понятную
+ * таксономию, по которой можно фильтровать issue в Sentry-UI и группировать
+ * однотипные бизнес-инциденты.
+ *
+ *   critical → level=error,   tag severity=critical
+ *              5xx, network/timeout онлайн, внутренние ошибки бэка
+ *              без бизнес-кода. Всегда баг — наш или upstream.
+ *
+ *   business → level=warning, tag severity=business
+ *              4xx с конкретным `errorCode` (SLOT_TAKEN, PROMO_INVALID,
+ *              ALREADY_PAID, ...). Не баг сам по себе, но если по одному
+ *              endpoint+code за день копится много событий — повод проверить
+ *              UX или валидацию на бэке.
+ *
+ *   debug    → level=info,    tag severity=debug
+ *              4xx с generic кодом (BAD_REQUEST, INTERNAL_ERROR, DEFAULT)
+ *              без бизнес-смысла, либо валидации форм. Шум, но иногда
+ *              полезно посмотреть.
+ *
+ *   skip     → не репортим
+ *              401/403 (handled через onUnauthorized + редирект на /auth),
+ *              304 (etag-success), отменённые axios-запросы (ERR_CANCELED).
+ *
+ * Группировка (`fingerprint`) делается так, чтобы все события с одинаковым
+ * `apiKey + errorCode` сливались в один issue. Иначе Sentry плодит отдельный
+ * issue под каждое сообщение от бэка («Слот занят на 19:00» vs «Слот занят
+ * на 20:00»), и в дашборде каша.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyApiError = classifyApiError;
+/**
+ * Бекенд маппит часть ошибок на эти generic-коды (см.
+ * `packages/utils/src/get-service-error.ts:INTERNAL_SERVICE_ERROR_CODES`).
+ * Если errorCode из этого списка — никакого «бизнеса» в ошибке нет, это
+ * generic-ошибка валидации/внутренней проблемы. Шлём как debug.
+ */
+const GENERIC_ERROR_CODES = new Set([
+    'BAD_REQUEST',
+    'INTERNAL_SERVER_ERROR',
+    'INTERNAL_ERROR',
+    'WS_ERROR',
+    'DEFAULT',
+    'VALIDATION_ERROR',
+]);
+/**
+ * Сетевые axios-коды, которые в продакшене НЕ означают баг фронта/бэка:
+ * ERR_CANCELED — мы сами отменили запрос (см. useApiMethod source.cancel()
+ * на каждом новом fetch). Засчитывать как ошибку нельзя — это нормальный
+ * lifecycle компонента.
+ */
+const SKIP_AXIOS_CODES = new Set(['ERR_CANCELED', 'CANCELED']);
+/**
+ * 401 = expired session, у нас глобальный `onUnauthorized` → редирект на
+ * /auth. Sentry от такого не получает никакой полезной инфы.
+ *
+ * 403 = доступ закрыт. На CRM это тоже expected (роль пользователя), на
+ * widget/orders просто не должно случаться — но если случилось, это
+ * config issue, нам нужен бэк-лог, а не дубль на фронте.
+ *
+ * 304 = успешный ответ при if-none-match (etag), axios считает это
+ * ошибкой только потому что код != 200.
+ */
+const SKIP_HTTP_STATUSES = new Set([401, 403, 304]);
+function classifyApiError(ctx) {
+    const { status, code, apiKey, errorCode, originalErrorCode } = ctx;
+    if (code && SKIP_AXIOS_CODES.has(code)) {
+        return { severity: 'skip', level: 'info', fingerprint: null, shouldReport: false };
+    }
+    if (typeof status === 'number' && SKIP_HTTP_STATUSES.has(status)) {
+        return { severity: 'skip', level: 'info', fingerprint: null, shouldReport: false };
+    }
+    // 5xx → critical. Включаем status в fingerprint, чтобы 502/503/504 не
+    // схлопывались в один issue с 500 — у них разные источники проблем
+    // (proxy/CDN vs само приложение vs gateway-timeout).
+    if (typeof status === 'number' && status >= 500) {
+        return {
+            severity: 'critical',
+            level: 'error',
+            fingerprint: ['api', 'critical', apiKey, String(status), errorCode || '_'],
+            shouldReport: true,
+        };
+    }
+    // 0-status + ECONNABORTED/ETIMEDOUT — наш timeout сработал (по умолчанию
+    // 25s для widget, 0 для остальных). Это сигнал «бэк не успел ответить» —
+    // critical, чтобы видеть на проде если ручка стала медленной.
+    if (!status &&
+        (code === 'ECONNABORTED' || code === 'ETIMEDOUT' || code === 'ECONNRESET')) {
+        return {
+            severity: 'critical',
+            level: 'error',
+            fingerprint: ['api', 'critical', apiKey, code],
+            shouldReport: true,
+        };
+    }
+    // 4xx → business либо debug. Решаем по errorCode из тела ответа:
+    //   - конкретный бизнес-код (SLOT_TAKEN, PROMO_INVALID, ...) → business
+    //   - generic (BAD_REQUEST, INTERNAL_ERROR) или его отсутствие → debug
+    //
+    // Фингерпринт по `apiKey + errorCode`: все события «createPreorder
+    // упал с SLOT_TAKEN» соберутся в один issue, независимо от того,
+    // какой слот занят.
+    if (typeof status === 'number' && status >= 400 && status < 500) {
+        const effectiveCode = errorCode || originalErrorCode;
+        if (effectiveCode && !GENERIC_ERROR_CODES.has(effectiveCode)) {
+            return {
+                severity: 'business',
+                level: 'warning',
+                fingerprint: ['api', 'business', apiKey, effectiveCode],
+                shouldReport: true,
+            };
+        }
+        return {
+            severity: 'debug',
+            level: 'info',
+            fingerprint: ['api', 'debug', apiKey, String(status), effectiveCode || '_'],
+            shouldReport: true,
+        };
+    }
+    // Сюда падают: NETWORK_ERROR без axios-кода, какие-то странные кейсы
+    // без status. Считаем critical, но без агрессивного группирования —
+    // пусть Sentry разберётся по stacktrace.
+    return {
+        severity: 'critical',
+        level: 'error',
+        fingerprint: null,
+        shouldReport: true,
+    };
+}

package/dist/format-amount/index.js

@@ -13,7 +13,7 @@ const getCurrency = (currency) => {
         [profile_currency_1.ProfileCurrencyEnum.CZK]: 'Kč', // Чешская крона
         [profile_currency_1.ProfileCurrencyEnum.PLN]: 'zł', // Польский злотый
         [profile_currency_1.ProfileCurrencyEnum.HUF]: 'Ft', // Венгерский форинт
-        [profile_currency_1.ProfileCurrencyEnum.RUB]: '₽',
+        [profile_currency_1.ProfileCurrencyEnum.RUB]: 'руб.',
         [profile_currency_1.ProfileCurrencyEnum.BGN]: 'лв',
         [profile_currency_1.ProfileCurrencyEnum.CAD]: 'C$',
         [profile_currency_1.ProfileCurrencyEnum.AUD]: '$',

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './agreement-config';
 export * from './booking-lead-time';
+export * from './classify-api-error';
 export * from './convert-hhmm-to-minutes';
 export * from './convert-minutes-to-hhmm';
 export * from './convert-to-options';

package/dist/index.js

@@ -16,6 +16,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("./classify-api-error"), exports);
 __exportStar(require("./convert-hhmm-to-minutes"), exports);
 __exportStar(require("./convert-minutes-to-hhmm"), exports);
 __exportStar(require("./convert-to-options"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "1.10.135",
+  "version": "1.10.137",
   "publishConfig": {
     "access": "public"
   },
@@ -14,7 +14,7 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^1.10.131",
+    "@escapenavigator/types": "^1.10.133",
     "axios": "^0.21.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
@@ -28,5 +28,5 @@
     "ts-jest": "^29.1.1",
     "typescript": "^5.6"
   },
-  "gitHead": "cb2f3ab38ef5b8b2a38ab5b2c485e484a0cf9414"
+  "gitHead": "e6562ef1dbf0652659bc037c3574e4f188663bf1"
 }