@futdevpro/nts-dynamo 1.5.77 → 1.5.83

package/src/_services/dynamo-nts-db.service.ts

@@ -1,12 +1,92 @@
 
 import * as mongoose from 'mongoose';
 import { Schema } from 'mongoose';
-import { Dynamo_Metadata, Dynamo_DataParams, Dynamo_DataPropertyParams, Dynamo_Error } from '@futdevpro/fsm-dynamo';
+
+import { 
+  Dynamo_Metadata, Dynamo_DataParams, Dynamo_DataPropertyParams, Dynamo_Error 
+} from '@futdevpro/fsm-dynamo';
+
+/**
+ * @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
+ */
+export type DynamoNTS_DBFilter<T> = {
+  [K in keyof T]?: T[K] | { 
+    $in?: any,            // Matches values that are includes the value; This works only when T[K] is an array!
+    $eq?: T[K],           // Matches values that are EQual to a specified value.
+    $gt?: number | Date,  // Matches values that are Greater Than a specified value.
+    $gte?: number | Date, // Matches values that are Greater Than OR Equal to a specified value.
+    $lt?: number | Date,  // Matches values that are Less Than a specified value.
+    $lte?: number | Date, // Matches values that are Less Than or Equal to a specified value.
+    $ne?: T[K],           // Matches all values that are Not Equal to a specified value.
+    $nin?: T[K],          // 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)
+ * //
+ */
+export type DynamoNTS_DBUpdate<T> = {
+  [K in keyof T]?: T[K] | {
+    $inc?: number,    // Increments the value of the field by the specified amount.
+    $push?: any | {   // Adds an item to an array. 
+      $each?: T[K],   // Adds multiple items to an array.
+    },                // or add multiple elements to a list
+                      // { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
+    $min?: number,    // Only updates the field if the specified value is less than the existing field value.
+    $max?: number,    // Only updates the field if the specified value is greater than the existing field value.
+    $mul?: number,    // Multiplies the value of the field by the specified amount.
+    $rename?: string, // Renames a field.
+    $unset?: string,  // Removes the specified field from a document. (set: "" to value)
+  };
+};
 
 /**
  * 
  */
-export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U extends T = any> {
+export class DynamoNTS_DBService<T extends Dynamo_Metadata> {
   dataModel = mongoose.model(this.dataParams.dbName, this.getSchema());
 
   private depDataName: string;
@@ -47,7 +127,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
           status: 204, 
           errorCode: 'NTS-DBS-CD1',
           addECToUserMsg: true,
-          message: `save ${this.dataParams.dbName} result not found! (NTS DB)`,
+          message: `createData failed, save ${this.dataParams.dbName} result not found! (NTS DB)`,
           userMessage: this.defaultErrorUserMsg
         });
       }
@@ -59,7 +139,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
           status: 422, 
           errorCode: 'NTS-DBS-CD0',
           addECToUserMsg: true,
-          message: `Create new ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+          message: `createData failed, Create new ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
           userMessage: this.defaultErrorUserMsg, 
           error 
         });
@@ -93,7 +173,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
           status: 204, 
           errorCode: 'NTS-DBS-FU1',
           addECToUserMsg: true,
-          message: `modify ${this.dataParams.dbName} result not found! (NTS DB)`,
+          message: `modifyData failed, modify ${this.dataParams.dbName} result not found! (NTS DB)`,
           userMessage: this.defaultErrorUserMsg,
         });
       }
@@ -102,7 +182,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
         status: 417, 
         errorCode: 'NTS-DBS-FU0',
         addECToUserMsg: true,
-        message: `modify ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        message: `modifyData ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
         userMessage: this.defaultErrorUserMsg, 
         error 
       });
@@ -266,15 +346,89 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
     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[]> {
+    let dataList: T[] = await this.dataModel.find({})
+    .then(res => {
+      return res as T[] ?? [];
+    }).catch(error => {
+      throw new Dynamo_Error({ 
+        status: 417, 
+        errorCode: 'NTS-DBS-GA0',
+        addECToUserMsg: true,
+        message: `get all ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
+        userMessage: this.defaultErrorUserMsg, 
+        error 
+      });
+    });
+
+    if (0 < dataList.length && typeof dataList[0]._id === 'object') {
+      dataList.forEach((data: T) => {
+        data._id = `˙${data._id}`;
+      });
+    }
+
+    return dataList as T[];
+  }
+
+  /**
+   * deleted data by id
+   * @param id id
+   */
+  async deleteDataById(id: string): Promise<void> {
+    await this.dataModel.findByIdAndDelete(id).catch(error => {
+      throw new Dynamo_Error({ 
+        status: 417, 
+        errorCode: 'NTS-DBS-DD0',
+        addECToUserMsg: true,
+        message: `delete ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
+        userMessage: this.defaultErrorUserMsg,  
+        error 
+      });
+    });
+  }
+
+  /**
+   * deleted data by id
+   * @param dependencyId id
+   */
+  async deleteDataByDependencyId(dependencyId: string): Promise<void> {
+    if (!this.depDataName) {
+      throw new 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: this.defaultErrorUserMsg
+      });
+    }
+
+    await this.dataModel.deleteMany({ [this.depDataName]: dependencyId }).catch(error => {
+      throw new 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 
+      });
+    });
+  }
+
   /**
    * returns search result for searchBy object params
    * can use lists or xRange values for searchBy obj properties
    * 
-   * @param searchBy filter
+   * @param filterBy filter
    * @param narrowByDependencyIds id
    * @returns dataList
    */
-  async searchData(searchBy: F, narrowByDependencyIds?: string[]): Promise<T[]> {
+  async searchData(filterBy: DynamoNTS_DBFilter<T>, narrowByDependencyIds?: string[]): Promise<T[]> {
     const filter = {};
 
     if (0 < narrowByDependencyIds.length) {
@@ -293,45 +447,45 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
 
     await this.dataParams.modelParams.forEach((modelParam: Dynamo_DataPropertyParams) => {
       if (
-        (searchBy[modelParam.key] !== null && searchBy[modelParam.key] !== undefined) || 
-        searchBy[modelParam.key + 'Range']
+        (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 (
-              searchBy[searchParamKeyWithoutRange] !== null && 
-              searchBy[searchParamKeyWithoutRange] !== undefined
+              filterBy[searchParamKeyWithoutRange] !== null && 
+              filterBy[searchParamKeyWithoutRange] !== undefined
             ) {
               filter[modelParam.key] = {
-                from: { $lte: searchBy[searchParamKeyWithoutRange] },
-                to: { $gte: searchBy[searchParamKeyWithoutRange] }
+                from: { $lte: filterBy[searchParamKeyWithoutRange] },
+                to: { $gte: filterBy[searchParamKeyWithoutRange] }
               };
             }
           } else {
             if (
-              searchBy[modelParam.key] !== null && 
-              searchBy[modelParam.key] !== undefined
+              filterBy[modelParam.key] !== null && 
+              filterBy[modelParam.key] !== undefined
             ) {
-              filter[modelParam.key] = { $in: searchBy[modelParam.key] };
+              filter[modelParam.key] = { $in: filterBy[modelParam.key] };
             }
           }
         } else {
           // basic search filter
-          if (searchBy[modelParam.key + 'Range']) {
-            if (searchBy[modelParam.key + 'Range'].from || searchBy[modelParam.key + 'Range'].to) {
+          if (filterBy[modelParam.key + 'Range']) {
+            if (filterBy[modelParam.key + 'Range'].from || filterBy[modelParam.key + 'Range'].to) {
               filter[modelParam.key] = {};
-              if (searchBy[modelParam.key + 'Range'].from) {
-                filter[modelParam.key].$gte = searchBy[modelParam.key + 'Range'].from;
+              if (filterBy[modelParam.key + 'Range'].from) {
+                filter[modelParam.key].$gte = filterBy[modelParam.key + 'Range'].from;
               }
-              if (searchBy[modelParam.key + 'Range'].to) {
-                filter[modelParam.key].$lte = searchBy[modelParam.key + 'Range'].to;
+              if (filterBy[modelParam.key + 'Range'].to) {
+                filter[modelParam.key].$lte = filterBy[modelParam.key + 'Range'].to;
               }
             }
-          } else if (searchBy[modelParam.key] !== null && searchBy[modelParam.key] !== undefined) {
-            if (searchBy[modelParam.key].lenght > 0) {
-              filter[modelParam.key] = { $in: searchBy[modelParam.key] };
+          } else if (filterBy[modelParam.key] !== null && filterBy[modelParam.key] !== undefined) {
+            if (filterBy[modelParam.key].lenght > 0) {
+              filter[modelParam.key] = { $in: filterBy[modelParam.key] };
             }
           }
         }
@@ -362,80 +516,6 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
     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[]> {
-    let dataList: T[] = await this.dataModel.find({})
-    .then(res => {
-      return res as T[] ?? [];
-    }).catch(error => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-GA0',
-        addECToUserMsg: true,
-        message: `get all ${this.dataParams.dbName} was unsuccessful (NTS DB)`, 
-        userMessage: this.defaultErrorUserMsg, 
-        error 
-      });
-    });
-
-    if (0 < dataList.length && typeof dataList[0]._id === 'object') {
-      dataList.forEach((data: T) => {
-        data._id = `˙${data._id}`;
-      });
-    }
-
-    return dataList as T[];
-  }
-
-  /**
-   * deleted data by id
-   * @param id id
-   */
-  async deleteDataById(id: string): Promise<void> {
-    await this.dataModel.findByIdAndDelete(id).catch(error => {
-      throw new Dynamo_Error({ 
-        status: 417, 
-        errorCode: 'NTS-DBS-DD0',
-        addECToUserMsg: true,
-        message: `delete ${this.dataParams.dbName} was unsuccessful (NTS DB)`,
-        userMessage: this.defaultErrorUserMsg,  
-        error 
-      });
-    });
-  }
-
-  /**
-   * deleted data by id
-   * @param dependencyId id
-   */
-  async deleteDataByDependencyId(dependencyId: string): Promise<void> {
-    if (!this.depDataName) {
-      throw new 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: this.defaultErrorUserMsg
-      });
-    }
-
-    await this.dataModel.deleteMany({ [this.depDataName]: dependencyId }).catch(error => {
-      throw new 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 
-      });
-    });
-  }
-
   // ----------------------------------------------------------------------------------
   // ----------------------------------------------------------------------------------
   // ----------------------------------------------------------------------------------
@@ -445,7 +525,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * Find the data first by any of its parameters, 
    * !!!: throws error if not found (errorCode on not found: NTS-DBS-FO1)
    * 
-   * @param filter if you can, use unique parameters for find!
+   * @param filterBy if you can, use unique parameters for find!
    * 
    * @example 
    * // by email: 
@@ -467,15 +547,15 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * //
    * @returns {T} data: T
    */
-  async findOne(filter: F): Promise<T> {
-    let data: T = await this.dataModel.findOne(filter).then(res => {
+  async findOne(filterBy: DynamoNTS_DBFilter<T>): Promise<T> {
+    let data: T = await this.dataModel.findOne(filterBy).then(res => {
       return res as T ?? null;
     }).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-FO0',
         addECToUserMsg: true,
-        message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB) fliter: ${filter}`, 
+        message: `findOne ${this.dataParams.dbName} was unsuccessful (NTS DB) fliter: ${filterBy}`, 
         userMessage: this.defaultErrorUserMsg, 
         error 
       });
@@ -493,7 +573,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * Find the data first by any of its parameters, 
    * !!!: throws error if not found (errorCode on not found: NTS-DBS-F1)
    * 
-   * @param filter if you can, use unique parameters for find!
+   * @param filterBy if you can, use unique parameters for find!
    * 
    * @example 
    * // by email: 
@@ -515,8 +595,8 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * //
    * @returns {T[]} dataList: T[]
    */
-  async find(filter: F): Promise<T[]> {
-    let dataList: T[] = await this.dataModel.find(filter)
+  async find(filterBy: DynamoNTS_DBFilter<T>): Promise<T[]> {
+    let dataList: T[] = await this.dataModel.find(filterBy)
     .then(res => {
       return res as T[] ?? [];
     }).catch(error => {
@@ -545,7 +625,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * #MONGOOSE FUNCTION
    * Find the data first by any of its parameters
    * 
-   * @param filter if you can, use unique parameters for find!
+   * @param filterBy if you can, use unique parameters for find!
    * 
    * @example 
    * // by email: 
@@ -574,8 +654,8 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * //
    * @returns {T[]} dataList: T[]
    */
-  async findWithPaging(filter: F, page: number, pageSize: number, sort?: any): Promise<T[]> {
-    let dataList: T[] = await this.dataModel.find(filter)
+  async findWithPaging(filterBy: DynamoNTS_DBFilter<T>, page: number, pageSize: number, sort?: any): Promise<T[]> {
+    let dataList: T[] = await this.dataModel.find(filterBy)
                         .sort(sort)
                         .skip(page * pageSize)
                         .limit(pageSize)
@@ -611,7 +691,7 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * @param update update
    * @returns data
    */
-  async findByIdAndUpdate(id: string, update: U, modifier: string): Promise<T> {
+  async findByIdAndUpdate(id: string, update: DynamoNTS_DBUpdate<T>, modifier: string): Promise<T> {
     update.__lastModified = new Date();
     update.__lastModifiedBy = modifier;
 
@@ -687,11 +767,11 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * $unset:       // Removes the specified field from a document. (set: "" to value)
    * //
    */
-  async updateOne(updateBy: F, update: U, issuer: string): Promise<void> {
+  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(updateBy, update).catch(error => {
+    await this.dataModel.updateOne(filterBy, update).catch(error => {
       throw new Dynamo_Error({
         status: 417, 
         errorCode: 'NTS-DBS-UO0',
@@ -754,11 +834,11 @@ export class DynamoNTS_DBService<T extends Dynamo_Metadata, F extends T = any, U
    * $unset:       // Removes the specified field from a document. (set: "" to value)
    * //
    */
-  async updateMany(updateBy: F, update: U, issuer: string): Promise<void> {
+  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(updateBy, update).catch(error => {
+    await this.dataModel.updateMany(filterBy, update).catch(error => {
       throw new Dynamo_Error({ 
         status: 417, 
         errorCode: 'NTS-DBS-UM0',

package/src/_services/dynamo-nts-email.service.ts

@@ -3,6 +3,7 @@ import * as FileSystem from 'fs';
 import * as Path from 'path';
 import * as NodeMailer from 'nodemailer';
 import { Options as MailOptions, Attachment } from 'nodemailer/lib/mailer';
+
 import { Dynamo_Error, Dynamo_Log } from '@futdevpro/fsm-dynamo';
 
 /**

package/src/_services/dynamo-nts-global.service.ts

@@ -1,7 +1,9 @@
 
 
 import { Dynamo_Metadata, Dynamo_DataParams, Dynamo_Log } from '@futdevpro/fsm-dynamo';
-import { DynamoNTS_AppParams } from '../_models';
+
+import { DynamoNTS_GlobalServiceSettings } from '../_interfaces/global-service-settings.interface';
+import { DynamoNTS_AppParams } from '../_models/dynamo-nts-app-params';
 
 import { DynamoNTS_AuthService } from './dynamo-nts-auth.service';
 import { DynamoNTS_DBServiceCollection } from './dynamo-nts-db-service-collection.service';
@@ -11,23 +13,6 @@ import { DynamoNTS_SingletonService } from './dynamo-nts-singleton.service';
 import { DynamoNTS_SocketServiceCollection } from './dynamo-nts-socket-service-collection.service';
 import { DynamoNTS_SocketService } from './dynamo-nts-socket.service';
 
-export interface DynamoNTS_GlobalServiceSettings {
-  /**
-   * You need to setup your Own Auth Service extending the DynamoBEAuthService class
-   */
-  authService?: DynamoNTS_AuthService,
-
-  /**
-   * You can setup your Own Email Service extending the DynamoBEEmailServiceCollection class
-   */
-  emailServiceCollection?: DynamoNTS_EmailServiceCollection,
-
-  /**
-   * you can setup data tables by passing a DynamoBEDataParams list at this point 
-   */
-  dbModels: Dynamo_DataParams[],
-}
-
 /**
  * This is the main Global/Core Service Collection used by DynamoBE, 
  * you also can use this to access main services as 

package/src/_services/dynamo-nts-routing-module.service.ts

@@ -1,5 +1,6 @@
 
 import { Router } from 'express';
+
 import { Dynamo_Error, Dynamo_Log } from '@futdevpro/fsm-dynamo';
 
 import { dynamoNTS_GlobalSettings } from '../_constants/dynamo-nts-global-settings';

package/src/_services/dynamo-nts-shared.service.spec.ts

@@ -0,0 +1,10 @@
+import { DynamoNTS_Shared } from './dynamo-nts-shared.service';
+
+describe('DynamoNTS_Shared', () => {
+  it('fns should be accessible', () => {
+    expect(DynamoNTS_Shared.getIpFromRequest).toBeTruthy();
+    expect(DynamoNTS_Shared.getLocationDataByRequest).toBeTruthy();
+    expect(DynamoNTS_Shared.getLocationByIp).toBeTruthy();
+    expect(DynamoNTS_Shared.prompt).toBeTruthy();
+  });
+});

package/src/_services/dynamo-nts-shared.service.ts

@@ -1,7 +1,8 @@
 
 import * as ReadLine from 'readline';
-import { Request } from 'express';
 import * as GeoIp from 'geoip-lite';
+import { Request } from 'express';
+
 import { GeoIpLocation, Dynamo_Shared } from '@futdevpro/fsm-dynamo/shared-service';
 
 /**