@andrey4emk/npm-app-back-b24 3.0.2 → 3.2.0

package/logs/logs.ts

@@ -19,6 +19,17 @@ interface LogLevelConfig {
 /** Полная конфигурация логирования */
 type LogConfig = Record<LogLevel, LogLevelConfig>;
 
+// ==================== Константы B24 Chat ====================
+
+/** ID бота в B24 для отправки error-логов */
+const B24_BOT_ID = 66600;
+
+/** CLIENT_ID бота в B24 */
+const B24_CLIENT_ID = "6rf74zyu842h6op1z186b08k7aavqq7z";
+
+/** Лимит длины сообщения для B24 чата (безопасный, с запасом на BB-обёртку) */
+const B24_TEXT_LIMIT = 4000;
+
 // ==================== Настройки ====================
 
 const configDir: string = process.env.CONFIG_DIR || "../config";
@@ -62,8 +73,20 @@ class LogsAPI {
 
     private readonly resetColor = "\x1b[0m";
 
+    /** Webhook URL для отправки error-логов в B24 чат */
+    private readonly b24WebhookUrl: string | undefined;
+
+    /** ID чата B24 для отправки error-логов (формат: chatXXXXXX) */
+    private readonly b24ChatId: string | undefined;
+
+    /** Имя приложения для заголовка сообщения */
+    private readonly appName: string;
+
     constructor() {
         this.initConfig();
+        this.b24WebhookUrl = process.env.LOG_B24_WEBHOOK_URL;
+        this.b24ChatId = process.env.LOG_B24_CHAT_ID;
+        this.appName = process.env.APP_NAME || "Unknown App";
     }
 
     /** Проверяем и заполняем конфиг дефолтными значениями если данных нет */
@@ -77,12 +100,24 @@ class LogsAPI {
 
     /**
      * Добавляет сообщение в лог
+     *
+     * Важно: при уровне `error` сообщение отправляется в B24 чат (через webhook)
+     * независимо от настройки `error.enabled` в `log.json`. Настройка `enabled`
+     * управляет только выводом в консоль. Это сделано намеренно, чтобы критические
+     * ошибки всегда доходили до команды даже при отключённом консольном логировании.
+     *
      * @param message - Текст сообщения или объект для вывода
      * @param level - Уровень логирования (trace, debug, info, warn, error)
      * @param jsonData - Дополнительные данные для вывода (опционально)
      */
     add(message: string | object, level?: LogLevel, jsonData?: unknown): void {
         const levelStr: LogLevel = level || "info";
+        const messageText = typeof message === "string" ? message : JSON.stringify(message);
+
+        // Отправляем error-логи в B24 чат независимо от настроек консольного вывода
+        if (levelStr === "error") {
+            this.sendToB24Chat(messageText, jsonData);
+        }
 
         // Проверяем конфиг, и если логирование отключено, то выходим
         const isLoggingEnabled = confLog.get(`${levelStr}.enabled`) as boolean;
@@ -90,8 +125,6 @@ class LogsAPI {
             return;
         }
 
-        const messageText = typeof message === "string" ? message : JSON.stringify(message);
-
         // Получаем цвет для уровня
         const color = (confLog.get(`${levelStr}.color`) as string) || "\x1b[37m";
 
@@ -106,6 +139,73 @@ class LogsAPI {
             console.dir(jsonData, { depth: null, colors: true });
         }
     }
+
+    /**
+     * Убирает BB-теги для plain text отправки (при обрезке текста)
+     */
+    private stripBbCodes(text: string): string {
+        return text.replace(/\[\/?(b|code)\]/g, "");
+    }
+
+    /**
+     * Отправляет error-сообщение в чат B24 через webhook (fire-and-forget)
+     * Использует нативный fetch, а не fetchRetry — во избежание циклической зависимости
+     * Ошибки не пробрасываются, только console.error
+     */
+    private sendToB24Chat(message: string, jsonData?: unknown): void {
+        if (!this.b24WebhookUrl || !this.b24ChatId) return;
+
+        // Нормализуем URL — гарантируем trailing slash
+        const baseUrl = this.b24WebhookUrl.endsWith("/") ? this.b24WebhookUrl : `${this.b24WebhookUrl}/`;
+        const url = `${baseUrl}imbot.message.add.json`;
+
+        let text = `[b]ERROR[/b] | ${this.appName}\n${message}`;
+
+        // Добавляем jsonData если есть
+        if (jsonData !== undefined) {
+            // Безопасная сериализация — логгер не должен бросать исключения
+            let jsonStr: string;
+            try {
+                jsonStr = JSON.stringify(jsonData, null, 2);
+            } catch {
+                jsonStr = "[Не удалось сериализовать jsonData]";
+            }
+            text += `\n[code]${jsonStr}[/code]`;
+        }
+
+        // Обрезаем до лимита B24
+        let isTruncated = false;
+        if (text.length > B24_TEXT_LIMIT) {
+            const truncatedSuffix = "\n...(обрезано)";
+            text = text.slice(0, B24_TEXT_LIMIT - truncatedSuffix.length) + truncatedSuffix;
+            isTruncated = true;
+        }
+
+        // Если текст обрезан — отправляем без BB-тегов, чтобы не разорвать [code]...[/code]
+        if (isTruncated) {
+            text = this.stripBbCodes(text);
+        }
+
+        fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                BOT_ID: B24_BOT_ID,
+                CLIENT_ID: B24_CLIENT_ID,
+                DIALOG_ID: this.b24ChatId,
+                MESSAGE: text,
+            }),
+        })
+            .then((response) => {
+                if (!response.ok) {
+                    console.error(`Logs B24 Chat: HTTP ${response.status}`);
+                }
+            })
+            .catch((error: unknown) => {
+                const errMsg = error instanceof Error ? error.message : String(error);
+                console.error(`Logs B24 Chat: ошибка отправки — ${errMsg}`);
+            });
+    }
 }
 
 export const logs = new LogsAPI();

package/package.json

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

package/utils/fetchRetry.ts

@@ -64,7 +64,7 @@ export async function fetchRetry(
 
             logs.add(
                 `fetchRetry: попытка ${attempt}/${retries} не удалась (${lastError.message}), повтор через ${delay}мс — ${String(url)}`,
-                "error"
+                "warn"
             );
 
             await new Promise((resolve) => setTimeout(resolve, delay));