@futdevpro/nts-dynamo 1.15.154 → 1.15.156

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

@@ -1,445 +1,445 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_FileLog_Service = void 0;
-const tslib_1 = require("tslib");
-const fs = tslib_1.__importStar(require("fs"));
-const path = tslib_1.__importStar(require("path"));
-const singleton_service_base_1 = require("../../_services/base/singleton.service-base");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-/**
- * Default ertekek a file-log config mezokhez. A `file_log` config nelkul
- * az install() no-op (enabled === false).
- */
-const DEFAULT_LOG_DIR = './logs/server';
-const DEFAULT_FILENAME_PREFIX = 'server-';
-const DEFAULT_FILENAME_SUFFIX = '.log';
-const DEFAULT_MAX_FILE_SIZE_MB = 50;
-const DEFAULT_MAX_FILES = 10;
-const DEFAULT_RETENTION_DAYS = 30;
-const DEFAULT_STRIP_ANSI = true;
-const DEFAULT_INCLUDE_STDOUT = true;
-const DEFAULT_INCLUDE_STDERR = true;
-/** ANSI escape code regex (szin/formazas kodok). */
-const ANSI_ESCAPE_REGEX = /\x1b\[[0-9;]*[a-zA-Z]/g;
-/** Max sor szam egy `readLogFile()` hivasra — vedi a memory-t nagy fajloknal. */
-const MAX_READ_LINES = 10000;
-/** Default tail sor szam (ha semmi mas mod nincs megadva). */
-const DEFAULT_READ_TAIL = 200;
-/**
- * File-based szerver log service — duplikalja a stdout/stderr-t per-session
- * log fajl(ok)ba, miközben a console kimenet erintetlenul marad. Az
- * in-memory ring buffer (`DyNTS_Logs_Service`) MELLETT mukodik, NEM
- * helyette.
- *
- * Architecture:
- *   - `process.stdout.write` es `process.stderr.write` monkey-patch (NEM
- *     `console.*` — azt mar a `DyNTS_Logs_Service` patch-elheti)
- *   - Per-session fajl: `{logDir}/{prefix}YYYY-MM-DD_HH-MM-SS.log`
- *   - Sync `appendFileSync` iras — crash-safe, azonnali flush
- *   - Rotation: `maxFileSizeMb` atlepesenel uj session fajl
- *   - Retention: `maxFiles` (count) ES `retentionDays` (age) — ami elobb
- *     teljesul; install-kor + minden rotation utan futtatva
- *   - Silent failure: file IO hibak ELNYELODNEK (a file logger SOHASEM
- *     buktathatja el a szervert)
- *
- * Idempotens: tobbszori install() hivas no-op (a masodiktol).
- *
- * Hasznalat:
- *   DyNTS_global_settings.log_settings.file_log = { enabled: true, ... };
- *   DyNTS_FileLog_Service.getInstance().install();  // szerver startup
- */
-class DyNTS_FileLog_Service extends singleton_service_base_1.DyNTS_SingletonServiceBase {
-    static getInstance() {
-        return DyNTS_FileLog_Service.getSingletonInstance();
-    }
-    installed = false;
-    activeLogDir = '';
-    filenamePrefix = DEFAULT_FILENAME_PREFIX;
-    maxFileSizeBytes = DEFAULT_MAX_FILE_SIZE_MB * 1024 * 1024;
-    maxFiles = DEFAULT_MAX_FILES;
-    retentionDays = DEFAULT_RETENTION_DAYS;
-    stripAnsiEnabled = DEFAULT_STRIP_ANSI;
-    currentLogPath = '';
-    currentLogSizeBytes = 0;
-    originalStdoutWrite = null;
-    originalStderrWrite = null;
-    /**
-     * Telepiti a file logger-t a `DyNTS_global_settings.log_settings.file_log`
-     * config alapjan. Ha `enabled === false` vagy hianyzik a config → no-op.
-     *
-     * Idempotens — masodszori hivas no-op (akkor is, ha kozben a config
-     * valtozott; a service uj install-jara teardownFor Testing() + install()).
-     */
-    install() {
-        if (this.installed) {
-            return;
-        }
-        const config = global_settings_const_1.DyNTS_global_settings.log_settings?.file_log;
-        if (!config || !config.enabled) {
-            return;
-        }
-        // Config feldolgozas + default-ok
-        this.activeLogDir = config.logDir ?? DEFAULT_LOG_DIR;
-        this.filenamePrefix = config.filenamePrefix ?? DEFAULT_FILENAME_PREFIX;
-        this.maxFileSizeBytes = (config.maxFileSizeMb ?? DEFAULT_MAX_FILE_SIZE_MB) * 1024 * 1024;
-        this.maxFiles = config.maxFiles ?? DEFAULT_MAX_FILES;
-        this.retentionDays = config.retentionDays ?? DEFAULT_RETENTION_DAYS;
-        this.stripAnsiEnabled = config.stripAnsi ?? DEFAULT_STRIP_ANSI;
-        const includeStdout = config.includeStdout ?? DEFAULT_INCLUDE_STDOUT;
-        const includeStderr = config.includeStderr ?? DEFAULT_INCLUDE_STDERR;
-        // Log dir letrehozasa silently
-        try {
-            if (!fs.existsSync(this.activeLogDir)) {
-                fs.mkdirSync(this.activeLogDir, { recursive: true });
-            }
-        }
-        catch {
-            // Ha a mkdir bukik (pl. permission denied), no-op — silent failure
-            return;
-        }
-        // Retention cleanup MIELOTT az uj session fajl letrejon (hogy a takaritas
-        // log uzenete ne keruljon a most induló fajlba)
-        this.cleanupOldLogs();
-        // Uj session fajl path + size init
-        this.currentLogPath = path.join(this.activeLogDir, this.buildSessionFilename());
-        this.currentLogSizeBytes = 0;
-        // Monkey-patch — az originalokat elmentjük (teardown miatt)
-        if (includeStdout) {
-            this.originalStdoutWrite = process.stdout.write.bind(process.stdout);
-            const self = this;
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            process.stdout.write = function patchedStdoutWrite(...args) {
-                self.teeWrite(args[0]);
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                return self.originalStdoutWrite(...args);
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            };
-        }
-        if (includeStderr) {
-            this.originalStderrWrite = process.stderr.write.bind(process.stderr);
-            const self = this;
-            // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            process.stderr.write = function patchedStderrWrite(...args) {
-                self.teeWrite(args[0]);
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                return self.originalStderrWrite(...args);
-                // eslint-disable-next-line @typescript-eslint/no-explicit-any
-            };
-        }
-        this.installed = true;
-        // Session header — kulcs info egy helyen a fajl tetejen
-        this.teeWrite(`===== DyNTS server log session started at ${new Date().toISOString()} =====\n` +
-            `===== PID: ${process.pid}, Node: ${process.version} =====\n` +
-            `===== Retention: ${this.retentionDays} days, max files: ${this.maxFiles}, max size: ${config.maxFileSizeMb ?? DEFAULT_MAX_FILE_SIZE_MB}MB =====\n\n`);
-    }
-    /**
-     * Visszaadja az aktualis log fajl abszolut path-jat (csak akkor letezo,
-     * ha az install() sikeresen lefutott; egyebkent ures string).
-     */
-    getCurrentLogPath() {
-        return this.currentLogPath;
-    }
-    /**
-     * Az aktualis aktiv log fajl basename-je (NEM teljes path). Csak akkor
-     * nem-ures, ha az install() sikeresen lefutott.
-     */
-    getCurrentLogFilename() {
-        if (!this.currentLogPath) {
-            return '';
-        }
-        return path.basename(this.currentLogPath);
-    }
-    /**
-     * Aktiv log dir abszolut path-ja. Csak akkor nem-ures, ha az install()
-     * sikeresen lefutott.
-     */
-    getActiveLogDir() {
-        return this.activeLogDir;
-    }
-    /**
-     * Aktiv filename prefix (a service config-jabol). Hasznalja a controller
-     * a request-fajlnev whitelist regex epitesehez.
-     */
-    getFilenamePrefix() {
-        return this.filenamePrefix;
-    }
-    /**
-     * Osszes log fajl listazasa az aktiv log dir-bol. Csak a service prefix-evel
-     * matchelo fajlokat veszi (`{prefix}*.log`).
-     *
-     * Rendezes: mtime DESC (legujabb elol). Hibakat csendben elnyel — ha a dir
-     * nem letezik vagy nem olvashato, ures array-t ad vissza.
-     */
-    listLogFiles() {
-        if (!this.activeLogDir || !this.installed) {
-            return [];
-        }
-        const currentBasename = this.getCurrentLogFilename();
-        const entries = [];
-        try {
-            const dirContents = fs.readdirSync(this.activeLogDir);
-            for (const name of dirContents) {
-                if (!name.startsWith(this.filenamePrefix) || !name.endsWith(DEFAULT_FILENAME_SUFFIX)) {
-                    continue;
-                }
-                const fullPath = path.join(this.activeLogDir, name);
-                try {
-                    const stats = fs.statSync(fullPath);
-                    if (!stats.isFile()) {
-                        continue;
-                    }
-                    entries.push({
-                        name: name,
-                        sizeBytes: stats.size,
-                        mtimeMs: stats.mtimeMs,
-                        isCurrent: name === currentBasename,
-                    });
-                }
-                catch {
-                    // egy fajlonkenti hiba ne szakitsa meg a listat
-                }
-            }
-        }
-        catch {
-            // dir read hiba → ures listat adunk vissza
-            return [];
-        }
-        // Legujabb elol
-        entries.sort((a, b) => b.mtimeMs - a.mtimeMs);
-        return entries;
-    }
-    /**
-     * Egy konkret log fajl olvasasa, line-based mode-ban (tail / head / range).
-     *
-     * **Biztonsagi safeguards:**
-     * - Filename whitelist: `{prefix}*.log` mintara matchelo nev kotelezo
-     * - Path resolution `path.resolve(activeLogDir, name)` + `startsWith(activeLogDir)` (path traversal vedelem)
-     * - Sor szam cap: `MAX_READ_LINES` (10000)
-     *
-     * **Hibak:**
-     * - Throw `Error('not installed')` ha a service nincs install-olva
-     * - Throw `Error('invalid filename')` ha a name nem matchel a whitelist-re VAGY kilep az activeLogDir-bol
-     * - Throw `Error('file not found')` ha a fajl nem letezik
-     *
-     * A hivot kell vigyaznia hogy ezeket HTTP status code-okra forditja.
-     */
-    readLogFile(name, options = {}) {
-        if (!this.installed || !this.activeLogDir) {
-            throw new Error('FileLog service not installed');
-        }
-        // Whitelist regex: csak a service prefix-evel matchelo fajlnev
-        if (!this.isValidFilename(name)) {
-            throw new Error('invalid filename');
-        }
-        // Path resolve + traversal check
-        const resolvedPath = path.resolve(this.activeLogDir, name);
-        const resolvedDir = path.resolve(this.activeLogDir);
-        // path.sep + sufix ellenőrzéssel megelőzzük a hasonló prefixű dir átverést
-        // (pl. '/logs' vs '/logs-other'); a resolvedPath az activeLogDir-en BELUL
-        // kell legyen.
-        if (!resolvedPath.startsWith(resolvedDir + path.sep) && resolvedPath !== resolvedDir) {
-            throw new Error('invalid filename');
-        }
-        if (!fs.existsSync(resolvedPath)) {
-            throw new Error('file not found');
-        }
-        const stats = fs.statSync(resolvedPath);
-        if (!stats.isFile()) {
-            throw new Error('file not found');
-        }
-        // Olvass + split soroka. UTF-8 encoding alapertelmezett. Nagy fajloknal a
-        // teljes betoltes nem ideal, de a 10000-soros cap es a Stream-based
-        // optimization egy kesobbi iteracio lehet ha kell.
-        const fullContent = fs.readFileSync(resolvedPath, 'utf-8');
-        // Split a sorvegekre — utolso ures stringet kivagjuk ha a fajl
-        // sorvégzodessel zarult (regenerált sor szám hibakerulest celozzuk meg)
-        const allLines = fullContent.split(/\r?\n/);
-        if (allLines.length > 0 && allLines[allLines.length - 1] === '') {
-            allLines.pop();
-        }
-        const totalLines = allLines.length;
-        // Mod meghatarozasa: range > head > tail
-        let mode;
-        let startIdx;
-        let endIdx; // exclusive
-        if (options.rangeStart !== undefined && options.rangeEnd !== undefined) {
-            mode = 'range';
-            const start1 = Math.max(1, Math.floor(options.rangeStart));
-            const end1 = Math.max(start1, Math.floor(options.rangeEnd));
-            startIdx = Math.max(0, Math.min(totalLines, start1 - 1));
-            endIdx = Math.max(startIdx, Math.min(totalLines, end1));
-            // Cap
-            if (endIdx - startIdx > MAX_READ_LINES) {
-                endIdx = startIdx + MAX_READ_LINES;
-            }
-        }
-        else if (options.head !== undefined) {
-            mode = 'head';
-            const headN = Math.min(Math.max(1, Math.floor(options.head)), MAX_READ_LINES);
-            startIdx = 0;
-            endIdx = Math.min(totalLines, headN);
-        }
-        else {
-            mode = 'tail';
-            const tailN = Math.min(Math.max(1, Math.floor(options.tail ?? DEFAULT_READ_TAIL)), MAX_READ_LINES);
-            startIdx = Math.max(0, totalLines - tailN);
-            endIdx = totalLines;
-        }
-        const lines = allLines.slice(startIdx, endIdx);
-        return {
-            name: path.basename(resolvedPath),
-            sizeBytes: stats.size,
-            totalLines: totalLines,
-            lines: lines,
-            mode: mode,
-            rangeStart: startIdx + 1, // 1-based, inclusive
-            rangeEnd: Math.max(startIdx, endIdx), // 1-based, inclusive ha lines van; egyebkent 0-szeru
-        };
-    }
-    /**
-     * Filename whitelist ellenorzes. Csak a service prefix-evel matchelo,
-     * biztonsagos karakterkeszletu fajlnev megengedett.
-     */
-    isValidFilename(name) {
-        if (typeof name !== 'string' || name.length === 0 || name.length > 256) {
-            return false;
-        }
-        // Path-szeparatorokat kifejezetten tiltjuk (mar a regex is, de gyors check)
-        if (name.includes('/') || name.includes('\\') || name.includes('..')) {
-            return false;
-        }
-        // `{prefix}[\w\-.]+\.log` — szigoru ASCII set
-        const escapedPrefix = this.filenamePrefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-        const regex = new RegExp(`^${escapedPrefix}[\\w\\-.]+\\.log$`);
-        return regex.test(name);
-    }
-    /**
-     * Telepitve van-e (csak akkor true, ha az enabled === true es a setup nem bukott).
-     */
-    isInstalled() {
-        return this.installed;
-    }
-    /**
-     * Test-only: visszallitja az eredeti stdout/stderr.write-okat, hogy a
-     * specfajlok egymas utan tisztán futhassanak. Production code NE hivja.
-     */
-    _teardownForTesting() {
-        if (this.originalStdoutWrite) {
-            process.stdout.write = this.originalStdoutWrite;
-            this.originalStdoutWrite = null;
-        }
-        if (this.originalStderrWrite) {
-            process.stderr.write = this.originalStderrWrite;
-            this.originalStderrWrite = null;
-        }
-        this.installed = false;
-        this.activeLogDir = '';
-        this.currentLogPath = '';
-        this.currentLogSizeBytes = 0;
-    }
-    /**
-     * Session fajl nev: `{prefix}YYYY-MM-DD_HH-MM-SS_RANDOM.log`. Az RANDOM
-     * suffix biztositja a unique nevet ha ugyanazon a masodpercen tobb fajl jon letre
-     * (pl. rotation kozvetlenul install utan, vagy specfajlok gyors egymas utan).
-     */
-    buildSessionFilename() {
-        const now = new Date();
-        const year = String(now.getFullYear());
-        const month = String(now.getMonth() + 1).padStart(2, '0');
-        const day = String(now.getDate()).padStart(2, '0');
-        const hour = String(now.getHours()).padStart(2, '0');
-        const minute = String(now.getMinutes()).padStart(2, '0');
-        const second = String(now.getSeconds()).padStart(2, '0');
-        const rand = Math.floor(Math.random() * 100000).toString(36);
-        return `${this.filenamePrefix}${year}-${month}-${day}_${hour}-${minute}-${second}_${rand}${DEFAULT_FILENAME_SUFFIX}`;
-    }
-    /**
-     * Egyetlen stdout/stderr iras tee-zese az aktualis log fajlba.
-     * Hibakat csendben elnyeli — a file logger SOHASEM blokkolja a szervert.
-     * Size-trackeli az aktualis fajlt es szukseg szerint rotalja.
-     */
-    teeWrite(data) {
-        try {
-            if (!this.currentLogPath) {
-                return;
-            }
-            const asString = typeof data === 'string'
-                ? data
-                : Buffer.from(data).toString('utf-8');
-            const cleaned = this.stripAnsiEnabled ? asString.replace(ANSI_ESCAPE_REGEX, '') : asString;
-            const writeBytes = Buffer.byteLength(cleaned, 'utf-8');
-            fs.appendFileSync(this.currentLogPath, cleaned, 'utf-8');
-            this.currentLogSizeBytes += writeBytes;
-            // Rotation trigger
-            if (this.currentLogSizeBytes >= this.maxFileSizeBytes) {
-                this.rotate();
-            }
-        }
-        catch {
-            // szandekosan elnyelve — silent failure
-        }
-    }
-    /**
-     * Uj session fajl letrehozasa (az aktualis lezarodik). Retention cleanup-ot is
-     * vegrehajt, hogy a rotation termeszetesen tisztan tarttsa a log dir-t.
-     */
-    rotate() {
-        try {
-            this.cleanupOldLogs();
-            this.currentLogPath = path.join(this.activeLogDir, this.buildSessionFilename());
-            this.currentLogSizeBytes = 0;
-        }
-        catch {
-            // szandekosan elnyelve
-        }
-    }
-    /**
-     * Retention takaritas: ket szabaly ami ami elobb teljesul:
-     *   1) maxFiles — ha tobb mint N log fajl van, a legregebbieket torli
-     *   2) retentionDays — `retentionDays`-nel idosebb fajlokat torli
-     *
-     * Hibakat csendben elnyel. A torolt fajlokat es az okot NEM logoljuk, hogy
-     * ne kerüljön extra szennyezes a most induló session fajlba.
-     */
-    cleanupOldLogs() {
-        try {
-            if (!fs.existsSync(this.activeLogDir)) {
-                return;
-            }
-            const cutoffMs = Date.now() - this.retentionDays * 24 * 60 * 60 * 1000;
-            const entries = fs.readdirSync(this.activeLogDir);
-            const matchingFiles = [];
-            for (const entry of entries) {
-                if (!entry.startsWith(this.filenamePrefix) || !entry.endsWith(DEFAULT_FILENAME_SUFFIX)) {
-                    continue;
-                }
-                const fullPath = path.join(this.activeLogDir, entry);
-                try {
-                    const stats = fs.statSync(fullPath);
-                    matchingFiles.push({ fullPath: fullPath, mtimeMs: stats.mtimeMs });
-                }
-                catch {
-                    // fajlonkent elnyelve
-                }
-            }
-            // Sort: legujabb elol -> legregebbi hatul (csokkeno mtime)
-            matchingFiles.sort((a, b) => b.mtimeMs - a.mtimeMs);
-            for (let i = 0; i < matchingFiles.length; i++) {
-                const file = matchingFiles[i];
-                const tooOldByAge = file.mtimeMs < cutoffMs;
-                const tooManyByCount = i >= this.maxFiles;
-                if (tooOldByAge || tooManyByCount) {
-                    try {
-                        fs.unlinkSync(file.fullPath);
-                    }
-                    catch { /* fajlonkent elnyelve */ }
-                }
-            }
-        }
-        catch {
-            // szandekosan elnyelve
-        }
-    }
-}
-exports.DyNTS_FileLog_Service = DyNTS_FileLog_Service;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_FileLog_Service = void 0;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs"));
+const path = tslib_1.__importStar(require("path"));
+const singleton_service_base_1 = require("../../_services/base/singleton.service-base");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+/**
+ * Default ertekek a file-log config mezokhez. A `file_log` config nelkul
+ * az install() no-op (enabled === false).
+ */
+const DEFAULT_LOG_DIR = './logs/server';
+const DEFAULT_FILENAME_PREFIX = 'server-';
+const DEFAULT_FILENAME_SUFFIX = '.log';
+const DEFAULT_MAX_FILE_SIZE_MB = 50;
+const DEFAULT_MAX_FILES = 10;
+const DEFAULT_RETENTION_DAYS = 30;
+const DEFAULT_STRIP_ANSI = true;
+const DEFAULT_INCLUDE_STDOUT = true;
+const DEFAULT_INCLUDE_STDERR = true;
+/** ANSI escape code regex (szin/formazas kodok). */
+const ANSI_ESCAPE_REGEX = /\x1b\[[0-9;]*[a-zA-Z]/g;
+/** Max sor szam egy `readLogFile()` hivasra — vedi a memory-t nagy fajloknal. */
+const MAX_READ_LINES = 10000;
+/** Default tail sor szam (ha semmi mas mod nincs megadva). */
+const DEFAULT_READ_TAIL = 200;
+/**
+ * File-based szerver log service — duplikalja a stdout/stderr-t per-session
+ * log fajl(ok)ba, miközben a console kimenet erintetlenul marad. Az
+ * in-memory ring buffer (`DyNTS_Logs_Service`) MELLETT mukodik, NEM
+ * helyette.
+ *
+ * Architecture:
+ *   - `process.stdout.write` es `process.stderr.write` monkey-patch (NEM
+ *     `console.*` — azt mar a `DyNTS_Logs_Service` patch-elheti)
+ *   - Per-session fajl: `{logDir}/{prefix}YYYY-MM-DD_HH-MM-SS.log`
+ *   - Sync `appendFileSync` iras — crash-safe, azonnali flush
+ *   - Rotation: `maxFileSizeMb` atlepesenel uj session fajl
+ *   - Retention: `maxFiles` (count) ES `retentionDays` (age) — ami elobb
+ *     teljesul; install-kor + minden rotation utan futtatva
+ *   - Silent failure: file IO hibak ELNYELODNEK (a file logger SOHASEM
+ *     buktathatja el a szervert)
+ *
+ * Idempotens: tobbszori install() hivas no-op (a masodiktol).
+ *
+ * Hasznalat:
+ *   DyNTS_global_settings.log_settings.file_log = { enabled: true, ... };
+ *   DyNTS_FileLog_Service.getInstance().install();  // szerver startup
+ */
+class DyNTS_FileLog_Service extends singleton_service_base_1.DyNTS_SingletonServiceBase {
+    static getInstance() {
+        return DyNTS_FileLog_Service.getSingletonInstance();
+    }
+    installed = false;
+    activeLogDir = '';
+    filenamePrefix = DEFAULT_FILENAME_PREFIX;
+    maxFileSizeBytes = DEFAULT_MAX_FILE_SIZE_MB * 1024 * 1024;
+    maxFiles = DEFAULT_MAX_FILES;
+    retentionDays = DEFAULT_RETENTION_DAYS;
+    stripAnsiEnabled = DEFAULT_STRIP_ANSI;
+    currentLogPath = '';
+    currentLogSizeBytes = 0;
+    originalStdoutWrite = null;
+    originalStderrWrite = null;
+    /**
+     * Telepiti a file logger-t a `DyNTS_global_settings.log_settings.file_log`
+     * config alapjan. Ha `enabled === false` vagy hianyzik a config → no-op.
+     *
+     * Idempotens — masodszori hivas no-op (akkor is, ha kozben a config
+     * valtozott; a service uj install-jara teardownFor Testing() + install()).
+     */
+    install() {
+        if (this.installed) {
+            return;
+        }
+        const config = global_settings_const_1.DyNTS_global_settings.log_settings?.file_log;
+        if (!config || !config.enabled) {
+            return;
+        }
+        // Config feldolgozas + default-ok
+        this.activeLogDir = config.logDir ?? DEFAULT_LOG_DIR;
+        this.filenamePrefix = config.filenamePrefix ?? DEFAULT_FILENAME_PREFIX;
+        this.maxFileSizeBytes = (config.maxFileSizeMb ?? DEFAULT_MAX_FILE_SIZE_MB) * 1024 * 1024;
+        this.maxFiles = config.maxFiles ?? DEFAULT_MAX_FILES;
+        this.retentionDays = config.retentionDays ?? DEFAULT_RETENTION_DAYS;
+        this.stripAnsiEnabled = config.stripAnsi ?? DEFAULT_STRIP_ANSI;
+        const includeStdout = config.includeStdout ?? DEFAULT_INCLUDE_STDOUT;
+        const includeStderr = config.includeStderr ?? DEFAULT_INCLUDE_STDERR;
+        // Log dir letrehozasa silently
+        try {
+            if (!fs.existsSync(this.activeLogDir)) {
+                fs.mkdirSync(this.activeLogDir, { recursive: true });
+            }
+        }
+        catch {
+            // Ha a mkdir bukik (pl. permission denied), no-op — silent failure
+            return;
+        }
+        // Retention cleanup MIELOTT az uj session fajl letrejon (hogy a takaritas
+        // log uzenete ne keruljon a most induló fajlba)
+        this.cleanupOldLogs();
+        // Uj session fajl path + size init
+        this.currentLogPath = path.join(this.activeLogDir, this.buildSessionFilename());
+        this.currentLogSizeBytes = 0;
+        // Monkey-patch — az originalokat elmentjük (teardown miatt)
+        if (includeStdout) {
+            this.originalStdoutWrite = process.stdout.write.bind(process.stdout);
+            const self = this;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            process.stdout.write = function patchedStdoutWrite(...args) {
+                self.teeWrite(args[0]);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return self.originalStdoutWrite(...args);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            };
+        }
+        if (includeStderr) {
+            this.originalStderrWrite = process.stderr.write.bind(process.stderr);
+            const self = this;
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            process.stderr.write = function patchedStderrWrite(...args) {
+                self.teeWrite(args[0]);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                return self.originalStderrWrite(...args);
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            };
+        }
+        this.installed = true;
+        // Session header — kulcs info egy helyen a fajl tetejen
+        this.teeWrite(`===== DyNTS server log session started at ${new Date().toISOString()} =====\n` +
+            `===== PID: ${process.pid}, Node: ${process.version} =====\n` +
+            `===== Retention: ${this.retentionDays} days, max files: ${this.maxFiles}, max size: ${config.maxFileSizeMb ?? DEFAULT_MAX_FILE_SIZE_MB}MB =====\n\n`);
+    }
+    /**
+     * Visszaadja az aktualis log fajl abszolut path-jat (csak akkor letezo,
+     * ha az install() sikeresen lefutott; egyebkent ures string).
+     */
+    getCurrentLogPath() {
+        return this.currentLogPath;
+    }
+    /**
+     * Az aktualis aktiv log fajl basename-je (NEM teljes path). Csak akkor
+     * nem-ures, ha az install() sikeresen lefutott.
+     */
+    getCurrentLogFilename() {
+        if (!this.currentLogPath) {
+            return '';
+        }
+        return path.basename(this.currentLogPath);
+    }
+    /**
+     * Aktiv log dir abszolut path-ja. Csak akkor nem-ures, ha az install()
+     * sikeresen lefutott.
+     */
+    getActiveLogDir() {
+        return this.activeLogDir;
+    }
+    /**
+     * Aktiv filename prefix (a service config-jabol). Hasznalja a controller
+     * a request-fajlnev whitelist regex epitesehez.
+     */
+    getFilenamePrefix() {
+        return this.filenamePrefix;
+    }
+    /**
+     * Osszes log fajl listazasa az aktiv log dir-bol. Csak a service prefix-evel
+     * matchelo fajlokat veszi (`{prefix}*.log`).
+     *
+     * Rendezes: mtime DESC (legujabb elol). Hibakat csendben elnyel — ha a dir
+     * nem letezik vagy nem olvashato, ures array-t ad vissza.
+     */
+    listLogFiles() {
+        if (!this.activeLogDir || !this.installed) {
+            return [];
+        }
+        const currentBasename = this.getCurrentLogFilename();
+        const entries = [];
+        try {
+            const dirContents = fs.readdirSync(this.activeLogDir);
+            for (const name of dirContents) {
+                if (!name.startsWith(this.filenamePrefix) || !name.endsWith(DEFAULT_FILENAME_SUFFIX)) {
+                    continue;
+                }
+                const fullPath = path.join(this.activeLogDir, name);
+                try {
+                    const stats = fs.statSync(fullPath);
+                    if (!stats.isFile()) {
+                        continue;
+                    }
+                    entries.push({
+                        name: name,
+                        sizeBytes: stats.size,
+                        mtimeMs: stats.mtimeMs,
+                        isCurrent: name === currentBasename,
+                    });
+                }
+                catch {
+                    // egy fajlonkenti hiba ne szakitsa meg a listat
+                }
+            }
+        }
+        catch {
+            // dir read hiba → ures listat adunk vissza
+            return [];
+        }
+        // Legujabb elol
+        entries.sort((a, b) => b.mtimeMs - a.mtimeMs);
+        return entries;
+    }
+    /**
+     * Egy konkret log fajl olvasasa, line-based mode-ban (tail / head / range).
+     *
+     * **Biztonsagi safeguards:**
+     * - Filename whitelist: `{prefix}*.log` mintara matchelo nev kotelezo
+     * - Path resolution `path.resolve(activeLogDir, name)` + `startsWith(activeLogDir)` (path traversal vedelem)
+     * - Sor szam cap: `MAX_READ_LINES` (10000)
+     *
+     * **Hibak:**
+     * - Throw `Error('not installed')` ha a service nincs install-olva
+     * - Throw `Error('invalid filename')` ha a name nem matchel a whitelist-re VAGY kilep az activeLogDir-bol
+     * - Throw `Error('file not found')` ha a fajl nem letezik
+     *
+     * A hivot kell vigyaznia hogy ezeket HTTP status code-okra forditja.
+     */
+    readLogFile(name, options = {}) {
+        if (!this.installed || !this.activeLogDir) {
+            throw new Error('FileLog service not installed');
+        }
+        // Whitelist regex: csak a service prefix-evel matchelo fajlnev
+        if (!this.isValidFilename(name)) {
+            throw new Error('invalid filename');
+        }
+        // Path resolve + traversal check
+        const resolvedPath = path.resolve(this.activeLogDir, name);
+        const resolvedDir = path.resolve(this.activeLogDir);
+        // path.sep + sufix ellenőrzéssel megelőzzük a hasonló prefixű dir átverést
+        // (pl. '/logs' vs '/logs-other'); a resolvedPath az activeLogDir-en BELUL
+        // kell legyen.
+        if (!resolvedPath.startsWith(resolvedDir + path.sep) && resolvedPath !== resolvedDir) {
+            throw new Error('invalid filename');
+        }
+        if (!fs.existsSync(resolvedPath)) {
+            throw new Error('file not found');
+        }
+        const stats = fs.statSync(resolvedPath);
+        if (!stats.isFile()) {
+            throw new Error('file not found');
+        }
+        // Olvass + split soroka. UTF-8 encoding alapertelmezett. Nagy fajloknal a
+        // teljes betoltes nem ideal, de a 10000-soros cap es a Stream-based
+        // optimization egy kesobbi iteracio lehet ha kell.
+        const fullContent = fs.readFileSync(resolvedPath, 'utf-8');
+        // Split a sorvegekre — utolso ures stringet kivagjuk ha a fajl
+        // sorvégzodessel zarult (regenerált sor szám hibakerulest celozzuk meg)
+        const allLines = fullContent.split(/\r?\n/);
+        if (allLines.length > 0 && allLines[allLines.length - 1] === '') {
+            allLines.pop();
+        }
+        const totalLines = allLines.length;
+        // Mod meghatarozasa: range > head > tail
+        let mode;
+        let startIdx;
+        let endIdx; // exclusive
+        if (options.rangeStart !== undefined && options.rangeEnd !== undefined) {
+            mode = 'range';
+            const start1 = Math.max(1, Math.floor(options.rangeStart));
+            const end1 = Math.max(start1, Math.floor(options.rangeEnd));
+            startIdx = Math.max(0, Math.min(totalLines, start1 - 1));
+            endIdx = Math.max(startIdx, Math.min(totalLines, end1));
+            // Cap
+            if (endIdx - startIdx > MAX_READ_LINES) {
+                endIdx = startIdx + MAX_READ_LINES;
+            }
+        }
+        else if (options.head !== undefined) {
+            mode = 'head';
+            const headN = Math.min(Math.max(1, Math.floor(options.head)), MAX_READ_LINES);
+            startIdx = 0;
+            endIdx = Math.min(totalLines, headN);
+        }
+        else {
+            mode = 'tail';
+            const tailN = Math.min(Math.max(1, Math.floor(options.tail ?? DEFAULT_READ_TAIL)), MAX_READ_LINES);
+            startIdx = Math.max(0, totalLines - tailN);
+            endIdx = totalLines;
+        }
+        const lines = allLines.slice(startIdx, endIdx);
+        return {
+            name: path.basename(resolvedPath),
+            sizeBytes: stats.size,
+            totalLines: totalLines,
+            lines: lines,
+            mode: mode,
+            rangeStart: startIdx + 1, // 1-based, inclusive
+            rangeEnd: Math.max(startIdx, endIdx), // 1-based, inclusive ha lines van; egyebkent 0-szeru
+        };
+    }
+    /**
+     * Filename whitelist ellenorzes. Csak a service prefix-evel matchelo,
+     * biztonsagos karakterkeszletu fajlnev megengedett.
+     */
+    isValidFilename(name) {
+        if (typeof name !== 'string' || name.length === 0 || name.length > 256) {
+            return false;
+        }
+        // Path-szeparatorokat kifejezetten tiltjuk (mar a regex is, de gyors check)
+        if (name.includes('/') || name.includes('\\') || name.includes('..')) {
+            return false;
+        }
+        // `{prefix}[\w\-.]+\.log` — szigoru ASCII set
+        const escapedPrefix = this.filenamePrefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+        const regex = new RegExp(`^${escapedPrefix}[\\w\\-.]+\\.log$`);
+        return regex.test(name);
+    }
+    /**
+     * Telepitve van-e (csak akkor true, ha az enabled === true es a setup nem bukott).
+     */
+    isInstalled() {
+        return this.installed;
+    }
+    /**
+     * Test-only: visszallitja az eredeti stdout/stderr.write-okat, hogy a
+     * specfajlok egymas utan tisztán futhassanak. Production code NE hivja.
+     */
+    _teardownForTesting() {
+        if (this.originalStdoutWrite) {
+            process.stdout.write = this.originalStdoutWrite;
+            this.originalStdoutWrite = null;
+        }
+        if (this.originalStderrWrite) {
+            process.stderr.write = this.originalStderrWrite;
+            this.originalStderrWrite = null;
+        }
+        this.installed = false;
+        this.activeLogDir = '';
+        this.currentLogPath = '';
+        this.currentLogSizeBytes = 0;
+    }
+    /**
+     * Session fajl nev: `{prefix}YYYY-MM-DD_HH-MM-SS_RANDOM.log`. Az RANDOM
+     * suffix biztositja a unique nevet ha ugyanazon a masodpercen tobb fajl jon letre
+     * (pl. rotation kozvetlenul install utan, vagy specfajlok gyors egymas utan).
+     */
+    buildSessionFilename() {
+        const now = new Date();
+        const year = String(now.getFullYear());
+        const month = String(now.getMonth() + 1).padStart(2, '0');
+        const day = String(now.getDate()).padStart(2, '0');
+        const hour = String(now.getHours()).padStart(2, '0');
+        const minute = String(now.getMinutes()).padStart(2, '0');
+        const second = String(now.getSeconds()).padStart(2, '0');
+        const rand = Math.floor(Math.random() * 100000).toString(36);
+        return `${this.filenamePrefix}${year}-${month}-${day}_${hour}-${minute}-${second}_${rand}${DEFAULT_FILENAME_SUFFIX}`;
+    }
+    /**
+     * Egyetlen stdout/stderr iras tee-zese az aktualis log fajlba.
+     * Hibakat csendben elnyeli — a file logger SOHASEM blokkolja a szervert.
+     * Size-trackeli az aktualis fajlt es szukseg szerint rotalja.
+     */
+    teeWrite(data) {
+        try {
+            if (!this.currentLogPath) {
+                return;
+            }
+            const asString = typeof data === 'string'
+                ? data
+                : Buffer.from(data).toString('utf-8');
+            const cleaned = this.stripAnsiEnabled ? asString.replace(ANSI_ESCAPE_REGEX, '') : asString;
+            const writeBytes = Buffer.byteLength(cleaned, 'utf-8');
+            fs.appendFileSync(this.currentLogPath, cleaned, 'utf-8');
+            this.currentLogSizeBytes += writeBytes;
+            // Rotation trigger
+            if (this.currentLogSizeBytes >= this.maxFileSizeBytes) {
+                this.rotate();
+            }
+        }
+        catch {
+            // szandekosan elnyelve — silent failure
+        }
+    }
+    /**
+     * Uj session fajl letrehozasa (az aktualis lezarodik). Retention cleanup-ot is
+     * vegrehajt, hogy a rotation termeszetesen tisztan tarttsa a log dir-t.
+     */
+    rotate() {
+        try {
+            this.cleanupOldLogs();
+            this.currentLogPath = path.join(this.activeLogDir, this.buildSessionFilename());
+            this.currentLogSizeBytes = 0;
+        }
+        catch {
+            // szandekosan elnyelve
+        }
+    }
+    /**
+     * Retention takaritas: ket szabaly ami ami elobb teljesul:
+     *   1) maxFiles — ha tobb mint N log fajl van, a legregebbieket torli
+     *   2) retentionDays — `retentionDays`-nel idosebb fajlokat torli
+     *
+     * Hibakat csendben elnyel. A torolt fajlokat es az okot NEM logoljuk, hogy
+     * ne kerüljön extra szennyezes a most induló session fajlba.
+     */
+    cleanupOldLogs() {
+        try {
+            if (!fs.existsSync(this.activeLogDir)) {
+                return;
+            }
+            const cutoffMs = Date.now() - this.retentionDays * 24 * 60 * 60 * 1000;
+            const entries = fs.readdirSync(this.activeLogDir);
+            const matchingFiles = [];
+            for (const entry of entries) {
+                if (!entry.startsWith(this.filenamePrefix) || !entry.endsWith(DEFAULT_FILENAME_SUFFIX)) {
+                    continue;
+                }
+                const fullPath = path.join(this.activeLogDir, entry);
+                try {
+                    const stats = fs.statSync(fullPath);
+                    matchingFiles.push({ fullPath: fullPath, mtimeMs: stats.mtimeMs });
+                }
+                catch {
+                    // fajlonkent elnyelve
+                }
+            }
+            // Sort: legujabb elol -> legregebbi hatul (csokkeno mtime)
+            matchingFiles.sort((a, b) => b.mtimeMs - a.mtimeMs);
+            for (let i = 0; i < matchingFiles.length; i++) {
+                const file = matchingFiles[i];
+                const tooOldByAge = file.mtimeMs < cutoffMs;
+                const tooManyByCount = i >= this.maxFiles;
+                if (tooOldByAge || tooManyByCount) {
+                    try {
+                        fs.unlinkSync(file.fullPath);
+                    }
+                    catch { /* fajlonkent elnyelve */ }
+                }
+            }
+        }
+        catch {
+            // szandekosan elnyelve
+        }
+    }
+}
+exports.DyNTS_FileLog_Service = DyNTS_FileLog_Service;
 //# sourceMappingURL=file-log.service.js.map