@futdevpro/nts-dynamo 1.9.33 → 1.9.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.09.33",
+  "version": "01.09.34",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "scripts": {
     "prep": "npm i rimraf nodemon -g",

package/src/_models/control-models/system-control.control-model.ts

@@ -5,7 +5,7 @@ export class DyNTS_SystemControl {
   init: boolean = false;
   started: boolean = false;
 
-  getReady(): boolean {
+  getIsReady(): boolean {
     return this.init ? this.started : true;
   }
 }

package/src/_modules/socket/_services/app-extended.server.spec.ts

@@ -1,4 +1,4 @@
-import { DyFM_delay } from '@futdevpro/fsm-dynamo';
+import { DyFM_delay, DyFM_Error, DyFM_Log } from '@futdevpro/fsm-dynamo';
 import { 
   DyNTS_AppExtendedBase_Mock, DyNTS_AppExtendedFull_Mock, DyNTS_AppWbMock_Mock 
 } from '../../mock/app-extended-server.mock';
@@ -8,17 +8,29 @@ describe('DyNTS_AppExtended;', (): void => {
     let app: DyNTS_AppExtendedBase_Mock;
 
     beforeEach(async (): Promise<void> => {
-      app = new DyNTS_AppExtendedBase_Mock();
+      try {
+        app = new DyNTS_AppExtendedBase_Mock();
 
-      await DyFM_delay(100);
-      
-      await app.ready();
+        await DyFM_delay(100);
+        
+        await app.ready();
+
+        await DyFM_delay(100);
+      } catch (error) {
+        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     afterEach(async (): Promise<void> => {
-      await app.stop();
-
-      await DyFM_delay(100);
+      try {
+        await DyFM_delay(100);
+        
+        await app.stop();
+
+        app = null;
+      } catch (error) {
+        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     it('should be created', (): void => {
@@ -34,17 +46,29 @@ describe('DyNTS_AppExtended;', (): void => {
     let app: DyNTS_AppExtendedFull_Mock;
 
     beforeEach(async (): Promise<void> => {
-      app = new DyNTS_AppExtendedFull_Mock();
+      try {
+        app = new DyNTS_AppExtendedFull_Mock();
 
-      await DyFM_delay(100);
-      
-      await app.ready();
+        await DyFM_delay(100);
+        
+        await app.ready();
+
+        await DyFM_delay(100);
+      } catch (error) {
+        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     afterEach(async (): Promise<void> => {
-      await app.stop();
-
-      await DyFM_delay(100);
+      try {
+        await DyFM_delay(100);
+        
+        await app.stop();
+
+        app = null;
+      } catch (error) {
+        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     it('should be created', (): void => {
@@ -60,14 +84,29 @@ describe('DyNTS_AppExtended;', (): void => {
     let app: DyNTS_AppWbMock_Mock;
 
     beforeEach(async (): Promise<void> => {
-      app = new DyNTS_AppWbMock_Mock();
-      await app.ready();
+      try {
+        app = new DyNTS_AppWbMock_Mock();
+
+        await DyFM_delay(100);
+        
+        await app.ready();
+
+        await DyFM_delay(100);
+      } catch (error) {
+        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     afterEach(async (): Promise<void> => {
-      await app.stop();
-
-      await DyFM_delay(100);
+      try {
+        await DyFM_delay(100);
+        
+        await app.stop();
+
+        app = null;
+      } catch (error) {
+        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     it('should be created', (): void => {

package/src/_modules/socket/_services/app-extended.server.ts

@@ -191,7 +191,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
         console.log(this.params.title);
         console.log(`Version: ${this.params.version}`);
       }
-      DyFM_Log.H_success(`${this.params.name} started successfully.`);
+      DyFM_Log.H_success(`"${this.params.name}" started successfully.`);
       
     } catch (error) {
       if (
@@ -216,20 +216,20 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
           systemControls: this.systemControls,
           systemControlsExt: this.systemControlsExt,
           systemReadies: {
-            app: this.systemControls.app.getReady(),
-            appExtended: this.systemControlsExt.appExtended.getReady(),
-            mongoose: this.systemControls.mongoose.getReady(),
-            httpServer: this.systemControls.httpServer.getReady(),
-            httpsServer: this.systemControls.httpsServer.getReady(),
-            httpSocketServer: this.systemControlsExt.httpSocketServer.getReady(),
-            httpsSocketServer: this.systemControlsExt.httpsSocketServer.getReady(),
+            app: this.systemControls.app.getIsReady(),
+            appExtended: this.systemControlsExt.appExtended.getIsReady(),
+            mongoose: this.systemControls.mongoose.getIsReady(),
+            httpServer: this.systemControls.httpServer.getIsReady(),
+            httpsServer: this.systemControls.httpsServer.getIsReady(),
+            httpSocketServer: this.systemControlsExt.httpSocketServer.getIsReady(),
+            httpsSocketServer: this.systemControlsExt.httpsSocketServer.getIsReady(),
           },
         },
       });
     }
   }
 
-  override async ready(timeout: number = 4 * second): Promise<void> {
+  override async ready(timeout: number = this.defaultReadyTimeout): Promise<void> {
     if (this.fnLogs) console.log('\nfn:. ready-extended');
 
     try {
@@ -239,17 +239,21 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
       const start: number = +new Date();
 
       if (this.constructErrors.length) {
-        DyFM_Log.H_error(
-          `Extended Application: ${this.params?.name} start failed. (ready constructErrors check)`,
-          `\n    construct ERRORS:\n`, 
-          this.constructErrors.map((error: any): any => {
-            if (error instanceof DyFM_Error) {
-              return error.getErrorSimplified();
-            } else {
-              return error;
-            }
-          }), 
-        );
+        if (this.deepLog) {
+          if (DyNTS_global_settings.log_settings.highDetailedLogs) {
+            DyFM_Log.H_error(
+              `Extended Application: "${this.params.name}" start failed. ` +
+              `(ready; constructErrors check +1)`,
+              `\n    construct ERRORS:`, this.constructErrors
+            );
+          } else {
+            DyFM_Log.H_error(
+              `Extended Application: "${this.params.name}" start failed. ` +
+              `(ready; constructErrors check +1)`,
+              `\n    construct ERRORS:`, this.getSimplifiedConstructErrors(),
+            );
+          }
+        }
 
         throw new DyFM_Error({ 
           message: `${this.params?.name} start failed.`,
@@ -262,11 +266,11 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
         if (this.systemControlsExt.appExtended.init) {
           ready = (
             this.superStarted &&
-            this.systemControlsExt.httpSocketServer.getReady() &&
-            this.systemControlsExt.httpsSocketServer.getReady()
+            this.systemControlsExt.httpSocketServer.getIsReady() &&
+            this.systemControlsExt.httpsSocketServer.getIsReady()
           );
         } else {
-          DyFM_Log.error(`${this.params.name} APP NOT INITIALIZED while trying to get ready.`);
+          DyFM_Log.error(`"${this.params.name}" APP NOT INITIALIZED while trying to get ready.`);
         }
 
         if (!ready) {
@@ -275,17 +279,19 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
       }
 
       if (this.constructErrors.length) {
-        DyFM_Log.H_error(
-          `Extended Application: ${this.params?.name} start failed. (ready TIMEOUT check)`, 
-          `\n    construct ERRORS:\n`, 
-          this.constructErrors.map((error: any): any => {
-            if (error instanceof DyFM_Error) {
-              return error.getErrorSimplified();
-            } else {
-              return error;
-            }
-          }), 
-        );
+        if (this.deepLog) {
+          if (DyNTS_global_settings.log_settings.highDetailedLogs) {
+            DyFM_Log.H_error(
+              `Extended Application: "${this.params.name}" start failed. (ready; TIMEOUT check +2)`,
+              `\n    construct ERRORS:`, this.constructErrors
+            );
+          } else {
+            DyFM_Log.H_error(
+              `Extended Application: "${this.params.name}" start failed. (ready; TIMEOUT check +2)`,
+              `\n    construct ERRORS:`, this.getSimplifiedConstructErrors(),
+            );
+          }
+        }
 
         throw new DyFM_Error({ 
           message: `${this.params?.name} start failed. TIMEOUT`,
@@ -329,13 +335,13 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
             systemControls: this.systemControls,
             systemControlsExt: this.systemControlsExt,
             systemReadies: {
-              app: this.systemControls.app.getReady(),
-              appExtended: this.systemControlsExt.appExtended.getReady(),
-              mongoose: this.systemControls.mongoose.getReady(),
-              httpServer: this.systemControls.httpServer.getReady(),
-              httpsServer: this.systemControls.httpsServer.getReady(),
-              httpSocketServer: this.systemControlsExt.httpSocketServer.getReady(),
-              httpsSocketServer: this.systemControlsExt.httpsSocketServer.getReady(),
+              app: this.systemControls.app.getIsReady(),
+              appExtended: this.systemControlsExt.appExtended.getIsReady(),
+              mongoose: this.systemControls.mongoose.getIsReady(),
+              httpServer: this.systemControls.httpServer.getIsReady(),
+              httpsServer: this.systemControls.httpsServer.getIsReady(),
+              httpSocketServer: this.systemControlsExt.httpSocketServer.getIsReady(),
+              httpsSocketServer: this.systemControlsExt.httpsSocketServer.getIsReady(),
             },
           },
           error: this.constructErrors?.[0] ?? new Error(),
@@ -387,7 +393,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
         
         await DyFM_delay(100);
 
-        DyFM_Log.H_info(`${this.params.name} stopped successfully.`);
+        DyFM_Log.H_info(`"${this.params.name}" stopped successfully.`);
       }
     } catch (error) {
       throw new DyFM_Error({

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

@@ -118,9 +118,6 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
         ...this._getDefaultErrorSettings('asyncPostConstruct', error, 'SYSTEM'),
 
         errorCode: 'NTS-ES0-APC0',
-        message: 
-        `\nDynamoBEEmailService ERROR, ` +
-        `\nThe emailService construction failed for ${this.serviceName}.`, 
       });
     }
   }
@@ -144,9 +141,7 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
           throw new DyFM_Error({ 
             ...this._getDefaultErrorSettings(
               'sendEmail',
-              new Error(
-                `No email template component is given!`
-              ),
+              new Error(`No email template component is given!`),
               issuer
             ),
 
@@ -470,20 +465,23 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
   private async loadComponent(component: DyNTS_EmailTemplateComponent): Promise<void> {
     try {
       if (this.componentsBySelector[component.selector]) {
-        throw new DyFM_Error({
-          ...this._getDefaultErrorSettings('loadComponent', new Error(), 'SYSTEM'),
-
-          errorCode: 'NTS-ES0-LC1',
-          message: `Template already loaded! (${component.name})`,
-        });
+        DyFM_Log.warn('Email component already loaded! (it will be skipped)', component.selector);
+        
+        return;
       }
 
       if (!component.templatePath && !component.template) {
         throw new DyFM_Error({
-          ...this._getDefaultErrorSettings('loadComponent', new Error(), 'SYSTEM'),
+          ...this._getDefaultErrorSettings(
+            'loadComponent', 
+            new Error(`Component missing template and templatePath! (${component.name})`), 
+            'SYSTEM'
+          ),
 
           errorCode: 'NTS-ES0-LC2',
-          message: `Component missing template and templatePath! (${component.name})`,
+          additionalContent: {
+            component: component,
+          },
         });
       }
 

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

@@ -4,7 +4,9 @@ import { Request, Response } from 'express';
 
 import { 
   DyFM_Metadata, DyFM_DataModel_Params, DyFM_Log, DyFM_Error, DyFM_Array, 
-  DyFM_errorFlag
+  DyFM_errorFlag,
+  DyFM_AnyError,
+  DyFM_Error_Settings
 } from '@futdevpro/fsm-dynamo';
 import { DyNTS_App_Params } from '../../_models/control-models/app-params.control-model';
 
@@ -49,13 +51,12 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
   authService: DyNTS_AuthService;
   dbServiceCollection: DyNTS_Service_Collection<DyNTS_DBService<any>>;
   emailServiceCollection: DyNTS_Service_Collection<DyNTS_EmailService>; 
+  
+  static readonly defaultErrorUserMsg: string = 
+    `We encountered an unhandled Control Service Error, ` +
+    `\nplease contact the responsible development team.`; 
 
-  static globalErrorHandler?: (
-    err: any, 
-    req?: Request, 
-    res?: Response, 
-    issuer?: string
-  ) => Promise<void>;
+  static globalErrorHandler?: DyNTS_GlobalErrorHandlerFn;
     
   /**
    * You need to setup global Services through this function
@@ -73,8 +74,8 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
       await this.setErrorHandler(set?.errorHandler);
     } catch (error) {
       throw new DyFM_Error({
-        message: `Failed to setServices on DyNTS_GlobalService.`,
-        error: error,
+        ...this.getDefaultErrorSettings('setServices', error, 'DyNTS_GlobalService'),
+
         errorCode: 'NTS-GS0-SS0',
       });
     }
@@ -86,8 +87,12 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
       dbModels?.forEach((dbModel: DyFM_DataModel_Params): void => {
         if (!dbModel.constructed) {
           throw new DyFM_Error({
-            message: `DyNTS_GlobalService.setServices failed, ` +
-              `ERROR: dbModel is not constructed!`,
+            ...this.getDefaultErrorSettings(
+              'setDBServices', 
+              new Error(`dbModel is not constructed!`), 
+              'DyNTS_GlobalService'
+            ),
+            
             errorCode: 'NTS-GS0-SDBS1',
             additionalContent: {
               dbModel: dbModel,
@@ -101,9 +106,8 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
           DyFM_Log.error(`Failed to create DyNTS_DBService (${dbModel.dataName}).`, error);
           
           throw new DyFM_Error({
-            message: `Failed to create DyNTS_DBService (${dbModel.dataName}).`, 
-            issuerService: 'DyNTS_GlobalService',
-            error: error,
+            ...this.getDefaultErrorSettings('setDBServices', error, 'DyNTS_GlobalService'),
+
             additionalContent: {
               dbModel: dbModel,
             },
@@ -112,8 +116,8 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
       });
     } catch (error) {
       throw new DyFM_Error({
-        message: `Failed to set dbServiceCollections on DyNTS_GlobalService.`,
-        error: error,
+        ...this.getDefaultErrorSettings('setDBServices', error, 'DyNTS_GlobalService'),
+        
         errorCode: 'NTS-GS0-SDBS0',
       });
     }
@@ -128,8 +132,8 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
       }
     } catch (error) {
       throw new DyFM_Error({
-        message: `Failed to set authService on DyNTS_GlobalService.`,
-        error: error,
+        ...this.getDefaultErrorSettings('setAuthService', error, 'DyNTS_GlobalService'),
+        
         errorCode: 'NTS-GS0-SAS0',
       });
     }
@@ -150,8 +154,8 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
       );
     } catch (error) {
       throw new DyFM_Error({
-        message: `Failed to set emailServiceCollections on DyNTS_GlobalService.`,
-        error: error,
+        ...this.getDefaultErrorSettings('setEmailServices', error, 'DyNTS_GlobalService'),
+        
         errorCode: 'NTS-GS0-SS4',
       });
     }
@@ -190,8 +194,8 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
         });
     } catch (error) {
       throw new DyFM_Error({
-        message: `Failed to set errorHandler on DyNTS_GlobalService.`,
-        error: error,
+        ...this.getDefaultErrorSettings('setErrorHandler', error, 'DyNTS_GlobalService'),
+        
         errorCode: 'NTS-GS0-SEH0',
       });
     }
@@ -338,4 +342,21 @@ export class DyNTS_GlobalService extends DyNTS_SingletonService {
                 ${names}\n`);
     }
   } */
+
+  protected static getDefaultErrorSettings(
+    fnName: string, 
+    error: DyFM_AnyError,
+    issuer: string
+  ): DyFM_Error_Settings {
+    return {
+      status: (error as DyFM_Error)?.___status ?? 500,
+      message: (error as Error)?.message ?? 
+        `${fnName} was UNSUCCESSFUL (${DyNTS_global_settings.systemShortCodeName})`,
+      addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
+      userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
+      issuer: issuer,
+      issuerService: this.constructor?.name,
+      error: error,
+    };
+  }
 }

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

@@ -1,5 +1,5 @@
 
-import { DyFM_Log, DyFM_delay } from '@futdevpro/fsm-dynamo';
+import { DyFM_Error, DyFM_Log, DyFM_delay } from '@futdevpro/fsm-dynamo';
 import { DyNTS_AppBase_Mock, DyNTS_AppFull_Mock } from '../../_modules/mock/app-server.mock';
 
 describe('DyNTS_App AND DyNTS_AppExtended?;', (): void => {
@@ -15,15 +15,23 @@ describe('DyNTS_App AND DyNTS_AppExtended?;', (): void => {
         await DyFM_delay(100);
         
         await app.ready();
+
+        await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('error', error);
+        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
       }
     });
 
     afterEach(async (): Promise<void> => {
-      await app.stop();
+      try {
+        await DyFM_delay(100);
+        
+        await app.stop();
 
-      await DyFM_delay(100);
+        app = null;
+      } catch (error) {
+        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     it('should be created', (): void => {
@@ -41,16 +49,27 @@ describe('DyNTS_App AND DyNTS_AppExtended?;', (): void => {
     beforeEach(async (): Promise<void> => {
       try {
         app = new DyNTS_AppFull_Mock();
+
+        await DyFM_delay(100);
+        
         await app.ready();
+
+        await DyFM_delay(100);
       } catch (error) {
-        DyFM_Log.test('error', error);
+        DyFM_Log.test('test beforeEach error:', (error as DyFM_Error)?._message);
       }
     });
 
     afterEach(async (): Promise<void> => {
-      await app.stop();
+      try {
+        await DyFM_delay(100);
+        
+        await app.stop();
 
-      await DyFM_delay(100);
+        app = null;
+      } catch (error) {
+        DyFM_Log.test('test afterEach error:', (error as DyFM_Error)?._message);
+      }
     });
 
     it('should be created', (): void => {