@futdevpro/nts-dynamo 1.5.53 → 1.5.55

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

@@ -50,14 +50,18 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
         });
       }
     }).catch(error => {
-      throw new Dynamo_Error({ 
-        status: 422, 
-        errorCode: 'NTS-DBS-CD0',
-        addECToUserMsg: true,
-        message: `Create new ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        error 
-      });
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 422, 
+          errorCode: 'NTS-DBS-CD0',
+          addECToUserMsg: true,
+          message: `Create new ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (typeof newData._id === 'object') {
@@ -92,14 +96,18 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
         });
       }
     }).catch(error => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-FU0',
-        addECToUserMsg: true,
-        message: `modify ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        error 
-      });
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-FU0',
+          addECToUserMsg: true,
+          message: `modify ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (typeof newData._id === 'object') {
@@ -112,7 +120,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,17 +130,28 @@ 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({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-GI0',
-        addECToUserMsg: true,
-        message: `get ${this.dataParams.dbName} by ID was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        error 
-      });
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GI0',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName} by ID was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (data && typeof data._id === 'object') {
@@ -142,7 +162,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,17 +183,28 @@ 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({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-GD1',
-        addECToUserMsg: true,
-        message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        error 
-      });
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GD1',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (data && typeof data._id === 'object') {
@@ -182,7 +215,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,16 +233,32 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
     }
 
     let dataList: T[] = await this.dataModel.find({ [this.depDataName]: dependencyId })
-    .then(res => res ?? [])
-    .catch(error => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-GLD1',
-        addECToUserMsg: true,
-        message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        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 => {
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GLD1',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (0 < dataList.length) {
@@ -222,7 +273,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,16 +291,32 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
     }
 
     let dataList: T[] = await this.dataModel.find({ [this.depDataName]: { $in: ids }})
-    .then(res => res ?? [])
-    .catch(error => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-GLDS1',
-        addECToUserMsg: true,
-        message: `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        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 => {
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GLDS1',
+          addECToUserMsg: true,
+          message: `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (0 < dataList.length) {
@@ -264,6 +333,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,21 +427,39 @@ 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 => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-GA0',
-        addECToUserMsg: true,
-        message: `get all ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        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 => {
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-GA0',
+          addECToUserMsg: true,
+          message: `get all ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (0 < dataList.length && typeof dataList[0]._id === 'object') {
@@ -415,8 +503,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
       });
     }
 
-    await this.dataModel.deleteMany({ [this.depDataName]: dependencyId })
-    .catch(error => {
+    await this.dataModel.deleteMany({ [this.depDataName]: dependencyId }).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-DDD1',
@@ -434,7 +521,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,19 +549,30 @@ 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)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        error 
-      });
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-FO0',
+          addECToUserMsg: true,
+          message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB) fliter: ${filter}`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (data && typeof data._id === 'object') {
@@ -484,7 +584,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,16 +611,32 @@ 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 => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-F0',
-        addECToUserMsg: true,
-        message: `find ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        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 => {
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-F0',
+          addECToUserMsg: true,
+          message: `find ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error 
+        });
+      }
     });
 
     if (0 < dataList.length) {
@@ -534,7 +652,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 +714,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
@@ -611,19 +732,23 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
           status: 204, 
           errorCode: 'NTS-DBS-FIU1',
           addECToUserMsg: true,
-          message: `${this.dataParams.dbName} not found! (NTS DB)`,
+          message: `${this.dataParams.dbName} not found! (by id: ${id}) (NTS DB)`,
           userMessage: this.defaultErrorUserMsg
         });
       }
     }).catch(error => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-FIU0',
-        addECToUserMsg: true,
-        message: `findByIdAndUpdate ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        error
-      });
+      if (error?.flag == 'DYNAMO ERROR OBJECT') {
+        throw error;
+      } else {
+        throw new Dynamo_Error({ 
+          status: 417, 
+          errorCode: 'NTS-DBS-FIU0',
+          addECToUserMsg: true,
+          message: `findByIdAndUpdate ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          userMessage: this.defaultErrorUserMsg, 
+          error
+        });
+      }
     });
 
     if (typeof newData._id === 'object') {
@@ -635,7 +760,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 +830,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: