@futdevpro/fsm-dynamo 1.14.9 → 1.14.11

package/build/_modules/location/_collections/loc-regions.util.js

@@ -42,6 +42,17 @@ class DyFM_Regions {
         });
         return result;
     }
+    /**
+     * Converts an ISO-3166 code to a country ISO object.
+     * @param iso2 The ISO-3166 code to convert.
+     * @returns The country ISO object.
+     *
+     * @example
+     * ```ts
+     * const country: DyFM_CountryISO = DyFM_Regions.isoToCountryIso('US');
+     * console.log(country.name); // United States
+     * ```
+     */
     static isoToCountryIso(iso2) {
         const country = this.countryISOs.find((iso) => iso.iso2 == iso2);
         if (!country) {
@@ -53,6 +64,17 @@ class DyFM_Regions {
             return country;
         }
     }
+    /**
+     * Converts an ISO-3166 code to a region.
+     * @param iso2 The ISO-3166 code to convert.
+     * @returns The region.
+     *
+     * @example
+     * ```ts
+     * const region: DyFM_Region = DyFM_Regions.isoToRegion('US');
+     * console.log(region); // North America
+     * ```
+     */
     static isoToRegion(iso2) {
         const region = this.countryISOs.find((iso) => iso.iso2 == iso2)?.region;
         if (!region) {
@@ -64,6 +86,17 @@ class DyFM_Regions {
             return region;
         }
     }
+    /**
+     * Converts an ISO-3166 code to a phone code.
+     * @param iso2 The ISO-3166 code to convert.
+     * @returns The phone code.
+     *
+     * @example
+     * ```ts
+     * const phoneCode: DyFM_CountryPhoneCode = DyFM_Regions.isoToPhoneCode('US');
+     * console.log(phoneCode.code); // +1
+     * ```
+     */
     static isoToPhoneCode(iso2) {
         const phoneCode = this.phoneCodes.find((code) => code.iso == iso2);
         if (!phoneCode) {

package/build/_modules/location/_collections/loc-regions.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"loc-regions.util.js","sourceRoot":"","sources":["../../../../src/_modules/location/_collections/loc-regions.util.ts"],"names":[],"mappings":";;;;AACA;;wBAEwB;AACxB,mFAA6D;AAE7D,sFAAgE;AAChE,qGAA+E;AAS/E,yEAAsE;AACtE,6FAAiF;AAGjF;;;GAGG;AACH,MAAa,YAAY;IACvB,qFAAqF;IACrF,MAAM,CAAU,SAAS,GAA2B,YAAY,CAAC,eAAe,EAAE,CAAC;IACnF,MAAM,CAAU,UAAU,GAA4B,YAAY,CAAC,gBAAgB,EAAE,CAAC;IACtF,MAAM,CAAU,WAAW,GAAsB,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAEzE,MAAM,CAAC,eAAe;QAC5B,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,gCAAU,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAErF,OAAO,yBAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IACO,MAAM,CAAC,gBAAgB;QAC7B,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,gCAAU,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAEtF,OAAO,yBAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED;;QAEI;IACI,MAAM,CAAC,gBAAgB;QAC7B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,gCAAU,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAEhF,MAAM,MAAM,GAAsB,yBAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAoB,EAAQ,EAAE;YAC5C,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAClC,CAAC,EAAyB,EAAW,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAC5D,EAAE,IAAI,CAAC;YACR,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CACnC,CAAC,CAAuB,EAAW,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,eAAe,CAAC,IAAY;QACjC,MAAM,OAAO,GAAoB,IAAI,CAAC,WAAW,CAAC,IAAI,CACpD,CAAC,GAAoB,EAAW,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CACpD,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,gCAAU,CAAC;gBACnB,OAAO,EAAE,uCAAuC,IAAI,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,MAAM,MAAM,GAAgB,IAAI,CAAC,WAAW,CAAC,IAAI,CAC/C,CAAC,GAAoB,EAAW,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CACpD,EAAE,MAAM,CAAC;QAEV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,gCAAU,CAAC;gBACnB,OAAO,EAAE,uCAAuC,IAAI,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,IAAY;QAChC,MAAM,SAAS,GAA0B,IAAI,CAAC,UAAU,CAAC,IAAI,CAC3D,CAAC,IAA2B,EAAW,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAC3D,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,gCAAU,CAAC;gBACnB,OAAO,EAAE,uCAAuC,IAAI,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;;AA7EH,oCA8EC"}
+{"version":3,"file":"loc-regions.util.js","sourceRoot":"","sources":["../../../../src/_modules/location/_collections/loc-regions.util.ts"],"names":[],"mappings":";;;;AACA;;wBAEwB;AACxB,mFAA6D;AAE7D,sFAAgE;AAChE,qGAA+E;AAS/E,yEAAsE;AACtE,6FAAiF;AAGjF;;;GAGG;AACH,MAAa,YAAY;IACvB,qFAAqF;IACrF,MAAM,CAAU,SAAS,GAA2B,YAAY,CAAC,eAAe,EAAE,CAAC;IACnF,MAAM,CAAU,UAAU,GAA4B,YAAY,CAAC,gBAAgB,EAAE,CAAC;IACtF,MAAM,CAAU,WAAW,GAAsB,YAAY,CAAC,gBAAgB,EAAE,CAAC;IAEzE,MAAM,CAAC,eAAe;QAC5B,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,gCAAU,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAErF,OAAO,yBAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC5C,CAAC;IACO,MAAM,CAAC,gBAAgB;QAC7B,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,gCAAU,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAEtF,OAAO,yBAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC7C,CAAC;IAED;;QAEI;IACI,MAAM,CAAC,gBAAgB;QAC7B,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,gCAAU,CAAC,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC,CAAC;QAEhF,MAAM,MAAM,GAAsB,yBAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEhE,MAAM,CAAC,OAAO,CAAC,CAAC,GAAoB,EAAQ,EAAE;YAC5C,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAClC,CAAC,EAAyB,EAAW,EAAE,CAAC,EAAE,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CAC5D,EAAE,IAAI,CAAC;YACR,GAAG,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CACnC,CAAC,CAAuB,EAAW,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,IAAI,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,eAAe,CAAC,IAAY;QACjC,MAAM,OAAO,GAAoB,IAAI,CAAC,WAAW,CAAC,IAAI,CACpD,CAAC,GAAoB,EAAW,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CACpD,CAAC;QAEF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,gCAAU,CAAC;gBACnB,OAAO,EAAE,uCAAuC,IAAI,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,WAAW,CAAC,IAAY;QAC7B,MAAM,MAAM,GAAgB,IAAI,CAAC,WAAW,CAAC,IAAI,CAC/C,CAAC,GAAoB,EAAW,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CACpD,EAAE,MAAM,CAAC;QAEV,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,gCAAU,CAAC;gBACnB,OAAO,EAAE,uCAAuC,IAAI,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,cAAc,CAAC,IAAY;QAChC,MAAM,SAAS,GAA0B,IAAI,CAAC,UAAU,CAAC,IAAI,CAC3D,CAAC,IAA2B,EAAW,EAAE,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAC3D,CAAC;QAEF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,gCAAU,CAAC;gBACnB,OAAO,EAAE,uCAAuC,IAAI,EAAE;aACvD,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;;AA9GH,oCA+GC"}

package/build/_modules/location/_collections/loc.util.d.ts

@@ -9,6 +9,16 @@ export declare class DyFM_Location {
     static getDistanceInKilometres(from: DyFM_LocationCoordinates, to: DyFM_LocationCoordinates): number;
     /**
      * Converts a distance in kilometers to degree difference for latitude or longitude.
+     * @param latiOrLong The direction to convert to degrees.
+     * @param distanceInKm The distance in kilometers.
+     * @param latitude The latitude to use for the conversion.
+     * @returns The degree difference.
+     *
+     * @example
+     * ```ts
+     * const degreeChange = DyFM_Location.getLocationDegByKilometers('latitude', 110.574);
+     * console.log(degreeChange); // 1
+     * ```
      */
     static getLocationDegByKilometers(latiOrLong: 'latitude' | 'longitude', distanceInKm: number, latitude?: number): number;
 }

package/build/_modules/location/_collections/loc.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loc.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/location/_collections/loc.util.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACzB,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,IAAI,EAAE,wBAAwB,EAC9B,EAAE,EAAE,wBAAwB,GAC3B,MAAM;IAgBT;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,UAAU,EAAE,UAAU,GAAG,WAAW,EACpC,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;CAqBV"}
+{"version":3,"file":"loc.util.d.ts","sourceRoot":"","sources":["../../../../src/_modules/location/_collections/loc.util.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,wBAAwB,EACzB,MAAM,sCAAsC,CAAC;AAE9C;;GAEG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,IAAI,EAAE,wBAAwB,EAC9B,EAAE,EAAE,wBAAwB,GAC3B,MAAM;IAgBT;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,0BAA0B,CAC/B,UAAU,EAAE,UAAU,GAAG,WAAW,EACpC,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM;CAqBV"}

package/build/_modules/location/_collections/loc.util.js

@@ -24,6 +24,16 @@ class DyFM_Location {
     }
     /**
      * Converts a distance in kilometers to degree difference for latitude or longitude.
+     * @param latiOrLong The direction to convert to degrees.
+     * @param distanceInKm The distance in kilometers.
+     * @param latitude The latitude to use for the conversion.
+     * @returns The degree difference.
+     *
+     * @example
+     * ```ts
+     * const degreeChange = DyFM_Location.getLocationDegByKilometers('latitude', 110.574);
+     * console.log(degreeChange); // 1
+     * ```
      */
     static getLocationDegByKilometers(latiOrLong, distanceInKm, latitude) {
         if (latiOrLong === 'latitude') {

package/build/_modules/location/_collections/loc.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"loc.util.js","sourceRoot":"","sources":["../../../../src/_modules/location/_collections/loc.util.ts"],"names":[],"mappings":";;;AACA,6FAAiF;AACjF,0FAAuF;AAKvF;;GAEG;AACH,MAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,IAA8B,EAC9B,EAA4B;QAG5B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,aAAa;QAC7B,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzE,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAE3E,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEzD,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,0BAA0B,CAC/B,UAAoC,EACpC,YAAoB,EACpB,QAAiB;QAEjB,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,YAAY,GAAG,OAAO,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,YAAY,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,qCAAiB,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,gCAAU,CAAC;oBACnB,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,aAAa;oBACxB,cAAc,EAAE,IAAI;oBACpB,OAAO,EACL,kFAAkF;wBAClF,gBAAgB,UAAU,mBAAmB,YAAY,eAAe,QAAQ,GAAG;oBACrF,WAAW,EACT,4CAA4C;wBAC5C,kDAAkD;iBACrD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnDD,sCAmDC"}
+{"version":3,"file":"loc.util.js","sourceRoot":"","sources":["../../../../src/_modules/location/_collections/loc.util.ts"],"names":[],"mappings":";;;AACA,6FAAiF;AACjF,0FAAuF;AAKvF;;GAEG;AACH,MAAa,aAAa;IACxB;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,IAA8B,EAC9B,EAA4B;QAG5B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,aAAa;QAC7B,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3D,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;QACzD,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzE,MAAM,EAAE,GAAG,qCAAiB,CAAC,cAAc,CAAC,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAE3E,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;YACnC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QAEzD,OAAO,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,0BAA0B,CAC/B,UAAoC,EACpC,YAAoB,EACpB,QAAiB;QAEjB,IAAI,UAAU,KAAK,UAAU,EAAE,CAAC;YAC9B,OAAO,YAAY,GAAG,OAAO,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,YAAY,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,qCAAiB,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;YACzF,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,gCAAU,CAAC;oBACnB,MAAM,EAAE,GAAG;oBACX,SAAS,EAAE,aAAa;oBACxB,cAAc,EAAE,IAAI;oBACpB,OAAO,EACL,kFAAkF;wBAClF,gBAAgB,UAAU,mBAAmB,YAAY,eAAe,QAAQ,GAAG;oBACrF,WAAW,EACT,4CAA4C;wBAC5C,kDAAkD;iBACrD,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AA7DD,sCA6DC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.14.9",
+  "version": "01.14.11",
   "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/constants/data-sizes.const.ts

@@ -1,15 +1,15 @@
 
 
-
+//file méret számításoknál a byte a legkisebb egység amit használunk
 
 /**
- * One byte is 1024 bytes
+ * One byte is 8 bits
  */
-export const byte = 1024;
+export const byte = 8;
 /**
  * One kilobyte is 1024 bytes
  */
-export const kilobyte = byte * 1024;
+export const kilobyte = 1024;
 /**
  * One megabyte is 1024 kilobytes
  */

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

@@ -16,6 +16,14 @@ export class DyFM_Array {
    * @param list - The array to iterate over.
    * @param func - The function to apply to each element.
    * @returns A promise that resolves when all elements have been processed.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * await DyFM_Array.asyncForEach(list, async (element: number, index?: number, array?: number[]): Promise<void> => {
+   *   console.log(element, index, array);
+   * });
+   * ```
    */
   static async asyncForEach<T>(
     list: T[], 
@@ -32,6 +40,14 @@ export class DyFM_Array {
    * @param list - The array to iterate over.
    * @param func - The function to apply to each element.
    * @returns A promise that resolves to the final result.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = await DyFM_Array.asyncForEachReturnToOne(0, list, async (element: number, dataCurrent: number, index?: number, array?: number[]): Promise<number> => {
+   *   return dataCurrent + element;
+   * });
+   * ```
    */
   static async asyncForEachReturnToOne<T, K>(
     startData: K,
@@ -52,6 +68,14 @@ export class DyFM_Array {
    * @param list - The array to iterate over.
    * @param func - The function to apply to each element.
    * @returns A promise that resolves to an array of results.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = await DyFM_Array.asyncForEachReturnToAll(list, async (element: number, index?: number, array?: number[]): Promise<number> => {
+   *   return element * 2;
+   * });
+   * ```
    */
   static async asyncForEachReturnToAll<T, K>(
     list: T[], 
@@ -71,6 +95,15 @@ export class DyFM_Array {
    * @param list - The array to iterate over.
    * @param func - The function to apply to each element.
    * @returns A promise that resolves to an array of results.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = await DyFM_Array.asyncForEachAllAtOnce(list, async (element: number, index?: number, array?: number[]): Promise<number> => {
+   *   return [ element * 2, element * 3 ];
+   * });
+   * console.log(result); // [ [ 2, 3 ], [ 4, 6 ], [ 6, 9 ] ]
+   * ```
    */
   static async asyncForEachAllAtOnce<T, R>(
     list: T[], 
@@ -84,6 +117,15 @@ export class DyFM_Array {
    * @param list - The array to filter.
    * @param filterFunc - The function to apply to each element.
    * @returns A promise that resolves to an array of results.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = await DyFM_Array.asyncFilter(list, async (element: number, index?: number, array?: number[]): Promise<boolean> => {
+   *   return element % 2 === 0;
+   * });
+   * console.log(result); // [ 2 ]
+   * ```
    */
   static async asyncFilter<T>(
     list: T[], 
@@ -105,6 +147,15 @@ export class DyFM_Array {
    * @param list - The array to map.
    * @param mapFunc - The function to apply to each element.
    * @returns A promise that resolves to an array of results.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = await DyFM_Array.asyncMap(list, async (element: number, index?: number, array?: number[]): Promise<number> => {
+   *   return element * 2;
+   * });
+   * console.log(result); // [ 2, 4, 6 ]
+   * ```
    */
   static async asyncMap<T, R>(
     list: T[], 
@@ -123,6 +174,13 @@ export class DyFM_Array {
    * Returns the last element of an array.
    * @param array - The array to get the last element from.
    * @returns The last element of the array, or null if the array is empty.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.last(list);
+   * console.log(result); // 3
+   * ```
    */
   static last<T>(array: T[]): T | null {
     return array?.length ? array[array.length - 1] : null;
@@ -133,6 +191,13 @@ export class DyFM_Array {
    * @param string - The string to check.
    * @param array - The array to check.
    * @returns True if the string is the last element of the array, false otherwise.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.isLast(3, list);
+   * console.log(result); // true
+   * ```
    */
   static isLast<T>(element: T, array: T[]): boolean {
     return array.indexOf(element) === array.length - 1;
@@ -143,6 +208,13 @@ export class DyFM_Array {
    * @param string - The string to check.
    * @param array - The array to check.
    * @returns True if the string is the last element of the array, false otherwise.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.isLastIndex(2, list);
+   * console.log(result); // true
+   * ```
    */
   static isLastIndex<T>(index: number, array: T[]): boolean {
     return index === array.length - 1;
@@ -153,6 +225,13 @@ export class DyFM_Array {
    * @param string - The string to check.
    * @param array - The array to check.
    * @returns True if the string is the first element of the array, false otherwise.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.isFirst(1, list);
+   * console.log(result); // true
+   * ```
    */
   static isFirst<T>(element: T, array: T[]): boolean {
     return array.indexOf(element) === 0;
@@ -162,6 +241,13 @@ export class DyFM_Array {
    * Returns the last character of a string.
    * @param string - The string to get the last character from.
    * @returns The last character of the string, or null if the string is empty.
+   * 
+   * @example 
+   * ```ts
+   * const string = 'hello';
+   * const result = DyFM_Array.lastCharacter(string);
+   * console.log(result); // 'o'
+   * ```
    */
   static lastCharacter(string: string): string | null {
     return string?.length ? string[string.length - 1] : null;
@@ -171,6 +257,13 @@ export class DyFM_Array {
    * Returns the first element of an array.
    * @param array - The array to get the first element from.
    * @returns The first element of the array, or null if the array is empty.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.first(list);
+   * console.log(result); // 1
+   * ```
    */
   static first<T>(array: T[]): T | null {
     return array?.length ? array[0] : null;
@@ -181,6 +274,13 @@ export class DyFM_Array {
    * @param array - The array to remove the element from.
    * @param element - The element to remove from the array.
    * @returns The array with the element removed.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.remove(list, 2);
+   * console.log(result); // [ 1, 3 ]
+   * ```
    */
   static remove<T>(array: T[], element: T): T[] {
     const index = array.indexOf(element);
@@ -197,6 +297,15 @@ export class DyFM_Array {
    * @param array - The array to find and remove the element from.
    * @param func - The function to apply to each element.
    * @returns The array with the element removed.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.findNRemove(list, (element: number, index?: number, array?: number[]): boolean => {
+   *   return element === 2;
+   * });
+   * console.log(result); // [ 1, 3 ]
+   * ```
    */
   static findNRemove<T>(
     array: T[], 
@@ -215,6 +324,13 @@ export class DyFM_Array {
    * Shuffles an array.
    * @param array - The array to shuffle.
    * @returns The shuffled array.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.shuffle(list);
+   * console.log(result); // [ 3, 1, 2 ]
+   * ```
    */
   static shuffle<T>(array: T[]): T[] {
     let currentIndex = array.length;
@@ -236,6 +352,13 @@ export class DyFM_Array {
    * @param pageIndex - The index of the page to return.
    * @param pageSize - The size of the page.
    * @returns The page of the array.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3, 4, 5, 6, 7, 8 ];
+   * const result = DyFM_Array.page(list, 0, 2);
+   * console.log(result); // [ 1, 2 ]
+   * ```
    */
   static page<T>(array: T[], pageIndex: number, pageSize: number): T[] {
     return array.slice(pageIndex * pageSize, (pageIndex + 1) * pageSize);
@@ -247,6 +370,13 @@ export class DyFM_Array {
    * @param pageIndex - The index of the page to return.
    * @param pageSize - The size of the page.
    * @returns The page of the array.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3, 4, 5, 6, 7, 8 ];
+   * const result = DyFM_Array.paged(list, 0, 2);
+   * console.log(result); // { pageIndex: 0, pageSize: 2, total: 8, totalPageCount: 4, items: [ 1, 2 ] }
+   * ```
    */
   static paged<T>(array: T[], pageIndex: number, pageSize: number): DyFM_Paged<T> {
     return {
@@ -264,6 +394,13 @@ export class DyFM_Array {
    * @param indexA - The index of the first element to swap.
    * @param indexB - The index of the second element to swap.
    * @returns The array with the elements swapped.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.swap(list, 0, 2);
+   * console.log(result); // [ 3, 2, 1 ]
+   * ```
    */
   static swap<T>(array: T[], indexA: number, indexB: number): T[] {
     [ array[indexA], array[indexB] ] = [ array[indexB], array[indexA] ];
@@ -275,6 +412,13 @@ export class DyFM_Array {
    * Checks if a string list has multiplications.
    * @param stringList - The string list to check.
    * @returns True if the string list has multiplications, false otherwise.
+   * 
+   * @example 
+   * ```ts
+   * const list: string[] = [ 'a', 'b', 'c', 'a' ];
+   * const result = DyFM_Array.stringListHasMultiplications(list);
+   * console.log(result); // true
+   * ```
    */
   static stringListHasMultiplications(stringList: string[]): boolean {
     return stringList.some((str: string, index: number): boolean => {
@@ -286,6 +430,13 @@ export class DyFM_Array {
    * Filters a string list to remove multiplications.
    * @param stringList - The string list to filter.
    * @returns The filtered string list.
+   * 
+   * @example 
+   * ```ts
+   * const list: string[] = [ 'a', 'b', 'c', 'a' ];
+   * const result = DyFM_Array.filterStringMultiplications(list);
+   * console.log(result); // [ 'a', 'b', 'c' ]
+   * ```
    */
   static filterStringMultiplications(stringList: string[]): string[] {
     return stringList.filter((str: string, index: number): boolean => {
@@ -297,6 +448,13 @@ export class DyFM_Array {
    * Gathers multiplications from a string list.
    * @param stringList - The string list to gather multiplications from.
    * @returns The gathered multiplications.
+   * 
+   * @example 
+   * ```ts
+   * const list: string[] = [ 'a', 'b', 'c', 'a' ];
+   * const result = DyFM_Array.gatherStringMultiplications(list);
+   * console.log(result); // [ [ 'a', 'a' ] ]
+   * ```
    */
   static gatherStringMultiplications(stringList: string[]): string[][] {
     const multiplications: string[][] = [];
@@ -323,6 +481,13 @@ export class DyFM_Array {
    * @param dataList - The data list to check.
    * @param byKey - The key to check for multiplications.
    * @returns True if the data list has multiplications, false otherwise.
+   * 
+   * @example 
+   * ```ts
+   * const list: { _id: number, name: string }[] = [ { _id: 1, name: 'John' }, { _id: 2, name: 'Jane' }, { _id: 1, name: 'Bob' } ];
+   * const result = DyFM_Array.haveMultiplications(list, '_id');
+   * console.log(result); // true
+   * ```
    */
   static haveMultiplications<T extends object>(dataList: T[], byKey: keyof T = '_id' as keyof T): boolean {
     return dataList.some((data: T, index: number): boolean => {
@@ -337,6 +502,13 @@ export class DyFM_Array {
    * @param dataList - The data list to filter.
    * @param byKey - The key to filter for multiplications.
    * @returns The filtered data list.
+   * 
+   * @example 
+   * ```ts
+   * const list: { _id: number, name: string }[] = [ { _id: 1, name: 'John' }, { _id: 2, name: 'Jane' }, { _id: 1, name: 'Bob' } ];
+   * const result = DyFM_Array.filterMultiplications(list, '_id');
+   * console.log(result); // [ { _id: 1, name: 'John' } , { _id: 2, name: 'Jane' } ]
+   * ```
    */
   static filterMultiplications<T extends object>(dataList: T[], byKey: keyof T = '_id' as keyof T): T[] {
     return dataList.filter((data: T, index: number): boolean => {
@@ -351,6 +523,13 @@ export class DyFM_Array {
    * @param dataList - The data list to gather multiplications from.
    * @param byKey - The key to gather multiplications from.
    * @returns The gathered multiplications.
+   * 
+   * @example 
+   * ```ts
+   * const list: { _id: number, name: string }[] = [ { _id: 1, name: 'John' }, { _id: 2, name: 'Jane' }, { _id: 1, name: 'Bob' } ];
+   * const result = DyFM_Array.gatherMultiplications(list, '_id');
+   * console.log(result); // [ [ { _id: 1, name: 'John' }, { _id: 1, name: 'Bob' } ] ]
+   * ```
    */
   static gatherMultiplications<T extends object>(dataList: T[], byKey: keyof T = '_id' as keyof T): T[][] {
     const multiplications: T[][] = [];
@@ -375,6 +554,15 @@ export class DyFM_Array {
    * @param array - The array to find the element in.
    * @param func - The function to apply to each element.
    * @returns The element found, or null if no element is found.
+   * 
+   * @example 
+   * ```ts
+   * const list: number[] = [ 1, 2, 3 ];
+   * const result = DyFM_Array.findFromEnd(list, (element: number, index?: number, array?: number[]): boolean => {
+   *   return element === 2;
+   * });
+   * console.log(result); // 2
+   * ```
    */
   static findFromEnd<T>(
     array: T[], 
@@ -395,6 +583,7 @@ export class DyFM_Array {
    * sorts so that the objects that have the value true for the checkFor function are at the beginning of the array
    * @param checkFor 
    * @returns 
+   * 
    */
   static getSortForTrueFn<T>(
     checkFor: (a: T) => boolean

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

@@ -10,6 +10,11 @@ export class DyFM_Async {
    * delays the execution of a function
    * @param ms 
    * @returns 
+   * 
+   * @example
+   * ```ts
+   * await DyFM_Async.wait(1000);
+   * ```
    */
   static wait(ms: number): Promise<void> {
     return new Promise((resolve): any => setTimeout(resolve, ms));
@@ -20,6 +25,11 @@ export class DyFM_Async {
   /** 
    * WARNING: This function is recommended to use ONLY for limited instances,
    * because it can cause performance issues.
+   * 
+   * @example
+   * ```ts
+   * await DyFM_Async.waitUntil(() => check(), 100, 10000);
+   * ```
    */
   static waitUntil(
     check: () => boolean, 
@@ -80,6 +90,14 @@ export class DyFM_Async {
 
   /**
    * Creates a promise that resolves when the observable emits a value that passes the check function
+   * 
+   * @example
+   * ```ts
+   * const observable = new Observable<number>(observer => {
+   *   setInterval(() => observer.next(Math.random()), 100);
+   * });
+   * const result = await DyFM_Async.takeUntil(observable, (value?: number) => value && value > 0.5);
+   * ```
    */
   static takeUntil<T>(
     observable: Observable<T>, 
@@ -97,6 +115,17 @@ export class DyFM_Async {
     });
   }
 
+  /**
+   * Waits for a given amount of time and logs the remaining time.
+   * @param totalWaitTimeMs - The total amount of time to wait.
+   * @param context - The context of the countdown.
+   * @returns A promise that resolves when the countdown is complete.
+   * 
+   * @example
+   * ```ts
+   * await DyFM_Async.waitWithCountdownLogging(1000, 'Countdown');
+   * ```
+   */
   static async waitWithCountdownLogging(
     totalWaitTimeMs: number,
     context: string = 'Countdown'
@@ -105,6 +134,17 @@ export class DyFM_Async {
     const endTime = startTime + totalWaitTimeMs;
     
     // Define logging intervals based on total duration
+    /**
+     * Gets the logging interval based on the total duration.
+     * @param totalMs - The total duration in milliseconds.
+     * @returns The logging interval in milliseconds.
+     * 
+     * @example
+     * ```ts
+     * const logInterval = getLogInterval(1000);
+     * console.log(logInterval); // 1000
+     * ```
+     */
     const getLogInterval = (totalMs: number): number => {
       const totalSeconds = totalMs / second;
       const totalMinutes = totalSeconds / 60;

package/src/_collections/utils/json-error-helper.util.ts

@@ -32,6 +32,12 @@ export class DyFM_JsonErrorHelper {
    * @param jsonInput - The original JSON input string
    * @param contextLines - Number of context lines to show before and after the error (default: 5)
    * @returns Object containing line number, context lines, and character position, or null if parsing fails
+   * 
+   * @example
+   * ```ts
+   * const lineInfo = DyFM_JsonErrorHelper.extractLineInfoFromJsonError('Expected property name or "}" in JSON at position 10', '{"name": "John", "age": 30}', 5);
+   * console.log(lineInfo); // { lineNumber: 1, contextLines: [ '{"name": "John", "age": 30}' ], characterPosition: 10 }
+   * ```
    */
   static extractLineInfoFromJsonError(
     errorMessage: string, 
@@ -86,6 +92,16 @@ export class DyFM_JsonErrorHelper {
 
   /**
    * Helper method to create line info from a character position
+   * @param jsonInput - The original JSON input string
+   * @param position - The character position where the error occurred
+   * @param contextLines - Number of context lines to show before and after the error (default: 5)
+   * @returns Object containing line number, context lines, and character position
+   * 
+   * @example
+   * ```ts
+   * const lineInfo = DyFM_JsonErrorHelper.createLineInfoFromPosition('{"name": "John", "age": 30}', 10, 5);
+   * console.log(lineInfo); // { lineNumber: 1, contextLines: [ '{"name": "John", "age": 30}' ], characterPosition: 10 }
+   * ```
    */
   private static createLineInfoFromPosition(
     jsonInput: string, 
@@ -152,6 +168,12 @@ export class DyFM_JsonErrorHelper {
    * @param lineInfo - The line information extracted from the error
    * @param errorMessage - The original error message
    * @returns Formatted error string for logging
+   * 
+   * @example
+   * ```ts
+   * const logLines = DyFM_JsonErrorHelper.formatJsonErrorForLogging({ lineNumber: 1, contextLines: [ '{"name": "John", "age": 30}' ], characterPosition: 10 }, 'Expected property name or "}" in JSON at position 10');
+   * console.log(logLines); // [ 'JSON parsing failed: Expected property name or "}" in JSON at position 10', 'Error at line 1, character 10:', 'Context (1 lines):', '    1: {"name": "John", "age": 30}' ]
+   * ```
    */
   static formatJsonErrorForLogging(
     lineInfo: JsonErrorLineInfo, 
@@ -185,6 +207,13 @@ export class DyFM_JsonErrorHelper {
    * @param contextLines - Number of context lines to show in error (default: 5)
    * @returns Parsed JSON object
    * @throws Error with detailed line information if parsing fails
+   * 
+   * @example
+   * ```ts
+   * const json = '{"name": "John", "age": 30}';
+   * const result = DyFM_JsonErrorHelper.parseJsonWithEnhancedError(json);
+   * console.log(result); // { name: 'John', age: 30 }
+   * ```
    */
   static parseJsonWithEnhancedError(
     jsonString: string, 
@@ -235,6 +264,15 @@ export class DyFM_JsonErrorHelper {
 
   /**
    * Formats single-line JSON with line breaks for better error reporting
+   * @param jsonString - The JSON string to format
+   * @returns The formatted JSON string
+   * 
+   * @example
+   * ```ts
+   * const json = '{"name": "John", "age": 30, "city": "New York"}';
+   * const result = DyFM_JsonErrorHelper.formatJsonForBetterErrors(json);
+   * console.log(result); // '{\n  "name": "John",\n  "age": 30,\n  "city": "New York"\n}'
+   * ```
    */
   private static formatJsonForBetterErrors(jsonString: string): string {
     if (!jsonString || typeof jsonString !== 'string') {