@andrey4emk/npm-app-back-b24 3.1.0 → 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,19 +73,19 @@ class LogsAPI {
 
     private readonly resetColor = "\x1b[0m";
 
-    /** Токен Telegram-бота для отправки error-логов */
-    private readonly tgBotToken: string | undefined;
+    /** Webhook URL для отправки error-логов в B24 чат */
+    private readonly b24WebhookUrl: string | undefined;
 
-    /** ID чата Telegram для отправки error-логов */
-    private readonly tgChatId: string | undefined;
+    /** ID чата B24 для отправки error-логов (формат: chatXXXXXX) */
+    private readonly b24ChatId: string | undefined;
 
     /** Имя приложения для заголовка сообщения */
     private readonly appName: string;
 
     constructor() {
         this.initConfig();
-        this.tgBotToken = process.env.LOG_TG_BOT_TOKEN;
-        this.tgChatId = process.env.LOG_TG_CHAT_ID;
+        this.b24WebhookUrl = process.env.LOG_B24_WEBHOOK_URL;
+        this.b24ChatId = process.env.LOG_B24_CHAT_ID;
         this.appName = process.env.APP_NAME || "Unknown App";
     }
 
@@ -89,6 +100,12 @@ class LogsAPI {
 
     /**
      * Добавляет сообщение в лог
+     *
+     * Важно: при уровне `error` сообщение отправляется в B24 чат (через webhook)
+     * независимо от настройки `error.enabled` в `log.json`. Настройка `enabled`
+     * управляет только выводом в консоль. Это сделано намеренно, чтобы критические
+     * ошибки всегда доходили до команды даже при отключённом консольном логировании.
+     *
      * @param message - Текст сообщения или объект для вывода
      * @param level - Уровень логирования (trace, debug, info, warn, error)
      * @param jsonData - Дополнительные данные для вывода (опционально)
@@ -97,9 +114,9 @@ class LogsAPI {
         const levelStr: LogLevel = level || "info";
         const messageText = typeof message === "string" ? message : JSON.stringify(message);
 
-        // Отправляем error-логи в Telegram независимо от настроек консольного вывода
+        // Отправляем error-логи в B24 чат независимо от настроек консольного вывода
         if (levelStr === "error") {
-            this.sendToTelegram(messageText, jsonData);
+            this.sendToB24Chat(messageText, jsonData);
         }
 
         // Проверяем конфиг, и если логирование отключено, то выходим
@@ -123,22 +140,26 @@ class LogsAPI {
         }
     }
 
-    /** Лимит длины текста для Telegram (с запасом на HTML-обёртку) */
-    private readonly TG_TEXT_LIMIT = 4000;
+    /**
+     * Убирает BB-теги для plain text отправки (при обрезке текста)
+     */
+    private stripBbCodes(text: string): string {
+        return text.replace(/\[\/?(b|code)\]/g, "");
+    }
 
     /**
-     * Отправляет сообщение в Telegram-чат (fire-and-forget)
+     * Отправляет error-сообщение в чат B24 через webhook (fire-and-forget)
      * Использует нативный fetch, а не fetchRetry — во избежание циклической зависимости
      * Ошибки не пробрасываются, только console.error
      */
-    private sendToTelegram(message: string, jsonData?: unknown): void {
-        if (!this.tgBotToken || !this.tgChatId) return;
+    private sendToB24Chat(message: string, jsonData?: unknown): void {
+        if (!this.b24WebhookUrl || !this.b24ChatId) return;
 
-        const url = `https://api.telegram.org/bot${this.tgBotToken}/sendMessage`;
+        // Нормализуем URL — гарантируем trailing slash
+        const baseUrl = this.b24WebhookUrl.endsWith("/") ? this.b24WebhookUrl : `${this.b24WebhookUrl}/`;
+        const url = `${baseUrl}imbot.message.add.json`;
 
-        // Экранируем HTML-спецсимволы в тексте сообщения
-        const escapedMessage = this.escapeHtml(message);
-        let text = `<b>ERROR</b> | ${this.escapeHtml(this.appName)}\n${escapedMessage}`;
+        let text = `[b]ERROR[/b] | ${this.appName}\n${message}`;
 
         // Добавляем jsonData если есть
         if (jsonData !== undefined) {
@@ -149,59 +170,42 @@ class LogsAPI {
             } catch {
                 jsonStr = "[Не удалось сериализовать jsonData]";
             }
-            text += `\n<pre>${this.escapeHtml(jsonStr)}</pre>`;
+            text += `\n[code]${jsonStr}[/code]`;
         }
 
-        // Обрезаем до лимита Telegram
+        // Обрезаем до лимита B24
         let isTruncated = false;
-        if (text.length > this.TG_TEXT_LIMIT) {
+        if (text.length > B24_TEXT_LIMIT) {
             const truncatedSuffix = "\n...(обрезано)";
-            text = text.slice(0, this.TG_TEXT_LIMIT - truncatedSuffix.length) + truncatedSuffix;
+            text = text.slice(0, B24_TEXT_LIMIT - truncatedSuffix.length) + truncatedSuffix;
             isTruncated = true;
         }
 
-        // Если текст обрезан — отправляем как plain text, чтобы не разорвать HTML-теги
+        // Если текст обрезан — отправляем без BB-тегов, чтобы не разорвать [code]...[/code]
         if (isTruncated) {
-            text = this.stripHtml(text);
+            text = this.stripBbCodes(text);
         }
 
         fetch(url, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify({
-                chat_id: this.tgChatId,
-                text,
-                ...(isTruncated ? {} : { parse_mode: "HTML" }),
+                BOT_ID: B24_BOT_ID,
+                CLIENT_ID: B24_CLIENT_ID,
+                DIALOG_ID: this.b24ChatId,
+                MESSAGE: text,
             }),
         })
             .then((response) => {
                 if (!response.ok) {
-                    console.error(`Logs Telegram: HTTP ${response.status}`);
+                    console.error(`Logs B24 Chat: HTTP ${response.status}`);
                 }
             })
             .catch((error: unknown) => {
                 const errMsg = error instanceof Error ? error.message : String(error);
-                console.error(`Logs Telegram: ошибка отправки — ${errMsg}`);
+                console.error(`Logs B24 Chat: ошибка отправки — ${errMsg}`);
             });
     }
-
-    /** Экранирует HTML-спецсимволы для Telegram parse_mode HTML */
-    private escapeHtml(text: string): string {
-        return text
-            .replace(/&/g, "&amp;")
-            .replace(/</g, "&lt;")
-            .replace(/>/g, "&gt;");
-    }
-
-    /** Убирает HTML-теги и декодирует HTML-entities для plain text отправки */
-    private stripHtml(text: string): string {
-        return text
-            .replace(/<\/?b>/g, "")
-            .replace(/<\/?pre>/g, "")
-            .replace(/&lt;/g, "<")
-            .replace(/&gt;/g, ">")
-            .replace(/&amp;/g, "&");
-    }
 }
 
 export const logs = new LogsAPI();

package/package.json

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