@futdevpro/nts-dynamo 1.15.155 → 1.15.156

package/README.md

@@ -28,7 +28,7 @@ Dynamo-NTS simplifies complex system definitions by abstracting common backend i
 - **Axios Usage**: HTTP client requests to external APIs are standardized through `DyNTS_ApiService` with `DyNTS_ApiCall_Params` configuration (simplifies Axios request setup, error handling, and response management)
 - **Discord.js / Slack / Teams Bot Development**: Platform-agnostic bot framework through `DyNTS_Bot_MessagingProvider_ServiceBase` and bot modules (simplifies Discord.js, Slack, and Teams bot development with unified interfaces)
 - **OpenAI / AI Provider Integration**: AI/LLM operations including chat, embeddings, and vector search are abstracted through `DyNTS_AI_Provider_ServiceBase` and provider implementations (simplifies OpenAI SDK usage and enables multi-provider architecture)
-- **Location Tracking**: Optional, local-only IP geolocation through `geoip-lite`; addresses are not sent to an external service or written to logs by Dynamo-NTS
+- **Location Tracking**: Optional, local-only IP geolocation through `geoip-lite`; addresses are not sent to an external service or written to logs by Dynamo-NTS
 
 This parameterization approach eliminates boilerplate code and provides a consistent, type-safe interface for all backend operations. Instead of learning multiple library APIs and their configuration patterns, developers work with unified Dynamo-NTS parameter objects that handle the underlying complexity.
 
@@ -98,13 +98,13 @@ These dependencies are only required when using specific modules:
 
 - **Socket Module**: `socket.io` - Real-time communication (simplified through Dynamo-NTS socket services)
 - **Email Service**: `nodemailer` - Email sending (simplified through Dynamo-NTS email services)
-- **Usage Module**: `geoip-lite` and `@types/geoip-lite` - optional, local-only IP geolocation. The provider is loaded only when a lookup is requested. Without it, lookup methods return `null` and the rest of Dynamo-NTS remains usable. The supported secure `geoip-lite` line requires Node.js 24 or newer.
-- **Bot Module (Discord)**: `discord.js` - Discord bot development (simplified through Dynamo-NTS bot module)
-- **AI Module (OpenAI)**: `openai` - OpenAI API integration (simplified through Dynamo-NTS AI module)
-
-The GeoIP lookup itself does not transmit or log an address. Calling the Usage module can persist the
-request address and derived location in the consumer's own data store. Consumers enabling that capability
-must define the applicable lawful basis, user-facing transparency, access controls, retention and deletion.
+- **Usage Module**: `geoip-lite` and `@types/geoip-lite` - optional, local-only IP geolocation. The provider is loaded only when a lookup is requested. Without it, lookup methods return `null` and the rest of Dynamo-NTS remains usable. The supported secure `geoip-lite` line requires Node.js 24 or newer.
+- **Bot Module (Discord)**: `discord.js` - Discord bot development (simplified through Dynamo-NTS bot module)
+- **AI Module (OpenAI)**: `openai` - OpenAI API integration (simplified through Dynamo-NTS AI module)
+
+The GeoIP lookup itself does not transmit or log an address. Calling the Usage module can persist the
+request address and derived location in the consumer's own data store. Consumers enabling that capability
+must define the applicable lawful basis, user-facing transparency, access controls, retention and deletion.
 
 Install module-specific dependencies as needed:
 
@@ -115,8 +115,8 @@ pnpm add socket.io
 # For Email service
 pnpm add nodemailer
 
-# For Usage module
-pnpm add geoip-lite@^2.0.3 @types/geoip-lite@^1.4.4
+# For Usage module
+pnpm add geoip-lite@^2.0.3 @types/geoip-lite@^1.4.4
 
 # For Bot module (Discord)
 pnpm add discord.js

package/__documentations/2026-08-22-bfr-ctm-018-content-free-endpoint-errors.md

@@ -0,0 +1,54 @@
+# BFR-CTM-018 — content-free endpoint error boundary
+
+**Date:** 2026-08-22
+**Status:** implemented and package-verified; consumer adoption is recorded by the requesting project
+**Target:** `@futdevpro/nts-dynamo`
+**Contract:** `dynts-safe-diagnostic/1`
+
+## Measured defect
+
+The shared `DyNTS_Endpoint_Params` error path constructed framework logs from route identity, path parameter
+values, raw `Error.message`, stack location and a request snapshot. The snapshot included URL, query, request
+metadata, header keys, IP address and an authorization-header shape. A plain error and a consumer global-handler
+rejection were also passed directly to Dynamo loggers. The primary raw log was unconditional, so disabling
+application API-error logging did not close the disclosure path.
+
+The same execution function declared a second local `issuer` variable inside the request callback. It shadowed
+the issuer captured by the error path, so a failing endpoint forwarded `undefined` rather than the resolved
+account identity to the consumer global handler.
+
+## Implemented Bedrock response
+
+- Added the closed `endpoint` safe-diagnostic stage.
+- Projected constructor, issuer-resolution, task/pre-process, consumer-handler, secondary-handler and circulation
+  failures through `DyNTS_SafeDiagnostic_ControlService`.
+- Removed framework-owned raw message, stack, route, request and response-preview logging from endpoint failures.
+- Removed mutation of caller errors with `endpointInfo` and `requestDebug` snapshots.
+- Wrapped plain failures with a static internal message and the immutable safe diagnostic while retaining the
+  existing public endpoint error-code shape and validated HTTP status behavior.
+- Sanitized and bounded developer-owned system and endpoint identifiers used in the compatibility error code.
+- Preserved raw failure/request access only for the explicitly installed application global handler; a rejection
+  from that handler is itself projected before logging.
+- Removed the issuer shadow so the resolved account identity reaches the application-owned error persistence
+  boundary.
+
+Normal successful-request logging is outside this change. Its existing request-param, body and response fields
+remain explicit caller-controlled options. This BFR makes the error path content-free regardless of those options
+or detailed logging mode.
+
+## Verification evidence
+
+- TypeScript production build: passed.
+- Focused BFR canary regression: 1/1 passed.
+- Full Jasmine package regression: 1750 specs, 0 failures, 146 explicit pending specs.
+- Package ESLint: 0 errors; the repository retains its pre-existing warning baseline.
+- Canary matrix: raw error message, secondary handler stack/token, workbook/sheet value, URL, query, header,
+  authorization value and path parameter are absent from every captured Dynamo logger call and from the client
+  response. The 503 status, safe diagnostic and resolved issuer are asserted.
+- Import validator baseline: 80 findings in 74 pre-existing files; the modified endpoint and safe-diagnostic files
+  introduce no import finding.
+- Naming validator baseline: 100 findings in 67 pre-existing files. The endpoint class carries its existing public
+  naming findings; this compatible security fix does not rename that public API.
+
+The validator baselines are reported as measured debt, not as green evidence. No unrelated mass rename or import
+rewrite is bundled into this security BFR.

package/__documentations/2026-08-22-content-free-process-error-boundary.md

@@ -54,9 +54,28 @@ MongoDB connection success logs only the stable fact that MongoDB is connected.
 initial connection failure and runtime connection failure do not interpolate the URI. The URI remains an input
 to Mongoose because it is operationally required, but it is not a diagnostic value.
 
-The default `DyNTS_GlobalService` handler also projects a raw failure before logging. A consumer-supplied global
-handler remains a consumer boundary; failures forwarded by `DyNTS_App` reach it as a content-free `DyFM_Error`.
-If that handler throws or rejects, Dynamo-NTS projects the secondary failure rather than recursively logging it.
+The default `DyNTS_GlobalService` handler also projects a raw failure before logging. A consumer-supplied global
+handler remains a consumer boundary; failures forwarded by `DyNTS_App` reach it as a content-free `DyFM_Error`.
+If that handler throws or rejects, Dynamo-NTS projects the secondary failure rather than recursively logging it.
+
+## Endpoint error integration
+
+`DyNTS_Endpoint_Params` applies the same projection at every framework-owned endpoint failure boundary. The
+primary task or pre-process failure, issuer-resolution failure, consumer global-handler rejection, secondary
+error-handler failure and circulation-resolution failure are classified with stable uppercase codes and the
+closed `endpoint` stage. Detailed logging mode does not bypass this projection.
+
+The endpoint boundary does not append route values, path parameters, URL, query, request body, headers, auth
+header shape, error message, stack or nested error content to logs or `additionalContent`. A plain native failure
+is converted to a client-safe `DyFM_Error` with a static internal message, the established
+`<SYSTEM>|DyNTS-EPP-<endpointName>` public code shape and the projected diagnostic. Developer-owned system and
+endpoint code parts are bounded and reduced to the established identifier alphabet. Conventional numeric HTTP
+status fields remain supported without inspecting message or stack.
+
+The raw failure and request remain available to the explicitly installed consumer global handler because that
+handler is the application-owned persistence boundary. If it rejects, the rejection is projected before any
+framework log. The resolved issuer is now carried through the error path rather than being shadowed by a local
+variable, so account-level attribution remains intact.
 
 ## Security and privacy properties
 
@@ -79,9 +98,10 @@ If that handler throws or rejects, Dynamo-NTS projects the secondary failure rat
 | Process-boundary runtime test | Unhandled rejection is projected before both logging and global-handler forwarding. |
 | Bootstrap runtime test | Rejected construction is projected before logging/forwarding and terminates with exit code 1. |
 | Default-handler runtime test | Raw input is projected before default global logging. |
-| App-params test | A malformed credential-bearing MongoDB URI triggers a warning without exposing the URI. |
-| Static source scan | No Dynamo-NTS App log call receives raw error, stack, promise, construct-error collection or DB URI. |
-| Full package regression | Build, complete Jasmine suite and project validators remain green. |
+| App-params test | A malformed credential-bearing MongoDB URI triggers a warning without exposing the URI. |
+| Endpoint runtime test | Error, handler, token, workbook, URL, query, header and path canaries are absent from every endpoint log and client response. |
+| Static source scan | No Dynamo-NTS App log call receives raw error, stack, promise, construct-error collection or DB URI. |
+| Full package regression | Build and complete Jasmine suite remain green; validator findings are measured and reported, never hidden. |
 
 ## Consumer adoption requirement
 

package/build/_collections/app-version-header.util.d.ts

@@ -1,42 +1,42 @@
-import * as Express from 'express';
-/**
- * FR-292 (2026-08-08) — a DEPLOYOLT app-verzió kiírása MINDEN válasz headerébe.
- *
- * **Miért kell:** a böngészőben nyitva hagyott SPA a memóriájában tartja a bundle-t, és a
- * deploy után is a RÉGI kódot futtatja, amíg a felhasználó újra nem tölt. Ez nem elméleti:
- * egy órákig nyitva hagyott dashboard-fülön hiányzó gombokat / régi viselkedést mutat, és
- * a felhasználó (jogosan) azt hiszi, hogy a funkció nincs kész.
- *
- * Az itteni megoldás **nem polling**: a szerver minden válaszra ráteszi a saját deployolt
- * app-verzióját, a kliens pedig a MÁR MEGLÉVŐ hívásaiból olvassa ki (ngx oldalon a
- * `DyNX_AppVersion_Interceptor`). Nulla extra kérés, nulla extra terhelés — a jelzés
- * „ingyen" utazik azon, ami úgyis megy.
- *
- * **CORS:** cross-origin kliens csak akkor OLVASHATJA a headert, ha az szerepel az
- * `Access-Control-Expose-Headers`-ben. Ezért a middleware a meglévő értékhez HOZZÁFŰZ
- * (nem felülír) — ezért kell a CORS-mount UTÁN felszerelni.
- */
-/** A deployolt app-verziót hordozó response-header neve (a kliens ezt olvassa). */
-export declare const DYNTS_APP_VERSION_HEADER: string;
-/**
- * Kiszámolja az `Access-Control-Expose-Headers` ÚJ értékét úgy, hogy a meglévő listát
- * megtartja és a verzió-headert csak akkor fűzi hozzá, ha még nincs benne (idempotens).
- *
- * Tiszta függvény: Express nélkül unit-tesztelhető.
- *
- * @param currentValue a válaszon MÁR beállított érték (a CORS-middleware-től), ha van
- * @param headerName a hozzáfűzendő header neve
- */
-export declare function DyNTS_resolveExposeHeaders(currentValue: string | undefined, headerName: string): string;
-/**
- * Express-middleware, ami minden válaszra ráteszi a deployolt app-verziót.
- *
- * A verziót FÜGGVÉNYKÉNT kapja (nem értékként), mert a `DyNTS_global_settings.systemVersion`
- * az app-params betöltésekor áll be — egy induláskor kiolvasott érték `unknown-version`
- * maradhatna örökre.
- *
- * @param getAppVersion a deployolt app-verziót visszaadó getter
- * @param headerName felülírható header-név (default: `X-App-Version`)
- */
-export declare function DyNTS_createAppVersionHeaderMiddleware(getAppVersion: () => string | undefined, headerName?: string): Express.RequestHandler;
+import * as Express from 'express';
+/**
+ * FR-292 (2026-08-08) — a DEPLOYOLT app-verzió kiírása MINDEN válasz headerébe.
+ *
+ * **Miért kell:** a böngészőben nyitva hagyott SPA a memóriájában tartja a bundle-t, és a
+ * deploy után is a RÉGI kódot futtatja, amíg a felhasználó újra nem tölt. Ez nem elméleti:
+ * egy órákig nyitva hagyott dashboard-fülön hiányzó gombokat / régi viselkedést mutat, és
+ * a felhasználó (jogosan) azt hiszi, hogy a funkció nincs kész.
+ *
+ * Az itteni megoldás **nem polling**: a szerver minden válaszra ráteszi a saját deployolt
+ * app-verzióját, a kliens pedig a MÁR MEGLÉVŐ hívásaiból olvassa ki (ngx oldalon a
+ * `DyNX_AppVersion_Interceptor`). Nulla extra kérés, nulla extra terhelés — a jelzés
+ * „ingyen" utazik azon, ami úgyis megy.
+ *
+ * **CORS:** cross-origin kliens csak akkor OLVASHATJA a headert, ha az szerepel az
+ * `Access-Control-Expose-Headers`-ben. Ezért a middleware a meglévő értékhez HOZZÁFŰZ
+ * (nem felülír) — ezért kell a CORS-mount UTÁN felszerelni.
+ */
+/** A deployolt app-verziót hordozó response-header neve (a kliens ezt olvassa). */
+export declare const DYNTS_APP_VERSION_HEADER: string;
+/**
+ * Kiszámolja az `Access-Control-Expose-Headers` ÚJ értékét úgy, hogy a meglévő listát
+ * megtartja és a verzió-headert csak akkor fűzi hozzá, ha még nincs benne (idempotens).
+ *
+ * Tiszta függvény: Express nélkül unit-tesztelhető.
+ *
+ * @param currentValue a válaszon MÁR beállított érték (a CORS-middleware-től), ha van
+ * @param headerName a hozzáfűzendő header neve
+ */
+export declare function DyNTS_resolveExposeHeaders(currentValue: string | undefined, headerName: string): string;
+/**
+ * Express-middleware, ami minden válaszra ráteszi a deployolt app-verziót.
+ *
+ * A verziót FÜGGVÉNYKÉNT kapja (nem értékként), mert a `DyNTS_global_settings.systemVersion`
+ * az app-params betöltésekor áll be — egy induláskor kiolvasott érték `unknown-version`
+ * maradhatna örökre.
+ *
+ * @param getAppVersion a deployolt app-verziót visszaadó getter
+ * @param headerName felülírható header-név (default: `X-App-Version`)
+ */
+export declare function DyNTS_createAppVersionHeaderMiddleware(getAppVersion: () => string | undefined, headerName?: string): Express.RequestHandler;
 //# sourceMappingURL=app-version-header.util.d.ts.map

package/build/_collections/app-version-header.util.js

@@ -1,67 +1,67 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DYNTS_APP_VERSION_HEADER = void 0;
-exports.DyNTS_resolveExposeHeaders = DyNTS_resolveExposeHeaders;
-exports.DyNTS_createAppVersionHeaderMiddleware = DyNTS_createAppVersionHeaderMiddleware;
-/**
- * FR-292 (2026-08-08) — a DEPLOYOLT app-verzió kiírása MINDEN válasz headerébe.
- *
- * **Miért kell:** a böngészőben nyitva hagyott SPA a memóriájában tartja a bundle-t, és a
- * deploy után is a RÉGI kódot futtatja, amíg a felhasználó újra nem tölt. Ez nem elméleti:
- * egy órákig nyitva hagyott dashboard-fülön hiányzó gombokat / régi viselkedést mutat, és
- * a felhasználó (jogosan) azt hiszi, hogy a funkció nincs kész.
- *
- * Az itteni megoldás **nem polling**: a szerver minden válaszra ráteszi a saját deployolt
- * app-verzióját, a kliens pedig a MÁR MEGLÉVŐ hívásaiból olvassa ki (ngx oldalon a
- * `DyNX_AppVersion_Interceptor`). Nulla extra kérés, nulla extra terhelés — a jelzés
- * „ingyen" utazik azon, ami úgyis megy.
- *
- * **CORS:** cross-origin kliens csak akkor OLVASHATJA a headert, ha az szerepel az
- * `Access-Control-Expose-Headers`-ben. Ezért a middleware a meglévő értékhez HOZZÁFŰZ
- * (nem felülír) — ezért kell a CORS-mount UTÁN felszerelni.
- */
-/** A deployolt app-verziót hordozó response-header neve (a kliens ezt olvassa). */
-exports.DYNTS_APP_VERSION_HEADER = 'X-App-Version';
-/** Az `Access-Control-Expose-Headers` header neve — hogy ne szórjuk el string-literálként. */
-const EXPOSE_HEADERS_HEADER = 'Access-Control-Expose-Headers';
-/**
- * Kiszámolja az `Access-Control-Expose-Headers` ÚJ értékét úgy, hogy a meglévő listát
- * megtartja és a verzió-headert csak akkor fűzi hozzá, ha még nincs benne (idempotens).
- *
- * Tiszta függvény: Express nélkül unit-tesztelhető.
- *
- * @param currentValue a válaszon MÁR beállított érték (a CORS-middleware-től), ha van
- * @param headerName a hozzáfűzendő header neve
- */
-function DyNTS_resolveExposeHeaders(currentValue, headerName) {
-    if (!currentValue) {
-        return headerName;
-    }
-    const alreadyExposed = currentValue
-        .split(',')
-        .some((entry) => entry.trim().toLowerCase() === headerName.toLowerCase());
-    return alreadyExposed ? currentValue : `${currentValue}, ${headerName}`;
-}
-/**
- * Express-middleware, ami minden válaszra ráteszi a deployolt app-verziót.
- *
- * A verziót FÜGGVÉNYKÉNT kapja (nem értékként), mert a `DyNTS_global_settings.systemVersion`
- * az app-params betöltésekor áll be — egy induláskor kiolvasott érték `unknown-version`
- * maradhatna örökre.
- *
- * @param getAppVersion a deployolt app-verziót visszaadó getter
- * @param headerName felülírható header-név (default: `X-App-Version`)
- */
-function DyNTS_createAppVersionHeaderMiddleware(getAppVersion, headerName = exports.DYNTS_APP_VERSION_HEADER) {
-    return (_req, res, next) => {
-        const appVersion = getAppVersion();
-        // Ismeretlen verziónál NEM írunk headert: egy `unknown-version` jelzés rosszabb a
-        // semminél — a kliens „új verzió van" hamis riasztást adna belőle.
-        if (appVersion && appVersion !== 'unknown-version') {
-            res.setHeader(headerName, appVersion);
-            res.setHeader(EXPOSE_HEADERS_HEADER, DyNTS_resolveExposeHeaders(res.getHeader(EXPOSE_HEADERS_HEADER)?.toString(), headerName));
-        }
-        next();
-    };
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DYNTS_APP_VERSION_HEADER = void 0;
+exports.DyNTS_resolveExposeHeaders = DyNTS_resolveExposeHeaders;
+exports.DyNTS_createAppVersionHeaderMiddleware = DyNTS_createAppVersionHeaderMiddleware;
+/**
+ * FR-292 (2026-08-08) — a DEPLOYOLT app-verzió kiírása MINDEN válasz headerébe.
+ *
+ * **Miért kell:** a böngészőben nyitva hagyott SPA a memóriájában tartja a bundle-t, és a
+ * deploy után is a RÉGI kódot futtatja, amíg a felhasználó újra nem tölt. Ez nem elméleti:
+ * egy órákig nyitva hagyott dashboard-fülön hiányzó gombokat / régi viselkedést mutat, és
+ * a felhasználó (jogosan) azt hiszi, hogy a funkció nincs kész.
+ *
+ * Az itteni megoldás **nem polling**: a szerver minden válaszra ráteszi a saját deployolt
+ * app-verzióját, a kliens pedig a MÁR MEGLÉVŐ hívásaiból olvassa ki (ngx oldalon a
+ * `DyNX_AppVersion_Interceptor`). Nulla extra kérés, nulla extra terhelés — a jelzés
+ * „ingyen" utazik azon, ami úgyis megy.
+ *
+ * **CORS:** cross-origin kliens csak akkor OLVASHATJA a headert, ha az szerepel az
+ * `Access-Control-Expose-Headers`-ben. Ezért a middleware a meglévő értékhez HOZZÁFŰZ
+ * (nem felülír) — ezért kell a CORS-mount UTÁN felszerelni.
+ */
+/** A deployolt app-verziót hordozó response-header neve (a kliens ezt olvassa). */
+exports.DYNTS_APP_VERSION_HEADER = 'X-App-Version';
+/** Az `Access-Control-Expose-Headers` header neve — hogy ne szórjuk el string-literálként. */
+const EXPOSE_HEADERS_HEADER = 'Access-Control-Expose-Headers';
+/**
+ * Kiszámolja az `Access-Control-Expose-Headers` ÚJ értékét úgy, hogy a meglévő listát
+ * megtartja és a verzió-headert csak akkor fűzi hozzá, ha még nincs benne (idempotens).
+ *
+ * Tiszta függvény: Express nélkül unit-tesztelhető.
+ *
+ * @param currentValue a válaszon MÁR beállított érték (a CORS-middleware-től), ha van
+ * @param headerName a hozzáfűzendő header neve
+ */
+function DyNTS_resolveExposeHeaders(currentValue, headerName) {
+    if (!currentValue) {
+        return headerName;
+    }
+    const alreadyExposed = currentValue
+        .split(',')
+        .some((entry) => entry.trim().toLowerCase() === headerName.toLowerCase());
+    return alreadyExposed ? currentValue : `${currentValue}, ${headerName}`;
+}
+/**
+ * Express-middleware, ami minden válaszra ráteszi a deployolt app-verziót.
+ *
+ * A verziót FÜGGVÉNYKÉNT kapja (nem értékként), mert a `DyNTS_global_settings.systemVersion`
+ * az app-params betöltésekor áll be — egy induláskor kiolvasott érték `unknown-version`
+ * maradhatna örökre.
+ *
+ * @param getAppVersion a deployolt app-verziót visszaadó getter
+ * @param headerName felülírható header-név (default: `X-App-Version`)
+ */
+function DyNTS_createAppVersionHeaderMiddleware(getAppVersion, headerName = exports.DYNTS_APP_VERSION_HEADER) {
+    return (_req, res, next) => {
+        const appVersion = getAppVersion();
+        // Ismeretlen verziónál NEM írunk headert: egy `unknown-version` jelzés rosszabb a
+        // semminél — a kliens „új verzió van" hamis riasztást adna belőle.
+        if (appVersion && appVersion !== 'unknown-version') {
+            res.setHeader(headerName, appVersion);
+            res.setHeader(EXPOSE_HEADERS_HEADER, DyNTS_resolveExposeHeaders(res.getHeader(EXPOSE_HEADERS_HEADER)?.toString(), headerName));
+        }
+        next();
+    };
+}
 //# sourceMappingURL=app-version-header.util.js.map

package/build/_collections/archive-service-registry.const.d.ts

@@ -1,16 +1,16 @@
-import type { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
-import type { DyNTS_ArchiveDataService } from '../_services/base/archive-data.service';
-/**
- * Az archive-service osztály runtime-registry-je (BFR-AM-012 — körkörös-import feloldás).
- *
- * A `DyNTS_DataService.getArchiveDataService()` default-implementációja a
- * `DyNTS_ArchiveDataService`-t példányosítaná — de az `archive-data.service` maga a
- * `data.service`-ből örököl, így a KÖZVETLEN value-import futásidejű require-ciklust okozna
- * („Class extends value undefined"). A regisztráció fordítva folyik: az `archive-data.service`
- * modul-inicializáláskor IDE teszi be a saját konstruktorát (a registry-nek nincs runtime-importja
- * → nincs ciklus), a base data-service pedig innen olvassa.
- */
-export declare const DyNTS_archiveServiceRegistry: {
-    ArchiveDataService?: new <T extends DyFM_Metadata>(data: T, dataParams: DyFM_DataModel_Params<T>, issuer: string) => DyNTS_ArchiveDataService<T>;
-};
+import type { DyFM_DataModel_Params, DyFM_Metadata } from '@futdevpro/fsm-dynamo';
+import type { DyNTS_ArchiveDataService } from '../_services/base/archive-data.service';
+/**
+ * Az archive-service osztály runtime-registry-je (BFR-AM-012 — körkörös-import feloldás).
+ *
+ * A `DyNTS_DataService.getArchiveDataService()` default-implementációja a
+ * `DyNTS_ArchiveDataService`-t példányosítaná — de az `archive-data.service` maga a
+ * `data.service`-ből örököl, így a KÖZVETLEN value-import futásidejű require-ciklust okozna
+ * („Class extends value undefined"). A regisztráció fordítva folyik: az `archive-data.service`
+ * modul-inicializáláskor IDE teszi be a saját konstruktorát (a registry-nek nincs runtime-importja
+ * → nincs ciklus), a base data-service pedig innen olvassa.
+ */
+export declare const DyNTS_archiveServiceRegistry: {
+    ArchiveDataService?: new <T extends DyFM_Metadata>(data: T, dataParams: DyFM_DataModel_Params<T>, issuer: string) => DyNTS_ArchiveDataService<T>;
+};
 //# sourceMappingURL=archive-service-registry.const.d.ts.map

package/build/_collections/archive-service-registry.const.js

@@ -1,15 +1,15 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_archiveServiceRegistry = void 0;
-/**
- * Az archive-service osztály runtime-registry-je (BFR-AM-012 — körkörös-import feloldás).
- *
- * A `DyNTS_DataService.getArchiveDataService()` default-implementációja a
- * `DyNTS_ArchiveDataService`-t példányosítaná — de az `archive-data.service` maga a
- * `data.service`-ből örököl, így a KÖZVETLEN value-import futásidejű require-ciklust okozna
- * („Class extends value undefined"). A regisztráció fordítva folyik: az `archive-data.service`
- * modul-inicializáláskor IDE teszi be a saját konstruktorát (a registry-nek nincs runtime-importja
- * → nincs ciklus), a base data-service pedig innen olvassa.
- */
-exports.DyNTS_archiveServiceRegistry = {};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_archiveServiceRegistry = void 0;
+/**
+ * Az archive-service osztály runtime-registry-je (BFR-AM-012 — körkörös-import feloldás).
+ *
+ * A `DyNTS_DataService.getArchiveDataService()` default-implementációja a
+ * `DyNTS_ArchiveDataService`-t példányosítaná — de az `archive-data.service` maga a
+ * `data.service`-ből örököl, így a KÖZVETLEN value-import futásidejű require-ciklust okozna
+ * („Class extends value undefined"). A regisztráció fordítva folyik: az `archive-data.service`
+ * modul-inicializáláskor IDE teszi be a saját konstruktorát (a registry-nek nincs runtime-importja
+ * → nincs ciklus), a base data-service pedig innen olvassa.
+ */
+exports.DyNTS_archiveServiceRegistry = {};
 //# sourceMappingURL=archive-service-registry.const.js.map

package/build/_collections/archive.util.d.ts

@@ -1,13 +1,13 @@
-/** Suffix appended to database names when archived. */
-export declare const DyNTS_archiveSuffix = "archived";
-/**
- * Create the archive database name for a given base database.
- *
- * @example
- * ```ts
- * const name = DyNTS_getArchivedDBName('users');
- * // => 'users_archived'
- * ```
- */
-export declare function DyNTS_getArchivedDBName(dbName: string): string;
+/** Suffix appended to database names when archived. */
+export declare const DyNTS_archiveSuffix = "archived";
+/**
+ * Create the archive database name for a given base database.
+ *
+ * @example
+ * ```ts
+ * const name = DyNTS_getArchivedDBName('users');
+ * // => 'users_archived'
+ * ```
+ */
+export declare function DyNTS_getArchivedDBName(dbName: string): string;
 //# sourceMappingURL=archive.util.d.ts.map

package/build/_collections/archive.util.js

@@ -1,19 +1,19 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_archiveSuffix = void 0;
-exports.DyNTS_getArchivedDBName = DyNTS_getArchivedDBName;
-/** Suffix appended to database names when archived. */
-exports.DyNTS_archiveSuffix = 'archived';
-/**
- * Create the archive database name for a given base database.
- *
- * @example
- * ```ts
- * const name = DyNTS_getArchivedDBName('users');
- * // => 'users_archived'
- * ```
- */
-function DyNTS_getArchivedDBName(dbName) {
-    return `${dbName}_${exports.DyNTS_archiveSuffix}`;
-}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_archiveSuffix = void 0;
+exports.DyNTS_getArchivedDBName = DyNTS_getArchivedDBName;
+/** Suffix appended to database names when archived. */
+exports.DyNTS_archiveSuffix = 'archived';
+/**
+ * Create the archive database name for a given base database.
+ *
+ * @example
+ * ```ts
+ * const name = DyNTS_getArchivedDBName('users');
+ * // => 'users_archived'
+ * ```
+ */
+function DyNTS_getArchivedDBName(dbName) {
+    return `${dbName}_${exports.DyNTS_archiveSuffix}`;
+}
 //# sourceMappingURL=archive.util.js.map

package/build/_collections/atlas-default-db-options.const.d.ts

@@ -1,3 +1,3 @@
-import { ConnectOptions } from 'mongoose';
-export declare const DyNTS_atlasDefaultDbOptions: ConnectOptions;
+import { ConnectOptions } from 'mongoose';
+export declare const DyNTS_atlasDefaultDbOptions: ConnectOptions;
 //# sourceMappingURL=atlas-default-db-options.const.d.ts.map

package/build/_collections/atlas-default-db-options.const.js

@@ -1,10 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_atlasDefaultDbOptions = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-exports.DyNTS_atlasDefaultDbOptions = {
-    directConnection: false,
-    serverSelectionTimeoutMS: 5 * fsm_dynamo_1.second,
-    connectTimeoutMS: 10 * fsm_dynamo_1.second,
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_atlasDefaultDbOptions = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+exports.DyNTS_atlasDefaultDbOptions = {
+    directConnection: false,
+    serverSelectionTimeoutMS: 5 * fsm_dynamo_1.second,
+    connectTimeoutMS: 10 * fsm_dynamo_1.second,
+};
 //# sourceMappingURL=atlas-default-db-options.const.js.map

package/build/_collections/client-safe-error.util.d.ts

@@ -1,39 +1,39 @@
-/**
- * Kliens-safe error-body SSOT (BFR-FDPAUTHSERVICE-002 — error-response info-disclosure fix).
- *
- * A DyFM_Error HTTP-response-ba szerializálásakor a belső diagnosztikai mezők NEM mehetnek ki a
- * kliensre — env-FÜGGETLENÜL (a korábbi prod-only strip a test/dev környezetben TELJES leaket
- * hagyott: `__localStack` stack-trace, `___systemVersion`, issuer-lánc). A strip-szabályok:
- *
- *   1. MINDIG ki (env-független, kliens sehol nem fogyasztja → 0 regresszió):
- *      `__localStack`, `stack`, `___systemVersion`, `___issuer`, `___issuerSystem`,
- *      `___issuerService`, `confidentialContent`, `error`, `errors` (a nyers belső error-lánc
- *      stack-eket hordoz), `_messages` (QA2-005: technikai message-lánc — belső URL-ek, DB-hibák).
- *   2. CSAK prod-ban ki: `additionalContent` — test/dev környezetben a diagnosztikai state-snapshot
- *      szándékosan kimegy (a hibafelület-debug erre épül), prod-ban nem. KIVÉTEL (QA2-005):
- *      az `additionalContent.requestDebug` (FR-071 header-lista/belső-IP snapshot) env-FÜGGETLENÜL
- *      strip-elve — csak az error-store-ba perzisztálódik.
- *   3. MARAD (kliens-kompatibilitás — a FDP-kliens error-interceptorok fogyasztják):
- *      `_message`, `_errorCodes`, `__userMessage`, `___status`, `level`. QA2-005: a `_message`
- *      TARTALMA a user-safe `__userMessage`-re cserélve (a technikai üzenet — belső BE-BE URL,
- *      nyers Mongo E11000 — nem hagyhatja el a szervert; a mező-ALAK a kliens-kompat miatt marad).
- *
- * NEM-DyFM error (plain Error / axios-error / bármi más): minimál `{ message }` shape — a plain
- * Error eddig is üres `{}`-ként szerializálódott (non-enumerable mezők), az axios-jellegű error-ok
- * viszont enumerable config/request mezőkben auth-headert is szivárogtathatnak → fail-safe minimál.
- *
- * ⚠️ A metódus MUTÁLJA a kapott DyFM_Error-t (a meglévő endpoint-strip precedensét követve) —
- * a hívási pont a response-küldés, ahol az error-objektum életciklusa véget ér.
- */
-export declare class DyNTS_ClientSafeError_Util {
-    /** A MINDIG strip-elendő DyFM-mezők (env-független — kliens-fogyasztás nélküli leak-vektorok). */
-    private static readonly alwaysStripKeys;
-    /** QA2-005 — generikus `_message` fallback, ha az errornak nincs `__userMessage`-e. */
-    private static readonly genericClientMessage;
-    /**
-     * Az error kliens-safe formára hozása a HTTP-response-küldés előtt.
-     * DyFM_Error: in-place strip (1-3. szabályok szerint); nem-DyFM object: minimál `{ message }`.
-     */
-    static toClientSafe(error: unknown): unknown;
-}
+/**
+ * Kliens-safe error-body SSOT (BFR-FDPAUTHSERVICE-002 — error-response info-disclosure fix).
+ *
+ * A DyFM_Error HTTP-response-ba szerializálásakor a belső diagnosztikai mezők NEM mehetnek ki a
+ * kliensre — env-FÜGGETLENÜL (a korábbi prod-only strip a test/dev környezetben TELJES leaket
+ * hagyott: `__localStack` stack-trace, `___systemVersion`, issuer-lánc). A strip-szabályok:
+ *
+ *   1. MINDIG ki (env-független, kliens sehol nem fogyasztja → 0 regresszió):
+ *      `__localStack`, `stack`, `___systemVersion`, `___issuer`, `___issuerSystem`,
+ *      `___issuerService`, `confidentialContent`, `error`, `errors` (a nyers belső error-lánc
+ *      stack-eket hordoz), `_messages` (QA2-005: technikai message-lánc — belső URL-ek, DB-hibák).
+ *   2. CSAK prod-ban ki: `additionalContent` — test/dev környezetben a diagnosztikai state-snapshot
+ *      szándékosan kimegy (a hibafelület-debug erre épül), prod-ban nem. KIVÉTEL (QA2-005):
+ *      az `additionalContent.requestDebug` (FR-071 header-lista/belső-IP snapshot) env-FÜGGETLENÜL
+ *      strip-elve — csak az error-store-ba perzisztálódik.
+ *   3. MARAD (kliens-kompatibilitás — a FDP-kliens error-interceptorok fogyasztják):
+ *      `_message`, `_errorCodes`, `__userMessage`, `___status`, `level`. QA2-005: a `_message`
+ *      TARTALMA a user-safe `__userMessage`-re cserélve (a technikai üzenet — belső BE-BE URL,
+ *      nyers Mongo E11000 — nem hagyhatja el a szervert; a mező-ALAK a kliens-kompat miatt marad).
+ *
+ * NEM-DyFM error (plain Error / axios-error / bármi más): minimál `{ message }` shape — a plain
+ * Error eddig is üres `{}`-ként szerializálódott (non-enumerable mezők), az axios-jellegű error-ok
+ * viszont enumerable config/request mezőkben auth-headert is szivárogtathatnak → fail-safe minimál.
+ *
+ * ⚠️ A metódus MUTÁLJA a kapott DyFM_Error-t (a meglévő endpoint-strip precedensét követve) —
+ * a hívási pont a response-küldés, ahol az error-objektum életciklusa véget ér.
+ */
+export declare class DyNTS_ClientSafeError_Util {
+    /** A MINDIG strip-elendő DyFM-mezők (env-független — kliens-fogyasztás nélküli leak-vektorok). */
+    private static readonly alwaysStripKeys;
+    /** QA2-005 — generikus `_message` fallback, ha az errornak nincs `__userMessage`-e. */
+    private static readonly genericClientMessage;
+    /**
+     * Az error kliens-safe formára hozása a HTTP-response-küldés előtt.
+     * DyFM_Error: in-place strip (1-3. szabályok szerint); nem-DyFM object: minimál `{ message }`.
+     */
+    static toClientSafe(error: unknown): unknown;
+}
 //# sourceMappingURL=client-safe-error.util.d.ts.map