@andrey4emk/npm-app-back-b24 5.1.0 → 5.2.0

package/bitrix24/b24/retry.ts

@@ -133,8 +133,11 @@ export function retryDelayFor(error: unknown, attempt: number): number {
     return isNonJsonResponseError(error) ? NON_JSON_RETRY_BASE_DELAY_MS * 2 ** (attempt - 1) : RETRY_DELAY_MS;
 }
 
+/** Начало фразы про создающий вызов — по нему уровень отмены повтора отличает её от резервирующей */
+const CREATING_REASON_HEAD = "вызов создаёт сущности (";
+
 /** Фраза для лога: повтор отменён, потому что вызов создаёт сущности */
-const creatingReason = (what: string): string => `вызов создаёт сущности (${what})`;
+const creatingReason = (what: string): string => `${CREATING_REASON_HEAD}${what})`;
 
 /** Фраза для лога: повтор отменён, потому что вызов резервирует данные на портале */
 const reservingReason = (what: string): string => `вызов резервирует данные на портале (${what})`;
@@ -447,8 +450,12 @@ export async function runWithRetry<T>(fn: () => Promise<T>, label: string, block
             // потеряться уже после того, как портал его выполнил. Различить нельзя,
             // поэтому вызовы под ограничением не повторяем — лучше вернуть ошибку,
             // чем создать дубликат или потерять зарезервированный пакет
+            // Отмена только резервирующего вызова (event.offline.get) — warn: приложение и так
+            // пишет свою строку error о том же сбое, а две строки дали бы два сообщения в
+            // Телеграме. Отмена создающего остаётся error: сущность могла не создаться
             if (blockReason && !proven) {
-                logs.add(`${label}${code}: повтор отменён, ${blockReason} — ${msg}`, "error");
+                const level = blockReason.includes(CREATING_REASON_HEAD) ? "error" : "warn";
+                logs.add(`${label}${code}: повтор отменён, ${blockReason} — ${msg}`, level);
                 throw error;
             }
 

package/logs/logs.ts

@@ -68,6 +68,26 @@ function describeSendError(error: unknown): string {
     return typeof causeLabel === "string" && causeLabel ? `${name} (${causeLabel})` : name;
 }
 
+/**
+ * Признаки разового сетевого сбоя в тексте error-лога: обрыв, таймаут, недоступный хост.
+ * Проверяется текст, а не тип ошибки: строки о сбое пишут и сами приложения
+ * («Не удалось получить события. read ECONNRESET»), типа ошибки у логгера нет
+ */
+const NETWORK_FAILURE_RE =
+    /ECONNRESET|socket hang up|ETIMEDOUT|ECONNREFUSED|EHOSTUNREACH|ENETUNREACH|ENOTFOUND|EAI_AGAIN|UND_ERR_SOCKET|UND_ERR_CONNECT_TIMEOUT|Request timeout exceeded|fetch failed|other side closed|Error connecting to authorization server/i;
+
+/**
+ * Строки с сетевым признаком, которые уходят сразу и по одной: отменённое создание
+ * сущности, провал обмена токена, неизвестный статус доставки — их разбирает человек
+ */
+const NETWORK_KEEP_RE = /вызов создаёт сущности|обновление токена не удалось|статус неизвестен/;
+
+/** Окно, за которое считаются сетевые сбои, и пауза между сводками, мс */
+const NETWORK_WINDOW_MS = 15 * 60_000;
+
+/** Со скольких сетевых сбоев за окно в Телеграм уходит сводка */
+const NETWORK_THRESHOLD = 3;
+
 /** Ключ ретранслятора — только видимые символы ASCII, без пробелов и управляющих */
 const RELAY_KEY_RE = /^[\x21-\x7e]+$/;
 
@@ -140,6 +160,12 @@ class LogsAPI {
     /** Ключ клиента ретранслятора (`LOG_RELAY_KEY`); `undefined` — канал выключен */
     private readonly relayKey: string | undefined;
 
+    /** Время сетевых сбоев за последние `NETWORK_WINDOW_MS`, мс */
+    private networkFailures: number[] = [];
+
+    /** Когда ушла последняя сводка сетевых сбоев, мс */
+    private lastNetworkSummaryAt = Number.NEGATIVE_INFINITY;
+
     constructor() {
         this.initConfig();
         const url = process.env.LOG_RELAY_URL?.trim() || undefined;
@@ -189,6 +215,7 @@ class LogsAPI {
      * независимо от настройки `error.enabled` в `log.json`. Настройка `enabled`
      * управляет только выводом в консоль. Это сделано намеренно, чтобы критические
      * ошибки всегда доходили до команды даже при отключённом консольном логировании.
+     * Исключение — разовые сетевые сбои: они уходят сводкой, см. `routeToRelay()`.
      *
      * @param message - Текст сообщения или объект для вывода
      * @param level - Уровень логирования (trace, debug, info, warn, error)
@@ -204,7 +231,7 @@ class LogsAPI {
         // В консоль ниже уходят исходные message и jsonData — маскировка телефонов
         // касается только текста для Телеграма
         if (levelStr === "error") {
-            this.sendToRelay(messageText, jsonData);
+            this.routeToRelay(messageText, jsonData);
         }
 
         // Проверяем конфиг, и если логирование отключено, то выходим
@@ -228,6 +255,36 @@ class LogsAPI {
         }
     }
 
+    /**
+     * Решает, уходит ли error-лог в Телеграм сразу.
+     *
+     * Разовый сетевой сбой проходит сам, а сообщение о нём в Телеграме — шум: 25.10.2026
+     * один недоступный сервер авторизации дал 14 сообщений подряд. Поэтому строка
+     * с сетевым признаком остаётся только в консоли, а в Телеграм уходит одна сводка,
+     * когда за 15 минут набралось 3 сбоя и больше; следующая — не раньше чем через 15 минут.
+     * Длинный обрыв так и виден — сводкой раз в 15 минут.
+     */
+    private routeToRelay(message: string, jsonData?: unknown): void {
+        if (!this.relayUrl || !this.relayKey) return;
+
+        if (!NETWORK_FAILURE_RE.test(message) || NETWORK_KEEP_RE.test(message)) {
+            this.sendToRelay(message, jsonData);
+            return;
+        }
+
+        const now = Date.now();
+        this.networkFailures = this.networkFailures.filter((at) => now - at < NETWORK_WINDOW_MS);
+        this.networkFailures.push(now);
+
+        if (this.networkFailures.length < NETWORK_THRESHOLD) return;
+        if (now - this.lastNetworkSummaryAt < NETWORK_WINDOW_MS) return;
+
+        this.lastNetworkSummaryAt = now;
+        const minutes = NETWORK_WINDOW_MS / 60_000;
+        const summary = `Сетевые сбои: ${this.networkFailures.length} за ${minutes} мин (одиночные в Телеграм не отправляются, все строки — в логе контейнера). Последний:\n${message}`;
+        this.sendToRelay(summary, jsonData);
+    }
+
     /**
      * Готовит текст error-лога и отправляет его в ретранслятор (fire-and-forget).
      *

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@andrey4emk/npm-app-back-b24",
-    "version": "5.1.0",
+    "version": "5.2.0",
     "description": "Bitrix24 OAuth helpers for Node.js projects",
     "main": "index.ts",
     "type": "module",