@futdevpro/nts-dynamo 1.5.52 → 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,13 +223,191 @@ 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 {
       if (set.updateBy) {
-        this.data = await this.dataDBService.updateOne(set.updateBy, set.update, this.issuer);
+        await this.dataDBService.updateOne(set.updateBy, set.update, this.issuer);
+      } else if (this.data._id) {
+        await this.dataDBService.updateOne({ _id: this.data._id }, set.update, this.issuer);
+      } else if (this.depKey && this.data[this.depKey]) {
+        await this.dataDBService.updateOne({ [this.depKey]: this.data[this.depKey] }, set.update, this.issuer);
+      } else {
+        throw new Dynamo_Error({
+          status: 417, 
+          errorCode: 'NTS-DS0-UD1',
+          addECToUserMsg: true,
+          message: `no usable parameter provided for updateData; no updateBy, no id, no dependencyId (${this.dataParams.dataName})`, 
+          userMessage: this.defaultErrorUserMsg, 
+        });
       }
-
     } catch (error) {
       throw new Dynamo_Error({ 
         status: 417, 
@@ -219,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 
@@ -229,36 +435,43 @@ 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);
-        if (!dataExists) {
+        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);
+        } else {
           // if data not exists check that dependency already exists for this
           if (this.depKey) {
-            if (this.data[this.depKey]) {
-              let dependencyExists = await this.getDependencyDataDBService().getDataById(this.data[this.depKey]);
-              if (!dependencyExists) {
-                throw new Dynamo_Error({ 
-                  status: 417, 
-                  errorCode: 'NTS-DS0-SD1',
-                  addECToUserMsg: true,
-                  message: `saveData was unsuccessful: dependency data not exists (key: ${this.depKey}, id: ${this.data[this.depKey]})`, 
-                  userMessage: this.defaultErrorUserMsg
-                });
+            if (!this.data[this.depKey]) {
+              throw new Dynamo_Error({ 
+                status: 417, 
+                errorCode: 'NTS-DS0-SD1',
+                addECToUserMsg: true,
+                message: `saveData was unsuccessful: dependency data id missing from data (key: ${this.depKey})`, 
+                userMessage: this.defaultErrorUserMsg
+              });
+            }
+
+            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;
               }
-            } else {
+            });
+            if (!dependencyExists) {
               throw new Dynamo_Error({ 
                 status: 417, 
                 errorCode: 'NTS-DS0-SD2',
                 addECToUserMsg: true,
-                message: `saveData was unsuccessful: dependency data id missing from data (key: ${this.depKey})`, 
+                message: `saveData was unsuccessful: dependency data not exists (key: ${this.depKey}, id: ${this.data[this.depKey]})`, 
                 userMessage: this.defaultErrorUserMsg
               });
             }
           }
           // if data not exists create new data
           this.data = await this.dataDBService.createData(this.data, this.issuer);
-        } else {
-          // if data exists do modify
-          this.data = await this.dataDBService.modifyData(this.data, this.issuer);
         }
       } else {
         // if ID is not present, data not exists, create new data
@@ -281,9 +494,7 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
    */
   async deleteData(): Promise<void> {
     try {
-      if (this.data._id) {
-        await this.dataDBService.deleteDataById(this.data._id);
-      } else {
+      if (!this.data._id) {
         throw new Dynamo_Error({ 
           status: 417, 
           errorCode: 'NTS-DS0-DD1',
@@ -292,6 +503,8 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
           userMessage: this.defaultErrorUserMsg, 
         });
       }
+          
+      await this.dataDBService.deleteDataById(this.data._id);
     } catch (error) {
       throw new Dynamo_Error({ 
         status: 417, 
@@ -321,6 +534,7 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
             userMessage: this.defaultValidationErrorUserMsg
           });
         }
+
         // specific Date validation
         if (this.dataParams.modelParams[i].type === 'Date' && !(new Date(this.data[this.dataParams.modelParams[i].key]) instanceof Date)) {
           throw new Dynamo_Error({
@@ -331,6 +545,7 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
             userMessage: this.defaultValidationErrorUserMsg
           });
         }
+
         // call additional validators
         if (this.dataParams.modelParams[i].additionalValidators) {
           for (let j = 0; j < this.dataParams.modelParams[i].additionalValidators.length; j++) {
@@ -368,14 +583,7 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
    * @returns 
    */
   getDependencyDataDBService(): DynamoNTS_DBService<any> {
-    if (this.depDBServiceKey) {
-      if (this.depDataDBService) {
-        return this.depDataDBService;
-      } else {
-        this.depDataDBService = DynamoNTS_GlobalService.getDBServiceByKey(this.depDBServiceKey);
-        return this.depDataDBService;
-      }
-    } else {
+    if (!this.depDBServiceKey) {
       throw new Dynamo_Error({ 
         status: 501, 
         errorCode: 'NTS-DS0-GDDB0',
@@ -384,5 +592,12 @@ export class DynamoNTS_DataService<T extends Dynamo_Metadata> {
         userMessage: this.defaultErrorUserMsg
       });
     }
+
+    if (this.depDataDBService) {
+      return this.depDataDBService;
+    } else {
+      this.depDataDBService = DynamoNTS_GlobalService.getDBServiceByKey(this.depDBServiceKey);
+      return this.depDataDBService;
+    }
   }
 }