@futdevpro/nts-dynamo 1.15.64 → 1.15.68

package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.d.ts

@@ -1,84 +1,84 @@
-import { DyNTS_ScopedConfig_Level } from '../_enums/dynts-scoped-config-level.enum';
-import { DyNTS_ScopedConfig } from '../_models/data-models/dynts-scoped-config.data-model';
-import { DyNTS_ScopedConfigResolveContext, DyNTS_ScopedConfigResolvedValue, DyNTS_ScopedConfigResolveOptions, DyNTS_ScopedConfigSetOptions, DyNTS_ScopedConfigValue } from '../_models/interfaces/dynts-scoped-config.interface';
-/**
- * `DyNTS_ScopedConfig_ControlService` — a DB-backed, scoped config GENERIKUS feloldó-engine (BFR-AM-004).
- *
- * Singleton. Domain-agnosztikus: NINCS beépített kulcs-katalógus / default — a katalógus a FOGYASZTÓ
- * dolga (a FAM `FAM_Config_ControlService` ennek vékony fogyasztója lesz). A bedrock CSAK a generikus
- * precedencia-engine + a tárolás + a rövid-TTL cache.
- *
- * **Precedencia (a legspecifikusabb nyer):** `scope (leaf→root, a legmélyebb találat) > table > global
- * > builtinDefault` (utóbbi a hívó által átadott fallback). A `resolve(key, opts)` egy kulcsot old fel;
- * a `resolveAll(ctx)` az összes konfigurált kulcsot egy Mongo-körrel; a `set(level, key, value, opts)`
- * archive-old-active + új aktív rekord + cache-invalidálás.
- *
- * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** NEM tartunk élő `DyNTS_ScopedConfig_DataService`
- * mezőt (eager DB-resolve a base-ctor-ban) — minden DB-művelet előtt lazy `new ...DataService`.
- */
-export declare class DyNTS_ScopedConfig_ControlService {
-    private static _instance;
-    /** Default issuer a config-műveletekhez. */
-    private readonly issuer;
-    /** Rövid-TTL memória-cache (kulcs: kontextus-szelet; `set` invalidálja). */
-    private cache;
-    /** A cache TTL ms-ben (~5s; rövid, hogy a hot-path olcsó legyen, de a `set` után friss). */
-    private cacheTtlMs;
-    static getInstance(): DyNTS_ScopedConfig_ControlService;
-    /**
-     * Egy kulcs feloldása a legspecifikusabb beállított értékre. A precedencia:
-     * (1) SCOPE szint a `scopePath` LEVÉBŐL a gyökér felé (az első/legmélyebb találat nyer),
-     * (2) TABLE szint, (3) GLOBAL szint, (4) a hívó által átadott `builtinDefault` (ha van).
-     *
-     * A `scopePath` canonical formában érkezik (a fogyasztó read/write-path-ja oldotta fel).
-     */
-    resolve<T = DyNTS_ScopedConfigValue>(key: string, options?: DyNTS_ScopedConfigResolveOptions<T>): Promise<DyNTS_ScopedConfigResolvedValue<T>>;
-    /**
-     * A teljes effektív config egy adott kontextusra (batch). EGY Mongo-kör (cache-elt), majd memóriában
-     * merge: minden KONFIGURÁLT kulcsra a feloldott érték + forrás-szint. A hot-path (read/write) ezt
-     * használja, nem per-key kört. A builtin-only kulcsok NEM jelennek meg (nincs katalógus a bedrock-ban
-     * — azokat a fogyasztó iterálja a saját katalógusából a `resolve`-on át).
-     */
-    resolveAll(context?: DyNTS_ScopedConfigResolveContext): Promise<{
-        [key: string]: DyNTS_ScopedConfigResolvedValue;
-    }>;
-    /**
-     * A `resolve` mag (memóriában, a betöltött rekord-halmazon). Külön metódus, hogy a `resolveAll` is
-     * ezt használja (egyetlen Mongo-kör után minden kulcsra). A `builtinDefault` a hívó fallback-je.
-     */
-    private resolveFromRecords;
-    /** Egy DB-rekordot a feloldott-érték shape-re (a forrás-szinttel + audittal). */
-    private toResolved;
-    /**
-     * A kontextusra releváns aktív rekordok betöltése EGY Mongo-körrel, cache-elve. A filter a global +
-     * (ha van) table + a scopePath összes scopeId-jára szűkít — a merge memóriában fut. `set` invalidál.
-     */
-    private loadEffectiveRecords;
-    /** A cache-kulcs egy kontextus-szeletre (table + a scopePath scopeId-lánca). */
-    private cacheKey;
-    /** A teljes cache invalidálása (`set` után). */
-    invalidateCache(): void;
-    /** A cache TTL felülírása (ms); a fogyasztó hangolhatja (pl. a saját `reference.cacheTtlMs`-éből). */
-    setCacheTtlMs(ttlMs: number): void;
-    /**
-     * Egy config-érték beállítása egy adott szinten (BFR-AM-004). A `set`:
-     * (1) az ugyanazon `(level,tableScope,scopeId,key)` kulcson lévő AKTÍV régi rekordot soft-delete-eli
-     *     (archív → history), (2) az új aktív rekordot kiírja (a `value` Mixed), (3) invalidálja a cache-t.
-     *
-     * **Domain-agnosztikus:** NINCS típus-/tartomány-validáció (az a fogyasztó katalógusának dolga); a
-     * bedrock csak a feloldási-kulcs konzisztenciáját biztosítja (table-/scope-szinten a megfelelő
-     * scope-azonosító jelenléte kötelező).
-     */
-    set(level: DyNTS_ScopedConfig_Level, key: string, value: unknown, options?: DyNTS_ScopedConfigSetOptions): Promise<DyNTS_ScopedConfig>;
-    /**
-     * A feloldási-kulcs minimál-konzisztenciája (NEM domain-validáció): table-/scope-szinten kötelező a
-     * `tableScope`, scope-szinten a `scopeId`. Ezek nélkül a feloldási-kulcs értelmetlen lenne.
-     */
-    private assertLevelConsistency;
-    /**
-     * Egy feloldási-kulcs felülírás-historyja: a soft-delete-elt (archív) régi rekordok az archív
-     * collection-ből. Audit-trail / rollback-alap. (A FOGYASZTÓ presetjei/auditja erre épülhetnek.)
-     */
-    getHistory(level: DyNTS_ScopedConfig_Level, key: string, options?: DyNTS_ScopedConfigSetOptions): Promise<DyNTS_ScopedConfig[]>;
-}
+import { DyNTS_ScopedConfig_Level } from '../_enums/dynts-scoped-config-level.enum';
+import { DyNTS_ScopedConfig } from '../_models/data-models/dynts-scoped-config.data-model';
+import { DyNTS_ScopedConfigResolveContext, DyNTS_ScopedConfigResolvedValue, DyNTS_ScopedConfigResolveOptions, DyNTS_ScopedConfigSetOptions, DyNTS_ScopedConfigValue } from '../_models/interfaces/dynts-scoped-config.interface';
+/**
+ * `DyNTS_ScopedConfig_ControlService` — a DB-backed, scoped config GENERIKUS feloldó-engine (BFR-AM-004).
+ *
+ * Singleton. Domain-agnosztikus: NINCS beépített kulcs-katalógus / default — a katalógus a FOGYASZTÓ
+ * dolga (a FAM `FAM_Config_ControlService` ennek vékony fogyasztója lesz). A bedrock CSAK a generikus
+ * precedencia-engine + a tárolás + a rövid-TTL cache.
+ *
+ * **Precedencia (a legspecifikusabb nyer):** `scope (leaf→root, a legmélyebb találat) > table > global
+ * > builtinDefault` (utóbbi a hívó által átadott fallback). A `resolve(key, opts)` egy kulcsot old fel;
+ * a `resolveAll(ctx)` az összes konfigurált kulcsot egy Mongo-körrel; a `set(level, key, value, opts)`
+ * archive-old-active + új aktív rekord + cache-invalidálás.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** NEM tartunk élő `DyNTS_ScopedConfig_DataService`
+ * mezőt (eager DB-resolve a base-ctor-ban) — minden DB-művelet előtt lazy `new ...DataService`.
+ */
+export declare class DyNTS_ScopedConfig_ControlService {
+    private static _instance;
+    /** Default issuer a config-műveletekhez. */
+    private readonly issuer;
+    /** Rövid-TTL memória-cache (kulcs: kontextus-szelet; `set` invalidálja). */
+    private cache;
+    /** A cache TTL ms-ben (~5s; rövid, hogy a hot-path olcsó legyen, de a `set` után friss). */
+    private cacheTtlMs;
+    static getInstance(): DyNTS_ScopedConfig_ControlService;
+    /**
+     * Egy kulcs feloldása a legspecifikusabb beállított értékre. A precedencia:
+     * (1) SCOPE szint a `scopePath` LEVÉBŐL a gyökér felé (az első/legmélyebb találat nyer),
+     * (2) TABLE szint, (3) GLOBAL szint, (4) a hívó által átadott `builtinDefault` (ha van).
+     *
+     * A `scopePath` canonical formában érkezik (a fogyasztó read/write-path-ja oldotta fel).
+     */
+    resolve<T = DyNTS_ScopedConfigValue>(key: string, options?: DyNTS_ScopedConfigResolveOptions<T>): Promise<DyNTS_ScopedConfigResolvedValue<T>>;
+    /**
+     * A teljes effektív config egy adott kontextusra (batch). EGY Mongo-kör (cache-elt), majd memóriában
+     * merge: minden KONFIGURÁLT kulcsra a feloldott érték + forrás-szint. A hot-path (read/write) ezt
+     * használja, nem per-key kört. A builtin-only kulcsok NEM jelennek meg (nincs katalógus a bedrock-ban
+     * — azokat a fogyasztó iterálja a saját katalógusából a `resolve`-on át).
+     */
+    resolveAll(context?: DyNTS_ScopedConfigResolveContext): Promise<{
+        [key: string]: DyNTS_ScopedConfigResolvedValue;
+    }>;
+    /**
+     * A `resolve` mag (memóriában, a betöltött rekord-halmazon). Külön metódus, hogy a `resolveAll` is
+     * ezt használja (egyetlen Mongo-kör után minden kulcsra). A `builtinDefault` a hívó fallback-je.
+     */
+    private resolveFromRecords;
+    /** Egy DB-rekordot a feloldott-érték shape-re (a forrás-szinttel + audittal). */
+    private toResolved;
+    /**
+     * A kontextusra releváns aktív rekordok betöltése EGY Mongo-körrel, cache-elve. A filter a global +
+     * (ha van) table + a scopePath összes scopeId-jára szűkít — a merge memóriában fut. `set` invalidál.
+     */
+    private loadEffectiveRecords;
+    /** A cache-kulcs egy kontextus-szeletre (table + a scopePath scopeId-lánca). */
+    private cacheKey;
+    /** A teljes cache invalidálása (`set` után). */
+    invalidateCache(): void;
+    /** A cache TTL felülírása (ms); a fogyasztó hangolhatja (pl. a saját `reference.cacheTtlMs`-éből). */
+    setCacheTtlMs(ttlMs: number): void;
+    /**
+     * Egy config-érték beállítása egy adott szinten (BFR-AM-004). A `set`:
+     * (1) az ugyanazon `(level,tableScope,scopeId,key)` kulcson lévő AKTÍV régi rekordot soft-delete-eli
+     *     (archív → history), (2) az új aktív rekordot kiírja (a `value` Mixed), (3) invalidálja a cache-t.
+     *
+     * **Domain-agnosztikus:** NINCS típus-/tartomány-validáció (az a fogyasztó katalógusának dolga); a
+     * bedrock csak a feloldási-kulcs konzisztenciáját biztosítja (table-/scope-szinten a megfelelő
+     * scope-azonosító jelenléte kötelező).
+     */
+    set(level: DyNTS_ScopedConfig_Level, key: string, value: unknown, options?: DyNTS_ScopedConfigSetOptions): Promise<DyNTS_ScopedConfig>;
+    /**
+     * A feloldási-kulcs minimál-konzisztenciája (NEM domain-validáció): table-/scope-szinten kötelező a
+     * `tableScope`, scope-szinten a `scopeId`. Ezek nélkül a feloldási-kulcs értelmetlen lenne.
+     */
+    private assertLevelConsistency;
+    /**
+     * Egy feloldási-kulcs felülírás-historyja: a soft-delete-elt (archív) régi rekordok az archív
+     * collection-ből. Audit-trail / rollback-alap. (A FOGYASZTÓ presetjei/auditja erre épülhetnek.)
+     */
+    getHistory(level: DyNTS_ScopedConfig_Level, key: string, options?: DyNTS_ScopedConfigSetOptions): Promise<DyNTS_ScopedConfig[]>;
+}
 //# sourceMappingURL=dynts-scoped-config.control-service.d.ts.map

package/build/_modules/scoped-config/_services/dynts-scoped-config.control-service.js

@@ -1,220 +1,220 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_ScopedConfig_ControlService = void 0;
-const dynts_scoped_config_level_enum_1 = require("../_enums/dynts-scoped-config-level.enum");
-const dynts_scoped_config_data_model_1 = require("../_models/data-models/dynts-scoped-config.data-model");
-const dynts_scoped_config_data_service_1 = require("./dynts-scoped-config.data-service");
-/**
- * `DyNTS_ScopedConfig_ControlService` — a DB-backed, scoped config GENERIKUS feloldó-engine (BFR-AM-004).
- *
- * Singleton. Domain-agnosztikus: NINCS beépített kulcs-katalógus / default — a katalógus a FOGYASZTÓ
- * dolga (a FAM `FAM_Config_ControlService` ennek vékony fogyasztója lesz). A bedrock CSAK a generikus
- * precedencia-engine + a tárolás + a rövid-TTL cache.
- *
- * **Precedencia (a legspecifikusabb nyer):** `scope (leaf→root, a legmélyebb találat) > table > global
- * > builtinDefault` (utóbbi a hívó által átadott fallback). A `resolve(key, opts)` egy kulcsot old fel;
- * a `resolveAll(ctx)` az összes konfigurált kulcsot egy Mongo-körrel; a `set(level, key, value, opts)`
- * archive-old-active + új aktív rekord + cache-invalidálás.
- *
- * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** NEM tartunk élő `DyNTS_ScopedConfig_DataService`
- * mezőt (eager DB-resolve a base-ctor-ban) — minden DB-művelet előtt lazy `new ...DataService`.
- */
-class DyNTS_ScopedConfig_ControlService {
-    static _instance;
-    /** Default issuer a config-műveletekhez. */
-    issuer = 'DyNTS_ScopedConfig_ControlService';
-    /** Rövid-TTL memória-cache (kulcs: kontextus-szelet; `set` invalidálja). */
-    cache = new Map();
-    /** A cache TTL ms-ben (~5s; rövid, hogy a hot-path olcsó legyen, de a `set` után friss). */
-    cacheTtlMs = 5000;
-    static getInstance() {
-        if (!DyNTS_ScopedConfig_ControlService._instance) {
-            DyNTS_ScopedConfig_ControlService._instance = new DyNTS_ScopedConfig_ControlService();
-        }
-        return DyNTS_ScopedConfig_ControlService._instance;
-    }
-    // =========================================================================
-    // RESOLVE — precedencia: scope (leaf→root) > table > global > builtinDefault
-    // =========================================================================
-    /**
-     * Egy kulcs feloldása a legspecifikusabb beállított értékre. A precedencia:
-     * (1) SCOPE szint a `scopePath` LEVÉBŐL a gyökér felé (az első/legmélyebb találat nyer),
-     * (2) TABLE szint, (3) GLOBAL szint, (4) a hívó által átadott `builtinDefault` (ha van).
-     *
-     * A `scopePath` canonical formában érkezik (a fogyasztó read/write-path-ja oldotta fel).
-     */
-    async resolve(key, options) {
-        const context = {
-            table: options?.table,
-            scopePath: options?.scopePath,
-        };
-        const records = await this.loadEffectiveRecords(context);
-        return this.resolveFromRecords(key, records, context, options?.builtinDefault);
-    }
-    /**
-     * A teljes effektív config egy adott kontextusra (batch). EGY Mongo-kör (cache-elt), majd memóriában
-     * merge: minden KONFIGURÁLT kulcsra a feloldott érték + forrás-szint. A hot-path (read/write) ezt
-     * használja, nem per-key kört. A builtin-only kulcsok NEM jelennek meg (nincs katalógus a bedrock-ban
-     * — azokat a fogyasztó iterálja a saját katalógusából a `resolve`-on át).
-     */
-    async resolveAll(context) {
-        const records = await this.loadEffectiveRecords(context);
-        const result = {};
-        const keys = new Set(records.map((record) => record.key));
-        for (const key of keys) {
-            result[key] = this.resolveFromRecords(key, records, context);
-        }
-        return result;
-    }
-    /**
-     * A `resolve` mag (memóriában, a betöltött rekord-halmazon). Külön metódus, hogy a `resolveAll` is
-     * ezt használja (egyetlen Mongo-kör után minden kulcsra). A `builtinDefault` a hívó fallback-je.
-     */
-    resolveFromRecords(key, records, context, builtinDefault) {
-        const table = context?.table;
-        const scopePath = context?.scopePath ?? [];
-        // 1. SCOPE szint — a scopePath levéből a gyökér felé (leaf→root); az első találat nyer.
-        if (table && scopePath.length) {
-            for (let i = scopePath.length - 1; i >= 0; i--) {
-                const scopeId = scopePath[i].scopeId;
-                const hit = records.find((record) => record.level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope &&
-                    record.tableScope === table &&
-                    record.scopeId === scopeId &&
-                    record.key === key);
-                if (hit) {
-                    return this.toResolved(hit, 'scope');
-                }
-            }
-        }
-        // 2. TABLE szint.
-        if (table) {
-            const hit = records.find((record) => record.level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.table &&
-                record.tableScope === table &&
-                record.key === key);
-            if (hit) {
-                return this.toResolved(hit, 'table');
-            }
-        }
-        // 3. GLOBAL szint.
-        const globalHit = records.find((record) => record.level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.global && record.key === key);
-        if (globalHit) {
-            return this.toResolved(globalHit, 'global');
-        }
-        // 4. builtinDefault (a hívó fallback-je; a bedrock NEM tart katalógust).
-        return {
-            value: builtinDefault,
-            resolvedFrom: 'builtin',
-        };
-    }
-    /** Egy DB-rekordot a feloldott-érték shape-re (a forrás-szinttel + audittal). */
-    toResolved(record, resolvedFrom) {
-        return {
-            value: record.value,
-            resolvedFrom: resolvedFrom,
-            scopeId: record.scopeId,
-            setBy: record.setBy,
-            setByDetail: record.setByDetail,
-        };
-    }
-    /**
-     * A kontextusra releváns aktív rekordok betöltése EGY Mongo-körrel, cache-elve. A filter a global +
-     * (ha van) table + a scopePath összes scopeId-jára szűkít — a merge memóriában fut. `set` invalidál.
-     */
-    async loadEffectiveRecords(context) {
-        const cacheKey = this.cacheKey(context);
-        const cached = this.cache.get(cacheKey);
-        if (cached && cached.expiresAt > Date.now()) {
-            return cached.records;
-        }
-        const orClauses = [{ level: dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.global }];
-        if (context?.table) {
-            orClauses.push({ level: dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.table, tableScope: context.table });
-            const scopeIds = (context.scopePath ?? []).map((ref) => ref.scopeId);
-            if (scopeIds.length) {
-                orClauses.push({ level: dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope, tableScope: context.table, scopeId: { $in: scopeIds } });
-            }
-        }
-        const dataService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ issuer: this.issuer });
-        const records = await dataService.findActiveList({ $or: orClauses });
-        this.cache.set(cacheKey, { records: records, expiresAt: Date.now() + this.cacheTtlMs });
-        return records;
-    }
-    /** A cache-kulcs egy kontextus-szeletre (table + a scopePath scopeId-lánca). */
-    cacheKey(context) {
-        const table = context?.table ?? '-';
-        const scopeIds = (context?.scopePath ?? []).map((ref) => ref.scopeId).join('>') || '-';
-        return `${table}|${scopeIds}`;
-    }
-    /** A teljes cache invalidálása (`set` után). */
-    invalidateCache() {
-        this.cache.clear();
-    }
-    /** A cache TTL felülírása (ms); a fogyasztó hangolhatja (pl. a saját `reference.cacheTtlMs`-éből). */
-    setCacheTtlMs(ttlMs) {
-        this.cacheTtlMs = ttlMs;
-    }
-    // =========================================================================
-    // SET — archive-old-active → write-new → invalidate cache
-    // =========================================================================
-    /**
-     * Egy config-érték beállítása egy adott szinten (BFR-AM-004). A `set`:
-     * (1) az ugyanazon `(level,tableScope,scopeId,key)` kulcson lévő AKTÍV régi rekordot soft-delete-eli
-     *     (archív → history), (2) az új aktív rekordot kiírja (a `value` Mixed), (3) invalidálja a cache-t.
-     *
-     * **Domain-agnosztikus:** NINCS típus-/tartomány-validáció (az a fogyasztó katalógusának dolga); a
-     * bedrock csak a feloldási-kulcs konzisztenciáját biztosítja (table-/scope-szinten a megfelelő
-     * scope-azonosító jelenléte kötelező).
-     */
-    async set(level, key, value, options = {}) {
-        this.assertLevelConsistency(level, key, options);
-        const issuer = options.issuer ?? this.issuer;
-        const filter = dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService.levelKeyFilter(level, key, options);
-        // Régi aktív rekord (ha van) → soft-delete (archív; history-megőrzés).
-        const findService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ issuer: issuer });
-        const existing = await findService.findActive(filter);
-        if (existing && existing._id) {
-            await findService.deleteData(existing._id);
-        }
-        // Új aktív rekord — a `value` Mixed.
-        const record = new dynts_scoped_config_data_model_1.DyNTS_ScopedConfig({
-            level: level,
-            tableScope: options.tableScope,
-            scopeId: options.scopeId,
-            key: key,
-            value: value,
-            setBy: options.setBy ?? 'system',
-            setByDetail: options.setByDetail,
-            note: options.note,
-        });
-        const writeService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ data: record, issuer: issuer });
-        const saved = await writeService.saveData(record);
-        this.invalidateCache();
-        return saved;
-    }
-    /**
-     * A feloldási-kulcs minimál-konzisztenciája (NEM domain-validáció): table-/scope-szinten kötelező a
-     * `tableScope`, scope-szinten a `scopeId`. Ezek nélkül a feloldási-kulcs értelmetlen lenne.
-     */
-    assertLevelConsistency(level, key, options) {
-        if ((level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.table || level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope) && !options.tableScope) {
-            throw new Error(`DyNTS_ScopedConfig: '${key}' '${level}' szintű beállításához kötelező a tableScope.`);
-        }
-        if (level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope && !options.scopeId) {
-            throw new Error(`DyNTS_ScopedConfig: '${key}' 'scope' szintű beállításához kötelező a scopeId.`);
-        }
-    }
-    // =========================================================================
-    // HISTORY — felülírás-history (soft-delete-elt régi rekordok)
-    // =========================================================================
-    /**
-     * Egy feloldási-kulcs felülírás-historyja: a soft-delete-elt (archív) régi rekordok az archív
-     * collection-ből. Audit-trail / rollback-alap. (A FOGYASZTÓ presetjei/auditja erre épülhetnek.)
-     */
-    async getHistory(level, key, options = {}) {
-        const filter = dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService.levelKeyFilter(level, key, options);
-        const dataService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ issuer: options.issuer ?? this.issuer });
-        return dataService.getArchiveDataService().findDataList(filter, true);
-    }
-}
-exports.DyNTS_ScopedConfig_ControlService = DyNTS_ScopedConfig_ControlService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ScopedConfig_ControlService = void 0;
+const dynts_scoped_config_level_enum_1 = require("../_enums/dynts-scoped-config-level.enum");
+const dynts_scoped_config_data_model_1 = require("../_models/data-models/dynts-scoped-config.data-model");
+const dynts_scoped_config_data_service_1 = require("./dynts-scoped-config.data-service");
+/**
+ * `DyNTS_ScopedConfig_ControlService` — a DB-backed, scoped config GENERIKUS feloldó-engine (BFR-AM-004).
+ *
+ * Singleton. Domain-agnosztikus: NINCS beépített kulcs-katalógus / default — a katalógus a FOGYASZTÓ
+ * dolga (a FAM `FAM_Config_ControlService` ennek vékony fogyasztója lesz). A bedrock CSAK a generikus
+ * precedencia-engine + a tárolás + a rövid-TTL cache.
+ *
+ * **Precedencia (a legspecifikusabb nyer):** `scope (leaf→root, a legmélyebb találat) > table > global
+ * > builtinDefault` (utóbbi a hívó által átadott fallback). A `resolve(key, opts)` egy kulcsot old fel;
+ * a `resolveAll(ctx)` az összes konfigurált kulcsot egy Mongo-körrel; a `set(level, key, value, opts)`
+ * archive-old-active + új aktív rekord + cache-invalidálás.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** NEM tartunk élő `DyNTS_ScopedConfig_DataService`
+ * mezőt (eager DB-resolve a base-ctor-ban) — minden DB-művelet előtt lazy `new ...DataService`.
+ */
+class DyNTS_ScopedConfig_ControlService {
+    static _instance;
+    /** Default issuer a config-műveletekhez. */
+    issuer = 'DyNTS_ScopedConfig_ControlService';
+    /** Rövid-TTL memória-cache (kulcs: kontextus-szelet; `set` invalidálja). */
+    cache = new Map();
+    /** A cache TTL ms-ben (~5s; rövid, hogy a hot-path olcsó legyen, de a `set` után friss). */
+    cacheTtlMs = 5000;
+    static getInstance() {
+        if (!DyNTS_ScopedConfig_ControlService._instance) {
+            DyNTS_ScopedConfig_ControlService._instance = new DyNTS_ScopedConfig_ControlService();
+        }
+        return DyNTS_ScopedConfig_ControlService._instance;
+    }
+    // =========================================================================
+    // RESOLVE — precedencia: scope (leaf→root) > table > global > builtinDefault
+    // =========================================================================
+    /**
+     * Egy kulcs feloldása a legspecifikusabb beállított értékre. A precedencia:
+     * (1) SCOPE szint a `scopePath` LEVÉBŐL a gyökér felé (az első/legmélyebb találat nyer),
+     * (2) TABLE szint, (3) GLOBAL szint, (4) a hívó által átadott `builtinDefault` (ha van).
+     *
+     * A `scopePath` canonical formában érkezik (a fogyasztó read/write-path-ja oldotta fel).
+     */
+    async resolve(key, options) {
+        const context = {
+            table: options?.table,
+            scopePath: options?.scopePath,
+        };
+        const records = await this.loadEffectiveRecords(context);
+        return this.resolveFromRecords(key, records, context, options?.builtinDefault);
+    }
+    /**
+     * A teljes effektív config egy adott kontextusra (batch). EGY Mongo-kör (cache-elt), majd memóriában
+     * merge: minden KONFIGURÁLT kulcsra a feloldott érték + forrás-szint. A hot-path (read/write) ezt
+     * használja, nem per-key kört. A builtin-only kulcsok NEM jelennek meg (nincs katalógus a bedrock-ban
+     * — azokat a fogyasztó iterálja a saját katalógusából a `resolve`-on át).
+     */
+    async resolveAll(context) {
+        const records = await this.loadEffectiveRecords(context);
+        const result = {};
+        const keys = new Set(records.map((record) => record.key));
+        for (const key of keys) {
+            result[key] = this.resolveFromRecords(key, records, context);
+        }
+        return result;
+    }
+    /**
+     * A `resolve` mag (memóriában, a betöltött rekord-halmazon). Külön metódus, hogy a `resolveAll` is
+     * ezt használja (egyetlen Mongo-kör után minden kulcsra). A `builtinDefault` a hívó fallback-je.
+     */
+    resolveFromRecords(key, records, context, builtinDefault) {
+        const table = context?.table;
+        const scopePath = context?.scopePath ?? [];
+        // 1. SCOPE szint — a scopePath levéből a gyökér felé (leaf→root); az első találat nyer.
+        if (table && scopePath.length) {
+            for (let i = scopePath.length - 1; i >= 0; i--) {
+                const scopeId = scopePath[i].scopeId;
+                const hit = records.find((record) => record.level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope &&
+                    record.tableScope === table &&
+                    record.scopeId === scopeId &&
+                    record.key === key);
+                if (hit) {
+                    return this.toResolved(hit, 'scope');
+                }
+            }
+        }
+        // 2. TABLE szint.
+        if (table) {
+            const hit = records.find((record) => record.level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.table &&
+                record.tableScope === table &&
+                record.key === key);
+            if (hit) {
+                return this.toResolved(hit, 'table');
+            }
+        }
+        // 3. GLOBAL szint.
+        const globalHit = records.find((record) => record.level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.global && record.key === key);
+        if (globalHit) {
+            return this.toResolved(globalHit, 'global');
+        }
+        // 4. builtinDefault (a hívó fallback-je; a bedrock NEM tart katalógust).
+        return {
+            value: builtinDefault,
+            resolvedFrom: 'builtin',
+        };
+    }
+    /** Egy DB-rekordot a feloldott-érték shape-re (a forrás-szinttel + audittal). */
+    toResolved(record, resolvedFrom) {
+        return {
+            value: record.value,
+            resolvedFrom: resolvedFrom,
+            scopeId: record.scopeId,
+            setBy: record.setBy,
+            setByDetail: record.setByDetail,
+        };
+    }
+    /**
+     * A kontextusra releváns aktív rekordok betöltése EGY Mongo-körrel, cache-elve. A filter a global +
+     * (ha van) table + a scopePath összes scopeId-jára szűkít — a merge memóriában fut. `set` invalidál.
+     */
+    async loadEffectiveRecords(context) {
+        const cacheKey = this.cacheKey(context);
+        const cached = this.cache.get(cacheKey);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.records;
+        }
+        const orClauses = [{ level: dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.global }];
+        if (context?.table) {
+            orClauses.push({ level: dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.table, tableScope: context.table });
+            const scopeIds = (context.scopePath ?? []).map((ref) => ref.scopeId);
+            if (scopeIds.length) {
+                orClauses.push({ level: dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope, tableScope: context.table, scopeId: { $in: scopeIds } });
+            }
+        }
+        const dataService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ issuer: this.issuer });
+        const records = await dataService.findActiveList({ $or: orClauses });
+        this.cache.set(cacheKey, { records: records, expiresAt: Date.now() + this.cacheTtlMs });
+        return records;
+    }
+    /** A cache-kulcs egy kontextus-szeletre (table + a scopePath scopeId-lánca). */
+    cacheKey(context) {
+        const table = context?.table ?? '-';
+        const scopeIds = (context?.scopePath ?? []).map((ref) => ref.scopeId).join('>') || '-';
+        return `${table}|${scopeIds}`;
+    }
+    /** A teljes cache invalidálása (`set` után). */
+    invalidateCache() {
+        this.cache.clear();
+    }
+    /** A cache TTL felülírása (ms); a fogyasztó hangolhatja (pl. a saját `reference.cacheTtlMs`-éből). */
+    setCacheTtlMs(ttlMs) {
+        this.cacheTtlMs = ttlMs;
+    }
+    // =========================================================================
+    // SET — archive-old-active → write-new → invalidate cache
+    // =========================================================================
+    /**
+     * Egy config-érték beállítása egy adott szinten (BFR-AM-004). A `set`:
+     * (1) az ugyanazon `(level,tableScope,scopeId,key)` kulcson lévő AKTÍV régi rekordot soft-delete-eli
+     *     (archív → history), (2) az új aktív rekordot kiírja (a `value` Mixed), (3) invalidálja a cache-t.
+     *
+     * **Domain-agnosztikus:** NINCS típus-/tartomány-validáció (az a fogyasztó katalógusának dolga); a
+     * bedrock csak a feloldási-kulcs konzisztenciáját biztosítja (table-/scope-szinten a megfelelő
+     * scope-azonosító jelenléte kötelező).
+     */
+    async set(level, key, value, options = {}) {
+        this.assertLevelConsistency(level, key, options);
+        const issuer = options.issuer ?? this.issuer;
+        const filter = dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService.levelKeyFilter(level, key, options);
+        // Régi aktív rekord (ha van) → soft-delete (archív; history-megőrzés).
+        const findService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ issuer: issuer });
+        const existing = await findService.findActive(filter);
+        if (existing && existing._id) {
+            await findService.deleteData(existing._id);
+        }
+        // Új aktív rekord — a `value` Mixed.
+        const record = new dynts_scoped_config_data_model_1.DyNTS_ScopedConfig({
+            level: level,
+            tableScope: options.tableScope,
+            scopeId: options.scopeId,
+            key: key,
+            value: value,
+            setBy: options.setBy ?? 'system',
+            setByDetail: options.setByDetail,
+            note: options.note,
+        });
+        const writeService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ data: record, issuer: issuer });
+        const saved = await writeService.saveData(record);
+        this.invalidateCache();
+        return saved;
+    }
+    /**
+     * A feloldási-kulcs minimál-konzisztenciája (NEM domain-validáció): table-/scope-szinten kötelező a
+     * `tableScope`, scope-szinten a `scopeId`. Ezek nélkül a feloldási-kulcs értelmetlen lenne.
+     */
+    assertLevelConsistency(level, key, options) {
+        if ((level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.table || level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope) && !options.tableScope) {
+            throw new Error(`DyNTS_ScopedConfig: '${key}' '${level}' szintű beállításához kötelező a tableScope.`);
+        }
+        if (level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope && !options.scopeId) {
+            throw new Error(`DyNTS_ScopedConfig: '${key}' 'scope' szintű beállításához kötelező a scopeId.`);
+        }
+    }
+    // =========================================================================
+    // HISTORY — felülírás-history (soft-delete-elt régi rekordok)
+    // =========================================================================
+    /**
+     * Egy feloldási-kulcs felülírás-historyja: a soft-delete-elt (archív) régi rekordok az archív
+     * collection-ből. Audit-trail / rollback-alap. (A FOGYASZTÓ presetjei/auditja erre épülhetnek.)
+     */
+    async getHistory(level, key, options = {}) {
+        const filter = dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService.levelKeyFilter(level, key, options);
+        const dataService = new dynts_scoped_config_data_service_1.DyNTS_ScopedConfig_DataService({ issuer: options.issuer ?? this.issuer });
+        return dataService.getArchiveDataService().findDataList(filter, true);
+    }
+}
+exports.DyNTS_ScopedConfig_ControlService = DyNTS_ScopedConfig_ControlService;
 //# sourceMappingURL=dynts-scoped-config.control-service.js.map