feat: add configurable log level and enhance logging functionality

Author: LabEG

README.md

@@ -74,6 +74,9 @@ The server will return a response with the specified status code.
 - `-e BOTVIEW_BLOCK_URLS_REGEX=""` - Comma or space separated list of regular expressions to block URLs, default empty.
   Example: `".*\.ads\..*,.*tracking.*"` will block URLs containing ".ads." or "tracking" anywhere in the URL.
 
+- `-e BOTVIEW_LOG_LEVEL=info` - Log level for the application, default "info".
+  Available levels: `trace`, `debug`, `info`, `warn`, `error`, `fatal`.
+
 ## Troubleshooting Timeout Issues
 
 If you encounter timeout errors during prerendering, it's usually caused by "leaked requests" - network requests that don't complete properly and prevent the page from finishing loading.

src/config.ts

@@ -1,4 +1,6 @@
 // array of basic auths in format "url:login:password" (URL-encoding is optional), use comma or space as separator
+import { LogLevels } from "./services/json-logger.service";
+
 process.env.BASIC_AUTHS ||= void 0;
 process.env.BOTVIEW_BASIC_AUTHS ||= process.env.BASIC_AUTHS; // BASIC_AUTHS - legacy env
 process.env.BOTVIEW_NAV_TIMEOUT ||= "30000"; // ms
@@ -10,11 +12,27 @@ process.env.BOTVIEW_BLOCK_FONTS ||= "true"; // true to block fonts
 process.env.BOTVIEW_BLOCK_MEDIA ||= "true"; // true to block media
 process.env.BOTVIEW_BLOCK_URLS ||= "https://an.yandex.ru, https://mc.yandex.ru"; // comma or space separated list of urls to block (URL-encoding is optional)
 process.env.BOTVIEW_BLOCK_URLS_REGEX ||= ""; // comma or space separated list of regexes to block (URL-encoding is optional)
+process.env.BOTVIEW_LOG_LEVEL ||= LogLevels.INFO.toString(); // log level: trace, debug, info, warn, error, fatal
+
+function getLogLevelChecked(logLevel: string): number {
+    // Если это число и оно есть в enum — используем
+    const numLevel = Number(logLevel);
+    if (!isNaN(numLevel) && Object.values(LogLevels).includes(numLevel)) {
+        return numLevel;
+    }
+    // Если это строка-ключ enum (например, "INFO")
+    if (typeof logLevel === "string" && logLevel.toUpperCase() in LogLevels) {
+        return LogLevels[
+            logLevel.toUpperCase() as keyof typeof LogLevels
+        ] as number;
+    }
+    throw new Error(`Unknown BOTVIEW_LOG_LEVEL: ${logLevel}`);
+}
 
 export const config = {
     basicAuth: process.env.BOTVIEW_BASIC_AUTHS,
     basicAuthParsed: process.env.BOTVIEW_BASIC_AUTHS
-        ? process.env.BOTVIEW_BASIC_AUTHS.split(/[,\s]+/).map((auth) => {
+        ? process.env.BOTVIEW_BASIC_AUTHS.split(/[\s,]+/).map((auth) => {
               const parts = decodeURIComponent(auth.trim()).split(":");
               return [parts[0], parts[1], parts[2]] as [string, string, string];
           })
@@ -27,13 +45,14 @@ export const config = {
     blockFonts: process.env.BOTVIEW_BLOCK_FONTS === "true",
     blockMedia: process.env.BOTVIEW_BLOCK_MEDIA === "true",
     blockUrls: process.env.BOTVIEW_BLOCK_URLS
-        ? process.env.BOTVIEW_BLOCK_URLS.split(/[,\s]+/)
+        ? process.env.BOTVIEW_BLOCK_URLS.split(/[\s,]+/)
               .map((url) => decodeURIComponent(url.trim()))
               .filter(Boolean)
         : [],
     blockUrlsRegex: process.env.BOTVIEW_BLOCK_URLS_REGEX
-        ? process.env.BOTVIEW_BLOCK_URLS_REGEX.split(/[,\s]+/)
+        ? process.env.BOTVIEW_BLOCK_URLS_REGEX.split(/[\s,]+/)
               .map((regex) => new RegExp(decodeURIComponent(regex.trim())))
               .filter(Boolean)
         : [],
+    logLevel: getLogLevelChecked(process.env.BOTVIEW_LOG_LEVEL),
 };

src/services/json-logger.service.ts

@@ -1,5 +1,6 @@
 import { LoggerService } from "@nestjs/common";
 import { hostname } from "os";
+import { config } from "../config";
 
 export enum LogLevels {
     FATAL = 60,
@@ -12,6 +13,12 @@ export enum LogLevels {
 
 export class JsonLogger implements LoggerService {
     protected hostname: string = hostname();
+    private minLogLevel: number;
+
+    constructor() {
+        // Получаем минимальный уровень логирования из конфигурации
+        this.minLogLevel = config.logLevel;
+    }
 
     /**
      * Write a 'log' level log.
@@ -27,6 +34,13 @@ export class JsonLogger implements LoggerService {
         this.writeJson(message, LogLevels.ERROR);
     }
 
+    /**
+     * Write a 'fatal' level log.
+     */
+    public fatal(message: string) {
+        this.writeJson(message, LogLevels.FATAL);
+    }
+
     /**
      * Write a 'warn' level log.
      */
@@ -48,6 +62,13 @@ export class JsonLogger implements LoggerService {
         this.writeJson(message, LogLevels.TRACE);
     }
 
+    /**
+     * Write a 'trace' level log.
+     */
+    public trace(message: string) {
+        this.writeJson(message, LogLevels.TRACE);
+    }
+
     public extraLogs(
         message: string,
         level: number,
@@ -61,6 +82,11 @@ export class JsonLogger implements LoggerService {
         level: number,
         extraProps: object = {},
     ): void {
+        // Проверяем, нужно ли выводить лог в зависимости от уровня
+        if (level < this.minLogLevel) {
+            return;
+        }
+
         console.log(
             JSON.stringify({
                 message: message,