@futdevpro/nts-dynamo 1.15.104 → 1.15.105

package/src/_modules/scoped-config/_enums/dynts-scoped-config-level.enum.ts

@@ -1,22 +1,22 @@
-
-/**
- * `DyNTS_ScopedConfig_Level` — a DB-backed scoped config feloldási-szintjei (BFR-AM-004).
- *
- * A precedencia: **scope (leaf→root) > table > global > builtin-default**. Egy `DyNTS_ScopedConfig`
- * dokumentum mindig pontosan EGY szinten él; a `level` + `tableScope` + `scopeId` hármas adja a
- * feloldási-kulcsot (a `key`-vel együtt a logikai unique-constraint).
- *
- * **Domain-agnosztikus:** a konkrét table-/scope-nevek a fogyasztó dolga; a bedrock csak a generikus
- * precedencia-engine + a tárolás szintjeit definiálja (a katalógus/kulcsok NEM ide tartoznak).
- */
-export enum DyNTS_ScopedConfig_Level {
-
-  /** Rendszer-szintű default (a legalacsonyabb precedencia a builtin felett). */
-  global = 'global',
-
-  /** Egy adott logikai tár/táblázat szintje (`tableScope` kötelező). */
-  table = 'table',
-
-  /** A legspecifikusabb szint: egy konkrét scope-entitás (`tableScope` + `scopeId` kötelező). */
-  scope = 'scope',
-}
+
+/**
+ * `DyNTS_ScopedConfig_Level` — a DB-backed scoped config feloldási-szintjei (BFR-AM-004).
+ *
+ * A precedencia: **scope (leaf→root) > table > global > builtin-default**. Egy `DyNTS_ScopedConfig`
+ * dokumentum mindig pontosan EGY szinten él; a `level` + `tableScope` + `scopeId` hármas adja a
+ * feloldási-kulcsot (a `key`-vel együtt a logikai unique-constraint).
+ *
+ * **Domain-agnosztikus:** a konkrét table-/scope-nevek a fogyasztó dolga; a bedrock csak a generikus
+ * precedencia-engine + a tárolás szintjeit definiálja (a katalógus/kulcsok NEM ide tartoznak).
+ */
+export enum DyNTS_ScopedConfig_Level {
+
+  /** Rendszer-szintű default (a legalacsonyabb precedencia a builtin felett). */
+  global = 'global',
+
+  /** Egy adott logikai tár/táblázat szintje (`tableScope` kötelező). */
+  table = 'table',
+
+  /** A legspecifikusabb szint: egy konkrét scope-entitás (`tableScope` + `scopeId` kötelező). */
+  scope = 'scope',
+}

package/src/_modules/scoped-config/_models/data-models/dynts-scoped-config.data-model.ts

@@ -1,82 +1,82 @@
-
-import { DyFM_DataModel_Params, DyFM_Metadata, DyFM_Object } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_ScopedConfig_Level } from '../../_enums/dynts-scoped-config-level.enum';
-
-/**
- * `DyNTS_ScopedConfig` entitás (BFR-AM-004) — egy dokumentum = **egy setting-érték egy adott szinten**.
- * A `level` + `tableScope` + `scopeId` hármas adja a feloldási-kulcsot (a `key`-vel együtt a logikai
- * unique-constraint); a precedencia: **scope (leaf→root) > table > global > builtin-default**.
- *
- * `extends DyFM_Metadata`: az identitás/metadata (`_id`, `__created`, `__lastModified`, `_deleted`)
- * az ősből jön; a `_deleted` soft-delete marker (Date), amit a `DyNTS_ArchiveDataService` kezel — ez
- * a felülírás-history alapja (egy `set` a régi aktív rekordot archiválja, az újat aktívan írja).
- *
- * **Domain-agnosztikus:** a `key` `string`, a `value` `unknown` (Mongoose `Mixed`, séma-szinten
- * `type:'object'`). A bedrock NEM validál séma-szinten — a típushelyesség / katalógus a FOGYASZTÓ
- * dolga. A `value` írása **`$set`-tel atomikus** (Mongoose Mixed silent-drop ellen — lásd
- * `DyNTS_ScopedConfig_DataService.setValue`).
- */
-export class DyNTS_ScopedConfig extends DyFM_Metadata {
-
-  // --- a feloldási kulcs ---
-
-  /** A feloldási-szint (`global`|`table`|`scope`). */
-  level?: DyNTS_ScopedConfig_Level;
-
-  /** `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;
-
-  // --- a setting maga ---
-
-  /** A config-kulcs (a fogyasztó katalógusából; string-ként perzistált). */
-  key?: string;
-
-  /** A setting-érték; típusa a fogyasztó katalógusa szerint. Mongoose `Mixed`. */
-  value?: unknown;
-
-  // --- audit ---
-
-  /** Ki/mi állította be (audit). */
-  setBy?: string;
-
-  /** Beállítás-részlet (pl. preset-név, CLI-user). */
-  setByDetail?: string;
-
-  /** Opcionális indoklás. */
-  note?: string;
-
-  constructor(set?: Partial<DyNTS_ScopedConfig>) {
+
+import { DyFM_DataModel_Params, DyFM_Metadata, DyFM_Object } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_ScopedConfig_Level } from '../../_enums/dynts-scoped-config-level.enum';
+
+/**
+ * `DyNTS_ScopedConfig` entitás (BFR-AM-004) — egy dokumentum = **egy setting-érték egy adott szinten**.
+ * A `level` + `tableScope` + `scopeId` hármas adja a feloldási-kulcsot (a `key`-vel együtt a logikai
+ * unique-constraint); a precedencia: **scope (leaf→root) > table > global > builtin-default**.
+ *
+ * `extends DyFM_Metadata`: az identitás/metadata (`_id`, `__created`, `__lastModified`, `_deleted`)
+ * az ősből jön; a `_deleted` soft-delete marker (Date), amit a `DyNTS_ArchiveDataService` kezel — ez
+ * a felülírás-history alapja (egy `set` a régi aktív rekordot archiválja, az újat aktívan írja).
+ *
+ * **Domain-agnosztikus:** a `key` `string`, a `value` `unknown` (Mongoose `Mixed`, séma-szinten
+ * `type:'object'`). A bedrock NEM validál séma-szinten — a típushelyesség / katalógus a FOGYASZTÓ
+ * dolga. A `value` írása **`$set`-tel atomikus** (Mongoose Mixed silent-drop ellen — lásd
+ * `DyNTS_ScopedConfig_DataService.setValue`).
+ */
+export class DyNTS_ScopedConfig extends DyFM_Metadata {
+
+  // --- a feloldási kulcs ---
+
+  /** A feloldási-szint (`global`|`table`|`scope`). */
+  level?: DyNTS_ScopedConfig_Level;
+
+  /** `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;
+
+  // --- a setting maga ---
+
+  /** A config-kulcs (a fogyasztó katalógusából; string-ként perzistált). */
+  key?: string;
+
+  /** A setting-érték; típusa a fogyasztó katalógusa szerint. Mongoose `Mixed`. */
+  value?: unknown;
+
+  // --- audit ---
+
+  /** Ki/mi állította be (audit). */
+  setBy?: string;
+
+  /** Beállítás-részlet (pl. preset-név, CLI-user). */
+  setByDetail?: string;
+
+  /** Opcionális indoklás. */
+  note?: string;
+
+  constructor(set?: Partial<DyNTS_ScopedConfig>) {
     super(set);
-
-    if (set) {
-      DyFM_Object.cleanAssign(this, set);
-    }
-  }
-}
-
-/**
- * MongoDB data-params a `dynts_scoped_config` collection-höz (BFR-AM-004). `addArchive: true` → a
- * felülírt (régi) értékek soft-delete-elve megőrződnek (audit-trail / history).
- *
- * A `value` `type:'object'` (Mongoose `Mixed`) — a séma NEM validál; a típushelyesség a fogyasztó
- * katalógusának + set-kori validációjának dolga.
- */
-export const DyNTS_scopedConfig_dataParams: DyFM_DataModel_Params<DyNTS_ScopedConfig> =
-  new DyFM_DataModel_Params<DyNTS_ScopedConfig>({
-    dataName: 'dynts_scoped_config',
-    addArchive: true,
-    properties: {
-      level: { type: 'string', index: true, required: true },
-      tableScope: { type: 'string', index: true },
-      scopeId: { type: 'string', index: true },
-      key: { type: 'string', index: true, required: true },
-      value: { type: 'object' },
-      setBy: { type: 'string', index: true },
-      setByDetail: { type: 'string' },
-      note: { type: 'string' },
-    },
-  });
+
+    if (set) {
+      DyFM_Object.cleanAssign(this, set);
+    }
+  }
+}
+
+/**
+ * MongoDB data-params a `dynts_scoped_config` collection-höz (BFR-AM-004). `addArchive: true` → a
+ * felülírt (régi) értékek soft-delete-elve megőrződnek (audit-trail / history).
+ *
+ * A `value` `type:'object'` (Mongoose `Mixed`) — a séma NEM validál; a típushelyesség a fogyasztó
+ * katalógusának + set-kori validációjának dolga.
+ */
+export const DyNTS_scopedConfig_dataParams: DyFM_DataModel_Params<DyNTS_ScopedConfig> =
+  new DyFM_DataModel_Params<DyNTS_ScopedConfig>({
+    dataName: 'dynts_scoped_config',
+    addArchive: true,
+    properties: {
+      level: { type: 'string', index: true, required: true },
+      tableScope: { type: 'string', index: true },
+      scopeId: { type: 'string', index: true },
+      key: { type: 'string', index: true, required: true },
+      value: { type: 'object' },
+      setBy: { type: 'string', index: true },
+      setByDetail: { type: 'string' },
+      note: { type: 'string' },
+    },
+  });

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

@@ -1,107 +1,107 @@
-
-/**
- * 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;
-}
+
+/**
+ * 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;
+}