@futdevpro/nts-dynamo 1.5.53 → 1.5.54

package/src/_services/dynamo-nts-data.service.ts

@@ -3,6 +3,7 @@ import { Dynamo_Metadata, DynamoNTS_DataParams, DynamoNTS_DataPropertyParams, Dy
 
 import { DynamoNTS_DBService } from './dynamo-nts-db.service';
 import { DynamoNTS_GlobalService } from './dynamo-nts-global.service';
+import { DynamoNTS_Shared } from './dynamo-nts-shared.service';
 
 /**
  * Basic Data Service that is connected to the relevant DBServices
@@ -27,13 +28,12 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
   dataDBService: DynamoNTS_DBService<T>;
   data: T;
   dataList: T[] = [];
-  issuer?: string;
+  issuer: string;
 
   depKey?: string;
   depDBServiceKey?: string;
   private depDataDBService: DynamoNTS_DBService<any>;
 
-  // dataModelParams?: DynamoBEDataPropertyParams[] = [];
   dataParams: DynamoNTS_DataParams;
 
   defaultErrorUserMsg = 'We encountered an unhandled Data Error, please contact the responsible development team.'; 
@@ -42,12 +42,11 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
   constructor(
     data: T,
     dataParams: DynamoNTS_DataParams,
-    issuer?: string,
+    issuer: string,
   ) {
     this.dataDBService = DynamoNTS_GlobalService.getDBService<T>(dataParams);
     this.data = data;
     this.dataParams = dataParams;
-    // this.dataModelParams = dataParams.modelParams;
     this.lookForDependencyDataSettings();
     this.issuer = issuer;
   }
@@ -57,7 +56,14 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
    */
   async getAll(): Promise<void> {
     try {
-      this.dataList = await this.dataDBService.getAll();
+      this.dataList = await this.dataDBService.getAll().catch(error => {
+        if (error?.errorCodes?.includes('NTS-DBS-GA1')) {
+          console.error(error);
+          return [];
+        } else {
+          throw error;
+        }
+      });
     } catch (error) {
       throw new Dynamo_Error({ 
         status: 417, 
@@ -74,7 +80,7 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
    * @description
    * returns data from database by id
    * also if dontSetToService is false or not setted, 
-   * the data will be saved to the service
+   * the data will be saved to the service, even if its not found
    * 
    * @remarks 
    * If you need to get-save a data, if possible, 
@@ -88,8 +94,15 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
   async getDataById(id?: string, dontSetToService?: boolean): Promise<T> {
     try {
       if (id || this.data._id) {
-        let dataExists: T = await this.dataDBService.getDataById(id ? id : this.data._id);
-        if (!dontSetToService && dataExists) {
+        let dataExists: T = await this.dataDBService.getDataById(id ? id : this.data._id).catch(error => {
+          if (error?.errorCodes?.includes('NTS-DBS-GI1')) {
+            console.error(error);
+            return null;
+          } else {
+            throw error;
+          }
+        });
+        if (!dontSetToService) {
           this.data = dataExists;
         }
         return dataExists;
@@ -122,7 +135,14 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
     try {
       if (this.depKey) {
         if (dependencyId || this.data[this.depKey]) {
-          let dataExists: T = await this.dataDBService.getDataByDependencyId(dependencyId ? dependencyId : this.data[this.depKey]);
+          let dataExists: T = await this.dataDBService.getDataByDependencyId(dependencyId ? dependencyId : this.data[this.depKey]).catch(error => {
+            if (error?.errorCodes?.includes('NTS-DBS-GD2')) {
+              console.error(error);
+              return null;
+            } else {
+              throw error;
+            }
+          });
           if (!dontSetToService && dataExists) {
             this.data = dataExists;
           }
@@ -165,7 +185,14 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
     try {
       if (this.depKey) {
         if (dependencyId || this.data[this.depKey]) {
-          this.dataList = await this.dataDBService.getDataListByDependencyId(dependencyId ? dependencyId : this.data[this.depKey]);
+          this.dataList = await this.dataDBService.getDataListByDependencyId(dependencyId ? dependencyId : this.data[this.depKey]).catch(error => {
+            if (error?.errorCodes?.includes('NTS-DBS-GLD2')) {
+              console.error(error);
+              return [];
+            } else {
+              throw error;
+            }
+          });
         } else {
           throw new Dynamo_Error({ 
             status: 417, 
@@ -196,10 +223,173 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
     }
   }
 
+  /**
+   * 
+   * // findOne desc:
+   * 
+   * Find the data first by any of its parameters,
+   * also if dontSetToService is false or not setted, 
+   * the data will be saved to the service, even if non found
+   * 
+   * @param filter if you can, use unique parameters for find!
+   * 
+   * @example 
+   * // by email: 
+   * { email: email }
+   * //
+   * @example 
+   * // or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * //
+   * @example 
+   * // or by number or Date that is Greater Than AND Less Than:
+   * { points: { $gt: 2, $lt: 14 } }
+   * // further tools (syntax matches with $gt):
+   * $eq:  // Matches values that are EQual to a specified value.
+   * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+   * $lte: // Matches values that are Less Than or Equal to a specified value.
+   * $ne:  // Matches all values that are Not Equal to a specified value.
+   * $nin: // Matches None of the values specified IN an array.
+   * //
+   * @returns {T} data: T
+   */
+  async findData(findBy: any, dontSetToService?: boolean): Promise<T> {
+    try {
+      const dataExists: T = await this.dataDBService.findOne(findBy).catch(error => {
+        if (error?.errorCodes?.includes('NTS-DBS-FO1')) {
+          console.error(error);
+          return null;
+        } else {
+          throw error;
+        }
+      });
+      if (!dontSetToService) {
+        this.data = dataExists;
+      }
+      return dataExists;
+    } catch (error) {
+      throw new Dynamo_Error({ 
+        status: 417, 
+        errorCode: 'NTS-DS0-FD0',
+        addECToUserMsg: true,
+        message: `findData was unsuccessful (${this.dataParams.dataName})`, 
+        userMessage: this.defaultErrorUserMsg, 
+        error: error 
+      });
+    }
+  }
+
+  /**
+   * 
+   * // find desc:
+   * 
+   * Find the data first by any of its parameters, 
+   * also if dontSetToService is false or not setted, 
+   * the data will be saved to the service, even if non found
+   * 
+   * @param filter if you can, use unique parameters for find!
+   * 
+   * @example 
+   * // by email: 
+   * { email: email }
+   * //
+   * @example 
+   * // or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * //
+   * @example 
+   * // or by number or Date that is Greater Than AND Less Than:
+   * { points: { $gt: 2, $lt: 14 } }
+   * // further tools (syntax matches with $gt):
+   * $eq:  // Matches values that are EQual to a specified value.
+   * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+   * $lte: // Matches values that are Less Than or Equal to a specified value.
+   * $ne:  // Matches all values that are Not Equal to a specified value.
+   * $nin: // Matches None of the values specified IN an array.
+   * //
+   * @returns {T[]} dataList: T[]
+   */
+  async findDatas(findBy: any, dontSetToService?: boolean): Promise<T[]> {
+    try {
+      const dataListExists: T[] = await this.dataDBService.find(findBy).catch(error => {
+        if (error?.errorCodes?.includes('NTS-DBS-F1')) {
+          console.error(error);
+          return [];
+        } else {
+          throw error;
+        }
+      });
+      if (!dontSetToService) {
+        this.dataList = dataListExists;
+      }
+      return dataListExists;
+    } catch (error) {
+      throw new Dynamo_Error({ 
+        status: 417, 
+        errorCode: 'NTS-DS0-FDS0',
+        addECToUserMsg: true,
+        message: `findDatas was unsuccessful (${this.dataParams.dataName})`, 
+        userMessage: this.defaultErrorUserMsg, 
+        error: error 
+      });
+    }
+  }
+
   /**
    * This function uses the dataDBService.updateOne function.
    * This uses updateBy if setted, or data._id if its setted or this.data[this.dependencyKey]
    * @param set 
+   * 
+   * // updateOne desc:
+   * 
+   * Find the data first by any of its parameters, throws error if not found
+   * @param filter This uses the basic Mongoose updateOne.
+   * If you can, use unique parameters for find!
+   * @example 
+   * // by email: 
+   * { email: email }
+   * //
+   * @example 
+   * // or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * //
+   * @example 
+   * // or by number or Date that is Greater Than AND Less Than:
+   * { points: { $gt: 2, $lt: 14 } }
+   * // further tools (syntax matches with $gt):
+   * $eq:  // Matches values that are EQual to a specified value.
+   * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+   * $lte: // Matches values that are Less Than or Equal to a specified value.
+   * $ne:  // Matches all values that are Not Equal to a specified value.
+   * $nin: // Matches None of the values specified IN an array.
+   * //
+   * 
+   * @param update this uses the basic Mongoose updateOne
+   * @example
+   * // increase a specific value (here by 15): 
+   * { $inc: { popularity: 15 } }
+   * //
+   * @example 
+   * // or add element to a list:
+   * { $push: { reactions: this.newReaction }
+   * // or add multiple elements to a list
+   * { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
+   * //
+   * @example 
+   * // or all at once 
+   * {  
+   *   $inc: { popularity: this.newVote.amount }, 
+   *   emailVerified: true, 
+   *   $push: { reactions: this.newReaction } 
+   * }
+   * // further tools (syntax matches with $inc):
+   * $currentDate: // Sets the value of a field to current date, either as a Date or a Timestamp.
+   * $min:         // Only updates the field if the specified value is less than the existing field value.
+   * $max:         // Only updates the field if the specified value is greater than the existing field value.
+   * $mul:         // Multiplies the value of the field by the specified amount.
+   * $rename:      // Renames a field.
+   * $unset:       // Removes the specified field from a document. (set: "" to value)
+   * //
    */
   async updateData(set: { updateBy?: any, update: any }): Promise<void> {
     try {
@@ -234,6 +424,7 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
    * modifies data if the data have ID and already exists in the DB, 
    * creates new if the ID is not present or cant find in DB, 
    * and if dependency data setted up, will check before creation,
+   * 
    * @warning
    * but the proper way to update data, if you use update method instead,
    * this way, you can avoid data override errors 
@@ -244,7 +435,7 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
     try {
       if (this.data._id) {
         // check if already exists
-        let dataExists: T = await this.getDataById(null, true).catch(() => null);
+        const dataExists: T = await this.getDataById(null, true);
         if (dataExists) {
           // if data exists do modify
           this.data = await this.dataDBService.modifyData(this.data, this.issuer);
@@ -261,7 +452,14 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
               });
             }
 
-            let dependencyExists = await this.getDependencyDataDBService().getDataById(this.data[this.depKey]);
+            let dependencyExists = await this.getDependencyDataDBService().getDataById(this.data[this.depKey]).catch(error => {
+              if (error?.errorCodes?.includes('NTS-DBS-GI1')) {
+                console.error(error);
+                return null;
+              } else {
+                throw error;
+              }
+            });
             if (!dependencyExists) {
               throw new Dynamo_Error({ 
                 status: 417, 

package/src/_services/dynamo-nts-db.service.ts

@@ -112,7 +112,8 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   }
 
   /**
-   * returns data by _id, throws error if not found
+   * returns data by _id, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GI1)
    * @param id id
    * @returns data
    */
@@ -121,7 +122,14 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
       if (res) {
         return res.toObject() as T;
       } else {
-        return null;
+        /* return null; */
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GI1',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName} by ID was unsuccessful: data not found by id: ${id} (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg
+        });
       }
     }).catch(error => {
       throw new Dynamo_Error({ 
@@ -142,7 +150,9 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   }
 
   /**
-   * get data by dependency data id, throws error if not found
+   * get data by dependency data id, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GD2)
+   * 
    * @param dependencyId id
    * @returns data
    */
@@ -161,7 +171,14 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
       if (res) {
         return res.toObject() as T;
       } else {
-        return null;
+        /* return null; */
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GD2',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful: data not found by id: ${dependencyId} (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg
+        });
       }
     }).catch(error => {
       throw new Dynamo_Error({ 
@@ -182,7 +199,9 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   }
 
   /**
-   * get data by dependency data id, throws error if not found
+   * get data by dependency data id, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLD2)
+   * 
    * @param dependencyId id
    * @returns dataList
    */
@@ -198,8 +217,20 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
     }
 
     let dataList: T[] = await this.dataModel.find({ [this.depDataName]: dependencyId })
-    .then(res => res ?? [])
-    .catch(error => {
+    .then(res => {
+      if (res) {
+        return res as T[];
+      } else {
+        /* return []; */
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GLD2',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful: no data found by id: ${dependencyId} (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg
+        });
+      }
+    }).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-GLD1',
@@ -222,7 +253,9 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   }
 
   /**
-   * get multiple data objects by a list of DependencyIDs, throws error if not found
+   * get multiple data objects by a list of DependencyIDs, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLDS2)
+   * 
    * @param ids ids
    * @returns dataList
    */
@@ -238,8 +271,20 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
     }
 
     let dataList: T[] = await this.dataModel.find({ [this.depDataName]: { $in: ids }})
-    .then(res => res ?? [])
-    .catch(error => {
+    .then(res => {
+      if (res) {
+        return res as T[];
+      } else {
+        /* return []; */
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GLDS2',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful: no data found by ids: ${ids} (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg
+        });
+      }
+    }).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-GLDS1',
@@ -264,6 +309,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   /**
    * returns search result for searchBy object params
    * can use lists or xRange values for searchBy obj properties
+   * 
    * @param searchBy filter
    * @param narrowByDependencyIds id
    * @returns dataList
@@ -357,13 +403,27 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   }
 
   /**
-   * returns all data from database, throws error if not found
+   * returns all data from database, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GA1)
+   * 
    * @returns dataList
    */
   async getAll(): Promise<T[]> {
     let dataList: T[] = await this.dataModel.find({})
-    .then(res => res ?? [])
-    .catch(error => {
+    .then(res => {
+      if (res) {
+        return res as T[];
+      } else {
+        /* return null; */
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GA1',
+          addECToUserMsg: true,
+          message: `get all ${this.dataParams.dbName} was unsuccessful: no data found (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg
+        });
+      }
+    }).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-GA0',
@@ -434,7 +494,9 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   // DIRECT Basic MONGOOSE FUNCTIONS (with error handlings)
 
   /**
-   * Find the data first by any of its parameters, throws error if not found
+   * Find the data first by any of its parameters, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-FO1)
+   * 
    * @param filter if you can, use unique parameters for find!
    * 
    * @example 
@@ -460,16 +522,23 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   async findOne(filter: any): Promise<T> {
     let data: T = await this.dataModel.findOne(filter).then(res => {
       if (res) {
-        return res.toObject() as T;
+        return res as T;
       } else {
-        return null;
+        /* return null; */
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-FO1',
+          addECToUserMsg: true,
+          message: `findOne ${this.dataParams.dbName} was unsuccessful, no data found (NTS DB) fliter: ${filter}`, 
+          userMessage: this.defaultErrorUserMsg
+        });
       }
     }).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-FO0',
         addECToUserMsg: true,
-        message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB) fliter: ${filter}`, 
         userMessage: this.defaultErrorUserMsg, 
         error 
       });
@@ -484,7 +553,9 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
 
   /**
    * #MONGOOSE FUNCTION
-   * Find the data first by any of its parameters, throws error if not found
+   * Find the data first by any of its parameters, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-F1)
+   * 
    * @param filter if you can, use unique parameters for find!
    * 
    * @example 
@@ -509,8 +580,20 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
    */
   async find(filter: any): Promise<T[]> {
     let dataList: T[] = await this.dataModel.find(filter)
-    .then(res => res ?? [])
-    .catch(error => {
+    .then(res => {
+      if (res) {
+        return res as T[];
+      } else {
+        /* return null; */
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-F1',
+          addECToUserMsg: true,
+          message: `find ${this.dataParams.dbName} was unsuccessful, no data found (NTS DB) fliter: ${filter}`, 
+          userMessage: this.defaultErrorUserMsg
+        });
+      }
+    }).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-F0',
@@ -534,7 +617,8 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
 
   /**
    * #MONGOOSE FUNCTION
-   * Find the data first by any of its parameters, throws error if not found
+   * Find the data first by any of its parameters
+   * 
    * @param filter if you can, use unique parameters for find!
    * 
    * @example 
@@ -595,6 +679,8 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   /**
    * #MONGOOSE FUNCTION
    * Find data by _id and update
+   * !!!: throws error if not found (errorCode on not found: )
+   * 
    * @param id id
    * @param update update
    * @returns data
@@ -635,7 +721,8 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
 
   /**
    * #MONGOOSE FUNCTION
-   * Find the data first by any of its parameters, throws error if not found
+   * Find the data first by any of its parameters
+   * 
    * @param filter This uses the basic Mongoose updateOne.
    * If you can, use unique parameters for find!
    * @example 
@@ -704,6 +791,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   /**
    * #MONGOOSE FUNCTION
    * update one parameter by a specific
+   * 
    * @param filter This uses the basic Mongoose updateMany.
    * @example 
    * // by email: