@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_modules/socket/app-extended.server.js

@@ -1,522 +1,522 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_AppExtended = void 0;
-const tslib_1 = require("tslib");
-const Http = tslib_1.__importStar(require("http"));
-const SocketIO = tslib_1.__importStar(require("socket.io"));
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const default_socket_path_const_1 = require("../../_collections/default-socket-path.const");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-const route_security_enum_1 = require("../../_enums/route-security.enum");
-const app_ext_system_controls_control_model_1 = require("../../_models/control-models/app-ext-system-controls.control-model");
-const app_server_1 = require("../../_services/server/app.server");
-const socket_security_enum_1 = require("./_enums/socket-security.enum");
-/**
- * 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 DyNTS_AppExtended {
- *
- *   ...
- *
- * // Setting up App params, and preparing project global settings
- *   setupAppParams(): void {
- *     this.params = new DyNTS_AppParams({
- *       name: 'Warbots Server',
- *       title: warbotsTitleLog,
- *       version: version,
- *       dbName: 'warbots',
- *     });
- *
- *     // dynamoNTS_GlobalSettings.logRequestsContent = false;
- *   }
- *
- *   ...
- *
- *   // Setting up DBServices
- *   setGlobalServiceCollection(): void {
- *     DyNTS_GlobalService.setServices({
- *       authService: AuthService.getInstance(),
- *       emailServiceCollection: EmailServiceCollectionService.getInstance(),
- *       dbModels: [
- *         userModelParams,
- *         userDataModelParams,
- *         userOptionsModelParams,
- *         userStatisticsModelParams,
- *         userAchievementsModelParams,
- *         userNotificationsModelParams,
- *
- *         matchStatisticsModelParams,
- *         matchDataModelParams,
-
- *         DyFM_usageSession_dataParams,
- *         DyFM_customData_dataParams,
- *       ]
- *     });
- *   }
- *
- *   ...
- *
- *   // Setting up Routes
- *   setupRoutingModules(): void {
- *     this.httpPort = env.port;
-
- *     this.routingModules = [
- *       new DyNTS_RoutingModule({
- *         route: '/user',
- *         controllers: [
- *           UserController.getInstance(),
- *           UserDataController.getInstance(),
- *           UserOptionsController.getInstance(),
- *           UserStatisticsController.getInstance(),
- *           UserAchievementsController.getInstance(),
- *           UserNotificationsController.getInstance()
- *         ]
- *       }),
- *       new DyNTS_RoutingModule({
- *         route: '/match',
- *         controllers: [
- *           MatchController.getInstance(),
- *           MatchDistributionController.getInstance(),
- *           MatchStatisticsController.getInstance(),
- *         ]
- *       }),
- *       new DyNTS_RoutingModule({
- *         route: '/server',
- *         controllers: [
- *           ServerController.getInstance(),
- *         ]
- *       }),
-
- *       getTestRoutingModule(),
- *       getUsageRoutingModule()
- *     ];
- *
- *     ...
- *
- *     // Setting up Sockets (port opcionális – ha nincs megadva, a HTTP/HTTPS portot használjuk, same port)
- *     this.socketServices = [
- *       NotificationService.getInstance(),
- *       ChatService.getInstance(),
- *       ...
- *     ];
- *   }
- * }
- */
-class DyNTS_AppExtended extends app_server_1.DyNTS_App {
-    systemControlsExt = new app_ext_system_controls_control_model_1.DyNTS_AppExtSysControls();
-    get started() { return this.systemControlsExt.appExtended.started; }
-    httpsSocketSettingUpCount = 0;
-    httpSocketSettingUpCount = 0;
-    socketSecurity;
-    /** Csak akkor van értékadva, ha nincs base httpServer (pl. nincs open route) és open socket van. */
-    httpSocketServer;
-    /**
-     * Socket szolgáltatások. A port opcionális: ha nincs megadva, az extended app
-     * a getPortSettings() httpPort/httpsPort értékét használja (WebSocket és HTTP ugyanazon a porton).
-     * @example
-     * // Setting up Sockets
-     * this.socketServices = [
-     *   NotificationService.getInstance(),
-     *   ChatService.getInstance(),
-     *   ...
-     * ];
-     */
-    socketServices;
-    allSocketServers = [];
-    constructor() {
-        super( /* true */);
-        /* this.asyncConstructExt().catch((error: DyFM_AnyError): void => {
-          if (
-            DyNTS_global_settings.log_settings.highDetailedLogs ||
-            !(error instanceof DyFM_Error)
-          ) {
-            DyFM_Log.H_error(
-              `Extended Application: ${this.params?.name} start failed. ` +
-              `(DyNTS_AppExtended constructor catch)`,
-              `\n    ERROR:`, error
-            );
-          } else {
-            error.logSimple(
-              `Extended Application: "${this.params?.name}" start failed. ` +
-              `(DyNTS_AppExtended constructor catch)`
-            );
-          }
-        }); */
-    }
-    async asyncConstruct(extended = true) {
-        if (this.fnLogs && this.deepLog)
-            console.log('\nfn:. asyncConstruct-extended');
-        try {
-            await super.asyncConstruct(true);
-            this.systemControlsExt.appExtended.init = true;
-            this.socketServices = this.getSocketServices();
-            if (this.socketServices?.length) {
-                if (this.logSetup)
-                    fsm_dynamo_1.DyFM_Log.log('\nsetting up socket servers...');
-                this.setSocketSecurity();
-                await this.setupSocketServerServices();
-                if (this.logSetup)
-                    console.log(`\nAll sockets setted up.... sockets using security: ${this.socketSecurity}`);
-            }
-            else {
-                fsm_dynamo_1.DyFM_Log.testWarn('No socketServices setted up while using Extended Application.', '\nYou should use DyNTS_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}`);
-            }
-            fsm_dynamo_1.DyFM_Log.H_success(`"${this.params.name}" started successfully.`);
-        }
-        catch (error) {
-            /* if (
-              DyNTS_global_settings.log_settings.highDetailedLogs ||
-              !(error instanceof DyFM_Error)
-            ) {
-              DyFM_Log.H_error(
-                `Extended Application: ${this.params?.name} start failed. (asyncConstructExt catch)` +
-                `\n    ERROR:`, error
-              );
-            } else {
-              error.logSimple(
-                `Extended Application: "${this.params?.name}" start failed. (asyncConstructExt catch)`
-              );
-            } */
-            throw new fsm_dynamo_1.DyFM_Error({
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-001`,
-                error: error,
-                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(),
-                    },
-                },
-            });
-        }
-    }
-    async ready(timeout = this.defaultReadyTimeout) {
-        if (this.fnLogs)
-            console.log('\nfn:. ready-extended');
-        try {
-            await super.ready(timeout);
-            let ready = false;
-            const start = +new Date();
-            if (this.constructErrors.length) {
-                if (this.deepLog) {
-                    if (global_settings_const_1.DyNTS_global_settings.log_settings.highDetailedLogs) {
-                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. ` +
-                            `(ready; constructErrors check +1)`, `\n    construct ERRORS:`, this.constructErrors);
-                    }
-                    else {
-                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. ` +
-                            `(ready; constructErrors check +1)`, `\n    construct ERRORS:`, this.getSimplifiedConstructErrors());
-                    }
-                }
-                throw new fsm_dynamo_1.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.getIsReady() &&
-                        this.systemControlsExt.httpsSocketServer.getIsReady());
-                }
-                else {
-                    fsm_dynamo_1.DyFM_Log.error(`"${this.params.name}" APP NOT INITIALIZED while trying to get ready.`);
-                }
-                if (!ready) {
-                    await fsm_dynamo_1.DyFM_Async.wait(100);
-                }
-            }
-            if (this.constructErrors.length) {
-                if (this.deepLog) {
-                    if (global_settings_const_1.DyNTS_global_settings.log_settings.highDetailedLogs) {
-                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. (ready; TIMEOUT check +2)`, `\n    construct ERRORS:`, this.constructErrors);
-                    }
-                    else {
-                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. (ready; TIMEOUT check +2)`, `\n    construct ERRORS:`, this.getSimplifiedConstructErrors());
-                    }
-                }
-                throw new fsm_dynamo_1.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 = `${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.';
-                }
-                fsm_dynamo_1.DyFM_Log.error(msg, this.constructErrors, '\n');
-                throw new fsm_dynamo_1.DyFM_Error({
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-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(),
-                });
-            }
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.__getDefaultErrorSettings('ready', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-111`,
-                error: error,
-            });
-        }
-    }
-    async stop() {
-        if (this.fnLogs)
-            console.log('\nfn:. stop-extended');
-        try {
-            if (this.started) {
-                await super.stop(true);
-                this.systemControlsExt.httpSocketServer.started = false;
-                this.systemControlsExt.httpsSocketServer.started = false;
-                await fsm_dynamo_1.DyFM_Array.asyncForEach(this.allSocketServers, async (socketServer) => {
-                    await new Promise((resolve, reject) => {
-                        socketServer.disconnectSockets(true);
-                        socketServer.close((err) => {
-                            if (err) {
-                                fsm_dynamo_1.DyFM_Log.error(`\nHTTP socket server close error`, err);
-                                reject(new fsm_dynamo_1.DyFM_Error({
-                                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-120`,
-                                    message: `SocketServer close failed.`,
-                                    error: err,
-                                }));
-                            }
-                            else {
-                                resolve();
-                            }
-                        });
-                    });
-                });
-                this.systemControlsExt.httpSocketServer.init = false;
-                this.systemControlsExt.httpsSocketServer.init = false;
-                await fsm_dynamo_1.DyFM_Async.delay(100);
-                fsm_dynamo_1.DyFM_Log.H_info(`"${this.params.name}" stopped successfully.`);
-            }
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.__getDefaultErrorSettings('stop', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-121`,
-            });
-        }
-    }
-    /**
-     *
-     */
-    setSocketSecurity() {
-        if (this.fnLogs)
-            console.log('\nfn:. setSocketSecurity');
-        this.socketServices.forEach((service) => {
-            if (!this.socketSecurity) {
-                this.socketSecurity = route_security_enum_1.DyNTS_RouteSecurity[service.security];
-            }
-            else if (this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity.both &&
-                this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity[service.security]) {
-                this.socketSecurity = route_security_enum_1.DyNTS_RouteSecurity.both;
-            }
-        });
-    }
-    /**
-     * Socket szerverek felállítása. By default a socket a HTTP/HTTPS porton fut (same port);
-     * ha a service.port nincs megadva, a getPortSettings() httpPort/httpsPort értékét használjuk.
-     * Ha a base app már listenel (httpServer/httpsServer), arra attacholjuk a Socket.IO-t,
-     * különben külön httpSocketServer-t hozunk létre és listenelünk.
-     * A Socket.IO path a portSettings.socketPath-ből jön (default: DyNTS_defaultSocketPath); a kliensnek ugyanazt kell használnia.
-     */
-    async setupSocketServerServices() {
-        try {
-            if (this.fnLogs)
-                console.log('\nfn:. setupSocketServerServices');
-            const useBaseHttpServer = !!this.httpServer;
-            const useBaseHttpsServer = !!this.httpsServer;
-            if (this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity.secure) {
-                if (!this.openExpress) {
-                    await this.initOpenExpress();
-                }
-                if (!useBaseHttpServer && !this.httpSocketServer) {
-                    this.httpSocketServer = Http.createServer(this.openExpress);
-                }
-            }
-            if (this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity.open) {
-                if (!this.httpsServer) {
-                    if (this.cert) {
-                        await this.initSecureExpress();
-                    }
-                    else {
-                        let errorMsg = `\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 DynamoNTSServer - setupRoutingModules() to enable secure routes.`;
-                        errorMsg += '\n\nThe socket services setted to use secure server:';
-                        this.socketServices.forEach((service) => {
-                            if (service.security !== socket_security_enum_1.DyNTS_SocketSecurity.open) {
-                                const effPort = service.port ??
-                                    this.portSettings.httpsPort;
-                                errorMsg += `\n  ${service?.name} (port: ${effPort})`;
-                            }
-                        });
-                        const error = new Error('Secure routes cannot be established!');
-                        const errorStack = error.stack.split('\n');
-                        errorStack.splice(1, 2);
-                        error.stack = errorStack.join('\n');
-                        fsm_dynamo_1.DyFM_Log.error(errorMsg);
-                        throw error;
-                    }
-                }
-            }
-            await fsm_dynamo_1.DyFM_Array.asyncForEach(this.socketServices, async (service) => {
-                try {
-                    const effectivePort = service.security === socket_security_enum_1.DyNTS_SocketSecurity.open
-                        ? (service.port ?? this.portSettings.httpPort)
-                        : (service.port ?? this.portSettings.httpsPort);
-                    if (effectivePort === undefined) {
-                        throw new Error(`PORT NOT SET: "${service.name}". ` +
-                            `Set port in getServiceParams() or ensure getPortSettings() returns httpPort/httpsPort.`);
-                    }
-                    if (service.security === socket_security_enum_1.DyNTS_SocketSecurity.open) {
-                        this.systemControlsExt.httpSocketServer.init = true;
-                        // BFR-MASTERPROMPTER-025 (a BFR-FDPTOKENSERVICE-007 3a2c381 utó-fix-e): az attach-mód
-                        // EXPLICIT opt-in (`dedicatedPort: true`), NEM a port-érték implicit inferenciája. A
-                        // korábbi `port≠httpPort → dedikált` inferencia CSENDBEN regresszálta a unified-shared
-                        // appokat, amelyek legacy-label/notif-konvenció okból adtak portot (MP live-igazolt:
-                        // realtime DEAD az nts-bump után; adventor/ccap/warbots latens). Mostantól:
-                        //   - default (dedicatedPort hiányzik/false) → SHARED (a fő szerverre attach, a port-label irreleváns);
-                        //   - dedicatedPort: true → saját Http.Server + listen a service.port-on (a bizonyított
-                        //     non-base útvonal tükre) — pl. a token-service szándékosan-dedikált notif-portja.
-                        if (service.dedicatedPort && (service.port === undefined || service.port === this.portSettings.httpPort)) {
-                            throw new Error(`SOCKET CONFIG ERROR: "${service.name}" dedicatedPort:true requires an explicit ` +
-                                `port that differs from the main httpPort (${this.portSettings.httpPort}).`);
-                        }
-                        const attachToMain = useBaseHttpServer && !service.dedicatedPort;
-                        const serverForOpen = attachToMain
-                            ? this.httpServer
-                            : (useBaseHttpServer
-                                ? Http.createServer(this.openExpress)
-                                : this.httpSocketServer);
-                        if (this.logSetup)
-                            console.log(`\nsocket setup (open): ${service?.name}:${effectivePort}` +
-                                (attachToMain ? ' (shared with HTTP)' : ' (dedicated port)'));
-                        this.httpSocketSettingUpCount++;
-                        this.systemControlsExt.httpSocketServer.started = false;
-                        const socketPath = this.portSettings.socketPath ?? default_socket_path_const_1.DyNTS_defaultSocketPath;
-                        this.allSocketServers.push(await service.setupSocketServer(new SocketIO.Server(serverForOpen, { path: socketPath }), socket_security_enum_1.DyNTS_SocketSecurity.open, () => {
-                            this.httpSocketSettingUpCount--;
-                            if (this.httpSocketSettingUpCount === 0) {
-                                this.systemControlsExt.httpSocketServer.started = true;
-                            }
-                        }, {
-                            attachedToExistingServer: attachToMain,
-                            effectivePort: effectivePort,
-                        }));
-                    }
-                    else if (service.security === socket_security_enum_1.DyNTS_SocketSecurity.secure) {
-                        this.systemControlsExt.httpsSocketServer.init = true;
-                        if (this.logSetup)
-                            console.log(`\nsocket setup (secure): ${service?.name}:${effectivePort}` +
-                                (useBaseHttpsServer ? ' (shared with HTTPS)' : ''));
-                        this.httpsSocketSettingUpCount++;
-                        this.systemControlsExt.httpsSocketServer.started = false;
-                        const socketPathSecure = this.portSettings.socketPath ?? default_socket_path_const_1.DyNTS_defaultSocketPath;
-                        this.allSocketServers.push(await service.setupSocketServer(new SocketIO.Server(this.httpsServer, { path: socketPathSecure }), socket_security_enum_1.DyNTS_SocketSecurity.secure, () => {
-                            this.httpsSocketSettingUpCount--;
-                            if (this.httpsSocketSettingUpCount === 0) {
-                                this.systemControlsExt.httpsSocketServer.started = true;
-                            }
-                        }, {
-                            attachedToExistingServer: useBaseHttpsServer,
-                            effectivePort: effectivePort,
-                        }));
-                    }
-                    else {
-                        const error = new Error(`INVALID Socket Service security: ${service.security} on ${service?.name}`);
-                        const errorStack = error.stack?.split('\n');
-                        errorStack.splice(1, 4);
-                        error.stack = errorStack.join('\n');
-                        fsm_dynamo_1.DyFM_Log.error(`\n${error.message}`);
-                        throw error;
-                    }
-                }
-                catch (error) {
-                    if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                        error.logSimple(`\nSocket Server service setup failed. (${service?.name})`);
-                    }
-                    else {
-                        fsm_dynamo_1.DyFM_Log.error(`\nSocket Server service setup failed. (${service?.name})`, error);
-                    }
-                    throw error;
-                }
-            });
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.error(`\nSocket Server services setup failed. (${this.socketServices?.length} services)\n`, error, '\n');
-            throw error;
-        }
-    }
-    __getDefaultErrorSettings(fnName, error) {
-        return {
-            status: error?.___status ?? 500,
-            message: error?.message ??
-                error?._message ??
-                `${fnName} was UNSUCCESSFUL (NTS)`,
-            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
-            addECToUserMsg: !error?.__userMessage,
-            issuerService: `${this?.constructor?.name}-DyNTS_AppExtended`,
-            level: fsm_dynamo_1.DyFM_ErrorLevel.fatal,
-            error: error,
-        };
-    }
-}
-exports.DyNTS_AppExtended = DyNTS_AppExtended;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_AppExtended = void 0;
+const tslib_1 = require("tslib");
+const Http = tslib_1.__importStar(require("http"));
+const SocketIO = tslib_1.__importStar(require("socket.io"));
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const default_socket_path_const_1 = require("../../_collections/default-socket-path.const");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const route_security_enum_1 = require("../../_enums/route-security.enum");
+const app_ext_system_controls_control_model_1 = require("../../_models/control-models/app-ext-system-controls.control-model");
+const app_server_1 = require("../../_services/server/app.server");
+const socket_security_enum_1 = require("./_enums/socket-security.enum");
+/**
+ * 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 DyNTS_AppExtended {
+ *
+ *   ...
+ *
+ * // Setting up App params, and preparing project global settings
+ *   setupAppParams(): void {
+ *     this.params = new DyNTS_AppParams({
+ *       name: 'Warbots Server',
+ *       title: warbotsTitleLog,
+ *       version: version,
+ *       dbName: 'warbots',
+ *     });
+ *
+ *     // dynamoNTS_GlobalSettings.logRequestsContent = false;
+ *   }
+ *
+ *   ...
+ *
+ *   // Setting up DBServices
+ *   setGlobalServiceCollection(): void {
+ *     DyNTS_GlobalService.setServices({
+ *       authService: AuthService.getInstance(),
+ *       emailServiceCollection: EmailServiceCollectionService.getInstance(),
+ *       dbModels: [
+ *         userModelParams,
+ *         userDataModelParams,
+ *         userOptionsModelParams,
+ *         userStatisticsModelParams,
+ *         userAchievementsModelParams,
+ *         userNotificationsModelParams,
+ *
+ *         matchStatisticsModelParams,
+ *         matchDataModelParams,
+
+ *         DyFM_usageSession_dataParams,
+ *         DyFM_customData_dataParams,
+ *       ]
+ *     });
+ *   }
+ *
+ *   ...
+ *
+ *   // Setting up Routes
+ *   setupRoutingModules(): void {
+ *     this.httpPort = env.port;
+
+ *     this.routingModules = [
+ *       new DyNTS_RoutingModule({
+ *         route: '/user',
+ *         controllers: [
+ *           UserController.getInstance(),
+ *           UserDataController.getInstance(),
+ *           UserOptionsController.getInstance(),
+ *           UserStatisticsController.getInstance(),
+ *           UserAchievementsController.getInstance(),
+ *           UserNotificationsController.getInstance()
+ *         ]
+ *       }),
+ *       new DyNTS_RoutingModule({
+ *         route: '/match',
+ *         controllers: [
+ *           MatchController.getInstance(),
+ *           MatchDistributionController.getInstance(),
+ *           MatchStatisticsController.getInstance(),
+ *         ]
+ *       }),
+ *       new DyNTS_RoutingModule({
+ *         route: '/server',
+ *         controllers: [
+ *           ServerController.getInstance(),
+ *         ]
+ *       }),
+
+ *       getTestRoutingModule(),
+ *       getUsageRoutingModule()
+ *     ];
+ *
+ *     ...
+ *
+ *     // Setting up Sockets (port opcionális – ha nincs megadva, a HTTP/HTTPS portot használjuk, same port)
+ *     this.socketServices = [
+ *       NotificationService.getInstance(),
+ *       ChatService.getInstance(),
+ *       ...
+ *     ];
+ *   }
+ * }
+ */
+class DyNTS_AppExtended extends app_server_1.DyNTS_App {
+    systemControlsExt = new app_ext_system_controls_control_model_1.DyNTS_AppExtSysControls();
+    get started() { return this.systemControlsExt.appExtended.started; }
+    httpsSocketSettingUpCount = 0;
+    httpSocketSettingUpCount = 0;
+    socketSecurity;
+    /** Csak akkor van értékadva, ha nincs base httpServer (pl. nincs open route) és open socket van. */
+    httpSocketServer;
+    /**
+     * Socket szolgáltatások. A port opcionális: ha nincs megadva, az extended app
+     * a getPortSettings() httpPort/httpsPort értékét használja (WebSocket és HTTP ugyanazon a porton).
+     * @example
+     * // Setting up Sockets
+     * this.socketServices = [
+     *   NotificationService.getInstance(),
+     *   ChatService.getInstance(),
+     *   ...
+     * ];
+     */
+    socketServices;
+    allSocketServers = [];
+    constructor() {
+        super( /* true */);
+        /* this.asyncConstructExt().catch((error: DyFM_AnyError): void => {
+          if (
+            DyNTS_global_settings.log_settings.highDetailedLogs ||
+            !(error instanceof DyFM_Error)
+          ) {
+            DyFM_Log.H_error(
+              `Extended Application: ${this.params?.name} start failed. ` +
+              `(DyNTS_AppExtended constructor catch)`,
+              `\n    ERROR:`, error
+            );
+          } else {
+            error.logSimple(
+              `Extended Application: "${this.params?.name}" start failed. ` +
+              `(DyNTS_AppExtended constructor catch)`
+            );
+          }
+        }); */
+    }
+    async asyncConstruct(extended = true) {
+        if (this.fnLogs && this.deepLog)
+            console.log('\nfn:. asyncConstruct-extended');
+        try {
+            await super.asyncConstruct(true);
+            this.systemControlsExt.appExtended.init = true;
+            this.socketServices = this.getSocketServices();
+            if (this.socketServices?.length) {
+                if (this.logSetup)
+                    fsm_dynamo_1.DyFM_Log.log('\nsetting up socket servers...');
+                this.setSocketSecurity();
+                await this.setupSocketServerServices();
+                if (this.logSetup)
+                    console.log(`\nAll sockets setted up.... sockets using security: ${this.socketSecurity}`);
+            }
+            else {
+                fsm_dynamo_1.DyFM_Log.testWarn('No socketServices setted up while using Extended Application.', '\nYou should use DyNTS_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}`);
+            }
+            fsm_dynamo_1.DyFM_Log.H_success(`"${this.params.name}" started successfully.`);
+        }
+        catch (error) {
+            /* if (
+              DyNTS_global_settings.log_settings.highDetailedLogs ||
+              !(error instanceof DyFM_Error)
+            ) {
+              DyFM_Log.H_error(
+                `Extended Application: ${this.params?.name} start failed. (asyncConstructExt catch)` +
+                `\n    ERROR:`, error
+              );
+            } else {
+              error.logSimple(
+                `Extended Application: "${this.params?.name}" start failed. (asyncConstructExt catch)`
+              );
+            } */
+            throw new fsm_dynamo_1.DyFM_Error({
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-001`,
+                error: error,
+                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(),
+                    },
+                },
+            });
+        }
+    }
+    async ready(timeout = this.defaultReadyTimeout) {
+        if (this.fnLogs)
+            console.log('\nfn:. ready-extended');
+        try {
+            await super.ready(timeout);
+            let ready = false;
+            const start = +new Date();
+            if (this.constructErrors.length) {
+                if (this.deepLog) {
+                    if (global_settings_const_1.DyNTS_global_settings.log_settings.highDetailedLogs) {
+                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. ` +
+                            `(ready; constructErrors check +1)`, `\n    construct ERRORS:`, this.constructErrors);
+                    }
+                    else {
+                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. ` +
+                            `(ready; constructErrors check +1)`, `\n    construct ERRORS:`, this.getSimplifiedConstructErrors());
+                    }
+                }
+                throw new fsm_dynamo_1.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.getIsReady() &&
+                        this.systemControlsExt.httpsSocketServer.getIsReady());
+                }
+                else {
+                    fsm_dynamo_1.DyFM_Log.error(`"${this.params.name}" APP NOT INITIALIZED while trying to get ready.`);
+                }
+                if (!ready) {
+                    await fsm_dynamo_1.DyFM_Async.wait(100);
+                }
+            }
+            if (this.constructErrors.length) {
+                if (this.deepLog) {
+                    if (global_settings_const_1.DyNTS_global_settings.log_settings.highDetailedLogs) {
+                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. (ready; TIMEOUT check +2)`, `\n    construct ERRORS:`, this.constructErrors);
+                    }
+                    else {
+                        fsm_dynamo_1.DyFM_Log.H_error(`Extended Application: "${this.params.name}" start failed. (ready; TIMEOUT check +2)`, `\n    construct ERRORS:`, this.getSimplifiedConstructErrors());
+                    }
+                }
+                throw new fsm_dynamo_1.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 = `${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.';
+                }
+                fsm_dynamo_1.DyFM_Log.error(msg, this.constructErrors, '\n');
+                throw new fsm_dynamo_1.DyFM_Error({
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-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(),
+                });
+            }
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.__getDefaultErrorSettings('ready', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-111`,
+                error: error,
+            });
+        }
+    }
+    async stop() {
+        if (this.fnLogs)
+            console.log('\nfn:. stop-extended');
+        try {
+            if (this.started) {
+                await super.stop(true);
+                this.systemControlsExt.httpSocketServer.started = false;
+                this.systemControlsExt.httpsSocketServer.started = false;
+                await fsm_dynamo_1.DyFM_Array.asyncForEach(this.allSocketServers, async (socketServer) => {
+                    await new Promise((resolve, reject) => {
+                        socketServer.disconnectSockets(true);
+                        socketServer.close((err) => {
+                            if (err) {
+                                fsm_dynamo_1.DyFM_Log.error(`\nHTTP socket server close error`, err);
+                                reject(new fsm_dynamo_1.DyFM_Error({
+                                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-120`,
+                                    message: `SocketServer close failed.`,
+                                    error: err,
+                                }));
+                            }
+                            else {
+                                resolve();
+                            }
+                        });
+                    });
+                });
+                this.systemControlsExt.httpSocketServer.init = false;
+                this.systemControlsExt.httpsSocketServer.init = false;
+                await fsm_dynamo_1.DyFM_Async.delay(100);
+                fsm_dynamo_1.DyFM_Log.H_info(`"${this.params.name}" stopped successfully.`);
+            }
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.__getDefaultErrorSettings('stop', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-AES-121`,
+            });
+        }
+    }
+    /**
+     *
+     */
+    setSocketSecurity() {
+        if (this.fnLogs)
+            console.log('\nfn:. setSocketSecurity');
+        this.socketServices.forEach((service) => {
+            if (!this.socketSecurity) {
+                this.socketSecurity = route_security_enum_1.DyNTS_RouteSecurity[service.security];
+            }
+            else if (this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity.both &&
+                this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity[service.security]) {
+                this.socketSecurity = route_security_enum_1.DyNTS_RouteSecurity.both;
+            }
+        });
+    }
+    /**
+     * Socket szerverek felállítása. By default a socket a HTTP/HTTPS porton fut (same port);
+     * ha a service.port nincs megadva, a getPortSettings() httpPort/httpsPort értékét használjuk.
+     * Ha a base app már listenel (httpServer/httpsServer), arra attacholjuk a Socket.IO-t,
+     * különben külön httpSocketServer-t hozunk létre és listenelünk.
+     * A Socket.IO path a portSettings.socketPath-ből jön (default: DyNTS_defaultSocketPath); a kliensnek ugyanazt kell használnia.
+     */
+    async setupSocketServerServices() {
+        try {
+            if (this.fnLogs)
+                console.log('\nfn:. setupSocketServerServices');
+            const useBaseHttpServer = !!this.httpServer;
+            const useBaseHttpsServer = !!this.httpsServer;
+            if (this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity.secure) {
+                if (!this.openExpress) {
+                    await this.initOpenExpress();
+                }
+                if (!useBaseHttpServer && !this.httpSocketServer) {
+                    this.httpSocketServer = Http.createServer(this.openExpress);
+                }
+            }
+            if (this.socketSecurity !== route_security_enum_1.DyNTS_RouteSecurity.open) {
+                if (!this.httpsServer) {
+                    if (this.cert) {
+                        await this.initSecureExpress();
+                    }
+                    else {
+                        let errorMsg = `\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 DynamoNTSServer - setupRoutingModules() to enable secure routes.`;
+                        errorMsg += '\n\nThe socket services setted to use secure server:';
+                        this.socketServices.forEach((service) => {
+                            if (service.security !== socket_security_enum_1.DyNTS_SocketSecurity.open) {
+                                const effPort = service.port ??
+                                    this.portSettings.httpsPort;
+                                errorMsg += `\n  ${service?.name} (port: ${effPort})`;
+                            }
+                        });
+                        const error = new Error('Secure routes cannot be established!');
+                        const errorStack = error.stack.split('\n');
+                        errorStack.splice(1, 2);
+                        error.stack = errorStack.join('\n');
+                        fsm_dynamo_1.DyFM_Log.error(errorMsg);
+                        throw error;
+                    }
+                }
+            }
+            await fsm_dynamo_1.DyFM_Array.asyncForEach(this.socketServices, async (service) => {
+                try {
+                    const effectivePort = service.security === socket_security_enum_1.DyNTS_SocketSecurity.open
+                        ? (service.port ?? this.portSettings.httpPort)
+                        : (service.port ?? this.portSettings.httpsPort);
+                    if (effectivePort === undefined) {
+                        throw new Error(`PORT NOT SET: "${service.name}". ` +
+                            `Set port in getServiceParams() or ensure getPortSettings() returns httpPort/httpsPort.`);
+                    }
+                    if (service.security === socket_security_enum_1.DyNTS_SocketSecurity.open) {
+                        this.systemControlsExt.httpSocketServer.init = true;
+                        // BFR-MASTERPROMPTER-025 (a BFR-FDPTOKENSERVICE-007 3a2c381 utó-fix-e): az attach-mód
+                        // EXPLICIT opt-in (`dedicatedPort: true`), NEM a port-érték implicit inferenciája. A
+                        // korábbi `port≠httpPort → dedikált` inferencia CSENDBEN regresszálta a unified-shared
+                        // appokat, amelyek legacy-label/notif-konvenció okból adtak portot (MP live-igazolt:
+                        // realtime DEAD az nts-bump után; adventor/ccap/warbots latens). Mostantól:
+                        //   - default (dedicatedPort hiányzik/false) → SHARED (a fő szerverre attach, a port-label irreleváns);
+                        //   - dedicatedPort: true → saját Http.Server + listen a service.port-on (a bizonyított
+                        //     non-base útvonal tükre) — pl. a token-service szándékosan-dedikált notif-portja.
+                        if (service.dedicatedPort && (service.port === undefined || service.port === this.portSettings.httpPort)) {
+                            throw new Error(`SOCKET CONFIG ERROR: "${service.name}" dedicatedPort:true requires an explicit ` +
+                                `port that differs from the main httpPort (${this.portSettings.httpPort}).`);
+                        }
+                        const attachToMain = useBaseHttpServer && !service.dedicatedPort;
+                        const serverForOpen = attachToMain
+                            ? this.httpServer
+                            : (useBaseHttpServer
+                                ? Http.createServer(this.openExpress)
+                                : this.httpSocketServer);
+                        if (this.logSetup)
+                            console.log(`\nsocket setup (open): ${service?.name}:${effectivePort}` +
+                                (attachToMain ? ' (shared with HTTP)' : ' (dedicated port)'));
+                        this.httpSocketSettingUpCount++;
+                        this.systemControlsExt.httpSocketServer.started = false;
+                        const socketPath = this.portSettings.socketPath ?? default_socket_path_const_1.DyNTS_defaultSocketPath;
+                        this.allSocketServers.push(await service.setupSocketServer(new SocketIO.Server(serverForOpen, { path: socketPath }), socket_security_enum_1.DyNTS_SocketSecurity.open, () => {
+                            this.httpSocketSettingUpCount--;
+                            if (this.httpSocketSettingUpCount === 0) {
+                                this.systemControlsExt.httpSocketServer.started = true;
+                            }
+                        }, {
+                            attachedToExistingServer: attachToMain,
+                            effectivePort: effectivePort,
+                        }));
+                    }
+                    else if (service.security === socket_security_enum_1.DyNTS_SocketSecurity.secure) {
+                        this.systemControlsExt.httpsSocketServer.init = true;
+                        if (this.logSetup)
+                            console.log(`\nsocket setup (secure): ${service?.name}:${effectivePort}` +
+                                (useBaseHttpsServer ? ' (shared with HTTPS)' : ''));
+                        this.httpsSocketSettingUpCount++;
+                        this.systemControlsExt.httpsSocketServer.started = false;
+                        const socketPathSecure = this.portSettings.socketPath ?? default_socket_path_const_1.DyNTS_defaultSocketPath;
+                        this.allSocketServers.push(await service.setupSocketServer(new SocketIO.Server(this.httpsServer, { path: socketPathSecure }), socket_security_enum_1.DyNTS_SocketSecurity.secure, () => {
+                            this.httpsSocketSettingUpCount--;
+                            if (this.httpsSocketSettingUpCount === 0) {
+                                this.systemControlsExt.httpsSocketServer.started = true;
+                            }
+                        }, {
+                            attachedToExistingServer: useBaseHttpsServer,
+                            effectivePort: effectivePort,
+                        }));
+                    }
+                    else {
+                        const error = new Error(`INVALID Socket Service security: ${service.security} on ${service?.name}`);
+                        const errorStack = error.stack?.split('\n');
+                        errorStack.splice(1, 4);
+                        error.stack = errorStack.join('\n');
+                        fsm_dynamo_1.DyFM_Log.error(`\n${error.message}`);
+                        throw error;
+                    }
+                }
+                catch (error) {
+                    if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                        error.logSimple(`\nSocket Server service setup failed. (${service?.name})`);
+                    }
+                    else {
+                        fsm_dynamo_1.DyFM_Log.error(`\nSocket Server service setup failed. (${service?.name})`, error);
+                    }
+                    throw error;
+                }
+            });
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.error(`\nSocket Server services setup failed. (${this.socketServices?.length} services)\n`, error, '\n');
+            throw error;
+        }
+    }
+    __getDefaultErrorSettings(fnName, error) {
+        return {
+            status: error?.___status ?? 500,
+            message: error?.message ??
+                error?._message ??
+                `${fnName} was UNSUCCESSFUL (NTS)`,
+            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
+            addECToUserMsg: !error?.__userMessage,
+            issuerService: `${this?.constructor?.name}-DyNTS_AppExtended`,
+            level: fsm_dynamo_1.DyFM_ErrorLevel.fatal,
+            error: error,
+        };
+    }
+}
+exports.DyNTS_AppExtended = DyNTS_AppExtended;
 //# sourceMappingURL=app-extended.server.js.map