@futdevpro/nts-dynamo 1.15.154 → 1.15.155

package/README.md

@@ -28,26 +28,26 @@ 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**: IP-based geolocation through `geoip-lite` is integrated into the usage tracking module (simplifies location data collection from HTTP requests)
+- **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.
-
-### Content-free process diagnostics
-
-`DyNTS_App` projects bootstrap failures, unhandled promise rejections, database connection/runtime failures,
-HTTP/HTTPS server errors, routing failures and Express fallbacks through the versioned
-`dynts-safe-diagnostic/1` contract before framework-owned logging or error forwarding. The public allowlist is
-limited to `contractVersion`, `code`, `stage`, `causeType`, `fingerprint` and `status`. Raw error messages,
-stacks, rejected promises, requests and database URIs are excluded. The fingerprint is derived only from the
-allowlisted classification, never from raw failure content.
-
-Consumers can use `DyNTS_SafeDiagnostic_ControlService.project()` when they need the same deterministic
-projection without logging, `report()` for safe framework logging, and `toError()` when a content-free
-`DyFM_Error` must cross an existing error-handler boundary. See
-[`__documentations/2026-08-22-content-free-process-error-boundary.md`](./__documentations/2026-08-22-content-free-process-error-boundary.md)
-for the normative boundary and verification matrix.
-
-## Table of Contents
+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.
+
+### Content-free process diagnostics
+
+`DyNTS_App` projects bootstrap failures, unhandled promise rejections, database connection/runtime failures,
+HTTP/HTTPS server errors, routing failures and Express fallbacks through the versioned
+`dynts-safe-diagnostic/1` contract before framework-owned logging or error forwarding. The public allowlist is
+limited to `contractVersion`, `code`, `stage`, `causeType`, `fingerprint` and `status`. Raw error messages,
+stacks, rejected promises, requests and database URIs are excluded. The fingerprint is derived only from the
+allowlisted classification, never from raw failure content.
+
+Consumers can use `DyNTS_SafeDiagnostic_ControlService.project()` when they need the same deterministic
+projection without logging, `report()` for safe framework logging, and `toError()` when a content-free
+`DyFM_Error` must cross an existing error-handler boundary. See
+[`__documentations/2026-08-22-content-free-process-error-boundary.md`](./__documentations/2026-08-22-content-free-process-error-boundary.md)
+for the normative boundary and verification matrix.
+
+## Table of Contents
 
 - [Installation](#installation)
 - [Quick Start](#quick-start)
@@ -98,9 +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` - IP geolocation (simplified through Dynamo-NTS usage module)
-- **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)
+- **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:
 
@@ -111,8 +115,8 @@ pnpm add socket.io
 # For Email service
 pnpm add nodemailer
 
-# For Usage module
-pnpm add geoip-lite @types/geoip-lite
+# 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-content-free-process-error-boundary.md

@@ -1,91 +1,91 @@
-# Content-free process error boundary
-
-**Date:** 2026-08-22
-**Status:** implemented; verification evidence is recorded below
-**Contract:** `dynts-safe-diagnostic/1`
-**Package surface:** `@futdevpro/nts-dynamo`, server module exports
-
-## Purpose
-
-Dynamo-NTS must remain debuggable without copying arbitrary application content into framework-owned logs or
-error forwarding. Process failures can contain credentials, personal data, workbook values, HTTP request data,
-provider responses or attacker-controlled strings in `message`, `stack`, rejected promises and nested error
-objects. This boundary converts such failures to a fixed allowlist before they reach a Dynamo-NTS logger or the
-global handler from `DyNTS_App`.
-
-The capability is direct Dynamo Bedrock. Consuming applications must use it as supplied and may add their own
-product metadata only through a separately reviewed, content-free contract.
-
-## Normative public contract
-
-`DyNTS_SafeDiagnostic_Interface` contains exactly these fields:
-
-| Field | Meaning |
-|---|---|
-| `contractVersion` | Literal `dynts-safe-diagnostic/1`. |
-| `code` | Stable uppercase error code; invalid caller input fails closed to a fixed fallback. |
-| `stage` | Closed lifecycle-stage enum. |
-| `causeType` | Coarse classification only: Dynamo error, native error, object, primitive or unknown. |
-| `fingerprint` | SHA-256 correlation of contract version, code, stage, cause type and status only. |
-| `status` | Valid HTTP-style integer from 100 through 599; otherwise 500. |
-
-No raw failure content participates in the returned object or the fingerprint. In particular, `message`,
-`stack`, request/response objects, rejected promises, MongoDB URIs, usernames, passwords, tokens, workbook data
-and arbitrary nested properties are not public fields and are never read for fingerprint construction.
-
-The projection is immutable. `project()` returns it without side effects, `report()` logs only that projection,
-and `toError()` creates a `DyFM_Error` whose message and additional content are derived solely from the safe
-projection.
-
-## Framework integration
-
-`DyNTS_App` applies the projection before framework-owned logging and forwarding at these boundaries:
-
-- bootstrap rejection and `unhandledRejection`;
-- post-process, memory guard, event-loop diagnostics and collection-growth monitor failures;
-- readiness reporting;
-- initial MongoDB connect failure, runtime connection error and reconnect-guard diagnostics;
-- HTTP and HTTPS server error/uncaught-exception events;
-- open/secure route configuration and duplicate-route failures;
-- Express error fallback and secondary global-handler failures;
-- retention installation diagnostics.
-
-MongoDB connection success logs only the stable fact that MongoDB is connected. Malformed URI warnings,
-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.
-
-## Security and privacy properties
-
-- The output is an exact allowlist rather than a denylist-based redaction attempt.
-- Hostile getters on error objects cannot make raw content appear in the projection.
-- Correlation is deterministic for the same safe classification but cannot be used to dictionary-test an error
-  message, password or token because raw values are excluded from the hash input.
-- Invalid codes and statuses fail closed to stable defaults.
-- Client responses continue to use the existing client-safe error utility; this capability governs
-  framework-owned process diagnostics and forwarding.
-- This boundary reduces disclosure risk but does not authorize logging sensitive values elsewhere in a
-  consuming application.
-
-## Verification matrix
-
-| Evidence | Required assertion |
-|---|---|
-| Safe-diagnostic unit tests | Exact frozen allowlist, stable fingerprint, cause classification and fail-closed hostile input. |
-| Report/toError unit test | Logger and serialized `DyFM_Error` contain the safe contract and exclude a credential-bearing canary. |
-| 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. |
-
-## Consumer adoption requirement
-
-A consumer adopts the capability by pinning the first exact `@futdevpro/nts-dynamo` version that contains this
-document and by proving the package-level runtime tests in its dependency tree. Reimplementing the boundary in
-the product does not count as Bedrock adoption. Product-specific diagnostics may compose the safe fields, but
-must not copy or reinterpret raw failure content.
+# Content-free process error boundary
+
+**Date:** 2026-08-22
+**Status:** implemented; verification evidence is recorded below
+**Contract:** `dynts-safe-diagnostic/1`
+**Package surface:** `@futdevpro/nts-dynamo`, server module exports
+
+## Purpose
+
+Dynamo-NTS must remain debuggable without copying arbitrary application content into framework-owned logs or
+error forwarding. Process failures can contain credentials, personal data, workbook values, HTTP request data,
+provider responses or attacker-controlled strings in `message`, `stack`, rejected promises and nested error
+objects. This boundary converts such failures to a fixed allowlist before they reach a Dynamo-NTS logger or the
+global handler from `DyNTS_App`.
+
+The capability is direct Dynamo Bedrock. Consuming applications must use it as supplied and may add their own
+product metadata only through a separately reviewed, content-free contract.
+
+## Normative public contract
+
+`DyNTS_SafeDiagnostic_Interface` contains exactly these fields:
+
+| Field | Meaning |
+|---|---|
+| `contractVersion` | Literal `dynts-safe-diagnostic/1`. |
+| `code` | Stable uppercase error code; invalid caller input fails closed to a fixed fallback. |
+| `stage` | Closed lifecycle-stage enum. |
+| `causeType` | Coarse classification only: Dynamo error, native error, object, primitive or unknown. |
+| `fingerprint` | SHA-256 correlation of contract version, code, stage, cause type and status only. |
+| `status` | Valid HTTP-style integer from 100 through 599; otherwise 500. |
+
+No raw failure content participates in the returned object or the fingerprint. In particular, `message`,
+`stack`, request/response objects, rejected promises, MongoDB URIs, usernames, passwords, tokens, workbook data
+and arbitrary nested properties are not public fields and are never read for fingerprint construction.
+
+The projection is immutable. `project()` returns it without side effects, `report()` logs only that projection,
+and `toError()` creates a `DyFM_Error` whose message and additional content are derived solely from the safe
+projection.
+
+## Framework integration
+
+`DyNTS_App` applies the projection before framework-owned logging and forwarding at these boundaries:
+
+- bootstrap rejection and `unhandledRejection`;
+- post-process, memory guard, event-loop diagnostics and collection-growth monitor failures;
+- readiness reporting;
+- initial MongoDB connect failure, runtime connection error and reconnect-guard diagnostics;
+- HTTP and HTTPS server error/uncaught-exception events;
+- open/secure route configuration and duplicate-route failures;
+- Express error fallback and secondary global-handler failures;
+- retention installation diagnostics.
+
+MongoDB connection success logs only the stable fact that MongoDB is connected. Malformed URI warnings,
+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.
+
+## Security and privacy properties
+
+- The output is an exact allowlist rather than a denylist-based redaction attempt.
+- Hostile getters on error objects cannot make raw content appear in the projection.
+- Correlation is deterministic for the same safe classification but cannot be used to dictionary-test an error
+  message, password or token because raw values are excluded from the hash input.
+- Invalid codes and statuses fail closed to stable defaults.
+- Client responses continue to use the existing client-safe error utility; this capability governs
+  framework-owned process diagnostics and forwarding.
+- This boundary reduces disclosure risk but does not authorize logging sensitive values elsewhere in a
+  consuming application.
+
+## Verification matrix
+
+| Evidence | Required assertion |
+|---|---|
+| Safe-diagnostic unit tests | Exact frozen allowlist, stable fingerprint, cause classification and fail-closed hostile input. |
+| Report/toError unit test | Logger and serialized `DyFM_Error` contain the safe contract and exclude a credential-bearing canary. |
+| 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. |
+
+## Consumer adoption requirement
+
+A consumer adopts the capability by pinning the first exact `@futdevpro/nts-dynamo` version that contains this
+document and by proving the package-level runtime tests in its dependency tree. Reimplementing the boundary in
+the product does not count as Bedrock adoption. Product-specific diagnostics may compose the safe fields, but
+must not copy or reinterpret raw failure content.

package/build/_services/shared.static-service.d.ts

@@ -16,16 +16,23 @@ export declare class DyNTS_Shared extends DyFM_Object {
      * Lookup the Geo location of a request based on its IP address.
      *
      * @param request Incoming request
-     * @returns Resolved geo location information
+     * The optional GeoIP provider is loaded only for this capability. When it is not installed,
+     * the method returns `null` and does not transmit or log the address.
+     *
+     * @returns Resolved geo location information, or `null` when unavailable
      */
-    static getLocationDataByRequest(request: Request): DyFM_GeoIpLocation;
+    static getLocationDataByRequest(request: Request): DyFM_GeoIpLocation | null;
     /**
      * Lookup the Geo location of a raw IP address.
      *
      * @param ip IP address string
-     * @returns Geo location information
+     * The lookup is local-only: the IP address is never sent to an external service. The optional
+     * provider may be omitted by consumers that do not use geolocation.
+     *
+     * @returns Geo location information, or `null` when unavailable
      */
-    static getLocationByIp(ip: string): DyFM_GeoIpLocation;
+    static getLocationByIp(ip: string): DyFM_GeoIpLocation | null;
+    private static getGeoIpProvider;
     /**
      * Simple CLI helper to prompt the user for input.
      *

package/build/_services/shared.static-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.static-service.d.ts","sourceRoot":"","sources":["../../src/_services/shared.static-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAejD;;;;;OAKG;IACH,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB;IAIrE;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB;IAItD;;;;;OAKG;WACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiBvD"}
+{"version":3,"file":"shared.static-service.d.ts","sourceRoot":"","sources":["../../src/_services/shared.static-service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAQpE;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;IAcjD;;;;;;;;OAQG;IACH,MAAM,CAAC,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,GAAG,IAAI;IAI5E;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAM7D,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAgB/B;;;;;OAKG;WACU,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiBvD"}

package/build/_services/shared.static-service.js

@@ -3,8 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyNTS_Shared = void 0;
 const tslib_1 = require("tslib");
 const ReadLine = tslib_1.__importStar(require("readline"));
-const GeoIp = tslib_1.__importStar(require("geoip-lite"));
+const module_1 = require("module");
 const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const DyNTS_optionalRequire = (0, module_1.createRequire)(__filename);
 /**
  * Collection of static helper utilities shared across modules.
  */
@@ -19,7 +20,6 @@ class DyNTS_Shared extends fsm_dynamo_1.DyFM_Object {
         let ip;
         if (request?.headers?.['x-forwarded-for']) {
             const route = request.headers['x-forwarded-for'].split(', ');
-            console.log('TESTTTT route:', route);
             ip = route[route.length - 1];
         }
         else {
@@ -31,19 +31,39 @@ class DyNTS_Shared extends fsm_dynamo_1.DyFM_Object {
      * Lookup the Geo location of a request based on its IP address.
      *
      * @param request Incoming request
-     * @returns Resolved geo location information
+     * The optional GeoIP provider is loaded only for this capability. When it is not installed,
+     * the method returns `null` and does not transmit or log the address.
+     *
+     * @returns Resolved geo location information, or `null` when unavailable
      */
     static getLocationDataByRequest(request) {
-        return GeoIp.lookup(this.getIpFromRequest(request));
+        return this.getLocationByIp(this.getIpFromRequest(request));
     }
     /**
      * Lookup the Geo location of a raw IP address.
      *
      * @param ip IP address string
-     * @returns Geo location information
+     * The lookup is local-only: the IP address is never sent to an external service. The optional
+     * provider may be omitted by consumers that do not use geolocation.
+     *
+     * @returns Geo location information, or `null` when unavailable
      */
     static getLocationByIp(ip) {
-        return GeoIp.lookup(ip);
+        const geoIpProvider = this.getGeoIpProvider();
+        return geoIpProvider?.lookup(ip) ?? null;
+    }
+    static getGeoIpProvider() {
+        let geoIpModulePath;
+        try {
+            geoIpModulePath = DyNTS_optionalRequire.resolve('geoip-lite');
+        }
+        catch (error) {
+            if (error instanceof Error && 'code' in error && error.code === 'MODULE_NOT_FOUND') {
+                return null;
+            }
+            throw error;
+        }
+        return DyNTS_optionalRequire(geoIpModulePath);
     }
     /**
      * Simple CLI helper to prompt the user for input.

package/build/_services/shared.static-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.static-service.js","sourceRoot":"","sources":["../../src/_services/shared.static-service.ts"],"names":[],"mappings":";;;;AACA,2DAAqC;AACrC,0DAAoC;AAGpC,sDAAoD;AAGpD;;GAEG;AACH,MAAa,YAAa,SAAQ,wBAAW;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAgB;QACtC,IAAI,EAAU,CAAC;QAEf,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAc,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEnF,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;YACrC,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;QACpC,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,wBAAwB,CAAC,OAAgB;QAC9C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,EAAU;QAC/B,OAAO,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAgB;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAc,EAAE,EAAE;oBAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;oBAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAlED,oCAkEC"}
+{"version":3,"file":"shared.static-service.js","sourceRoot":"","sources":["../../src/_services/shared.static-service.ts"],"names":[],"mappings":";;;;AACA,2DAAqC;AACrC,mCAAuC;AAGvC,sDAAoD;AAOpD,MAAM,qBAAqB,GAAmB,IAAA,sBAAa,EAAC,UAAU,CAAC,CAAC;AAExE;;GAEG;AACH,MAAa,YAAa,SAAQ,wBAAW;IAE3C;;;;;OAKG;IACH,MAAM,CAAC,gBAAgB,CAAC,OAAgB;QACtC,IAAI,EAAU,CAAC;QAEf,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAc,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAEnF,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC;QACpC,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,wBAAwB,CAAC,OAAgB;QAC9C,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CAAC,EAAU;QAC/B,MAAM,aAAa,GAA+B,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE1E,OAAO,aAAa,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC;IAC3C,CAAC;IAEO,MAAM,CAAC,gBAAgB;QAC7B,IAAI,eAAuB,CAAC;QAE5B,IAAI,CAAC;YACH,eAAe,GAAG,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAChE,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;gBACnF,OAAO,IAAI,CAAC;YACd,CAAC;YAED,MAAM,KAAK,CAAC;QACd,CAAC;QAED,OAAO,qBAAqB,CAAC,eAAe,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAgB;QAClC,MAAM,QAAQ,GAAG,QAAQ,CAAC,eAAe,CAAC;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC;gBACH,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAc,EAAE,EAAE;oBAC7C,OAAO,CAAC,MAAM,CAAC,CAAC;oBAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAzFD,oCAyFC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.154",
+  "version": "01.15.155",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -411,16 +411,16 @@
     "better-sqlite3": "~12.4.1",
     "@futdevpro/fsm-dynamo": "1.16.40",
     "@types/express": "4.17.21",
-    "@types/geoip-lite": "~1.4.1",
+    "@types/geoip-lite": "~1.4.4",
     "@types/node": "~24.1.0",
-    "axios": ">=1.8.1 <2",
-    "body-parser": "~1.20.2",
+    "axios": ">=1.19.0 <2",
+    "body-parser": ">=1.20.6 <2",
     "discord.js": "~14.24.2",
-    "dotenv": "~16.5.0",
-    "express": "4.21.2",
-    "geoip-lite": "~1.4.7",
-    "mongoose": "~8.10.1",
-    "nodemailer": ">=6.9.4 <8",
+    "dotenv": ">=16.6.1 <17",
+    "express": ">=4.22.1 <5",
+    "geoip-lite": ">=2.0.3 <3",
+    "mongoose": ">=8.24.1 <9",
+    "nodemailer": ">=9.0.5 <10",
     "openai": "~5.23.2",
     "rxjs": "7.8.1",
     "ts-node": "~10.9.2"
@@ -438,6 +438,12 @@
     "discord.js": {
       "optional": true
     },
+    "@types/geoip-lite": {
+      "optional": true
+    },
+    "geoip-lite": {
+      "optional": true
+    },
     "openai": {
       "optional": true
     }

package/src/_models/control-models/app-params.control-model.spec.ts

@@ -1,9 +1,9 @@
 
-import { DyFM_EnvironmentFlag, DyFM_Log } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
-
-import { DyNTS_App_Params } from './app-params.control-model';
+import { DyFM_EnvironmentFlag, DyFM_Log } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+
+import { DyNTS_App_Params } from './app-params.control-model';
 
 describe('| DyNTS_App_Params', () => {
   let originalEnv: any;
@@ -209,21 +209,21 @@ describe('| DyNTS_App_Params', () => {
     expect(logSpy).toHaveBeenCalled();
   });
 
-  it('| should warn without logging a malformed credential-bearing dbUri', () => {
-    const logSpy = spyOn(DyFM_Log, 'warn');
-    const canary: string = 'mongodb://canary-user:canary-secret@localhost:27017//testdb';
-
-    const params: DyNTS_App_Params = {
-      name: 'TestApp',
-      version: '1.0.0',
-      dbName: 'testdb',
-      dbUri: canary,
-    };
-
-    new DyNTS_App_Params(params);
-
-    expect(logSpy).toHaveBeenCalled();
-    expect(JSON.stringify(logSpy.calls.allArgs())).not.toContain(canary);
-    expect(JSON.stringify(logSpy.calls.allArgs())).not.toContain('canary-secret');
-  });
-});
+  it('| should warn without logging a malformed credential-bearing dbUri', () => {
+    const logSpy = spyOn(DyFM_Log, 'warn');
+    const canary: string = 'mongodb://canary-user:canary-secret@localhost:27017//testdb';
+
+    const params: DyNTS_App_Params = {
+      name: 'TestApp',
+      version: '1.0.0',
+      dbName: 'testdb',
+      dbUri: canary,
+    };
+
+    new DyNTS_App_Params(params);
+
+    expect(logSpy).toHaveBeenCalled();
+    expect(JSON.stringify(logSpy.calls.allArgs())).not.toContain(canary);
+    expect(JSON.stringify(logSpy.calls.allArgs())).not.toContain('canary-secret');
+  });
+});

package/src/_models/control-models/app-params.control-model.ts

@@ -1,8 +1,8 @@
-import { ConnectOptions } from 'mongoose';
-
-import { DyFM_Log, DyFM_String } from '@futdevpro/fsm-dynamo';
-
-import { DyNTS_global_settings } from '../../_collections/global-settings.const';
+import { ConnectOptions } from 'mongoose';
+
+import { DyFM_Log, DyFM_String } from '@futdevpro/fsm-dynamo';
+
+import { DyNTS_global_settings } from '../../_collections/global-settings.const';
 
 /**
  * This will hold and set the basic settings of an application
@@ -84,11 +84,11 @@ export class DyNTS_App_Params {
         this.dbUri = set.dbUri;
       }
 
-      if (this.dbUri.split('//').length > 2) {
-        DyFM_Log.warn(
-          'DyNTS_App_Params.constructor: dbUri should not contain more than one "//".'
-        );
-      }
+      if (this.dbUri.split('//').length > 2) {
+        DyFM_Log.warn(
+          'DyNTS_App_Params.constructor: dbUri should not contain more than one "//".'
+        );
+      }
 
       this.dbOptions = set.dbOptions ?? {
         directConnection: true,

package/src/_modules/server/index.ts

@@ -20,7 +20,7 @@ export * from './errors/errors.controller';
 export * from './errors/errors.control-service';
 export * from './errors/errors.data-service';
 
-// SERVER-STATUS
+// SERVER-STATUS
 export * from './server-status/db-readiness-probe-code.type-enum';
 export * from './server-status/db-readiness-probe-stage.type-enum';
 export * from './server-status/db-readiness-probe.interface';
@@ -28,13 +28,13 @@ export * from './server-status/db-readiness-probe.control-service';
 export * from './server-status/server-status-snapshot.data-service';
 export * from './server-status/server-status-snapshot.control-service';
 export * from './server-status/server-status.control-service';
-export * from './server-status/server-status.controller';
-
-// SAFE-DIAGNOSTIC
-export * from './safe-diagnostic/safe-diagnostic-cause.type-enum';
-export * from './safe-diagnostic/safe-diagnostic-stage.type-enum';
-export * from './safe-diagnostic/safe-diagnostic.interface';
-export * from './safe-diagnostic/safe-diagnostic.control-service';
+export * from './server-status/server-status.controller';
+
+// SAFE-DIAGNOSTIC
+export * from './safe-diagnostic/safe-diagnostic-cause.type-enum';
+export * from './safe-diagnostic/safe-diagnostic-stage.type-enum';
+export * from './safe-diagnostic/safe-diagnostic.interface';
+export * from './safe-diagnostic/safe-diagnostic.control-service';
 
 
 

package/src/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.ts

@@ -1,8 +1,8 @@
-/** Stable, content-free classifications for framework-owned failures. */
-export enum DyNTS_SafeDiagnosticCause_Type {
-  dynamoError = 'dynamo-error',
-  nativeError = 'native-error',
-  object = 'object',
-  primitive = 'primitive',
-  unknown = 'unknown',
-}
+/** Stable, content-free classifications for framework-owned failures. */
+export enum DyNTS_SafeDiagnosticCause_Type {
+  dynamoError = 'dynamo-error',
+  nativeError = 'native-error',
+  object = 'object',
+  primitive = 'primitive',
+  unknown = 'unknown',
+}

package/src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts

@@ -1,19 +1,19 @@
-/** Framework stages that may emit a content-free diagnostic. */
-export enum DyNTS_SafeDiagnosticStage_Type {
-  bootstrap = 'bootstrap',
-  collectionGrowthMonitor = 'collection-growth-monitor',
-  databaseConnect = 'database-connect',
-  databaseRuntime = 'database-runtime',
-  eventLoopDiagnostic = 'event-loop-diagnostic',
-  expressFallback = 'express-fallback',
-  globalErrorHandler = 'global-error-handler',
-  httpServer = 'http-server',
-  httpsServer = 'https-server',
-  memoryGuard = 'memory-guard',
-  mongoReconnectGuard = 'mongo-reconnect-guard',
-  postProcess = 'post-process',
-  readiness = 'readiness',
-  retention = 'retention',
-  routing = 'routing',
-  unhandledRejection = 'unhandled-rejection',
-}
+/** Framework stages that may emit a content-free diagnostic. */
+export enum DyNTS_SafeDiagnosticStage_Type {
+  bootstrap = 'bootstrap',
+  collectionGrowthMonitor = 'collection-growth-monitor',
+  databaseConnect = 'database-connect',
+  databaseRuntime = 'database-runtime',
+  eventLoopDiagnostic = 'event-loop-diagnostic',
+  expressFallback = 'express-fallback',
+  globalErrorHandler = 'global-error-handler',
+  httpServer = 'http-server',
+  httpsServer = 'https-server',
+  memoryGuard = 'memory-guard',
+  mongoReconnectGuard = 'mongo-reconnect-guard',
+  postProcess = 'post-process',
+  readiness = 'readiness',
+  retention = 'retention',
+  routing = 'routing',
+  unhandledRejection = 'unhandled-rejection',
+}