@escapenavigator/utils 1.10.170 → 1.10.172

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

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

package/dist/classify-api-error.spec.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const classify_api_error_1 = require("./classify-api-error");
+/**
+ * Триаж API-ошибок — это «входной фильтр» всего, что попадает в Sentry как
+ * `severity=business`. Если он сломается, бизнес-инциденты либо утонут в шуме
+ * (debug вместо business), либо наоборот зафлудят дашборд (business на каждый
+ * отменённый axios-запрос). Поэтому фиксируем каждую ветку классификатора.
+ */
+describe('classifyApiError', () => {
+    const base = { apiKey: 'createPreorder', method: 'POST', url: '/openapi/orders' };
+    describe('skip (не репортим)', () => {
+        it('отменённый axios-запрос (ERR_CANCELED) → skip', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, code: 'ERR_CANCELED' });
+            expect(r.severity).toBe('skip');
+            expect(r.shouldReport).toBe(false);
+        });
+        it('304 (etag-success) → skip', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, status: 304 });
+            expect(r.shouldReport).toBe(false);
+        });
+        it('401/403 на app/auth → skip (ожидаемый session/role flow)', () => {
+            expect((0, classify_api_error_1.classifyApiError)({ ...base, status: 401, app: 'app' }).shouldReport).toBe(false);
+            expect((0, classify_api_error_1.classifyApiError)({ ...base, status: 403, app: 'auth' }).shouldReport).toBe(false);
+        });
+        it('401/403 на widget/orders → НЕ skip (сигнал мониторинга)', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, status: 403, app: 'widget' });
+            expect(r.shouldReport).toBe(true);
+            expect(r.severity).toBe('debug');
+        });
+    });
+    describe('critical', () => {
+        it.each([500, 502, 503, 504])('%s → critical с status в fingerprint', (status) => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, status });
+            expect(r.severity).toBe('critical');
+            expect(r.level).toBe('error');
+            expect(r.fingerprint).toContain(String(status));
+        });
+        it('таймаут без status (ECONNABORTED) → critical', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, code: 'ECONNABORTED' });
+            expect(r.severity).toBe('critical');
+            expect(r.fingerprint).toContain('ECONNABORTED');
+        });
+        it('совсем странный кейс (нет status/code/message) → critical, дефолтный fingerprint', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({ apiKey: 'x' });
+            expect(r.severity).toBe('critical');
+            expect(r.fingerprint).toBeNull();
+        });
+    });
+    describe('business (4xx с бизнес-кодом — то, ради чего всё затевалось)', () => {
+        it('4xx + конкретный errorCode → business, fingerprint по apiKey+code', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, status: 400, errorCode: 'slotAlreadyOccupied' });
+            expect(r.severity).toBe('business');
+            expect(r.level).toBe('warning');
+            expect(r.fingerprint).toEqual([
+                'api',
+                'business',
+                'createPreorder',
+                'slotAlreadyOccupied',
+            ]);
+        });
+        it('тот же код на разных слотах схлопывается в один issue (стабильный fingerprint)', () => {
+            const a = (0, classify_api_error_1.classifyApiError)({ ...base, status: 400, errorCode: 'slotAlreadyOccupied' });
+            const b = (0, classify_api_error_1.classifyApiError)({ ...base, status: 409, errorCode: 'slotAlreadyOccupied' });
+            expect(a.fingerprint).toEqual(b.fingerprint);
+        });
+        it('падает на originalErrorCode, если errorCode пуст', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({
+                ...base,
+                status: 400,
+                originalErrorCode: 'bookingWindowClosed',
+            });
+            expect(r.severity).toBe('business');
+            expect(r.fingerprint).toContain('bookingWindowClosed');
+        });
+        it('мобильный обрыв (timeout of 0ms) → business/info', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({
+                ...base,
+                code: 'ECONNABORTED',
+                message: 'timeout of 0ms exceeded',
+            });
+            expect(r.severity).toBe('business');
+            expect(r.level).toBe('info');
+            expect(r.fingerprint).toContain('mobile-abort');
+        });
+        it('чистый network error → business', () => {
+            expect((0, classify_api_error_1.classifyApiError)({ ...base, code: 'ERR_NETWORK' }).severity).toBe('business');
+            expect((0, classify_api_error_1.classifyApiError)({ ...base, message: 'Network Error' }).severity).toBe('business');
+        });
+    });
+    describe('debug (generic 4xx — шум, но репортим info-level)', () => {
+        it.each([
+            'BAD_REQUEST',
+            'INTERNAL_ERROR',
+            'VALIDATION_ERROR',
+            'DEFAULT',
+        ])('generic-код %s → debug, НЕ business', (errorCode) => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, status: 400, errorCode });
+            expect(r.severity).toBe('debug');
+            expect(r.level).toBe('info');
+        });
+        it('4xx вообще без кода → debug', () => {
+            const r = (0, classify_api_error_1.classifyApiError)({ ...base, status: 422 });
+            expect(r.severity).toBe('debug');
+        });
+    });
+});
+describe('isOfflineNetworkRelatedEvent', () => {
+    it('ловит network/timeout по message', () => {
+        expect((0, classify_api_error_1.isOfflineNetworkRelatedEvent)('Network Error')).toBe(true);
+        expect((0, classify_api_error_1.isOfflineNetworkRelatedEvent)('timeout of 25000ms exceeded')).toBe(true);
+    });
+    it('ловит по original exception code', () => {
+        expect((0, classify_api_error_1.isOfflineNetworkRelatedEvent)('boom', { originalException: { code: 'ERR_NETWORK' } })).toBe(true);
+    });
+    it('обычную ошибку не считает сетевой', () => {
+        expect((0, classify_api_error_1.isOfflineNetworkRelatedEvent)('slot already occupied')).toBe(false);
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@escapenavigator/utils",
-  "version": "1.10.170",
+  "version": "1.10.172",
   "publishConfig": {
     "access": "public"
   },
@@ -14,7 +14,7 @@
     "test": "jest"
   },
   "dependencies": {
-    "@escapenavigator/types": "^1.10.163",
+    "@escapenavigator/types": "^1.10.164",
     "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": "ad28ed8f74f9a00d33dffd883d7f9ed26d596629"
+  "gitHead": "ec475db7eb7e2365207a19ac0e6cd15f86be35ac"
 }