@futdevpro/nts-dynamo 1.9.15 → 1.9.17

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

@@ -1,520 +1,520 @@
-
-import * as SocketIO from 'socket.io';
-import * as Http from 'http';
-
-import { DynamoFM_Array, DynamoFM_Error, DynamoFM_Log, second, DynamoFM_wait } from '@futdevpro/fsm-dynamo';
-
-import { DynamoNTS_App } from './app.server';
-import { DynamoNTS_RouteSecurity } from '../../_enums/route-security.enum';
-import { DynamoNTS_SocketServerService } from '../socket/socket-server.service';
-import { DynamoNTS_SocketSecurity } from '../../_enums/socket-security.enum';
-import { 
-  DynamoNTS_AppExtSysControls 
-} from '../../_models/control-models/app-ext-system-controls.control-model';
-
-/**
- * This will be the MAIN service of our server project,
- * follow the types and type instructions while setting up your project
- * 
- * In this service, there are abstract functions that you will need to implement,
- * where you need to set up the main params for your application.
- * 
- * The extended App is containing socket server tools
- * 
- * You need to add socketService definitions to setupRoutingModules
- * 
- * @example
- * export class App extends DynamoNTS_AppExtended {
- *   
- *   ...
- *   
- * // Setting up App params, and preparing project global settings
- *   setupAppParams(): void {
- *     this.params = new DynamoNTS_AppParams({
- *       name: 'Warbots Server',
- *       title: warbotsTitleLog,
- *       version: version,
- *       dbName: 'warbots',
- *     });
- *  
- *     // dynamoNTS_GlobalSettings.logRequestsContent = false;
- *   }
- *   
- *   ...
- * 
- *   // Setting up DBServices
- *   setGlobalServiceCollection(): void {
- *     DynamoNTS_GlobalService.setServices({
- *       authService: AuthService.getInstance(),
- *       emailServiceCollection: EmailServiceCollectionService.getInstance(),
- *       dbModels: [
- *         userModelParams,
- *         userDataModelParams,
- *         userOptionsModelParams,
- *         userStatisticsModelParams,
- *         userAchievementsModelParams,
- *         userNotificationsModelParams,
- *         
- *         matchStatisticsModelParams,
- *         matchDataModelParams,
-
- *         DynamoFM_usageSessionModel_params,
- *         DynamoFM_customDataModel_params,
- *       ]
- *     });
- *   }
- *   
- *   ...
- *   
- *   // Setting up Routes
- *   setupRoutingModules(): void {
- *     this.httpPort = env.port;
-
- *     this.routingModules = [
- *       new DynamoNTS_RoutingModule({
- *         route: '/user',
- *         controllers: [ 
- *           UserController.getInstance(),
- *           UserDataController.getInstance(),
- *           UserOptionsController.getInstance(),
- *           UserStatisticsController.getInstance(),
- *           UserAchievementsController.getInstance(),
- *           UserNotificationsController.getInstance()
- *         ]
- *       }),
- *       new DynamoNTS_RoutingModule({
- *         route: '/match',
- *         controllers: [ 
- *           MatchController.getInstance(),
- *           MatchDistributionController.getInstance(),
- *           MatchStatisticsController.getInstance(),
- *         ]
- *       }),
- *       new DynamoNTS_RoutingModule({
- *         route: '/server',
- *         controllers: [ 
- *           ServerController.getInstance(),
- *         ]
- *       }),
-
- *       getTestRoutingModule(),
- *       getUsageRoutingModule()
- *     ];
- * 
- *     ...
- *   
- *     // Setting up Sockets
- *     this.socketServices = [
- *       NotificationService.getInstance(),
- *       ChatService.getInstance(),
- *       ...
- *     ];
- *   }
- * }
- */
-export abstract class DynamoNTS_AppExtended extends DynamoNTS_App {
-  
-  private systemControlsExt: DynamoNTS_AppExtSysControls = new DynamoNTS_AppExtSysControls();
-  override get started(): boolean { return this.systemControlsExt.appExtended.started; }
-  private httpsSocketSettingUpCount: number = 0;
-  private httpSocketSettingUpCount: number = 0;
-
-  private socketSecurity: DynamoNTS_RouteSecurity;
-
-  private httpSocketServer: Http.Server;
-  
-  /**
-   * @example
-   * // Setting up Sockets
-   * this.socketServices = [
-   *   NotificationService.getInstance(),
-   *   ChatService.getInstance(),
-   *   ...
-   * ];
-   */
-  protected socketServices: DynamoNTS_SocketServerService<any>[];
-  private allSocketServers: SocketIO.Server[] = [];
-
-  constructor(){
-    super(true);
-
-    this.asyncConstructExt().catch((error: any): void => {
-      DynamoFM_Log.H_error(
-        `\nExtended Application: ${this.params?.name} start failed.` +
-        `\n`, error, 
-        '\n'
-      );
-    });
-  }
-
-  private async asyncConstructExt(): Promise<void> {
-    if (this.logFn && this.deepLog) console.log('\nfn:. asyncConstruct-extended');
-    try {
-      this.systemControlsExt.appExtended.init = true;
-    
-      this.socketServices = this.getSocketServices();
-
-      if (this.socketServices?.length) {
-        this.setSocketSecurity();
-
-        await this.setupSocketServerServices();
-
-        if (this.logSetup) console.log(
-          `\nAll sockets setted up.... sockets using security: ${this.socketSecurity}`
-        );
-      } else {
-        DynamoFM_Log.testWarn(
-          'No socketServices setted up while using Extended Application.',
-          '\nYou should use DynamoNTS_App if you don`t need socket services.' 
-        );
-      }
-
-      await this.ready();
-            
-      if (this.params.title) {
-        console.log(this.params.title);
-        console.log(`Version: ${this.params.version}`);
-      }
-      DynamoFM_Log.H_success(`${this.params.name} started successfully.`);
-      
-    } catch (error) {
-      DynamoFM_Log.H_error(
-        `\nExtended Application: ${this.params?.name} start failed.` +
-        `\n`, error,
-        '\n'
-      );
-
-      throw new DynamoFM_Error({
-        errorCode: 'NTS-AES-001',
-        error: error,
-        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(),
-          },
-        },
-      });
-    }
-  }
-
-  override async ready(timeout: number = 4 * second): Promise<void> {
-    if (this.logFn) console.log('\nfn:. ready-extended');
-    await super.ready(timeout);
-
-    let ready: boolean = false;
-    const start: number = +new Date();
-
-    if (this.constructErrors.length) {
-      DynamoFM_Log.H_error(
-        `Extended Application: ${this.params?.name} start failed. ERRORS`, 
-        this.constructErrors, 
-        '\n'
-      );
-
-      throw new DynamoFM_Error({ 
-        message: `${this.params?.name} start failed. ERRORS`,
-        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 {
-        DynamoFM_Log.error(`${this.params.name} APP NOT INITIALIZED while trying to get ready.`);
-      }
-
-      if (!ready) {
-        await DynamoFM_wait(100);
-      }
-    }
-
-    if (this.constructErrors.length) {
-      DynamoFM_Log.H_error(
-        `Extended Application: ${this.params?.name} start failed. TIMEOUT`, 
-        this.constructErrors, 
-        '\n'
-      );
-
-      throw new DynamoFM_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.logFn && 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.';
-      }
-
-      if (
-        this.systemControlsExt.httpsSocketServer.init && 
-        !this.systemControlsExt.httpsSocketServer.started
-      ) {
-        msg += '\nhttpsSocketServer start failed.';
-      }      
-
-      DynamoFM_Log.error(msg, this.constructErrors, '\n');
-
-      throw new DynamoFM_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(),
-          },
-        },
-        error: this.constructErrors?.[0] ?? new Error()
-      });
-    }
-  }
-
-  override async stop(): Promise<void> {
-    if (this.logFn) console.log('\nfn:. stop-extended');
-    
-    if (this.started) {
-      await super.stop(true);
-
-      this.systemControlsExt.httpSocketServer.started = false;
-      this.systemControlsExt.httpsSocketServer.started = false;
-      await DynamoFM_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) {
-                DynamoFM_Log.error(`\nHTTP socket server close error`, err);
-                reject(
-                  new DynamoFM_Error({
-                    errorCode: 'NTS-AES-120',
-                    message: `SocketServer close failed.`,
-                    error: err
-                  })
-                );
-              } else {
-                resolve();
-              }
-            });
-          });
-        }
-      );
-      this.systemControlsExt.httpSocketServer.init = false;
-      this.systemControlsExt.httpsSocketServer.init = false;
-
-      DynamoFM_Log.H_info(`${this.params.name} stopped successfully.`);
-    }
-  }
-
-  /**
-   * 
-   */
-  private setSocketSecurity(): void {
-    if (this.logFn) console.log('\nfn:. setSocketSecurity');
-    this.socketServices.forEach((service: DynamoNTS_SocketServerService<any>): void => {
-      if (!this.socketSecurity) {
-        this.socketSecurity = DynamoNTS_RouteSecurity[service.security];
-      } else if (
-        this.socketSecurity !== DynamoNTS_RouteSecurity.both && 
-        this.socketSecurity !== DynamoNTS_RouteSecurity[service.security]
-      ) {
-        this.socketSecurity = DynamoNTS_RouteSecurity.both;
-      }
-    });
-  }
-
-  /**
-   * 
-   */
-  private async setupSocketServerServices(): Promise<void> {
-    try {
-      if (this.logFn) console.log('\nfn:. setupSocketServerServices');
-      /* let httpServer: Http.Server; */
-
-      if (this.socketSecurity !== DynamoNTS_RouteSecurity.secure) {
-        if (!this.openExpress) {
-          await this.initOpenExpress();
-        }
-
-        if (!this.httpSocketServer) {
-          this.httpSocketServer = Http.createServer(this.openExpress);
-        }
-      }
-
-      if (this.socketSecurity !== DynamoNTS_RouteSecurity.open) {
-        if (!this.httpsServer) {
-          if (this.cert) {
-            await this.initSecureExpress();
-          } else {
-            let errorMsg: string =
-              `\nYou have secure socket service, but the certification paths are not set!` +
-              `\nset...` +
-              `\n  cert: {` +
-              `\n    keyPath: FileSystem.PathLike,` +
-              `\n    certPath: FileSystem.PathLike,` +
-              `\n  }` +
-              `\nin DynamoBEServer - setupRoutingModules() to enable secure routes.`;
-              
-            errorMsg += '\n\nThe socket services setted to use secure server:';
-            this.socketServices.forEach((service: DynamoNTS_SocketServerService<any>): void => {
-              if (service.security != DynamoNTS_SocketSecurity.open) {
-                errorMsg += `\n  ${service?.name} (port: ${service.port})`;
-              }
-            });
-    
-            const error = new Error('Secure routes cannot be established!');
-            const errorStack: string[] = error.stack.split('\n');
-
-            errorStack.splice(1, 2);
-            error.stack = errorStack.join('\n');
-    
-            DynamoFM_Log.error(errorMsg);
-
-            throw error;
-          }
-        }
-      }
-
-      await DynamoFM_Array.asyncForEach(
-        this.socketServices, 
-        async (service: DynamoNTS_SocketServerService<any>): Promise<void> => {
-          try {
-            this.systemControlsExt.httpSocketServer.init = true;
-            const existingPorts: DynamoNTS_SocketServerService<any>[] = this.socketServices.filter(
-              (mod: DynamoNTS_SocketServerService<any>): boolean => mod.port === service.port
-            );
-
-            if (
-              1 < existingPorts.length || 
-              this.portSettings.httpPort === service.port || 
-              this.portSettings.httpsPort === service.port
-            ) {
-              const error = new Error(`PORT DUPLICATION: ${service.port}`);
-              const errorStack: string[] = error.stack.split('\n');
-
-              errorStack.splice(1, 4);
-              error.stack = errorStack.join('\n');
-
-              DynamoFM_Log.error(`\n${error.message}`);
-
-              throw error;
-            }
-
-            if (service.security === DynamoNTS_SocketSecurity.open) {
-              if (this.logSetup) console.log(
-                `\nsocket setup (open): ${service?.name}:${service.port}`
-              );
-              this.httpSocketSettingUpCount++;
-              this.systemControlsExt.httpSocketServer.started = false;
-
-              this.allSocketServers.push(
-                await service.setupSocketServer(
-                  new SocketIO.Server(this.httpSocketServer), 
-                  DynamoNTS_SocketSecurity.open, 
-                  (): void => { 
-                    this.httpSocketSettingUpCount--;
-
-                    if (this.httpSocketSettingUpCount === 0) {
-                      this.systemControlsExt.httpSocketServer.started = true;
-                    }
-                  }
-                )
-              );
-
-            } else if (service.security === DynamoNTS_SocketSecurity.secure) {
-              if (this.logSetup) console.log(
-                `\nsocket setup (secure): ${service?.name}:${service.port}`
-              );
-              this.httpsSocketSettingUpCount++;
-              this.systemControlsExt.httpsSocketServer.started = false;
-
-              this.allSocketServers.push(
-                await service.setupSocketServer(
-                  new SocketIO.Server(this.httpsServer), 
-                  DynamoNTS_SocketSecurity.secure, 
-                  (): void => {
-                    this.httpsSocketSettingUpCount--;
-
-                    if (this.httpsSocketSettingUpCount === 0) {
-                      this.systemControlsExt.httpsSocketServer.started = true;
-                    }
-                  }
-                )
-              );
-              
-            } else {
-              const error = new Error(
-                `INVALID Socket Service security: ${service.security} on ${service?.name}`
-              );
-              const errorStack: string[] = error.stack.split('\n');
-
-              errorStack.splice(1, 4);
-              error.stack = errorStack.join('\n');
-
-              DynamoFM_Log.error(`\n${error.message}`);
-
-              throw error;
-            }
-          } catch (error) {
-            DynamoFM_Log.error(
-              `\nSocket Server service setup failed. (${service?.name})\n`, 
-              error, 
-              '\n'
-            );
-
-            throw error;
-          }
-        }
-      );
-    } catch (error) {
-      DynamoFM_Log.error(
-        `\nSocket Server services setup failed. (${this.socketServices?.length} services)\n`, 
-        error, 
-        '\n'
-      );
-
-      throw error;
-    } 
-  }
-
-  /**
-   * MISSING Description (TODO)
-   */
-  abstract getSocketServices(): DynamoNTS_SocketServerService<any>[];
-}
+
+import * as SocketIO from 'socket.io';
+import * as Http from 'http';
+
+import { DynamoFM_Array, DynamoFM_Error, DynamoFM_Log, second, DynamoFM_wait } from '@futdevpro/fsm-dynamo';
+
+import { DynamoNTS_App } from './app.server';
+import { DynamoNTS_RouteSecurity } from '../../_enums/route-security.enum';
+import { DynamoNTS_SocketServerService } from '../socket/socket-server.service';
+import { DynamoNTS_SocketSecurity } from '../../_enums/socket-security.enum';
+import { 
+  DynamoNTS_AppExtSysControls 
+} from '../../_models/control-models/app-ext-system-controls.control-model';
+
+/**
+ * This will be the MAIN service of our server project,
+ * follow the types and type instructions while setting up your project
+ * 
+ * In this service, there are abstract functions that you will need to implement,
+ * where you need to set up the main params for your application.
+ * 
+ * The extended App is containing socket server tools
+ * 
+ * You need to add socketService definitions to setupRoutingModules
+ * 
+ * @example
+ * export class App extends DynamoNTS_AppExtended {
+ *   
+ *   ...
+ *   
+ * // Setting up App params, and preparing project global settings
+ *   setupAppParams(): void {
+ *     this.params = new DynamoNTS_AppParams({
+ *       name: 'Warbots Server',
+ *       title: warbotsTitleLog,
+ *       version: version,
+ *       dbName: 'warbots',
+ *     });
+ *  
+ *     // dynamoNTS_GlobalSettings.logRequestsContent = false;
+ *   }
+ *   
+ *   ...
+ * 
+ *   // Setting up DBServices
+ *   setGlobalServiceCollection(): void {
+ *     DynamoNTS_GlobalService.setServices({
+ *       authService: AuthService.getInstance(),
+ *       emailServiceCollection: EmailServiceCollectionService.getInstance(),
+ *       dbModels: [
+ *         userModelParams,
+ *         userDataModelParams,
+ *         userOptionsModelParams,
+ *         userStatisticsModelParams,
+ *         userAchievementsModelParams,
+ *         userNotificationsModelParams,
+ *         
+ *         matchStatisticsModelParams,
+ *         matchDataModelParams,
+
+ *         DynamoFM_usageSessionModel_params,
+ *         DynamoFM_customDataModel_params,
+ *       ]
+ *     });
+ *   }
+ *   
+ *   ...
+ *   
+ *   // Setting up Routes
+ *   setupRoutingModules(): void {
+ *     this.httpPort = env.port;
+
+ *     this.routingModules = [
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/user',
+ *         controllers: [ 
+ *           UserController.getInstance(),
+ *           UserDataController.getInstance(),
+ *           UserOptionsController.getInstance(),
+ *           UserStatisticsController.getInstance(),
+ *           UserAchievementsController.getInstance(),
+ *           UserNotificationsController.getInstance()
+ *         ]
+ *       }),
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/match',
+ *         controllers: [ 
+ *           MatchController.getInstance(),
+ *           MatchDistributionController.getInstance(),
+ *           MatchStatisticsController.getInstance(),
+ *         ]
+ *       }),
+ *       new DynamoNTS_RoutingModule({
+ *         route: '/server',
+ *         controllers: [ 
+ *           ServerController.getInstance(),
+ *         ]
+ *       }),
+
+ *       getTestRoutingModule(),
+ *       getUsageRoutingModule()
+ *     ];
+ * 
+ *     ...
+ *   
+ *     // Setting up Sockets
+ *     this.socketServices = [
+ *       NotificationService.getInstance(),
+ *       ChatService.getInstance(),
+ *       ...
+ *     ];
+ *   }
+ * }
+ */
+export abstract class DynamoNTS_AppExtended extends DynamoNTS_App {
+  
+  private systemControlsExt: DynamoNTS_AppExtSysControls = new DynamoNTS_AppExtSysControls();
+  override get started(): boolean { return this.systemControlsExt.appExtended.started; }
+  private httpsSocketSettingUpCount: number = 0;
+  private httpSocketSettingUpCount: number = 0;
+
+  private socketSecurity: DynamoNTS_RouteSecurity;
+
+  private httpSocketServer: Http.Server;
+  
+  /**
+   * @example
+   * // Setting up Sockets
+   * this.socketServices = [
+   *   NotificationService.getInstance(),
+   *   ChatService.getInstance(),
+   *   ...
+   * ];
+   */
+  protected socketServices: DynamoNTS_SocketServerService<any>[];
+  private allSocketServers: SocketIO.Server[] = [];
+
+  constructor(){
+    super(true);
+
+    this.asyncConstructExt().catch((error: any): void => {
+      DynamoFM_Log.H_error(
+        `\nExtended Application: ${this.params?.name} start failed.` +
+        `\n`, error, 
+        '\n'
+      );
+    });
+  }
+
+  private async asyncConstructExt(): Promise<void> {
+    if (this.logFn && this.deepLog) console.log('\nfn:. asyncConstruct-extended');
+    try {
+      this.systemControlsExt.appExtended.init = true;
+    
+      this.socketServices = this.getSocketServices();
+
+      if (this.socketServices?.length) {
+        this.setSocketSecurity();
+
+        await this.setupSocketServerServices();
+
+        if (this.logSetup) console.log(
+          `\nAll sockets setted up.... sockets using security: ${this.socketSecurity}`
+        );
+      } else {
+        DynamoFM_Log.testWarn(
+          'No socketServices setted up while using Extended Application.',
+          '\nYou should use DynamoNTS_App if you don`t need socket services.' 
+        );
+      }
+
+      await this.ready();
+            
+      if (this.params.title) {
+        console.log(this.params.title);
+        console.log(`Version: ${this.params.version}`);
+      }
+      DynamoFM_Log.H_success(`${this.params.name} started successfully.`);
+      
+    } catch (error) {
+      DynamoFM_Log.H_error(
+        `\nExtended Application: ${this.params?.name} start failed.` +
+        `\n`, error,
+        '\n'
+      );
+
+      throw new DynamoFM_Error({
+        errorCode: 'NTS-AES-001',
+        error: error,
+        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(),
+          },
+        },
+      });
+    }
+  }
+
+  override async ready(timeout: number = 4 * second): Promise<void> {
+    if (this.logFn) console.log('\nfn:. ready-extended');
+    await super.ready(timeout);
+
+    let ready: boolean = false;
+    const start: number = +new Date();
+
+    if (this.constructErrors.length) {
+      DynamoFM_Log.H_error(
+        `Extended Application: ${this.params?.name} start failed. ERRORS`, 
+        this.constructErrors, 
+        '\n'
+      );
+
+      throw new DynamoFM_Error({ 
+        message: `${this.params?.name} start failed. ERRORS`,
+        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 {
+        DynamoFM_Log.error(`${this.params.name} APP NOT INITIALIZED while trying to get ready.`);
+      }
+
+      if (!ready) {
+        await DynamoFM_wait(100);
+      }
+    }
+
+    if (this.constructErrors.length) {
+      DynamoFM_Log.H_error(
+        `Extended Application: ${this.params?.name} start failed. TIMEOUT`, 
+        this.constructErrors, 
+        '\n'
+      );
+
+      throw new DynamoFM_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.logFn && 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.';
+      }
+
+      if (
+        this.systemControlsExt.httpsSocketServer.init && 
+        !this.systemControlsExt.httpsSocketServer.started
+      ) {
+        msg += '\nhttpsSocketServer start failed.';
+      }      
+
+      DynamoFM_Log.error(msg, this.constructErrors, '\n');
+
+      throw new DynamoFM_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(),
+          },
+        },
+        error: this.constructErrors?.[0] ?? new Error()
+      });
+    }
+  }
+
+  override async stop(): Promise<void> {
+    if (this.logFn) console.log('\nfn:. stop-extended');
+    
+    if (this.started) {
+      await super.stop(true);
+
+      this.systemControlsExt.httpSocketServer.started = false;
+      this.systemControlsExt.httpsSocketServer.started = false;
+      await DynamoFM_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) {
+                DynamoFM_Log.error(`\nHTTP socket server close error`, err);
+                reject(
+                  new DynamoFM_Error({
+                    errorCode: 'NTS-AES-120',
+                    message: `SocketServer close failed.`,
+                    error: err
+                  })
+                );
+              } else {
+                resolve();
+              }
+            });
+          });
+        }
+      );
+      this.systemControlsExt.httpSocketServer.init = false;
+      this.systemControlsExt.httpsSocketServer.init = false;
+
+      DynamoFM_Log.H_info(`${this.params.name} stopped successfully.`);
+    }
+  }
+
+  /**
+   * 
+   */
+  private setSocketSecurity(): void {
+    if (this.logFn) console.log('\nfn:. setSocketSecurity');
+    this.socketServices.forEach((service: DynamoNTS_SocketServerService<any>): void => {
+      if (!this.socketSecurity) {
+        this.socketSecurity = DynamoNTS_RouteSecurity[service.security];
+      } else if (
+        this.socketSecurity !== DynamoNTS_RouteSecurity.both && 
+        this.socketSecurity !== DynamoNTS_RouteSecurity[service.security]
+      ) {
+        this.socketSecurity = DynamoNTS_RouteSecurity.both;
+      }
+    });
+  }
+
+  /**
+   * 
+   */
+  private async setupSocketServerServices(): Promise<void> {
+    try {
+      if (this.logFn) console.log('\nfn:. setupSocketServerServices');
+      /* let httpServer: Http.Server; */
+
+      if (this.socketSecurity !== DynamoNTS_RouteSecurity.secure) {
+        if (!this.openExpress) {
+          await this.initOpenExpress();
+        }
+
+        if (!this.httpSocketServer) {
+          this.httpSocketServer = Http.createServer(this.openExpress);
+        }
+      }
+
+      if (this.socketSecurity !== DynamoNTS_RouteSecurity.open) {
+        if (!this.httpsServer) {
+          if (this.cert) {
+            await this.initSecureExpress();
+          } else {
+            let errorMsg: string =
+              `\nYou have secure socket service, but the certification paths are not set!` +
+              `\nset...` +
+              `\n  cert: {` +
+              `\n    keyPath: FileSystem.PathLike,` +
+              `\n    certPath: FileSystem.PathLike,` +
+              `\n  }` +
+              `\nin DynamoBEServer - setupRoutingModules() to enable secure routes.`;
+              
+            errorMsg += '\n\nThe socket services setted to use secure server:';
+            this.socketServices.forEach((service: DynamoNTS_SocketServerService<any>): void => {
+              if (service.security != DynamoNTS_SocketSecurity.open) {
+                errorMsg += `\n  ${service?.name} (port: ${service.port})`;
+              }
+            });
+    
+            const error = new Error('Secure routes cannot be established!');
+            const errorStack: string[] = error.stack.split('\n');
+
+            errorStack.splice(1, 2);
+            error.stack = errorStack.join('\n');
+    
+            DynamoFM_Log.error(errorMsg);
+
+            throw error;
+          }
+        }
+      }
+
+      await DynamoFM_Array.asyncForEach(
+        this.socketServices, 
+        async (service: DynamoNTS_SocketServerService<any>): Promise<void> => {
+          try {
+            this.systemControlsExt.httpSocketServer.init = true;
+            const existingPorts: DynamoNTS_SocketServerService<any>[] = this.socketServices.filter(
+              (mod: DynamoNTS_SocketServerService<any>): boolean => mod.port === service.port
+            );
+
+            if (
+              1 < existingPorts.length || 
+              this.portSettings.httpPort === service.port || 
+              this.portSettings.httpsPort === service.port
+            ) {
+              const error = new Error(`PORT DUPLICATION: ${service.port}`);
+              const errorStack: string[] = error.stack.split('\n');
+
+              errorStack.splice(1, 4);
+              error.stack = errorStack.join('\n');
+
+              DynamoFM_Log.error(`\n${error.message}`);
+
+              throw error;
+            }
+
+            if (service.security === DynamoNTS_SocketSecurity.open) {
+              if (this.logSetup) console.log(
+                `\nsocket setup (open): ${service?.name}:${service.port}`
+              );
+              this.httpSocketSettingUpCount++;
+              this.systemControlsExt.httpSocketServer.started = false;
+
+              this.allSocketServers.push(
+                await service.setupSocketServer(
+                  new SocketIO.Server(this.httpSocketServer), 
+                  DynamoNTS_SocketSecurity.open, 
+                  (): void => { 
+                    this.httpSocketSettingUpCount--;
+
+                    if (this.httpSocketSettingUpCount === 0) {
+                      this.systemControlsExt.httpSocketServer.started = true;
+                    }
+                  }
+                )
+              );
+
+            } else if (service.security === DynamoNTS_SocketSecurity.secure) {
+              if (this.logSetup) console.log(
+                `\nsocket setup (secure): ${service?.name}:${service.port}`
+              );
+              this.httpsSocketSettingUpCount++;
+              this.systemControlsExt.httpsSocketServer.started = false;
+
+              this.allSocketServers.push(
+                await service.setupSocketServer(
+                  new SocketIO.Server(this.httpsServer), 
+                  DynamoNTS_SocketSecurity.secure, 
+                  (): void => {
+                    this.httpsSocketSettingUpCount--;
+
+                    if (this.httpsSocketSettingUpCount === 0) {
+                      this.systemControlsExt.httpsSocketServer.started = true;
+                    }
+                  }
+                )
+              );
+              
+            } else {
+              const error = new Error(
+                `INVALID Socket Service security: ${service.security} on ${service?.name}`
+              );
+              const errorStack: string[] = error.stack.split('\n');
+
+              errorStack.splice(1, 4);
+              error.stack = errorStack.join('\n');
+
+              DynamoFM_Log.error(`\n${error.message}`);
+
+              throw error;
+            }
+          } catch (error) {
+            DynamoFM_Log.error(
+              `\nSocket Server service setup failed. (${service?.name})\n`, 
+              error, 
+              '\n'
+            );
+
+            throw error;
+          }
+        }
+      );
+    } catch (error) {
+      DynamoFM_Log.error(
+        `\nSocket Server services setup failed. (${this.socketServices?.length} services)\n`, 
+        error, 
+        '\n'
+      );
+
+      throw error;
+    } 
+  }
+
+  /**
+   * MISSING Description (TODO)
+   */
+  abstract getSocketServices(): DynamoNTS_SocketServerService<any>[];
+}