@futdevpro/nts-dynamo 1.5.50 → 1.5.52

package/lib/_services/dynamo-nts-db.service.js

@@ -18,6 +18,7 @@ class DynamoNTS_DBService {
     constructor(dataParams) {
         this.dataParams = dataParams;
         this.dataModel = mongoose.model(this.dataParams.dbName, this.getSchema());
+        this.defaultErrorUserMsg = 'We encountered an unhandled DB Error, please contact the responsible development team.';
         this.lookForDependencyDataSettings();
     }
     /**
@@ -32,10 +33,9 @@ class DynamoNTS_DBService {
             data.__createdBy = creator;
             data.__lastModifiedBy = creator;
             const dataModel = new this.dataModel(data);
-            let newData;
-            yield dataModel.save().then(res => {
+            let newData = yield dataModel.save().then(res => {
                 if (res) {
-                    newData = res.toObject();
+                    return res.toObject();
                 }
                 else {
                     throw new fsm_dynamo_1.Dynamo_Error({
@@ -43,7 +43,7 @@ class DynamoNTS_DBService {
                         errorCode: 'NTS-DBS-CD1',
                         addECToUserMsg: true,
                         message: `save ${this.dataParams.dbName} result not found! (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                        userMessage: this.defaultErrorUserMsg
                     });
                 }
             }).catch(error => {
@@ -52,7 +52,7 @@ class DynamoNTS_DBService {
                     errorCode: 'NTS-DBS-CD0',
                     addECToUserMsg: true,
                     message: `Create new ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
@@ -74,10 +74,9 @@ class DynamoNTS_DBService {
             data.__lastModified = new Date();
             data.__lastModifiedBy = modifier;
             const dataModel = new this.dataModel(data);
-            let newData;
-            yield this.dataModel.findByIdAndUpdate(data._id, dataModel).then(res => {
+            let newData = yield this.dataModel.findByIdAndUpdate(data._id, dataModel).then(res => {
                 if (res) {
-                    newData = res.toObject();
+                    return res.toObject();
                 }
                 else {
                     throw new fsm_dynamo_1.Dynamo_Error({
@@ -85,7 +84,7 @@ class DynamoNTS_DBService {
                         errorCode: 'NTS-DBS-FU1',
                         addECToUserMsg: true,
                         message: `update ${this.dataParams.dbName} result not found! (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                        userMessage: this.defaultErrorUserMsg
                     });
                 }
             }).catch(error => {
@@ -94,10 +93,14 @@ class DynamoNTS_DBService {
                     errorCode: 'NTS-DBS-FU0',
                     addECToUserMsg: true,
                     message: `modify ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
+            if (typeof newData._id === 'object') {
+                newData._id = `${newData._id}`;
+            }
+            data._id = newData._id;
             data.__v = newData.__v;
             return data;
         });
@@ -109,13 +112,12 @@ class DynamoNTS_DBService {
      */
     getDataById(id) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let data;
-            yield this.dataModel.findById(id).then(res => {
+            let data = yield this.dataModel.findById(id).then(res => {
                 if (res) {
-                    data = res.toObject();
+                    return res.toObject();
                 }
                 else {
-                    data = null;
+                    return null;
                 }
             }).catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
@@ -123,7 +125,7 @@ class DynamoNTS_DBService {
                     errorCode: 'NTS-DBS-GI0',
                     addECToUserMsg: true,
                     message: `get ${this.dataParams.dbName} by ID was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
@@ -140,39 +142,36 @@ class DynamoNTS_DBService {
      */
     getDataByDependencyId(dependencyId) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            if (this.depDataName) {
-                let data;
-                yield this.dataModel.findOne({ [this.depDataName]: dependencyId }).then(res => {
-                    if (res) {
-                        data = res.toObject();
-                    }
-                    else {
-                        data = null;
-                    }
-                }).catch(error => {
-                    throw new fsm_dynamo_1.Dynamo_Error({
-                        status: 417,
-                        errorCode: 'NTS-DBS-GD1',
-                        addECToUserMsg: true,
-                        message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
-                        error
-                    });
-                });
-                if (data && typeof data._id === 'object') {
-                    data._id = `${data._id}`;
-                }
-                return data;
-            }
-            else {
+            if (!this.depDataName) {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 501,
                     errorCode: 'NTS-DBS-GD0',
                     addECToUserMsg: true,
                     message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                    userMessage: this.defaultErrorUserMsg
                 });
             }
+            let data = yield this.dataModel.findOne({ [this.depDataName]: dependencyId }).then(res => {
+                if (res) {
+                    return res.toObject();
+                }
+                else {
+                    return null;
+                }
+            }).catch(error => {
+                throw new fsm_dynamo_1.Dynamo_Error({
+                    status: 417,
+                    errorCode: 'NTS-DBS-GD1',
+                    addECToUserMsg: true,
+                    message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
+                    userMessage: this.defaultErrorUserMsg,
+                    error
+                });
+            });
+            if (data && typeof data._id === 'object') {
+                data._id = `${data._id}`;
+            }
+            return data;
         });
     }
     /**
@@ -182,38 +181,35 @@ class DynamoNTS_DBService {
      */
     getDataListByDependencyId(dependencyId) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            if (this.depDataName) {
-                let dataList = [];
-                yield this.dataModel.find({ [this.depDataName]: dependencyId }).then(res => {
-                    if (res) {
-                        dataList = res;
-                    }
-                }).catch(error => {
-                    throw new fsm_dynamo_1.Dynamo_Error({
-                        status: 417,
-                        errorCode: 'NTS-DBS-GLD1',
-                        addECToUserMsg: true,
-                        message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
-                        error
-                    });
-                });
-                if (0 < dataList.length && typeof dataList[0]._id === 'object') {
-                    dataList.forEach((data) => {
-                        data._id = `˙${data._id}`;
-                    });
-                }
-                return dataList;
-            }
-            else {
+            if (!this.depDataName) {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 501,
                     errorCode: 'NTS-DBS-GLD0',
                     addECToUserMsg: true,
                     message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                    userMessage: this.defaultErrorUserMsg
                 });
             }
+            let dataList = yield this.dataModel.find({ [this.depDataName]: dependencyId })
+                .then(res => res !== null && res !== void 0 ? res : [])
+                .catch(error => {
+                throw new fsm_dynamo_1.Dynamo_Error({
+                    status: 417,
+                    errorCode: 'NTS-DBS-GLD1',
+                    addECToUserMsg: true,
+                    message: `get ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
+                    userMessage: this.defaultErrorUserMsg,
+                    error
+                });
+            });
+            if (0 < dataList.length) {
+                dataList.forEach((data) => {
+                    if (data && typeof data._id === 'object') {
+                        data._id = `${data._id}`;
+                    }
+                });
+            }
+            return dataList;
         });
     }
     /**
@@ -223,33 +219,35 @@ class DynamoNTS_DBService {
      */
     getDataListByDependencyIds(ids) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            if (this.depDataName) {
-                let dataList = [];
-                yield this.dataModel.find({ [this.depDataName]: { $in: ids } }).then(res => {
-                    if (res) {
-                        dataList = res;
-                    }
-                }).catch(error => {
-                    throw new fsm_dynamo_1.Dynamo_Error({
-                        status: 417,
-                        errorCode: 'NTS-DBS-GLDS1',
-                        addECToUserMsg: true,
-                        message: `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
-                        error
-                    });
-                });
-                return dataList;
-            }
-            else {
+            if (!this.depDataName) {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 501,
                     errorCode: 'NTS-DBS-GLDS0',
                     addECToUserMsg: true,
                     message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                    userMessage: this.defaultErrorUserMsg
+                });
+            }
+            let dataList = yield this.dataModel.find({ [this.depDataName]: { $in: ids } })
+                .then(res => res !== null && res !== void 0 ? res : [])
+                .catch(error => {
+                throw new fsm_dynamo_1.Dynamo_Error({
+                    status: 417,
+                    errorCode: 'NTS-DBS-GLDS1',
+                    addECToUserMsg: true,
+                    message: `get ${this.dataParams.dbName}s by ${this.depDataName}s was unsuccessful (NTS DB)`,
+                    userMessage: this.defaultErrorUserMsg,
+                    error
+                });
+            });
+            if (0 < dataList.length) {
+                dataList.forEach((data) => {
+                    if (data && typeof data._id === 'object') {
+                        data._id = `${data._id}`;
+                    }
                 });
             }
+            return dataList;
         });
     }
     /**
@@ -262,27 +260,27 @@ class DynamoNTS_DBService {
     searchData(searchBy, narrowByDependencyIds) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             const filter = {};
-            if (narrowByDependencyIds.length > 0) {
-                if (this.depDataName) {
-                    filter[this.depDataName] = { $in: narrowByDependencyIds };
-                }
-                else {
+            if (0 < narrowByDependencyIds.length) {
+                if (!this.depDataName) {
                     throw new fsm_dynamo_1.Dynamo_Error({
                         status: 501,
                         errorCode: 'NTS-DBS-SD0',
                         addECToUserMsg: true,
                         message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                        userMessage: this.defaultErrorUserMsg
                     });
                 }
+                filter[this.depDataName] = { $in: narrowByDependencyIds };
             }
             yield this.dataParams.modelParams.forEach((modelParam) => {
-                if ((searchBy[modelParam.key] !== null && searchBy[modelParam.key] !== undefined) || searchBy[modelParam.key + 'Range']) {
+                if ((searchBy[modelParam.key] !== null && searchBy[modelParam.key] !== undefined) ||
+                    searchBy[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 (searchBy[searchParamKeyWithoutRange] !== null && searchBy[searchParamKeyWithoutRange] !== undefined) {
+                            if (searchBy[searchParamKeyWithoutRange] !== null &&
+                                searchBy[searchParamKeyWithoutRange] !== undefined) {
                                 filter[modelParam.key] = {
                                     from: { $lte: searchBy[searchParamKeyWithoutRange] },
                                     to: { $gte: searchBy[searchParamKeyWithoutRange] }
@@ -290,7 +288,8 @@ class DynamoNTS_DBService {
                             }
                         }
                         else {
-                            if (searchBy[modelParam.key] !== null && searchBy[modelParam.key] !== undefined) {
+                            if (searchBy[modelParam.key] !== null &&
+                                searchBy[modelParam.key] !== undefined) {
                                 filter[modelParam.key] = { $in: searchBy[modelParam.key] };
                             }
                         }
@@ -316,74 +315,43 @@ class DynamoNTS_DBService {
                     }
                 }
             });
-            let dataList = [];
-            yield this.dataModel.find(filter).then(res => {
-                if (res) {
-                    dataList = res;
-                }
-            }).catch(error => {
+            let dataList = yield this.dataModel.find(filter)
+                .then(res => res !== null && res !== void 0 ? res : [])
+                .catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 417,
                     errorCode: 'NTS-DBS-SD1',
                     addECToUserMsg: true,
                     message: `search ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
-            if (0 < dataList.length && typeof dataList[0]._id === 'object') {
+            if (0 < dataList.length) {
                 dataList.forEach((data) => {
-                    data._id = `˙${data._id}`;
+                    if (data && typeof data._id === 'object') {
+                        data._id = `${data._id}`;
+                    }
                 });
             }
             return dataList;
         });
     }
-    /**
-     * find data by any of its parameters, throws error if not found
-     * @param data
-     * (always use unique parameters for find!)
-     * etc.: by email:
-     * @example { email: email }
-     * or by id that is in list:
-     * @example { userIds: { $in: this.userId } }
-     * or by number or Date that is greater than OR less than:
-     * @example { points: { $gte: 2, $lte: 14 } }
-     * @returns data
-     */
-    /* async findData(data: T): Promise<T> {
-      await this.dataModel.findOne(data).then(res => {
-        if (res) {
-          data = res.toObject() as T;
-        } else {
-          data = null;
-        }
-      }).catch(error => {
-        throw new Dynamo_Error({ status: 417, message: `find ${this.dataParams.dbName} was unsuccessful (NTS DB)`, error });
-      });
-      if (data && typeof data._id === 'object') {
-        data._id = `${data._id}`;
-      }
-      return data;
-    } */
     /**
      * returns all data from database, throws error if not found
      * @returns dataList
      */
     getAll() {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let dataList = [];
-            yield this.dataModel.find({}).then(res => {
-                if (res) {
-                    dataList = res;
-                }
-            }).catch(error => {
+            let dataList = yield this.dataModel.find({})
+                .then(res => res !== null && res !== void 0 ? res : [])
+                .catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 417,
                     errorCode: 'NTS-DBS-GA0',
                     addECToUserMsg: true,
                     message: `get all ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
@@ -407,7 +375,7 @@ class DynamoNTS_DBService {
                     errorCode: 'NTS-DBS-DD0',
                     addECToUserMsg: true,
                     message: `delete ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
@@ -419,61 +387,64 @@ class DynamoNTS_DBService {
      */
     deleteDataByDependencyId(dependencyId) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            if (this.depDataName) {
-                yield this.dataModel.deleteMany({ [this.depDataName]: dependencyId }).catch(error => {
-                    throw new fsm_dynamo_1.Dynamo_Error({
-                        status: 417,
-                        errorCode: 'NTS-DBS-DDD1',
-                        addECToUserMsg: true,
-                        message: `delete ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
-                        error
-                    });
-                });
-            }
-            else {
+            if (!this.depDataName) {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 501,
                     errorCode: 'NTS-DBS-DDD0',
                     addECToUserMsg: true,
                     message: `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                    userMessage: this.defaultErrorUserMsg
                 });
             }
+            yield this.dataModel.deleteMany({ [this.depDataName]: dependencyId })
+                .catch(error => {
+                throw new fsm_dynamo_1.Dynamo_Error({
+                    status: 417,
+                    errorCode: 'NTS-DBS-DDD1',
+                    addECToUserMsg: true,
+                    message: `delete ${this.dataParams.dbName} by ${this.depDataName} was unsuccessful (NTS DB)`,
+                    userMessage: this.defaultErrorUserMsg,
+                    error
+                });
+            });
         });
     }
     // ----------------------------------------------------------------------------------
     // ----------------------------------------------------------------------------------
     // ----------------------------------------------------------------------------------
-    // DIRECT MONGOOSE CALLS (with error handlings)
+    // DIRECT Basic MONGOOSE FUNCTIONS (with error handlings)
     /**
-     * find the data first by any of its parameters, throws error if not found
-     * @param filter
-     * (always use unique parameters for find!)
-     * etc.: by email:
-     * @example { email: email }
-     * or by id that is in list:
-     * @example { userIds: { $in: this.userId } }
-     * or by number or Date that is GREATER THAN OR LESS THAN:
-     * @example { 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.
+     * Find the data first by any of its parameters, throws error if not found
+     * @param filter if you can, use unique parameters for find!
      *
-     * @returns data
+     * @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
      */
     findOne(filter) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let data;
-            yield this.dataModel.findOne(filter).then(res => {
+            let data = yield this.dataModel.findOne(filter).then(res => {
                 if (res) {
-                    data = res.toObject();
+                    return res.toObject();
                 }
                 else {
-                    data = null;
+                    return null;
                 }
             }).catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
@@ -481,7 +452,7 @@ class DynamoNTS_DBService {
                     errorCode: 'NTS-DBS-FO0',
                     addECToUserMsg: true,
                     message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
@@ -492,93 +463,106 @@ class DynamoNTS_DBService {
         });
     }
     /**
-     * find all data by any of its parameters, throws error if not found
-     * @param filter
-     * etc.: by email:
-     * @example { email: email }
-     * or by id that is in list:
-     * @example { userIds: { $in: this.userId } }
-     * or by number or Date that is GREATER THAN OR LESS THAN:
-     * @example { 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.
+     * Find the data first by any of its parameters, throws error if not found
+     * @param filter if you can, use unique parameters for find!
      *
-     * @returns dataList
+     * @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[]
      */
     find(filter) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let dataList = [];
-            yield this.dataModel.find(filter).then(res => {
-                if (res) {
-                    dataList = res;
-                }
-            }).catch(error => {
+            let dataList = yield this.dataModel.find(filter)
+                .then(res => res !== null && res !== void 0 ? res : [])
+                .catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 417,
                     errorCode: 'NTS-DBS-F0',
                     addECToUserMsg: true,
                     message: `find ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
-            if (0 < dataList.length && typeof dataList[0]._id === 'object') {
+            if (0 < dataList.length) {
                 dataList.forEach((data) => {
-                    data._id = `˙${data._id}`;
+                    if (data && typeof data._id === 'object') {
+                        data._id = `${data._id}`;
+                    }
                 });
             }
             return dataList;
         });
     }
     /**
-     * find all data by any of its parameters, throws error if not found
-     * @param filter
-     * etc.: by email:
-     * @example { email: email }
-     * or by id that is in list:
-     * @example { userIds: { $in: this.userId } }
-     * or by number or Date that is GREATER THAN OR LESS THAN:
-     * @example { 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.
+     * Find the data first by any of its parameters, throws error if not 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.
+     * //
      * @param page page
      * @param pageSize pageSize
-     * @param sort etc. by dateTime: { dateTime: -1 }
-     * @returns dataList
+     * @param sort
+     * @example
+     * // by dateTime (this uses the basic sort function):
+     * { dateTime: -1 }
+     * //
+     * @returns {T[]} dataList: T[]
      */
     findWithPaging(filter, page, pageSize, sort) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let dataList = [];
-            yield this.dataModel.find(filter)
+            let dataList = yield this.dataModel.find(filter)
                 .sort(sort)
                 .skip(page * pageSize)
                 .limit(pageSize)
-                .then(res => {
-                if (res) {
-                    dataList = res;
-                }
-            }).catch(error => {
+                .then(res => res !== null && res !== void 0 ? res : [])
+                .catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 417,
                     errorCode: 'NTS-DBS-WP0',
                     addECToUserMsg: true,
                     message: `findWithPaging ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
-            if (0 < dataList.length && typeof dataList[0]._id === 'object') {
+            if (0 < dataList.length) {
                 dataList.forEach((data) => {
-                    data._id = `˙${data._id}`;
+                    if (data && typeof data._id === 'object') {
+                        data._id = `${data._id}`;
+                    }
                 });
             }
             return dataList;
@@ -592,12 +576,11 @@ class DynamoNTS_DBService {
      */
     findByIdAndUpdate(id, update, modifier) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            let data;
             update.__lastModified = new Date();
             update.__lastModifiedBy = modifier;
-            yield this.dataModel.findByIdAndUpdate(id, update).then(res => {
+            let newData = yield this.dataModel.findByIdAndUpdate(id, update).then(res => {
                 if (res) {
-                    data = res.toObject();
+                    return res.toObject();
                 }
                 else {
                     throw new fsm_dynamo_1.Dynamo_Error({
@@ -605,7 +588,7 @@ class DynamoNTS_DBService {
                         errorCode: 'NTS-DBS-FIU1',
                         addECToUserMsg: true,
                         message: `${this.dataParams.dbName} not found! (NTS DB)`,
-                        userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`
+                        userMessage: this.defaultErrorUserMsg
                     });
                 }
             }).catch(error => {
@@ -614,107 +597,178 @@ class DynamoNTS_DBService {
                     errorCode: 'NTS-DBS-FIU0',
                     addECToUserMsg: true,
                     message: `findByIdAndUpdate ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
-            update.__v = data.__v;
-            return update;
+            if (typeof newData._id === 'object') {
+                newData._id = `${newData._id}`;
+            }
+            /* update._id = newData._id;
+            update.__v = newData.__v; */
+            return newData;
         });
     }
     /**
-     * update one parameter by a specific
-     * @param updateBy
-     * (always use unique parameters for find!)
-     * etc.: by email:
-     * @example { email: email }
-     * or by id that is in list:
-     * @example { userIds: { $in: this.userId } }
-     * or by number or Date that is GREATER THAN OR LESS THAN:
-     * @example { 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.
+     * 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
-     * etc.: increase a specific value:
-     * @example { $inc: { popularity: 15 } }
-     * or add element to a list:
-     * @example { $push: { reactions: this.newReaction }
-     * or all at once
-     * @example { $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)
+     * @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)
+     * //
      */
     updateOne(updateBy, update, modifier) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             update.__lastModified = new Date();
             update.__lastModifiedBy = modifier;
-            yield this.dataModel.updateOne(updateBy, update).catch(error => {
+            let newData = yield this.dataModel.updateOne(updateBy, update).then(res => {
+                if (res) {
+                    return res.toObject();
+                }
+                else {
+                    throw new fsm_dynamo_1.Dynamo_Error({
+                        status: 204,
+                        errorCode: 'NTS-DBS-FU1',
+                        addECToUserMsg: true,
+                        message: `update ${this.dataParams.dbName} result not found! (NTS DB)`,
+                        userMessage: this.defaultErrorUserMsg
+                    });
+                }
+            }).catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 417,
                     errorCode: 'NTS-DBS-UO0',
                     addECToUserMsg: true,
                     message: `updateOne ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
+            if (typeof newData._id === 'object') {
+                newData._id = `${newData._id}`;
+            }
+            /* update._id = newData._id;
+            update.__v = newData.__v; */
+            console.log(`Dynamo function result under testing: ${newData}`);
+            return newData;
         });
     }
     /**
      * update one parameter by a specific
-     * @param updateBy
-     * etc.: by email:
-     * @example { email: email }
-     * or by id that is in list:
-     * @example { userIds: { $in: this.userId } }
-     * or by number or Date that is GREATER THAN OR LESS THAN:
-     * @example { 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 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
-     * etc.: increase a specific value:
-     * @example { $inc: { popularity: 15 } }
-     * or add element to a list:
-     * @example { $push: { reactions: this.newReaction }
-     * or all at once
-     * @example { $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)
+     * @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)
+     * //
      */
     updateMany(updateBy, update, modifier) {
         return tslib_1.__awaiter(this, void 0, void 0, function* () {
             update.__lastModified = new Date();
             update.__lastModifiedBy = modifier;
-            yield this.dataModel.updateMany(updateBy, update).catch(error => {
+            let dataList = yield this.dataModel.updateMany(updateBy, update)
+                .then(res => res !== null && res !== void 0 ? res : [])
+                .catch(error => {
                 throw new fsm_dynamo_1.Dynamo_Error({
                     status: 417,
                     errorCode: 'NTS-DBS-UM0',
                     addECToUserMsg: true,
                     message: `updateMany ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-                    userMessage: `We encountered an unhandled DB Error, please contact the responsible development team.`,
+                    userMessage: this.defaultErrorUserMsg,
                     error
                 });
             });
+            if (0 < dataList.length) {
+                dataList.forEach((data) => {
+                    if (data && typeof data._id === 'object') {
+                        data._id = `${data._id}`;
+                    }
+                });
+            }
+            console.log(`Dynamo function result under testing: ${dataList}`);
+            return dataList;
         });
     }
     // ----------------------------------------------------------------------------------
@@ -746,8 +800,9 @@ class DynamoNTS_DBService {
             params = this.dataParams.modelParams;
         }
         params.forEach((property) => {
+            var _a;
             const beType = this.getBEType(property.type);
-            if (beType !== Object || !property.subObjectParams) {
+            if (beType !== Object || !(property === null || property === void 0 ? void 0 : property.subObjectParams) || ((_a = property === null || property === void 0 ? void 0 : property.subObjectParams) === null || _a === void 0 ? void 0 : _a.length) == 0) {
                 schemaSettingsObj[property.key] = {
                     type: beType
                 };