@futdevpro/nts-dynamo 1.9.32 → 1.9.34

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

@@ -2,7 +2,11 @@
 import * as SocketIO from 'socket.io';
 import * as Http from 'http';
 
-import { DyFM_Array, DyFM_Error, DyFM_Log, second, DyFM_wait, DyFM_AnyError } from '@futdevpro/fsm-dynamo';
+import { 
+  DyFM_Array, DyFM_Error, DyFM_Log, second, DyFM_wait, DyFM_AnyError, DyFM_Error_Settings, 
+  DyFM_ErrorLevel, 
+  DyFM_delay
+} from '@futdevpro/fsm-dynamo';
 
 import { DyNTS_App } from '../../../_services/server/app.server';
 import { DyNTS_RouteSecurity } from '../../../_enums/route-security.enum';
@@ -160,6 +164,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
 
   private async asyncConstructExt(): Promise<void> {
     if (this.fnLogs && this.deepLog) console.log('\nfn:. asyncConstruct-extended');
+
     try {
       this.systemControlsExt.appExtended.init = true;
     
@@ -186,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 (
@@ -211,127 +216,143 @@ 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');
-    await super.ready(timeout);
-
-    let ready: boolean = false;
-    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();
+
+    try {
+      await super.ready(timeout);
+
+      let ready: boolean = false;
+      const start: number = +new Date();
+
+      if (this.constructErrors.length) {
+        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 {
-            return error;
+            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.`,
-        additionalContent: this.constructErrors,
-        error: this.constructErrors?.[0] ?? new Error(),
-      });
-    }
+        }
 
-    while (!ready && +new Date() - start < timeout) {
-      if (this.systemControlsExt.appExtended.init) {
-        ready = (
-          this.superStarted &&
-          this.systemControlsExt.httpSocketServer.getReady() &&
-          this.systemControlsExt.httpsSocketServer.getReady()
-        );
-      } else {
-        DyFM_Log.error(`${this.params.name} APP NOT INITIALIZED while trying to get ready.`);
+        throw new DyFM_Error({ 
+          message: `${this.params?.name} start failed.`,
+          additionalContent: this.constructErrors,
+          error: this.constructErrors?.[0] ?? new Error(),
+        });
       }
 
-      if (!ready) {
-        await DyFM_wait(100);
+      while (!ready && +new Date() - start < timeout) {
+        if (this.systemControlsExt.appExtended.init) {
+          ready = (
+            this.superStarted &&
+            this.systemControlsExt.httpSocketServer.getIsReady() &&
+            this.systemControlsExt.httpsSocketServer.getIsReady()
+          );
+        } else {
+          DyFM_Log.error(`"${this.params.name}" APP NOT INITIALIZED while trying to get ready.`);
+        }
+
+        if (!ready) {
+          await DyFM_wait(100);
+        }
       }
-    }
 
-    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();
+      if (this.constructErrors.length) {
+        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 {
-            return error;
+            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`,
-        additionalContent: this.constructErrors,
-        error: this.constructErrors?.[0] ?? new Error(),
-      });
-    }
-
-    if (ready) {
-      this.systemControlsExt.appExtended.started = true;
-      
-      if (this.fnLogs && this.deepLog) console.log('\nfn:. ready-extended: return');
-
-      return;
-    } else {
-      this.systemControlsExt.appExtended.started = false;
-      
-      let msg: string = `${this.params?.name} start failed. UNKNOWN`;
+        }
 
-      if (
-        this.systemControlsExt.httpSocketServer.init && 
-        !this.systemControlsExt.httpSocketServer.started
-      ) {
-        msg += '\nhttpSocketServer start failed.';
+        throw new DyFM_Error({ 
+          message: `${this.params?.name} start failed. TIMEOUT`,
+          additionalContent: this.constructErrors,
+          error: this.constructErrors?.[0] ?? new Error(),
+        });
       }
 
-      if (
-        this.systemControlsExt.httpsSocketServer.init && 
-        !this.systemControlsExt.httpsSocketServer.started
-      ) {
-        msg += '\nhttpsSocketServer start failed.';
-      }      
+      if (ready) {
+        this.systemControlsExt.appExtended.started = true;
+        
+        if (this.fnLogs && this.deepLog) console.log('\nfn:. ready-extended: return');
 
-      DyFM_Log.error(msg, this.constructErrors, '\n');
+        return;
+      } else {
+        this.systemControlsExt.appExtended.started = false;
+        
+        let msg: string = `${this.params?.name} start failed. UNKNOWN`;
+
+        if (
+          this.systemControlsExt.httpSocketServer.init && 
+          !this.systemControlsExt.httpSocketServer.started
+        ) {
+          msg += '\nhttpSocketServer start failed.';
+        }
 
-      throw new DyFM_Error({ 
-        errorCode: 'NTS-AES-110',
-        message: msg,
-        additionalContent: {
-          constructErrors: this.constructErrors,
-          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(),
+        if (
+          this.systemControlsExt.httpsSocketServer.init && 
+          !this.systemControlsExt.httpsSocketServer.started
+        ) {
+          msg += '\nhttpsSocketServer start failed.';
+        }      
+
+        DyFM_Log.error(msg, this.constructErrors, '\n');
+
+        throw new DyFM_Error({ 
+          errorCode: 'NTS-AES-110',
+          message: msg,
+          additionalContent: {
+            constructErrors: this.constructErrors,
+            systemControls: this.systemControls,
+            systemControlsExt: this.systemControlsExt,
+            systemReadies: {
+              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(),
+          error: this.constructErrors?.[0] ?? new Error(),
+        });
+      }
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this.__getDefaultErrorSettings('ready', error),
+        
+        errorCode: 'NTS-AES-111',
+        error: error,
       });
     }
   }
@@ -339,37 +360,47 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
   override async stop(): Promise<void> {
     if (this.fnLogs) console.log('\nfn:. stop-extended');
     
-    if (this.started) {
-      await super.stop(true);
-
-      this.systemControlsExt.httpSocketServer.started = false;
-      this.systemControlsExt.httpsSocketServer.started = false;
-      await DyFM_Array.asyncForEach(
-        this.allSocketServers, 
-        async (socketServer: SocketIO.Server): Promise<void> => {
-          await new Promise<void>((resolve, reject): void => {
-            socketServer.disconnectSockets(true);
-            socketServer.close((err): void => {
-              if (err) {
-                DyFM_Log.error(`\nHTTP socket server close error`, err);
-                reject(
-                  new DyFM_Error({
-                    errorCode: 'NTS-AES-120',
-                    message: `SocketServer close failed.`,
-                    error: err,
-                  })
-                );
-              } else {
-                resolve();
-              }
+    try {
+      if (this.started) {
+        await super.stop(true);
+
+        this.systemControlsExt.httpSocketServer.started = false;
+        this.systemControlsExt.httpsSocketServer.started = false;
+        await DyFM_Array.asyncForEach(
+          this.allSocketServers, 
+          async (socketServer: SocketIO.Server): Promise<void> => {
+            await new Promise<void>((resolve, reject): void => {
+              socketServer.disconnectSockets(true);
+              socketServer.close((err): void => {
+                if (err) {
+                  DyFM_Log.error(`\nHTTP socket server close error`, err);
+                  reject(
+                    new DyFM_Error({
+                      errorCode: 'NTS-AES-120',
+                      message: `SocketServer close failed.`,
+                      error: err,
+                    })
+                  );
+                } else {
+                  resolve();
+                }
+              });
             });
-          });
-        }
-      );
-      this.systemControlsExt.httpSocketServer.init = false;
-      this.systemControlsExt.httpsSocketServer.init = false;
+          }
+        );
+        this.systemControlsExt.httpSocketServer.init = false;
+        this.systemControlsExt.httpsSocketServer.init = false;
+        
+        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({
+        ...this.__getDefaultErrorSettings('stop', error),
+        
+        errorCode: 'NTS-AES-121',
+      });
     }
   }
 
@@ -378,6 +409,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
    */
   private setSocketSecurity(): void {
     if (this.fnLogs) console.log('\nfn:. setSocketSecurity');
+
     this.socketServices.forEach((service: DyNTS_SocketServerService<any>): void => {
       if (!this.socketSecurity) {
         this.socketSecurity = DyNTS_RouteSecurity[service.security];
@@ -457,7 +489,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
               this.portSettings.httpsPort === service.port
             ) {
               const error = new Error(`PORT DUPLICATION: ${service.port}`);
-              const errorStack: string[] = error.stack.split('\n');
+              const errorStack: string[] = error.stack?.split('\n');
 
               errorStack.splice(1, 4);
               error.stack = errorStack.join('\n');
@@ -513,7 +545,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
               const error = new Error(
                 `INVALID Socket Service security: ${service.security} on ${service?.name}`
               );
-              const errorStack: string[] = error.stack.split('\n');
+              const errorStack: string[] = error.stack?.split('\n');
 
               errorStack.splice(1, 4);
               error.stack = errorStack.join('\n');
@@ -548,4 +580,19 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
    * MISSING Description (TODO)
    */
   abstract getSocketServices(): DyNTS_SocketServerService<any>[];
+    
+  private __getDefaultErrorSettings(
+    fnName: string, 
+    error: DyFM_AnyError
+  ): DyFM_Error_Settings {
+    return {
+      status: (error as DyFM_Error)?.___status ?? 500,
+      message: (error as Error)?.message ?? `${fnName} was UNSUCCESSFUL (NTS)`,
+      userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
+      addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
+      issuerService: `${this?.constructor?.name}-DyNTS_AppExtended`,
+      level: DyFM_ErrorLevel.fatal,
+      error: 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
             ),
 
@@ -171,7 +166,7 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
           });
         }
 
-        content = this.compileTemplateComponent(
+        content = await this.compileTemplateComponent(
           set.templateComponentName, 
           set.templateProperties, 
           issuer
@@ -217,11 +212,11 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
     }
   }
 
-  private compileTemplateComponent<T>(
+  private async compileTemplateComponent<T>(
     componentName: string, 
     componentProperties:T, 
     issuer: string
-  ): string {
+  ): Promise<string> {
     try {
       if (!this.componentsByName[componentName]) {
         throw new DyFM_Error({
@@ -233,7 +228,7 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
 
           errorCode: 'NTS-ES0-SC1',
           additionalContent: {
-            availableComponenets: Object.keys(this.componentsByName),
+            availableComponents: Object.keys(this.componentsByName),
           },
         });
       }
@@ -242,20 +237,23 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
       let template: string = this.compileHTMLMainFrame(component);
 
       template = template.replace('<nts-content>', '');
-      template = this.compileComponentProperties<T>(
+      template = await this.compileComponentProperties<T>(
         component, 
         componentProperties, 
         template, 
         issuer
       );
 
-      component.subComponentSelectors.forEach((subComponentSelector: string): void => {
-        while (template.includes(`<nts-${subComponentSelector}`)) {
-          template = this.compileSubComponent<T>(
-            subComponentSelector, componentProperties, template, issuer
-          );
+      await DyFM_Array.asyncForEach(
+        component.subComponentSelectors,
+        async (subComponentSelector: string): Promise<void> => {
+          while (template.includes(`<nts-${subComponentSelector}`)) {
+            template = await this.compileSubComponent<T>(
+              subComponentSelector, componentProperties, template, issuer
+            );
+          }
         }
-      });
+      );
 
       template = this.templateTrim(template);
       
@@ -325,9 +323,9 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
 
   /** trims all rows and remove everything between /*...*\/  */
   private styleTrim(style: string): string {
-    let result: string = style.split('\n').map((row: string): string => row.trim()).join('');
+    let result: string = style?.split('\n').map((row: string): string => row.trim()).join('');
 
-    while (result.includes('/*')) {
+    while (result?.includes('/*')) {
       const start = result.indexOf('/*');
       const end = result.indexOf('*/', start) + 2;
 
@@ -358,44 +356,53 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
     return b / 1024;
   }
 
-  private compileComponentProperties<T>(
+  private async compileComponentProperties<T>(
     component: DyNTS_EmailTemplateComponent, 
     componentProperties: T, 
     template: string, 
     issuer: string
-  ): string {
-    component.properties.forEach((propertyKey: string): void => {
-      if (!componentProperties[propertyKey]) {
-        throw new DyFM_Error({
-          ...this._getDefaultErrorSettings(
-            'setupComponent',
-            new Error(
-              `ComponentProperty missing from input! '${propertyKey}' for ${component.name}`
+  ): Promise<string> {
+    try {
+      component.properties.forEach((propertyKey: string): void => {
+        if (!componentProperties[propertyKey]) {
+          throw new DyFM_Error({
+            ...this._getDefaultErrorSettings(
+              'setupComponent',
+              new Error(
+                `ComponentProperty missing from input! '${propertyKey}' for ${component.name}`
+              ),
+              issuer
             ),
-            issuer
-          ),
 
-          errorCode: 'NTS-ES0-SC4',
-          additionalContent: {
-            componentProperties: Object.keys(componentProperties),
-          },
-        });
-      }
+            errorCode: 'NTS-ES0-SC4',
+            additionalContent: {
+              componentProperties: Object.keys(componentProperties),
+            },
+          });
+        }
 
-      const propReg = new RegExp(`{{${propertyKey}}}`, 'g');
+        const propReg = new RegExp(`{{${propertyKey}}}`, 'g');
 
-      template = template.replace(propReg, componentProperties[propertyKey]);
-    });
+        template = template.replace(propReg, componentProperties[propertyKey]);
+      });
 
-    return template;
+      return template;
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this._getDefaultErrorSettings('setupComponent', error, issuer),
+
+        errorCode: 'NTS-ES0-SC3',
+      });
+    }
   }
 
-  private compileSubComponent<T>(
+  private async compileSubComponent<T>(
     subComponentSelector: string, 
     componentProperties: T,
     template: string,
     issuer: string
-  ): string {
+  ): Promise<string> {
+
     const subComponent: DyNTS_EmailTemplateComponent = 
       this.componentsBySelector[subComponentSelector];
 
@@ -428,7 +435,7 @@ export class DyNTS_EmailService /* extends DyNTS_SingletonService */ {
     const contentReg = new RegExp(`<nts-content>`, 'g');
 
     subComponentTemplate = subComponentTemplate.replace(contentReg, componentContent);
-    subComponentTemplate = this.compileComponentProperties<T>(
+    subComponentTemplate = await this.compileComponentProperties<T>(
       subComponent, 
       componentProperties, 
       subComponentTemplate, 
@@ -458,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,
+          },
         });
       }