@futdevpro/nts-dynamo 1.15.156 → 1.15.157

package/build/_services/core/global.service.js

@@ -1,387 +1,387 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_GlobalService = void 0;
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-/* import { DyNTS_DBServiceCollection } from './db-service-collection.service'; */
-/* import { DyNTS_EmailServiceCollection } from './email-service-collection.service'; */
-const db_service_1 = require("../base/db.service");
-const singleton_service_1 = require("../base/singleton.service");
-/* import { DyNTS_archiveFlag } from '../../_collections/archive-flag.const'; */
-const archive_util_1 = require("../../_collections/archive.util");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-const safe_diagnostic_stage_type_enum_1 = require("../../_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum");
-const safe_diagnostic_control_service_1 = require("../../_modules/server/safe-diagnostic/safe-diagnostic.control-service");
-/**
- * This is the main Global/Core Service Collection used by DynamoNTS,
- * you also can use this to access main services as
- * dbServices, emailServices, or authService
- */
-class DyNTS_GlobalService extends singleton_service_1.DyNTS_SingletonService {
-    static getInstance() {
-        return DyNTS_GlobalService.getSingletonInstance();
-    }
-    static _params;
-    static get params() {
-        return this._params;
-    }
-    static _upSince = new Date();
-    static get upSince() {
-        return this._upSince;
-    }
-    static get upTime() {
-        return +new Date() - +this._upSince;
-    }
-    /**
-     * FR-258 / SR-2 — enumerate every registered DB service (one per data-model, including the
-     * auto-created `_archived` siblings). Used by the DyNTS_App startup TTL-installer to find the
-     * models that declared `retention` and create their MongoDB TTL index. Returns an empty array
-     * if services aren't set up yet (safe to call early).
-     */
-    static getAllDBServices() {
-        const collection = this.instance?.dbServiceCollection;
-        return collection ? Object.values(collection) : [];
-    }
-    authService;
-    dbServiceCollection;
-    /* dataServiceCollection: DyNTS_Service_Collection<any>; */
-    emailServiceCollection;
-    static defaultErrorUserMsg = `We encountered an unhandled Control Service Error, ` +
-        `\nplease contact the responsible development team.`;
-    static globalErrorHandler = async (error) => {
-        safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
-            code: 'DYNTS|GLOBAL|HANDLER_NOT_SET',
-            stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.globalErrorHandler,
-            error: error,
-        });
-    };
-    /**
-     * You need to setup global Services through this function
-     */
-    static async setServices(set) {
-        this.getInstance();
-        try {
-            await this.setDBServices(set?.dbModels);
-            await this.setAuthService(set?.authService);
-            await this.setEmailServices(set?.emailServiceCollection);
-            await this.setErrorHandler(set?.errorHandler);
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('setServices', error, 'DyNTS_GlobalService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SS0`,
-            });
-        }
-    }
-    static async setDBServices(dbModels) {
-        try {
-            this.instance.dbServiceCollection = {};
-            dbModels?.forEach((dbModel) => {
-                if (!dbModel) {
-                    throw new fsm_dynamo_1.DyFM_Error({
-                        ...this.getDefaultErrorSettings('setDBServices', new Error(`given dbModel is empty!`), 'DyNTS_GlobalService'),
-                        errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SDBS2`,
-                        additionalContent: {
-                            dbModels: dbModels,
-                            dbModelNames: dbModels.map((dbModel) => dbModel.dataName),
-                        },
-                    });
-                }
-                if (dbModel.addArchive) {
-                    const archiveModel = new fsm_dynamo_1.DyFM_DataModel_Params({
-                        ...dbModel,
-                        dataName: (0, archive_util_1.DyNTS_getArchivedDBName)(dbModel.dataName),
-                        properties: {
-                            ...dbModel.properties,
-                        },
-                    });
-                    dbModels.push(archiveModel);
-                }
-            });
-            dbModels?.forEach((dbModel) => {
-                this.createDBService(dbModel);
-            });
-            if (fsm_dynamo_1.DyFM_global_settings.log_settings.dbSetup) {
-                fsm_dynamo_1.DyFM_Log.info(`DB Services setup complete. DB Models:`, `\n  ${Object.keys(this.instance.dbServiceCollection).join('\n  ')}`);
-            }
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('setDBServices', error, 'DyNTS_GlobalService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SDBS0`,
-            });
-        }
-    }
-    static createDBService(dbModel) {
-        try {
-            if (!dbModel.constructed) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this.getDefaultErrorSettings('setDBServices', new Error(`"${dbModel.dataName}" dbModel is not constructed!` +
-                        `\n  use new DyFM_DataModel_Params() to properly construct it.`), 'DyNTS_GlobalService'),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-CDBS1`,
-                    additionalContent: {
-                        dbModel: dbModel,
-                    },
-                });
-            }
-            if (this.instance.dbServiceCollection[dbModel.dataName]) {
-                return;
-            }
-            try {
-                this.instance.dbServiceCollection[dbModel.dataName] = new db_service_1.DyNTS_DBService(dbModel);
-            }
-            catch (error) {
-                safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
-                    code: 'DYNTS|GLOBAL|DB_SERVICE_CREATE_FAILED',
-                    stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.bootstrap,
-                    error: error,
-                });
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this.getDefaultErrorSettings('setDBServices', error, 'DyNTS_GlobalService'),
-                    additionalContent: {
-                        dbModel: dbModel,
-                    },
-                });
-            }
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('createDBService', error, 'DyNTS_GlobalService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SDBS0`,
-            });
-        }
-    }
-    static unmountDBService(dbModel) {
-        try {
-            if (!this.instance.dbServiceCollection[dbModel.dataName]) {
-                return;
-            }
-            delete this.instance.dbServiceCollection[dbModel.dataName];
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('unmountDBService', error, 'DyNTS_GlobalService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-UDBS0`,
-            });
-        }
-    }
-    static async setAuthService(authService) {
-        try {
-            if (!authService) {
-                // Opcionális auth-service esetén ez VÁRT (public / no-auth szerver) — nincs warn.
-                if (!global_settings_const_1.DyNTS_global_settings.auth_settings?.optional) {
-                    fsm_dynamo_1.DyFM_Log.warn(`Authentication Service missing!`);
-                }
-            }
-            else {
-                this.instance.authService = authService;
-            }
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('setAuthService', error, 'DyNTS_GlobalService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SAS0`,
-            });
-        }
-    }
-    static async setEmailServices(emailServiceCollection) {
-        try {
-            this.instance.emailServiceCollection = emailServiceCollection ?? {};
-            await fsm_dynamo_1.DyFM_Array.asyncForEach(Object.keys(this.instance.emailServiceCollection), async (key) => {
-                await this.instance.emailServiceCollection[key].asyncPostConstruct();
-            });
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('setEmailServices', error, 'DyNTS_GlobalService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SS4`,
-            });
-        }
-    }
-    static async setErrorHandler(errorHandler) {
-        try {
-            DyNTS_GlobalService.globalErrorHandler = (async (error) => {
-                try {
-                    if (errorHandler) {
-                        await errorHandler(error);
-                        return;
-                    }
-                    fsm_dynamo_1.DyFM_Log.warn(`globalErrorHandler not set! (set in app.getGlobalServiceCollection)`, '\nwill use default-logging', '\n(If you set the globalErrorHandler, ' +
-                        'please check if it is using the same node_modules as the app)');
-                    safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
-                        code: 'DYNTS|GLOBAL|UNHANDLED_ERROR',
-                        stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.globalErrorHandler,
-                        error: error,
-                    });
-                }
-                catch (error) {
-                    safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
-                        code: 'DYNTS|GLOBAL|HANDLER_FAILED',
-                        stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.globalErrorHandler,
-                        error: error,
-                    });
-                }
-            });
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this.getDefaultErrorSettings('setErrorHandler', error, 'DyNTS_GlobalService'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SEH0`,
-            });
-        }
-    }
-    static setParams(params) {
-        this._params = params;
-    }
-    /**
-     *
-     * @returns
-     */
-    static getAuthService() {
-        if (!this.instance?.authService) {
-            // Ha az app explicit opcionálisnak jelölte az auth-service-t
-            // (DyNTS_global_settings.auth_settings.optional), NEM dobunk: undefined-ot
-            // adunk vissza. A hívók (pl. a request-path issuer-kinyerés) optional-
-            // chaining-gel kezelik. Public / no-auth szervereknek — így a
-            // "Unique Authentication Service missing!" hiba suppress-elhető beállításból.
-            if (global_settings_const_1.DyNTS_global_settings.auth_settings?.optional) {
-                return undefined;
-            }
-            throw new Error(`\n  Unique Authentication Service missing!` +
-                `\n    Please create a Unique Authentication Service extending DyNTS_AuthService, ` +
-                `\n      and Setup with DyNTS_GlobalServiceC.setServices(...)` +
-                '\n    (If you set the globalErrorHandler, ' +
-                'please check if it is using the same node_modules as the app)' +
-                '\n    (To run WITHOUT an auth service, set ' +
-                'DyNTS_global_settings.auth_settings.optional = true)');
-        }
-        return this.instance.authService;
-    }
-    /**
-     *
-     * @returns
-     */
-    static getDBServiceCollection() {
-        if (!this.instance?.dbServiceCollection) {
-            throw new Error(`\n  Unique DataBase Service Collection missing!` +
-                `\n    Please create a Unique DataBase Service Collection extending ` +
-                `DyNTS_DBServiceCollection, ` +
-                `\n      and Setup with DyNTS_GlobalServiceC.setServices(...)` +
-                '\n    (If you set the globalErrorHandler, ' +
-                'please check if it is using the same node_modules as the app)\n');
-        }
-        return this.instance.dbServiceCollection;
-    }
-    /**
-     *
-     * @param dataParams
-     * @returns
-     */
-    static getDBService(dataParams) {
-        return this.getDBServiceByKey(dataParams.dataName);
-    }
-    /**
-     *
-     * @param key
-     * @returns
-     */
-    static getDBServiceByKey(key) {
-        const collection = this.getDBServiceCollection();
-        if (collection[key]) {
-            return collection[key];
-        }
-        else {
-            throw new Error(`\n  DyNTS_GlobalService.getDBService failed, ERROR: ` +
-                `\n    no dbService on collection with this key: "${key}"!` +
-                '\n    (If you set the globalErrorHandler, ' +
-                'please check if it is using the same node_modules as the app)' +
-                `\n      The available dbServices on collection:` +
-                `\n        ${Object.keys(collection).join(', ')}\n`);
-        }
-    }
-    /**
-     *
-     * @returns
-     */
-    static getEmailServiceCollection() {
-        if (!this.instance.emailServiceCollection) {
-            throw new Error(`\n  Unique Email Service Collection missing!` +
-                `\n    Please create a Unique Email Service Collection extending ` +
-                `DyNTS_EmailServiceCollection, ` +
-                '\n    (If you set the globalErrorHandler, ' +
-                'please check if it is using the same node_modules as the app)' +
-                `\n      and Setup with DyNTS_GlobalServiceC.setServices(...)\n` +
-                `\n      available emailServiceCollection: ` +
-                `${Object().keys(this.instance.emailServiceCollection).join(', ')}\n`);
-        }
-        return this.instance.emailServiceCollection;
-    }
-    /**
-     *
-     * @returns
-     */
-    /* static getSocketServiceCollection(): DyNTS_SocketServiceCollection {
-      if (!this.instance?.socketServiceCollection) {
-        throw new Error(
-          `\nUnique Socket Service Collection missing!` +
-          `\nSocket Service Collection will only be created if there are Socket Services properly setted up ` +
-          `in the setupModules in the App using DyNTS_AppExtended, ` +
-          `and Setup with "DyNTS_GlobalServiceC.setServices(...)"`);
-      }
-  
-      return this.instance.socketServiceCollection;
-    } */
-    /**
-     *
-     * @param name
-     * @returns
-     */
-    /* static getSocketServiceByName(name: string): DyNTS_SocketService<any> {
-      const collection: DyNTS_SocketServiceCollection = this.getSocketServiceCollection();
-      if (collection[name]) {
-        return collection[name];
-      } else {
-        let names: string = `${Object.keys(collection)}`;
-        names = names.replace(/,/g, '\n                ');
-  
-        throw new Error(
-          `\nDyNTS_GlobalService.getSocketServiceByName failed, ERROR:
-          no socketService on collection with this name: ${name}!
-          The available socketServices on collection:
-                  ${names}\n`);
-      }
-    }
-  
-    static attachNewSocketService(service: DyNTS_SocketService<any>): void {
-      const collection: DyNTS_SocketServiceCollection = this.getSocketServiceCollection();
-      if (!collection[service.name]) {
-        collection[service.name] = service;
-      } else {
-        let names: string = `${Object.keys(collection)}`;
-        names = names.replace(/,/g, '\n                ');
-  
-        throw new Error(
-          `\nDyNTS_GlobalService.attachNewSocketService failed, ERROR:
-          socketService name is already taken on collection with this name: ${service.name}!
-          The available socketServices on collection:
-                  ${names}\n`);
-      }
-    } */
-    static getDefaultErrorSettings(fnName, error, issuer, 
-    /** @deprecated we wont support the separate user message in the future, use the message instead */
-    useMessageAsUserMessage = true) {
-        return {
-            status: error?.___status ?? 500,
-            message: error?.message ??
-                error?._message ??
-                `${fnName} was UNSUCCESSFUL (${global_settings_const_1.DyNTS_global_settings.systemShortCodeName})`,
-            addECToUserMsg: !error?.__userMessage,
-            userMessage: error?.__userMessage ??
-                (useMessageAsUserMessage ? error?.message : this.defaultErrorUserMsg),
-            issuer: issuer,
-            issuerService: this.constructor?.name,
-            error: error,
-        };
-    }
-}
-exports.DyNTS_GlobalService = DyNTS_GlobalService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_GlobalService = void 0;
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+/* import { DyNTS_DBServiceCollection } from './db-service-collection.service'; */
+/* import { DyNTS_EmailServiceCollection } from './email-service-collection.service'; */
+const db_service_1 = require("../base/db.service");
+const singleton_service_1 = require("../base/singleton.service");
+/* import { DyNTS_archiveFlag } from '../../_collections/archive-flag.const'; */
+const archive_util_1 = require("../../_collections/archive.util");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+const safe_diagnostic_stage_type_enum_1 = require("../../_modules/server/safe-diagnostic/safe-diagnostic-stage.type-enum");
+const safe_diagnostic_control_service_1 = require("../../_modules/server/safe-diagnostic/safe-diagnostic.control-service");
+/**
+ * This is the main Global/Core Service Collection used by DynamoNTS,
+ * you also can use this to access main services as
+ * dbServices, emailServices, or authService
+ */
+class DyNTS_GlobalService extends singleton_service_1.DyNTS_SingletonService {
+    static getInstance() {
+        return DyNTS_GlobalService.getSingletonInstance();
+    }
+    static _params;
+    static get params() {
+        return this._params;
+    }
+    static _upSince = new Date();
+    static get upSince() {
+        return this._upSince;
+    }
+    static get upTime() {
+        return +new Date() - +this._upSince;
+    }
+    /**
+     * FR-258 / SR-2 — enumerate every registered DB service (one per data-model, including the
+     * auto-created `_archived` siblings). Used by the DyNTS_App startup TTL-installer to find the
+     * models that declared `retention` and create their MongoDB TTL index. Returns an empty array
+     * if services aren't set up yet (safe to call early).
+     */
+    static getAllDBServices() {
+        const collection = this.instance?.dbServiceCollection;
+        return collection ? Object.values(collection) : [];
+    }
+    authService;
+    dbServiceCollection;
+    /* dataServiceCollection: DyNTS_Service_Collection<any>; */
+    emailServiceCollection;
+    static defaultErrorUserMsg = `We encountered an unhandled Control Service Error, ` +
+        `\nplease contact the responsible development team.`;
+    static globalErrorHandler = async (error) => {
+        safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
+            code: 'DYNTS|GLOBAL|HANDLER_NOT_SET',
+            stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.globalErrorHandler,
+            error: error,
+        });
+    };
+    /**
+     * You need to setup global Services through this function
+     */
+    static async setServices(set) {
+        this.getInstance();
+        try {
+            await this.setDBServices(set?.dbModels);
+            await this.setAuthService(set?.authService);
+            await this.setEmailServices(set?.emailServiceCollection);
+            await this.setErrorHandler(set?.errorHandler);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('setServices', error, 'DyNTS_GlobalService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SS0`,
+            });
+        }
+    }
+    static async setDBServices(dbModels) {
+        try {
+            this.instance.dbServiceCollection = {};
+            dbModels?.forEach((dbModel) => {
+                if (!dbModel) {
+                    throw new fsm_dynamo_1.DyFM_Error({
+                        ...this.getDefaultErrorSettings('setDBServices', new Error(`given dbModel is empty!`), 'DyNTS_GlobalService'),
+                        errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SDBS2`,
+                        additionalContent: {
+                            dbModels: dbModels,
+                            dbModelNames: dbModels.map((dbModel) => dbModel.dataName),
+                        },
+                    });
+                }
+                if (dbModel.addArchive) {
+                    const archiveModel = new fsm_dynamo_1.DyFM_DataModel_Params({
+                        ...dbModel,
+                        dataName: (0, archive_util_1.DyNTS_getArchivedDBName)(dbModel.dataName),
+                        properties: {
+                            ...dbModel.properties,
+                        },
+                    });
+                    dbModels.push(archiveModel);
+                }
+            });
+            dbModels?.forEach((dbModel) => {
+                this.createDBService(dbModel);
+            });
+            if (fsm_dynamo_1.DyFM_global_settings.log_settings.dbSetup) {
+                fsm_dynamo_1.DyFM_Log.info(`DB Services setup complete. DB Models:`, `\n  ${Object.keys(this.instance.dbServiceCollection).join('\n  ')}`);
+            }
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('setDBServices', error, 'DyNTS_GlobalService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SDBS0`,
+            });
+        }
+    }
+    static createDBService(dbModel) {
+        try {
+            if (!dbModel.constructed) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('setDBServices', new Error(`"${dbModel.dataName}" dbModel is not constructed!` +
+                        `\n  use new DyFM_DataModel_Params() to properly construct it.`), 'DyNTS_GlobalService'),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-CDBS1`,
+                    additionalContent: {
+                        dbModel: dbModel,
+                    },
+                });
+            }
+            if (this.instance.dbServiceCollection[dbModel.dataName]) {
+                return;
+            }
+            try {
+                this.instance.dbServiceCollection[dbModel.dataName] = new db_service_1.DyNTS_DBService(dbModel);
+            }
+            catch (error) {
+                safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
+                    code: 'DYNTS|GLOBAL|DB_SERVICE_CREATE_FAILED',
+                    stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.bootstrap,
+                    error: error,
+                });
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this.getDefaultErrorSettings('setDBServices', error, 'DyNTS_GlobalService'),
+                    additionalContent: {
+                        dbModel: dbModel,
+                    },
+                });
+            }
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('createDBService', error, 'DyNTS_GlobalService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SDBS0`,
+            });
+        }
+    }
+    static unmountDBService(dbModel) {
+        try {
+            if (!this.instance.dbServiceCollection[dbModel.dataName]) {
+                return;
+            }
+            delete this.instance.dbServiceCollection[dbModel.dataName];
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('unmountDBService', error, 'DyNTS_GlobalService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-UDBS0`,
+            });
+        }
+    }
+    static async setAuthService(authService) {
+        try {
+            if (!authService) {
+                // Opcionális auth-service esetén ez VÁRT (public / no-auth szerver) — nincs warn.
+                if (!global_settings_const_1.DyNTS_global_settings.auth_settings?.optional) {
+                    fsm_dynamo_1.DyFM_Log.warn(`Authentication Service missing!`);
+                }
+            }
+            else {
+                this.instance.authService = authService;
+            }
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('setAuthService', error, 'DyNTS_GlobalService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SAS0`,
+            });
+        }
+    }
+    static async setEmailServices(emailServiceCollection) {
+        try {
+            this.instance.emailServiceCollection = emailServiceCollection ?? {};
+            await fsm_dynamo_1.DyFM_Array.asyncForEach(Object.keys(this.instance.emailServiceCollection), async (key) => {
+                await this.instance.emailServiceCollection[key].asyncPostConstruct();
+            });
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('setEmailServices', error, 'DyNTS_GlobalService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SS4`,
+            });
+        }
+    }
+    static async setErrorHandler(errorHandler) {
+        try {
+            DyNTS_GlobalService.globalErrorHandler = (async (error) => {
+                try {
+                    if (errorHandler) {
+                        await errorHandler(error);
+                        return;
+                    }
+                    fsm_dynamo_1.DyFM_Log.warn(`globalErrorHandler not set! (set in app.getGlobalServiceCollection)`, '\nwill use default-logging', '\n(If you set the globalErrorHandler, ' +
+                        'please check if it is using the same node_modules as the app)');
+                    safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
+                        code: 'DYNTS|GLOBAL|UNHANDLED_ERROR',
+                        stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.globalErrorHandler,
+                        error: error,
+                    });
+                }
+                catch (error) {
+                    safe_diagnostic_control_service_1.DyNTS_SafeDiagnostic_ControlService.report({
+                        code: 'DYNTS|GLOBAL|HANDLER_FAILED',
+                        stage: safe_diagnostic_stage_type_enum_1.DyNTS_SafeDiagnosticStage_Type.globalErrorHandler,
+                        error: error,
+                    });
+                }
+            });
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this.getDefaultErrorSettings('setErrorHandler', error, 'DyNTS_GlobalService'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-GS0-SEH0`,
+            });
+        }
+    }
+    static setParams(params) {
+        this._params = params;
+    }
+    /**
+     *
+     * @returns
+     */
+    static getAuthService() {
+        if (!this.instance?.authService) {
+            // Ha az app explicit opcionálisnak jelölte az auth-service-t
+            // (DyNTS_global_settings.auth_settings.optional), NEM dobunk: undefined-ot
+            // adunk vissza. A hívók (pl. a request-path issuer-kinyerés) optional-
+            // chaining-gel kezelik. Public / no-auth szervereknek — így a
+            // "Unique Authentication Service missing!" hiba suppress-elhető beállításból.
+            if (global_settings_const_1.DyNTS_global_settings.auth_settings?.optional) {
+                return undefined;
+            }
+            throw new Error(`\n  Unique Authentication Service missing!` +
+                `\n    Please create a Unique Authentication Service extending DyNTS_AuthService, ` +
+                `\n      and Setup with DyNTS_GlobalServiceC.setServices(...)` +
+                '\n    (If you set the globalErrorHandler, ' +
+                'please check if it is using the same node_modules as the app)' +
+                '\n    (To run WITHOUT an auth service, set ' +
+                'DyNTS_global_settings.auth_settings.optional = true)');
+        }
+        return this.instance.authService;
+    }
+    /**
+     *
+     * @returns
+     */
+    static getDBServiceCollection() {
+        if (!this.instance?.dbServiceCollection) {
+            throw new Error(`\n  Unique DataBase Service Collection missing!` +
+                `\n    Please create a Unique DataBase Service Collection extending ` +
+                `DyNTS_DBServiceCollection, ` +
+                `\n      and Setup with DyNTS_GlobalServiceC.setServices(...)` +
+                '\n    (If you set the globalErrorHandler, ' +
+                'please check if it is using the same node_modules as the app)\n');
+        }
+        return this.instance.dbServiceCollection;
+    }
+    /**
+     *
+     * @param dataParams
+     * @returns
+     */
+    static getDBService(dataParams) {
+        return this.getDBServiceByKey(dataParams.dataName);
+    }
+    /**
+     *
+     * @param key
+     * @returns
+     */
+    static getDBServiceByKey(key) {
+        const collection = this.getDBServiceCollection();
+        if (collection[key]) {
+            return collection[key];
+        }
+        else {
+            throw new Error(`\n  DyNTS_GlobalService.getDBService failed, ERROR: ` +
+                `\n    no dbService on collection with this key: "${key}"!` +
+                '\n    (If you set the globalErrorHandler, ' +
+                'please check if it is using the same node_modules as the app)' +
+                `\n      The available dbServices on collection:` +
+                `\n        ${Object.keys(collection).join(', ')}\n`);
+        }
+    }
+    /**
+     *
+     * @returns
+     */
+    static getEmailServiceCollection() {
+        if (!this.instance.emailServiceCollection) {
+            throw new Error(`\n  Unique Email Service Collection missing!` +
+                `\n    Please create a Unique Email Service Collection extending ` +
+                `DyNTS_EmailServiceCollection, ` +
+                '\n    (If you set the globalErrorHandler, ' +
+                'please check if it is using the same node_modules as the app)' +
+                `\n      and Setup with DyNTS_GlobalServiceC.setServices(...)\n` +
+                `\n      available emailServiceCollection: ` +
+                `${Object().keys(this.instance.emailServiceCollection).join(', ')}\n`);
+        }
+        return this.instance.emailServiceCollection;
+    }
+    /**
+     *
+     * @returns
+     */
+    /* static getSocketServiceCollection(): DyNTS_SocketServiceCollection {
+      if (!this.instance?.socketServiceCollection) {
+        throw new Error(
+          `\nUnique Socket Service Collection missing!` +
+          `\nSocket Service Collection will only be created if there are Socket Services properly setted up ` +
+          `in the setupModules in the App using DyNTS_AppExtended, ` +
+          `and Setup with "DyNTS_GlobalServiceC.setServices(...)"`);
+      }
+  
+      return this.instance.socketServiceCollection;
+    } */
+    /**
+     *
+     * @param name
+     * @returns
+     */
+    /* static getSocketServiceByName(name: string): DyNTS_SocketService<any> {
+      const collection: DyNTS_SocketServiceCollection = this.getSocketServiceCollection();
+      if (collection[name]) {
+        return collection[name];
+      } else {
+        let names: string = `${Object.keys(collection)}`;
+        names = names.replace(/,/g, '\n                ');
+  
+        throw new Error(
+          `\nDyNTS_GlobalService.getSocketServiceByName failed, ERROR:
+          no socketService on collection with this name: ${name}!
+          The available socketServices on collection:
+                  ${names}\n`);
+      }
+    }
+  
+    static attachNewSocketService(service: DyNTS_SocketService<any>): void {
+      const collection: DyNTS_SocketServiceCollection = this.getSocketServiceCollection();
+      if (!collection[service.name]) {
+        collection[service.name] = service;
+      } else {
+        let names: string = `${Object.keys(collection)}`;
+        names = names.replace(/,/g, '\n                ');
+  
+        throw new Error(
+          `\nDyNTS_GlobalService.attachNewSocketService failed, ERROR:
+          socketService name is already taken on collection with this name: ${service.name}!
+          The available socketServices on collection:
+                  ${names}\n`);
+      }
+    } */
+    static getDefaultErrorSettings(fnName, error, issuer, 
+    /** @deprecated we wont support the separate user message in the future, use the message instead */
+    useMessageAsUserMessage = true) {
+        return {
+            status: error?.___status ?? 500,
+            message: error?.message ??
+                error?._message ??
+                `${fnName} was UNSUCCESSFUL (${global_settings_const_1.DyNTS_global_settings.systemShortCodeName})`,
+            addECToUserMsg: !error?.__userMessage,
+            userMessage: error?.__userMessage ??
+                (useMessageAsUserMessage ? error?.message : this.defaultErrorUserMsg),
+            issuer: issuer,
+            issuerService: this.constructor?.name,
+            error: error,
+        };
+    }
+}
+exports.DyNTS_GlobalService = DyNTS_GlobalService;
 //# sourceMappingURL=global.service.js.map