@futdevpro/nts-dynamo 1.15.454 → 1.15.455

package/build/_collections/mongo-handshake-probe.util.d.ts

@@ -0,0 +1,33 @@
+import { DyNTS_MongoHandshakeResult_Interface } from '../_models/interfaces/mongo-handshake-result.interface';
+/**
+ * "Is there a MongoDB behind this address?" - the shared handshake probe (BFR-CCAPREVISIONED-024).
+ *
+ * WHY NOT TCP ONLY: an open port is not a working database. On 2026-09-18 (PLO-KOON) the TCP connection was made in
+ * 3 ms and the handshake never finished; a TCP-only check said "reachable" and hid the fault. Two repos then solved the
+ * same incident apart (`fdp-cli` net-check with the handshake, a later CCAP check without it) - this is the one place.
+ *
+ * ⛔ PRODUCTION-SAFE: it sends ONE `isMaster` command (OP_QUERY on `admin.$cmd`), the message every driver sends on
+ * every connect. No authentication, no data read, no write. The connection is closed after the first reply chunk.
+ */
+export declare class DyNTS_MongoHandshakeProbe_Util {
+    /** The default timeout of one probe (ms). */
+    static readonly defaultTimeoutMs: number;
+    /**
+     * The raw `isMaster` frame: OP_QUERY (opCode 2004) on `admin.$cmd`, BSON body `{ isMaster: 1 }`, numberToReturn -1.
+     * (The frame layout is the one `fdp-cli` net-check proved on the PLO-KOON case, 2026-09-22.)
+     */
+    static buildIsMasterFrame(): Buffer;
+    /** The opCode of a reply chunk (-1 when it is shorter than a message header). */
+    static replyOpCode(data: Buffer): number;
+    /** Whether the reply is a MongoDB server message: OP_REPLY (1) or OP_MSG (2013). */
+    static isValidReply(data: Buffer): boolean;
+    /**
+     * Probes one address. Never rejects: every failure is an outcome, the raw network code stays in `errorCode`.
+     */
+    static probe(set: {
+        host: string;
+        port: number;
+        timeoutMs?: number;
+    }): Promise<DyNTS_MongoHandshakeResult_Interface>;
+}
+//# sourceMappingURL=mongo-handshake-probe.util.d.ts.map

package/build/_collections/mongo-handshake-probe.util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-handshake-probe.util.d.ts","sourceRoot":"","sources":["../../src/_collections/mongo-handshake-probe.util.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,oCAAoC,EAAE,MAAM,wDAAwD,CAAC;AAE9G;;;;;;;;;GASG;AACH,qBAAa,8BAA8B;IAEzC,6CAA6C;IAC7C,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAQ;IAEhD;;;OAGG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM;IAwBnC,iFAAiF;IACjF,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIxC,oFAAoF;IACpF,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAM1C;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,oCAAoC,CAAC;CAsDrH"}

package/build/_collections/mongo-handshake-probe.util.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MongoHandshakeProbe_Util = void 0;
+const tslib_1 = require("tslib");
+const net = tslib_1.__importStar(require("net"));
+const mongo_handshake_outcome_enum_1 = require("../_enums/mongo-handshake-outcome.enum");
+/**
+ * "Is there a MongoDB behind this address?" - the shared handshake probe (BFR-CCAPREVISIONED-024).
+ *
+ * WHY NOT TCP ONLY: an open port is not a working database. On 2026-09-18 (PLO-KOON) the TCP connection was made in
+ * 3 ms and the handshake never finished; a TCP-only check said "reachable" and hid the fault. Two repos then solved the
+ * same incident apart (`fdp-cli` net-check with the handshake, a later CCAP check without it) - this is the one place.
+ *
+ * ⛔ PRODUCTION-SAFE: it sends ONE `isMaster` command (OP_QUERY on `admin.$cmd`), the message every driver sends on
+ * every connect. No authentication, no data read, no write. The connection is closed after the first reply chunk.
+ */
+class DyNTS_MongoHandshakeProbe_Util {
+    /** The default timeout of one probe (ms). */
+    static defaultTimeoutMs = 5000;
+    /**
+     * The raw `isMaster` frame: OP_QUERY (opCode 2004) on `admin.$cmd`, BSON body `{ isMaster: 1 }`, numberToReturn -1.
+     * (The frame layout is the one `fdp-cli` net-check proved on the PLO-KOON case, 2026-09-22.)
+     */
+    static buildIsMasterFrame() {
+        const name = Buffer.from('isMaster\0');
+        // BSON document: { isMaster: 1 } - length, int32 element (0x10), name, value, terminator
+        const doc = Buffer.alloc(4 + 1 + name.length + 4 + 1);
+        doc.writeInt32LE(doc.length, 0);
+        doc.writeUInt8(0x10, 4);
+        name.copy(doc, 5);
+        doc.writeInt32LE(1, 5 + name.length);
+        // flags = 0, the collection name, numberToSkip = 0, numberToReturn = -1
+        const limit = Buffer.alloc(8);
+        limit.writeInt32LE(-1, 4);
+        const body = Buffer.concat([Buffer.alloc(4), Buffer.from('admin.$cmd\0'), limit, doc]);
+        // message header: messageLength, requestID, responseTo, opCode
+        const head = Buffer.alloc(16);
+        head.writeInt32LE(16 + body.length, 0);
+        head.writeInt32LE(1, 4);
+        head.writeInt32LE(2004, 12);
+        return Buffer.concat([head, body]);
+    }
+    /** The opCode of a reply chunk (-1 when it is shorter than a message header). */
+    static replyOpCode(data) {
+        return data.length >= 16 ? data.readInt32LE(12) : -1;
+    }
+    /** Whether the reply is a MongoDB server message: OP_REPLY (1) or OP_MSG (2013). */
+    static isValidReply(data) {
+        const opCode = DyNTS_MongoHandshakeProbe_Util.replyOpCode(data);
+        return opCode === 1 || opCode === 2013;
+    }
+    /**
+     * Probes one address. Never rejects: every failure is an outcome, the raw network code stays in `errorCode`.
+     */
+    static probe(set) {
+        const started = Date.now();
+        const timeoutMs = set.timeoutMs ?? DyNTS_MongoHandshakeProbe_Util.defaultTimeoutMs;
+        return new Promise((resolve) => {
+            let connected = false;
+            let settled = false;
+            const socket = net.connect({ host: set.host, port: set.port });
+            /** Resolves once, and always closes the socket. */
+            const finish = (result) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                socket.destroy();
+                resolve({ ...result, connected: connected, ms: Date.now() - started });
+            };
+            socket.setTimeout(timeoutMs);
+            socket.on('connect', () => {
+                connected = true;
+                socket.write(DyNTS_MongoHandshakeProbe_Util.buildIsMasterFrame());
+            });
+            socket.once('data', (data) => {
+                const valid = DyNTS_MongoHandshakeProbe_Util.isValidReply(data);
+                finish({
+                    outcome: valid ? mongo_handshake_outcome_enum_1.DyNTS_MongoHandshakeOutcome_Enum.ok : mongo_handshake_outcome_enum_1.DyNTS_MongoHandshakeOutcome_Enum.protocolMismatch,
+                    ok: valid,
+                    opCode: DyNTS_MongoHandshakeProbe_Util.replyOpCode(data),
+                    replyBytes: data.length,
+                });
+            });
+            socket.on('timeout', () => {
+                // the difference IS the point: connected-but-silent is another fault than a closed / unreachable port
+                finish({
+                    outcome: connected
+                        ? mongo_handshake_outcome_enum_1.DyNTS_MongoHandshakeOutcome_Enum.connectedButSilent
+                        : mongo_handshake_outcome_enum_1.DyNTS_MongoHandshakeOutcome_Enum.noConnection,
+                    ok: false,
+                });
+            });
+            socket.on('error', (error) => {
+                finish({
+                    outcome: mongo_handshake_outcome_enum_1.DyNTS_MongoHandshakeOutcome_Enum.networkError,
+                    ok: false,
+                    errorCode: error.code ?? error.message,
+                });
+            });
+        });
+    }
+}
+exports.DyNTS_MongoHandshakeProbe_Util = DyNTS_MongoHandshakeProbe_Util;
+//# sourceMappingURL=mongo-handshake-probe.util.js.map

package/build/_collections/mongo-handshake-probe.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-handshake-probe.util.js","sourceRoot":"","sources":["../../src/_collections/mongo-handshake-probe.util.ts"],"names":[],"mappings":"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"}

package/build/_enums/mongo-handshake-outcome.enum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The outcome of a MongoDB handshake probe (`DyNTS_MongoHandshakeProbe_Util`, BFR-CCAPREVISIONED-024).
+ *
+ * ⚠️ `connectedButSilent` is its own outcome on purpose: the TCP connection was made, but no handshake reply came.
+ * Measured 2026-09-18 (PLO-KOON): the port opened in 3 ms and the handshake never finished - a TCP-only check would
+ * have called that healthy.
+ */
+export declare enum DyNTS_MongoHandshakeOutcome_Enum {
+    /** A valid server reply (OP_REPLY or OP_MSG) to `isMaster`. */
+    ok = "ok",
+    /** TCP connected, but no reply within the timeout. */
+    connectedButSilent = "connected-but-silent",
+    /** Something replied, but not with a MongoDB message (another service on the port). */
+    protocolMismatch = "protocol-mismatch",
+    /** No TCP connection within the timeout. */
+    noConnection = "no-connection",
+    /** The connection failed with a network error - its raw code is in `errorCode`. */
+    networkError = "network-error"
+}
+//# sourceMappingURL=mongo-handshake-outcome.enum.d.ts.map

package/build/_enums/mongo-handshake-outcome.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-handshake-outcome.enum.d.ts","sourceRoot":"","sources":["../../src/_enums/mongo-handshake-outcome.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,oBAAY,gCAAgC;IAC1C,+DAA+D;IAC/D,EAAE,OAAO;IACT,sDAAsD;IACtD,kBAAkB,yBAAyB;IAC3C,uFAAuF;IACvF,gBAAgB,sBAAsB;IACtC,4CAA4C;IAC5C,YAAY,kBAAkB;IAC9B,mFAAmF;IACnF,YAAY,kBAAkB;CAC/B"}

package/build/_enums/mongo-handshake-outcome.enum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_MongoHandshakeOutcome_Enum = void 0;
+/**
+ * The outcome of a MongoDB handshake probe (`DyNTS_MongoHandshakeProbe_Util`, BFR-CCAPREVISIONED-024).
+ *
+ * ⚠️ `connectedButSilent` is its own outcome on purpose: the TCP connection was made, but no handshake reply came.
+ * Measured 2026-09-18 (PLO-KOON): the port opened in 3 ms and the handshake never finished - a TCP-only check would
+ * have called that healthy.
+ */
+var DyNTS_MongoHandshakeOutcome_Enum;
+(function (DyNTS_MongoHandshakeOutcome_Enum) {
+    /** A valid server reply (OP_REPLY or OP_MSG) to `isMaster`. */
+    DyNTS_MongoHandshakeOutcome_Enum["ok"] = "ok";
+    /** TCP connected, but no reply within the timeout. */
+    DyNTS_MongoHandshakeOutcome_Enum["connectedButSilent"] = "connected-but-silent";
+    /** Something replied, but not with a MongoDB message (another service on the port). */
+    DyNTS_MongoHandshakeOutcome_Enum["protocolMismatch"] = "protocol-mismatch";
+    /** No TCP connection within the timeout. */
+    DyNTS_MongoHandshakeOutcome_Enum["noConnection"] = "no-connection";
+    /** The connection failed with a network error - its raw code is in `errorCode`. */
+    DyNTS_MongoHandshakeOutcome_Enum["networkError"] = "network-error";
+})(DyNTS_MongoHandshakeOutcome_Enum || (exports.DyNTS_MongoHandshakeOutcome_Enum = DyNTS_MongoHandshakeOutcome_Enum = {}));
+//# sourceMappingURL=mongo-handshake-outcome.enum.js.map

package/build/_enums/mongo-handshake-outcome.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-handshake-outcome.enum.js","sourceRoot":"","sources":["../../src/_enums/mongo-handshake-outcome.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,IAAY,gCAWX;AAXD,WAAY,gCAAgC;IAC1C,+DAA+D;IAC/D,6CAAS,CAAA;IACT,sDAAsD;IACtD,+EAA2C,CAAA;IAC3C,uFAAuF;IACvF,0EAAsC,CAAA;IACtC,4CAA4C;IAC5C,kEAA8B,CAAA;IAC9B,mFAAmF;IACnF,kEAA8B,CAAA;AAChC,CAAC,EAXW,gCAAgC,gDAAhC,gCAAgC,QAW3C"}

package/build/_models/interfaces/mongo-handshake-result.interface.d.ts

@@ -0,0 +1,17 @@
+import { DyNTS_MongoHandshakeOutcome_Enum } from '../../_enums/mongo-handshake-outcome.enum';
+/** The result of one MongoDB handshake probe (BFR-CCAPREVISIONED-024). */
+export interface DyNTS_MongoHandshakeResult_Interface {
+    outcome: DyNTS_MongoHandshakeOutcome_Enum;
+    /** `true` only for `ok` - a valid MongoDB reply. */
+    ok: boolean;
+    /** Whether the TCP connection was made (tells `connected-but-silent` apart from `no-connection`). */
+    connected: boolean;
+    /** The opCode of the reply (1 = OP_REPLY, 2013 = OP_MSG), when a reply came. */
+    opCode?: number;
+    /** The size of the first reply chunk in bytes, when a reply came. */
+    replyBytes?: number;
+    /** The RAW network error code (`ECONNREFUSED`, `ENOTFOUND` ...) - the classification is left to the caller. */
+    errorCode?: string;
+    ms: number;
+}
+//# sourceMappingURL=mongo-handshake-result.interface.d.ts.map

package/build/_models/interfaces/mongo-handshake-result.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-handshake-result.interface.d.ts","sourceRoot":"","sources":["../../../src/_models/interfaces/mongo-handshake-result.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAE7F,0EAA0E;AAC1E,MAAM,WAAW,oCAAoC;IACnD,OAAO,EAAE,gCAAgC,CAAC;IAC1C,oDAAoD;IACpD,EAAE,EAAE,OAAO,CAAC;IACZ,qGAAqG;IACrG,SAAS,EAAE,OAAO,CAAC;IACnB,gFAAgF;IAChF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+GAA+G;IAC/G,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/build/_models/interfaces/mongo-handshake-result.interface.js

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

package/build/_models/interfaces/mongo-handshake-result.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-handshake-result.interface.js","sourceRoot":"","sources":["../../../src/_models/interfaces/mongo-handshake-result.interface.ts"],"names":[],"mappings":""}

package/build/index.d.ts

@@ -11,6 +11,7 @@ export * from './_enums/email-submission-outcome.enum';
 export * from './_enums/data-model-type.enum';
 export * from './_enums/data-service-function.enum';
 export * from './_enums/dependency-check-mode.enum';
+export * from './_enums/mongo-handshake-outcome.enum';
 export * from './_enums/predefined-data-types.enum';
 export * from './_enums/route-security.enum';
 /** Interfaces describing global configuration and certificates. */
@@ -25,6 +26,7 @@ export * from './_models/interfaces/environment-settings.interface';
 export * from './_models/interfaces/global-service-settings.interface';
 export * from './_models/interfaces/global-settings.interface';
 export * from './_models/interfaces/routing-module-settings.interface';
+export * from './_models/interfaces/mongo-handshake-result.interface';
 export * from './_models/interfaces/signed-url-verify-result.interface';
 export * from './_models/interfaces/socket-server-options.interface';
 export * from './_models/interfaces/static-client-settings.interface';
@@ -61,6 +63,7 @@ export * from './_collections/client-safe-error-response.interface';
 export * from './_collections/header-size-measurement.interface';
 export * from './_collections/load-shed.util';
 export * from './_collections/database-unavailable.util';
+export * from './_collections/mongo-handshake-probe.util';
 export * from './_collections/db-error-detail.util';
 export * from './_collections/db-plain-data.util';
 export * from './_collections/email-account.util';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA2BA,cAAc,6BAA6B,CAAC;AAC5C,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qDAAqD,CAAC;AACpE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,0CAA0C,CAAC;AACzD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,sCAAsC,CAAC;AAIrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,qCAAqC,CAAC;AACpD,cAAc,8BAA8B,CAAC;AAK7C,mEAAmE;AACnE,cAAc,yDAAyD,CAAC;AACxE,cAAc,mDAAmD,CAAC;AAClE,cAAc,iEAAiE,CAAC;AAChF,cAAc,oDAAoD,CAAC;AACnE,cAAc,qDAAqD,CAAC;AACpE,cAAc,uDAAuD,CAAC;AACtE,cAAc,uDAAuD,CAAC;AACtE,cAAc,qDAAqD,CAAC;AACpE,cAAc,wDAAwD,CAAC;AACvE,cAAc,gDAAgD,CAAC;AAC/D,cAAc,wDAAwD,CAAC;AACvE,cAAc,uDAAuD,CAAC;AACtE,cAAc,yDAAyD,CAAC;AACxE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AACtE,cAAc,8CAA8C,CAAC;AAC7D,cAAc,0DAA0D,CAAC;AACzE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,2DAA2D,CAAC;AAC1E,cAAc,iDAAiD,CAAC;AAChE,cAAc,iDAAiD,CAAC;AAChE,cAAc,oDAAoD,CAAC;AACnE,cAAc,+CAA+C,CAAC;AAC9D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,2DAA2D,CAAC;AAC1E,cAAc,sCAAsC,CAAC;AACrD,cAAc,wCAAwC,CAAC;AACvD,cAAc,mCAAmC,CAAC;AAClD,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,uCAAuC,CAAC;AACtD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,oCAAoC,CAAC;AAEnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,+CAA+C,CAAC;AAC9D,cAAc,8BAA8B,CAAC;AAC7C,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,qDAAqD,CAAC;AACpE,cAAc,kDAAkD,CAAC;AACjE,cAAc,+BAA+B,CAAC;AAC9C,cAAc,0CAA0C,CAAC;AACzD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,mCAAmC,CAAC;AAClD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,uCAAuC,CAAC;AACtD,cAAc,oCAAoC,CAAC;AACnD,cAAc,0CAA0C,CAAC;AACzD,cAAc,yCAAyC,CAAC;AACxD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AAGrD,cAAc,wDAAwD,CAAC;AACvE,cAAc,gEAAgE,CAAC;AAC/E,cAAc,mDAAmD,CAAC;AAClE,cAAc,4DAA4D,CAAC;AAC3E,cAAc,wDAAwD,CAAC;AACvE,cAAc,sDAAsD,CAAC;AACrE,cAAc,uDAAuD,CAAC;AAGtE,cAAc,gCAAgC,CAAC;AAG/C,cAAc,mDAAmD,CAAC;AAKlE,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+BAA+B,CAAC;AAE9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oDAAoD,CAAC;AACnE,cAAc,iCAAiC,CAAC;AAChD,cAAc,uCAAuC,CAAC;AACtD,cAAc,oDAAoD,CAAC;AAEnE,cAAc,6CAA6C,CAAC;AAC5D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,oDAAoD,CAAC;AAGnE,cAAc,mCAAmC,CAAC;AAClD,cAAc,uCAAuC,CAAC;AACtD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yCAAyC,CAAC;AACxD,cAAc,oCAAoC,CAAC;AAGnD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,yCAAyC,CAAC;AAGxD,cAAc,sCAAsC,CAAC;AACrD,cAAc,0CAA0C,CAAC;AAGzD,cAAc,mCAAmC,CAAC"}

package/build/index.js

@@ -39,6 +39,7 @@ tslib_1.__exportStar(require("./_enums/email-submission-outcome.enum"), exports)
 tslib_1.__exportStar(require("./_enums/data-model-type.enum"), exports);
 tslib_1.__exportStar(require("./_enums/data-service-function.enum"), exports);
 tslib_1.__exportStar(require("./_enums/dependency-check-mode.enum"), exports);
+tslib_1.__exportStar(require("./_enums/mongo-handshake-outcome.enum"), exports);
 tslib_1.__exportStar(require("./_enums/predefined-data-types.enum"), exports);
 tslib_1.__exportStar(require("./_enums/route-security.enum"), exports);
 // MODELS (CONTROL-MODELS, INTERFACES, TYPES)
@@ -54,6 +55,7 @@ tslib_1.__exportStar(require("./_models/interfaces/environment-settings.interfac
 tslib_1.__exportStar(require("./_models/interfaces/global-service-settings.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/global-settings.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/routing-module-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/mongo-handshake-result.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/signed-url-verify-result.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/socket-server-options.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/static-client-settings.interface"), exports);
@@ -91,6 +93,7 @@ tslib_1.__exportStar(require("./_collections/client-safe-error-response.interfac
 tslib_1.__exportStar(require("./_collections/header-size-measurement.interface"), exports);
 tslib_1.__exportStar(require("./_collections/load-shed.util"), exports);
 tslib_1.__exportStar(require("./_collections/database-unavailable.util"), exports);
+tslib_1.__exportStar(require("./_collections/mongo-handshake-probe.util"), exports);
 tslib_1.__exportStar(require("./_collections/db-error-detail.util"), exports);
 tslib_1.__exportStar(require("./_collections/db-plain-data.util"), exports);
 tslib_1.__exportStar(require("./_collections/email-account.util"), exports);

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;IAsBI;;;AAEJ,cAAc;AACd,sEAA4C;AAC5C,+EAAqD;AACrD,8EAAoD;AACpD,wFAA8D;AAC9D,8FAAoE;AACpE,sFAA4D;AAC5D,mFAAyD;AACzD,uFAA6D;AAC7D,+EAAqD;AAGrD,QAAQ;AACR,iFAAuD;AACvD,wEAA8C;AAC9C,8EAAoD;AACpD,8EAAoD;AACpD,8EAAoD;AACpD,uEAA6C;AAG7C,6CAA6C;AAE7C,mEAAmE;AACnE,kGAAwE;AACxE,4FAAkE;AAClE,0GAAgF;AAChF,6FAAmE;AACnE,8FAAoE;AACpE,gGAAsE;AACtE,gGAAsE;AACtE,8FAAoE;AACpE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AACvE,kGAAwE;AACxE,+FAAqE;AACrE,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,qGAA2E;AAC3E,oGAA0E;AAC1E,oGAA0E;AAC1E,0FAAgE;AAChE,0FAAgE;AAChE,6FAAmE;AACnE,wFAA8D;AAC9D,yFAA+D;AAC/D,oGAA0E;AAC1E,+EAAqD;AACrD,iFAAuD;AACvD,4EAAkD;AAClD,mFAAyD;AACzD,oFAA0D;AAC1D,yEAA+C;AAC/C,gFAAsD;AACtD,0EAAgD;AAChD,wEAA8C;AAC9C,6EAAmD;AACnD,mHAAmH;AACnH,+EAAqD;AACrD,4EAAkD;AAClD,wFAA8D;AAC9D,uEAA6C;AAC7C,2EAAiD;AACjD,6EAAmD;AACnD,8EAAoD;AACpD,4EAAkD;AAClD,8FAAoE;AACpE,2FAAiE;AACjE,wEAA8C;AAC9C,mFAAyD;AACzD,8EAAoD;AACpD,4EAAkD;AAClD,4EAAkD;AAClD,+EAAqD;AACrD,oFAA0D;AAC1D,gFAAsD;AACtD,6EAAmD;AACnD,mFAAyD;AACzD,kFAAwD;AACxD,4EAAkD;AAClD,+EAAqD;AAErD,wBAAwB;AACxB,iGAAuE;AACvE,yGAA+E;AAC/E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AACf,yEAA+C;AAE/C,qBAAqB;AACrB,4FAAkE;AAGlE,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAE9C,yEAA+C;AAC/C,6FAAmE;AACnE,0EAAgD;AAChD,gFAAsD;AACtD,6FAAmE;AAEnE,sFAA4D;AAC5D,oFAA0D;AAC1D,6FAAmE;AAEnE,gBAAgB;AAChB,4EAAkD;AAClD,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,kFAAwD;AACxD,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAC9C,wFAA8D;AAC9D,kFAAwD;AAExD,iBAAiB;AACjB,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;;;IAsBI;;;AAEJ,cAAc;AACd,sEAA4C;AAC5C,+EAAqD;AACrD,8EAAoD;AACpD,wFAA8D;AAC9D,8FAAoE;AACpE,sFAA4D;AAC5D,mFAAyD;AACzD,uFAA6D;AAC7D,+EAAqD;AAGrD,QAAQ;AACR,iFAAuD;AACvD,wEAA8C;AAC9C,8EAAoD;AACpD,8EAAoD;AACpD,gFAAsD;AACtD,8EAAoD;AACpD,uEAA6C;AAG7C,6CAA6C;AAE7C,mEAAmE;AACnE,kGAAwE;AACxE,4FAAkE;AAClE,0GAAgF;AAChF,6FAAmE;AACnE,8FAAoE;AACpE,gGAAsE;AACtE,gGAAsE;AACtE,8FAAoE;AACpE,iGAAuE;AACvE,yFAA+D;AAC/D,iGAAuE;AACvE,gGAAsE;AACtE,kGAAwE;AACxE,+FAAqE;AACrE,gGAAsE;AACtE,uFAA6D;AAC7D,mGAAyE;AACzE,qGAA2E;AAC3E,oGAA0E;AAC1E,oGAA0E;AAC1E,0FAAgE;AAChE,0FAAgE;AAChE,6FAAmE;AACnE,wFAA8D;AAC9D,yFAA+D;AAC/D,oGAA0E;AAC1E,+EAAqD;AACrD,iFAAuD;AACvD,4EAAkD;AAClD,mFAAyD;AACzD,oFAA0D;AAC1D,yEAA+C;AAC/C,gFAAsD;AACtD,0EAAgD;AAChD,wEAA8C;AAC9C,6EAAmD;AACnD,mHAAmH;AACnH,+EAAqD;AACrD,4EAAkD;AAClD,wFAA8D;AAC9D,uEAA6C;AAC7C,2EAAiD;AACjD,6EAAmD;AACnD,8EAAoD;AACpD,4EAAkD;AAClD,8FAAoE;AACpE,2FAAiE;AACjE,wEAA8C;AAC9C,mFAAyD;AACzD,oFAA0D;AAC1D,8EAAoD;AACpD,4EAAkD;AAClD,4EAAkD;AAClD,+EAAqD;AACrD,oFAA0D;AAC1D,gFAAsD;AACtD,6EAAmD;AACnD,mFAAyD;AACzD,kFAAwD;AACxD,4EAAkD;AAClD,+EAAqD;AAErD,wBAAwB;AACxB,iGAAuE;AACvE,yGAA+E;AAC/E,4FAAkE;AAClE,qGAA2E;AAC3E,iGAAuE;AACvE,+FAAqE;AACrE,gGAAsE;AAEtE,eAAe;AACf,yEAA+C;AAE/C,qBAAqB;AACrB,4FAAkE;AAGlE,WAAW;AACX,gBAAgB;AAChB,uEAA6C;AAC7C,wEAA8C;AAE9C,yEAA+C;AAC/C,6FAAmE;AACnE,0EAAgD;AAChD,gFAAsD;AACtD,6FAAmE;AAEnE,sFAA4D;AAC5D,oFAA0D;AAC1D,6FAAmE;AAEnE,gBAAgB;AAChB,4EAAkD;AAClD,gFAAsD;AACtD,wEAA8C;AAC9C,sEAA4C;AAC5C,kFAAwD;AACxD,6EAAmD;AAEnD,kBAAkB;AAClB,wEAA8C;AAC9C,wFAA8D;AAC9D,kFAAwD;AAExD,iBAAiB;AACjB,+EAAqD;AACrD,mFAAyD;AAEzD,kBAAkB;AAClB,4EAAkD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.454",
+  "version": "01.15.455",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",
@@ -553,7 +553,7 @@
     }
   },
   "devDependencies": {
-    "@futdevpro/fsm-dynamo": "1.20.139",
+    "@futdevpro/fsm-dynamo": "1.20.140",
     "@futdevpro/dynamo-eslint": "1.20.74",
     "@discordjs/opus": "^0.10.0",
     "@discordjs/voice": "^0.18.0",