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

package/logs/logs.ts

@@ -62,8 +62,20 @@ class LogsAPI {
 
     private readonly resetColor = "\x1b[0m";
 
+    /** Токен Telegram-бота для отправки error-логов */
+    private readonly tgBotToken: string | undefined;
+
+    /** ID чата Telegram для отправки error-логов */
+    private readonly tgChatId: 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.appName = process.env.APP_NAME || "Unknown App";
     }
 
     /** Проверяем и заполняем конфиг дефолтными значениями если данных нет */
@@ -83,6 +95,12 @@ class LogsAPI {
      */
     add(message: string | object, level?: LogLevel, jsonData?: unknown): void {
         const levelStr: LogLevel = level || "info";
+        const messageText = typeof message === "string" ? message : JSON.stringify(message);
+
+        // Отправляем error-логи в Telegram независимо от настроек консольного вывода
+        if (levelStr === "error") {
+            this.sendToTelegram(messageText, jsonData);
+        }
 
         // Проверяем конфиг, и если логирование отключено, то выходим
         const isLoggingEnabled = confLog.get(`${levelStr}.enabled`) as boolean;
@@ -90,8 +108,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 +122,86 @@ class LogsAPI {
             console.dir(jsonData, { depth: null, colors: true });
         }
     }
+
+    /** Лимит длины текста для Telegram (с запасом на HTML-обёртку) */
+    private readonly TG_TEXT_LIMIT = 4000;
+
+    /**
+     * Отправляет сообщение в Telegram-чат (fire-and-forget)
+     * Использует нативный fetch, а не fetchRetry — во избежание циклической зависимости
+     * Ошибки не пробрасываются, только console.error
+     */
+    private sendToTelegram(message: string, jsonData?: unknown): void {
+        if (!this.tgBotToken || !this.tgChatId) return;
+
+        const url = `https://api.telegram.org/bot${this.tgBotToken}/sendMessage`;
+
+        // Экранируем HTML-спецсимволы в тексте сообщения
+        const escapedMessage = this.escapeHtml(message);
+        let text = `<b>ERROR</b> | ${this.escapeHtml(this.appName)}\n${escapedMessage}`;
+
+        // Добавляем jsonData если есть
+        if (jsonData !== undefined) {
+            // Безопасная сериализация — логгер не должен бросать исключения
+            let jsonStr: string;
+            try {
+                jsonStr = JSON.stringify(jsonData, null, 2);
+            } catch {
+                jsonStr = "[Не удалось сериализовать jsonData]";
+            }
+            text += `\n<pre>${this.escapeHtml(jsonStr)}</pre>`;
+        }
+
+        // Обрезаем до лимита Telegram
+        let isTruncated = false;
+        if (text.length > this.TG_TEXT_LIMIT) {
+            const truncatedSuffix = "\n...(обрезано)";
+            text = text.slice(0, this.TG_TEXT_LIMIT - truncatedSuffix.length) + truncatedSuffix;
+            isTruncated = true;
+        }
+
+        // Если текст обрезан — отправляем как plain text, чтобы не разорвать HTML-теги
+        if (isTruncated) {
+            text = this.stripHtml(text);
+        }
+
+        fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                chat_id: this.tgChatId,
+                text,
+                ...(isTruncated ? {} : { parse_mode: "HTML" }),
+            }),
+        })
+            .then((response) => {
+                if (!response.ok) {
+                    console.error(`Logs Telegram: HTTP ${response.status}`);
+                }
+            })
+            .catch((error: unknown) => {
+                const errMsg = error instanceof Error ? error.message : String(error);
+                console.error(`Logs Telegram: ошибка отправки — ${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.0.2",
+    "version": "3.1.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));