@futdevpro/nts-dynamo 1.15.391 → 1.15.392

package/build/_modules/server/errors/errors-sink.util.d.ts

@@ -26,5 +26,14 @@ export declare class DyNTS_ErrorsSink_Util {
      * (`recordError` handles the missing-data case itself).
      */
     static clientRecord<T>(body: T): T;
+    /** The prefix of a report that arrived with nothing readable — a loud marker instead of `[unknown] (no message)`. */
+    static readonly emptyReportPrefix: string;
+    /**
+     * BFR-FDPFTPSERVICE-007 ② — a `DyFM_Error`-shaped body (`_message`, `_errorCode`, `___issuerSystem`) sent to the sink
+     * was stored SILENTLY as `[unknown] (no message)`: the record reads `message` / `source`, the DyFM error keeps them
+     * under its own names. The fields are adopted where the record has none; a report that still says nothing is
+     * stored with a loud marker naming the keys it did carry (never the values — they may hold personal data).
+     */
+    static adoptDyFmErrorShape(record: object): void;
 }
 //# sourceMappingURL=errors-sink.util.d.ts.map

package/build/_modules/server/errors/errors-sink.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors-sink.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors-sink.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,qBAAqB;IAEhC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAoB;IAE/D,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAShD;IAEF;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;CAqBnC"}
+{"version":3,"file":"errors-sink.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors-sink.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,qBAAqB;IAEhC,gFAAgF;IAChF,MAAM,CAAC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAoB;IAE/D,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAShD;IAEF;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;IAwBlC,qHAAqH;IACrH,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAA0B;IAEnE;;;;;OAKG;IACH,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CA6DjD"}

package/build/_modules/server/errors/errors-sink.util.js

@@ -45,6 +45,7 @@ class DyNTS_ErrorsSink_Util {
         for (const key of DyNTS_ErrorsSink_Util.serverOwnedKeys) {
             Reflect.deleteProperty(clean, key);
         }
+        DyNTS_ErrorsSink_Util.adoptDyFmErrorShape(clean);
         // BFR-MASTERPROMPTER-085 — a report without a usable `source` is stored as `CLIENT-UNKNOWN`, so every reader can
         // rely on the field (before, one such record crashed the error statistics)
         const source = Reflect.get(clean, 'source');
@@ -53,6 +54,57 @@ class DyNTS_ErrorsSink_Util {
         }
         return clean;
     }
+    /** The prefix of a report that arrived with nothing readable — a loud marker instead of `[unknown] (no message)`. */
+    static emptyReportPrefix = '[EMPTY ERROR REPORT]';
+    /**
+     * BFR-FDPFTPSERVICE-007 ② — a `DyFM_Error`-shaped body (`_message`, `_errorCode`, `___issuerSystem`) sent to the sink
+     * was stored SILENTLY as `[unknown] (no message)`: the record reads `message` / `source`, the DyFM error keeps them
+     * under its own names. The fields are adopted where the record has none; a report that still says nothing is
+     * stored with a loud marker naming the keys it did carry (never the values — they may hold personal data).
+     */
+    static adoptDyFmErrorShape(record) {
+        const text = (key) => {
+            const value = Reflect.get(record, key);
+            return typeof value === 'string' && value.trim() ? value : undefined;
+        };
+        const firstText = (key) => {
+            const values = Reflect.get(record, key);
+            return Array.isArray(values)
+                ? values.find((value) => typeof value === 'string' && !!value.trim())
+                : undefined;
+        };
+        // an `FDP_Errors` report may carry its text only inside the nested `error`
+        const nested = Reflect.get(record, 'error');
+        const nestedText = (key) => {
+            const value = nested && typeof nested === 'object' ? Reflect.get(nested, key) : undefined;
+            return typeof value === 'string' && value.trim() ? value : undefined;
+        };
+        if (!text('message')) {
+            const message = text('_message') ?? firstText('_messages') ?? text('__userMessage') ?? firstText('__userMessages')
+                ?? nestedText('message') ?? nestedText('_message');
+            if (message) {
+                Reflect.set(record, 'message', message);
+            }
+        }
+        // the error code goes where the readers look for it (`fdp errors --code` reads `additionalContent.errorCode`, ①)
+        const errorCode = text('_errorCode') ?? firstText('_errorCodes');
+        const additional = Reflect.get(record, 'additionalContent');
+        const additionalObject = additional && typeof additional === 'object' && !Array.isArray(additional) ? { ...additional } : {};
+        if (errorCode && !additionalObject['errorCode']) {
+            Reflect.set(record, 'additionalContent', { ...additionalObject, errorCode: errorCode });
+        }
+        if (!text('source')) {
+            const source = text('___issuerService') ?? text('___issuerSystem');
+            if (source) {
+                Reflect.set(record, 'source', source);
+            }
+        }
+        if (!text('message')) {
+            const keys = Object.keys(record).sort().slice(0, 20);
+            Reflect.set(record, 'message', `${DyNTS_ErrorsSink_Util.emptyReportPrefix} the report carried no message — received keys: ` +
+                (keys.length ? keys.join(', ') : '(none)'));
+        }
+    }
 }
 exports.DyNTS_ErrorsSink_Util = DyNTS_ErrorsSink_Util;
 //# sourceMappingURL=errors-sink.util.js.map

package/build/_modules/server/errors/errors-sink.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors-sink.util.js","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors-sink.util.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAa,qBAAqB;IAEhC,gFAAgF;IAChF,MAAM,CAAU,mBAAmB,GAAW,gBAAgB,CAAC;IAE/D,6DAA6D;IAC7D,MAAM,CAAU,eAAe,GAAsB;QACnD,kCAAkC;QAClC,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,KAAK;QAC9E,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa;QACpD,YAAY;QACZ,QAAQ,EAAE,iBAAiB,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,mBAAmB;QACnH,mBAAmB,EAAE,qBAAqB;QAC1C,2CAA2C;QAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,uBAAuB,EAAE,kBAAkB;KACjF,CAAC;IAEF;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAI,IAAO;QAC5B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,KAAK,GAAe,EAAE,GAAG,IAAI,EAAE,CAAC;QAEtC,KAAK,MAAM,GAAG,IAAI,qBAAqB,CAAC,eAAe,EAAE,CAAC;YACxD,OAAO,CAAC,cAAc,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;QAED,iHAAiH;QACjH,2EAA2E;QAC3E,MAAM,MAAM,GAAY,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QAErD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;;AAzCH,sDA0CC"}
+{"version":3,"file":"errors-sink.util.js","sourceRoot":"","sources":["../../../../src/_modules/server/errors/errors-sink.util.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.15.391",
+  "version": "01.15.392",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "DyBu_settings": {
     "packageType": "server-package",