@futdevpro/nts-dynamo 1.15.156 → 1.15.160

package/src/_models/interfaces/global-settings.interface.ts

@@ -1,294 +0,0 @@
-import { DyFM_EnvironmentFlag } from '@futdevpro/fsm-dynamo';
-import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { DyNTS_SecurityHeaders_Settings } from './security-headers-settings.interface';
-import { DyNTS_AppVersionHeader_Settings } from './app-version-header-settings.interface';
-import { DyNTS_SocketSecurity } from '../../_modules/socket/_enums/socket-security.enum';
-import { DyNTS_GlobalLog_Settings } from './global-log-settings.interface';
-import { DyNTS_Environment_Settings } from './environment-settings.interface';
-
-/**
- * 
- * 
- * @param logRequestsContent only will log if the specific logRequest is also true
- * 
- * @param logEventContent only will log if the specific socket event is also set to log
- * 
- */
-export interface DyNTS_Global_Settings {
-
-  env_settings: DyNTS_Environment_Settings;
-
-  /**
-   * this will be used as the main baseUrl for the application,
-   * this is not required, but we suggest to use at least a '/api' as base route
-   */
-  baseUrl: string;
-  /**
-   * this sets the default security for routes
-   */
-  defaultRouteSecurity: DyNTS_RouteSecurity;
-  /**
-   * this sets the default security for sockets
-   */
-  defaultSocketSecurity: DyNTS_SocketSecurity;
-
-  /**
-   * this is the name of the system, this will be used for the server status
-   */
-  systemName?: string;
-
-  /**
-   * this is the short code name of the system, this will be used for the logs and errors
-   */
-  systemShortCodeName?: string;
-
-  /**
-   * this is the version of the system, this will be used for the logs and errors
-   */
-  systemVersion: string;
-
-  /**
-   * this setting will set if the default route should be created
-   */
-  dontCreateDefaultRoute?: boolean;
-
-  /**
-   * 
-   */
-  autoResolveEndpointCirculationErrors: boolean;
-
-  /**
-   * this setting will set the compact error response mode for the system
-   */
-  compactErrorResponse: boolean;
-
-  /**
-   * this is the default page size for pagination
-   */
-  defaultPageSize: number;
-
-  /**
-   * this is the number of items to archive in the list, this will be used to archive the list
-   */
-  archiveListAfter: number;
-
-  /**
-   * this is the environment of the system
-   */
-  /* environment: DyFM_EnvironmentFlag; */
-
-  /**
-   * this setting will set which logs will be shown
-   */
-  log_settings: DyNTS_GlobalLog_Settings;
-
-  /**
-   * this setting will set the research issues mode for the system
-   */
-  autoResearchIssues: boolean;
-
-  /**
-   * this setting will set the bot settings
-   * (this will be set in the {@link DyNTS_Bot_Main_ControlService} constructor)
-   * 
-   * {@link DyNTS_GlobalBot_Settings}
-   * default settings: {@link DyNTS_Bot_Global_Settings}
-   */
-  bot_settings: any;
-
-  /**
-   * this setting will set the openai settings
-   * (this will be set in the {@link DyNTS_OAI_LLMChat_ServiceBase} constructor)
-   * 
-   * {@link DyNTS_OpenAI_Settings}
-   * default settings: {@link DyNTS_OAI_global_settings}
-   */
-  openAi_settings: any;
-
-  /**
-   * this setting will set the dias settings
-   * (this will be set in the {@link DyNTS_OAI_LLM_ServiceBase} constructor, if not set already)
-   * ({@link DyNTS_OAI_VectorDataService} is not using this, but its own settings)
-   * 
-   * {@link DyNTS_DiAs_Global_Settings}
-   * default settings: {@link DyNTS_DiAs_Global_Settings}
-   */
-  dias_settings: any;
-
-  /**
-   * this setting will set the assistant settings
-   * (this will be set in the {@link DyNTS_Ass_ServiceBase} constructor)
-   * 
-   * {@link DyNTS_Ass_Global_Settings}
-   * default settings: {@link DyNTS_Ass_global_settings}
-   */
-  assistant_settings?: any;
-
-  /**
-   * Auth-service beállítások.
-   *
-   * Ha `optional: true`, a framework NEM követeli meg az egyedi Auth Service-t:
-   * a {@link DyNTS_GlobalService.getAuthService} hiányzó service esetén `undefined`-ot
-   * ad vissza a `"Unique Authentication Service missing!"` hiba DOBÁSA HELYETT, és
-   * a startup-warn ('Authentication Service missing!') is elmarad. Public / no-auth
-   * szervereknek (pl. nyílt RAG/MCP backend), ahol nincs saját auth-réteg.
-   *
-   * Default: `{ optional: false }` — az auth-service kötelező (visszafelé kompatibilis,
-   * a régi viselkedés: hiányzó service → dobott hiba).
-   */
-  auth_settings?: {
-    /**
-     * Ha `true`, az Auth Service opcionális: `getAuthService()` NEM dob hiányzó
-     * service esetén, hanem `undefined`-ot ad vissza (a hívók optional-chaining-gel
-     * kezelik), és a startup 'Authentication Service missing!' warn is elmarad.
-     * Default: `false`.
-     */
-    optional?: boolean;
-  };
-
-  /**
-   * this setting will set the doc chunking settings
-   */
-  docChunking: {
-    maxChunkSize: number;
-    maxChunkCount: number;
-  };
-
-  /**
-   * this setting will set the messaging settings
-   * (this will be set in the {@link DyNTS_Msg_Main_ControlService} constructor)
-   *
-   * {@link DyNTS_Msg_Global_Settings}
-   * default settings: {@link DyNTS_Msg_global_settings}
-   */
-  messaging_settings?: any;
-
-  /**
-   * BFR-MASTERPROMPTER-011 / SEC-R2-8 — security response-header middleware. Ha enabled
-   * (default: true), a base App az open+secure Express-en a CORS-mount ELŐTT minden válaszra
-   * ráteszi a biztonsági headereket (x-powered-by removal + X-Frame-Options + nosniff +
-   * Referrer-Policy; HSTS auto-prod-gated; CSP opt-in). Lásd {@link DyNTS_SecurityHeaders_Settings}.
-   */
-  securityHeaders?: DyNTS_SecurityHeaders_Settings;
-
-  /**
-   * FR-292 — a deployolt app-verzio kiirasa minden valasz headerebe (X-App-Version), hogy
-   * a bongeszoben NYITVA HAGYOTT SPA eszrevegye, ha kozben ujabb kliens-build ment ki.
-   * Default: enabled. Lasd {@link DyNTS_AppVersionHeader_Settings}.
-   */
-  appVersionHeader?: DyNTS_AppVersionHeader_Settings;
-
-  /**
-   * FR-193 — bedrock OOM korai-figyelmeztető heap-watchdog ({@link DyNTS_MemoryGuard}).
-   * Ha `enabled`, a base `App` startup automatikusan feltelepíti. Periodikusan figyeli a
-   * heap-kihasználtságot, és a `--max-old-space-size` plafonhoz közeledve TARTÓS rekordot
-   * hagy az error-sinkbe (Errors-rendszer + Discord) — mielőtt a fatal OOM megölné a
-   * process-t. Default: enabled, 10s poll, warn 85% / crit 95%.
-   */
-  memoryGuard?: {
-    /** Bekapcsolja a heap-watchdogot (a base App startup feltelepíti). Default: true. */
-    enabled: boolean;
-    /** Poll-intervallum ms-ben. Default: 10000. */
-    pollIntervalMs?: number;
-    /** Warning küszöb a heap-plafon %-ában. Default: 85. */
-    heapWarningThreshold?: number;
-    /** Critical küszöb a heap-plafon %-ában. Default: 95. */
-    heapCriticalThreshold?: number;
-    /** A warning küszöb ALATTI margó %-ban a 'recovered'-hez (hiszterézis). Default: 10. */
-    recoveryMargin?: number;
-    /** Megőrzött események max száma (ring-buffer). Default: 100. */
-    maxHistoryCount?: number;
-    /**
-     * GC-hányad (GC-ben töltött idő / poll-ablak) küszöb a `warning`-hoz, a %-küszöb MELLETT. 0..1. Default: 0.40.
-     * A „Ineffective mark-compacts near heap limit" OOM gyakran a heap-% kritikus küszöb ALATT üt be (a GC thrash-el,
-     * `mutator utilization` lezuhan) — ezt a jelet a puszta % későn/sosem fogja. Ez a GC-jel a valódi OOM-precursor.
-     */
-    gcWarningFraction?: number;
-    /** GC-hányad küszöb a `critical`-hoz (load-shed + graceful-exit zóna). 0..1. Default: 0.60. */
-    gcCriticalFraction?: number;
-    /**
-     * Process-szintű crash-handler (`uncaughtException`) telepítése — a crash ELŐTT TELJES-RÉSZLETŰ error-entry
-     * (message + stack + kód + issuer + memória-snapshot) az error-sinkbe, majd tiszta exit. Default: true.
-     * (Az `unhandledRejection`-t a base App már rögzíti; ez az eddig néma `uncaughtException`-t fedi le.)
-     */
-    installCrashHandlers?: boolean;
-    /**
-     * Tartós `critical` (a megadott poll-számon át, GC-vel sem csökkenő) esetén TISZTA kilépés → a wrapper/
-     * restart-policy PREDIKTÍVEN újraindít, a kriptikus fatal OOM (exit 134) helyett. Default: false
-     * (konténer-restart-policy-ra bízva; standalone/`serve`-wrapper-es app opt-in-olja).
-     */
-    exitOnSustainedCritical?: boolean;
-    /** Hány EGYMÁST KÖVETŐ `critical` poll után lépjen ki (`exitOnSustainedCritical`-hez). Default: 3. */
-    sustainedCriticalPolls?: number;
-    /** A graceful-exit kódja (a wrapper ezt látja restart-jelnek). Default: 137. */
-    exitCode?: number;
-    /**
-     * **Auto-load-shed middleware** (BFR-OVERSEER-009 maradék): ha true, a base App egy korai
-     * middleware-t mountol, ami CRITICAL memória-nyomásnál (`shouldShedLoad()`) az új, nem-esszenciális
-     * kéréseket gyors **503**-mal ejti — a GC levegőhöz jut, a death-spiral megelőzhető. Default: false
-     * (opt-in — a 503-viselkedés ops-döntés; a `shouldShedLoad()` primitív enélkül is hívható kézzel).
-     */
-    loadShedEnabled?: boolean;
-    /**
-     * Path-részek, amikre a load-shed SOSEM vonatkozik (`req.path.includes(part)` match) — az
-     * esszenciális útvonalak (healthcheck/readiness/diag) 503-a ÖNGÓL lenne (a restart-policy
-     * health-probe-ját ölné meg). Default: `['/health', '/readiness', '/status', '/diag']`.
-     */
-    loadShedExemptPathParts?: string[];
-    /**
-     * **Boot-grace ms** az `exitOnSustainedCritical`-hez: a guard-install UTÁNI első ennyi ms-ben a sustained-critical
-     * NEM lép ki (csak logol + load-shed). A nehéz-boot appok (nagy in-memory pool-hidratálás) ELEVE GC-thrash-elnek a
-     * boot alatt → e nélkül a sustained-exit boot-loop-ot okozna. A grace UTÁN a tartós critical normálisan kilép (a
-     * VALÓDI futásidejű OOM-ot kezeli). Default: 60000 (60s). 0 → nincs grace (azonnal élesedik).
-     */
-    bootGraceMs?: number;
-  };
-
-  /**
-   * Event-loop-lag + connection diagnosztika (BFR-OVERSEER-007) — a „process él, HTTP néma" wedge
-   * belső mérése (`perf_hooks.monitorEventLoopDelay` natív histogram + aktív-handle count, ring-buffer).
-   * A `GET /server/diag` endpoint innen olvas. A MemoryGuard MELLÉ illeszkedik (memória ↔ loop-lag).
-   */
-  eventLoopDiag?: {
-    /** Bekapcsolja a diag-mérést (a base App startup telepíti). Default: true (a mérés olcsó). */
-    enabled: boolean;
-    /** Mintavételi intervallum ms-ben. Default: 5000. */
-    pollIntervalMs?: number;
-    /** Megőrzött minták max száma (ring-buffer; 120 × 5s = 10 perc). Default: 120. */
-    maxHistoryCount?: number;
-  };
-
-  /**
-   * FR-258 / SR-4 — proactive collection-growth monitor (companion to {@link memoryGuard}). Samples
-   * each registered collection's document count (scan-free `estimatedDocumentCount`) on a slow
-   * cadence and raises a warning into the Errors-sink BEFORE an unbounded collection can be loaded
-   * into heap and OOM. Observation only — never deletes (retention SR-1/SR-2 does the deleting).
-   */
-  collectionGrowthMonitor?: {
-    /** Bekapcsolja a monitort (a base App startup feltelepíti). Default: true. */
-    enabled: boolean;
-    /** Poll-intervallum ms-ben. Default: 300000 (5 min). */
-    pollIntervalMs?: number;
-    /** Warning, ha egy collection doc-száma ezt meghaladja. Default: 250000. */
-    sizeThresholdDocCount?: number;
-    /** Warning, ha egy collection az előző poll óta ennél többel nőtt (%). Default: 50. */
-    growthRateThresholdPct?: number;
-    /** Re-alert cooldown collection-önként + alert-típusonként, ms (anti-flood). Default: 3600000 (1 h). */
-    reAlertCooldownMs?: number;
-  };
-
-  /**
-   * BFR-MASTERPROMPTER-015 (MP-19) — test-email SINK. Ha a környezet local/test ÉS a címzett(ek)
-   * a teszt-cím-mintára matchelnek, a `DyNTS_EmailService.sendEmail` a küldést SMTP helyett a
-   * `dynts_sent_test_mails` kollekcióba teríti (olvasás: `DyNTS_getSentMailRoutingModule`).
-   * Prod/dev környezetben a sink HARD-gate-elt: `enabled: true` sem kapcsolja be (fail-closed).
-   */
-  testEmailSink?: {
-    /** Kikapcsolás local/test-en (default: aktív local/test-en). Prod-on hatástalan. */
-    enabled?: boolean;
-    /** Cím-minta override (default: `DyNTS_testEmailPattern` = *@e2e.test.futdevpro.local). */
-    pattern?: RegExp;
-    /** A sink-elt emailek TTL-je órában (default: 24). */
-    ttlHours?: number;
-  };
-}

package/src/_models/interfaces/migration-entry.interface.ts

@@ -1,19 +0,0 @@
-/**
- * Egy regisztrált deploy-integrált migráció leírója. Az app egy `DyNTS_MigrationEntry[]` registry-t
- * ad át a `DyNTS_Migration_Runner.runPending(...)`-nek; a runner a pending (még nem alkalmazott)
- * entry-ket **egyszer** futtatja le, sorrendben, majd a `DyNTS_SchemaMigration` ledgerbe rögzíti.
- */
-export interface DyNTS_MigrationEntry {
-  /** Egyedi, monoton bővíthető ID (konvenció: `YYYY-MM-DD-NNN-descriptor`). A ledger ez alapján run-once-ol. */
-  id: string;
-
-  /** Rövid leíró (admin/debug/log). */
-  description: string;
-
-  /**
-   * A tényleges migráció-logika. Az app már-csatlakozott Mongo-kapcsolatát használja (a runner a
-   * `postProcess`-ből fut, ahol a DB már él). Hibára DOBHAT — a runner catch-eli, a `notes`-ba menti,
-   * és NEM állítja meg a boot-ot. Visszaad: `{ touched }` (a módosított dokumentumok száma — count/riport).
-   */
-  run: (issuer: string) => Promise<{ touched: number }>;
-}

package/src/_models/interfaces/mongo-transaction-settings.interface.ts

@@ -1,9 +0,0 @@
-import { ClientSession } from 'mongoose';
-
-/** One atomic Mongo transaction request with content-free diagnostic identity. */
-export interface DyNTS_MongoTransaction_Settings<T> {
-  transactionName: string;
-  issuer: string;
-  maxCommitTimeMs?: number;
-  task: (session: ClientSession) => Promise<T>;
-}

package/src/_models/interfaces/routing-module-settings.interface.ts

@@ -1,21 +0,0 @@
-import { DyNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { DyNTS_Controller } from '../../_services/route/controller.service';
-
-
-/**
- * This is a main route point handler, which collects a list of controllers for the API
- */
-export interface DyNTS_RoutingModule_Settings {
-  /**
-   * main route of the module
-   */
-  route: string;
-  /**
-   * the collection of controllers (sub-routes, with differentlogical parts, to different db elements)
-   */
-  controllers: DyNTS_Controller[];
-  /**
-   * securityOverride will be used to create different security for a single module without changing the default security (http/https/both)
-   */
-  securityOverride?: DyNTS_RouteSecurity;
-}

package/src/_models/interfaces/security-headers-settings.interface.ts

@@ -1,50 +0,0 @@
-/**
- * `DyNTS_SecurityHeaders_Settings` — a bedrock security response-header middleware beállításai
- * (BFR-MASTERPROMPTER-011 / SEC-R2-8). A middleware minden `DyNTS_App`-leszármazott open+secure
- * Express-én, a CORS-mount ELŐTT fut (így az OPTIONS preflight-válaszok is megkapják a headereket).
- *
- * **Default-ON, safe-by-default**: zéró-konfiggal a bizonyítottan nem-törő készlet megy ki
- * (x-powered-by removal + X-Frame-Options + nosniff + Referrer-Policy). A HSTS auto-env-gated
- * (csak prod), a CSP opt-in (app-specifikus). Bármely header `false`-szal kikapcsolható;
- * `enabled: false` = teljes opt-out.
- */
-export interface DyNTS_SecurityHeaders_Settings {
-  /** Fő kapcsoló. Default: true (a middleware minden szerveren aktív). */
-  enabled: boolean;
-
-  /** `app.disable('x-powered-by')` — Express tech-leak eltávolítás. Default: true. */
-  removePoweredBy?: boolean;
-
-  /** `X-Frame-Options` értéke, vagy `false` a kihagyáshoz. Default: 'SAMEORIGIN'. */
-  frameOptions?: string | false;
-
-  /** `X-Content-Type-Options` értéke, vagy `false`. Default: 'nosniff'. */
-  contentTypeOptions?: string | false;
-
-  /** `Referrer-Policy` értéke, vagy `false`. Default: 'strict-origin-when-cross-origin'. */
-  referrerPolicy?: string | false;
-
-  /** `Permissions-Policy` értéke, vagy `false`. Default: false (opt-in — app-specifikus). */
-  permissionsPolicy?: string | false;
-
-  /**
-   * HSTS (`Strict-Transport-Security`). Default: AUTO — CSAK prod environment-en emittál
-   * (`max-age=15768000; includeSubDomains`); a test-en a sticky-HSTS strukturálisan elkerülve.
-   * Explicit `{ enabled: true }` bármely env-en bekapcsolja; `false` mindenhol kikapcsolja.
-   */
-  hsts?: {
-    enabled?: boolean;
-    maxAgeSeconds?: number;
-    includeSubDomains?: boolean;
-    preload?: boolean;
-  } | false;
-
-  /** `Content-Security-Policy` string, vagy `false`. Default: false (app-specifikus, OPT-IN). */
-  csp?: string | false;
-
-  /** Ha true, a CSP a `Content-Security-Policy-Report-Only` header-névvel megy ki (rollout-segéd). */
-  cspReportOnly?: boolean;
-
-  /** További tetszőleges fix headerek (merge a resolvelt készletre). */
-  additionalHeaders?: Record<string, string>;
-}

package/src/_models/interfaces/signed-url-verify-result.interface.ts

@@ -1,13 +0,0 @@
-/**
- * Az aláírt-URL ellenőrzés (`DyNTS_SignedUrl_Util.verify`) strukturált eredménye.
- *
- * ⚠️ A `reason` **logba** való — a HTTP-válaszba **NEM** szivárogtatható: az elutasítás oka
- * támadónak információ *(pl. „expired" vs. „signature-mismatch" megkülönböztetése)*.
- *
- * ⭐ **Miért strukturált eredmény és nem kivétel:** a `verify` SOHA nem dob, hogy a hívó gate-ek
- * egységes, szivárgás-mentes választ tudjanak adni — a `reason` a **belső** diagnosztika.
- */
-export interface DyNTS_SignedUrl_VerifyResult {
-  valid: boolean;
-  reason?: 'missing-secret' | 'missing-params' | 'expired' | 'signature-mismatch';
-}

package/src/_models/interfaces/static-client-settings.interface.spec.ts

@@ -1,29 +0,0 @@
-import { DyNTS_StaticClient_Settings } from './static-client-settings.interface';
-
-describe('| DyNTS_StaticClient_Settings', () => {
-  it('| should allow minimal settings with only root', () => {
-    const s: DyNTS_StaticClient_Settings = { root: '/dist' };
-    expect(s.root).toBe('/dist');
-    expect(s.fallbackPath).toBeUndefined();
-  });
-
-  it('| should allow optional fallbackPath', () => {
-    const s: DyNTS_StaticClient_Settings = {
-      root: '/dist',
-      fallbackPath: 'index.html',
-    };
-    expect(s.fallbackPath).toBe('index.html');
-  });
-
-  it('| should allow SPA cache options', () => {
-    const s: DyNTS_StaticClient_Settings = {
-      root: '/dist',
-      assetCacheMaxAge: 31536000,
-      assetCacheImmutable: true,
-      fallbackCacheMaxAge: 0,
-    };
-    expect(s.assetCacheMaxAge).toBe(31536000);
-    expect(s.assetCacheImmutable).toBe(true);
-    expect(s.fallbackCacheMaxAge).toBe(0);
-  });
-});

package/src/_models/interfaces/static-client-settings.interface.ts

@@ -1,36 +0,0 @@
-/**
- * Beállítások a client static fájlok kiszolgálásához (pl. SPA) a '/' path alatt.
- * Ha megadva, a getStaticClientSettings() által visszaadott értéket a base app
- * a mountStaticClient() során használja (API route-ok után).
- * A cache mezők SPA (pl. Angular) optimalizáláshoz opcionálisak; ha nincs kitöltve,
- * viselkedés változatlan (alkalmas nem-SPA kiszolgálásra is).
- */
-export interface DyNTS_StaticClient_Settings {
-  /** A static fájlok könyvtárának path-ja (abszolút vagy process.cwd()-hez képest). */
-  root: string;
-  /** SPA fallback: ha a kérés nem egy fájlra mutat, ezt a fájlt szolgáljuk ki (pl. 'index.html'). */
-  fallbackPath?: string;
-  /**
-   * Static asset-ek (pl. JS, CSS) Cache-Control max-age másodpercben.
-   * SPA (Angular) hashed fájloknál pl. 1 év (31536000).
-   */
-  assetCacheMaxAge?: number;
-  /**
-   * Ha true és assetCacheMaxAge is megadva, Cache-Control-hoz hozzáadódik az immutable direktíva
-   * (Angular hashed fájlokra ideális).
-   */
-  assetCacheImmutable?: boolean;
-  /**
-   * Fallback (pl. index.html) Cache-Control max-age másodpercben.
-   * SPA esetén ajánlott 0, hogy a böngésző ne cache-elje az index.html-t (deploy után friss).
-   */
-  fallbackCacheMaxAge?: number;
-  /**
-   * API-namespace prefixek, amikre a SPA-fallback NEM vonatkozik (BFR-DYNAMOBUILDER-001):
-   * egy ismeretlen `GET /api/...` így 404 JSON-t kap a megtévesztő `200 + index.html` helyett
-   * (a SPA-fallback catch-all eddig az API-namespace-t is fedte). Default:
-   * `['/api', '/auth-api']` — felülírható/üríthető, ha az app más namespace-t használ,
-   * vagy szándékosan SPA-route-ol API-szerű path alatt.
-   */
-  fallbackExcludePrefixes?: string[];
-}

package/src/_models/types/db-update.type.ts

@@ -1,100 +0,0 @@
-
-/**
- * @param update this uses the basic Mongoose updateOne
- * @example
- * // increase a specific value (here by 15): 
- * { $inc: { popularity: 15 } }
- * //
- * @example 
- * // or add element to a list:
- * { $push: { reactions: this.newReaction }
- * // or add multiple elements to a list
- * { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
- * //
- * @example 
- * // or all at once 
- * {  
- *   $inc: { popularity: this.newVote.amount }, 
- *   emailVerified: true, 
- *   $push: { reactions: this.newReaction } 
- * }
- * // further tools (syntax matches with $inc):
- * $currentDate: // Sets the value of a field to current date, either as a Date or a Timestamp.
- * $min:         // Only updates the field if the specified value is less than the existing field value.
- * $max:         // Only updates the field if the specified value is greater than the existing field value.
- * $mul:         // Multiplies the value of the field by the specified amount.
- * $rename:      // Renames a field.
- * $unset:       // Removes the specified field from a document. (set: "" to value)
- * //
- */
-export type DyNTS_DBUpdate<T> = {
-  /**
-   * Sets the value of a field to current date, either as a Date or a Timestamp.
-   */
-  /* $currentDate?: { [K in keyof T]?: boolean }; */
-  /**
-   * Increments the value of the field by the specified amount.
-   */
-  $inc?: { [K in keyof T]?: number };
-  /**
-   * Only updates the field if the specified value is less than the existing field value.
-   */
-  $min?: { [K in keyof T]?: number };
-  /**
-   * Only updates the field if the specified value is greater than the existing field value.
-   */
-  $max?: { [K in keyof T]?: number };
-  /**
-   * Multiplies the value of the field by the specified amount.
-   */
-  $mul?: { [K in keyof T]?: number };
-  /**
-   * Renames a field.
-   */
-  $rename?: { [K in keyof T]?: string };
-  /**
-   * Removes the specified field from a document. (set: "" to value)
-   */
-  $unset?: { [K in keyof T]?: string };
-  /**
-   * Sets the value of a field in a document.
-   */
-  $set?: { [K in keyof T]?: string } | any;
-  /**
-   * Sets the value of a field if an update results in an insert of a document. 
-   * Has no effect on update operations that modify existing documents.
-   */
-  $setOnInsert?: { [K in keyof T]?: T[K] };
-  /**
-   * Removes the first or last item of an array.
-   */
-
-  // array only operations
-  /**
-   * Removes the first or last item of an array.
-   */
-  $push?: { [K in keyof T]?: any | { $each?: T[K] } };
-  /**
-   * Removes the first or last item of an array.
-   */
-  $addToSet?: { [K in keyof T]?: any | { $each?: T[K] } };
-  /**
-   * Removes the first or last item of an array.
-   */
-  $pop?: { [K in keyof T]?: 1 | -1 };
-  /**
-   * Removes all array elements that match a specified query.
-   */
-  $pull?: { [K in keyof T]?: any | { $each?: T[K] } };
-  /**
-   * Removes all array elements that match a specified query.
-   */
-  $pullAll?: { [K in keyof T]?: any | { $each?: T[K] } };
-} & DyNTS_DBSimpleUpdate<T>;
-
-/**
- * 
- */
-export type DyNTS_DBSimpleUpdate<T> = {
-  [K in keyof T]?: T[K];
-};

package/src/_modules/account-security/_enums/account-challenge-purpose.type-enum.ts

@@ -1,5 +0,0 @@
-/** Supported one-time account challenge purposes. */
-export enum DyNTS_AccountChallengePurpose_Type {
-  emailVerification = 'email-verification',
-  passwordReset = 'password-reset',
-}

package/src/_modules/account-security/_enums/account-refresh-token-state.type-enum.ts

@@ -1,6 +0,0 @@
-/** One-time refresh-token ledger states. */
-export enum DyNTS_AccountRefreshTokenState_Type {
-  active = 'active',
-  used = 'used',
-  revoked = 'revoked',
-}

package/src/_modules/account-security/_enums/account-session-state.type-enum.ts

@@ -1,6 +0,0 @@
-/** Persisted standalone account-session states. */
-export enum DyNTS_AccountSessionState_Type {
-  active = 'active',
-  revoked = 'revoked',
-  expired = 'expired',
-}

package/src/_modules/account-security/_models/account-challenge-adapter.interface.ts

@@ -1,17 +0,0 @@
-import { DyNTS_AccountChallengePurpose_Type } from '../_enums/account-challenge-purpose.type-enum';
-import { DyNTS_AccountChallengeRecord_Interface } from './account-challenge-record.interface';
-
-/** Atomic persistence contract for replacing and consuming one-time account challenges. */
-export interface DyNTS_AccountChallengeAdapter_Interface {
-  replaceActiveChallenge(record: DyNTS_AccountChallengeRecord_Interface): Promise<void>;
-  consumeActiveChallenge(
-    tokenHash: string,
-    purpose: DyNTS_AccountChallengePurpose_Type,
-    consumedAt: string
-  ): Promise<DyNTS_AccountChallengeRecord_Interface | null>;
-  revokeSubjectChallenges(
-    subjectId: string,
-    purpose: DyNTS_AccountChallengePurpose_Type,
-    revokedAt: string
-  ): Promise<void>;
-}

package/src/_modules/account-security/_models/account-challenge-issued.interface.ts

@@ -1,6 +0,0 @@
-/** Raw one-time challenge returned once after its hash is persisted. */
-export interface DyNTS_AccountChallengeIssued_Interface {
-  challengeId: string;
-  token: string;
-  expiresAt: string;
-}

package/src/_modules/account-security/_models/account-challenge-record.interface.ts

@@ -1,13 +0,0 @@
-import { DyNTS_AccountChallengePurpose_Type } from '../_enums/account-challenge-purpose.type-enum';
-
-/** Server-only one-time account challenge record containing a credential hash only. */
-export interface DyNTS_AccountChallengeRecord_Interface {
-  challengeId: string;
-  subjectId: string;
-  purpose: DyNTS_AccountChallengePurpose_Type;
-  tokenHash: string;
-  createdAt: string;
-  expiresAt: string;
-  consumedAt: string;
-  revokedAt: string;
-}

package/src/_modules/account-security/_models/account-challenge-result.interface.ts

@@ -1,8 +0,0 @@
-import { DyNTS_AccountChallengePurpose_Type } from '../_enums/account-challenge-purpose.type-enum';
-
-/** Trusted identity binding returned after an atomic one-time challenge consumption. */
-export interface DyNTS_AccountChallengeResult_Interface {
-  challengeId: string;
-  subjectId: string;
-  purpose: DyNTS_AccountChallengePurpose_Type;
-}

package/src/_modules/account-security/_models/account-challenge-settings.interface.ts

@@ -1,9 +0,0 @@
-import { DyNTS_AccountChallengeAdapter_Interface } from './account-challenge-adapter.interface';
-
-/** Runtime settings for one-time account challenges. */
-export interface DyNTS_AccountChallengeSettings_Interface {
-  adapter: DyNTS_AccountChallengeAdapter_Interface;
-  ttlMs?: number;
-  tokenBytes?: number;
-  clock?: () => Date;
-}