@futdevpro/nts-dynamo 1.15.20 → 1.15.21

package/build/_modules/logs/get-file-logs-routing-module.util.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_getFileLogsRoutingModule = DyNTS_getFileLogsRoutingModule;
+const routing_module_service_1 = require("../../_services/route/routing-module.service");
+const file_logs_controller_1 = require("./file-logs.controller");
+/**
+ * Letrehoz egy routing module-t a `DyNTS_FileLogs_Controller`-rel.
+ *
+ * **Hasznalat (auth nelkul, fejlesztoi env):**
+ *   ```ts
+ *   app.use(DyNTS_getFileLogsRoutingModule());
+ *   ```
+ *
+ * **Hasznalat (admin API key auth-tal — javasolt produkcios env-re):**
+ *   ```ts
+ *   const adminAuth = DyNTS_AdminApiKey_AuthService.getInstance();
+ *   app.use(DyNTS_getFileLogsRoutingModule({
+ *     authPreProcess: adminAuth.verify,
+ *     route: '/admin/file-logs',  // opcionalis override
+ *   }));
+ *   ```
+ *
+ * **Elofeltetel:** `DyNTS_FileLog_Service.getInstance().install()` lefutott
+ * a szerver startup-on (es a `log_settings.file_log.enabled = true`).
+ * Egyebkent a controller endpointjai 503-at adnak.
+ */
+function DyNTS_getFileLogsRoutingModule(config) {
+    // Controller config atadasa (static — getInstance() elott)
+    if (config) {
+        file_logs_controller_1.DyNTS_FileLogs_Controller.configure({ authPreProcess: config.authPreProcess });
+    }
+    const settings = {
+        route: config?.route ?? '/file-logs',
+        controllers: [file_logs_controller_1.DyNTS_FileLogs_Controller.getInstance()],
+    };
+    return new routing_module_service_1.DyNTS_RoutingModule(settings);
+}
+//# sourceMappingURL=get-file-logs-routing-module.util.js.map

package/build/_modules/logs/get-file-logs-routing-module.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file-logs-routing-module.util.js","sourceRoot":"","sources":["../../../src/_modules/logs/get-file-logs-routing-module.util.ts"],"names":[],"mappings":";;AAoCA,wEAcC;AAjDD,yFAAmF;AAEnF,iEAAoG;AAYpG;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,SAAgB,8BAA8B,CAC5C,MAA2C;IAE3C,2DAA2D;IAC3D,IAAI,MAAM,EAAE,CAAC;QACX,gDAAyB,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE,CAAC,CAAC;IACjF,CAAC;IAED,MAAM,QAAQ,GAAiC;QAC7C,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,YAAY;QACpC,WAAW,EAAE,CAAC,gDAAyB,CAAC,WAAW,EAAE,CAAC;KACvD,CAAC;IAEF,OAAO,IAAI,4CAAmB,CAAC,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

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

@@ -2,4 +2,8 @@ export { DyNTS_Logs_Service } from './logs.service';
 export { DyNTS_Logs_Controller, DyNTS_LogsController_Config } from './logs.controller';
 export { DyNTS_getLogsRoutingModule } from './get-logs-routing-module.util';
 export { DyNTS_FileLog_Service } from './file-log.service';
+export { DyNTS_FileLogs_Controller, DyNTS_FileLogsController_Config } from './file-logs.controller';
+export { DyNTS_getFileLogsRoutingModule, DyNTS_FileLogsRoutingModule_Config, } from './get-file-logs-routing-module.util';
+export { DyNTS_FileLog_Entry } from './_models/file-log-entry.interface';
+export { DyNTS_FileLog_ReadResult, DyNTS_FileLog_ReadOptions } from './_models/file-log-read-result.interface';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/logs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/logs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,0BAA0B,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,EACL,8BAA8B,EAC9B,kCAAkC,GACnC,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC"}

package/build/_modules/logs/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_FileLog_Service = exports.DyNTS_getLogsRoutingModule = exports.DyNTS_Logs_Controller = exports.DyNTS_Logs_Service = void 0;
+exports.DyNTS_getFileLogsRoutingModule = exports.DyNTS_FileLogs_Controller = exports.DyNTS_FileLog_Service = exports.DyNTS_getLogsRoutingModule = exports.DyNTS_Logs_Controller = exports.DyNTS_Logs_Service = void 0;
 var logs_service_1 = require("./logs.service");
 Object.defineProperty(exports, "DyNTS_Logs_Service", { enumerable: true, get: function () { return logs_service_1.DyNTS_Logs_Service; } });
 var logs_controller_1 = require("./logs.controller");
@@ -9,4 +9,8 @@ var get_logs_routing_module_util_1 = require("./get-logs-routing-module.util");
 Object.defineProperty(exports, "DyNTS_getLogsRoutingModule", { enumerable: true, get: function () { return get_logs_routing_module_util_1.DyNTS_getLogsRoutingModule; } });
 var file_log_service_1 = require("./file-log.service");
 Object.defineProperty(exports, "DyNTS_FileLog_Service", { enumerable: true, get: function () { return file_log_service_1.DyNTS_FileLog_Service; } });
+var file_logs_controller_1 = require("./file-logs.controller");
+Object.defineProperty(exports, "DyNTS_FileLogs_Controller", { enumerable: true, get: function () { return file_logs_controller_1.DyNTS_FileLogs_Controller; } });
+var get_file_logs_routing_module_util_1 = require("./get-file-logs-routing-module.util");
+Object.defineProperty(exports, "DyNTS_getFileLogsRoutingModule", { enumerable: true, get: function () { return get_file_logs_routing_module_util_1.DyNTS_getFileLogsRoutingModule; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/logs/index.ts"],"names":[],"mappings":";;;AAAA,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,qDAAuF;AAA9E,wHAAA,qBAAqB,OAAA;AAC9B,+EAA4E;AAAnE,0IAAA,0BAA0B,OAAA;AACnC,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/logs/index.ts"],"names":[],"mappings":";;;AAAA,+CAAoD;AAA3C,kHAAA,kBAAkB,OAAA;AAC3B,qDAAuF;AAA9E,wHAAA,qBAAqB,OAAA;AAC9B,+EAA4E;AAAnE,0IAAA,0BAA0B,OAAA;AACnC,uDAA2D;AAAlD,yHAAA,qBAAqB,OAAA;AAC9B,+DAAoG;AAA3F,iIAAA,yBAAyB,OAAA;AAClC,yFAG6C;AAF3C,mJAAA,8BAA8B,OAAA"}

package/package.json

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

package/src/_modules/logs/_models/file-log-entry.interface.ts

@@ -0,0 +1,13 @@
+/**
+ * Egy log fajl meta-adata a listazasban.
+ */
+export interface DyNTS_FileLog_Entry {
+  /** Fajlnev (csak basename — NEM teljes path). */
+  name: string;
+  /** Fajlmeret byte-ban. */
+  sizeBytes: number;
+  /** Modositasi ido ms-ban (mtimeMs). */
+  mtimeMs: number;
+  /** Igaz, ha ez az aktualis aktiv session fajlja. */
+  isCurrent: boolean;
+}

package/src/_modules/logs/_models/file-log-read-result.interface.ts

@@ -0,0 +1,37 @@
+/**
+ * `readLogFile()` valaszobjektum.
+ */
+export interface DyNTS_FileLog_ReadResult {
+  /** Fajlnev (csak basename). */
+  name: string;
+  /** Teljes fajlmeret byte-ban. */
+  sizeBytes: number;
+  /** A fajlban talalhato osszes sor szama. */
+  totalLines: number;
+  /** A visszaadott sorok. */
+  lines: string[];
+  /** Mod amiben olvastunk: 'tail' | 'head' | 'range'. */
+  mode: 'tail' | 'head' | 'range';
+  /** Visszaadott tartomany 1-based start (range/tail/head normalizalva). */
+  rangeStart: number;
+  /** Visszaadott tartomany 1-based end (inclusive). */
+  rangeEnd: number;
+}
+
+
+/**
+ * `readLogFile(name, options)` opciok.
+ *
+ * Egyetlen mod aktiv egyszerre. Prioritas: range > head > tail.
+ * Egyik sem megadott → default `tail: 200`.
+ */
+export interface DyNTS_FileLog_ReadOptions {
+  /** Utolso N sor (default mod ha semmi mas nincs). */
+  tail?: number;
+  /** Elso N sor. */
+  head?: number;
+  /** 1-based line range start (inclusive). `rangeEnd` is kell. */
+  rangeStart?: number;
+  /** 1-based line range end (inclusive). */
+  rangeEnd?: number;
+}

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

@@ -199,4 +199,143 @@ describe('| DyNTS_FileLog_Service', (): void => {
       expect(DyNTS_FileLog_Service.getInstance().isInstalled()).toBe(false);
     });
   });
+
+  describe('| listLogFiles()', (): void => {
+    it('| ures lista ha nincs installalva', (): void => {
+      const svc = DyNTS_FileLog_Service.getInstance();
+      // NEM hivunk install-t
+      expect(svc.listLogFiles()).toEqual([]);
+    });
+
+    it('| listazza az osszes prefix-elt log fajlt + jelzi az isCurrent flag-et', (): void => {
+      // 3 fajl letrehozasa kezzel kulonbozo prefix-szel
+      fs.writeFileSync(path.join(tempDir, 'spec-2026-01-01_aaa.log'), 'a');
+      fs.writeFileSync(path.join(tempDir, 'spec-2026-01-02_bbb.log'), 'bb');
+      fs.writeFileSync(path.join(tempDir, 'spec-2026-01-03_ccc.log'), 'ccc');
+      fs.writeFileSync(path.join(tempDir, 'other-2026-01-04_zzz.log'), 'should-be-ignored');
+
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+      };
+      const svc = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+
+      const list = svc.listLogFiles();
+      // 3 spec- fajl + 1 aktualis session fajl = 4
+      expect(list.length).toBe(4);
+      const names: string[] = list.map((e) => e.name);
+      expect(names.find((n) => n.startsWith('other-'))).toBeUndefined();
+      expect(list.filter((e) => e.isCurrent).length).toBe(1);
+    });
+  });
+
+  describe('| readLogFile() — happy paths', (): void => {
+    let svc: DyNTS_FileLog_Service;
+    let testFile: string;
+
+    beforeEach((): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+      };
+      svc = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+      // Kulon teszt-fajl
+      testFile = `spec-test-${Date.now()}.log`;
+      const lines: string[] = [];
+      for (let i: number = 1; i <= 50; i++) {
+        lines.push(`line-${i}`);
+      }
+      fs.writeFileSync(path.join(tempDir, testFile), lines.join('\n') + '\n');
+    });
+
+    it('| tail mod: utolso N sor', (): void => {
+      const result = svc.readLogFile(testFile, { tail: 5 });
+      expect(result.mode).toBe('tail');
+      expect(result.lines).toEqual(['line-46', 'line-47', 'line-48', 'line-49', 'line-50']);
+      expect(result.totalLines).toBe(50);
+      expect(result.rangeStart).toBe(46);
+      expect(result.rangeEnd).toBe(50);
+    });
+
+    it('| head mod: elso N sor', (): void => {
+      const result = svc.readLogFile(testFile, { head: 3 });
+      expect(result.mode).toBe('head');
+      expect(result.lines).toEqual(['line-1', 'line-2', 'line-3']);
+      expect(result.rangeStart).toBe(1);
+      expect(result.rangeEnd).toBe(3);
+    });
+
+    it('| range mod: explicit 10-15 tartomany', (): void => {
+      const result = svc.readLogFile(testFile, { rangeStart: 10, rangeEnd: 15 });
+      expect(result.mode).toBe('range');
+      expect(result.lines).toEqual(['line-10', 'line-11', 'line-12', 'line-13', 'line-14', 'line-15']);
+    });
+
+    it('| default tail 200 ha semmi mod nincs megadva', (): void => {
+      const result = svc.readLogFile(testFile, {});
+      expect(result.mode).toBe('tail');
+      // A teszt fajl 50 sor → mind visszajon
+      expect(result.lines.length).toBe(50);
+    });
+  });
+
+  describe('| readLogFile() — error paths', (): void => {
+    let svc: DyNTS_FileLog_Service;
+
+    beforeEach((): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+      };
+      svc = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+    });
+
+    it('| throw ha invalid filename (prefix nem matchel)', (): void => {
+      expect(() => svc.readLogFile('other-2026.log')).toThrowError('invalid filename');
+    });
+
+    it('| throw ha path traversal kiserlet (`../`)', (): void => {
+      expect(() => svc.readLogFile('../etc/passwd')).toThrowError('invalid filename');
+    });
+
+    it('| throw ha path separator (`/`) van a nevben', (): void => {
+      expect(() => svc.readLogFile('spec-foo/bar.log')).toThrowError('invalid filename');
+    });
+
+    it('| throw ha file nem letezik', (): void => {
+      expect(() => svc.readLogFile('spec-nonexistent.log')).toThrowError('file not found');
+    });
+
+    it('| NEM installalt service → throw `not installed`', (): void => {
+      svc._teardownForTesting();
+      expect(() => svc.readLogFile('spec-foo.log')).toThrowError(/not installed/);
+    });
+  });
+
+  describe('| getCurrentLogFilename()', (): void => {
+    it('| ures string ha nincs installalva', (): void => {
+      expect(DyNTS_FileLog_Service.getInstance().getCurrentLogFilename()).toBe('');
+    });
+
+    it('| basename-t ad vissza ha installalva van', (): void => {
+      DyNTS_global_settings.log_settings.file_log = {
+        enabled: true,
+        logDir: tempDir,
+        filenamePrefix: 'spec-',
+      };
+      const svc = DyNTS_FileLog_Service.getInstance();
+      svc.install();
+      const basename: string = svc.getCurrentLogFilename();
+      expect(basename.startsWith('spec-')).toBe(true);
+      expect(basename.endsWith('.log')).toBe(true);
+      expect(basename.includes('/')).toBe(false);
+      expect(basename.includes('\\')).toBe(false);
+    });
+  });
 });

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

@@ -3,6 +3,8 @@ import * as path from 'path';
 
 import { DyNTS_SingletonServiceBase } from '../../_services/base/singleton.service-base';
 import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+import { DyNTS_FileLog_Entry } from './_models/file-log-entry.interface';
+import { DyNTS_FileLog_ReadOptions, DyNTS_FileLog_ReadResult } from './_models/file-log-read-result.interface';
 
 
 /**
@@ -22,6 +24,12 @@ const DEFAULT_INCLUDE_STDERR: boolean = true;
 /** ANSI escape code regex (szin/formazas kodok). */
 const ANSI_ESCAPE_REGEX: RegExp = /\x1b\[[0-9;]*[a-zA-Z]/g;
 
+/** Max sor szam egy `readLogFile()` hivasra — vedi a memory-t nagy fajloknal. */
+const MAX_READ_LINES: number = 10000;
+
+/** Default tail sor szam (ha semmi mas mod nincs megadva). */
+const DEFAULT_READ_TAIL: number = 200;
+
 
 /**
  * File-based szerver log service — duplikalja a stdout/stderr-t per-session
@@ -149,6 +157,181 @@ export class DyNTS_FileLog_Service extends DyNTS_SingletonServiceBase {
     return this.currentLogPath;
   }
 
+  /**
+   * Az aktualis aktiv log fajl basename-je (NEM teljes path). Csak akkor
+   * nem-ures, ha az install() sikeresen lefutott.
+   */
+  getCurrentLogFilename(): string {
+    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(): string {
+    return this.activeLogDir;
+  }
+
+  /**
+   * Aktiv filename prefix (a service config-jabol). Hasznalja a controller
+   * a request-fajlnev whitelist regex epitesehez.
+   */
+  getFilenamePrefix(): string {
+    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(): DyNTS_FileLog_Entry[] {
+    if (!this.activeLogDir || !this.installed) { return []; }
+    const currentBasename: string = this.getCurrentLogFilename();
+    const entries: DyNTS_FileLog_Entry[] = [];
+
+    try {
+      const dirContents: string[] = fs.readdirSync(this.activeLogDir);
+      for (const name of dirContents) {
+        if (!name.startsWith(this.filenamePrefix) || !name.endsWith(DEFAULT_FILENAME_SUFFIX)) { continue; }
+        const fullPath: string = path.join(this.activeLogDir, name);
+        try {
+          const stats: fs.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: DyNTS_FileLog_Entry, b: DyNTS_FileLog_Entry): number => 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: string, options: DyNTS_FileLog_ReadOptions = {}): DyNTS_FileLog_ReadResult {
+    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: string = path.resolve(this.activeLogDir, name);
+    const resolvedDir: string = 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.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: string = 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: string[] = fullContent.split(/\r?\n/);
+    if (allLines.length > 0 && allLines[allLines.length - 1] === '') {
+      allLines.pop();
+    }
+    const totalLines: number = allLines.length;
+
+    // Mod meghatarozasa: range > head > tail
+    let mode: 'tail' | 'head' | 'range';
+    let startIdx: number;
+    let endIdx: number;  // exclusive
+
+    if (options.rangeStart !== undefined && options.rangeEnd !== undefined) {
+      mode = 'range';
+      const start1: number = Math.max(1, Math.floor(options.rangeStart));
+      const end1: number = 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: number = Math.min(Math.max(1, Math.floor(options.head)), MAX_READ_LINES);
+      startIdx = 0;
+      endIdx   = Math.min(totalLines, headN);
+    } else {
+      mode = 'tail';
+      const tailN: number = 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: string[] = 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.
+   */
+  private isValidFilename(name: string): boolean {
+    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: string = this.filenamePrefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const regex: RegExp = new RegExp(`^${escapedPrefix}[\\w\\-.]+\\.log$`);
+    return regex.test(name);
+  }
+
   /**
    * Telepitve van-e (csak akkor true, ha az enabled === true es a setup nem bukott).
    */