@futdevpro/nts-dynamo 1.15.156 → 1.15.160

package/build/_services/core/collection-growth-monitor.service.js

@@ -1,166 +1,166 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_CollectionGrowthMonitor = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-const singleton_service_base_1 = require("../base/singleton.service-base");
-const global_service_1 = require("./global.service");
-class DyNTS_CollectionGrowthMonitor extends singleton_service_base_1.DyNTS_SingletonServiceBase {
-    static getInstance() {
-        return DyNTS_CollectionGrowthMonitor.getSingletonInstance();
-    }
-    timer = null;
-    installed = false;
-    // Resolved (effective) config — filled at install().
-    pollIntervalMs = 300000;
-    sizeThresholdDocCount = 250000;
-    growthRateThresholdPct = 50;
-    reAlertCooldownMs = 3600000;
-    lastSnapshotByCollection = new Map();
-    /** Last time we alerted, keyed by `${dataName}:${kind}` — for the anti-flood cooldown. */
-    lastAlertAtByKey = new Map();
-    constructor() {
-        super();
-    }
-    /**
-     * Start the monitor. Idempotent (a second call is a no-op). `config` overrides
-     * `DyNTS_global_settings.collectionGrowthMonitor`, which overrides the built-in defaults. NEVER
-     * throws — every error is try/catch-ed and descriptively logged.
-     */
-    install(config) {
-        if (this.installed) {
-            return;
-        }
-        try {
-            const g = global_settings_const_1.DyNTS_global_settings.collectionGrowthMonitor ?? { enabled: true };
-            if (!(config?.enabled ?? g.enabled ?? true)) {
-                return;
-            }
-            this.pollIntervalMs = config?.pollIntervalMs ?? g.pollIntervalMs ?? 300000;
-            this.sizeThresholdDocCount = config?.sizeThresholdDocCount ?? g.sizeThresholdDocCount ?? 250000;
-            this.growthRateThresholdPct = config?.growthRateThresholdPct ?? g.growthRateThresholdPct ?? 50;
-            this.reAlertCooldownMs = config?.reAlertCooldownMs ?? g.reAlertCooldownMs ?? 3600000;
-            this.installed = true;
-            this.timer = setInterval(() => { void this.poll(); }, this.pollIntervalMs);
-            if (typeof this.timer.unref === 'function') {
-                this.timer.unref();
-            }
-            fsm_dynamo_1.DyFM_Log.info(`[DyNTS_CollectionGrowthMonitor] installed — poll ${Math.round(this.pollIntervalMs / 1000)}s, ` +
-                `size-threshold ${this.sizeThresholdDocCount} docs, growth-rate ${this.growthRateThresholdPct}%/poll`);
-        }
-        catch (err) {
-            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_CollectionGrowthMonitor] install failed (non-fatal):', err);
-        }
-    }
-    /**
-     * Pure decision core (unit-tested): given a fresh count + the previous snapshot, return the alerts
-     * to raise. NEVER does I/O. A `size` alert fires when `count > sizeThreshold`; a `growth` alert
-     * fires when the collection grew by more than `growthRatePct` since the last snapshot (needs a
-     * non-zero previous count).
-     */
-    static evaluateGrowth(dataName, count, last, sizeThreshold, growthRatePct, retentionTtlSec) {
-        const alerts = [];
-        if (count > sizeThreshold) {
-            // FR-311 — RETENTION-TUDATOS tanacs. A korabbi uzenet FELTETEL NELKUL azt ajanlotta, hogy
-            // "declare `retention`" — akkor is, ha a modell MAR deklaralt egyet. Elesben (2026-08-19,
-            // overseer `ov_secret_audit`, 253 617 dokumentum) ez oda vezetett, hogy az operator olyat
-            // kapott feladatul, ami mar KESZ volt, orankent ujra, az error-tarba is elmentve. A ket eset
-            // KULONBOZO teendot kiván, ezert kulon is kell mondani oket.
-            const retentionDays = retentionTtlSec === undefined
-                ? null
-                : Math.round(retentionTtlSec / 86400);
-            alerts.push({
-                kind: 'size',
-                dataName: dataName,
-                message: retentionDays === null
-                    ? `Collection "${dataName}" has ${count} documents (> ${sizeThreshold} threshold) — ` +
-                        `unbounded-growth risk. Consider declaring \`retention\` on this model (FR-258 / SR-1).`
-                    : `Collection "${dataName}" has ${count} documents (> ${sizeThreshold} threshold) DESPITE a ` +
-                        `declared retention of ~${retentionDays} day(s) — the window is too long, or growth outpaces ` +
-                        `the TTL. Shorten \`retention\` or reduce the write-rate (FR-258 / SR-1).`,
-                detail: {
-                    collection: dataName, docCount: count, threshold: sizeThreshold,
-                    retentionDays: retentionDays,
-                },
-            });
-        }
-        if (last && last.docCount > 0) {
-            const growthPct = ((count - last.docCount) / last.docCount) * 100;
-            if (growthPct > growthRatePct) {
-                alerts.push({
-                    kind: 'growth',
-                    dataName: dataName,
-                    message: `Collection "${dataName}" grew ${Math.round(growthPct)}% since the last poll ` +
-                        `(${last.docCount} → ${count} docs) — fast unbounded growth.`,
-                    detail: { collection: dataName, oldCount: last.docCount, newCount: count, growthPct: Math.round(growthPct) },
-                });
-            }
-        }
-        return alerts;
-    }
-    /**
-     * One poll cycle: sample every registered collection's `estimatedDocumentCount()` (scan-free) and
-     * raise cooldown-gated warnings. Fully non-fatal — a failure on one collection never aborts the rest.
-     */
-    async poll() {
-        try {
-            const services = global_service_1.DyNTS_GlobalService.getAllDBServices();
-            const nowMs = Date.now();
-            for (const service of services) {
-                const dataName = service?.dataParams?.dataName;
-                const model = service?.dataModel;
-                if (!dataName || !model || typeof model.estimatedDocumentCount !== 'function') {
-                    continue;
-                }
-                try {
-                    const count = await model.estimatedDocumentCount();
-                    const last = this.lastSnapshotByCollection.get(dataName);
-                    // FR-311 — a modell SAJAT retention-deklaraciojat visszük be a dontesbe. A feloldas az
-                    // fsm-dynamo SSOT-resolvereval megy (`ttlSeconds` > `retentionDays`, ervenytelen ertek
-                    // elutasitva) — NEM ujraimplementalva, kulonben ketfele igazsag lenne rola.
-                    const retentionTtlSec = (0, fsm_dynamo_1.DyFM_resolveRetentionTtlSeconds)(service?.dataParams?.retention);
-                    const alerts = DyNTS_CollectionGrowthMonitor.evaluateGrowth(dataName, count, last, this.sizeThresholdDocCount, this.growthRateThresholdPct, retentionTtlSec);
-                    for (const alert of alerts) {
-                        this.emitAlert(alert, nowMs);
-                    }
-                    this.lastSnapshotByCollection.set(dataName, { docCount: count, atMs: nowMs });
-                }
-                catch (collErr) {
-                    fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_CollectionGrowthMonitor] poll for "${dataName}" failed (non-fatal): ` +
-                        `${collErr instanceof Error ? collErr.message : String(collErr)}`);
-                }
-            }
-        }
-        catch (err) {
-            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_CollectionGrowthMonitor] poll failed (non-fatal):', err);
-        }
-    }
-    /** Raise one alert to the Errors-sink, gated by the per-(collection,kind) cooldown to avoid flooding. */
-    emitAlert(alert, nowMs) {
-        const key = `${alert.dataName}:${alert.kind}`;
-        const lastAt = this.lastAlertAtByKey.get(key);
-        if (lastAt !== undefined && nowMs - lastAt < this.reAlertCooldownMs) {
-            return;
-        }
-        this.lastAlertAtByKey.set(key, nowMs);
-        fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_CollectionGrowthMonitor] ${alert.message}`);
-        global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
-            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-CGM-${alert.kind === 'size' ? 'SIZE' : 'GROWTH'}`,
-            message: alert.message,
-            level: fsm_dynamo_1.DyFM_ErrorLevel.warning,
-            additionalContent: alert.detail,
-        }));
-    }
-    /** Test-only teardown: stop the timer + clear state so specs don't leak between runs. */
-    _teardownForTesting() {
-        if (this.timer) {
-            clearInterval(this.timer);
-            this.timer = null;
-        }
-        this.installed = false;
-        this.lastSnapshotByCollection.clear();
-        this.lastAlertAtByKey.clear();
-    }
-}
-exports.DyNTS_CollectionGrowthMonitor = DyNTS_CollectionGrowthMonitor;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_CollectionGrowthMonitor = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const singleton_service_base_1 = require("../base/singleton.service-base");
+const global_service_1 = require("./global.service");
+class DyNTS_CollectionGrowthMonitor extends singleton_service_base_1.DyNTS_SingletonServiceBase {
+    static getInstance() {
+        return DyNTS_CollectionGrowthMonitor.getSingletonInstance();
+    }
+    timer = null;
+    installed = false;
+    // Resolved (effective) config — filled at install().
+    pollIntervalMs = 300000;
+    sizeThresholdDocCount = 250000;
+    growthRateThresholdPct = 50;
+    reAlertCooldownMs = 3600000;
+    lastSnapshotByCollection = new Map();
+    /** Last time we alerted, keyed by `${dataName}:${kind}` — for the anti-flood cooldown. */
+    lastAlertAtByKey = new Map();
+    constructor() {
+        super();
+    }
+    /**
+     * Start the monitor. Idempotent (a second call is a no-op). `config` overrides
+     * `DyNTS_global_settings.collectionGrowthMonitor`, which overrides the built-in defaults. NEVER
+     * throws — every error is try/catch-ed and descriptively logged.
+     */
+    install(config) {
+        if (this.installed) {
+            return;
+        }
+        try {
+            const g = global_settings_const_1.DyNTS_global_settings.collectionGrowthMonitor ?? { enabled: true };
+            if (!(config?.enabled ?? g.enabled ?? true)) {
+                return;
+            }
+            this.pollIntervalMs = config?.pollIntervalMs ?? g.pollIntervalMs ?? 300000;
+            this.sizeThresholdDocCount = config?.sizeThresholdDocCount ?? g.sizeThresholdDocCount ?? 250000;
+            this.growthRateThresholdPct = config?.growthRateThresholdPct ?? g.growthRateThresholdPct ?? 50;
+            this.reAlertCooldownMs = config?.reAlertCooldownMs ?? g.reAlertCooldownMs ?? 3600000;
+            this.installed = true;
+            this.timer = setInterval(() => { void this.poll(); }, this.pollIntervalMs);
+            if (typeof this.timer.unref === 'function') {
+                this.timer.unref();
+            }
+            fsm_dynamo_1.DyFM_Log.info(`[DyNTS_CollectionGrowthMonitor] installed — poll ${Math.round(this.pollIntervalMs / 1000)}s, ` +
+                `size-threshold ${this.sizeThresholdDocCount} docs, growth-rate ${this.growthRateThresholdPct}%/poll`);
+        }
+        catch (err) {
+            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_CollectionGrowthMonitor] install failed (non-fatal):', err);
+        }
+    }
+    /**
+     * Pure decision core (unit-tested): given a fresh count + the previous snapshot, return the alerts
+     * to raise. NEVER does I/O. A `size` alert fires when `count > sizeThreshold`; a `growth` alert
+     * fires when the collection grew by more than `growthRatePct` since the last snapshot (needs a
+     * non-zero previous count).
+     */
+    static evaluateGrowth(dataName, count, last, sizeThreshold, growthRatePct, retentionTtlSec) {
+        const alerts = [];
+        if (count > sizeThreshold) {
+            // FR-311 — RETENTION-TUDATOS tanacs. A korabbi uzenet FELTETEL NELKUL azt ajanlotta, hogy
+            // "declare `retention`" — akkor is, ha a modell MAR deklaralt egyet. Elesben (2026-08-19,
+            // overseer `ov_secret_audit`, 253 617 dokumentum) ez oda vezetett, hogy az operator olyat
+            // kapott feladatul, ami mar KESZ volt, orankent ujra, az error-tarba is elmentve. A ket eset
+            // KULONBOZO teendot kiván, ezert kulon is kell mondani oket.
+            const retentionDays = retentionTtlSec === undefined
+                ? null
+                : Math.round(retentionTtlSec / 86400);
+            alerts.push({
+                kind: 'size',
+                dataName: dataName,
+                message: retentionDays === null
+                    ? `Collection "${dataName}" has ${count} documents (> ${sizeThreshold} threshold) — ` +
+                        `unbounded-growth risk. Consider declaring \`retention\` on this model (FR-258 / SR-1).`
+                    : `Collection "${dataName}" has ${count} documents (> ${sizeThreshold} threshold) DESPITE a ` +
+                        `declared retention of ~${retentionDays} day(s) — the window is too long, or growth outpaces ` +
+                        `the TTL. Shorten \`retention\` or reduce the write-rate (FR-258 / SR-1).`,
+                detail: {
+                    collection: dataName, docCount: count, threshold: sizeThreshold,
+                    retentionDays: retentionDays,
+                },
+            });
+        }
+        if (last && last.docCount > 0) {
+            const growthPct = ((count - last.docCount) / last.docCount) * 100;
+            if (growthPct > growthRatePct) {
+                alerts.push({
+                    kind: 'growth',
+                    dataName: dataName,
+                    message: `Collection "${dataName}" grew ${Math.round(growthPct)}% since the last poll ` +
+                        `(${last.docCount} → ${count} docs) — fast unbounded growth.`,
+                    detail: { collection: dataName, oldCount: last.docCount, newCount: count, growthPct: Math.round(growthPct) },
+                });
+            }
+        }
+        return alerts;
+    }
+    /**
+     * One poll cycle: sample every registered collection's `estimatedDocumentCount()` (scan-free) and
+     * raise cooldown-gated warnings. Fully non-fatal — a failure on one collection never aborts the rest.
+     */
+    async poll() {
+        try {
+            const services = global_service_1.DyNTS_GlobalService.getAllDBServices();
+            const nowMs = Date.now();
+            for (const service of services) {
+                const dataName = service?.dataParams?.dataName;
+                const model = service?.dataModel;
+                if (!dataName || !model || typeof model.estimatedDocumentCount !== 'function') {
+                    continue;
+                }
+                try {
+                    const count = await model.estimatedDocumentCount();
+                    const last = this.lastSnapshotByCollection.get(dataName);
+                    // FR-311 — a modell SAJAT retention-deklaraciojat visszük be a dontesbe. A feloldas az
+                    // fsm-dynamo SSOT-resolvereval megy (`ttlSeconds` > `retentionDays`, ervenytelen ertek
+                    // elutasitva) — NEM ujraimplementalva, kulonben ketfele igazsag lenne rola.
+                    const retentionTtlSec = (0, fsm_dynamo_1.DyFM_resolveRetentionTtlSeconds)(service?.dataParams?.retention);
+                    const alerts = DyNTS_CollectionGrowthMonitor.evaluateGrowth(dataName, count, last, this.sizeThresholdDocCount, this.growthRateThresholdPct, retentionTtlSec);
+                    for (const alert of alerts) {
+                        this.emitAlert(alert, nowMs);
+                    }
+                    this.lastSnapshotByCollection.set(dataName, { docCount: count, atMs: nowMs });
+                }
+                catch (collErr) {
+                    fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_CollectionGrowthMonitor] poll for "${dataName}" failed (non-fatal): ` +
+                        `${collErr instanceof Error ? collErr.message : String(collErr)}`);
+                }
+            }
+        }
+        catch (err) {
+            fsm_dynamo_1.DyFM_Log.warn('[DyNTS_CollectionGrowthMonitor] poll failed (non-fatal):', err);
+        }
+    }
+    /** Raise one alert to the Errors-sink, gated by the per-(collection,kind) cooldown to avoid flooding. */
+    emitAlert(alert, nowMs) {
+        const key = `${alert.dataName}:${alert.kind}`;
+        const lastAt = this.lastAlertAtByKey.get(key);
+        if (lastAt !== undefined && nowMs - lastAt < this.reAlertCooldownMs) {
+            return;
+        }
+        this.lastAlertAtByKey.set(key, nowMs);
+        fsm_dynamo_1.DyFM_Log.warn(`[DyNTS_CollectionGrowthMonitor] ${alert.message}`);
+        global_service_1.DyNTS_GlobalService.globalErrorHandler?.(new fsm_dynamo_1.DyFM_Error({
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName ?? 'DyNTS'}|DyNTS-CGM-${alert.kind === 'size' ? 'SIZE' : 'GROWTH'}`,
+            message: alert.message,
+            level: fsm_dynamo_1.DyFM_ErrorLevel.warning,
+            additionalContent: alert.detail,
+        }));
+    }
+    /** Test-only teardown: stop the timer + clear state so specs don't leak between runs. */
+    _teardownForTesting() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.installed = false;
+        this.lastSnapshotByCollection.clear();
+        this.lastAlertAtByKey.clear();
+    }
+}
+exports.DyNTS_CollectionGrowthMonitor = DyNTS_CollectionGrowthMonitor;
 //# sourceMappingURL=collection-growth-monitor.service.js.map

package/build/_services/core/db-stats.service.d.ts

@@ -1,34 +1,34 @@
-import * as mongoose from 'mongoose';
-/**
- * BFR-OVERSEER-004 — stats-only DB-diagnosztika (NO direct data read).
- *
- * Per-collection rekordszám + adat-méret + index-méret (a `$collStats` aggregation-stage-en át —
- * metaadat-olvasás, SOHA nem dokumentum-tartalom) + összesített DB-méret. A 2026-06-23 overseer-incidens
- * (3 GB-ra hízott archív-collection, csak kézi mongosh-sal látszott) proaktív early-warningja: minden
- * NTS-szerver default megkapja a `/server/db-stats` endpointon (app-auth-tal gate-elhető).
- */
-export interface DyNTS_CollectionStats {
-    name: string;
-    documentCount: number;
-    sizeMB: number;
-    indexSizeMB: number;
-}
-export interface DyNTS_DbStats {
-    dbName: string;
-    collections: DyNTS_CollectionStats[];
-    totalSizeMB: number;
-    totalIndexSizeMB: number;
-    totalDocumentCount: number;
-    /** A gyűjtés közben elhasalt collection-ök (never-silent — a kihagyás látható). */
-    failedCollections: string[];
-}
-export declare class DyNTS_DbStats_Util {
-    /**
-     * A teljes stats-only pillanatkép. Hibatűrő: egy-egy collection statjának elhasalása NEM
-     * borítja a többit (failedCollections-be kerül, warn-nal — no-silent-skip).
-     */
-    static collect(connection: mongoose.Connection): Promise<DyNTS_DbStats>;
-    static toMB(bytes: number): number;
-    static round2(value: number): number;
-}
+import * as mongoose from 'mongoose';
+/**
+ * BFR-OVERSEER-004 — stats-only DB-diagnosztika (NO direct data read).
+ *
+ * Per-collection rekordszám + adat-méret + index-méret (a `$collStats` aggregation-stage-en át —
+ * metaadat-olvasás, SOHA nem dokumentum-tartalom) + összesített DB-méret. A 2026-06-23 overseer-incidens
+ * (3 GB-ra hízott archív-collection, csak kézi mongosh-sal látszott) proaktív early-warningja: minden
+ * NTS-szerver default megkapja a `/server/db-stats` endpointon (app-auth-tal gate-elhető).
+ */
+export interface DyNTS_CollectionStats {
+    name: string;
+    documentCount: number;
+    sizeMB: number;
+    indexSizeMB: number;
+}
+export interface DyNTS_DbStats {
+    dbName: string;
+    collections: DyNTS_CollectionStats[];
+    totalSizeMB: number;
+    totalIndexSizeMB: number;
+    totalDocumentCount: number;
+    /** A gyűjtés közben elhasalt collection-ök (never-silent — a kihagyás látható). */
+    failedCollections: string[];
+}
+export declare class DyNTS_DbStats_Util {
+    /**
+     * A teljes stats-only pillanatkép. Hibatűrő: egy-egy collection statjának elhasalása NEM
+     * borítja a többit (failedCollections-be kerül, warn-nal — no-silent-skip).
+     */
+    static collect(connection: mongoose.Connection): Promise<DyNTS_DbStats>;
+    static toMB(bytes: number): number;
+    static round2(value: number): number;
+}
 //# sourceMappingURL=db-stats.service.d.ts.map

package/build/_services/core/db-stats.service.js

@@ -1,65 +1,65 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_DbStats_Util = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const BYTES_PER_MB = 1024 * 1024;
-class DyNTS_DbStats_Util {
-    /**
-     * A teljes stats-only pillanatkép. Hibatűrő: egy-egy collection statjának elhasalása NEM
-     * borítja a többit (failedCollections-be kerül, warn-nal — no-silent-skip).
-     */
-    static async collect(connection) {
-        const db = connection?.db;
-        if (!db) {
-            return {
-                dbName: connection?.name ?? '-no-connection-',
-                collections: [],
-                totalSizeMB: 0,
-                totalIndexSizeMB: 0,
-                totalDocumentCount: 0,
-                failedCollections: [],
-            };
-        }
-        const collectionInfos = await db.listCollections({}, { nameOnly: true }).toArray();
-        const collections = [];
-        const failedCollections = [];
-        for (const info of collectionInfos) {
-            try {
-                // $collStats storageStats: metaadat-only (size/count/totalIndexSize) — nincs dokumentum-olvasás.
-                const statsCursor = db.collection(info.name).aggregate([
-                    { $collStats: { storageStats: {} } },
-                ]);
-                const statsDocs = await statsCursor.toArray();
-                const storage = (statsDocs[0]?.['storageStats'] ?? {});
-                collections.push({
-                    name: info.name,
-                    documentCount: Number(storage['count'] ?? 0),
-                    sizeMB: DyNTS_DbStats_Util.toMB(Number(storage['size'] ?? 0)),
-                    indexSizeMB: DyNTS_DbStats_Util.toMB(Number(storage['totalIndexSize'] ?? 0)),
-                });
-            }
-            catch (error) {
-                failedCollections.push(info.name);
-                fsm_dynamo_1.DyFM_Log.warn(`(DyNTS_DbStats) collStats failed for "${info.name}" (non-fatal)`, error);
-            }
-        }
-        // Méret szerint csökkenő — a bloat-gyanús collection legyen elöl.
-        collections.sort((a, b) => b.sizeMB - a.sizeMB);
-        return {
-            dbName: connection.name,
-            collections: collections,
-            totalSizeMB: DyNTS_DbStats_Util.round2(collections.reduce((sum, c) => sum + c.sizeMB, 0)),
-            totalIndexSizeMB: DyNTS_DbStats_Util.round2(collections.reduce((sum, c) => sum + c.indexSizeMB, 0)),
-            totalDocumentCount: collections.reduce((sum, c) => sum + c.documentCount, 0),
-            failedCollections: failedCollections,
-        };
-    }
-    static toMB(bytes) {
-        return DyNTS_DbStats_Util.round2(bytes / BYTES_PER_MB);
-    }
-    static round2(value) {
-        return Math.round(value * 100) / 100;
-    }
-}
-exports.DyNTS_DbStats_Util = DyNTS_DbStats_Util;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_DbStats_Util = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const BYTES_PER_MB = 1024 * 1024;
+class DyNTS_DbStats_Util {
+    /**
+     * A teljes stats-only pillanatkép. Hibatűrő: egy-egy collection statjának elhasalása NEM
+     * borítja a többit (failedCollections-be kerül, warn-nal — no-silent-skip).
+     */
+    static async collect(connection) {
+        const db = connection?.db;
+        if (!db) {
+            return {
+                dbName: connection?.name ?? '-no-connection-',
+                collections: [],
+                totalSizeMB: 0,
+                totalIndexSizeMB: 0,
+                totalDocumentCount: 0,
+                failedCollections: [],
+            };
+        }
+        const collectionInfos = await db.listCollections({}, { nameOnly: true }).toArray();
+        const collections = [];
+        const failedCollections = [];
+        for (const info of collectionInfos) {
+            try {
+                // $collStats storageStats: metaadat-only (size/count/totalIndexSize) — nincs dokumentum-olvasás.
+                const statsCursor = db.collection(info.name).aggregate([
+                    { $collStats: { storageStats: {} } },
+                ]);
+                const statsDocs = await statsCursor.toArray();
+                const storage = (statsDocs[0]?.['storageStats'] ?? {});
+                collections.push({
+                    name: info.name,
+                    documentCount: Number(storage['count'] ?? 0),
+                    sizeMB: DyNTS_DbStats_Util.toMB(Number(storage['size'] ?? 0)),
+                    indexSizeMB: DyNTS_DbStats_Util.toMB(Number(storage['totalIndexSize'] ?? 0)),
+                });
+            }
+            catch (error) {
+                failedCollections.push(info.name);
+                fsm_dynamo_1.DyFM_Log.warn(`(DyNTS_DbStats) collStats failed for "${info.name}" (non-fatal)`, error);
+            }
+        }
+        // Méret szerint csökkenő — a bloat-gyanús collection legyen elöl.
+        collections.sort((a, b) => b.sizeMB - a.sizeMB);
+        return {
+            dbName: connection.name,
+            collections: collections,
+            totalSizeMB: DyNTS_DbStats_Util.round2(collections.reduce((sum, c) => sum + c.sizeMB, 0)),
+            totalIndexSizeMB: DyNTS_DbStats_Util.round2(collections.reduce((sum, c) => sum + c.indexSizeMB, 0)),
+            totalDocumentCount: collections.reduce((sum, c) => sum + c.documentCount, 0),
+            failedCollections: failedCollections,
+        };
+    }
+    static toMB(bytes) {
+        return DyNTS_DbStats_Util.round2(bytes / BYTES_PER_MB);
+    }
+    static round2(value) {
+        return Math.round(value * 100) / 100;
+    }
+}
+exports.DyNTS_DbStats_Util = DyNTS_DbStats_Util;
 //# sourceMappingURL=db-stats.service.js.map

package/build/_services/core/diagnostics.service.d.ts

@@ -1,43 +1,43 @@
-import * as mongoose from 'mongoose';
-/**
- * BFR-AM-015 (+ BFR-OVERSEER-004 aggregátor-fele) — generikus, újrahasználható diagnosztikai
- * aggregátor MINDEN `DyNTS_App`-hoz: a `GET /server/doctor` endpoint forrása.
- *
- * Check-ek (mind SAJÁT try-ban — egy elhasaló check nem borítja a doctort, néma hiba TILOS):
- *  - mongo: kapcsolat + ping (readiness-minta);
- *  - memory: MemoryGuard pressure-snapshot;
- *  - eventLoop: EventLoopDiag snapshot;
- *  - dbStats: stats-only collection-méretek + küszöb-warn a bloat-gyanúra.
- * Az app APP-SPECIFIKUS check-eket regisztrálhat (`registerCheck`) — pl. env-validáció,
- * provider-probe (a FAM `FAM_Doctor` mintája bedrock-magként).
- */
-export interface DyNTS_DoctorCheck {
-    name: string;
-    health: 'ok' | 'warn' | 'fail';
-    detail?: unknown;
-    /** Mit tegyen az operátor, ha nem ok (néma hiba tilos — a hint kötelező nem-ok esetén). */
-    fixHint?: string;
-}
-export interface DyNTS_DoctorReport {
-    health: 'ok' | 'warn' | 'fail';
-    checks: DyNTS_DoctorCheck[];
-    summary: string;
-    uptimeSec: number;
-}
-/** App-specifikus check-függvény (a doctor futtatja, saját try-ban). */
-export type DyNTS_DoctorCheckFn = () => Promise<DyNTS_DoctorCheck>;
-export declare class DyNTS_Diagnostics {
-    private static readonly customChecks;
-    /** App-specifikus check regisztrálása (pl. env-validáció, provider-probe). */
-    static registerCheck(check: DyNTS_DoctorCheckFn): void;
-    /** A teljes doctor-riport. SOSEM dob — a hibás check `fail`-ként jelenik meg. */
-    static runDoctor(set: {
-        connection: mongoose.Connection;
-        collectionWarnMB?: number;
-    }): Promise<DyNTS_DoctorReport>;
-    /** Aggregált health: bármely fail → fail; különben bármely warn → warn; különben ok. Pure (unit-tesztelt). */
-    static interpretHealth(checks: DyNTS_DoctorCheck[]): 'ok' | 'warn' | 'fail';
-    /** Ember-olvasható összegzés a nem-ok check-ekből. Pure (unit-tesztelt). */
-    static buildSummary(checks: DyNTS_DoctorCheck[]): string;
-}
+import * as mongoose from 'mongoose';
+/**
+ * BFR-AM-015 (+ BFR-OVERSEER-004 aggregátor-fele) — generikus, újrahasználható diagnosztikai
+ * aggregátor MINDEN `DyNTS_App`-hoz: a `GET /server/doctor` endpoint forrása.
+ *
+ * Check-ek (mind SAJÁT try-ban — egy elhasaló check nem borítja a doctort, néma hiba TILOS):
+ *  - mongo: kapcsolat + ping (readiness-minta);
+ *  - memory: MemoryGuard pressure-snapshot;
+ *  - eventLoop: EventLoopDiag snapshot;
+ *  - dbStats: stats-only collection-méretek + küszöb-warn a bloat-gyanúra.
+ * Az app APP-SPECIFIKUS check-eket regisztrálhat (`registerCheck`) — pl. env-validáció,
+ * provider-probe (a FAM `FAM_Doctor` mintája bedrock-magként).
+ */
+export interface DyNTS_DoctorCheck {
+    name: string;
+    health: 'ok' | 'warn' | 'fail';
+    detail?: unknown;
+    /** Mit tegyen az operátor, ha nem ok (néma hiba tilos — a hint kötelező nem-ok esetén). */
+    fixHint?: string;
+}
+export interface DyNTS_DoctorReport {
+    health: 'ok' | 'warn' | 'fail';
+    checks: DyNTS_DoctorCheck[];
+    summary: string;
+    uptimeSec: number;
+}
+/** App-specifikus check-függvény (a doctor futtatja, saját try-ban). */
+export type DyNTS_DoctorCheckFn = () => Promise<DyNTS_DoctorCheck>;
+export declare class DyNTS_Diagnostics {
+    private static readonly customChecks;
+    /** App-specifikus check regisztrálása (pl. env-validáció, provider-probe). */
+    static registerCheck(check: DyNTS_DoctorCheckFn): void;
+    /** A teljes doctor-riport. SOSEM dob — a hibás check `fail`-ként jelenik meg. */
+    static runDoctor(set: {
+        connection: mongoose.Connection;
+        collectionWarnMB?: number;
+    }): Promise<DyNTS_DoctorReport>;
+    /** Aggregált health: bármely fail → fail; különben bármely warn → warn; különben ok. Pure (unit-tesztelt). */
+    static interpretHealth(checks: DyNTS_DoctorCheck[]): 'ok' | 'warn' | 'fail';
+    /** Ember-olvasható összegzés a nem-ok check-ekből. Pure (unit-tesztelt). */
+    static buildSummary(checks: DyNTS_DoctorCheck[]): string;
+}
 //# sourceMappingURL=diagnostics.service.d.ts.map