@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_modules/server/index.d.ts

@@ -1,16 +1,16 @@
-export * from './errors/errors.controller';
-export * from './errors/errors.control-service';
-export * from './errors/errors.data-service';
-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';
-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';
-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 './errors/errors.controller';
+export * from './errors/errors.control-service';
+export * from './errors/errors.data-service';
+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';
+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';
+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';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/server/index.js

@@ -1,36 +1,36 @@
-"use strict";
-//
-// Server module
-//
-// This module contains solutions for basic server endpoints such as:
-//
-// - Errors; 
-//     saving and retrieving errors that are occuring on the server
-//
-// - Server Status; 
-//     retrieving the status of the server
-//
-// - Server Status Snapshot; 
-//     saving and retrieving the status of the server at a specific time
-//
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-// ERRORS
-tslib_1.__exportStar(require("./errors/errors.controller"), exports);
-tslib_1.__exportStar(require("./errors/errors.control-service"), exports);
-tslib_1.__exportStar(require("./errors/errors.data-service"), exports);
-// SERVER-STATUS
-tslib_1.__exportStar(require("./server-status/db-readiness-probe-code.type-enum"), exports);
-tslib_1.__exportStar(require("./server-status/db-readiness-probe-stage.type-enum"), exports);
-tslib_1.__exportStar(require("./server-status/db-readiness-probe.interface"), exports);
-tslib_1.__exportStar(require("./server-status/db-readiness-probe.control-service"), exports);
-tslib_1.__exportStar(require("./server-status/server-status-snapshot.data-service"), exports);
-tslib_1.__exportStar(require("./server-status/server-status-snapshot.control-service"), exports);
-tslib_1.__exportStar(require("./server-status/server-status.control-service"), exports);
-tslib_1.__exportStar(require("./server-status/server-status.controller"), exports);
-// SAFE-DIAGNOSTIC
-tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic-cause.type-enum"), exports);
-tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic-stage.type-enum"), exports);
-tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic.interface"), exports);
-tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic.control-service"), exports);
+"use strict";
+//
+// Server module
+//
+// This module contains solutions for basic server endpoints such as:
+//
+// - Errors; 
+//     saving and retrieving errors that are occuring on the server
+//
+// - Server Status; 
+//     retrieving the status of the server
+//
+// - Server Status Snapshot; 
+//     saving and retrieving the status of the server at a specific time
+//
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// ERRORS
+tslib_1.__exportStar(require("./errors/errors.controller"), exports);
+tslib_1.__exportStar(require("./errors/errors.control-service"), exports);
+tslib_1.__exportStar(require("./errors/errors.data-service"), exports);
+// SERVER-STATUS
+tslib_1.__exportStar(require("./server-status/db-readiness-probe-code.type-enum"), exports);
+tslib_1.__exportStar(require("./server-status/db-readiness-probe-stage.type-enum"), exports);
+tslib_1.__exportStar(require("./server-status/db-readiness-probe.interface"), exports);
+tslib_1.__exportStar(require("./server-status/db-readiness-probe.control-service"), exports);
+tslib_1.__exportStar(require("./server-status/server-status-snapshot.data-service"), exports);
+tslib_1.__exportStar(require("./server-status/server-status-snapshot.control-service"), exports);
+tslib_1.__exportStar(require("./server-status/server-status.control-service"), exports);
+tslib_1.__exportStar(require("./server-status/server-status.controller"), exports);
+// SAFE-DIAGNOSTIC
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic-cause.type-enum"), exports);
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic-stage.type-enum"), exports);
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic.interface"), exports);
+tslib_1.__exportStar(require("./safe-diagnostic/safe-diagnostic.control-service"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1,9 +1,9 @@
-/** Stable, content-free classifications for framework-owned failures. */
-export declare 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 declare enum DyNTS_SafeDiagnosticCause_Type {
+    dynamoError = "dynamo-error",
+    nativeError = "native-error",
+    object = "object",
+    primitive = "primitive",
+    unknown = "unknown"
+}
 //# sourceMappingURL=safe-diagnostic-cause.type-enum.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic-cause.type-enum.js

@@ -1,13 +1,13 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_SafeDiagnosticCause_Type = void 0;
-/** Stable, content-free classifications for framework-owned failures. */
-var DyNTS_SafeDiagnosticCause_Type;
-(function (DyNTS_SafeDiagnosticCause_Type) {
-    DyNTS_SafeDiagnosticCause_Type["dynamoError"] = "dynamo-error";
-    DyNTS_SafeDiagnosticCause_Type["nativeError"] = "native-error";
-    DyNTS_SafeDiagnosticCause_Type["object"] = "object";
-    DyNTS_SafeDiagnosticCause_Type["primitive"] = "primitive";
-    DyNTS_SafeDiagnosticCause_Type["unknown"] = "unknown";
-})(DyNTS_SafeDiagnosticCause_Type || (exports.DyNTS_SafeDiagnosticCause_Type = DyNTS_SafeDiagnosticCause_Type = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_SafeDiagnosticCause_Type = void 0;
+/** Stable, content-free classifications for framework-owned failures. */
+var DyNTS_SafeDiagnosticCause_Type;
+(function (DyNTS_SafeDiagnosticCause_Type) {
+    DyNTS_SafeDiagnosticCause_Type["dynamoError"] = "dynamo-error";
+    DyNTS_SafeDiagnosticCause_Type["nativeError"] = "native-error";
+    DyNTS_SafeDiagnosticCause_Type["object"] = "object";
+    DyNTS_SafeDiagnosticCause_Type["primitive"] = "primitive";
+    DyNTS_SafeDiagnosticCause_Type["unknown"] = "unknown";
+})(DyNTS_SafeDiagnosticCause_Type || (exports.DyNTS_SafeDiagnosticCause_Type = DyNTS_SafeDiagnosticCause_Type = {}));
 //# sourceMappingURL=safe-diagnostic-cause.type-enum.js.map

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

@@ -1,20 +1,21 @@
-/** Framework stages that may emit a content-free diagnostic. */
-export declare 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 declare enum DyNTS_SafeDiagnosticStage_Type {
+    bootstrap = "bootstrap",
+    collectionGrowthMonitor = "collection-growth-monitor",
+    databaseConnect = "database-connect",
+    databaseRuntime = "database-runtime",
+    eventLoopDiagnostic = "event-loop-diagnostic",
+    endpoint = "endpoint",
+    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"
+}
 //# sourceMappingURL=safe-diagnostic-stage.type-enum.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"safe-diagnostic-stage.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oBAAY,8BAA8B;IACxC,SAAS,cAAc;IACvB,uBAAuB,8BAA8B;IACrD,eAAe,qBAAqB;IACpC,eAAe,qBAAqB;IACpC,mBAAmB,0BAA0B;IAC7C,eAAe,qBAAqB;IACpC,kBAAkB,yBAAyB;IAC3C,UAAU,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,mBAAmB,0BAA0B;IAC7C,WAAW,iBAAiB;IAC5B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,kBAAkB,wBAAwB;CAC3C"}
+{"version":3,"file":"safe-diagnostic-stage.type-enum.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,oBAAY,8BAA8B;IACxC,SAAS,cAAc;IACvB,uBAAuB,8BAA8B;IACrD,eAAe,qBAAqB;IACpC,eAAe,qBAAqB;IACpC,mBAAmB,0BAA0B;IAC7C,QAAQ,aAAa;IACrB,eAAe,qBAAqB;IACpC,kBAAkB,yBAAyB;IAC3C,UAAU,gBAAgB;IAC1B,WAAW,iBAAiB;IAC5B,WAAW,iBAAiB;IAC5B,mBAAmB,0BAA0B;IAC7C,WAAW,iBAAiB;IAC5B,SAAS,cAAc;IACvB,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,kBAAkB,wBAAwB;CAC3C"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.js

@@ -1,24 +1,25 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_SafeDiagnosticStage_Type = void 0;
-/** Framework stages that may emit a content-free diagnostic. */
-var DyNTS_SafeDiagnosticStage_Type;
-(function (DyNTS_SafeDiagnosticStage_Type) {
-    DyNTS_SafeDiagnosticStage_Type["bootstrap"] = "bootstrap";
-    DyNTS_SafeDiagnosticStage_Type["collectionGrowthMonitor"] = "collection-growth-monitor";
-    DyNTS_SafeDiagnosticStage_Type["databaseConnect"] = "database-connect";
-    DyNTS_SafeDiagnosticStage_Type["databaseRuntime"] = "database-runtime";
-    DyNTS_SafeDiagnosticStage_Type["eventLoopDiagnostic"] = "event-loop-diagnostic";
-    DyNTS_SafeDiagnosticStage_Type["expressFallback"] = "express-fallback";
-    DyNTS_SafeDiagnosticStage_Type["globalErrorHandler"] = "global-error-handler";
-    DyNTS_SafeDiagnosticStage_Type["httpServer"] = "http-server";
-    DyNTS_SafeDiagnosticStage_Type["httpsServer"] = "https-server";
-    DyNTS_SafeDiagnosticStage_Type["memoryGuard"] = "memory-guard";
-    DyNTS_SafeDiagnosticStage_Type["mongoReconnectGuard"] = "mongo-reconnect-guard";
-    DyNTS_SafeDiagnosticStage_Type["postProcess"] = "post-process";
-    DyNTS_SafeDiagnosticStage_Type["readiness"] = "readiness";
-    DyNTS_SafeDiagnosticStage_Type["retention"] = "retention";
-    DyNTS_SafeDiagnosticStage_Type["routing"] = "routing";
-    DyNTS_SafeDiagnosticStage_Type["unhandledRejection"] = "unhandled-rejection";
-})(DyNTS_SafeDiagnosticStage_Type || (exports.DyNTS_SafeDiagnosticStage_Type = DyNTS_SafeDiagnosticStage_Type = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_SafeDiagnosticStage_Type = void 0;
+/** Framework stages that may emit a content-free diagnostic. */
+var DyNTS_SafeDiagnosticStage_Type;
+(function (DyNTS_SafeDiagnosticStage_Type) {
+    DyNTS_SafeDiagnosticStage_Type["bootstrap"] = "bootstrap";
+    DyNTS_SafeDiagnosticStage_Type["collectionGrowthMonitor"] = "collection-growth-monitor";
+    DyNTS_SafeDiagnosticStage_Type["databaseConnect"] = "database-connect";
+    DyNTS_SafeDiagnosticStage_Type["databaseRuntime"] = "database-runtime";
+    DyNTS_SafeDiagnosticStage_Type["eventLoopDiagnostic"] = "event-loop-diagnostic";
+    DyNTS_SafeDiagnosticStage_Type["endpoint"] = "endpoint";
+    DyNTS_SafeDiagnosticStage_Type["expressFallback"] = "express-fallback";
+    DyNTS_SafeDiagnosticStage_Type["globalErrorHandler"] = "global-error-handler";
+    DyNTS_SafeDiagnosticStage_Type["httpServer"] = "http-server";
+    DyNTS_SafeDiagnosticStage_Type["httpsServer"] = "https-server";
+    DyNTS_SafeDiagnosticStage_Type["memoryGuard"] = "memory-guard";
+    DyNTS_SafeDiagnosticStage_Type["mongoReconnectGuard"] = "mongo-reconnect-guard";
+    DyNTS_SafeDiagnosticStage_Type["postProcess"] = "post-process";
+    DyNTS_SafeDiagnosticStage_Type["readiness"] = "readiness";
+    DyNTS_SafeDiagnosticStage_Type["retention"] = "retention";
+    DyNTS_SafeDiagnosticStage_Type["routing"] = "routing";
+    DyNTS_SafeDiagnosticStage_Type["unhandledRejection"] = "unhandled-rejection";
+})(DyNTS_SafeDiagnosticStage_Type || (exports.DyNTS_SafeDiagnosticStage_Type = DyNTS_SafeDiagnosticStage_Type = {}));
 //# sourceMappingURL=safe-diagnostic-stage.type-enum.js.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"safe-diagnostic-stage.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts"],"names":[],"mappings":";;;AAAA,gEAAgE;AAChE,IAAY,8BAiBX;AAjBD,WAAY,8BAA8B;IACxC,yDAAuB,CAAA;IACvB,uFAAqD,CAAA;IACrD,sEAAoC,CAAA;IACpC,sEAAoC,CAAA;IACpC,+EAA6C,CAAA;IAC7C,sEAAoC,CAAA;IACpC,6EAA2C,CAAA;IAC3C,4DAA0B,CAAA;IAC1B,8DAA4B,CAAA;IAC5B,8DAA4B,CAAA;IAC5B,+EAA6C,CAAA;IAC7C,8DAA4B,CAAA;IAC5B,yDAAuB,CAAA;IACvB,yDAAuB,CAAA;IACvB,qDAAmB,CAAA;IACnB,4EAA0C,CAAA;AAC5C,CAAC,EAjBW,8BAA8B,8CAA9B,8BAA8B,QAiBzC"}
+{"version":3,"file":"safe-diagnostic-stage.type-enum.js","sourceRoot":"","sources":["../../../../src/_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum.ts"],"names":[],"mappings":";;;AAAA,gEAAgE;AAChE,IAAY,8BAkBX;AAlBD,WAAY,8BAA8B;IACxC,yDAAuB,CAAA;IACvB,uFAAqD,CAAA;IACrD,sEAAoC,CAAA;IACpC,sEAAoC,CAAA;IACpC,+EAA6C,CAAA;IAC7C,uDAAqB,CAAA;IACrB,sEAAoC,CAAA;IACpC,6EAA2C,CAAA;IAC3C,4DAA0B,CAAA;IAC1B,8DAA4B,CAAA;IAC5B,8DAA4B,CAAA;IAC5B,+EAA6C,CAAA;IAC7C,8DAA4B,CAAA;IAC5B,yDAAuB,CAAA;IACvB,yDAAuB,CAAA;IACvB,qDAAmB,CAAA;IACnB,4EAA0C,CAAA;AAC5C,CAAC,EAlBW,8BAA8B,8CAA9B,8BAA8B,QAkBzC"}

package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.d.ts

@@ -1,19 +1,19 @@
-import { DyFM_Error } from '@futdevpro/fsm-dynamo';
-import { DyNTS_SafeDiagnosticInput_Interface, DyNTS_SafeDiagnostic_Interface } from './safe-diagnostic.interface';
-/** Projects arbitrary failures to a versioned, content-free public diagnostic. */
-export declare class DyNTS_SafeDiagnostic_ControlService {
-    private static readonly contractVersion;
-    private static readonly defaultCode;
-    private static readonly defaultStatus;
-    /** Returns an immutable exact allowlist and never reflects raw failure content. */
-    static project(input: DyNTS_SafeDiagnosticInput_Interface): DyNTS_SafeDiagnostic_Interface;
-    /** Logs only the projected allowlist and returns the same immutable diagnostic. */
-    static report(input: DyNTS_SafeDiagnosticInput_Interface): DyNTS_SafeDiagnostic_Interface;
-    /** Creates a framework error that carries only the safe diagnostic allowlist. */
-    static toError(diagnostic: DyNTS_SafeDiagnostic_Interface): DyFM_Error;
-    private static getCode;
-    private static getCauseType;
-    private static getStatus;
-    private static getFingerprint;
-}
+import { DyFM_Error } from '@futdevpro/fsm-dynamo';
+import { DyNTS_SafeDiagnosticInput_Interface, DyNTS_SafeDiagnostic_Interface } from './safe-diagnostic.interface';
+/** Projects arbitrary failures to a versioned, content-free public diagnostic. */
+export declare class DyNTS_SafeDiagnostic_ControlService {
+    private static readonly contractVersion;
+    private static readonly defaultCode;
+    private static readonly defaultStatus;
+    /** Returns an immutable exact allowlist and never reflects raw failure content. */
+    static project(input: DyNTS_SafeDiagnosticInput_Interface): DyNTS_SafeDiagnostic_Interface;
+    /** Logs only the projected allowlist and returns the same immutable diagnostic. */
+    static report(input: DyNTS_SafeDiagnosticInput_Interface): DyNTS_SafeDiagnostic_Interface;
+    /** Creates a framework error that carries only the safe diagnostic allowlist. */
+    static toError(diagnostic: DyNTS_SafeDiagnostic_Interface): DyFM_Error;
+    private static getCode;
+    private static getCauseType;
+    private static getStatus;
+    private static getFingerprint;
+}
 //# sourceMappingURL=safe-diagnostic.control-service.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic.control-service.js

@@ -1,83 +1,83 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_SafeDiagnostic_ControlService = void 0;
-const crypto_1 = require("crypto");
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const safe_diagnostic_cause_type_enum_1 = require("./safe-diagnostic-cause.type-enum");
-/** Projects arbitrary failures to a versioned, content-free public diagnostic. */
-class DyNTS_SafeDiagnostic_ControlService {
-    static contractVersion = 'dynts-safe-diagnostic/1';
-    static defaultCode = 'DYNTS_SAFE_DIAGNOSTIC_INVALID_CODE';
-    static defaultStatus = 500;
-    /** Returns an immutable exact allowlist and never reflects raw failure content. */
-    static project(input) {
-        const code = this.getCode(input.code);
-        const causeType = this.getCauseType(input.error);
-        const status = this.getStatus(input.status);
-        const fingerprint = this.getFingerprint([
-            this.contractVersion,
-            code,
-            input.stage,
-            causeType,
-            status.toString(),
-        ]);
-        return Object.freeze({
-            contractVersion: this.contractVersion,
-            code: code,
-            stage: input.stage,
-            causeType: causeType,
-            fingerprint: fingerprint,
-            status: status,
-        });
-    }
-    /** Logs only the projected allowlist and returns the same immutable diagnostic. */
-    static report(input) {
-        const diagnostic = this.project(input);
-        fsm_dynamo_1.DyFM_Log.error('[DyNTS safe diagnostic]', diagnostic);
-        return diagnostic;
-    }
-    /** Creates a framework error that carries only the safe diagnostic allowlist. */
-    static toError(diagnostic) {
-        return new fsm_dynamo_1.DyFM_Error({
-            errorCode: diagnostic.code,
-            message: `Framework failure at ${diagnostic.stage}. Correlation: ${diagnostic.fingerprint}.`,
-            userMessage: 'A server operation failed. Contact the responsible team with the correlation fingerprint.',
-            additionalContent: { diagnostic: diagnostic },
-            status: diagnostic.status,
-        });
-    }
-    static getCode(code) {
-        return /^[A-Z][A-Z0-9_|-]{2,127}$/.test(code) ? code : this.defaultCode;
-    }
-    static getCauseType(error) {
-        try {
-            if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.dynamoError;
-            }
-            if (error instanceof Error) {
-                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.nativeError;
-            }
-            if (error !== null && typeof error === 'object') {
-                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.object;
-            }
-            if (error !== undefined) {
-                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.primitive;
-            }
-        }
-        catch {
-            return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.unknown;
-        }
-        return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.unknown;
-    }
-    static getStatus(status) {
-        if (typeof status !== 'number' || !Number.isInteger(status) || status < 100 || status > 599) {
-            return this.defaultStatus;
-        }
-        return status;
-    }
-    static getFingerprint(subject) {
-        return (0, crypto_1.createHash)('sha256').update(subject.join('\u0000'), 'utf8').digest('hex');
-    }
-}
-exports.DyNTS_SafeDiagnostic_ControlService = DyNTS_SafeDiagnostic_ControlService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_SafeDiagnostic_ControlService = void 0;
+const crypto_1 = require("crypto");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const safe_diagnostic_cause_type_enum_1 = require("./safe-diagnostic-cause.type-enum");
+/** Projects arbitrary failures to a versioned, content-free public diagnostic. */
+class DyNTS_SafeDiagnostic_ControlService {
+    static contractVersion = 'dynts-safe-diagnostic/1';
+    static defaultCode = 'DYNTS_SAFE_DIAGNOSTIC_INVALID_CODE';
+    static defaultStatus = 500;
+    /** Returns an immutable exact allowlist and never reflects raw failure content. */
+    static project(input) {
+        const code = this.getCode(input.code);
+        const causeType = this.getCauseType(input.error);
+        const status = this.getStatus(input.status);
+        const fingerprint = this.getFingerprint([
+            this.contractVersion,
+            code,
+            input.stage,
+            causeType,
+            status.toString(),
+        ]);
+        return Object.freeze({
+            contractVersion: this.contractVersion,
+            code: code,
+            stage: input.stage,
+            causeType: causeType,
+            fingerprint: fingerprint,
+            status: status,
+        });
+    }
+    /** Logs only the projected allowlist and returns the same immutable diagnostic. */
+    static report(input) {
+        const diagnostic = this.project(input);
+        fsm_dynamo_1.DyFM_Log.error('[DyNTS safe diagnostic]', diagnostic);
+        return diagnostic;
+    }
+    /** Creates a framework error that carries only the safe diagnostic allowlist. */
+    static toError(diagnostic) {
+        return new fsm_dynamo_1.DyFM_Error({
+            errorCode: diagnostic.code,
+            message: `Framework failure at ${diagnostic.stage}. Correlation: ${diagnostic.fingerprint}.`,
+            userMessage: 'A server operation failed. Contact the responsible team with the correlation fingerprint.',
+            additionalContent: { diagnostic: diagnostic },
+            status: diagnostic.status,
+        });
+    }
+    static getCode(code) {
+        return /^[A-Z][A-Z0-9_|-]{2,127}$/.test(code) ? code : this.defaultCode;
+    }
+    static getCauseType(error) {
+        try {
+            if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.dynamoError;
+            }
+            if (error instanceof Error) {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.nativeError;
+            }
+            if (error !== null && typeof error === 'object') {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.object;
+            }
+            if (error !== undefined) {
+                return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.primitive;
+            }
+        }
+        catch {
+            return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.unknown;
+        }
+        return safe_diagnostic_cause_type_enum_1.DyNTS_SafeDiagnosticCause_Type.unknown;
+    }
+    static getStatus(status) {
+        if (typeof status !== 'number' || !Number.isInteger(status) || status < 100 || status > 599) {
+            return this.defaultStatus;
+        }
+        return status;
+    }
+    static getFingerprint(subject) {
+        return (0, crypto_1.createHash)('sha256').update(subject.join('\u0000'), 'utf8').digest('hex');
+    }
+}
+exports.DyNTS_SafeDiagnostic_ControlService = DyNTS_SafeDiagnostic_ControlService;
 //# sourceMappingURL=safe-diagnostic.control-service.js.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.d.ts

@@ -1,19 +1,19 @@
-import { DyNTS_SafeDiagnosticCause_Type } from './safe-diagnostic-cause.type-enum';
-import { DyNTS_SafeDiagnosticStage_Type } from './safe-diagnostic-stage.type-enum';
-/** Caller-owned input whose raw failure content is never returned or logged. */
-export interface DyNTS_SafeDiagnosticInput_Interface {
-    code: string;
-    stage: DyNTS_SafeDiagnosticStage_Type;
-    error?: unknown;
-    status?: number;
-}
-/** Exact public allowlist emitted by the safe diagnostic boundary. */
-export interface DyNTS_SafeDiagnostic_Interface {
-    contractVersion: 'dynts-safe-diagnostic/1';
-    code: string;
-    stage: DyNTS_SafeDiagnosticStage_Type;
-    causeType: DyNTS_SafeDiagnosticCause_Type;
-    fingerprint: string;
-    status: number;
-}
+import { DyNTS_SafeDiagnosticCause_Type } from './safe-diagnostic-cause.type-enum';
+import { DyNTS_SafeDiagnosticStage_Type } from './safe-diagnostic-stage.type-enum';
+/** Caller-owned input whose raw failure content is never returned or logged. */
+export interface DyNTS_SafeDiagnosticInput_Interface {
+    code: string;
+    stage: DyNTS_SafeDiagnosticStage_Type;
+    error?: unknown;
+    status?: number;
+}
+/** Exact public allowlist emitted by the safe diagnostic boundary. */
+export interface DyNTS_SafeDiagnostic_Interface {
+    contractVersion: 'dynts-safe-diagnostic/1';
+    code: string;
+    stage: DyNTS_SafeDiagnosticStage_Type;
+    causeType: DyNTS_SafeDiagnosticCause_Type;
+    fingerprint: string;
+    status: number;
+}
 //# sourceMappingURL=safe-diagnostic.interface.d.ts.map

package/build/_modules/server/safe-diagnostic/safe-diagnostic.interface.js

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

package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.d.ts

@@ -1,14 +1,14 @@
-/** Stable, content-free result codes emitted by the database-readiness probe. */
-export declare enum DyNTS_DbReadinessProbeCode_Type {
-    ready = "dynts-db-readiness-ready",
-    connectionUnavailable = "dynts-db-readiness-connection-unavailable",
-    disconnected = "dynts-db-readiness-disconnected",
-    connecting = "dynts-db-readiness-connecting",
-    disconnecting = "dynts-db-readiness-disconnecting",
-    stateUnknown = "dynts-db-readiness-state-unknown",
-    databaseUnavailable = "dynts-db-readiness-database-unavailable",
-    pingFailed = "dynts-db-readiness-ping-failed",
-    cancelled = "dynts-db-readiness-cancelled",
-    probeFailed = "dynts-db-readiness-probe-failed"
-}
+/** Stable, content-free result codes emitted by the database-readiness probe. */
+export declare enum DyNTS_DbReadinessProbeCode_Type {
+    ready = "dynts-db-readiness-ready",
+    connectionUnavailable = "dynts-db-readiness-connection-unavailable",
+    disconnected = "dynts-db-readiness-disconnected",
+    connecting = "dynts-db-readiness-connecting",
+    disconnecting = "dynts-db-readiness-disconnecting",
+    stateUnknown = "dynts-db-readiness-state-unknown",
+    databaseUnavailable = "dynts-db-readiness-database-unavailable",
+    pingFailed = "dynts-db-readiness-ping-failed",
+    cancelled = "dynts-db-readiness-cancelled",
+    probeFailed = "dynts-db-readiness-probe-failed"
+}
 //# sourceMappingURL=db-readiness-probe-code.type-enum.d.ts.map

package/build/_modules/server/server-status/db-readiness-probe-code.type-enum.js

@@ -1,18 +1,18 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_DbReadinessProbeCode_Type = void 0;
-/** Stable, content-free result codes emitted by the database-readiness probe. */
-var DyNTS_DbReadinessProbeCode_Type;
-(function (DyNTS_DbReadinessProbeCode_Type) {
-    DyNTS_DbReadinessProbeCode_Type["ready"] = "dynts-db-readiness-ready";
-    DyNTS_DbReadinessProbeCode_Type["connectionUnavailable"] = "dynts-db-readiness-connection-unavailable";
-    DyNTS_DbReadinessProbeCode_Type["disconnected"] = "dynts-db-readiness-disconnected";
-    DyNTS_DbReadinessProbeCode_Type["connecting"] = "dynts-db-readiness-connecting";
-    DyNTS_DbReadinessProbeCode_Type["disconnecting"] = "dynts-db-readiness-disconnecting";
-    DyNTS_DbReadinessProbeCode_Type["stateUnknown"] = "dynts-db-readiness-state-unknown";
-    DyNTS_DbReadinessProbeCode_Type["databaseUnavailable"] = "dynts-db-readiness-database-unavailable";
-    DyNTS_DbReadinessProbeCode_Type["pingFailed"] = "dynts-db-readiness-ping-failed";
-    DyNTS_DbReadinessProbeCode_Type["cancelled"] = "dynts-db-readiness-cancelled";
-    DyNTS_DbReadinessProbeCode_Type["probeFailed"] = "dynts-db-readiness-probe-failed";
-})(DyNTS_DbReadinessProbeCode_Type || (exports.DyNTS_DbReadinessProbeCode_Type = DyNTS_DbReadinessProbeCode_Type = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_DbReadinessProbeCode_Type = void 0;
+/** Stable, content-free result codes emitted by the database-readiness probe. */
+var DyNTS_DbReadinessProbeCode_Type;
+(function (DyNTS_DbReadinessProbeCode_Type) {
+    DyNTS_DbReadinessProbeCode_Type["ready"] = "dynts-db-readiness-ready";
+    DyNTS_DbReadinessProbeCode_Type["connectionUnavailable"] = "dynts-db-readiness-connection-unavailable";
+    DyNTS_DbReadinessProbeCode_Type["disconnected"] = "dynts-db-readiness-disconnected";
+    DyNTS_DbReadinessProbeCode_Type["connecting"] = "dynts-db-readiness-connecting";
+    DyNTS_DbReadinessProbeCode_Type["disconnecting"] = "dynts-db-readiness-disconnecting";
+    DyNTS_DbReadinessProbeCode_Type["stateUnknown"] = "dynts-db-readiness-state-unknown";
+    DyNTS_DbReadinessProbeCode_Type["databaseUnavailable"] = "dynts-db-readiness-database-unavailable";
+    DyNTS_DbReadinessProbeCode_Type["pingFailed"] = "dynts-db-readiness-ping-failed";
+    DyNTS_DbReadinessProbeCode_Type["cancelled"] = "dynts-db-readiness-cancelled";
+    DyNTS_DbReadinessProbeCode_Type["probeFailed"] = "dynts-db-readiness-probe-failed";
+})(DyNTS_DbReadinessProbeCode_Type || (exports.DyNTS_DbReadinessProbeCode_Type = DyNTS_DbReadinessProbeCode_Type = {}));
 //# sourceMappingURL=db-readiness-probe-code.type-enum.js.map

package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.d.ts

@@ -1,8 +1,8 @@
-/** Bounded stages of the foreground database-readiness probe. */
-export declare enum DyNTS_DbReadinessProbeStage_Type {
-    input = "input",
-    state = "state",
-    ping = "ping",
-    complete = "complete"
-}
+/** Bounded stages of the foreground database-readiness probe. */
+export declare enum DyNTS_DbReadinessProbeStage_Type {
+    input = "input",
+    state = "state",
+    ping = "ping",
+    complete = "complete"
+}
 //# sourceMappingURL=db-readiness-probe-stage.type-enum.d.ts.map

package/build/_modules/server/server-status/db-readiness-probe-stage.type-enum.js

@@ -1,12 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_DbReadinessProbeStage_Type = void 0;
-/** Bounded stages of the foreground database-readiness probe. */
-var DyNTS_DbReadinessProbeStage_Type;
-(function (DyNTS_DbReadinessProbeStage_Type) {
-    DyNTS_DbReadinessProbeStage_Type["input"] = "input";
-    DyNTS_DbReadinessProbeStage_Type["state"] = "state";
-    DyNTS_DbReadinessProbeStage_Type["ping"] = "ping";
-    DyNTS_DbReadinessProbeStage_Type["complete"] = "complete";
-})(DyNTS_DbReadinessProbeStage_Type || (exports.DyNTS_DbReadinessProbeStage_Type = DyNTS_DbReadinessProbeStage_Type = {}));
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_DbReadinessProbeStage_Type = void 0;
+/** Bounded stages of the foreground database-readiness probe. */
+var DyNTS_DbReadinessProbeStage_Type;
+(function (DyNTS_DbReadinessProbeStage_Type) {
+    DyNTS_DbReadinessProbeStage_Type["input"] = "input";
+    DyNTS_DbReadinessProbeStage_Type["state"] = "state";
+    DyNTS_DbReadinessProbeStage_Type["ping"] = "ping";
+    DyNTS_DbReadinessProbeStage_Type["complete"] = "complete";
+})(DyNTS_DbReadinessProbeStage_Type || (exports.DyNTS_DbReadinessProbeStage_Type = DyNTS_DbReadinessProbeStage_Type = {}));
 //# sourceMappingURL=db-readiness-probe-stage.type-enum.js.map