@futdevpro/nts-dynamo 1.9.15 → 1.9.16

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

@@ -1,1063 +1,1063 @@
-
-import * as mongoose from 'mongoose';
-import { Schema } from 'mongoose';
-
-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';
-
-/**
- * DB Service for MongoDB
- */
-export class DynamoNTS_DBService<T extends DynamoFM_Metadata> {
-
-  serviceName: string;
-
-  dataModel/* : mongoose.Model<T> */; // = mongoose.model(this.dataParams.dbName, this.getSchema());
-
-  private depDataName: string;
-
-  defaultErrorUserMsg = 
-    `We encountered an unhandled DB Error, ` +
-    `\nplease contact the responsible development team.`;
-
-  /**
-   * @param dataName name the model
-   * @param typeSample sample data for scheme creation (dont include DynamoFM_Metadata!)
-   * @param schemaSettings additional settings for specific parameters as unique, required, minlength or maxlength
-   * schemaSettings also MUST contain specific types that differs from the listed above (Array, Date)
-   */
-  constructor(
-    public dataParams: DynamoFM_DataModel_Params
-  ){
-    try {
-      this.serviceName = this.constructor?.name;
-
-      try {
-        this.dataModel = mongoose.model(this.dataParams.dbName, this.getSchema());
-      } catch (error) {
-        if (mongoose.models[this.dataParams.dbName]) {
-          this.dataModel = mongoose.models[this.dataParams.dbName];
-        } else {
-          throw error;
-        }
-      }
-
-      this.lookForDependencyDataSettings();
-    } catch (error) {
-      throw new DynamoFM_Error({
-        message: 
-          `DynamoNTS_DBService construction failed! ${dataParams.dataName} - ${this.serviceName}`,
-        errorCode: 'NTS-DBS-C00',
-        level: DynamoFM_ErrorLevel.critical,
-        additionalContent: { dataParams: this.dataParams },
-        error,
-      });
-      /* DynamoFM_Log.error(
-        `\nDynamoNTS_DBService ERROR, ` +
-        `The dbService construction failed for ${dataParams.dataName}. ${this.serviceName}` +
-        `\nERROR: `, error,
-        new Error()
-      ); */
-    }
-  }
-
-  /**
-   * save new data
-   * @param data data
-   * @returns data
-   */
-  async createData(data: T, issuer: string): Promise<T> {
-    data.__created = new Date();
-    data.__lastModified = new Date();
-    data.__createdBy = issuer;
-    data.__lastModifiedBy = issuer;
-
-    const dataModel = new this.dataModel(data);
-    let newData: T = await dataModel.save().then((res): T => {
-      if (res) {
-        return res?.toObject() as T;
-        
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'createData', 
-            new Error(
-              `createData failed, save ${this.dataParams.dbName} result not found! (NTS DB)`
-            ),
-            issuer
-          ),
-
-          status: 204, 
-          errorCode: 'NTS-DBS-CD1',
-          additionalContent: { data },
-          issuer,
-        });
-      }
-    }).catch((error): void => {
-      if (error?.flag?.includes('DYNAMO')) {
-        throw error;
-
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('createData', error, issuer),
-
-          status: 422, 
-          errorCode: 'NTS-DBS-CD0',
-          additionalContent: { data, dataModel },
-          message: 
-            `createData failed, Create new ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-          issuer,
-        });
-      }
-    });
-
-    newData = this.stringifyDataId(newData, 'createData');
-
-    return newData;
-  }
-
-  /**
-   * Find data by _id and update
-   * @param data data
-   * @returns data
-   */
-  async modifyData(data: T, issuer: string): Promise<T> {
-    data.__lastModified = new Date();
-    data.__lastModifiedBy = issuer;
-
-    /** 
-     * EZ A SZAR TELJESEN SZAR, nem friss, nem a db-be mentett adatokat ad vissza, 
-     * átír random value-kat össze vissza, WTF 
-     * */
-    /* let newData: T = */ await this.dataModel.findByIdAndUpdate(data._id, data).then((res) => {
-      /* if (res) {
-        //return res?.toObject() as T;
-      } else {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'modifyData', 
-            new Error(`modifyData failed, modify ${this.dataParams.dbName} result not found! (NTS DB)`),
-            issuer,
-          ),
-
-          status: 204, 
-          errorCode: 'NTS-DBS-FU1',
-          additionalContent: { data },
-          issuer,
-        });
-      } */
-    }).catch((error): void => {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings('modifyData', error, issuer),
-
-        errorCode: 'NTS-DBS-FU0',
-        additionalContent: { data },
-        message: `modifyData ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        issuer,
-      });
-    });
-
-    /* newData = this.stringifyDataId(newData, 'modifyData'); */
-
-    return data;
-  }
-
-  /**
-   * returns data by _id, 
-   * @param id id
-   * @returns data
-   */
-  async getDataById(id: string): Promise<T> {
-    if (!id) { 
-      throw new DynamoFM_Error({
-        ...this._getDefaultErrorSettings('getDataById', new Error(`No ID provided! (NTS DB)`)),
-
-        errorCode: 'NTS-DBS-GI1',
-        message: `get ${this.dataParams.dbName} by ID was unsuccessful (NTS DB)`,
-      });
-    }
-
-    let data: T = await this.dataModel
-      .findById(id)
-      .then((res): T => res?.toObject() as T ?? null)
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getDataById', error),
-
-          errorCode: 'NTS-DBS-GI0',
-          additionalContent: { id },
-          message: `get ${this.dataParams.dbName} by ID was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    data = this.stringifyDataId(data, 'getDataById');
-
-    return data;
-  }
-
-  /**
-   * get data by dependency data id, 
-   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GD2)
-   * 
-   * @param dependencyId id
-   * @returns data
-   */
-  async getDataByDependencyId(dependencyId: string): Promise<T> {
-    if (!this.depDataName) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings(
-          'getDataByDependencyId', 
-          new Error(
-            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
-            `(NTS DB)`
-          )
-        ),
-        
-        status: 501, 
-        errorCode: 'NTS-DBS-GD0',
-      });
-    }
-
-    let data: T = await this.dataModel
-      .findOne({ [this.depDataName]: dependencyId })
-      .then((res): T => res?.toObject() as T ?? null)
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getDataByDependencyId', error),
-
-          errorCode: 'NTS-DBS-GD1',
-          additionalContent: { dependencyId },
-          message: 
-            `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    data = this.stringifyDataId(data, 'getDataByDependencyId');
-
-    return data;
-  }
-
-  /**
-   * get data by dependency data id, 
-   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLD2)
-   * 
-   * @param dependencyId id
-   * @returns dataList
-   */
-  async getDataListByDependencyId(dependencyId: string): Promise<T[]> {
-    if (!this.depDataName) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings(
-          'getDataListByDependencyId',
-          new Error(
-            `isDependencyHook not setted up for this dataModel (${this.dataParams.dbName}) ` +
-            `(NTS DB)`
-          )
-        ),
-
-        status: 501, 
-        errorCode: 'NTS-DBS-GLD0',
-        additionalContent: {
-          dataModel: this.dataModel,
-        },
-      });
-    }
-
-    const dataList: T[] = await this.dataModel
-      .find({ [this.depDataName]: dependencyId })
-      .then((res): T[] => res as T[] ?? [])
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getDataListByDependencyId', error),
-          
-          errorCode: 'NTS-DBS-GLD1',
-          additionalContent: { dependencyId },
-          message: 
-            `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    dataList.forEach((data: T): void => {
-      data = this.stringifyDataId(data, 'getDataListByDependencyId');
-    });
-
-    return dataList;
-  }
-
-  async getDatasByDependencyIds(dependencyIds: string[]): Promise<T[]> {
-    if (!this.depDataName) {
-      throw new DynamoFM_Error({
-        ...this._getDefaultErrorSettings(
-          'getDatasByDependencyIds',
-          new Error(
-            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
-            `(NTS DB)`
-          )
-        ),
-
-        status: 501,
-        errorCode: 'NTS-DBS-GLDS0',
-      });
-    }
-
-    const dataList: T[] = await this.dataModel
-      .find({ [this.depDataName]: { $in: dependencyIds }})
-      .then((res): T[] => res as T[] ?? [])
-      .catch((error): void => {
-        throw new DynamoFM_Error({
-          ...this._getDefaultErrorSettings('getDatasByDependencyIds', error),
-
-          errorCode: 'NTS-DBS-GLDS1',
-          additionalContent: { dependencyIds },
-          message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
-        });
-      });
-
-    dataList.forEach((data: T): void => {
-      data = this.stringifyDataId(data, 'getDatasByDependencyIds');
-    });
-
-    return dataList;
-  }
-
-  /**
-   * get multiple data objects by a list of DependencyIDs, 
-   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLDS2)
-   * 
-   * @param ids ids
-   * @returns dataList
-   */
-  async getDataListByDependencyIds(ids: string[]): Promise<T[]> {
-    if (!this.depDataName) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings(
-          'getDataListByDependencyIds',
-          new Error(
-            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
-            `(NTS DB)`
-          )
-        ),
-
-        status: 501, 
-        errorCode: 'NTS-DBS-GLDS0',
-      });
-    }
-
-    const dataList: T[] = await this.dataModel
-      .find({ [this.depDataName]: { $in: ids } })
-      .then((res): T[] => res as T[] ?? [])
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getDataListByDependencyIds', error),
-          
-          errorCode: 'NTS-DBS-GLDS1',
-          additionalContent: { ids },
-          message: 
-            `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    dataList.forEach((data: T): void => {
-      data = this.stringifyDataId(data, 'getDataListByDependencyIds');
-    });
-
-    return dataList;
-  }
-
-  /**
-   * returns all data from database, 
-   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GA1)
-   * 
-   * @returns dataList
-   */
-  async getAll(): Promise<T[]> {
-    const dataList: T[] = await this.dataModel
-      .find({})
-      .then((res): T[] => res as T[] ?? [])
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('getAll', error),
-          
-          errorCode: 'NTS-DBS-GA0',
-          message: `get all ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    dataList.forEach((data: T): void => {
-      data = this.stringifyDataId(data, 'getAll');
-    });
-
-    return dataList as T[];
-  }
-
-  /**
-   * deleted data by id
-   * @param id id
-   */
-  async deleteDataById(id: string): Promise<void> {
-    await this.dataModel
-      .findByIdAndDelete(id)
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('deleteDataById', error),
-          
-          errorCode: 'NTS-DBS-DD0',
-          additionalContent: { id },
-          message: `delete ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-        });
-      });
-  }
-
-  /**
-   * deleted data by id
-   * @param dependencyId id
-   */
-  async deleteDataByDependencyId(dependencyId: string): Promise<void> {
-    if (!this.depDataName) {
-      throw new DynamoFM_Error({ 
-        ...this._getDefaultErrorSettings(
-          'deleteDataByDependencyId',
-          new Error(
-            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
-            `(NTS DB)`
-          )
-        ),
-
-        status: 501, 
-        errorCode: 'NTS-DBS-DDD0',
-      });
-    }
-
-    await this.dataModel
-      .deleteMany({ [this.depDataName]: dependencyId })
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('deleteDataByDependencyId', error),
-
-          errorCode: 'NTS-DBS-DDD1',
-          additionalContent: { dependencyId },
-          message: 
-            `delete ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
-        });
-      });
-  }
-
-  /**
-   * returns search result for searchBy object params
-   * can use lists or xRange values for searchBy obj properties
-   * 
-   * @param filterBy filter
-   * @param narrowByDependencyIds id
-   * @returns dataList
-   */
-  async searchData(
-    filterBy: DynamoNTS_DBFilter<T>, 
-    narrowByDependencyIds?: string[]
-  ): Promise<T[]> {
-    const filter = {};
-
-    if (0 < narrowByDependencyIds.length) {
-      if (!this.depDataName) {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings(
-            'searchData',
-            new Error(
-              `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
-              `(NTS DB)`
-            )
-          ),
-
-          status: 501, 
-          errorCode: 'NTS-DBS-SD0',
-        });
-      }
-      
-      filter[this.depDataName] = { $in: narrowByDependencyIds };      
-    }
-
-    await this.dataParams.properties.forEach((modelParam: DynamoFM_DataProperty_Params): void => {
-      if (
-        (filterBy[modelParam.key] !== null && filterBy[modelParam.key] !== undefined) || 
-        filterBy[modelParam.key + 'Range']
-      ) {
-        if (modelParam.key.includes('Range') || modelParam.type.includes('[]')) {
-          // inverz search filter (for Range and Array functions)
-          if (modelParam.key.includes('Range')) {
-            const searchParamKeyWithoutRange = modelParam.key.split('Range')[0];
-
-            if (
-              filterBy[searchParamKeyWithoutRange] !== null && 
-              filterBy[searchParamKeyWithoutRange] !== undefined
-            ) {
-              filter[modelParam.key] = {
-                from: { $lte: filterBy[searchParamKeyWithoutRange] },
-                to: { $gte: filterBy[searchParamKeyWithoutRange] }
-              };
-            }
-          } else {
-            if (
-              filterBy[modelParam.key] !== null && 
-              filterBy[modelParam.key] !== undefined
-            ) {
-              filter[modelParam.key] = { $in: filterBy[modelParam.key] };
-            }
-          }
-        } else {
-          // basic search filter
-          if (filterBy[modelParam.key + 'Range']) {
-            if (filterBy[modelParam.key + 'Range'].from || filterBy[modelParam.key + 'Range'].to) {
-              filter[modelParam.key] = {};
-
-              if (filterBy[modelParam.key + 'Range'].from) {
-                filter[modelParam.key].$gte = filterBy[modelParam.key + 'Range'].from;
-              }
-
-              if (filterBy[modelParam.key + 'Range'].to) {
-                filter[modelParam.key].$lte = filterBy[modelParam.key + 'Range'].to;
-              }
-            }
-          } else if (filterBy[modelParam.key] !== null && filterBy[modelParam.key] !== undefined) {
-            if (filterBy[modelParam.key].lenght > 0) {
-              filter[modelParam.key] = { $in: filterBy[modelParam.key] };
-            }
-          }
-        }
-      }
-    });
-
-    const dataList: T[] = await this.dataModel
-      .find(filter)
-      .then((res): T[] => res as T[] ?? [])
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('searchData', error),
-          
-          errorCode: 'NTS-DBS-SD1',
-          additionalContent: { filterBy, narrowByDependencyIds },
-          message: `search ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    dataList.forEach((data: T): void => {
-      data = this.stringifyDataId(data, 'searchData');
-    });
-
-    return dataList;
-  }
-
-  // ----------------------------------------------------------------------------------
-  // ----------------------------------------------------------------------------------
-  // ----------------------------------------------------------------------------------
-  // DIRECT Basic MONGOOSE FUNCTIONS (with error handlings)
-
-  /**
-   * Find the data first by any of its parameters, 
-   * !!!: throws error if not found (errorCode on not found: NTS-DBS-FO1)
-   * 
-   * @param filterBy 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 findOne(filterBy: DynamoNTS_DBFilter<T>): Promise<T> {
-    let data: T = await this.dataModel
-      .findOne(filterBy)
-      .then((res): T => res as T ?? null)
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('findOne', error),
-
-          errorCode: 'NTS-DBS-FO0',
-          additionalContent: { filterBy },
-          message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-        });
-      });
-
-    data = this.stringifyDataId(data, 'findOne');
-
-    return data;
-  }
-
-  /**
-   * #MONGOOSE FUNCTION
-   * Find the data first by any of its parameters, 
-   * !!!: throws error if not found (errorCode on not found: NTS-DBS-F1)
-   * 
-   * @param filterBy 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 find(filterBy: DynamoNTS_DBFilter<T>): Promise<T[]> {
-    const dataList: T[] = await this.dataModel
-      .find(filterBy)
-      .then((res): T[] => res as T[] ?? [])
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('find', error),
-          
-          errorCode: 'NTS-DBS-F0',
-          additionalContent: { filterBy },
-          message: `find ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    dataList.forEach((data: T): void => {
-      data = this.stringifyDataId(data, 'find');
-    });
-
-    return dataList as T[];
-  }
-
-  /**
-   * #MONGOOSE FUNCTION
-   * Find the data first by any of its parameters
-   * 
-   * @param filterBy 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 page page
-   * @param pageSize pageSize
-   * @param sort 
-   * @example
-   * // by dateTime (this uses the basic sort function): 
-   * { dateTime: -1 }
-   * //
-   * @returns {T[]} dataList: T[]
-   */
-  async findWithPaging(
-    filterBy: DynamoNTS_DBFilter<T>, 
-    page: number, 
-    pageSize: number, 
-    sort?: any
-  ): Promise<T[]> {
-    const dataList: T[] = await this.dataModel
-      .find(filterBy)
-      .sort(sort)
-      .skip(page * pageSize)
-      .limit(pageSize)
-      .then((res): T => res ?? [])
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('findWithPaging', error),
-          
-          errorCode: 'NTS-DBS-WP0',
-          additionalContent: { filterBy, page, pageSize, sort },
-          message: `findWithPaging ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        });
-      });
-
-    dataList.forEach((data: T): void => {
-      data = this.stringifyDataId(data, 'findWithPaging');
-    });
-
-    return dataList;
-  }
-
-  /**
-   * #MONGOOSE FUNCTION
-   * Find data by _id and update
-   * !!!: throws error if not found (errorCode on not found: )
-   * 
-   * @param id id
-   * @param update update
-   * @returns data
-   */
-  async findByIdAndUpdate(id: string, update: DynamoNTS_DBUpdate<T>, issuer: string): Promise<T> {
-    update.__lastModified = new Date();
-    update.__lastModifiedBy = issuer;
-
-    let newData: T = await this.dataModel
-      .findByIdAndUpdate(id, update)
-      .then((res): T => res?.toObject() as T ?? null)
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('findByIdAndUpdate', error, issuer),
-          
-          errorCode: 'NTS-DBS-FIU0',
-          additionalContent: { id, update },
-          message: `findByIdAndUpdate ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-          issuer,
-        });
-      });
-
-    newData = this.stringifyDataId(newData, 'findByIdAndUpdate');
-
-    return newData;
-  }
-
-  /**
-   * #MONGOOSE FUNCTION
-   * Find the data first by any of its parameters
-   * 
-   * @param filter This uses the basic Mongoose updateOne.
-   * If you can, use unique parameters for find!
-   * @example 
-   * // 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 updateOne(
-    filterBy: DynamoNTS_DBFilter<T>, 
-    update: DynamoNTS_DBUpdate<T>, 
-    issuer: string
-  ): Promise<void> {
-    update.__lastModified = new Date();
-    update.__lastModifiedBy = issuer;
-    
-    await this.dataModel
-      .updateOne(filterBy, update)
-      .catch((error): void => {
-        throw new DynamoFM_Error({
-          ...this._getDefaultErrorSettings('updateOne', error, issuer),
-          
-          errorCode: 'NTS-DBS-UO0',
-          additionalContent: { filterBy, update },
-          message: `updateOne ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-          issuer,
-        });
-      });
-  }
-
-  /**
-   * #MONGOOSE FUNCTION
-   * update one parameter by a specific
-   * 
-   * @param filter This uses the basic Mongoose updateMany.
-   * @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 updateMany(
-    filterBy: DynamoNTS_DBFilter<T>, 
-    update: DynamoNTS_DBUpdate<T>, 
-    issuer: string
-  ): Promise<void> {
-    update.__lastModified = new Date();
-    update.__lastModifiedBy = issuer;
-
-    await this.dataModel
-      .updateMany(filterBy, update)
-      .catch((error): void => {
-        throw new DynamoFM_Error({ 
-          ...this._getDefaultErrorSettings('updateMany', error, issuer),
-          
-          errorCode: 'NTS-DBS-UM0',
-          additionalContent: { filterBy, update },
-          message: `updateMany ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-          issuer,
-        });
-      });
-  }
-
-  // ----------------------------------------------------------------------------------
-  // ----------------------------------------------------------------------------------
-  // ----------------------------------------------------------------------------------
-  // PRIVATE FUNCTIONS
-
-  private stringifyDataId(data: T, fnName: string): T {
-    if (data?._id && (typeof data._id !== 'string' || typeof data._id === 'object')) {
-      data._id = `${data._id}`;
-
-      if (typeof data._id !== 'string' || typeof data._id === 'object') {
-        data = JSON.parse(JSON.stringify(data));
-
-        if (typeof data._id !== 'string' || typeof data._id === 'object') {
-          DynamoFM_Log.error(
-            `data._id stringifying failed! Please notfiy the DynamoNTS developers! ` +
-            `(${fnName})`, 
-            new Error()
-          );
-        }
-      }  
-    }
-
-    return data;    
-  }
-
-  private _getDefaultErrorSettings(
-    fnName: string, 
-    error: DynamoFM_AnyError, 
-    issuer?: string
-  ): DynamoFM_Error_Settings {
-    return {
-      status: (error as DynamoFM_Error)?.___status ?? 500,
-      message: (error as Error)?.message ?? `${fnName} was UNSUCCESFUL (NTS-DB)`,
-      addECToUserMsg: !(error as DynamoFM_Error)?.__userMessage,
-      userMessage: (error as DynamoFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
-      issuer: issuer,
-      issuerService: this.serviceName,
-      error: error,
-    };
-  }
-
-  // ----------------------------------------------------------------------------------
-  // PRIVATE BUILD FUNCTIONS
-
-  /**
-   * builds and returns mongoose schema
-   * @returns schema
-   */
-  private getSchema(): mongoose.Schema {
-    let schema: any = this.buildMongooseSchemaByModelParams();
-
-    schema = this.addDynamoFM_MetadataToSchema(schema);
-
-    // tslint:disable-next-line: no-string-literal
-    if (schema['_id']) {
-      // tslint:disable-next-line: no-string-literal
-      delete schema['_id'];
-    }
-
-    return new Schema(schema);
-  }
-
-  /**
-   * builds mongoose schema building settings object by dynamoDataModelParamsList
-   * @param params DynamoBEDataPropertyParams
-   * @returns mongoose schema object
-   */
-  private buildMongooseSchemaByModelParams(params?: DynamoFM_DataProperty_Params[]): any {
-    const schemaSettingsObj = {};
-
-    if (!params) {
-      params = this.dataParams.properties;
-    }
-
-    params.forEach((property: DynamoFM_DataProperty_Params): void => {
-      const beType = this.getBEType(property.type);
-
-      if (
-        beType !== Object || 
-        !property?.subObjectParams || 
-        property?.subObjectParams?.length == 0
-      ) {
-        schemaSettingsObj[property.key] = {
-          type: beType,
-        };
-
-        if (property.index) {
-          schemaSettingsObj[property.key].index = true;
-        }
-
-        if (property.unique) {
-          schemaSettingsObj[property.key].unique = true;
-        }
-
-        if (property.required) {
-          schemaSettingsObj[property.key].required = true;
-        }
-
-        if (property.minlength) {
-          schemaSettingsObj[property.key].minlength = property.minlength;
-        }
-
-        if (property.maxlength) {
-          schemaSettingsObj[property.key].maxlength = property.maxlength;
-        }
-      } else {
-        schemaSettingsObj[property.key] = this.buildMongooseSchemaByModelParams(
-          property.subObjectParams
-        );
-      }
-    });
-
-    return schemaSettingsObj;
-  }
-
-  private getBEType(
-    type: string
-  ): String | Number | Boolean | Object | Function | Array<any> | Date {
-    switch (type.toLocaleLowerCase()) {
-
-      case 'string':
-        return String;
-        
-      case 'number':
-        return Number;
-
-      case 'boolean':
-        return Boolean;
-
-      case 'date':
-        return Date;
-
-      case 'object':
-        return Object;
-        
-      default:
-        if (type.includes('[]') || type.includes('array')) {
-          return Array;
-        } else if (type.includes('=>') || type.includes('function')) {
-          return Function;
-        } else {
-          return Object;
-        }
-    }
-  }
-
-  /**
-   * adds dynamo metadata settings to any mongoose schema building settings object
-   * @param schema schema to update
-   * @returns updated schema
-   */
-  private addDynamoFM_MetadataToSchema(schema: any): any {
-    schema.__created = { type: Date };
-    schema.__createdBy = { type: String };
-    schema.__lastModified = { type: Date };
-    schema.__lastModifiedBy = { type: String };
-    
-    return schema;
-  }
-
-  /**
-   * sets depDataKey
-   */
-  private lookForDependencyDataSettings(): void {
-    const dependencyParam: DynamoFM_DataProperty_Params = this.dataParams.properties.find(
-      (modelParams: DynamoFM_DataProperty_Params): boolean => modelParams.isDependencyHook
-    );
-    
-    if (dependencyParam) {
-      this.depDataName = dependencyParam.key;
-    }
-  }
-}
+
+import * as mongoose from 'mongoose';
+import { Schema } from 'mongoose';
+
+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';
+
+/**
+ * DB Service for MongoDB
+ */
+export class DynamoNTS_DBService<T extends DynamoFM_Metadata> {
+
+  serviceName: string;
+
+  dataModel/* : mongoose.Model<T> */; // = mongoose.model(this.dataParams.dbName, this.getSchema());
+
+  private depDataName: string;
+
+  defaultErrorUserMsg = 
+    `We encountered an unhandled DB Error, ` +
+    `\nplease contact the responsible development team.`;
+
+  /**
+   * @param dataName name the model
+   * @param typeSample sample data for scheme creation (dont include DynamoFM_Metadata!)
+   * @param schemaSettings additional settings for specific parameters as unique, required, minlength or maxlength
+   * schemaSettings also MUST contain specific types that differs from the listed above (Array, Date)
+   */
+  constructor(
+    public dataParams: DynamoFM_DataModel_Params
+  ){
+    try {
+      this.serviceName = this.constructor?.name;
+
+      try {
+        this.dataModel = mongoose.model(this.dataParams.dbName, this.getSchema());
+      } catch (error) {
+        if (mongoose.models[this.dataParams.dbName]) {
+          this.dataModel = mongoose.models[this.dataParams.dbName];
+        } else {
+          throw error;
+        }
+      }
+
+      this.lookForDependencyDataSettings();
+    } catch (error) {
+      throw new DynamoFM_Error({
+        message: 
+          `DynamoNTS_DBService construction failed! ${dataParams.dataName} - ${this.serviceName}`,
+        errorCode: 'NTS-DBS-C00',
+        level: DynamoFM_ErrorLevel.critical,
+        additionalContent: { dataParams: this.dataParams },
+        error,
+      });
+      /* DynamoFM_Log.error(
+        `\nDynamoNTS_DBService ERROR, ` +
+        `The dbService construction failed for ${dataParams.dataName}. ${this.serviceName}` +
+        `\nERROR: `, error,
+        new Error()
+      ); */
+    }
+  }
+
+  /**
+   * save new data
+   * @param data data
+   * @returns data
+   */
+  async createData(data: T, issuer: string): Promise<T> {
+    data.__created = new Date();
+    data.__lastModified = new Date();
+    data.__createdBy = issuer;
+    data.__lastModifiedBy = issuer;
+
+    const dataModel = new this.dataModel(data);
+    let newData: T = await dataModel.save().then((res): T => {
+      if (res) {
+        return res?.toObject() as T;
+        
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'createData', 
+            new Error(
+              `createData failed, save ${this.dataParams.dbName} result not found! (NTS DB)`
+            ),
+            issuer
+          ),
+
+          status: 204, 
+          errorCode: 'NTS-DBS-CD1',
+          additionalContent: { data },
+          issuer,
+        });
+      }
+    }).catch((error): void => {
+      if (error?.flag?.includes('DYNAMO')) {
+        throw error;
+
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('createData', error, issuer),
+
+          status: 422, 
+          errorCode: 'NTS-DBS-CD0',
+          additionalContent: { data, dataModel },
+          message: 
+            `createData failed, Create new ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          issuer,
+        });
+      }
+    });
+
+    newData = this.stringifyDataId(newData, 'createData');
+
+    return newData;
+  }
+
+  /**
+   * Find data by _id and update
+   * @param data data
+   * @returns data
+   */
+  async modifyData(data: T, issuer: string): Promise<T> {
+    data.__lastModified = new Date();
+    data.__lastModifiedBy = issuer;
+
+    /** 
+     * EZ A SZAR TELJESEN SZAR, nem friss, nem a db-be mentett adatokat ad vissza, 
+     * átír random value-kat össze vissza, WTF 
+     * */
+    /* let newData: T = */ await this.dataModel.findByIdAndUpdate(data._id, data).then((res) => {
+      /* if (res) {
+        //return res?.toObject() as T;
+      } else {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'modifyData', 
+            new Error(`modifyData failed, modify ${this.dataParams.dbName} result not found! (NTS DB)`),
+            issuer,
+          ),
+
+          status: 204, 
+          errorCode: 'NTS-DBS-FU1',
+          additionalContent: { data },
+          issuer,
+        });
+      } */
+    }).catch((error): void => {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings('modifyData', error, issuer),
+
+        errorCode: 'NTS-DBS-FU0',
+        additionalContent: { data },
+        message: `modifyData ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        issuer,
+      });
+    });
+
+    /* newData = this.stringifyDataId(newData, 'modifyData'); */
+
+    return data;
+  }
+
+  /**
+   * returns data by _id, 
+   * @param id id
+   * @returns data
+   */
+  async getDataById(id: string): Promise<T> {
+    if (!id) { 
+      throw new DynamoFM_Error({
+        ...this._getDefaultErrorSettings('getDataById', new Error(`No ID provided! (NTS DB)`)),
+
+        errorCode: 'NTS-DBS-GI1',
+        message: `get ${this.dataParams.dbName} by ID was unsuccessful (NTS DB)`,
+      });
+    }
+
+    let data: T = await this.dataModel
+      .findById(id)
+      .then((res): T => res?.toObject() as T ?? null)
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getDataById', error),
+
+          errorCode: 'NTS-DBS-GI0',
+          additionalContent: { id },
+          message: `get ${this.dataParams.dbName} by ID was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    data = this.stringifyDataId(data, 'getDataById');
+
+    return data;
+  }
+
+  /**
+   * get data by dependency data id, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GD2)
+   * 
+   * @param dependencyId id
+   * @returns data
+   */
+  async getDataByDependencyId(dependencyId: string): Promise<T> {
+    if (!this.depDataName) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings(
+          'getDataByDependencyId', 
+          new Error(
+            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+            `(NTS DB)`
+          )
+        ),
+        
+        status: 501, 
+        errorCode: 'NTS-DBS-GD0',
+      });
+    }
+
+    let data: T = await this.dataModel
+      .findOne({ [this.depDataName]: dependencyId })
+      .then((res): T => res?.toObject() as T ?? null)
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getDataByDependencyId', error),
+
+          errorCode: 'NTS-DBS-GD1',
+          additionalContent: { dependencyId },
+          message: 
+            `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    data = this.stringifyDataId(data, 'getDataByDependencyId');
+
+    return data;
+  }
+
+  /**
+   * get data by dependency data id, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLD2)
+   * 
+   * @param dependencyId id
+   * @returns dataList
+   */
+  async getDataListByDependencyId(dependencyId: string): Promise<T[]> {
+    if (!this.depDataName) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings(
+          'getDataListByDependencyId',
+          new Error(
+            `isDependencyHook not setted up for this dataModel (${this.dataParams.dbName}) ` +
+            `(NTS DB)`
+          )
+        ),
+
+        status: 501, 
+        errorCode: 'NTS-DBS-GLD0',
+        additionalContent: {
+          dataModel: this.dataModel,
+        },
+      });
+    }
+
+    const dataList: T[] = await this.dataModel
+      .find({ [this.depDataName]: dependencyId })
+      .then((res): T[] => res as T[] ?? [])
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getDataListByDependencyId', error),
+          
+          errorCode: 'NTS-DBS-GLD1',
+          additionalContent: { dependencyId },
+          message: 
+            `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    dataList.forEach((data: T): void => {
+      data = this.stringifyDataId(data, 'getDataListByDependencyId');
+    });
+
+    return dataList;
+  }
+
+  async getDatasByDependencyIds(dependencyIds: string[]): Promise<T[]> {
+    if (!this.depDataName) {
+      throw new DynamoFM_Error({
+        ...this._getDefaultErrorSettings(
+          'getDatasByDependencyIds',
+          new Error(
+            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+            `(NTS DB)`
+          )
+        ),
+
+        status: 501,
+        errorCode: 'NTS-DBS-GLDS0',
+      });
+    }
+
+    const dataList: T[] = await this.dataModel
+      .find({ [this.depDataName]: { $in: dependencyIds }})
+      .then((res): T[] => res as T[] ?? [])
+      .catch((error): void => {
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings('getDatasByDependencyIds', error),
+
+          errorCode: 'NTS-DBS-GLDS1',
+          additionalContent: { dependencyIds },
+          message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
+        });
+      });
+
+    dataList.forEach((data: T): void => {
+      data = this.stringifyDataId(data, 'getDatasByDependencyIds');
+    });
+
+    return dataList;
+  }
+
+  /**
+   * get multiple data objects by a list of DependencyIDs, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLDS2)
+   * 
+   * @param ids ids
+   * @returns dataList
+   */
+  async getDataListByDependencyIds(ids: string[]): Promise<T[]> {
+    if (!this.depDataName) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings(
+          'getDataListByDependencyIds',
+          new Error(
+            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+            `(NTS DB)`
+          )
+        ),
+
+        status: 501, 
+        errorCode: 'NTS-DBS-GLDS0',
+      });
+    }
+
+    const dataList: T[] = await this.dataModel
+      .find({ [this.depDataName]: { $in: ids } })
+      .then((res): T[] => res as T[] ?? [])
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getDataListByDependencyIds', error),
+          
+          errorCode: 'NTS-DBS-GLDS1',
+          additionalContent: { ids },
+          message: 
+            `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    dataList.forEach((data: T): void => {
+      data = this.stringifyDataId(data, 'getDataListByDependencyIds');
+    });
+
+    return dataList;
+  }
+
+  /**
+   * returns all data from database, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-GA1)
+   * 
+   * @returns dataList
+   */
+  async getAll(): Promise<T[]> {
+    const dataList: T[] = await this.dataModel
+      .find({})
+      .then((res): T[] => res as T[] ?? [])
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('getAll', error),
+          
+          errorCode: 'NTS-DBS-GA0',
+          message: `get all ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    dataList.forEach((data: T): void => {
+      data = this.stringifyDataId(data, 'getAll');
+    });
+
+    return dataList as T[];
+  }
+
+  /**
+   * deleted data by id
+   * @param id id
+   */
+  async deleteDataById(id: string): Promise<void> {
+    await this.dataModel
+      .findByIdAndDelete(id)
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('deleteDataById', error),
+          
+          errorCode: 'NTS-DBS-DD0',
+          additionalContent: { id },
+          message: `delete ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
+        });
+      });
+  }
+
+  /**
+   * deleted data by id
+   * @param dependencyId id
+   */
+  async deleteDataByDependencyId(dependencyId: string): Promise<void> {
+    if (!this.depDataName) {
+      throw new DynamoFM_Error({ 
+        ...this._getDefaultErrorSettings(
+          'deleteDataByDependencyId',
+          new Error(
+            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+            `(NTS DB)`
+          )
+        ),
+
+        status: 501, 
+        errorCode: 'NTS-DBS-DDD0',
+      });
+    }
+
+    await this.dataModel
+      .deleteMany({ [this.depDataName]: dependencyId })
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('deleteDataByDependencyId', error),
+
+          errorCode: 'NTS-DBS-DDD1',
+          additionalContent: { dependencyId },
+          message: 
+            `delete ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`, 
+        });
+      });
+  }
+
+  /**
+   * returns search result for searchBy object params
+   * can use lists or xRange values for searchBy obj properties
+   * 
+   * @param filterBy filter
+   * @param narrowByDependencyIds id
+   * @returns dataList
+   */
+  async searchData(
+    filterBy: DynamoNTS_DBFilter<T>, 
+    narrowByDependencyIds?: string[]
+  ): Promise<T[]> {
+    const filter = {};
+
+    if (0 < narrowByDependencyIds.length) {
+      if (!this.depDataName) {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings(
+            'searchData',
+            new Error(
+              `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+              `(NTS DB)`
+            )
+          ),
+
+          status: 501, 
+          errorCode: 'NTS-DBS-SD0',
+        });
+      }
+      
+      filter[this.depDataName] = { $in: narrowByDependencyIds };      
+    }
+
+    await this.dataParams.properties.forEach((modelParam: DynamoFM_DataProperty_Params): void => {
+      if (
+        (filterBy[modelParam.key] !== null && filterBy[modelParam.key] !== undefined) || 
+        filterBy[modelParam.key + 'Range']
+      ) {
+        if (modelParam.key.includes('Range') || modelParam.type.includes('[]')) {
+          // inverz search filter (for Range and Array functions)
+          if (modelParam.key.includes('Range')) {
+            const searchParamKeyWithoutRange = modelParam.key.split('Range')[0];
+
+            if (
+              filterBy[searchParamKeyWithoutRange] !== null && 
+              filterBy[searchParamKeyWithoutRange] !== undefined
+            ) {
+              filter[modelParam.key] = {
+                from: { $lte: filterBy[searchParamKeyWithoutRange] },
+                to: { $gte: filterBy[searchParamKeyWithoutRange] }
+              };
+            }
+          } else {
+            if (
+              filterBy[modelParam.key] !== null && 
+              filterBy[modelParam.key] !== undefined
+            ) {
+              filter[modelParam.key] = { $in: filterBy[modelParam.key] };
+            }
+          }
+        } else {
+          // basic search filter
+          if (filterBy[modelParam.key + 'Range']) {
+            if (filterBy[modelParam.key + 'Range'].from || filterBy[modelParam.key + 'Range'].to) {
+              filter[modelParam.key] = {};
+
+              if (filterBy[modelParam.key + 'Range'].from) {
+                filter[modelParam.key].$gte = filterBy[modelParam.key + 'Range'].from;
+              }
+
+              if (filterBy[modelParam.key + 'Range'].to) {
+                filter[modelParam.key].$lte = filterBy[modelParam.key + 'Range'].to;
+              }
+            }
+          } else if (filterBy[modelParam.key] !== null && filterBy[modelParam.key] !== undefined) {
+            if (filterBy[modelParam.key].lenght > 0) {
+              filter[modelParam.key] = { $in: filterBy[modelParam.key] };
+            }
+          }
+        }
+      }
+    });
+
+    const dataList: T[] = await this.dataModel
+      .find(filter)
+      .then((res): T[] => res as T[] ?? [])
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('searchData', error),
+          
+          errorCode: 'NTS-DBS-SD1',
+          additionalContent: { filterBy, narrowByDependencyIds },
+          message: `search ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    dataList.forEach((data: T): void => {
+      data = this.stringifyDataId(data, 'searchData');
+    });
+
+    return dataList;
+  }
+
+  // ----------------------------------------------------------------------------------
+  // ----------------------------------------------------------------------------------
+  // ----------------------------------------------------------------------------------
+  // DIRECT Basic MONGOOSE FUNCTIONS (with error handlings)
+
+  /**
+   * Find the data first by any of its parameters, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-FO1)
+   * 
+   * @param filterBy 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 findOne(filterBy: DynamoNTS_DBFilter<T>): Promise<T> {
+    let data: T = await this.dataModel
+      .findOne(filterBy)
+      .then((res): T => res as T ?? null)
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('findOne', error),
+
+          errorCode: 'NTS-DBS-FO0',
+          additionalContent: { filterBy },
+          message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
+        });
+      });
+
+    data = this.stringifyDataId(data, 'findOne');
+
+    return data;
+  }
+
+  /**
+   * #MONGOOSE FUNCTION
+   * Find the data first by any of its parameters, 
+   * !!!: throws error if not found (errorCode on not found: NTS-DBS-F1)
+   * 
+   * @param filterBy 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 find(filterBy: DynamoNTS_DBFilter<T>): Promise<T[]> {
+    const dataList: T[] = await this.dataModel
+      .find(filterBy)
+      .then((res): T[] => res as T[] ?? [])
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('find', error),
+          
+          errorCode: 'NTS-DBS-F0',
+          additionalContent: { filterBy },
+          message: `find ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    dataList.forEach((data: T): void => {
+      data = this.stringifyDataId(data, 'find');
+    });
+
+    return dataList as T[];
+  }
+
+  /**
+   * #MONGOOSE FUNCTION
+   * Find the data first by any of its parameters
+   * 
+   * @param filterBy 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 page page
+   * @param pageSize pageSize
+   * @param sort 
+   * @example
+   * // by dateTime (this uses the basic sort function): 
+   * { dateTime: -1 }
+   * //
+   * @returns {T[]} dataList: T[]
+   */
+  async findWithPaging(
+    filterBy: DynamoNTS_DBFilter<T>, 
+    page: number, 
+    pageSize: number, 
+    sort?: any
+  ): Promise<T[]> {
+    const dataList: T[] = await this.dataModel
+      .find(filterBy)
+      .sort(sort)
+      .skip(page * pageSize)
+      .limit(pageSize)
+      .then((res): T => res ?? [])
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('findWithPaging', error),
+          
+          errorCode: 'NTS-DBS-WP0',
+          additionalContent: { filterBy, page, pageSize, sort },
+          message: `findWithPaging ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        });
+      });
+
+    dataList.forEach((data: T): void => {
+      data = this.stringifyDataId(data, 'findWithPaging');
+    });
+
+    return dataList;
+  }
+
+  /**
+   * #MONGOOSE FUNCTION
+   * Find data by _id and update
+   * !!!: throws error if not found (errorCode on not found: )
+   * 
+   * @param id id
+   * @param update update
+   * @returns data
+   */
+  async findByIdAndUpdate(id: string, update: DynamoNTS_DBUpdate<T>, issuer: string): Promise<T> {
+    update.__lastModified = new Date();
+    update.__lastModifiedBy = issuer;
+
+    let newData: T = await this.dataModel
+      .findByIdAndUpdate(id, update)
+      .then((res): T => res?.toObject() as T ?? null)
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('findByIdAndUpdate', error, issuer),
+          
+          errorCode: 'NTS-DBS-FIU0',
+          additionalContent: { id, update },
+          message: `findByIdAndUpdate ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          issuer,
+        });
+      });
+
+    newData = this.stringifyDataId(newData, 'findByIdAndUpdate');
+
+    return newData;
+  }
+
+  /**
+   * #MONGOOSE FUNCTION
+   * Find the data first by any of its parameters
+   * 
+   * @param filter This uses the basic Mongoose updateOne.
+   * If you can, use unique parameters for find!
+   * @example 
+   * // 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 updateOne(
+    filterBy: DynamoNTS_DBFilter<T>, 
+    update: DynamoNTS_DBUpdate<T>, 
+    issuer: string
+  ): Promise<void> {
+    update.__lastModified = new Date();
+    update.__lastModifiedBy = issuer;
+    
+    await this.dataModel
+      .updateOne(filterBy, update)
+      .catch((error): void => {
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings('updateOne', error, issuer),
+          
+          errorCode: 'NTS-DBS-UO0',
+          additionalContent: { filterBy, update },
+          message: `updateOne ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          issuer,
+        });
+      });
+  }
+
+  /**
+   * #MONGOOSE FUNCTION
+   * update one parameter by a specific
+   * 
+   * @param filter This uses the basic Mongoose updateMany.
+   * @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 updateMany(
+    filterBy: DynamoNTS_DBFilter<T>, 
+    update: DynamoNTS_DBUpdate<T>, 
+    issuer: string
+  ): Promise<void> {
+    update.__lastModified = new Date();
+    update.__lastModifiedBy = issuer;
+
+    await this.dataModel
+      .updateMany(filterBy, update)
+      .catch((error): void => {
+        throw new DynamoFM_Error({ 
+          ...this._getDefaultErrorSettings('updateMany', error, issuer),
+          
+          errorCode: 'NTS-DBS-UM0',
+          additionalContent: { filterBy, update },
+          message: `updateMany ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          issuer,
+        });
+      });
+  }
+
+  // ----------------------------------------------------------------------------------
+  // ----------------------------------------------------------------------------------
+  // ----------------------------------------------------------------------------------
+  // PRIVATE FUNCTIONS
+
+  private stringifyDataId(data: T, fnName: string): T {
+    if (data?._id && (typeof data._id !== 'string' || typeof data._id === 'object')) {
+      data._id = `${data._id}`;
+
+      if (typeof data._id !== 'string' || typeof data._id === 'object') {
+        data = JSON.parse(JSON.stringify(data));
+
+        if (typeof data._id !== 'string' || typeof data._id === 'object') {
+          DynamoFM_Log.error(
+            `data._id stringifying failed! Please notfiy the DynamoNTS developers! ` +
+            `(${fnName})`, 
+            new Error()
+          );
+        }
+      }  
+    }
+
+    return data;    
+  }
+
+  private _getDefaultErrorSettings(
+    fnName: string, 
+    error: DynamoFM_AnyError, 
+    issuer?: string
+  ): DynamoFM_Error_Settings {
+    return {
+      status: (error as DynamoFM_Error)?.___status ?? 500,
+      message: (error as Error)?.message ?? `${fnName} was UNSUCCESFUL (NTS-DB)`,
+      addECToUserMsg: !(error as DynamoFM_Error)?.__userMessage,
+      userMessage: (error as DynamoFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
+      issuer: issuer,
+      issuerService: this.serviceName,
+      error: error,
+    };
+  }
+
+  // ----------------------------------------------------------------------------------
+  // PRIVATE BUILD FUNCTIONS
+
+  /**
+   * builds and returns mongoose schema
+   * @returns schema
+   */
+  private getSchema(): mongoose.Schema {
+    let schema: any = this.buildMongooseSchemaByModelParams();
+
+    schema = this.addDynamoFM_MetadataToSchema(schema);
+
+    // tslint:disable-next-line: no-string-literal
+    if (schema['_id']) {
+      // tslint:disable-next-line: no-string-literal
+      delete schema['_id'];
+    }
+
+    return new Schema(schema);
+  }
+
+  /**
+   * builds mongoose schema building settings object by dynamoDataModelParamsList
+   * @param params DynamoBEDataPropertyParams
+   * @returns mongoose schema object
+   */
+  private buildMongooseSchemaByModelParams(params?: DynamoFM_DataProperty_Params[]): any {
+    const schemaSettingsObj = {};
+
+    if (!params) {
+      params = this.dataParams.properties;
+    }
+
+    params.forEach((property: DynamoFM_DataProperty_Params): void => {
+      const beType = this.getBEType(property.type);
+
+      if (
+        beType !== Object || 
+        !property?.subObjectParams || 
+        property?.subObjectParams?.length == 0
+      ) {
+        schemaSettingsObj[property.key] = {
+          type: beType,
+        };
+
+        if (property.index) {
+          schemaSettingsObj[property.key].index = true;
+        }
+
+        if (property.unique) {
+          schemaSettingsObj[property.key].unique = true;
+        }
+
+        if (property.required) {
+          schemaSettingsObj[property.key].required = true;
+        }
+
+        if (property.minlength) {
+          schemaSettingsObj[property.key].minlength = property.minlength;
+        }
+
+        if (property.maxlength) {
+          schemaSettingsObj[property.key].maxlength = property.maxlength;
+        }
+      } else {
+        schemaSettingsObj[property.key] = this.buildMongooseSchemaByModelParams(
+          property.subObjectParams
+        );
+      }
+    });
+
+    return schemaSettingsObj;
+  }
+
+  private getBEType(
+    type: string
+  ): String | Number | Boolean | Object | Function | Array<any> | Date {
+    switch (type.toLocaleLowerCase()) {
+
+      case 'string':
+        return String;
+        
+      case 'number':
+        return Number;
+
+      case 'boolean':
+        return Boolean;
+
+      case 'date':
+        return Date;
+
+      case 'object':
+        return Object;
+        
+      default:
+        if (type.includes('[]') || type.includes('array')) {
+          return Array;
+        } else if (type.includes('=>') || type.includes('function')) {
+          return Function;
+        } else {
+          return Object;
+        }
+    }
+  }
+
+  /**
+   * adds dynamo metadata settings to any mongoose schema building settings object
+   * @param schema schema to update
+   * @returns updated schema
+   */
+  private addDynamoFM_MetadataToSchema(schema: any): any {
+    schema.__created = { type: Date };
+    schema.__createdBy = { type: String };
+    schema.__lastModified = { type: Date };
+    schema.__lastModifiedBy = { type: String };
+    
+    return schema;
+  }
+
+  /**
+   * sets depDataKey
+   */
+  private lookForDependencyDataSettings(): void {
+    const dependencyParam: DynamoFM_DataProperty_Params = this.dataParams.properties.find(
+      (modelParams: DynamoFM_DataProperty_Params): boolean => modelParams.isDependencyHook
+    );
+    
+    if (dependencyParam) {
+      this.depDataName = dependencyParam.key;
+    }
+  }
+}