@futdevpro/nts-dynamo 1.15.56 → 1.15.58

package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Scoped-config shared vokabulár (BFR-AM-004). Egy fájlban a szorosan összetartozó típusok
+ * (a `*.interface.ts` az egy-export-per-file konvenció ismert kivétele — mint a FAM `fam-config.interface.ts`).
+ *
+ * **Domain-agnosztikus:** a bedrock CSAK a generikus resolve-precedencia engine-t + a tárolást adja;
+ * a konkrét kulcs-katalógus, a kulcs-típusok és a default-ok a fogyasztó projekté (pl. FAM
+ * `CONFIG_CATALOG`). Ezért a `value` itt `unknown`, a `key` `string`, és a `builtinDefault`-ot a
+ * hívó adja át (nincs beépített katalógus).
+ */
+/**
+ * Egy scoped-config érték generikus típusa. A típushelyesség a FOGYASZTÓ felelőssége (a bedrock nem
+ * validál séma-szinten — a `value` Mongoose `Mixed`). A `null` megengedett (pl. "nincs plafon").
+ */
+export type DyNTS_ScopedConfigValue = number | string | boolean | string[] | null | {
+    [key: string]: unknown;
+};
+/**
+ * A precedencia-feloldás forrás-szintje. A `resolve` ezt adja vissza, hogy a fogyasztó átlátható módon
+ * tudja, **honnan** jön egy érték (`builtin` = a hívó által átadott `builtinDefault`).
+ */
+export type DyNTS_ScopedConfigResolvedFrom = 'scope' | 'table' | 'global' | 'builtin';
+/**
+ * Egy canonical scope-referencia a `scopePath`-ban (BFR-AM-004). A `scopeId` a logikai scope-azonosító
+ * (a fogyasztó adja, pl. egy `FAM_Scope._id`); a feloldás a path **levéből** (utolsó elem) indul a
+ * gyökér (első elem) felé — a legmélyebb találat nyer.
+ */
+export interface DyNTS_ScopedConfigScopeRef {
+    /** A scope logikai azonosítója (a `DyNTS_ScopedConfig.scopeId`-vel egyezik). */
+    scopeId: string;
+}
+/**
+ * A `resolve(key, ctx)` / `resolveAll(ctx)` kontextusa (BFR-AM-004). A `table` + `scopePath` nélkül
+ * csak a global + builtin szint értelmezett. A `scopePath` canonical formában érkezik (a fogyasztó
+ * read/write-path-ja oldotta fel) — a config-engine nyers stringgel NEM dolgozik.
+ */
+export interface DyNTS_ScopedConfigResolveContext {
+    /** Melyik logikai tár szintjén oldjuk fel (a table + scope ág; nélküle csak global+builtin). */
+    table?: string;
+    /** Canonical scope-lánc (gyökér→levél); a feloldás a **levéből** indul a gyökér felé. */
+    scopePath?: DyNTS_ScopedConfigScopeRef[];
+}
+/**
+ * Egy feloldott config-érték a forrás-szinttel (BFR-AM-004). Átlátható: jelzi, melyik szintről jött
+ * az effektív érték + ki állította be (audit). A `builtin` esetén csak a `value` + `resolvedFrom` van.
+ */
+export interface DyNTS_ScopedConfigResolvedValue<T = DyNTS_ScopedConfigValue> {
+    /** A feloldott effektív érték. */
+    value: T;
+    /** A forrás-szint (`scope`/`table`/`global`/`builtin`). */
+    resolvedFrom: DyNTS_ScopedConfigResolvedFrom;
+    /** Ha `resolvedFrom='scope'`, melyik scope-entitásról (a legmélyebb találat). */
+    scopeId?: string;
+    /** Ki/mi állította be (a forrás-rekordról; `builtin` esetén nincs). */
+    setBy?: string;
+    /** Beállítás-részlet (pl. preset-név / CLI-user), ha van. */
+    setByDetail?: string;
+}
+/**
+ * A `resolve(key, opts)` opciói (BFR-AM-004). A `builtinDefault` a hívó által átadott fallback —
+ * ha egyik DB-szinten sincs érték, ezt adja vissza `resolvedFrom='builtin'`-nal (a bedrock nem
+ * tart beépített katalógust). Ha nincs `builtinDefault` és nincs DB-érték, az érték `undefined`.
+ */
+export interface DyNTS_ScopedConfigResolveOptions<T = DyNTS_ScopedConfigValue> {
+    /** Melyik logikai tár szintjén oldjuk fel (a table + scope ág). */
+    table?: string;
+    /** Canonical scope-lánc (gyökér→levél); a feloldás a **levéből** indul a gyökér felé. */
+    scopePath?: DyNTS_ScopedConfigScopeRef[];
+    /** A hívó által átadott builtin fallback (a katalógus a fogyasztóé). */
+    builtinDefault?: T;
+}
+/**
+ * A `set(level, key, value, opts)` opció-objektuma (BFR-AM-004). A `level`+`tableScope`+`scopeId` adja
+ * a feloldási-kulcsot; az audit-mezők (`setBy`/`setByDetail`/`note`) a felülírás-history-hez.
+ */
+export interface DyNTS_ScopedConfigSetOptions {
+    /** `level='table'|'scope'` esetén kötelező: melyik logikai tár. */
+    tableScope?: string;
+    /** `level='scope'` esetén kötelező: a scope-entitás logikai azonosítója. */
+    scopeId?: string;
+    /** Ki/mi állította be (audit; default `'system'`). */
+    setBy?: string;
+    /** Beállítás-részlet (pl. preset-név / CLI-user). */
+    setByDetail?: string;
+    /** Opcionális indoklás. */
+    note?: string;
+    /** A hibák / write-ok `issuer`-e. */
+    issuer?: string;
+}
+//# sourceMappingURL=dynts-scoped-config.interface.d.ts.map

package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config.interface.d.ts","sourceRoot":"","sources":["../../../../../src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GACjC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,8BAA8B,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEtF;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,gGAAgG;IAChG,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yFAAyF;IACzF,SAAS,CAAC,EAAE,0BAA0B,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,+BAA+B,CAAC,CAAC,GAAG,uBAAuB;IAC1E,kCAAkC;IAClC,KAAK,EAAE,CAAC,CAAC;IAET,2DAA2D;IAC3D,YAAY,EAAE,8BAA8B,CAAC;IAE7C,iFAAiF;IACjF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6DAA6D;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,gCAAgC,CAAC,CAAC,GAAG,uBAAuB;IAC3E,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,yFAAyF;IACzF,SAAS,CAAC,EAAE,0BAA0B,EAAE,CAAC;IAEzC,wEAAwE;IACxE,cAAc,CAAC,EAAE,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B;IAC3C,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dynts-scoped-config.interface.js.map

package/build/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config.interface.js","sourceRoot":"","sources":["../../../../../src/_modules/scoped-config/_models/interfaces/dynts-scoped-config.interface.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,84 @@
+import { DyNTS_ScopedConfig_Level } from '../_enums/dynts-scoped-config-level.enum';
+import { DyNTS_ScopedConfig_DataModel } 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_DataModel>;
+    /**
+     * 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_DataModel[]>;
+}
+//# sourceMappingURL=dynts-scoped-config.control-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config.control-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/scoped-config/_services/dynts-scoped-config.control-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uDAAuD,CAAC;AACrG,OAAO,EACL,gCAAgC,EAEhC,+BAA+B,EAC/B,gCAAgC,EAChC,4BAA4B,EAC5B,uBAAuB,EACxB,MAAM,qDAAqD,CAAC;AAa7D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,iCAAiC;IAE5C,OAAO,CAAC,MAAM,CAAC,SAAS,CAAoC;IAE5D,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IAEtE,4EAA4E;IAC5E,OAAO,CAAC,KAAK,CAA8F;IAE3G,4FAA4F;IAC5F,OAAO,CAAC,UAAU,CAAgB;IAElC,MAAM,CAAC,WAAW,IAAI,iCAAiC;IAWvD;;;;;;OAMG;IACG,OAAO,CAAC,CAAC,GAAG,uBAAuB,EACvC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,gCAAgC,CAAC,CAAC,CAAC,GAC5C,OAAO,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC;IAS9C;;;;;OAKG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE,gCAAgC,GAAG,OAAO,CAAC;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,+BAA+B,CAAA;KAAE,CAAC;IAUzH;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAoD1B,iFAAiF;IACjF,OAAO,CAAC,UAAU;IAalB;;;OAGG;YACW,oBAAoB;IAuBlC,gFAAgF;IAChF,OAAO,CAAC,QAAQ;IAMhB,gDAAgD;IAChD,eAAe,IAAI,IAAI;IAIvB,sGAAsG;IACtG,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQlC;;;;;;;;OAQG;IACG,GAAG,CACP,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,4BAA4B,CAAC;IAgCxC;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAa9B;;;OAGG;IACG,UAAU,CACd,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,4BAA4B,EAAE,CAAC;CAM3C"}

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

@@ -0,0 +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_DataModel({
+            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

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

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

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

@@ -0,0 +1,54 @@
+import { DyFM_DBFilter, DyFM_DBFilterSimple } from '@futdevpro/fsm-dynamo';
+import { DyNTS_ArchiveDataService } from '../../../_services/base/archive-data.service';
+import { DyNTS_DataService } from '../../../_services/base/data.service';
+import { DyNTS_ScopedConfig_Level } from '../_enums/dynts-scoped-config-level.enum';
+import { DyNTS_ScopedConfig_DataModel } from '../_models/data-models/dynts-scoped-config.data-model';
+/**
+ * `DyNTS_ScopedConfig_DataService` — a `dynts_scoped_config` collection CRUD + soft-delete history-rétege
+ * (BFR-AM-004). `extends DyNTS_DataService`; `addArchive: true` → a felülírt (régi) értékek
+ * soft-delete-elve megőrződnek (audit-trail). A nts-konvenció szerinti `{ data?, issuer }` constructor.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** a `DyNTS_DataService` base-ctor EAGER
+ * `getDBService`-t hív → a control-service NEM tarthat élő data-service-példányt mezőként; minden
+ * művelet előtt lazy `new DyNTS_ScopedConfig_DataService(...)` kell.
+ *
+ * **A `value` írása `$set`-tel atomikus** (Mongoose Mixed silent-drop ellen — memory:
+ * mongoose_mixed_atomic_write): a `findOne→mutate→save` SILENT-DROP-ot ad a Mixed mezőkre, ezért az
+ * érték-frissítést a `setValue` `updateOne({ ... }, { $set: { value } })`-vel végzi.
+ */
+export declare class DyNTS_ScopedConfig_DataService extends DyNTS_DataService<DyNTS_ScopedConfig_DataModel> {
+    constructor(set: {
+        data?: DyNTS_ScopedConfig_DataModel;
+        issuer: string;
+    });
+    /**
+     * Az archív (soft-delete-elt) rekordokhoz tartozó data-service (a base override-ja). A
+     * `DyNTS_DataService.deleteData` ezen át archiválja a felülírt aktív rekordokat (history).
+     */
+    getArchiveDataService(): DyNTS_ArchiveDataService<DyNTS_ScopedConfig_DataModel>;
+    /**
+     * Egy adott feloldási-kulcson (`level`+`tableScope`+`scopeId`+`key`) az AKTÍV (nem soft-delete-elt)
+     * rekord. Az aktív rekordon a `_deleted` Date soft-delete marker nincs beállítva.
+     */
+    findActive(filter: DyFM_DBFilter<DyNTS_ScopedConfig_DataModel>): Promise<DyNTS_ScopedConfig_DataModel>;
+    /**
+     * Az adott kontextusra konfigurált ÖSSZES aktív rekord (a `resolveAll` egy Mongo-köre).
+     */
+    findActiveList(filter: DyFM_DBFilter<DyNTS_ScopedConfig_DataModel>): Promise<DyNTS_ScopedConfig_DataModel[]>;
+    /**
+     * Egy létező aktív rekord `value`-jának ATOMIKUS frissítése (`$set`). A Mixed mező `findOne→mutate→
+     * save` útján SILENT-DROP-ot adna; a `$set` ezt elkerüli (memory: mongoose_mixed_atomic_write). A
+     * `setBy`/`setByDetail`/`note` audit-mezők is frissülnek.
+     */
+    setValue(id: string, value: unknown, audit?: {
+        setBy?: string;
+        setByDetail?: string;
+        note?: string;
+    }): Promise<void>;
+    /** A `(level, tableScope, scopeId, key)` feloldási-kulcs filtere (a logikai unique-constraint). */
+    static levelKeyFilter(level: DyNTS_ScopedConfig_Level, key: string, set: {
+        tableScope?: string;
+        scopeId?: string;
+    }): DyFM_DBFilterSimple<DyNTS_ScopedConfig_DataModel>;
+}
+//# sourceMappingURL=dynts-scoped-config.data-service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config.data-service.d.ts","sourceRoot":"","sources":["../../../../src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,0CAA0C,CAAC;AACpF,OAAO,EACL,4BAA4B,EAE7B,MAAM,uDAAuD,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,qBAAa,8BAA+B,SAAQ,iBAAiB,CAAC,4BAA4B,CAAC;gBAG/F,GAAG,EAAE;QACH,IAAI,CAAC,EAAE,4BAA4B,CAAC;QACpC,MAAM,EAAE,MAAM,CAAC;KAChB;IASH;;;OAGG;IACM,qBAAqB,IAAI,wBAAwB,CAAC,4BAA4B,CAAC;IAQxF;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,4BAA4B,CAAC,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAI5G;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,aAAa,CAAC,4BAA4B,CAAC,GAAG,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAIlH;;;;OAIG;IACG,QAAQ,CACZ,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,EACd,KAAK,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAClE,OAAO,CAAC,IAAI,CAAC;IAchB,mGAAmG;IACnG,MAAM,CAAC,cAAc,CACnB,KAAK,EAAE,wBAAwB,EAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,mBAAmB,CAAC,4BAA4B,CAAC;CAUrD"}

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

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ScopedConfig_DataService = void 0;
+const archive_data_service_1 = require("../../../_services/base/archive-data.service");
+const data_service_1 = require("../../../_services/base/data.service");
+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");
+/**
+ * `DyNTS_ScopedConfig_DataService` — a `dynts_scoped_config` collection CRUD + soft-delete history-rétege
+ * (BFR-AM-004). `extends DyNTS_DataService`; `addArchive: true` → a felülírt (régi) értékek
+ * soft-delete-elve megőrződnek (audit-trail). A nts-konvenció szerinti `{ data?, issuer }` constructor.
+ *
+ * **FIGYELEM (memory: dynts_dataservice_eager_resolve):** a `DyNTS_DataService` base-ctor EAGER
+ * `getDBService`-t hív → a control-service NEM tarthat élő data-service-példányt mezőként; minden
+ * művelet előtt lazy `new DyNTS_ScopedConfig_DataService(...)` kell.
+ *
+ * **A `value` írása `$set`-tel atomikus** (Mongoose Mixed silent-drop ellen — memory:
+ * mongoose_mixed_atomic_write): a `findOne→mutate→save` SILENT-DROP-ot ad a Mixed mezőkre, ezért az
+ * érték-frissítést a `setValue` `updateOne({ ... }, { $set: { value } })`-vel végzi.
+ */
+class DyNTS_ScopedConfig_DataService extends data_service_1.DyNTS_DataService {
+    constructor(set) {
+        super(set.data instanceof dynts_scoped_config_data_model_1.DyNTS_ScopedConfig_DataModel ? set.data : new dynts_scoped_config_data_model_1.DyNTS_ScopedConfig_DataModel(set.data), dynts_scoped_config_data_model_1.dyNTS_scopedConfig_dataParams, set.issuer);
+    }
+    /**
+     * Az archív (soft-delete-elt) rekordokhoz tartozó data-service (a base override-ja). A
+     * `DyNTS_DataService.deleteData` ezen át archiválja a felülírt aktív rekordokat (history).
+     */
+    getArchiveDataService() {
+        return new archive_data_service_1.DyNTS_ArchiveDataService(this.data, dynts_scoped_config_data_model_1.dyNTS_scopedConfig_dataParams, this.issuer);
+    }
+    /**
+     * Egy adott feloldási-kulcson (`level`+`tableScope`+`scopeId`+`key`) az AKTÍV (nem soft-delete-elt)
+     * rekord. Az aktív rekordon a `_deleted` Date soft-delete marker nincs beállítva.
+     */
+    async findActive(filter) {
+        return this.findData(filter, true);
+    }
+    /**
+     * Az adott kontextusra konfigurált ÖSSZES aktív rekord (a `resolveAll` egy Mongo-köre).
+     */
+    async findActiveList(filter) {
+        return this.findDataList(filter, true);
+    }
+    /**
+     * Egy létező aktív rekord `value`-jának ATOMIKUS frissítése (`$set`). A Mixed mező `findOne→mutate→
+     * save` útján SILENT-DROP-ot adna; a `$set` ezt elkerüli (memory: mongoose_mixed_atomic_write). A
+     * `setBy`/`setByDetail`/`note` audit-mezők is frissülnek.
+     */
+    async setValue(id, value, audit = {}) {
+        await this.updateData({
+            filterBy: { _id: id },
+            update: {
+                $set: {
+                    value: value,
+                    setBy: audit.setBy,
+                    setByDetail: audit.setByDetail,
+                    note: audit.note,
+                },
+            },
+        });
+    }
+    /** A `(level, tableScope, scopeId, key)` feloldási-kulcs filtere (a logikai unique-constraint). */
+    static levelKeyFilter(level, key, set) {
+        const filter = { level: level, key: key };
+        if (level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.table || level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope) {
+            filter.tableScope = set.tableScope;
+        }
+        if (level === dynts_scoped_config_level_enum_1.DyNTS_ScopedConfig_Level.scope) {
+            filter.scopeId = set.scopeId;
+        }
+        return filter;
+    }
+}
+exports.DyNTS_ScopedConfig_DataService = DyNTS_ScopedConfig_DataService;
+//# sourceMappingURL=dynts-scoped-config.data-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dynts-scoped-config.data-service.js","sourceRoot":"","sources":["../../../../src/_modules/scoped-config/_services/dynts-scoped-config.data-service.ts"],"names":[],"mappings":";;;AAGA,uFAAwF;AACxF,uEAAyE;AACzE,6FAAoF;AACpF,0GAG+D;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAa,8BAA+B,SAAQ,gCAA+C;IAEjG,YACE,GAGC;QAED,KAAK,CACH,GAAG,CAAC,IAAI,YAAY,6DAA4B,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,6DAA4B,CAAC,GAAG,CAAC,IAAI,CAAC,EACxG,8DAA6B,EAC7B,GAAG,CAAC,MAAM,CACX,CAAC;IACJ,CAAC;IAED;;;OAGG;IACM,qBAAqB;QAC5B,OAAO,IAAI,+CAAwB,CACjC,IAAI,CAAC,IAAI,EACT,8DAA6B,EAC7B,IAAI,CAAC,MAAM,CACZ,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,MAAmD;QAClE,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,MAAmD;QACtE,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,EAAU,EACV,KAAc,EACd,QAAiE,EAAE;QAEnE,MAAM,IAAI,CAAC,UAAU,CAAC;YACpB,QAAQ,EAAE,EAAE,GAAG,EAAE,EAAE,EAAuD;YAC1E,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,WAAW,EAAE,KAAK,CAAC,WAAW;oBAC9B,IAAI,EAAE,KAAK,CAAC,IAAI;iBACjB;aACF;SACF,CAAC,CAAC;IACL,CAAC;IAED,mGAAmG;IACnG,MAAM,CAAC,cAAc,CACnB,KAA+B,EAC/B,GAAW,EACX,GAA8C;QAE9C,MAAM,MAAM,GAAsD,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC7F,IAAI,KAAK,KAAK,yDAAwB,CAAC,KAAK,IAAI,KAAK,KAAK,yDAAwB,CAAC,KAAK,EAAE,CAAC;YACzF,MAAM,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;QACrC,CAAC;QACD,IAAI,KAAK,KAAK,yDAAwB,CAAC,KAAK,EAAE,CAAC;YAC7C,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC/B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAhFD,wEAgFC"}

package/build/_modules/scoped-config/index.d.ts

@@ -0,0 +1,6 @@
+export * from './_enums/dynts-scoped-config-level.enum';
+export * from './_models/interfaces/dynts-scoped-config.interface';
+export * from './_models/data-models/dynts-scoped-config.data-model';
+export * from './_services/dynts-scoped-config.data-service';
+export * from './_services/dynts-scoped-config.control-service';
+//# sourceMappingURL=index.d.ts.map

package/build/_modules/scoped-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/scoped-config/index.ts"],"names":[],"mappings":"AAMA,cAAc,yCAAyC,CAAC;AAGxD,cAAc,oDAAoD,CAAC;AAGnE,cAAc,sDAAsD,CAAC;AAGrE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,iDAAiD,CAAC"}

package/build/_modules/scoped-config/index.js

@@ -0,0 +1,15 @@
+"use strict";
+// SCOPED-CONFIG MODULE (BFR-AM-004) — DB-backed, domain-agnostic scoped config precedence engine.
+// Precedencia: scope (leaf→root) > table > global > builtinDefault.
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// ENUMS
+tslib_1.__exportStar(require("./_enums/dynts-scoped-config-level.enum"), exports);
+// INTERFACES
+tslib_1.__exportStar(require("./_models/interfaces/dynts-scoped-config.interface"), exports);
+// DATA-MODELS
+tslib_1.__exportStar(require("./_models/data-models/dynts-scoped-config.data-model"), exports);
+// SERVICES
+tslib_1.__exportStar(require("./_services/dynts-scoped-config.data-service"), exports);
+tslib_1.__exportStar(require("./_services/dynts-scoped-config.control-service"), exports);
+//# sourceMappingURL=index.js.map

package/build/_modules/scoped-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/scoped-config/index.ts"],"names":[],"mappings":";AAEA,kGAAkG;AAClG,oEAAoE;;;AAEpE,QAAQ;AACR,kFAAwD;AAExD,aAAa;AACb,6FAAmE;AAEnE,cAAc;AACd,+FAAqE;AAErE,WAAW;AACX,uFAA6D;AAC7D,0FAAgE"}

package/eslint.config.js

@@ -1,3 +1,3 @@
-const ntsPackageConfig = require('@futdevpro/dynamo-eslint/nts-package');
-
-module.exports = ntsPackageConfig;
+const ntsPackageConfig = require('@futdevpro/dynamo-eslint/nts-package');
+
+module.exports = ntsPackageConfig;