@futdevpro/nts-dynamo 1.9.15 → 1.9.16

package/src/_services/base/data.service.ts

@@ -1,921 +1,921 @@
-
-import { 
-  DynamoFM_Metadata, DynamoFM_DataModel_Params, DynamoFM_DataProperty_Params, DynamoFM_Error,
-  DynamoFM_Log, DynamoFM_AnyError, DynamoFM_Error_Settings, DynamoFM_ErrorLevel 
-} from '@futdevpro/fsm-dynamo';
-import { DynamoNTS_DBFilter } from '../../_models/types/db-filter.type';
-import { DynamoNTS_DBUpdate } from '../../_models/types/db-update.type';
-
-import { DynamoNTS_DBService } from './db.service';
-import { DynamoNTS_GlobalService } from '../core/global.service';
-
-/**
- * Basic Data Service that is connected to the relevant DBServices
- * 
- * @example
- * export class UserMatchStatisticsService extends DynamoNTS_DataService<UserMatchStatistics> {
- *   constructor(
- *     set?: {
- *       data?: UserMatchStatistics,
- *       issuer?: string,
- *     }
- *   ) {
- *     super(
- *       new UserMatchStatistics(set?.data),
- *       userMatchStatisticsModelParams
- *     );
- *     this.issuer = set?.issuer;
- *   }
- * }
- */
-export class DynamoNTS_DataService<T extends DynamoFM_Metadata> {
-
-  serviceName: string;
-
-  dataDBService: DynamoNTS_DBService<T>;
-  data: T;
-  dataList: T[] = [];
-  issuer: string;
-
-  depKey?: string;
-  depDBServiceKey?: string;
-  depKeyIsUnique?: boolean;
-  depKeyIsRequired?: boolean;
-  private depDataDBService: DynamoNTS_DBService<any>;
-
-  dataParams: DynamoFM_DataModel_Params;
-
-  defaultErrorUserMsg: string = 
-    `We encountered an unhandled Data Service Error, ` +
-    `\nplease contact the responsible development team.`; 
-  defaultValidationErrorUserMsg: string = 
-    `We encountered an unhandled Validation Error, ` +
-    `\nplease contact the responsible development team.`; 
-
-  constructor(
-    /**
-     * Initial data, this will be used by functions on default
-     */
-    data: T,
-    /**
-     * DB data prams will be used to connect to usable dbService on GlobalService
-     */
-    dataParams: DynamoFM_DataModel_Params,
-    /**
-     * Initial set for issuer to be able to follow the issuer's activity
-     */
-    issuer: string
-  ) {
-    try {
-      this.serviceName = this.constructor?.name;
-      this.dataDBService = DynamoNTS_GlobalService.getDBService<T>(dataParams);
-      this.data = data;
-      this.dataParams = dataParams;
-      this.lookForDependencyDataSettings();
-      this.issuer = issuer;
-    } catch (error) {
-      throw new DynamoFM_Error({
-        ...this._getDefaultErrorSettings('constructor', error),
-        message: `The dataService construction failed for ${dataParams?.dataName}. ` +
-          `${this.serviceName} (${this.constructor.name})` +
-          `\nMaybe you forgot to add the dbService to the GlobalService?\n\n`,
-        level: DynamoFM_ErrorLevel.critical,
-        
-        errorCode: 'NTS-DS0-C00',
-      });
-      /* DynamoFM_Log.error(
-        `\nDynamoNTS_DataService ERROR: ` +
-        `\nThe dataService construction failed for ` +
-        `${dataParams?.dataName}. ${this.serviceName} (${this.constructor.name})` +
-        `\nMaybe you forgot to add the dbService to the GlobalService?` +
-        `\n\n`, 
-        new Error()
-      ); */
-    }
-  }
-
-  /**
-   * returns all data from database to service dataList
-   */
-  async getAll(dontSetToService?: boolean): Promise<T[]> {
-    try {
-      const dataListExists: T[] = await this.dataDBService.getAll().catch((error): T[] => {
-        if (error?.errorCode === 'NTS-DBS-GA1') {
-          DynamoFM_Log.warn(`getAll ${this.dataParams.dataName} didn't found any.`);
-
-          return [];
-        } else {
-          throw error;
-        }
-      });
-
-      if (!dontSetToService) {
-        this.dataList = dataListExists;
-      }
-
-      return dataListExists;
-    } catch (error) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings('getAll', error),
-
-        errorCode: 'NTS-DS0-GA0',
-      });
-    }
-  }
-
-  /**
-   * @description
-   * returns data from database by id
-   * also if dontSetToService is false or not setted, 
-   * the data will be saved to the service, even if its not found
-   * 
-   * @remarks 
-   * If you need to get-save a data, if possible, 
-   * use db-service update instead.
-   * 
-   * @param {string} id
-   * (using id from service.data, if not provided)
-   * @param dontSetToService
-   * 
-   * @return {T} data: T
-   */
-  async getDataById(id?: string, dontSetToService?: boolean): Promise<T> {
-    try {
-      if (!id && !this.data._id) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'getDataById', 
-            new Error(
-              `getDataById failed, ID is missing! ` +
-              `(maybe you wanted to use getDataByDependencyId() instead...) ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-          
-          errorCode: 'NTS-DS0-GI1',
-        });
-      }
-
-      const dataExists: T = await this.dataDBService.getDataById(id ?? this.data._id);
-
-      if (!dontSetToService) {
-        this.data = dataExists;
-      }
-
-      return dataExists;
-    } catch (error) {
-      if (error?.errorCode == 'NTS-DS0-GI1') {
-        throw error;
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getDataById', error),
-          errorCode: 'NTS-DS0-GI0',
-        });
-      }
-    }
-  }
-
-  async getDataByIds(ids: string[], dontSetToService?: boolean): Promise<T[]> {
-    try {
-      if (!ids) {
-        throw new DynamoFM_Error({
-          ...this._getDefaultErrorSettings(
-            'getDataByIds',
-            new Error(`getDataByIds failed, ids is missing! (${this.dataParams.dataName})`)
-          ),
-
-          errorCode: 'NTS-DS0-GIS1',
-        });
-      }
-
-      if (ids.length === 0) {
-        return [];
-      }
-
-      const datas: T[] = await this.dataDBService.find({ _id: { $in: ids } });
-
-      if (!dontSetToService) {
-        this.dataList = datas;
-      }
-
-      return datas;
-    } catch (error) {
-      throw new DynamoFM_Error({
-        ...this._getDefaultErrorSettings('getDataByIds', error),
-
-        errorCode: 'NTS-DS0-GIS0',
-      });
-    }
-  }
-  
-  /**
-   * returns data from database by dependencyId to the service
-   * (using id from service.data, if not provided)
-   * @param dependencyId 
-   */
-  async getDataByDependencyId(dependencyId?: string, dontSetToService?: boolean): Promise<T> {
-    try {
-      if (!this.depKey) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'getDataByDependencyId',
-            new Error(
-              `getDataByDependencyId failed, dependencyKey is missing from service! ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-          
-          errorCode: 'NTS-DS0-GD1',
-        });
-      }
-
-      if (!dependencyId && !this.data[this.depKey]) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'getDataByDependencyId',
-            new Error(
-              `getDataByDependencyId failed, ${this.depKey} is missing! ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-          
-          errorCode: 'NTS-DS0-GD2',
-        });
-      }
-
-      const dataExists: T = await this.dataDBService.getDataByDependencyId(
-        dependencyId ?? this.data[this.depKey]
-      ).catch((error): null => {
-        if (error?.errorCode === 'NTS-DBS-GD2') {
-          DynamoFM_Log.warn(
-            `getDataByDependencyId failed; ${this.dataParams.dataName} ` +
-            `(${this.depKey}: ${dependencyId ?? this.data[this.depKey]}) didn't found any.`
-          );
-
-          return null;
-        } else {
-          throw error;
-        }
-      });
-
-      if (!dontSetToService) {
-        this.data = dataExists;
-      }
-
-      return dataExists;
-    } catch (error) {
-      if ([ 'NTS-DS0-GD1', 'NTS-DS0-GD2' ].includes(error?.errorCode)) {
-        throw error;
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getDataByDependencyId', error),
-          
-          errorCode: 'NTS-DS0-GD0',
-        });
-      }
-    }
-  }
-
-  async getDatasByDependencyIds(dependencyIds: string[], dontSetToService?: boolean): Promise<T[]> {
-    try {
-      if (!this.depKey) {
-        throw new DynamoFM_Error({
-          ...this._getDefaultErrorSettings(
-            'getDatasByDependencyIds',
-            new Error(
-              `getDatasByDependencyIds failed, dependencyKey is missing from service! ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-
-          errorCode: 'NTS-DS0-GDS1',
-        });
-      }
-
-      if (!dependencyIds) {
-        throw new DynamoFM_Error({
-          ...this._getDefaultErrorSettings(
-            'getDatasByDependencyIds',
-            new Error(
-              `getDatasByDependencyIds failed, dependencyIds is missing! ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-
-          errorCode: 'NTS-DS0-GDS2',
-        });
-      }
-
-      if (dependencyIds.length === 0) {
-        return [];
-      }
-
-      const datas: T[] = await this.dataDBService.getDatasByDependencyIds(dependencyIds);
-
-      if (!dontSetToService) {
-        this.dataList = datas;
-      }
-
-      return datas;
-    } catch (error) {
-      if ([ 'NTS-DS0-GDS1', 'NTS-DS0-GDS2' ].includes(error?.errorCode)) {
-        throw error;
-      } else {
-        throw new DynamoFM_Error({
-          ...this._getDefaultErrorSettings('getDatasByDependencyIds', error),
-
-          errorCode: 'NTS-DS0-GDS0',
-        });
-      }
-    }
-  }      
-  
-  /**
-   * returns dataList from database by dependencyId to the service
-   * @param dependencyId 
-   */
-  async getDataListByDependencyId(dependencyId?: string, dontSetToService?: boolean): Promise<T[]> {
-    try {
-      if (!this.depKey) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'getDataListByDependencyId',
-            new Error(
-              `getDataListByDependencyId failed, dependencyKey is missing from service! ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-          
-          errorCode: 'NTS-DS0-GLD1',
-        });
-      }
-
-      if (!dependencyId && !this.data[this.depKey]) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'getDataListByDependencyId',
-            new Error(
-              `getDataListByDependencyId failed, ${this.depKey} is missing! ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-          
-          errorCode: 'NTS-DS0-GLD2',
-        });
-      }
-
-      const dataListExists: T[] = await this.dataDBService.getDataListByDependencyId(
-        dependencyId ?? this.data[this.depKey]
-      ).catch((error): T[] => {
-        if (error?.errorCode === 'NTS-DBS-GLD2') {
-          DynamoFM_Log.warn(
-            `getDataListByDependencyId ${this.dataParams.dataName} ` +
-            `(${this.depKey}: ${dependencyId ?? this.data[this.depKey]}) didn't found any.`
-          );
-
-          return [];
-        } else {
-          throw error;
-        }
-      });
-
-      if (!dontSetToService) {
-        this.dataList = dataListExists;
-      }
-
-      return dataListExists;
-    } catch (error) {
-      if ([ 'NTS-DS0-GLD1', 'NTS-DS0-GLD2' ].includes(error?.errorCode)) {
-        throw error;
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getDataListByDependencyId', error),
-          
-          errorCode: 'NTS-DS0-GLD0',
-          
-        });
-      }
-    }
-  }
-
-  /**
-   * 
-   * // 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(filterBy: DynamoNTS_DBFilter<T>, dontSetToService?: boolean): Promise<T> {
-    try {
-      const dataExists: T = await this.dataDBService.findOne(filterBy).catch((error): null => {
-        if (error?.errorCode === 'NTS-DBS-FO1') {
-          DynamoFM_Log.warn(`findData ${this.dataParams.dataName} didn't found any.`);
-
-          return null;
-        } else {
-          throw error;
-        }
-      });
-
-      if (!dontSetToService) {
-        this.data = dataExists;
-      }
-
-      return dataExists;
-    } catch (error) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings('findData', error),
-        
-        errorCode: 'NTS-DS0-FD0',
-      });
-    }
-  }
-
-  /**
-   * 
-   * // 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(filterBy: DynamoNTS_DBFilter<T>, dontSetToService?: boolean): Promise<T[]> {
-    try {
-      const dataListExists: T[] = await this.dataDBService.find(filterBy).catch((error): T[] => {
-        if (error?.errorCode === 'NTS-DBS-F1') {
-          DynamoFM_Log.warn(`findDatas ${this.dataParams.dataName} didn't found any.`);
-
-          return [];
-        } else {
-          throw error;
-        }
-      });
-
-      if (!dontSetToService) {
-        this.dataList = dataListExists;
-      }
-
-      return dataListExists;
-    } catch (error) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings('findDatas', error),
-        
-        errorCode: 'NTS-DS0-FDS0',
-      });
-    }
-  }
-
-  /**
-   * 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: { filterBy?: DynamoNTS_DBFilter<T>, update: DynamoNTS_DBUpdate<T> }
-  ): Promise<void> {
-    try {
-      if (set.filterBy) {
-        await this.dataDBService.updateOne(set.filterBy, set.update, this.issuer);
-
-      } else if (this.data._id) {
-        await this.dataDBService.updateOne(
-          { _id: this.data._id } as DynamoNTS_DBFilter<T>, 
-          set.update, 
-          this.issuer
-        );
-
-      } else if (this.depKey && this.data[this.depKey]) {
-        await this.dataDBService.updateOne(
-          { [this.depKey]: this.data[this.depKey] } as DynamoNTS_DBFilter<T>, 
-          set.update, 
-          this.issuer
-        );
-
-      } else {
-        throw new DynamoFM_Error({
-          ...this._getDefaultErrorSettings(
-            'updateData',
-            new Error(
-              `no usable parameter provided for updateData; no updateBy, no id, no dependencyId ` +
-              `(${this.dataParams.dataName})`
-            )
-          ),
-          
-          errorCode: 'NTS-DS0-UD1',
-        });
-      }
-    } catch (error) {
-      
-      if (error?.errorCode == 'NTS-DS0-UD1') {
-        throw error;
-
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('updateData', error),
-          
-          errorCode: 'NTS-DS0-UD0',
-        });
-      }
-    }
-  }
-
-  /**
-   * 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 
-   * (when you simultaneously trying to change the same data's 
-   * different values from different flows)
-   */
-  async saveData(): Promise<T> {
-    try {
-      if (!this.data) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'saveData', 
-            new Error(`no data to save! (${this.dataParams.dataName})`)
-          ),
-          
-          errorCode: 'NTS-DS0-SD4',
-        });
-      }
-
-      await this.validateForSave();
-
-      if (!this.data._id && (!this.depKey || !this.data[this.depKey])) {
-        // if ID of dependencyID is not present, data not exists, create new data
-        this.data = await this.dataDBService.createData(this.data, this.issuer);
-
-        return this.data;
-      }
-
-      let dataExists: T;
-
-      // check if data already exists with the specific ID
-      if (this.data._id) {
-        dataExists = await this.getDataById(null, true);
-
-        if (dataExists) {
-          // if data exists do modify
-          this.data = await this.dataDBService.modifyData(this.data, this.issuer);
-
-          return this.data;
-
-        } else {
-          throw new DynamoFM_Error({ 
-            ...this._getDefaultErrorSettings(
-              'saveData',
-              new Error(
-                `saveData was unsuccessful: provided ID not exists ` +
-                `(id: ${this.data._id}, ${this.dataParams.dataName})`
-              )
-            ),
-
-            errorCode: 'NTS-DS0-SD1',
-          });
-        }
-      }
-
-      if (this.depKey) {
-        if (!this.data[this.depKey]) {
-          throw new DynamoFM_Error({ 
-            ...this._getDefaultErrorSettings(
-              'saveData',
-              new Error(
-                `saveData was unsuccessful: dependency data id missing from data ` +
-                `(key: ${this.depKey}, ${this.dataParams.dataName})`
-              )
-            ),
-            
-            errorCode: 'NTS-DS0-SD2',
-          });
-        }
-
-        if (this.depKeyIsUnique) {
-          dataExists = await this.getDataByDependencyId(null, true);
-
-          if (dataExists) {
-            // if data exists do modify
-            this.data = await this.dataDBService.modifyData(this.data, this.issuer);
-
-            return this.data;
-
-          } else if (this.depKeyIsRequired) {
-            // if data not exists check that dependency already exists for this
-            const dependencyExists = await this.getDependencyDataDBService()
-              .getDataById(this.data[this.depKey])
-              .catch();
-
-            if (!dependencyExists) {
-              throw new DynamoFM_Error({ 
-                ...this._getDefaultErrorSettings(
-                  'saveData',
-                  new Error(
-                    `saveData was unsuccessful: dependency data not exists ` +
-                    `(key: ${this.depKey}, id: ${this.data[this.depKey]}, ` +
-                    `${this.dataParams.dataName})`
-                  )
-                ),
-                
-                errorCode: 'NTS-DS0-SD3',
-              });
-            }
-          }
-        }
-      }
-
-      // if data not exists create new data
-      this.data = await this.dataDBService.createData(this.data, this.issuer);
-
-      return this.data;
-
-    } catch (error) {
-      if ([ 'NTS-DS0-SD1', 'NTS-DS0-SD2' ].includes(error?.errorCode)) {
-        throw error;
-
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('saveData', error),
-          
-          errorCode: 'NTS-DS0-SD0',
-        });
-      }
-    }
-  }
-
-  /**
-   * permanently deletes data from database by data._id
-   */
-  async deleteData(): Promise<void> {
-    try {
-      if (!this.data._id) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'deleteData',
-            new Error(`deleteData failed, ID is missing! (${this.dataParams.dataName})`)
-          ),
-          
-          errorCode: 'NTS-DS0-DD1',
-        });
-      }
-          
-      await this.dataDBService.deleteDataById(this.data._id);
-    } catch (error) {
-      if (error?.errorCode == 'NTS-DS0-DD1') {
-        throw error;
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('deleteData', error),
-          
-          errorCode: 'NTS-DS0-DD0',
-        });
-      }
-    }
-  }
-
-  /**
-   * validation of data, for modify and create, by the ModelParams
-   */
-  async validateForSave(): Promise<void> {
-    try {
-      for (let i = 0; i < this.dataParams.properties.length; i++) {
-        // basic required validations
-        if (
-          (this.dataParams.properties[i].required && 
-            (this.data[this.dataParams.properties[i].key] === null || 
-              this.data[this.dataParams.properties[i].key] === undefined
-            )
-          ) ||
-          (this.dataParams.properties[i].index && 
-            (this.data[this.dataParams.properties[i].key] === null || 
-              this.data[this.dataParams.properties[i].key] === undefined
-            )
-          )
-        ) {
-          throw new DynamoFM_Error({ 
-            ...this._getDefaultErrorSettings(
-              'validateForSave',
-              new Error(
-                `validateForSave failed, ${this.dataParams.properties[i].key} is missing! ` +
-                `(${this.dataParams.dataName})`
-              )
-            ),
-
-            status: 422, 
-            errorCode: 'NTS-DS0-VD1',
-            userMessage: this.defaultValidationErrorUserMsg,
-          });
-        }
-
-        // specific Date validation
-        if (this.dataParams.properties[i].type === 'Date' && 
-          !(new Date(this.data[this.dataParams.properties[i].key]) instanceof Date)
-        ) {
-          throw new DynamoFM_Error({
-            ...this._getDefaultErrorSettings(
-              'validateForSave',
-              new Error(
-                `validateForSave failed, ${this.dataParams.properties[i].key} is not a date! ` +
-                `(${this.dataParams.dataName})`
-              )
-            ),
-
-            status: 422, 
-            errorCode: 'NTS-DS0-VD2',
-            userMessage: this.defaultValidationErrorUserMsg,
-          });
-        }
-
-        // call additional validators
-        if (this.dataParams.properties[i].additionalValidators) {
-          for (let j = 0; j < this.dataParams.properties[i].additionalValidators.length; j++) {
-            this.dataParams.properties[i].additionalValidators[j](
-              this.data[this.dataParams.properties[i].key]
-            );
-          }
-        }
-      }
-    } catch (error) {
-      if ([ 'NTS-DS0-VD1', 'NTS-DS0-VD2' ].includes(error?.errorCode)) {
-        throw error;
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('validateForSave', error),
-
-          status: 422, 
-          errorCode: 'NTS-DS0-VD0',
-        });
-      }
-    }
-  }
-
-  /**
-   * setting up dependency dataHook by DynamoBEDataModelParams
-   */
-  private lookForDependencyDataSettings(): void {
-    const dependencyParam: DynamoFM_DataProperty_Params = this.dataParams.properties.find(
-      (modelParams: DynamoFM_DataProperty_Params): boolean => modelParams.isDependencyHook
-    );
-
-    if (dependencyParam) {
-      this.depKey = dependencyParam.key;
-
-      if (dependencyParam.dependencyDataName) {
-        this.depDBServiceKey = dependencyParam.dependencyDataName;
-      }
-
-      if (dependencyParam.unique) {
-        this.depKeyIsUnique = true;
-      }
-
-      if (dependencyParam.required) {
-        this.depKeyIsRequired = true;
-      }
-    }
-  }
-
-  /**
-   * 
-   * @returns 
-   */
-  getDependencyDataDBService(): DynamoNTS_DBService<any> {
-    if (!this.depDBServiceKey) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings(
-          'getDependencyDataDBService',
-          new Error(
-            `getDependencyDataDBService was unsuccessful, service key not setted up! ` +
-            `(${this.dataParams.dataName}))`
-          )
-        ),
-
-        status: 501, 
-        errorCode: 'NTS-DS0-GDDB0',
-      });
-    }
-
-    if (this.depDataDBService) {
-      return this.depDataDBService;
-    } else {
-      this.depDataDBService = DynamoNTS_GlobalService.getDBServiceByKey(this.depDBServiceKey);
-
-      return this.depDataDBService;
-    }
-  }
-  
-  private _getDefaultErrorSettings(
-    fnName: string, 
-    error: DynamoFM_AnyError
-  ): DynamoFM_Error_Settings {
-    return {
-      status: (error as DynamoFM_Error)?.___status ?? 500,
-      message: 
-        (error as Error)?.message ?? 
-        `${fnName} was UNSUCCESFUL (NTS; ${this.dataParams.dataName})`,
-      addECToUserMsg: !(error as DynamoFM_Error)?.__userMessage,
-      userMessage: (error as DynamoFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
-      issuer: this.issuer,
-      issuerService: this.serviceName + ` (${this?.constructor?.name}-DynamoNTS_DataService)`,
-      error: error,
-    };
-  }
-}
+
+import { 
+  DynamoFM_Metadata, DynamoFM_DataModel_Params, DynamoFM_DataProperty_Params, DynamoFM_Error,
+  DynamoFM_Log, DynamoFM_AnyError, DynamoFM_Error_Settings, DynamoFM_ErrorLevel 
+} from '@futdevpro/fsm-dynamo';
+import { DynamoNTS_DBFilter } from '../../_models/types/db-filter.type';
+import { DynamoNTS_DBUpdate } from '../../_models/types/db-update.type';
+
+import { DynamoNTS_DBService } from './db.service';
+import { DynamoNTS_GlobalService } from '../core/global.service';
+
+/**
+ * Basic Data Service that is connected to the relevant DBServices
+ * 
+ * @example
+ * export class UserMatchStatisticsService extends DynamoNTS_DataService<UserMatchStatistics> {
+ *   constructor(
+ *     set?: {
+ *       data?: UserMatchStatistics,
+ *       issuer?: string,
+ *     }
+ *   ) {
+ *     super(
+ *       new UserMatchStatistics(set?.data),
+ *       userMatchStatisticsModelParams
+ *     );
+ *     this.issuer = set?.issuer;
+ *   }
+ * }
+ */
+export class DynamoNTS_DataService<T extends DynamoFM_Metadata> {
+
+  serviceName: string;
+
+  dataDBService: DynamoNTS_DBService<T>;
+  data: T;
+  dataList: T[] = [];
+  issuer: string;
+
+  depKey?: string;
+  depDBServiceKey?: string;
+  depKeyIsUnique?: boolean;
+  depKeyIsRequired?: boolean;
+  private depDataDBService: DynamoNTS_DBService<any>;
+
+  dataParams: DynamoFM_DataModel_Params;
+
+  defaultErrorUserMsg: string = 
+    `We encountered an unhandled Data Service Error, ` +
+    `\nplease contact the responsible development team.`; 
+  defaultValidationErrorUserMsg: string = 
+    `We encountered an unhandled Validation Error, ` +
+    `\nplease contact the responsible development team.`; 
+
+  constructor(
+    /**
+     * Initial data, this will be used by functions on default
+     */
+    data: T,
+    /**
+     * DB data prams will be used to connect to usable dbService on GlobalService
+     */
+    dataParams: DynamoFM_DataModel_Params,
+    /**
+     * Initial set for issuer to be able to follow the issuer's activity
+     */
+    issuer: string
+  ) {
+    try {
+      this.serviceName = this.constructor?.name;
+      this.dataDBService = DynamoNTS_GlobalService.getDBService<T>(dataParams);
+      this.data = data;
+      this.dataParams = dataParams;
+      this.lookForDependencyDataSettings();
+      this.issuer = issuer;
+    } catch (error) {
+      throw new DynamoFM_Error({
+        ...this._getDefaultErrorSettings('constructor', error),
+        message: `The dataService construction failed for ${dataParams?.dataName}. ` +
+          `${this.serviceName} (${this.constructor.name})` +
+          `\nMaybe you forgot to add the dbService to the GlobalService?\n\n`,
+        level: DynamoFM_ErrorLevel.critical,
+        
+        errorCode: 'NTS-DS0-C00',
+      });
+      /* DynamoFM_Log.error(
+        `\nDynamoNTS_DataService ERROR: ` +
+        `\nThe dataService construction failed for ` +
+        `${dataParams?.dataName}. ${this.serviceName} (${this.constructor.name})` +
+        `\nMaybe you forgot to add the dbService to the GlobalService?` +
+        `\n\n`, 
+        new Error()
+      ); */
+    }
+  }
+
+  /**
+   * returns all data from database to service dataList
+   */
+  async getAll(dontSetToService?: boolean): Promise<T[]> {
+    try {
+      const dataListExists: T[] = await this.dataDBService.getAll().catch((error): T[] => {
+        if (error?.errorCode === 'NTS-DBS-GA1') {
+          DynamoFM_Log.warn(`getAll ${this.dataParams.dataName} didn't found any.`);
+
+          return [];
+        } else {
+          throw error;
+        }
+      });
+
+      if (!dontSetToService) {
+        this.dataList = dataListExists;
+      }
+
+      return dataListExists;
+    } catch (error) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings('getAll', error),
+
+        errorCode: 'NTS-DS0-GA0',
+      });
+    }
+  }
+
+  /**
+   * @description
+   * returns data from database by id
+   * also if dontSetToService is false or not setted, 
+   * the data will be saved to the service, even if its not found
+   * 
+   * @remarks 
+   * If you need to get-save a data, if possible, 
+   * use db-service update instead.
+   * 
+   * @param {string} id
+   * (using id from service.data, if not provided)
+   * @param dontSetToService
+   * 
+   * @return {T} data: T
+   */
+  async getDataById(id?: string, dontSetToService?: boolean): Promise<T> {
+    try {
+      if (!id && !this.data._id) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'getDataById', 
+            new Error(
+              `getDataById failed, ID is missing! ` +
+              `(maybe you wanted to use getDataByDependencyId() instead...) ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+          
+          errorCode: 'NTS-DS0-GI1',
+        });
+      }
+
+      const dataExists: T = await this.dataDBService.getDataById(id ?? this.data._id);
+
+      if (!dontSetToService) {
+        this.data = dataExists;
+      }
+
+      return dataExists;
+    } catch (error) {
+      if (error?.errorCode == 'NTS-DS0-GI1') {
+        throw error;
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getDataById', error),
+          errorCode: 'NTS-DS0-GI0',
+        });
+      }
+    }
+  }
+
+  async getDataByIds(ids: string[], dontSetToService?: boolean): Promise<T[]> {
+    try {
+      if (!ids) {
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings(
+            'getDataByIds',
+            new Error(`getDataByIds failed, ids is missing! (${this.dataParams.dataName})`)
+          ),
+
+          errorCode: 'NTS-DS0-GIS1',
+        });
+      }
+
+      if (ids.length === 0) {
+        return [];
+      }
+
+      const datas: T[] = await this.dataDBService.find({ _id: { $in: ids } });
+
+      if (!dontSetToService) {
+        this.dataList = datas;
+      }
+
+      return datas;
+    } catch (error) {
+      throw new DynamoFM_Error({
+        ...this._getDefaultErrorSettings('getDataByIds', error),
+
+        errorCode: 'NTS-DS0-GIS0',
+      });
+    }
+  }
+  
+  /**
+   * returns data from database by dependencyId to the service
+   * (using id from service.data, if not provided)
+   * @param dependencyId 
+   */
+  async getDataByDependencyId(dependencyId?: string, dontSetToService?: boolean): Promise<T> {
+    try {
+      if (!this.depKey) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'getDataByDependencyId',
+            new Error(
+              `getDataByDependencyId failed, dependencyKey is missing from service! ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+          
+          errorCode: 'NTS-DS0-GD1',
+        });
+      }
+
+      if (!dependencyId && !this.data[this.depKey]) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'getDataByDependencyId',
+            new Error(
+              `getDataByDependencyId failed, ${this.depKey} is missing! ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+          
+          errorCode: 'NTS-DS0-GD2',
+        });
+      }
+
+      const dataExists: T = await this.dataDBService.getDataByDependencyId(
+        dependencyId ?? this.data[this.depKey]
+      ).catch((error): null => {
+        if (error?.errorCode === 'NTS-DBS-GD2') {
+          DynamoFM_Log.warn(
+            `getDataByDependencyId failed; ${this.dataParams.dataName} ` +
+            `(${this.depKey}: ${dependencyId ?? this.data[this.depKey]}) didn't found any.`
+          );
+
+          return null;
+        } else {
+          throw error;
+        }
+      });
+
+      if (!dontSetToService) {
+        this.data = dataExists;
+      }
+
+      return dataExists;
+    } catch (error) {
+      if ([ 'NTS-DS0-GD1', 'NTS-DS0-GD2' ].includes(error?.errorCode)) {
+        throw error;
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getDataByDependencyId', error),
+          
+          errorCode: 'NTS-DS0-GD0',
+        });
+      }
+    }
+  }
+
+  async getDatasByDependencyIds(dependencyIds: string[], dontSetToService?: boolean): Promise<T[]> {
+    try {
+      if (!this.depKey) {
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings(
+            'getDatasByDependencyIds',
+            new Error(
+              `getDatasByDependencyIds failed, dependencyKey is missing from service! ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+
+          errorCode: 'NTS-DS0-GDS1',
+        });
+      }
+
+      if (!dependencyIds) {
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings(
+            'getDatasByDependencyIds',
+            new Error(
+              `getDatasByDependencyIds failed, dependencyIds is missing! ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+
+          errorCode: 'NTS-DS0-GDS2',
+        });
+      }
+
+      if (dependencyIds.length === 0) {
+        return [];
+      }
+
+      const datas: T[] = await this.dataDBService.getDatasByDependencyIds(dependencyIds);
+
+      if (!dontSetToService) {
+        this.dataList = datas;
+      }
+
+      return datas;
+    } catch (error) {
+      if ([ 'NTS-DS0-GDS1', 'NTS-DS0-GDS2' ].includes(error?.errorCode)) {
+        throw error;
+      } else {
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings('getDatasByDependencyIds', error),
+
+          errorCode: 'NTS-DS0-GDS0',
+        });
+      }
+    }
+  }      
+  
+  /**
+   * returns dataList from database by dependencyId to the service
+   * @param dependencyId 
+   */
+  async getDataListByDependencyId(dependencyId?: string, dontSetToService?: boolean): Promise<T[]> {
+    try {
+      if (!this.depKey) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'getDataListByDependencyId',
+            new Error(
+              `getDataListByDependencyId failed, dependencyKey is missing from service! ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+          
+          errorCode: 'NTS-DS0-GLD1',
+        });
+      }
+
+      if (!dependencyId && !this.data[this.depKey]) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'getDataListByDependencyId',
+            new Error(
+              `getDataListByDependencyId failed, ${this.depKey} is missing! ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+          
+          errorCode: 'NTS-DS0-GLD2',
+        });
+      }
+
+      const dataListExists: T[] = await this.dataDBService.getDataListByDependencyId(
+        dependencyId ?? this.data[this.depKey]
+      ).catch((error): T[] => {
+        if (error?.errorCode === 'NTS-DBS-GLD2') {
+          DynamoFM_Log.warn(
+            `getDataListByDependencyId ${this.dataParams.dataName} ` +
+            `(${this.depKey}: ${dependencyId ?? this.data[this.depKey]}) didn't found any.`
+          );
+
+          return [];
+        } else {
+          throw error;
+        }
+      });
+
+      if (!dontSetToService) {
+        this.dataList = dataListExists;
+      }
+
+      return dataListExists;
+    } catch (error) {
+      if ([ 'NTS-DS0-GLD1', 'NTS-DS0-GLD2' ].includes(error?.errorCode)) {
+        throw error;
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getDataListByDependencyId', error),
+          
+          errorCode: 'NTS-DS0-GLD0',
+          
+        });
+      }
+    }
+  }
+
+  /**
+   * 
+   * // 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(filterBy: DynamoNTS_DBFilter<T>, dontSetToService?: boolean): Promise<T> {
+    try {
+      const dataExists: T = await this.dataDBService.findOne(filterBy).catch((error): null => {
+        if (error?.errorCode === 'NTS-DBS-FO1') {
+          DynamoFM_Log.warn(`findData ${this.dataParams.dataName} didn't found any.`);
+
+          return null;
+        } else {
+          throw error;
+        }
+      });
+
+      if (!dontSetToService) {
+        this.data = dataExists;
+      }
+
+      return dataExists;
+    } catch (error) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings('findData', error),
+        
+        errorCode: 'NTS-DS0-FD0',
+      });
+    }
+  }
+
+  /**
+   * 
+   * // 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(filterBy: DynamoNTS_DBFilter<T>, dontSetToService?: boolean): Promise<T[]> {
+    try {
+      const dataListExists: T[] = await this.dataDBService.find(filterBy).catch((error): T[] => {
+        if (error?.errorCode === 'NTS-DBS-F1') {
+          DynamoFM_Log.warn(`findDatas ${this.dataParams.dataName} didn't found any.`);
+
+          return [];
+        } else {
+          throw error;
+        }
+      });
+
+      if (!dontSetToService) {
+        this.dataList = dataListExists;
+      }
+
+      return dataListExists;
+    } catch (error) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings('findDatas', error),
+        
+        errorCode: 'NTS-DS0-FDS0',
+      });
+    }
+  }
+
+  /**
+   * 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: { filterBy?: DynamoNTS_DBFilter<T>, update: DynamoNTS_DBUpdate<T> }
+  ): Promise<void> {
+    try {
+      if (set.filterBy) {
+        await this.dataDBService.updateOne(set.filterBy, set.update, this.issuer);
+
+      } else if (this.data._id) {
+        await this.dataDBService.updateOne(
+          { _id: this.data._id } as DynamoNTS_DBFilter<T>, 
+          set.update, 
+          this.issuer
+        );
+
+      } else if (this.depKey && this.data[this.depKey]) {
+        await this.dataDBService.updateOne(
+          { [this.depKey]: this.data[this.depKey] } as DynamoNTS_DBFilter<T>, 
+          set.update, 
+          this.issuer
+        );
+
+      } else {
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings(
+            'updateData',
+            new Error(
+              `no usable parameter provided for updateData; no updateBy, no id, no dependencyId ` +
+              `(${this.dataParams.dataName})`
+            )
+          ),
+          
+          errorCode: 'NTS-DS0-UD1',
+        });
+      }
+    } catch (error) {
+      
+      if (error?.errorCode == 'NTS-DS0-UD1') {
+        throw error;
+
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('updateData', error),
+          
+          errorCode: 'NTS-DS0-UD0',
+        });
+      }
+    }
+  }
+
+  /**
+   * 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 
+   * (when you simultaneously trying to change the same data's 
+   * different values from different flows)
+   */
+  async saveData(): Promise<T> {
+    try {
+      if (!this.data) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'saveData', 
+            new Error(`no data to save! (${this.dataParams.dataName})`)
+          ),
+          
+          errorCode: 'NTS-DS0-SD4',
+        });
+      }
+
+      await this.validateForSave();
+
+      if (!this.data._id && (!this.depKey || !this.data[this.depKey])) {
+        // if ID of dependencyID is not present, data not exists, create new data
+        this.data = await this.dataDBService.createData(this.data, this.issuer);
+
+        return this.data;
+      }
+
+      let dataExists: T;
+
+      // check if data already exists with the specific ID
+      if (this.data._id) {
+        dataExists = await this.getDataById(null, true);
+
+        if (dataExists) {
+          // if data exists do modify
+          this.data = await this.dataDBService.modifyData(this.data, this.issuer);
+
+          return this.data;
+
+        } else {
+          throw new DynamoFM_Error({ 
+            ...this._getDefaultErrorSettings(
+              'saveData',
+              new Error(
+                `saveData was unsuccessful: provided ID not exists ` +
+                `(id: ${this.data._id}, ${this.dataParams.dataName})`
+              )
+            ),
+
+            errorCode: 'NTS-DS0-SD1',
+          });
+        }
+      }
+
+      if (this.depKey) {
+        if (!this.data[this.depKey]) {
+          throw new DynamoFM_Error({ 
+            ...this._getDefaultErrorSettings(
+              'saveData',
+              new Error(
+                `saveData was unsuccessful: dependency data id missing from data ` +
+                `(key: ${this.depKey}, ${this.dataParams.dataName})`
+              )
+            ),
+            
+            errorCode: 'NTS-DS0-SD2',
+          });
+        }
+
+        if (this.depKeyIsUnique) {
+          dataExists = await this.getDataByDependencyId(null, true);
+
+          if (dataExists) {
+            // if data exists do modify
+            this.data = await this.dataDBService.modifyData(this.data, this.issuer);
+
+            return this.data;
+
+          } else if (this.depKeyIsRequired) {
+            // if data not exists check that dependency already exists for this
+            const dependencyExists = await this.getDependencyDataDBService()
+              .getDataById(this.data[this.depKey])
+              .catch();
+
+            if (!dependencyExists) {
+              throw new DynamoFM_Error({ 
+                ...this._getDefaultErrorSettings(
+                  'saveData',
+                  new Error(
+                    `saveData was unsuccessful: dependency data not exists ` +
+                    `(key: ${this.depKey}, id: ${this.data[this.depKey]}, ` +
+                    `${this.dataParams.dataName})`
+                  )
+                ),
+                
+                errorCode: 'NTS-DS0-SD3',
+              });
+            }
+          }
+        }
+      }
+
+      // if data not exists create new data
+      this.data = await this.dataDBService.createData(this.data, this.issuer);
+
+      return this.data;
+
+    } catch (error) {
+      if ([ 'NTS-DS0-SD1', 'NTS-DS0-SD2' ].includes(error?.errorCode)) {
+        throw error;
+
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('saveData', error),
+          
+          errorCode: 'NTS-DS0-SD0',
+        });
+      }
+    }
+  }
+
+  /**
+   * permanently deletes data from database by data._id
+   */
+  async deleteData(): Promise<void> {
+    try {
+      if (!this.data._id) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'deleteData',
+            new Error(`deleteData failed, ID is missing! (${this.dataParams.dataName})`)
+          ),
+          
+          errorCode: 'NTS-DS0-DD1',
+        });
+      }
+          
+      await this.dataDBService.deleteDataById(this.data._id);
+    } catch (error) {
+      if (error?.errorCode == 'NTS-DS0-DD1') {
+        throw error;
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('deleteData', error),
+          
+          errorCode: 'NTS-DS0-DD0',
+        });
+      }
+    }
+  }
+
+  /**
+   * validation of data, for modify and create, by the ModelParams
+   */
+  async validateForSave(): Promise<void> {
+    try {
+      for (let i = 0; i < this.dataParams.properties.length; i++) {
+        // basic required validations
+        if (
+          (this.dataParams.properties[i].required && 
+            (this.data[this.dataParams.properties[i].key] === null || 
+              this.data[this.dataParams.properties[i].key] === undefined
+            )
+          ) ||
+          (this.dataParams.properties[i].index && 
+            (this.data[this.dataParams.properties[i].key] === null || 
+              this.data[this.dataParams.properties[i].key] === undefined
+            )
+          )
+        ) {
+          throw new DynamoFM_Error({ 
+            ...this._getDefaultErrorSettings(
+              'validateForSave',
+              new Error(
+                `validateForSave failed, ${this.dataParams.properties[i].key} is missing! ` +
+                `(${this.dataParams.dataName})`
+              )
+            ),
+
+            status: 422, 
+            errorCode: 'NTS-DS0-VD1',
+            userMessage: this.defaultValidationErrorUserMsg,
+          });
+        }
+
+        // specific Date validation
+        if (this.dataParams.properties[i].type === 'Date' && 
+          !(new Date(this.data[this.dataParams.properties[i].key]) instanceof Date)
+        ) {
+          throw new DynamoFM_Error({
+            ...this._getDefaultErrorSettings(
+              'validateForSave',
+              new Error(
+                `validateForSave failed, ${this.dataParams.properties[i].key} is not a date! ` +
+                `(${this.dataParams.dataName})`
+              )
+            ),
+
+            status: 422, 
+            errorCode: 'NTS-DS0-VD2',
+            userMessage: this.defaultValidationErrorUserMsg,
+          });
+        }
+
+        // call additional validators
+        if (this.dataParams.properties[i].additionalValidators) {
+          for (let j = 0; j < this.dataParams.properties[i].additionalValidators.length; j++) {
+            this.dataParams.properties[i].additionalValidators[j](
+              this.data[this.dataParams.properties[i].key]
+            );
+          }
+        }
+      }
+    } catch (error) {
+      if ([ 'NTS-DS0-VD1', 'NTS-DS0-VD2' ].includes(error?.errorCode)) {
+        throw error;
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('validateForSave', error),
+
+          status: 422, 
+          errorCode: 'NTS-DS0-VD0',
+        });
+      }
+    }
+  }
+
+  /**
+   * setting up dependency dataHook by DynamoBEDataModelParams
+   */
+  private lookForDependencyDataSettings(): void {
+    const dependencyParam: DynamoFM_DataProperty_Params = this.dataParams.properties.find(
+      (modelParams: DynamoFM_DataProperty_Params): boolean => modelParams.isDependencyHook
+    );
+
+    if (dependencyParam) {
+      this.depKey = dependencyParam.key;
+
+      if (dependencyParam.dependencyDataName) {
+        this.depDBServiceKey = dependencyParam.dependencyDataName;
+      }
+
+      if (dependencyParam.unique) {
+        this.depKeyIsUnique = true;
+      }
+
+      if (dependencyParam.required) {
+        this.depKeyIsRequired = true;
+      }
+    }
+  }
+
+  /**
+   * 
+   * @returns 
+   */
+  getDependencyDataDBService(): DynamoNTS_DBService<any> {
+    if (!this.depDBServiceKey) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings(
+          'getDependencyDataDBService',
+          new Error(
+            `getDependencyDataDBService was unsuccessful, service key not setted up! ` +
+            `(${this.dataParams.dataName}))`
+          )
+        ),
+
+        status: 501, 
+        errorCode: 'NTS-DS0-GDDB0',
+      });
+    }
+
+    if (this.depDataDBService) {
+      return this.depDataDBService;
+    } else {
+      this.depDataDBService = DynamoNTS_GlobalService.getDBServiceByKey(this.depDBServiceKey);
+
+      return this.depDataDBService;
+    }
+  }
+  
+  private _getDefaultErrorSettings(
+    fnName: string, 
+    error: DynamoFM_AnyError
+  ): DynamoFM_Error_Settings {
+    return {
+      status: (error as DynamoFM_Error)?.___status ?? 500,
+      message: 
+        (error as Error)?.message ?? 
+        `${fnName} was UNSUCCESFUL (NTS; ${this.dataParams.dataName})`,
+      addECToUserMsg: !(error as DynamoFM_Error)?.__userMessage,
+      userMessage: (error as DynamoFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
+      issuer: this.issuer,
+      issuerService: this.serviceName + ` (${this?.constructor?.name}-DynamoNTS_DataService)`,
+      error: error,
+    };
+  }
+}