@futdevpro/fsm-dynamo 1.11.1 → 1.11.2

package/build/_collections/utils/shared.util.d.ts

@@ -100,6 +100,25 @@ export declare class DyFM_Shared {
     static cleanObject(obj: any): void;
     /** intertwine */
     static mergeObjects(target: any, source: any): any;
+    /**
+     * parses the JSON list, if it fails, it returns the answer as a single item in an array
+     *
+     * (uses {@link DyFM_safeParseJSON})
+     */
+    static safeParseList<T extends Array<any>>(textedJSON: string, disableErrorLog?: boolean): T;
+    /**
+     * parses the JSON, if it fails, it returns { unparsableResult: textedJSON }
+     *
+     * (uses {@link DyFM_failableSafeParseJSON})
+     */
+    static safeParseJSON<T = any>(textedJSON: string, disableErrorLog?: boolean): T | {
+        unparsableResult: string;
+    };
+    /**
+     * parses the JSON, if it fails, it throws an error
+     * (also will extract the JSON from "```json ... ```" wrapper)
+     */
+    static failableSafeParseJSON<T = any>(textedJSON: string): T;
 }
 export type DyFM_Object = DyFM_Shared;
 //# sourceMappingURL=shared.util.d.ts.map

package/build/_collections/utils/shared.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/shared.util.ts"],"names":[],"mappings":"AAGA,qBAAa,WAAW;IAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE;IAgBjE;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,GAAG;IAYtE;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM;IAe9E;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM;IAerF;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM;IAmBvF;;;;;;;OAOG;IACH,MAAM,CAAC,uBAAuB,CAAC,CAAC,EAC9B,SAAS,EAAE,CAAC,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,GAAG,GACb,CAAC;IAiBJ,MAAM,CAAC,QAAQ,CAAC,iBAAiB,wCAA2B;IAC5D;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,CAAC,EACzB,IAAI,EAAE,CAAC,EACP,QAAQ,GAAE,MAAM,EAA4C,EAC5D,IAAI,GAAE,GAAG,EAAO,GAEf,GAAG;IA4BN;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gBAAgB,CACrB,IAAI,EAAE,GAAG,EACT,QAAQ,GAAE,MAAM,EAA4C,EAC5D,IAAI,GAAE,GAAG,EAAO,EAChB,YAAY,GAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,sBAAsB,EAAE,MAAM,EAAE,CAAA;KAAE,EAAO,GACrE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,sBAAsB,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE;IAsBtD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAUlC,iBAAiB;IACjB,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;CA0B7C;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC"}
+{"version":3,"file":"shared.util.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/shared.util.ts"],"names":[],"mappings":"AAIA,qBAAa,WAAW;IAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE;IAgBjE;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,GAAG;IAYtE;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM;IAe9E;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,GAAG,MAAM;IAerF;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,GAAG,GAAG,MAAM;IAmBvF;;;;;;;OAOG;IACH,MAAM,CAAC,uBAAuB,CAAC,CAAC,EAC9B,SAAS,EAAE,CAAC,EACZ,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,GAAG,GACb,CAAC;IAiBJ,MAAM,CAAC,QAAQ,CAAC,iBAAiB,wCAA2B;IAC5D;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CAAC,CAAC,EACzB,IAAI,EAAE,CAAC,EACP,QAAQ,GAAE,MAAM,EAA4C,EAC5D,IAAI,GAAE,GAAG,EAAO,GAEf,GAAG;IA4BN;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gBAAgB,CACrB,IAAI,EAAE,GAAG,EACT,QAAQ,GAAE,MAAM,EAA4C,EAC5D,IAAI,GAAE,GAAG,EAAO,EAChB,YAAY,GAAE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,sBAAsB,EAAE,MAAM,EAAE,CAAA;KAAE,EAAO,GACrE;QAAE,MAAM,EAAE,GAAG,CAAC;QAAC,sBAAsB,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE;IAsBtD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI;IAUlC,iBAAiB;IACjB,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;IA2B5C;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,EACvC,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,OAAO,GACxB,CAAC;IA+BJ;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,CAAC,GAAG,GAAG,EAC1B,UAAU,EAAE,MAAM,EAClB,eAAe,CAAC,EAAE,OAAO,GACxB,CAAC,GAAG;QAAE,gBAAgB,EAAE,MAAM,CAAA;KAAE;IAkBnC;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,CAAC;CAgB7D;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC"}

package/build/_collections/utils/shared.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DyFM_Shared = void 0;
+const log_util_1 = require("./log.util");
 const utilities_util_1 = require("./utilities.util");
 class DyFM_Shared {
     /**
@@ -229,6 +230,69 @@ class DyFM_Shared {
         }
         return target;
     }
+    /**
+     * parses the JSON list, if it fails, it returns the answer as a single item in an array
+     *
+     * (uses {@link DyFM_safeParseJSON})
+     */
+    static safeParseList(textedJSON, disableErrorLog) {
+        const parsed = this.safeParseJSON(textedJSON, true);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        else if (typeof parsed === 'object') {
+            if (!disableErrorLog) {
+                log_util_1.DyFM_Log.warn('DyFM_safeParseList result is an object, returning its values', {
+                    parsed: parsed,
+                });
+            }
+            return Object.values(parsed);
+        }
+        else {
+            if (!disableErrorLog) {
+                log_util_1.DyFM_Log.warn('DyFM_safeParseList result is not an array or object, returning it as a single item', {
+                    parsed: parsed,
+                });
+            }
+            return [parsed];
+        }
+    }
+    /**
+     * parses the JSON, if it fails, it returns { unparsableResult: textedJSON }
+     *
+     * (uses {@link DyFM_failableSafeParseJSON})
+     */
+    static safeParseJSON(textedJSON, disableErrorLog) {
+        try {
+            return this.failableSafeParseJSON(textedJSON);
+        }
+        catch (error) {
+            if (!disableErrorLog) {
+                log_util_1.DyFM_Log.error('Unable to parse JSON answer:', {
+                    unparsedJSON: textedJSON,
+                    error: error,
+                });
+            }
+            return { unparsableResult: textedJSON };
+        }
+    }
+    /**
+     * parses the JSON, if it fails, it throws an error
+     * (also will extract the JSON from "```json ... ```" wrapper)
+     */
+    static failableSafeParseJSON(textedJSON) {
+        if (!textedJSON) {
+            throw new Error(`No content provided to JSON parse ("${textedJSON}")`);
+        }
+        const match = textedJSON.match(/```json(.*)```/s);
+        textedJSON = textedJSON.replaceAll('\n', '');
+        if (match) {
+            return JSON.parse(match[1].replaceAll('\n', ''));
+        }
+        else {
+            return JSON.parse(textedJSON.replaceAll('```json', '').replaceAll('```', ''));
+        }
+    }
 }
 exports.DyFM_Shared = DyFM_Shared;
 //# sourceMappingURL=shared.util.js.map

package/build/_collections/utils/shared.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/shared.util.ts"],"names":[],"mappings":";;;AACA,qDAAgE;AAEhE,MAAa,WAAW;IAEtB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,UAAU,CAAC,OAAiB,EAAE,KAAiB;QACpD,IAAI,UAAU,GAAa,CAAE,GAAG,OAAO,CAAE,CAAC;QAE1C,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAO,EAAE;YACvC,MAAM,MAAM,GAAQ,EAAE,CAAC;YAEvB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAc,EAAQ,EAAE;gBACrC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,aAAa,CAAC,SAAiB,EAAE,cAAwB;QAC9D,IAAI,OAAO,GAAQ,IAAA,2BAAU,EAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB;QAE5D,cAAc,CAAC,OAAO,CAAC,CAAC,EAAU,EAAQ,EAAE;YAC1C,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAiB,EAAE,QAAkB,EAAE,SAAc;QACnE,MAAM,OAAO,GAAQ,IAAA,2BAAU,EAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB;QAE9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAa,CAAE,GAAG,QAAQ,CAAE,CAAC;YACvC,MAAM,WAAW,GAAW,IAAI,CAAC,KAAK,EAAY,CAAC;YAEnD,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QACnC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,eAAe,CAAC,SAAiB,EAAE,QAAkB,EAAE,SAAc;QAC1E,MAAM,OAAO,GAAQ,IAAA,2BAAU,EAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB;QAE9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAa,CAAE,GAAG,QAAQ,CAAE,CAAC;YACvC,MAAM,WAAW,GAAW,IAAI,CAAC,KAAK,EAAY,CAAC;YAEnD,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACrF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QACpC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,gBAAgB,CAAC,SAAiB,EAAE,QAAkB,EAAE,UAAe;QAC5E,MAAM,OAAO,GAAQ,IAAA,2BAAU,EAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB;QAE9D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,GAAa,CAAE,GAAG,QAAQ,CAAE,CAAC;YACvC,MAAM,WAAW,GAAW,IAAI,CAAC,KAAK,EAAY,CAAC;YAEnD,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAE,UAAU,CAAE,CAAC;YACxC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,uBAAuB,CAC5B,SAAY,EACZ,aAAqB,EACrB,WAAqB,EACrB,SAAc;QAEd,MAAM,OAAO,GAAQ,IAAA,2BAAU,EAAC,SAAS,CAAC,CAAC,CAAC,gCAAgC;QAE5E,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAa,CAAE,GAAG,WAAW,CAAE,CAAC;YAC7C,MAAM,YAAY,GAAW,OAAO,CAAC,KAAK,EAAY,CAAC;YAEvD,OAAO,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,uBAAuB,CACjE,OAAO,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,SAAS,CACxE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,aAAa,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;QACrD,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,MAAM,CAAU,iBAAiB,GAAG,IAAI,CAAC,kBAAkB,CAAC;IAC5D;;;;;OAKG;IACH,MAAM,CAAC,kBAAkB,CACvB,IAAO,EACP,WAAqB,CAAE,CAAC,OAAO,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAE,EAC5D,OAAc,EAAE;QAGhB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,OAAO,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,OAAY,CAAC;QAEjB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,EAAE,CAAC;QACf,CAAC;QAED,oFAAoF;QACpF,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAQ,EAAE;YAC9C,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,kBAAkB,CACpC,IAAI,CAAC,GAAwB,CAAC,EAC9B,CAAE,GAAG,QAAQ,EAAE,GAAG,CAAE,EACpB,CAAE,GAAG,IAAI,EAAE,IAAI,CAAE,CAClB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACjB,CAAC;IAGD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,gBAAgB,CACrB,IAAS,EACT,WAAqB,CAAE,CAAC,OAAO,GAAG,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,CAAE,EAC5D,OAAc,EAAE,EAChB,eAAoE,EAAE;QAEtE,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,YAAY,CAAC;QACtB,CAAC;aAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/B,YAAY,CAAC,IAAI,CAAC;gBAChB,MAAM,EAAE,IAAI;gBACZ,sBAAsB,EAAE,QAAQ;aACjC,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAQ,EAAE;YAC9C,IAAI,CAAC,gBAAgB,CACnB,IAAI,CAAC,GAAG,CAAC,EACT,CAAE,GAAG,QAAQ,EAAE,GAAG,CAAE,EACpB,CAAE,GAAG,IAAI,EAAE,IAAI,CAAE,EACjB,YAAY,CACb,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,YAAY,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,GAAQ;QACzB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAW,EAAQ,EAAE;YAC7C,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,CAAC;iBAAM,IAAI,OAAO,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,iBAAiB;IACjB,MAAM,CAAC,YAAY,CAAC,MAAW,EAAE,MAAW;QAC1C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,EAAE,CAAC;YAEd,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;gBACzB,IAAI,MAAM,CAAC,GAAG,CAAC,YAAY,MAAM,EAAE,CAAC;oBAClC,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC5D,CAAC;qBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBACtC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;oBACnB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;wBACzB,IACE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;4BAC3B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,IAAA,iCAAgB,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC,EACnE,CAAC;4BACD,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACzB,CAAC;oBACH,CAAC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;;AAxRH,kCA0RC"}
+{"version":3,"file":"shared.util.js","sourceRoot":"","sources":["../../../src/_collections/utils/shared.util.ts"],"names":[],"mappings":"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"}

package/build/_models/types/db-filter.type.d.ts

@@ -8,6 +8,10 @@
  * { userIds: { $in: this.userId } }
  * //
  * @example
+ * // or by userIds:
+ * { userId: { $in: userIds } }
+ * //
+ * @example
  * // or by number or Date that is Greater Than AND Less Than:
  * { points: { $gt: 2, $lt: 14 } }
  * // further tools (syntax matches with $gt):

package/build/_models/types/db-filter.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-filter.type.d.ts","sourceRoot":"","sources":["../../../src/_models/types/db-filter.type.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IACzB,mBAAmB,CAAC,CAAC,CAAC,GACtB,eAAe,CAAC,CAAC,CAAC,GAClB,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;CACjE,GAAG;IACF,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;IACxC;;OAEG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;;OAEG;IACH,GAAG,CAAC,EAAE,CAAC,CAAC;IACR;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,EAAE,CAAC,CAAC;IACR;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC;IACT;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG;QACT,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC1B,CAAC;IACF;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CAChC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B;;OAEG;IACH,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/B,CAAA"}
+{"version":3,"file":"db-filter.type.d.ts","sourceRoot":"","sources":["../../../src/_models/types/db-filter.type.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IACzB,mBAAmB,CAAC,CAAC,CAAC,GACtB,eAAe,CAAC,CAAC,CAAC,GAClB,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAEtB;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;KAClC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC;CACjE,GAAG;IACF,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI;IACxC;;OAEG;IACH,GAAG,CAAC,EAAE,GAAG,CAAC;IACV;;OAEG;IACH,GAAG,CAAC,EAAE,CAAC,CAAC;IACR;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;OAEG;IACH,GAAG,CAAC,EAAE,CAAC,CAAC;IACR;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,CAAC;IACT;;OAEG;IACH,IAAI,CAAC,EAAE,CAAC,GAAG;QACT,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KAC1B,CAAC;IACF;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAGF;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC;;OAEG;IACH,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CAChC,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B;;OAEG;IACH,GAAG,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.11.01",
+  "version": "01.11.2",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "DyBu_settings": {
     "packageType": "full-stack-package",

package/src/_collections/utils/shared.util.ts

@@ -1,4 +1,5 @@
 
+import { DyFM_Log } from './log.util';
 import { DyFM_clone, DyFM_sameObjects } from './utilities.util';
 
 export class DyFM_Shared {
@@ -282,7 +283,93 @@ export class DyFM_Shared {
   
     return target;
   }
+  
+
+  /**
+   * parses the JSON list, if it fails, it returns the answer as a single item in an array
+   * 
+   * (uses {@link DyFM_safeParseJSON})
+   */
+  static safeParseList<T extends Array<any>>(
+    textedJSON: string, 
+    disableErrorLog?: boolean
+  ): T {
+    const parsed = this.safeParseJSON<T>(textedJSON, true);
+
+    if (Array.isArray(parsed)) {
+      return parsed;
+    } else if (typeof parsed === 'object') {
+      if (!disableErrorLog) {
+        DyFM_Log.warn(
+          'DyFM_safeParseList result is an object, returning its values', 
+          {
+            parsed: parsed,
+          }
+        );
+      }
+
+      return Object.values(parsed) as T;
+    } else {
+
+      if (!disableErrorLog) {
+        DyFM_Log.warn(
+          'DyFM_safeParseList result is not an array or object, returning it as a single item', 
+          {
+            parsed: parsed,
+          }
+        );
+      }
+
+      return [ parsed ] as string[] as T;
+    }
+  }
 
+  /**
+   * parses the JSON, if it fails, it returns { unparsableResult: textedJSON }
+   * 
+   * (uses {@link DyFM_failableSafeParseJSON})
+   */
+  static safeParseJSON<T = any>(
+    textedJSON: string,
+    disableErrorLog?: boolean
+  ): T | { unparsableResult: string } {
+    try {
+      return this.failableSafeParseJSON(textedJSON);
+    } catch (error) {
+      if (!disableErrorLog) {
+        DyFM_Log.error(
+          'Unable to parse JSON answer:', 
+          {
+            unparsedJSON: textedJSON,
+            error: error,
+          }
+        );
+      }
+
+      return { unparsableResult: textedJSON };
+    }
+  }
+
+  /**
+   * parses the JSON, if it fails, it throws an error
+   * (also will extract the JSON from "```json ... ```" wrapper)
+   */
+  static failableSafeParseJSON<T = any>(textedJSON: string): T {
+    if (!textedJSON) {
+      throw new Error(`No content provided to JSON parse ("${textedJSON}")`);
+    }
+
+    const match = textedJSON.match(/```json(.*)```/s);
+    textedJSON = textedJSON.replaceAll('\n', '');
+
+    if (match) {
+      return JSON.parse(match[1].replaceAll('\n', ''));
+    } else {
+      return JSON.parse(
+        textedJSON.replaceAll('```json', '').replaceAll('```', '')
+      );
+    }
+  }
 }
 
 export type DyFM_Object = DyFM_Shared;

package/src/_models/types/db-filter.type.ts

@@ -9,6 +9,10 @@
  * { userIds: { $in: this.userId } }
  * //
  * @example 
+ * // or by userIds:
+ * { userId: { $in: userIds } }
+ * //
+ * @example 
  * // or by number or Date that is Greater Than AND Less Than:
  * { points: { $gt: 2, $lt: 14 } }
  * // further tools (syntax matches with $gt):