@futdevpro/nts-dynamo 1.5.18 → 1.5.20

package/src/_services/dynamobe-data.service.ts

@@ -13,7 +13,8 @@ export class DynamoBEDataService<T extends Metadata> {
   depKey?: string;
   depDBServiceKey?: string;
 
-  dataModelParams?: DynamoBEDataPropertyParams[] = [];
+  // dataModelParams?: DynamoBEDataPropertyParams[] = [];
+  dataParams: DynamoBEDataParams;
 
   constructor(
     data: T,
@@ -22,7 +23,8 @@ export class DynamoBEDataService<T extends Metadata> {
   ) {
     this.dataDBService = DBE_Global_S.getDBService<T>(dataParams);
     this.data = data;
-    this.dataModelParams = dataParams.modelParams;
+    this.dataParams = dataParams;
+    // this.dataModelParams = dataParams.modelParams;
     this.lookForDependencyDataSettings();
     this.issuer = issuer;
   }
@@ -36,7 +38,11 @@ export class DynamoBEDataService<T extends Metadata> {
         this.dataList = dataList;
       });
     } catch (error) {
-      throw new DynamoBEError({ status: 417, message: 'getAll was unsuccessful', error: error });
+      throw new DynamoBEError({ 
+        status: 417, message: 'getAll was unsuccessful', 
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-130`, 
+        error: error 
+      });
     }
   }
 
@@ -55,10 +61,17 @@ export class DynamoBEDataService<T extends Metadata> {
         });
         return dataExists;
       } else {
-        throw new DynamoBEError({ status: 417, message: 'ID is missing!' });
+        throw new DynamoBEError({ 
+          status: 417, message: 'ID is missing!',
+          userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-131B`, 
+        });
       }
     } catch (error) {
-      throw new DynamoBEError({ status: 417, message: 'getDataById was unsuccessful', error: error });
+      throw new DynamoBEError({ 
+        status: 417, message: 'getDataById was unsuccessful', 
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-131A`, 
+        error: error 
+      });
     }
   }
   
@@ -79,13 +92,23 @@ export class DynamoBEDataService<T extends Metadata> {
           });
           return dataExists;
         } else {
-          throw new DynamoBEError({ status: 417, message: `${this.depKey} is missing!` });
+          throw new DynamoBEError({ 
+            status: 417, message: `${this.depKey} is missing!`,
+            userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-132C`, 
+          });
         }
       } else {
-        throw new DynamoBEError({ status: 417, message: 'dependencyDataIdKey is missing from service!' });
+        throw new DynamoBEError({ 
+          status: 417, message: 'dependencyDataIdKey is missing from service!',
+          userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-132B`, 
+        });
       }
     } catch (error) {
-      throw new DynamoBEError({ status: 417, message: 'getDataByDependencyId was unsuccessful', error: error });
+      throw new DynamoBEError({ 
+        status: 417, message: 'getDataByDependencyId was unsuccessful', 
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-132A`, 
+        error: error 
+      });
     }
   }
   
@@ -101,13 +124,23 @@ export class DynamoBEDataService<T extends Metadata> {
             this.dataList = data;
           });
         } else {
-          throw new DynamoBEError({ status: 417, message: `${this.depKey} is missing!` });
+          throw new DynamoBEError({ 
+            status: 417, message: `${this.depKey} is missing!`,
+            userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-133C`, 
+          });
         }
       } else {
-        throw new DynamoBEError({ status: 417, message: 'dependencyDataIdKey is missing from service!' });
+        throw new DynamoBEError({ 
+          status: 417, message: 'dependencyDataIdKey is missing from service!',
+          userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-133B`, 
+        });
       }
     } catch (error) {
-      throw new DynamoBEError({ status: 417, message: 'getDataListByDependencyId was unsuccessful', error: error });
+      throw new DynamoBEError({ status: 417, 
+        message: 'getDataListByDependencyId was unsuccessful', 
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-133A`, 
+        error: error 
+      });
     }
   }
 
@@ -147,7 +180,11 @@ export class DynamoBEDataService<T extends Metadata> {
         });
       }
     } catch (error) {
-      throw new DynamoBEError({ status: 417, message: 'modifyData was unsuccessful', error: error });
+      throw new DynamoBEError({ 
+        status: 417, message: `modifyData was unsuccessful (${this.dataParams.dataName})`, 
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-222`, 
+        error: error 
+      });
     }
   }
 
@@ -162,7 +199,11 @@ export class DynamoBEDataService<T extends Metadata> {
         throw new DynamoBEError({ status: 417, message: 'ID is missing!' });
       }
     } catch (error) {
-      throw new DynamoBEError({ status: 417, message: 'deleteData was unsuccessful', error: error });
+      throw new DynamoBEError({ 
+        status: 417, message: 'deleteData was unsuccessful', 
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-223`, 
+        error: error 
+      });
     }
   }
 
@@ -171,25 +212,29 @@ export class DynamoBEDataService<T extends Metadata> {
    */
   async validateForSave(): Promise<void> {
     try {
-      for (let i = 0; i < this.dataModelParams.length; i++) {
+      for (let i = 0; i < this.dataParams.modelParams.length; i++) {
         // basic required validations
-        if ((this.dataModelParams[i].required && (this.data[this.dataModelParams[i].key] === null || this.data[this.dataModelParams[i].key] === undefined)) ||
-            (this.dataModelParams[i].index && (this.data[this.dataModelParams[i].key] === null || this.data[this.dataModelParams[i].key] === undefined))) {
-          throw new DynamoBEError({ status: 422, message: `${this.dataModelParams[i].key} is missing! (${this.dataModelParams[i].required ? 'required' : 'index'})` });
+        if ((this.dataParams.modelParams[i].required && (this.data[this.dataParams.modelParams[i].key] === null || this.data[this.dataParams.modelParams[i].key] === undefined)) ||
+            (this.dataParams.modelParams[i].index && (this.data[this.dataParams.modelParams[i].key] === null || this.data[this.dataParams.modelParams[i].key] === undefined))) {
+          throw new DynamoBEError({ status: 422, message: `${this.dataParams.modelParams[i].key} is missing! (${this.dataParams.modelParams[i].required ? 'required' : 'index'})` });
         }
         // specific Date validation
-        if (this.dataModelParams[i].type === 'Date' && !(new Date(this.data[this.dataModelParams[i].key]) instanceof Date)) {
-          throw new DynamoBEError({ status: 422, message: `${this.dataModelParams[i].key} is not a date!` });
+        if (this.dataParams.modelParams[i].type === 'Date' && !(new Date(this.data[this.dataParams.modelParams[i].key]) instanceof Date)) {
+          throw new DynamoBEError({ status: 422, message: `${this.dataParams.modelParams[i].key} is not a date!` });
         }
         // call additional validators
-        if (this.dataModelParams[i].additionalValidators) {
-          for (let j = 0; j < this.dataModelParams[i].additionalValidators.length; j++) {
-            this.dataModelParams[i].additionalValidators[j](this.data[this.dataModelParams[i].key]);
+        if (this.dataParams.modelParams[i].additionalValidators) {
+          for (let j = 0; j < this.dataParams.modelParams[i].additionalValidators.length; j++) {
+            this.dataParams.modelParams[i].additionalValidators[j](this.data[this.dataParams.modelParams[i].key]);
           }
         }
       }
     } catch (error) {
-      throw new DynamoBEError({ status: 422, message: 'validateForSave was unsuccessful', error: error });
+      throw new DynamoBEError({ 
+        status: 422, message: 'validateForSave was unsuccessful', 
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-220`, 
+        error: error 
+      });
     }
   }
 
@@ -197,7 +242,7 @@ export class DynamoBEDataService<T extends Metadata> {
    * setting up dependency dataHook by DynamoBEDataModelParams
    */
   private lookForDependencyDataSettings(): void {
-    const dependencyParam: DynamoBEDataPropertyParams = this.dataModelParams.find((modelParams: DynamoBEDataPropertyParams) => modelParams.isDependencyHook);
+    const dependencyParam: DynamoBEDataPropertyParams = this.dataParams.modelParams.find((modelParams: DynamoBEDataPropertyParams) => modelParams.isDependencyHook);
     if (dependencyParam) {
       this.depKey = dependencyParam.key;
       if (dependencyParam.dependencyName) {
@@ -206,11 +251,18 @@ export class DynamoBEDataService<T extends Metadata> {
     }
   }
 
+  /**
+   * 
+   * @returns 
+   */
   getDependencyDataDBService(): DynamoBEDBService<any> {
     if (this.depDBServiceKey) {
-      return DBE_Global_S.getDBServiceCollection()[this.depDBServiceKey];
+      return DBE_Global_S.getDBService(this.dataParams);
     } else {
-      throw new DynamoBEError({ status: 501, message: 'getDependencyDataDBService was unsuccessful, service key not setted up!' });
+      throw new DynamoBEError({ 
+        status: 501, message: 'getDependencyDataDBService was unsuccessful, service key not setted up!',
+        userMessage: `We encountered a DB Error, please contact the responsible development team. errorcode: 744-234-200`, 
+      });
     }
   }
 }

package/src/_services/dynamobe-db-service-collection.service.ts

@@ -2,6 +2,9 @@
 import { DynamoBEDBService } from './dynamobe-db.service';
 import { DynamoBESingletonService } from './dynamobe-singleton.service';
 
+/**
+ * 
+ */
 export class DynamoBEDBServiceCollection extends DynamoBESingletonService {
 
   [service: string]: DynamoBEDBService<any>;

package/src/_services/dynamobe-db.service.ts

@@ -3,6 +3,9 @@ import * as mongoose from 'mongoose';
 import { Schema } from 'mongoose';
 import { Metadata, DynamoBEDataParams, DynamoBEDataPropertyParams, DynamoBEError } from '@futdevpro/fsm-dynamo';
 
+/**
+ * 
+ */
 export class DynamoBEDBService<T extends Metadata> {
   dataModel = mongoose.model(this.dataParams.dbName, this.getSchema());
 
@@ -36,10 +39,17 @@ export class DynamoBEDBService<T extends Metadata> {
       if (res) {
         newData = res.toObject() as T;
       } else {
-        throw new DynamoBEError({ status: 204, message: `${this.dataParams.dbName} not found! (BD)` });
+        throw new DynamoBEError({ 
+          status: 204, message: `${this.dataParams.dbName} not found! (BD)`,
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-401`, 
+        });
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 422, message: `Create new ${this.dataParams.dbName} was unsuccessful (BD)`, error });
+      throw new DynamoBEError({ 
+        status: 422, message: `Create new ${this.dataParams.dbName} was unsuccessful (BD)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-400`, 
+        error 
+      });
     });
     if (typeof newData._id === 'object') {
       newData._id = `${newData._id}`;
@@ -63,10 +73,17 @@ export class DynamoBEDBService<T extends Metadata> {
       if (res) {
         newData = res.toObject() as T;
       } else {
-        throw new DynamoBEError({ status: 204, message: `${this.dataParams.dbName} not found! (BD)` });
+        throw new DynamoBEError({ 
+          status: 204, message: `${this.dataParams.dbName} not found! (BD)`,
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-411`, 
+        });
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `modify ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `modify ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-410`, 
+        error 
+      });
     });
     data.__v = newData.__v;
     return data;
@@ -86,7 +103,11 @@ export class DynamoBEDBService<T extends Metadata> {
         data = null;
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `get ${this.dataParams.dbName} by ID was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `get ${this.dataParams.dbName} by ID was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-430`, 
+        error 
+      });
     });
     if (data && typeof data._id === 'object') {
       data._id = `${data._id}`;
@@ -109,14 +130,21 @@ export class DynamoBEDBService<T extends Metadata> {
           data = null;
         }
       }).catch(error => {
-        throw new DynamoBEError({ status: 417, message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (DB)`, error });
+        throw new DynamoBEError({ 
+          status: 417, message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (DB)`, 
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-441`, 
+          error 
+        });
       });
       if (data && typeof data._id === 'object') {
         data._id = `${data._id}`;
       }
       return data;
     } else {
-      throw new DynamoBEError({ status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)` });
+      throw new DynamoBEError({ 
+        status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)`,
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-440`, 
+      });
     }
   }
 
@@ -133,7 +161,11 @@ export class DynamoBEDBService<T extends Metadata> {
           dataList = res;
         }
       }).catch(error => {
-        throw new DynamoBEError({ status: 417, message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (DB)`, error });
+        throw new DynamoBEError({ 
+          status: 417, message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (DB)`, 
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-451`, 
+          error 
+        });
       });
       if (0 < dataList.length && typeof dataList[0]._id === 'object') {
         dataList.forEach((data: T) => {
@@ -142,7 +174,10 @@ export class DynamoBEDBService<T extends Metadata> {
       }
       return dataList;
     } else {
-      throw new DynamoBEError({ status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)` });
+      throw new DynamoBEError({ 
+        status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)`,
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-450`, 
+      });
     }
   }
 
@@ -159,11 +194,18 @@ export class DynamoBEDBService<T extends Metadata> {
           dataList = res;
         }
       }).catch(error => {
-        throw new DynamoBEError({ status: 417, message: `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (DB)`, error });
+        throw new DynamoBEError({ 
+          status: 417, message: `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (DB)`, 
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-461`, 
+          error 
+        });
       });
       return dataList;
     } else {
-      throw new DynamoBEError({ status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)` });
+      throw new DynamoBEError({ 
+        status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)`,
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-460`, 
+      });
     }
   }
 
@@ -181,7 +223,10 @@ export class DynamoBEDBService<T extends Metadata> {
       if (this.depDataName) {
         filter[this.depDataName] = { $in: narrowByDependencyIds };
       } else {
-        throw new DynamoBEError({ status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)` });
+        throw new DynamoBEError({ 
+          status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)`,
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-470`, 
+        });
       }
     }
     await this.dataParams.modelParams.forEach((modelParam: DynamoBEDataPropertyParams) => {
@@ -228,7 +273,11 @@ export class DynamoBEDBService<T extends Metadata> {
         dataList = res;
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `search ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `search ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-471`, 
+        error 
+      });
     });
     if (0 < dataList.length && typeof dataList[0]._id === 'object') {
       dataList.forEach((data: T) => {
@@ -240,11 +289,17 @@ export class DynamoBEDBService<T extends Metadata> {
 
   /**
    * find data by any of its parameters, throws error if not found
-   * @param data etc.: by email: { email: email }
+   * @param data 
+   * (always use unique parameters for find!)
+   * etc.: by email: 
+   * { email: email }
+   * or by id that is in list:
    * { userIds: { $in: this.userId } }
+   * or by number or Date that is greater than OR less than:
+   * { points: { $gte: 2, $lte: 14 } }
    * @returns data
    */
-  async findData(data: T): Promise<T> {
+  /* async findData(data: T): Promise<T> {
     await this.dataModel.findOne(data).then(res => {
       if (res) {
         data = res.toObject() as T;
@@ -258,7 +313,7 @@ export class DynamoBEDBService<T extends Metadata> {
       data._id = `${data._id}`;
     }
     return data;
-  }
+  } */
 
   /**
    * returns all data from database, throws error if not found
@@ -271,7 +326,11 @@ export class DynamoBEDBService<T extends Metadata> {
         dataList = res;
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `get all ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `get all ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-480`, 
+        error 
+      });
     });
     if (0 < dataList.length && typeof dataList[0]._id === 'object') {
       dataList.forEach((data: T) => {
@@ -281,27 +340,17 @@ export class DynamoBEDBService<T extends Metadata> {
     return dataList as T[];
   }
 
-  /**
-   * update one parameter by a specific
-   * { _id: pictureId }, { approved: true }
-   * @param updateBy etc.: { email: email } (always use unique parameters for find!)
-   * @param update etc.: { $inc: { popularity: this.newVote.amount }, emailVerified: true }
-   */
-  /* async updateOneParameter(updateBy: any, update: any, modifier: string): Promise<void> {
-    update.__lastModified = new Date();
-    update.__lastModifiedBy = modifier;
-    await this.dataModel.updateOne(updateBy, update).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `update one parameter on ${this.dataParams.dbName} was unsuccessful (DB)`, error });
-    });
-  } */
-
   /**
    * deleted data by id
    * @param id id
    */
   async deleteDataById(id: string): Promise<void> {
     await this.dataModel.findByIdAndDelete(id).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `delete ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `delete ${this.dataParams.dbName} was unsuccessful (DB)`,
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-490`,  
+        error 
+      });
     });
   }
 
@@ -312,10 +361,17 @@ export class DynamoBEDBService<T extends Metadata> {
   async deleteDataByDependencyId(dependencyId: string): Promise<void> {
     if (this.depDataName) {
       await this.dataModel.deleteMany({ [this.depDataName]: dependencyId }).catch(error => {
-        throw new DynamoBEError({ status: 417, message: `delete ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (DB)`, error });
+        throw new DynamoBEError({ 
+          status: 417, message: `delete ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (DB)`, 
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-591`, 
+          error 
+        });
       });
     } else {
-      throw new DynamoBEError({ status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)` });
+      throw new DynamoBEError({ 
+        status: 501, message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (BD)`,
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-590`, 
+      });
     }
   }
 
@@ -326,7 +382,21 @@ export class DynamoBEDBService<T extends Metadata> {
 
   /**
    * find the data first by any of its parameters, throws error if not found
-   * @param filter etc. by email: { email: email }
+   * @param filter
+   * (always use unique parameters for find!)
+   * etc.: by email: 
+   * { email: email }
+   * or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * or by number or Date that is GREATER THAN OR 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 data
    */
   async findOne(filter: any): Promise<T> {
@@ -338,7 +408,11 @@ export class DynamoBEDBService<T extends Metadata> {
         data = null;
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `findOne ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `findOne ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-510`, 
+        error 
+      });
     });
     if (data && typeof data._id === 'object') {
       data._id = `${data._id}`;
@@ -348,7 +422,20 @@ export class DynamoBEDBService<T extends Metadata> {
 
   /**
    * find all data by any of its parameters, throws error if not found
-   * @param filter etc. by email: { email: email, points: { $gte: 2, $lte: 12 }, userIds: { $in: this.userId } }
+   * @param filter 
+   * etc.: by email: 
+   * { email: email }
+   * or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * or by number or Date that is GREATER THAN OR 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 dataList
    */
   async find(filter: any): Promise<T[]> {
@@ -358,7 +445,11 @@ export class DynamoBEDBService<T extends Metadata> {
         dataList = res;
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `find ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `find ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-520`, 
+        error 
+      });
     });
     if (0 < dataList.length && typeof dataList[0]._id === 'object') {
       dataList.forEach((data: T) => {
@@ -370,7 +461,20 @@ export class DynamoBEDBService<T extends Metadata> {
 
   /**
    * find all data by any of its parameters, throws error if not found
-   * @param filter etc. by email: { email: email, points: { $gte: 2, $lte: 12 }, userIds: { $in: this.userId } }
+   * @param filter
+   * etc.: by email: 
+   * { email: email }
+   * or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * or by number or Date that is GREATER THAN OR 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 page page
    * @param pageSize pageSize
    * @param sort etc. by dateTime: { dateTime: -1 }
@@ -387,7 +491,11 @@ export class DynamoBEDBService<T extends Metadata> {
         dataList = res;
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `findWithPaging ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `findWithPaging ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-530`, 
+        error 
+      });
     });
     if (0 < dataList.length && typeof dataList[0]._id === 'object') {
       dataList.forEach((data: T) => {
@@ -411,10 +519,17 @@ export class DynamoBEDBService<T extends Metadata> {
       if (res) {
         data = res.toObject() as T;
       } else {
-        throw new DynamoBEError({ status: 204, message: `${this.dataParams.dbName} not found! (BD)` });
+        throw new DynamoBEError({ 
+          status: 204, message: `${this.dataParams.dbName} not found! (BD)`,
+          userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-541`, 
+        });
       }
     }).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `findByIdAndUpdate ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `findByIdAndUpdate ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-540`, 
+        error 
+      });
     });
     update.__v = data.__v;
     return update;
@@ -422,27 +537,88 @@ export class DynamoBEDBService<T extends Metadata> {
 
   /**
    * update one parameter by a specific
-   * @param updateBy etc.: by email: { email: email, points: { $gte: 2, $lte: 12 }, userIds: { $in: this.userId } } (always use unique parameters for find!)
-   * @param update etc.: { $inc: { popularity: this.newVote.amount }, emailVerified: true }
+   * @param updateBy
+   * (always use unique parameters for find!)
+   * etc.: by email: 
+   * { email: email }
+   * or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * or by number or Date that is GREATER THAN OR 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
+   * etc.: increase a specific value:
+   * { $inc: { popularity: 15 } }
+   * or add element to a list:
+   * { $push: { reactions: this.newReaction }
+   * 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 updateOne(updateBy: any, update: any, modifier: string): Promise<void> {
     update.__lastModified = new Date();
     update.__lastModifiedBy = modifier;
     await this.dataModel.updateOne(updateBy, update).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `updateOne ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `updateOne ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-550`, 
+        error 
+      });
     });
   }
 
   /**
    * update one parameter by a specific
-   * @param updateBy etc.: by email: { email: email, points: { $gte: 2, $lte: 12 }, userIds: { $in: this.userId } } (always use unique parameters for find!)
-   * @param update etc.: { $inc: { popularity: this.newVote.amount }, emailVerified: true, reactions: { $push: this.newReaction } }
+   * @param updateBy
+   * etc.: by email: 
+   * { email: email }
+   * or by id that is in list:
+   * { userIds: { $in: this.userId } }
+   * or by number or Date that is GREATER THAN OR 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 
+   * etc.: increase a specific value:
+   * { $inc: { popularity: 15 } }
+   * or add element to a list:
+   * { $push: { reactions: this.newReaction }
+   * 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 updateMany(updateBy: any, update: any, modifier: string): Promise<void> {
     update.__lastModified = new Date();
     update.__lastModifiedBy = modifier;
     await this.dataModel.updateMany(updateBy, update).catch(error => {
-      throw new DynamoBEError({ status: 417, message: `updateMany ${this.dataParams.dbName} was unsuccessful (DB)`, error });
+      throw new DynamoBEError({ 
+        status: 417, message: `updateMany ${this.dataParams.dbName} was unsuccessful (DB)`, 
+        userMessage: `We encountered an uncought DB Error, please contact the responsible development team. errorcode: 505-223-560`, 
+        error 
+      });
     });
   }