@futdevpro/nts-dynamo 1.5.17 → 1.5.20

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 
+      });
     });
   }
 

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

@@ -7,6 +7,9 @@ import { DynamoBEError } from '@futdevpro/fsm-dynamo';
 
 import { DBE_Shared } from './dynamobe-shared.service';
 
+/**
+ * 
+ */
 export class DynamoBEEmailService {
   private nmTransporter: NodeMailer.Transporter;
   private senderName: string;
@@ -52,14 +55,21 @@ export class DynamoBEEmailService {
         this.constructionFinished();
       }
     } catch (error) {
-      console.log(`\nDynamoBEEmailService ERROR, The emailService construction failed for ${set.email}.`, new Error());
+      DBE_Shared.logError(`\nDynamoBEEmailService ERROR, The emailService construction failed for ${set.email}.`, new Error());
     }
   }
 
+  /**
+   * 
+   */
   private constructionFinished(): void { 
     DBE_Shared.logSuccess(`\nEmailService construction (${this.senderName}) Finished!\n`) 
   }
 
+  /**
+   * 
+   * @param set 
+   */
   public async sendEmail(set: {
     to: string,
     subject: string,
@@ -77,24 +87,33 @@ export class DynamoBEEmailService {
         content = set.content
       } else if (set.useTemplate) {
         if (!this.templates[set.useTemplate]) {
-          throw new DynamoBEError({ message: `no template found with this parameter! (${set.useTemplate})` });
+          throw new DynamoBEError({ 
+            message: `no template found with this parameter! (${set.useTemplate})`,
+            userMessage: `We encountered an uncought BackEnd Email Service Error, please contact the responsible development team. errorcode: 701-114-101`, 
+          });
         }
         content = this.templates[set.useTemplate];
 
         if (this.templatePropertyKeys[set.useTemplate].length > 0) {
           if (!set.templateProperties) {
-            throw new DynamoBEError({ message: `templateProperties missing!` });
+            throw new DynamoBEError({ 
+              message: `templateProperties missing!`,
+              userMessage: `We encountered an uncought BackEnd Email Service Error, please contact the responsible development team. errorcode: 701-114-102`, 
+            });
           }
           this.templatePropertyKeys[set.useTemplate].forEach((propertyKey: string) => {
             if (!set.templateProperties[propertyKey]) {
-              console.log(`templateProperty missing! (${propertyKey})`);
+              DBE_Shared.logError(`templateProperty missing! (${propertyKey})`);
             }
             const reg = new RegExp(`{{${propertyKey}}}`, 'g')
             content = content.replace(reg, set.templateProperties[propertyKey]);
           })
         }
       } else {
-        throw new DynamoBEError({ message: 'no content setting passsed to emailSending!' });
+        throw new DynamoBEError({ 
+          message: 'no content setting passsed to emailSending!',
+          userMessage: `We encountered an uncought BackEnd Email Service Error, please contact the responsible development team. errorcode: 701-114-100`, 
+        });
       }
 
       let mailOptions: MailOptions = {
@@ -112,10 +131,17 @@ export class DynamoBEEmailService {
         }
       });
     } catch (error) {
-      console.log('\nDynamoBEEmailService ERROR, email sending error', error);
+      DBE_Shared.logError('\nDynamoBEEmailService ERROR, email sending error', error);
     }
   }
 
+  /**
+   * 
+   * @param templateName 
+   * @param rootPath 
+   * @param templatePath 
+   * @returns 
+   */
   private async loadTemplate(templateName: string, rootPath: string, templatePath: string): Promise<void> {
     try {
       this.templateLoadingInProgressCounter++;
@@ -123,7 +149,7 @@ export class DynamoBEEmailService {
         templatePath = Path.join(rootPath, templatePath);
         FileSystem.readFile(templatePath, 'utf8' , (err, template) => {
           if (err) {
-            console.log(`\nDynamoBEEmailService readFile ERROR (0), Couldn't load email template; ${templateName} from ${templatePath}\nerror:\n`, err, '\n');
+            DBE_Shared.logError(`\nDynamoBEEmailService readFile ERROR (0), Couldn't load email template; ${templateName} from ${templatePath}\nerror:\n`, err, '\n');
             reject(err);
             return;
           } else {
@@ -139,10 +165,15 @@ export class DynamoBEEmailService {
         });
       });
     } catch (error) {
-      console.log(`\nDynamoBEEmailService ERROR (1), Couldn't load email template; ${templateName} from ${templatePath}`, new Error());
+      DBE_Shared.logError(`\nDynamoBEEmailService ERROR (1), Couldn't load email template; ${templateName} from ${templatePath}`, new Error());
     }
   }
 
+  /**
+   * 
+   * @param template 
+   * @returns 
+   */
   private getTemplatePropertyKeys(template: string): string[] {
     try {
       const propertyKeys: string[] = [];
@@ -150,8 +181,11 @@ export class DynamoBEEmailService {
       let propertyCloseTagIndex = template.indexOf('}}', propertyOpenTagIndex + 2);
       while (propertyOpenTagIndex >= 0) {
         if (propertyCloseTagIndex === -1) {
-          console.log(`\nDynamoBEEmailService ERROR, missing closing tag from email template! (${propertyOpenTagIndex} -)`, propertyKeys);
-          throw new DynamoBEError({ message: `ERROR, missing closing tag from email template! (${propertyOpenTagIndex} -)` });
+          DBE_Shared.logError(`\nDynamoBEEmailService ERROR, missing closing tag from email template! (${propertyOpenTagIndex} -)`, propertyKeys);
+          throw new DynamoBEError({ 
+            message: `ERROR, missing closing tag from email template! (${propertyOpenTagIndex} -)`,
+            userMessage: `We encountered an uncought BackEnd Email Service Error, please contact the responsible development team. errorcode: 701-114-200`, 
+          });
         }
         const newKey: string = template.substring(propertyOpenTagIndex + 2, propertyCloseTagIndex);
         if (!propertyKeys.includes(newKey)) {
@@ -163,7 +197,7 @@ export class DynamoBEEmailService {
       // console.log('\n\n\nTEST propertyKeys: ', propertyKeys);
       return propertyKeys;
     } catch (error) {
-      console.log(`\nDynamoBEEmailService ERROR, getTemplatePropertyKeys ERROR`, new Error(), '\ntemplate:\n', template);
+      DBE_Shared.logError(`\nDynamoBEEmailService ERROR, getTemplatePropertyKeys ERROR`, new Error(), '\ntemplate:\n', template);
     }
   }
 }

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

@@ -55,6 +55,10 @@ export class DBE_Global_S extends DynamoBESingletonService {
     this.instance.emailServiceCollection = set.emailServiceCollection;
   }
 
+  /**
+   * 
+   * @returns 
+   */
   static getAuthService(): DynamoBEAuthService {
     if (!this.instance?.authService?.authenticateToken) {
       throw new Error(
@@ -65,6 +69,10 @@ export class DBE_Global_S extends DynamoBESingletonService {
     return this.instance.authService;
   }
 
+  /**
+   * 
+   * @returns 
+   */
   static getDBServiceCollection(): DynamoBEDBServiceCollection {
     if (!this.instance?.dbServiceCollection) {
       throw new Error(
@@ -75,10 +83,20 @@ export class DBE_Global_S extends DynamoBESingletonService {
     return this.instance.dbServiceCollection;
   }
 
+  /**
+   * 
+   * @param dataParams 
+   * @returns 
+   */
   static getDBService<T extends Metadata>(dataParams: DynamoBEDataParams): DynamoBEDBService<T> {
     return this.getDBServiceByKey<T>(dataParams.dataName);
   }
 
+  /**
+   * 
+   * @param key 
+   * @returns 
+   */
   static getDBServiceByKey<T extends Metadata>(key: string): DynamoBEDBService<T> {
     const collection = this.getDBServiceCollection();
     if (collection[key]) {
@@ -94,6 +112,10 @@ export class DBE_Global_S extends DynamoBESingletonService {
     }
   }
 
+  /**
+   * 
+   * @returns 
+   */
   static getEmailServiceCollection(): DynamoBEEmailServiceCollection {
     if (!this.instance?.emailServiceCollection) {
       throw new Error(