@futdevpro/nts-dynamo 1.15.16 → 1.15.19

package/build/_modules/logs/log-buffer.service.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_LogBuffer_Service = void 0;
+const singleton_service_1 = require("../../_services/base/singleton.service");
+/**
+ * In-memory ring buffer a szerver console kimenethez.
+ * Interceptalja a console.log/error/warn/info hivasokat es eltarolja az utolso N sort.
+ *
+ * Hasznalat:
+ *   DyNTS_LogBuffer_Service.getInstance().install();  // app startup-nal
+ *   DyNTS_LogBuffer_Service.getInstance().getLines(100);  // utolso 100 sor
+ */
+class DyNTS_LogBuffer_Service extends singleton_service_1.DyNTS_SingletonService {
+    static getInstance() {
+        return DyNTS_LogBuffer_Service.getSingletonInstance();
+    }
+    maxLines = 2000;
+    buffer = [];
+    installed = false;
+    /**
+     * Interceptalja a console.log/error/warn/info kimeneteket es a bufferbe irja.
+     * Egyszer kell hivni, a szerver indulasakor (lehetoleg a legelso muvelet).
+     */
+    install() {
+        if (this.installed) {
+            return;
+        }
+        this.installed = true;
+        const self = this;
+        const originalLog = console.log.bind(console);
+        const originalError = console.error.bind(console);
+        const originalWarn = console.warn.bind(console);
+        const originalInfo = console.info.bind(console);
+        console.log = (...args) => {
+            self.addLine('LOG', args);
+            originalLog(...args);
+        };
+        console.error = (...args) => {
+            self.addLine('ERR', args);
+            originalError(...args);
+        };
+        console.warn = (...args) => {
+            self.addLine('WRN', args);
+            originalWarn(...args);
+        };
+        console.info = (...args) => {
+            self.addLine('INF', args);
+            originalInfo(...args);
+        };
+    }
+    /**
+     * A log buffer be van-e kapcsolva (install megtortent-e).
+     */
+    isInstalled() {
+        return this.installed;
+    }
+    /**
+     * Az utolso N sor lekerdezese.
+     */
+    getLines(count = 200) {
+        const start = Math.max(0, this.buffer.length - count);
+        return this.buffer.slice(start);
+    }
+    /**
+     * Az osszes buffered sor szama.
+     */
+    getLineCount() {
+        return this.buffer.length;
+    }
+    /**
+     * Buffer uritese.
+     */
+    clear() {
+        this.buffer.length = 0;
+    }
+    addLine(level, args) {
+        const timestamp = new Date().toISOString();
+        const message = args.map(formatArg).join(' ');
+        this.buffer.push(`${timestamp} [${level}] ${message}`);
+        if (this.buffer.length > this.maxLines) {
+            this.buffer.shift();
+        }
+    }
+}
+exports.DyNTS_LogBuffer_Service = DyNTS_LogBuffer_Service;
+function formatArg(arg) {
+    if (typeof arg === 'string') {
+        return arg;
+    }
+    try {
+        return JSON.stringify(arg);
+    }
+    catch {
+        return String(arg);
+    }
+}
+//# sourceMappingURL=log-buffer.service.js.map

package/build/_modules/logs/log-buffer.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-buffer.service.js","sourceRoot":"","sources":["../../../src/_modules/logs/log-buffer.service.ts"],"names":[],"mappings":"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"}

package/build/_modules/logs/logs.controller.d.ts

@@ -0,0 +1,27 @@
+import { Request, Response } from 'express';
+import { DyNTS_Controller } from '../../_services/route/controller.service';
+/**
+ * Overseer-szintu log parameter tipus.
+ * Az authPreProcess opcionalis — ha megadod, a /get endpoint vedett lesz.
+ */
+export interface DyNTS_LogsController_Config {
+    /** Opcionalis auth preprocess. Ha nincs megadva → nyilt hozzaferes. */
+    authPreProcess?: (req: Request, res: Response) => Promise<void>;
+}
+/**
+ * NTS Logs Controller — beepitett /logs/get endpoint a szerver logok lekeresehez.
+ *
+ * Hasznalat:
+ *   DyNTS_getLogsRoutingModule()  — auth nelkul
+ *   DyNTS_getLogsRoutingModule({ authPreProcess: myAuth })  — auth-tal
+ *
+ * Ha a logs_endpoint.enabled === false, a controller 503-at dob.
+ */
+export declare class DyNTS_Logs_Controller extends DyNTS_Controller {
+    private static config;
+    static configure(config: DyNTS_LogsController_Config): void;
+    static getInstance(): DyNTS_Logs_Controller;
+    private readonly logsService;
+    setupEndpoints(): void;
+}
+//# sourceMappingURL=logs.controller.d.ts.map

package/build/_modules/logs/logs.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.controller.d.ts","sourceRoot":"","sources":["../../../src/_modules/logs/logs.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAI5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAK5E;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,uEAAuE;IACvE,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjE;AAED;;;;;;;;GAQG;AACH,qBAAa,qBAAsB,SAAQ,gBAAgB;IAEzD,OAAO,CAAC,MAAM,CAAC,MAAM,CAAmC;IAExD,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,2BAA2B,GAAG,IAAI;IAI3D,MAAM,CAAC,WAAW,IAAI,qBAAqB;IAI3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwD;IAEpF,cAAc,IAAI,IAAI;CAmEvB"}

package/build/_modules/logs/logs.controller.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Logs_Controller = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const controller_service_1 = require("../../_services/route/controller.service");
+const endpoint_params_control_model_1 = require("../../_models/control-models/endpoint-params.control-model");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const logs_service_1 = require("./logs.service");
+/**
+ * NTS Logs Controller — beepitett /logs/get endpoint a szerver logok lekeresehez.
+ *
+ * Hasznalat:
+ *   DyNTS_getLogsRoutingModule()  — auth nelkul
+ *   DyNTS_getLogsRoutingModule({ authPreProcess: myAuth })  — auth-tal
+ *
+ * Ha a logs_endpoint.enabled === false, a controller 503-at dob.
+ */
+class DyNTS_Logs_Controller extends controller_service_1.DyNTS_Controller {
+    static config = {};
+    static configure(config) {
+        DyNTS_Logs_Controller.config = config;
+    }
+    static getInstance() {
+        return DyNTS_Logs_Controller.getSingletonInstance();
+    }
+    logsService = logs_service_1.DyNTS_Logs_Service.getInstance();
+    setupEndpoints() {
+        const preProcesses = [];
+        if (DyNTS_Logs_Controller.config.authPreProcess) {
+            preProcesses.push(DyNTS_Logs_Controller.config.authPreProcess);
+        }
+        this.endpoints = [
+            // GET /get?tail=200 — utolso N sor a log bufferbol
+            new endpoint_params_control_model_1.DyNTS_Endpoint_Params({
+                name: 'getLogs',
+                type: fsm_dynamo_1.DyFM_HttpCallType.get,
+                endpoint: '/get',
+                preProcesses: preProcesses,
+                logRequest: false,
+                tasks: [
+                    async (req, res) => {
+                        // Ellenorzes: be van-e kapcsolva a logs endpoint
+                        if (!global_settings_const_1.DyNTS_global_settings.log_settings?.logs_endpoint?.enabled) {
+                            res.status(503).send({
+                                error: 'Logs endpoint is not enabled on this server.',
+                                hint: 'Set DyNTS_global_settings.log_settings.logs_endpoint.enabled = true',
+                            });
+                            return;
+                        }
+                        // Ellenorzes: install megtortent-e
+                        if (!this.logsService.isInstalled()) {
+                            res.status(503).send({
+                                error: 'Log buffer is not installed. Call DyNTS_Logs_Service.getInstance().install() at server startup.',
+                            });
+                            return;
+                        }
+                        const tail = Math.min(parseInt(req.query.tail) || 200, 2000);
+                        const lines = this.logsService.getLines(tail);
+                        res.send({
+                            totalBuffered: this.logsService.getLineCount(),
+                            returned: lines.length,
+                            lines: lines,
+                        });
+                    },
+                ],
+            }),
+            // DELETE /clear — buffer uritese
+            new endpoint_params_control_model_1.DyNTS_Endpoint_Params({
+                name: 'clearLogs',
+                type: fsm_dynamo_1.DyFM_HttpCallType.delete,
+                endpoint: '/clear',
+                preProcesses: preProcesses,
+                logRequest: false,
+                tasks: [
+                    async (req, res) => {
+                        if (!global_settings_const_1.DyNTS_global_settings.log_settings?.logs_endpoint?.enabled) {
+                            res.status(503).send({ error: 'Logs endpoint is not enabled.' });
+                            return;
+                        }
+                        const count = this.logsService.getLineCount();
+                        this.logsService.clear();
+                        res.send({ result: 'Log buffer cleared', clearedLines: count });
+                    },
+                ],
+            }),
+        ];
+    }
+}
+exports.DyNTS_Logs_Controller = DyNTS_Logs_Controller;
+//# sourceMappingURL=logs.controller.js.map

package/build/_modules/logs/logs.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.controller.js","sourceRoot":"","sources":["../../../src/_modules/logs/logs.controller.ts"],"names":[],"mappings":"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"}

package/build/_modules/logs/logs.service.d.ts

@@ -0,0 +1,40 @@
+import { DyNTS_SingletonServiceBase } from '../../_services/base/singleton.service-base';
+/**
+ * In-memory ring buffer a szerver logokhoz.
+ * Interceptalja a console.log/error/warn kimeneteket es tarolja oket.
+ * Max entryszam a log_settings.logs_endpoint.maxEntries-bol jon (default: 2000).
+ *
+ * Hasznalat:
+ *   DyNTS_Logs_Service.getInstance().install()  — egyszer, szerver indulasakor
+ *   DyNTS_Logs_Service.getInstance().getLines(200)  — utolso N sor
+ */
+export declare class DyNTS_Logs_Service extends DyNTS_SingletonServiceBase {
+    static getInstance(): DyNTS_Logs_Service;
+    private readonly maxEntries;
+    private readonly buffer;
+    private installed;
+    protected constructor();
+    /**
+     * Interceptalja a console.log/error/warn kimeneteket es a bufferbe irja.
+     * Egyszer kell hivni, a szerver indulasakor. Tobbszori hivas no-op.
+     */
+    install(): void;
+    /**
+     * Az utolso N sor lekerdezese.
+     */
+    getLines(count?: number): string[];
+    /**
+     * Osszes bufferelt sor szama.
+     */
+    getLineCount(): number;
+    /**
+     * Buffer uritese.
+     */
+    clear(): void;
+    /**
+     * Telepitve van-e mar a console intercept.
+     */
+    isInstalled(): boolean;
+    private addLine;
+}
+//# sourceMappingURL=logs.service.d.ts.map

package/build/_modules/logs/logs.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.service.d.ts","sourceRoot":"","sources":["../../../src/_modules/logs/logs.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6CAA6C,CAAC;AAGzF;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,SAAQ,0BAA0B;IAEhE,MAAM,CAAC,WAAW,IAAI,kBAAkB;IAIxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,SAAS,CAAkB;IAEnC,SAAS;IAKT;;;OAGG;IACH,OAAO,IAAI,IAAI;IA0Bf;;OAEG;IACH,QAAQ,CAAC,KAAK,GAAE,MAAY,GAAG,MAAM,EAAE;IAKvC;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB,OAAO,CAAC,OAAO;CAahB"}

package/build/_modules/logs/logs.service.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_Logs_Service = void 0;
+const singleton_service_base_1 = require("../../_services/base/singleton.service-base");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+/**
+ * In-memory ring buffer a szerver logokhoz.
+ * Interceptalja a console.log/error/warn kimeneteket es tarolja oket.
+ * Max entryszam a log_settings.logs_endpoint.maxEntries-bol jon (default: 2000).
+ *
+ * Hasznalat:
+ *   DyNTS_Logs_Service.getInstance().install()  — egyszer, szerver indulasakor
+ *   DyNTS_Logs_Service.getInstance().getLines(200)  — utolso N sor
+ */
+class DyNTS_Logs_Service extends singleton_service_base_1.DyNTS_SingletonServiceBase {
+    static getInstance() {
+        return DyNTS_Logs_Service.getSingletonInstance();
+    }
+    maxEntries;
+    buffer = [];
+    installed = false;
+    constructor() {
+        super();
+        this.maxEntries = global_settings_const_1.DyNTS_global_settings.log_settings?.logs_endpoint?.maxEntries ?? 2000;
+    }
+    /**
+     * Interceptalja a console.log/error/warn kimeneteket es a bufferbe irja.
+     * Egyszer kell hivni, a szerver indulasakor. Tobbszori hivas no-op.
+     */
+    install() {
+        if (this.installed) {
+            return;
+        }
+        this.installed = true;
+        const originalLog = console.log.bind(console);
+        const originalError = console.error.bind(console);
+        const originalWarn = console.warn.bind(console);
+        const self = this;
+        console.log = (...args) => {
+            self.addLine('LOG', args);
+            originalLog(...args);
+        };
+        console.error = (...args) => {
+            self.addLine('ERR', args);
+            originalError(...args);
+        };
+        console.warn = (...args) => {
+            self.addLine('WRN', args);
+            originalWarn(...args);
+        };
+    }
+    /**
+     * Az utolso N sor lekerdezese.
+     */
+    getLines(count = 200) {
+        const start = Math.max(0, this.buffer.length - count);
+        return this.buffer.slice(start);
+    }
+    /**
+     * Osszes bufferelt sor szama.
+     */
+    getLineCount() {
+        return this.buffer.length;
+    }
+    /**
+     * Buffer uritese.
+     */
+    clear() {
+        this.buffer.length = 0;
+    }
+    /**
+     * Telepitve van-e mar a console intercept.
+     */
+    isInstalled() {
+        return this.installed;
+    }
+    addLine(level, args) {
+        const message = args.map((arg) => {
+            if (typeof arg === 'string') {
+                return arg;
+            }
+            try {
+                return JSON.stringify(arg);
+            }
+            catch {
+                return String(arg);
+            }
+        }).join(' ');
+        const timestamped = `${new Date().toISOString()} [${level}] ${message}`;
+        this.buffer.push(timestamped);
+        if (this.buffer.length > this.maxEntries) {
+            this.buffer.shift();
+        }
+    }
+}
+exports.DyNTS_Logs_Service = DyNTS_Logs_Service;
+//# sourceMappingURL=logs.service.js.map

package/build/_modules/logs/logs.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.service.js","sourceRoot":"","sources":["../../../src/_modules/logs/logs.service.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.16",
+  "version": "01.15.19",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",

package/pipeline.cicd.config.json

@@ -76,7 +76,9 @@
               "@futdevpro/fsm-dynamo"
             ]
           }
-        ]
+        ],
+        "fix": true,
+        "patchOnly": true
       }
     },
     {

package/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+allowBuilds:
+  '@discordjs/opus': set this to true or false

package/src/_models/interfaces/global-log-settings.interface.ts

@@ -105,4 +105,40 @@ export interface DyNTS_GlobalLog_Settings {
     /** Max sorok szama a bufferben. Default: 2000. */
     maxEntries?: number;
   };
+
+  /**
+   * File-based log kiiras konfiguracio (DyNTS_FileLog_Service).
+   *
+   * Az in-memory ring buffer (DyNTS_Logs_Service) mellett mukodik — NEM
+   * helyette. A szerver stdout/stderr kimeneteket egy per-session log
+   * fajlba duplikalja (`{logDir}/{filenamePrefix}YYYY-MM-DD_HH-MM-SS.log`).
+   *
+   * Rotation: ha az aktiv fajl meghaladja a `maxFileSizeMb`-t, uj fajl jon
+   * letre. Retention: az `install()` + minden rotation utan a
+   * `maxFiles`-nel regebbi vagy a `retentionDays`-nel idosebb fajlok
+   * torlodnek (ami elobb teljesul).
+   *
+   * Hasznalat:
+   *   DyNTS_FileLog_Service.getInstance().install();  // szerver startup
+   */
+  file_log?: {
+    /** Engedelyezve van-e a file-based logolás. Default: false. */
+    enabled: boolean;
+    /** Log mappa abszolut vagy relativ path-ja. Default: './logs/server'. */
+    logDir?: string;
+    /** Per-session fajlnev prefix. Default: 'server-'. */
+    filenamePrefix?: string;
+    /** Rotation trigger MB-ban. Default: 50. */
+    maxFileSizeMb?: number;
+    /** Retention by count — max ennyi log fajl marad meg. Default: 10. */
+    maxFiles?: number;
+    /** Retention by age — ennyi napnal regebbi fajl torlodik. Default: 30. */
+    retentionDays?: number;
+    /** ANSI escape kodok strippelese a fajl-irasnal. Default: true. */
+    stripAnsi?: boolean;
+    /** stdout interceptalasa. Default: true. */
+    includeStdout?: boolean;
+    /** stderr interceptalasa. Default: true. */
+    includeStderr?: boolean;
+  };
 }

package/src/_modules/logs/file-log.service.spec.ts

@@ -0,0 +1,202 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+
+import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+
+import { DyNTS_FileLog_Service } from './file-log.service';
+
+
+describe('| DyNTS_FileLog_Service', (): void => {
+  let tempDir: string;
+  let originalFileLogConfig: typeof DyNTS_global_settings.log_settings.file_log;
+
+  beforeEach((): void => {
+    tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'nts-filelog-spec-'));
+    originalFileLogConfig = DyNTS_global_settings.log_settings.file_log;
+  });
+
+  afterEach((): void => {
+    // Mindig allitsuk vissza az eredeti console-t es config-ot, hogy
+    // ne szivarogtassuk at a teszt envt.
+    DyNTS_FileLog_Service.getInstance()._teardownForTesting();
+    DyNTS_global_settings.log_settings.file_log = originalFileLogConfig;
+    try { fs.rmSync(tempDir, { recursive: true, force: true }); } catch { /* swallow */ }
+  });
+
+  describe('| install() — gating', (): void => {
+    it('| no-op ha file_log config hianyzik', (): void => {
+      DyNTS_global_settings.log_settings.file_log = undefined;
+      DyNTS_FileLog_Service.getInstance().install();
+      expect(DyNTS_FileLog_Service.getInstance().isInstalled()).toBe(false);
+    });
+
+    it('| no-op ha enabled === false', (): void => {
+      DyNTS_global_settings.log_settings.file_log = { enabled: false, logDir: tempDir };
+      DyNTS_FileLog_Service.getInstance().install();
+      expect(DyNTS_FileLog_Service.getInstance().isInstalled()).toBe(false);
+    });
+
+    it('| install() idempotens — masodszorra is no-op', (): void => {
+      DyNTS_global_settings.log_settings.file_log = { enabled: true, logDir: tempDir };
+      const svc: DyNTS_FileLog_Service = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+      const firstPath: string = svc.getCurrentLogPath();
+      svc.install();  // ismet
+      expect(svc.getCurrentLogPath()).toBe(firstPath);
+    });
+  });
+
+  describe('| install() — file creation + intercept', (): void => {
+    it('| stdout iras a fajlba is bekerul', (): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+      };
+      const svc: DyNTS_FileLog_Service = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+
+      const marker: string = `hello-from-spec-${Date.now()}\n`;
+      process.stdout.write(marker);
+
+      const logPath: string = svc.getCurrentLogPath();
+      expect(fs.existsSync(logPath)).toBe(true);
+      const contents: string = fs.readFileSync(logPath, 'utf-8');
+      expect(contents).toContain(marker.trim());
+    });
+
+    it('| stderr iras a fajlba is bekerul ha includeStderr=true', (): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+      };
+      const svc: DyNTS_FileLog_Service = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+
+      const marker: string = `error-marker-${Date.now()}\n`;
+      process.stderr.write(marker);
+
+      const contents: string = fs.readFileSync(svc.getCurrentLogPath(), 'utf-8');
+      expect(contents).toContain(marker.trim());
+    });
+
+    it('| ANSI escape kodok strippelve a fajlban ha stripAnsi=true (default)', (): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+      };
+      const svc: DyNTS_FileLog_Service = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+
+      process.stdout.write('\x1b[31mredtext\x1b[0m-payload\n');
+
+      const contents: string = fs.readFileSync(svc.getCurrentLogPath(), 'utf-8');
+      expect(contents).toContain('redtext-payload');
+      expect(contents).not.toContain('\x1b[31m');
+      expect(contents).not.toContain('\x1b[0m');
+    });
+
+    it('| ANSI megmarad ha stripAnsi=false', (): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+        stripAnsi: false,
+      };
+      const svc: DyNTS_FileLog_Service = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+
+      process.stdout.write('\x1b[31mraw\x1b[0m\n');
+
+      const contents: string = fs.readFileSync(svc.getCurrentLogPath(), 'utf-8');
+      expect(contents).toContain('\x1b[31mraw\x1b[0m');
+    });
+  });
+
+  describe('| rotation', (): void => {
+    it('| uj fajl jon letre ha az iras meghaladja a maxFileSizeMb-t', (): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'rotspec-',
+        // 1 byte limit → minden iras azonnal triggereli a rotaciot
+        maxFileSizeMb: 1 / (1024 * 1024),
+      };
+      const svc: DyNTS_FileLog_Service = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+
+      const firstPath: string = svc.getCurrentLogPath();
+      process.stdout.write('payload-1\n');
+      process.stdout.write('payload-2\n');
+
+      const secondPath: string = svc.getCurrentLogPath();
+      expect(secondPath).not.toBe(firstPath);
+      // Mindket fajl letezik a tempDir-ben
+      const files: string[] = fs.readdirSync(tempDir).filter((f: string) => f.startsWith('rotspec-'));
+      expect(files.length).toBeGreaterThanOrEqual(2);
+    });
+  });
+
+  describe('| retention', (): void => {
+    it('| install() torli a `retentionDays`-nel regebbi fajlokat (mtime backdated)', (): void => {
+      const oldFile: string = path.join(tempDir, 'spec-2020-01-01_00-00-00_abc.log');
+      fs.writeFileSync(oldFile, 'old');
+      const oldMs: number = Date.now() - 365 * 24 * 60 * 60 * 1000;
+      fs.utimesSync(oldFile, oldMs / 1000, oldMs / 1000);
+
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+        retentionDays: 30,
+        maxFiles: 100,  // count szabaly NE triggereljen
+      };
+      DyNTS_FileLog_Service.getInstance().install();
+
+      expect(fs.existsSync(oldFile)).toBe(false);
+    });
+
+    it('| install() retention by count — maxFiles-nel tobb fajl van, a legregebbi torlodik', (): void => {
+      // 3 fix mtime-u "regi" fajl letrehozasa (azonnali age szempontbol mind ok)
+      const now: number = Date.now();
+      const f1: string = path.join(tempDir, 'spec-2026-01-01_00-00-01_aaa.log');
+      const f2: string = path.join(tempDir, 'spec-2026-01-01_00-00-02_bbb.log');
+      const f3: string = path.join(tempDir, 'spec-2026-01-01_00-00-03_ccc.log');
+      fs.writeFileSync(f1, '1'); fs.utimesSync(f1, (now - 30000) / 1000, (now - 30000) / 1000);
+      fs.writeFileSync(f2, '2'); fs.utimesSync(f2, (now - 20000) / 1000, (now - 20000) / 1000);
+      fs.writeFileSync(f3, '3'); fs.utimesSync(f3, (now - 10000) / 1000, (now - 10000) / 1000);
+
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+        maxFiles: 2,            // a legregebbi (f1) torlodik
+        retentionDays: 36500,   // age szabaly NE triggereljen
+      };
+      DyNTS_FileLog_Service.getInstance().install();
+
+      expect(fs.existsSync(f1)).toBe(false);
+      expect(fs.existsSync(f2)).toBe(true);
+      expect(fs.existsSync(f3)).toBe(true);
+    });
+  });
+
+  describe('| silent failure', (): void => {
+    it('| install() NEM crashel ha a logDir letrehozasa bukik', (): void => {
+      // Olyan path amit nem lehet letrehozni: egy meglévő fajl ALATTI subdir.
+      const blocker: string = path.join(tempDir, 'iam-a-file');
+      fs.writeFileSync(blocker, '');
+      const impossible: string = path.join(blocker, 'cant-create-subdir');
+
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: impossible,
+      };
+      expect(() => DyNTS_FileLog_Service.getInstance().install()).not.toThrow();
+      expect(DyNTS_FileLog_Service.getInstance().isInstalled()).toBe(false);
+    });
+  });
+});