@futdevpro/nts-dynamo 1.10.6 → 1.10.8

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

@@ -23,7 +23,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
 
   serviceName: string;
 
-  dataModel/* : mongoose.Model<T> */; // = mongoose.model(this.dataParams.dbName, this.getSchema());
+  dataModel/* : mongoose.Model<T> */; // = mongoose.model(this.dataParams.dataName, this.getSchema());
 
   private depDataName: string;
 
@@ -43,11 +43,17 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
     try {
       this.serviceName = this.constructor?.name;
 
+      if (!this.dataParams.dataName) {
+        throw new Error(
+          `dbName not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`
+        );
+      }
+
       try {
-        this.dataModel = mongoose.model(this.dataParams.dbName, this.getSchema());
+        this.dataModel = mongoose.model(this.dataParams.dataName, this.getSchema());
       } catch (error) {
-        if (mongoose.models[this.dataParams.dbName]) {
-          this.dataModel = mongoose.models[this.dataParams.dbName];
+        if (mongoose.models[this.dataParams.dataName]) {
+          this.dataModel = mongoose.models[this.dataParams.dataName];
         } else {
           throw error;
         }
@@ -87,7 +93,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings(
             'createData', 
             new Error(
-              `createData failed, save "${this.dataParams.dbName}" result not found! (NTS DB)`
+              `createData failed, save "${this.dataParams.dataName}" result not found! (NTS DB)`
             ),
             issuer
           ),
@@ -109,7 +115,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
             dataModel: this.dataModel,
           },
           message: 
-            `createData failed, Create new "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+            `createData failed, Create new "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
           issuer,
         });
       }
@@ -141,7 +147,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         throw new DyFM_Error({ 
           ...this._getDefaultErrorSettings(
             'modifyData', 
-            new Error(`modifyData failed, modify "${this.dataParams.dbName}" result not found! (NTS DB)`),
+            new Error(`modifyData failed, modify "${this.dataParams.dataName}" result not found! (NTS DB)`),
             issuer,
           ),
 
@@ -156,7 +162,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('modifyData', error, issuer),
           errorCode: 'NTS-DBS-FU0',
           additionalContent: { data },
-          message: `modifyData "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `modifyData "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
           issuer,
         });
       });
@@ -175,7 +181,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         ...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)`,
+        message: `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)`,
       });
     }
 
@@ -187,7 +193,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('getDataById', error),
           errorCode: 'NTS-DBS-GI0',
           additionalContent: { id },
-          message: `get "${this.dataParams.dbName}" by ID was unsuccessful (NTS DB)`, 
+          message: `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)`, 
         });
       });
 
@@ -207,7 +213,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         ...this._getDefaultErrorSettings(
           'getDataByDependencyId', 
           new Error(
-            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) ` +
             `(NTS DB)`
           )
         ),
@@ -225,7 +231,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           errorCode: 'NTS-DBS-GD1',
           additionalContent: { dependencyId },
           message: 
-            `get "${this.dataParams.dbName}" by ${this.depDataName} was unsuccessful (NTS DB)`, 
+            `get "${this.dataParams.dataName}" by ${this.depDataName} was unsuccessful (NTS DB)`, 
         });
       });
 
@@ -245,7 +251,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         ...this._getDefaultErrorSettings(
           'getDataListByDependencyId',
           new Error(
-            `isDependencyHook not setted up for this dataModel (${this.dataParams.dbName}) ` +
+            `isDependencyHook not setted up for this dataModel (${this.dataParams.dataName}) ` +
             `(NTS DB)`
           )
         ),
@@ -267,7 +273,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           errorCode: 'NTS-DBS-GLD1',
           additionalContent: { dependencyId },
           message: 
-            `get "${this.dataParams.dbName}" by ${this.depDataName} was unsuccessful (NTS DB)`, 
+            `get "${this.dataParams.dataName}" by ${this.depDataName} was unsuccessful (NTS DB)`, 
         });
       });
 
@@ -292,7 +298,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           'getDataListByDependencyIds',
           new Error(
             `getDataListByDependencyIds not setted up for this db-service ` +
-            `(${this.dataParams.dbName}) (NTS DB)`
+            `(${this.dataParams.dataName}) (NTS DB)`
           )
         ),
         errorCode: 'NTS-DBS-GLDS0',
@@ -310,7 +316,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           errorCode: 'NTS-DBS-GLDS1',
           additionalContent: { dependencyIds },
           message: 
-            `get "${this.dataParams.dbName}" by ${this.depDataName} was unsuccessful (NTS DB)`,
+            `get "${this.dataParams.dataName}" by ${this.depDataName} was unsuccessful (NTS DB)`,
         });
       });
 
@@ -336,7 +342,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('getAll', error),
           
           errorCode: 'NTS-DBS-GA0',
-          message: `get all "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `get all "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
         });
       });
 
@@ -362,7 +368,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           
           errorCode: 'NTS-DBS-MD0',
           additionalContent: { id },
-          message: `mark deleted "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `mark deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
           issuer,
         });
       }
@@ -382,7 +388,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         errorCode: 'NTS-DBS-MDD0',
         additionalContent: { dependencyId },
         message: 
-          `markDeleted "${this.dataParams.dbName}" by ${this.depDataName} was unsuccessful ` +
+          `markDeleted "${this.dataParams.dataName}" by ${this.depDataName} was unsuccessful ` +
           `(NTS DB)`, 
         issuer,
       });
@@ -403,7 +409,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         ...this._getDefaultErrorSettings('restoreDeletedById', error, issuer),
         errorCode: 'NTS-DBS-RD0',
         additionalContent: { id },
-        message: `restoreDeleted "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+        message: `restoreDeleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
         issuer,
       });
     });
@@ -423,7 +429,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         errorCode: 'NTS-DBS-RDD0',
         additionalContent: { dependencyId },
         message: 
-          `restoreDeleted "${this.dataParams.dbName}" by ${this.depDataName} was unsuccessful ` +
+          `restoreDeleted "${this.dataParams.dataName}" by ${this.depDataName} was unsuccessful ` +
           `(NTS DB)`, 
         issuer,
       });
@@ -438,7 +444,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         throw new DyFM_Error({ 
           ...this._getDefaultErrorSettings('getDeletedData', error),
           errorCode: 'NTS-DBS-GDD0',
-          message: `get deleted "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `get deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
         });
       });
 
@@ -459,7 +465,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('deleteDataById', error),
           errorCode: 'NTS-DBS-DD0',
           additionalContent: { id },
-          message: `delete "${this.dataParams.dbName}" was unsuccessful (NTS DB)`,
+          message: `delete "${this.dataParams.dataName}" was unsuccessful (NTS DB)`,
         });
       });
   }
@@ -474,7 +480,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         ...this._getDefaultErrorSettings(
           'deleteDataByDependencyId',
           new Error(
-            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+            `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) ` +
             `(NTS DB)`
           )
         ),
@@ -490,7 +496,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           errorCode: 'NTS-DBS-DDD1',
           additionalContent: { dependencyId },
           message: 
-            `delete "${this.dataParams.dbName}" by ${this.depDataName} was unsuccessful (NTS DB)`, 
+            `delete "${this.dataParams.dataName}" by ${this.depDataName} was unsuccessful (NTS DB)`, 
         });
       });
   }
@@ -500,7 +506,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
       throw new DyFM_Error({ 
         ...this._getDefaultErrorSettings('deleteAllData', error),
         errorCode: 'NTS-DBS-DAD0',
-        message: `delete all "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+        message: `delete all "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
       });
     });
   }
@@ -525,7 +531,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings(
             'searchData',
             new Error(
-              `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dbName}) ` +
+              `dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) ` +
               `(NTS DB)`
             )
           ),
@@ -602,7 +608,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('searchData', error),
           errorCode: 'NTS-DBS-SD1',
           additionalContent: { filterBy, narrowByDependencyIds },
-          message: `search "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `search "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
         });
       });
       
@@ -653,7 +659,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('findOne', error),
           errorCode: 'NTS-DBS-FO0',
           additionalContent: { filterBy },
-          message: `findOne "${this.dataParams.dbName}" was unsuccessful (NTS DB)`,
+          message: `findOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)`,
         });
       });
 
@@ -696,7 +702,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('find', error),
           errorCode: 'NTS-DBS-F0',
           additionalContent: { filterBy },
-          message: `find "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `find "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
         });
       });
 
@@ -762,7 +768,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('findWithPaging', error),
           errorCode: 'NTS-DBS-WP0',
           additionalContent: { filterBy, page, pageSize, sort },
-          message: `findWithPaging "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `findWithPaging "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
         });
       });
 
@@ -800,7 +806,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('findByIdAndUpdate', error, issuer),
           errorCode: 'NTS-DBS-FIU0',
           additionalContent: { id, update },
-          message: `findByIdAndUpdate "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `findByIdAndUpdate "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
           issuer,
         });
       });
@@ -878,7 +884,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('updateOne', error, issuer),
           errorCode: 'NTS-DBS-UO0',
           additionalContent: { filterBy, update },
-          message: `updateOne "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `updateOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
           issuer,
         });
       });
@@ -953,7 +959,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings('updateMany', error, issuer),
           errorCode: 'NTS-DBS-UM0',
           additionalContent: { filterBy, update },
-          message: `updateMany "${this.dataParams.dbName}" was unsuccessful (NTS DB)`, 
+          message: `updateMany "${this.dataParams.dataName}" was unsuccessful (NTS DB)`, 
           issuer,
         });
       });
@@ -1045,7 +1051,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
 
     Object.values(properties).forEach((property: DyFM_DataProperty_Params<any>): void => {
       if (!property) {
-        DyFM_Log.warn(`property is undefined on ${this.dataParams.dbName} (NTS DB)`);
+        DyFM_Log.warn(`property is undefined on ${this.dataParams.dataName} (NTS DB)`);
         
         return;
       }
@@ -1055,7 +1061,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
           ...this._getDefaultErrorSettings(
             'buildMongooseSchemaByModelParams',
             new Error(
-              `property.key is undefined on ${this.dataParams.dbName} (NTS DB)` +
+              `property.key is undefined on ${this.dataParams.dataName} (NTS DB)` +
               `(keys: ${Object.keys(properties)})`
             )
           ),
@@ -1227,19 +1233,21 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
   private lookForDependencyDataSettings(): void {
     const dependencyParam: DyFM_DataProperty_Params<any> = 
       Object.values(this.dataParams.properties).find(
-        (modelParams: DyFM_DataProperty_Params<any>): boolean => modelParams.isDependencyHook
+        (modelParams: DyFM_DataProperty_Params<any>): boolean => 
+          Boolean(modelParams.dependencyDataName)
       );
     
     if (
       Object.values(this.dataParams.properties).filter(
-        (modelParams: DyFM_DataProperty_Params<any>): boolean => modelParams.isDependencyHook
+        (modelParams: DyFM_DataProperty_Params<any>): boolean => 
+          Boolean(modelParams.dependencyDataName)
       ).length > 1
     ) {
       throw new DyFM_Error({
         ...this._getDefaultErrorSettings(
           'lookForDependencyDataSettings',
           new Error(
-            `Multiple "isDependencyHook" found for this dataModel (${this.dataParams.dbName}) ` +
+            `Multiple "dependencyDataName" found for this dataModel (${this.dataParams.dataName}) ` +
             `(NTS DB)` +
             `\nSorry, but this is not supported yet! (Donate to Dynamo to get this feature!)`
           )

package/src/_services/core/api.service.spec.ts

@@ -11,9 +11,9 @@ describe('DyNTS_ApiService', () => {
   let inputParams: DyNTS_ApiCallInput_Params;
 
   beforeEach(() => {
-    callParams = {
+    callParams = new DyNTS_ApiCall_Params({
       baseUrl: 'http://example.com',
-      endPoint: '/api/test',
+      endpoint: '/api/test',
       type: DyFM_HttpCallType.get,
       httpOptions: {
         headers: {},
@@ -21,7 +21,7 @@ describe('DyNTS_ApiService', () => {
       },
       name: 'Test API Call',
       getFullResponse: false,
-    };
+    });
 
     inputParams = {
       pathParams: { id: '123' },

package/src/_services/core/api.service.ts

@@ -30,7 +30,7 @@ export interface DyNTS_ApiCallInput_Params<T_Body = any> {
  */
 export class DyNTS_ApiService {
 
-  static defaultErrorUserMsg =
+  static readonly defaultErrorUserMsg =
     `We encountered a BackEnd API Error, ` +
     `\nplease contact the responsible development team.\n` +
     `\n(Internal BE to BE error)`;
@@ -54,11 +54,27 @@ export class DyNTS_ApiService {
      */
     inputParams?: DyNTS_ApiCallInput_Params<T_Body>
   ): Promise<T_Response /* | Axios.AxiosResponse */> {
+    let url: string;
+
     try {
       let a: T_Response;
-      let url: string = callParams.baseUrl + callParams.endPoint;
+      url = callParams.baseUrl + callParams.endpoint;
       const axios = Axios.default.create();
 
+      if (callParams.pathParamKeys.length) {
+        callParams.pathParamKeys.forEach(key => {
+          if (!inputParams?.pathParams?.[key]) {
+            throw new DyFM_Error({
+              ...this._getDefaultErrorSettings(
+                'startApiCall',
+                new Error(`missing pathParam: "${key}"`)
+              ),
+              errorCode: 'NTS-API-SAC1',
+            });
+          }
+        });
+      }
+
       if (callParams?.httpOptions?.headers) {
         this.setupHeaders(callParams, axios);
       }
@@ -128,7 +144,7 @@ export class DyNTS_ApiService {
         return a as T_Response;
       } */
     } catch (error) {
-      this.handleError<T_Body>(callParams, error, inputParams);
+      this.handleError<T_Body>(callParams, error, inputParams, url);
     }
   }
 
@@ -165,15 +181,18 @@ export class DyNTS_ApiService {
        * api call's body
        */
       body?: T_Body;
-    }
+    },
+    url: string
   ): void {
-    DyFM_Log.error(
-      `\n--->   API ERROR: '${callParams?.name}' failed...` +
-      `\n${callParams?.baseUrl}${callParams?.endPoint}`
-    );
+    let msg: string = 
+      `\n--->   API ERROR: "${callParams?.name}" failed...` +
+      `\n         endpoint: ${callParams?.type} "${callParams?.baseUrl}${callParams?.endpoint}"` +
+      `\n         BE-BE requestStackLocation: "${callParams.stack}"`;
 
     if (DyNTS_global_settings.log_settings.detailedErrors) {
-      DyFM_Log.error(`\ncallParams:`, callParams);
+      DyFM_Log.error(`${msg}\ncallParams:`, callParams);
+    } else {
+      DyFM_Log.error(msg);
     }
 
     if (error && callParams?.httpOptions?.responseType === DyFM_HttpResponseType.text) {
@@ -189,8 +208,10 @@ export class DyNTS_ApiService {
           error.response.data
         ),
 
-        errorCode: 'NTS-API-SAC1',
-        message: 'API call failed on the other end! error response found...',
+        errorCode: 'NTS-API-HE1',
+        message: 
+          `API call "${callParams.name}" failed on the other end! error response found...`,
+        error: error.response.data,
         additionalContent: {
           callParams,
           inputParams,
@@ -207,7 +228,7 @@ export class DyNTS_ApiService {
         ),
 
         status: 404,
-        errorCode: 'NTS-API-SAC2',
+        errorCode: 'NTS-API-HE2',
         message: 'DNS error; address cannot be resolved!',
         additionalContent: {
           callParams,
@@ -225,11 +246,12 @@ export class DyNTS_ApiService {
         ),
 
         status: 404,
-        errorCode: 'NTS-API-SAC3',
-        message: `Can't connect to the endpoint!`,
+        errorCode: 'NTS-API-HE3',
+        message: `Can't connect to the endpoint! ${callParams.type} "${url}"`,
         additionalContent: {
           callParams,
           inputParams,
+          url,
         },
       });
 
@@ -242,7 +264,7 @@ export class DyNTS_ApiService {
         ),
 
         status: +error.message.substring(error.message.length - 4, 3),
-        errorCode: 'NTS-API-SAC4',
+        errorCode: 'NTS-API-HE4',
         additionalContent: {
           callParams,
           inputParams,

package/src/_services/core/global.service.ts

@@ -126,7 +126,10 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
           throw new DyFM_Error({
             ...this.getDefaultErrorSettings(
               'setDBServices', 
-              new Error(`dbModel is not constructed!`), 
+              new Error(
+                `dbModel is not constructed!` +
+                `\n  use new DyFM_DataModel_Params() to properly construct it.`
+              ), 
               'DyNTS_GlobalService'
             ),
             

package/src/_services/server/app.server.ts

@@ -315,19 +315,19 @@ export abstract class DyNTS_App extends DyNTS_SingletonService {
       }
 
       if (
-        DyNTS_global_settings.log_settings.highDetailedLogs ||
-        !(error instanceof DyFM_Error)
+        !DyNTS_global_settings.log_settings.highDetailedLogs &&
+        (error instanceof DyFM_Error)
       ) {
-        DyFM_Log.H_error(
-          `Application: "${this.params?.name}" start failed. (constructor asyncConstruct.catch)`,
-          `\n    ERROR:`, error
-        );
-      } else {
         error.logSimple(
           `Application: "${this.params?.name}" start failed. (constructor asyncConstruct.catch)` +
           '\n      all error messages (from this stack):\n\n"' + 
           error._messages.join('"\n\n"') + '"\n\n'
         );
+      } else if (error instanceof DyFM_Error) {
+        DyFM_Log.H_error(
+          `Application: "${this.params?.name}" start failed. (constructor asyncConstruct.catch)`,
+          `\n    ERROR:`, error
+        );
       }
     });
   }

package/src/index.ts

@@ -1,6 +1,8 @@
 
 // COLLECTIONS
+export * from './_collections/archive.util';
 export * from './_collections/global-settings.const';
+export * from './_collections/stack.util';
 
 
 // ENUMS