@futdevpro/nts-dynamo 1.15.64 → 1.15.68

package/build/_modules/socket/_services/socket-server.service.js

@@ -1,690 +1,690 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_SocketServerService = void 0;
-const tslib_1 = require("tslib");
-const SocketIO = tslib_1.__importStar(require("socket.io"));
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const socket_1 = require("@futdevpro/fsm-dynamo/socket");
-const global_settings_const_1 = require("../../../_collections/global-settings.const");
-const singleton_service_1 = require("../../../_services/base/singleton.service");
-const socket_security_enum_1 = require("../_enums/socket-security.enum");
-/**
- * You need to define the following functions:
- * ```ts
- * getServiceParams(): DyNTS_SocketServerServiceParams;
- *
- * getIncomingEvents(): DyFM_SocketEvent<any>[];
- *
- * getPresenceFromSubscriptionEventContent(
- *  socketSubscription: T_SubscriptionContent,
- *  socket: SocketIO.Socket
- * ): Promise<T_Presence>;
- * ```
- */
-class DyNTS_SocketServerService extends singleton_service_1.DyNTS_SingletonService {
-    params;
-    get name() { return this.params.name; }
-    get port() { return this.params.port; }
-    get security() { return this.params.security; }
-    get activeSubscriptionsCount() { return this.presences.length; }
-    openSocketServer;
-    secureSocketServer;
-    /* private connectEvent: DyFM_SocketEvent<SocketIO.Socket>; */
-    incomingEvents;
-    /* private subscriptionEvent: DyFM_SocketEvent<any>; */
-    /* private unsubscribeEvent: DyFM_SocketEvent<any>; */
-    presences = [];
-    get logSetup() { return global_settings_const_1.DyNTS_global_settings.log_settings.setup; }
-    get highDetailedLogs() { return global_settings_const_1.DyNTS_global_settings.log_settings.highDetailedLogs; }
-    defaultErrorUserMsg = `We encountered an unhandled Socket Server Error, ` +
-        `\nplease contact the responsible development team.`;
-    /* readonly thisLocationStack: string; */
-    constructor() {
-        super();
-        /* this.thisLocationStack = DyNTS_getStackLocation(); */
-        this.asyncConstructor().catch((error) => {
-            fsm_dynamo_1.DyFM_Log.error(`Socket Server Service setup failed: "${this.params?.name}" (${this.params?.port})`, error);
-        });
-    }
-    async asyncConstructor() {
-        try {
-            this.params = this.getServiceParams();
-            this.incomingEvents = this.getIncomingEvents() ?? [];
-            await this.prepareEvents();
-            if (this.logSetup)
-                console.log(`Socket Server Service setup done: "${this.params.name}" (${this.params.port}) ` +
-                    `security: ${this.params.security}\n`);
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.error(`Socket Server Service setup failed: "${this.params?.name}" (${this.params?.port})`, error);
-            throw new fsm_dynamo_1.DyFM_Error({
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-GPFSRC0`,
-                error: error,
-            });
-        }
-    }
-    /**
-     * You must setup events and required services for this function
-     */
-    async prepareEvents() {
-        try {
-            /** Setup connect event */
-            /* const connectEventIndex = this.incomingEvents.findIndex(
-              (event: DyFM_SocketEvent<any>) =>
-                event.eventKey === DyFM_SocketEvent_Key.connection
-            );
-      
-            if (0 <= connectEventIndex) {
-              this.connectEvent = this.incomingEvents.splice(connectEventIndex)[0];
-            } else {
-              this.connectEvent = new DyFM_SocketEvent({
-                eventKey: DyFM_SocketEvent_Key.connection,
-              });
-            }
-            this.connectEvent.serviceName = this.params.name; */
-            if (!this.getPresenceFromSubscriptionEventContent) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    error: new Error('getPresenceFromSubscriptionEventContent must be set'),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-PPE1`,
-                });
-            }
-            if (!this.getSubscriptionTasks) {
-                fsm_dynamo_1.DyFM_Log.warn(`You should not set the subscription event, ` +
-                    `in case you need additional steps for your subscriptions.`, `${this.params.name} (${this.params.port})`);
-            }
-            if (this.incomingEvents.find((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.subscribe)) {
-                fsm_dynamo_1.DyFM_Log.warn(`You need to use getSubscriptionTasks() ` +
-                    `instead of setting the subscribe event in getIncomingEvents().`, `${this.params.name} (${this.params.port})`);
-            }
-            if (!this.incomingEvents.find((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.unsubscribe)) {
-                fsm_dynamo_1.DyFM_Log.warn(`You should not set the unsubscribe event, ` +
-                    `in case you need additional steps for your unsubscribe.`, `${this.params.name} (${this.params.port})`);
-            }
-            if (this.incomingEvents.find((event) => !event.eventKey)) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    error: new Error('eventKey must be set'),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-PPE2`,
-                });
-            }
-            this.incomingEvents.push(new socket_1.DyFM_SocketEvent({
-                eventKey: socket_1.DyFM_SocketEvent_Key.disconnect,
-                tasks: [
-                    async (socket, issuer) => this.disconnectBaseTask(socket, issuer),
-                ],
-            }));
-            if (this.errorHandling) {
-                this.incomingEvents.push(new socket_1.DyFM_SocketEvent({
-                    serviceName: this.params.name,
-                    eventKey: socket_1.DyFM_SocketEvent_Key.error,
-                    tasks: [
-                        async (content) => this.errorHandling(content),
-                    ],
-                }));
-            }
-            else {
-                fsm_dynamo_1.DyFM_Log.warn(`You should not set the error event, ` +
-                    `in case you need additional steps for your error.`, `${this.params.name} (${this.params.port})`);
-                this.incomingEvents.push(new socket_1.DyFM_SocketEvent({
-                    serviceName: this.params.name,
-                    eventKey: socket_1.DyFM_SocketEvent_Key.error,
-                    tasks: [
-                        async (content) => {
-                            if (content instanceof fsm_dynamo_1.DyFM_Error) {
-                                content.logSimple(`=-->   socket-client (${this.params.name}) ERROR`);
-                            }
-                            else {
-                                fsm_dynamo_1.DyFM_Log.error(`=-->   socket-client (${this.params.name}) ERROR:`, content);
-                            }
-                        }
-                    ],
-                }));
-            }
-            // Merge incoming events of the same eventKey
-            const eventKeys = this.incomingEvents.map((event) => event.eventKey).filter((eventKey, index, self) => self.indexOf(eventKey) === index);
-            const mergedEvents = [];
-            eventKeys.forEach((eventKey) => {
-                const events = this.incomingEvents.filter((event) => event.eventKey === eventKey);
-                mergedEvents.push(new socket_1.DyFM_SocketEvent({
-                    eventKey: eventKey,
-                    preProcesses: events.map((event) => event.preProcesses).flat(),
-                    tasks: events.map((event) => event.tasks).flat(),
-                }));
-            });
-            this.incomingEvents = mergedEvents;
-            if (global_settings_const_1.DyNTS_global_settings.log_settings.setup) {
-                fsm_dynamo_1.DyFM_Log.log(`Socket Server Service - Event Preparation setup done: ` +
-                    `"${this.params?.name}" (${this.params?.port})` +
-                    `\nincomingEvents:`, this.incomingEvents.map((event) => `\n\t"${event.eventKey}": preProcesses: ${event.preProcesses?.length} ` +
-                    `tasks: ${event.tasks?.length}`));
-            }
-            // Set incoming events serviceName
-            this.incomingEvents.forEach((event) => {
-                event.serviceName = this.params.name;
-            });
-        }
-        catch (error) {
-            fsm_dynamo_1.DyFM_Log.error(`Socket Server Service - Event Preparation setup failed: ` +
-                `"${this.params?.name}" (${this.params?.port})`, error);
-            throw error;
-        }
-    }
-    // eslint-disable-next-line max-lines-per-function
-    async setupSocketServer(newSocketServer, security, successCallback, options) {
-        try {
-            if (this.highDetailedLogs)
-                console.log('\nfn:. setupSocketServer');
-            const effectivePort = options?.effectivePort ?? this.params.port;
-            newSocketServer.on(socket_1.DyFM_SocketEvent_Key.incomingNewConnection, async (socket) => {
-                try {
-                    let issuer;
-                    /* await this.connectEvent.executeEventTasks(socket); */
-                    await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.incomingNewConnection), async (event) => {
-                        await event.executeEventTasks(socket);
-                    });
-                    if (this.getPresenceFromSubscriptionEventContent) {
-                        socket.on(socket_1.DyFM_SocketEvent_Key.subscribe, async (content) => {
-                            let presence;
-                            try {
-                                /**
-                                 * usually socket logs are in event.executeEventTasks(),
-                                 * but subscribe event is an exception from this,
-                                 * to be able to check content before getPresenceFromSubscriptionEventContent
-                                 */
-                                if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
-                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
-                                        `event: "${socket_1.DyFM_SocketEvent_Key.subscribe}";` +
-                                        `\ncontent:`, content);
-                                }
-                                else {
-                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
-                                        `event: "${socket_1.DyFM_SocketEvent_Key.subscribe}"`);
-                                }
-                                presence = await this.getPresenceFromSubscriptionEventContent(content, socket);
-                                presence.serviceName = this.params.name;
-                                issuer = presence.issuerLocalId;
-                                this.addSocketToPresence(presence);
-                                /* await this.subscriptionEvent.executeEventTasks(content, issuer); */
-                                if (this.getSubscriptionTasks) {
-                                    await fsm_dynamo_1.DyFM_Array.asyncForEach(this.getSubscriptionTasks(), async (task) => {
-                                        await task(content, issuer);
-                                    });
-                                }
-                                socket.emit(socket_1.DyFM_SocketEvent_Key.subscriptionSuccessful, 'subscribe was successful', error => {
-                                    fsm_dynamo_1.DyFM_Log.error(`Emitting subscriptionSuccessful event failed!` +
-                                        `\nerror:`, error);
-                                });
-                                fsm_dynamo_1.DyFM_Log.success(`<-==>  socket(${this.params.name}) subscription successful (${issuer})`);
-                            }
-                            catch (error) {
-                                if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                                    error.logShort(`Socket Subscription failed: "${this.params.name}" ` +
-                                        `(${this.params.port}) will disconnect now...`);
-                                }
-                                else if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
-                                    fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params.name}" ` +
-                                        `(${this.params.port}) will disconnect now...`, 
-                                    /* `${this.thisLocationStack}`, */
-                                    error);
-                                }
-                                else {
-                                    fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params.name}" `, `(${this.params.port}) will disconnect now...`);
-                                }
-                                await this.closeSocket(socket, issuer, error);
-                            }
-                        });
-                        socket.on(socket_1.DyFM_SocketEvent_Key.unsubscribe, async (issuer) => {
-                            try {
-                                /**
-                                 * usually socket logs are in event.executeEventTasks(),
-                                 * but unsubscribe event is an exception from this,
-                                 * to be able to check content before getPresenceFromSubscriptionEventContent
-                                 */
-                                if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
-                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
-                                        `event: ${socket_1.DyFM_SocketEvent_Key.unsubscribe};` +
-                                        `\ncontent:`, issuer);
-                                }
-                                else {
-                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
-                                        `event: ${socket_1.DyFM_SocketEvent_Key.unsubscribe}`);
-                                }
-                                /* await this.unsubscribeEvent.executeEventTasks(null, issuer); */
-                                await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.unsubscribe), async (event) => {
-                                    await event.executeEventTasks(null, issuer);
-                                });
-                                this.removeSubscription(socket, issuer);
-                                socket.emit(socket_1.DyFM_SocketEvent_Key.unsubscribeSuccessful, 'unsubscribe was successful', error => {
-                                    fsm_dynamo_1.DyFM_Log.error(`Emitting unsubscribeSuccessful event failed!` +
-                                        `\nerror:`, error);
-                                });
-                                fsm_dynamo_1.DyFM_Log.success(`< x >  socket(${this.params.name}) unsubscribe successful (${issuer})`);
-                            }
-                            catch (error) {
-                                if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                                    error.logSimple(`Socket Unsubscription failed: "${this.params.name}" ` +
-                                        `(${this.params.port}) will disconnect now...`);
-                                }
-                                else if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
-                                    fsm_dynamo_1.DyFM_Log.error(`Socket unsubscribe failed: "${this.params.name}" `, `(${this.params.port}) will disconnect now...`, error);
-                                }
-                                else {
-                                    fsm_dynamo_1.DyFM_Log.error(`Socket unsubscribe failed: "${this.params.name}" `, `(${this.params.port}) will disconnect now...`);
-                                }
-                                socket.emit(socket_1.DyFM_SocketEvent_Key.error, error);
-                                this.removeSubscription(socket, issuer);
-                            }
-                        });
-                    }
-                    this.incomingEvents.filter((event) => event.eventKey !== socket_1.DyFM_SocketEvent_Key.incomingNewConnection &&
-                        event.eventKey !== socket_1.DyFM_SocketEvent_Key.subscribe &&
-                        event.eventKey !== socket_1.DyFM_SocketEvent_Key.unsubscribe).forEach((event) => {
-                        socket.on(event.eventKey, async (content) => {
-                            try {
-                                await event.executeEventTasks(content, issuer);
-                            }
-                            catch (error) {
-                                if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                                    error.logSimple(`Socket Event failed: "${this.params.name}" (${this.params.port})`);
-                                }
-                                else {
-                                    fsm_dynamo_1.DyFM_Log.error(`Socket Event failed: "${this.params.name}" (${this.params.port})`, error);
-                                }
-                                socket.emit(socket_1.DyFM_SocketEvent_Key.error, error);
-                            }
-                        });
-                    });
-                    if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_mainEvents) {
-                        fsm_dynamo_1.DyFM_Log.success(`<   >  socket(${this.params.name}): new CONNECTION established`);
-                    }
-                }
-                catch (error) {
-                    if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                        error.logSimple(`Socket Connection failed: "${this.params.name}" ` +
-                            `(${this.params.port}) will disconnect now...`);
-                    }
-                    else {
-                        fsm_dynamo_1.DyFM_Log.error(`Socket Connection failed: "${this.params.name}" ` +
-                            `(${this.params.port}) will disconnect now...`, error);
-                    }
-                    await this.closeSocket(socket, `${this.params.name} on connection error`, error);
-                }
-            });
-            const isAttach = options?.attachedToExistingServer === true ||
-                (this.params.port === undefined && options?.effectivePort !== undefined);
-            if (isAttach) {
-                fsm_dynamo_1.DyFM_Log.success(`\nsocket server setup finished: "${this.params.name}"` +
-                    (effectivePort !== undefined ? ` (attached to server on port: ${effectivePort})` : ' (attached to existing server)'));
-                successCallback();
-            }
-            else {
-                try {
-                    const portToListen = this.params.port ?? options?.effectivePort;
-                    if (portToListen === undefined) {
-                        throw new Error(`PORT NOT SET: "${this.params.name}". ` +
-                            `Either set port in getServiceParams() or pass effectivePort in setupSocketServer options.`);
-                    }
-                    newSocketServer.listen(portToListen);
-                    fsm_dynamo_1.DyFM_Log.success(`\nsocket server setup finished: "${this.params.name}"` +
-                        `\nsocket server listening on port: "${portToListen}"`);
-                }
-                catch (listenError) {
-                    const portForMsg = this.params.port ?? options?.effectivePort;
-                    const errorMessage = `Failed to bind socket server "${this.params.name}" to port ${portForMsg}. ` +
-                        `This could be due to port already in use or insufficient permissions. ` +
-                        `Please ensure the port is available and try again.`;
-                    fsm_dynamo_1.DyFM_Log.error(errorMessage, listenError);
-                    throw new Error(errorMessage);
-                }
-                successCallback();
-            }
-            if (security === socket_security_enum_1.DyNTS_SocketSecurity.open) {
-                this.openSocketServer = newSocketServer;
-                return this.openSocketServer;
-            }
-            else {
-                this.secureSocketServer = newSocketServer;
-                return this.secureSocketServer;
-            }
-        }
-        catch (error) {
-            if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                error.logSimple(`Socket Server Service - Deep Setup failed: "${this.params?.name}" ` +
-                    `(${this.params?.port})`);
-            }
-            else {
-                fsm_dynamo_1.DyFM_Log.error(`Socket Server Service - Deep Setup failed: "${this.params?.name}" ` +
-                    `(${this.params?.port})`, error);
-            }
-            throw error;
-        }
-    }
-    async addSocketToPresence(newPresence) {
-        try {
-            const activePresence = this.presences.find((pres) => pres.issuerLocalId === newPresence.issuerLocalId);
-            if (activePresence) {
-                activePresence.sockets.push(...newPresence.sockets);
-            }
-            else {
-                this.presences.push(newPresence);
-            }
-        }
-        catch (error) {
-            if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                error.logShort(`Socket Subscription failed: "${this.params?.name}" (${this.params?.port})`);
-            }
-            else if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
-                fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params?.name}" (${this.params?.port})`, 
-                /* `${this.thisLocationStack}`, */
-                error);
-            }
-            else {
-                fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params?.name}" (${this.params?.port})`);
-            }
-            throw error;
-        }
-    }
-    async closeSocket(socket, issuer, withError) {
-        try {
-            if (withError) {
-                socket.emit(socket_1.DyFM_SocketEvent_Key.error, withError);
-            }
-            await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.disconnect), async (event) => {
-                await event.executeEventTasks(null, issuer);
-            });
-            /* if (this.getSubscriptionCloseTasks) {
-              await DyFM_Array.asyncForEach(
-                this.getSubscriptionCloseTasks(),
-                async (task: DyFM_SocketEventTask<null>) => {
-                  await task(null, issuer);
-                }
-              );
-            } */
-            socket.emit(socket_1.DyFM_SocketEvent_Key.disconnect);
-            socket.disconnect();
-            await this.removeSocketFromPresence(socket);
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('closeSocket', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-CS0`,
-            });
-        }
-    }
-    async removeSocketFromPresence(socket) {
-        try {
-            const presence = this.presences.find((pres) => pres.sockets.includes(socket));
-            if (presence) {
-                const socketIndex = presence.sockets.indexOf(socket);
-                if (socketIndex !== -1) {
-                    presence.sockets.splice(socketIndex, 1);
-                }
-                if (presence.sockets.length === 0) {
-                    const presenceIndex = this.presences.indexOf(presence);
-                    if (presenceIndex !== -1) {
-                        this.presences.splice(presenceIndex, 1);
-                    }
-                }
-            }
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('removeSocketFromPresence', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RSO0`,
-            });
-        }
-    }
-    async disconnectBaseTask(socket, issuer) {
-        try {
-            if (!(socket instanceof SocketIO.Socket)) {
-                /* throw new DyFM_Error({
-                  ...this._getDefaultErrorSettings(
-                    'disconnectBaseTask',
-                    new Error('Socket is not a SocketIO.Socket, type: ' + typeof socket),
-                  ),
-                }); */
-                fsm_dynamo_1.DyFM_Log.error(`Socket is not a SocketIO.Socket, type: ${typeof socket}`, socket);
-                //TODO: remove all presences that have no socket
-            }
-            await this.removeSubscription(socket, issuer).catch(error => {
-                if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                    error.logShort(`Remove Subscription failed: "${this.params.name}" (${this.params.port})`);
-                }
-                else {
-                    fsm_dynamo_1.DyFM_Log.error(`Remove Subscription failed: "${this.params.name}" (${this.params.port})`, error);
-                }
-            });
-            fsm_dynamo_1.DyFM_Log.info(`< x >  socket(${this.params.name}) disconnected (${issuer})`);
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('disconnectBaseTask', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-DBT0`,
-            });
-        }
-    }
-    async removeSubscription(socket, issuer) {
-        try {
-            if (!this.presences.length) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('removeSubscription', new Error(`No presences found (${this.params.name})`), issuer ?? 'unknown issuer'),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS1`,
-                });
-            }
-            const activePresenceIndex = this.presences.findIndex((pres) => pres.sockets.includes(socket));
-            if (activePresenceIndex === -1) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`closing socket (${this.params.name}) does not match any in the activePresences`), issuer ?? 'unknown issuer'),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS2`,
-                });
-            }
-            const activePresence = this.presences[activePresenceIndex];
-            if (issuer && activePresence.issuerLocalId !== issuer) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`socket unsubscription for "${issuer}" and ` +
-                        `"${activePresence.issuerLocalId}" does not match.`), issuer),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS3`,
-                });
-            }
-            const socketIndex = activePresence.sockets.findIndex((s) => s === socket);
-            if (socketIndex === -1) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`closing socket (${this.params.name}) does not match any in the activePresences`), activePresence.issuerLocalId),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS4`,
-                });
-            }
-            activePresence.sockets.splice(socketIndex);
-            await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.unsubscribeSuccessful), async (event) => {
-                await event.executeEventTasks(null, issuer);
-            });
-            /* if (this.getSubscriptionCloseTasks) {
-              await DyFM_Array.asyncForEach(
-                this.getSubscriptionCloseTasks(),
-                async (task: DyFM_SocketEventTask<null>) => {
-                  await task(null, issuer);
-                }
-              );
-            } */
-            if (activePresence.sockets.length === 0) {
-                this.presences.splice(activePresenceIndex);
-            }
-            socket.emit(socket_1.DyFM_SocketEvent_Key.unsubscribeSuccessful, 'unsubscribe was successful');
-            socket.disconnect();
-            fsm_dynamo_1.DyFM_Log.info(`<x==>  socket (${this.params.name}) unsubscription successful (${issuer})`);
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('sendEventForId', error, issuer ?? 'unknown issuer'),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS0`,
-                message: `socket (${this.params.name}) Subscription Removal failed: "${this.params?.name}"`,
-            });
-        }
-    }
-    /* emitServerEvent(event: string, content: any): void {
-      try {
-        DyFM_Log.log(` <=--  emitting server socket(${this.params.name}) event: ${event}`);
-  
-        this.openSocketServer.emit(event, content, error => {
-          DyFM_Log.error(`Emitting server event '${event}' failed!\nerror:`, error);
-        });
-      } catch (error) {
-        throw new DyFM_Error({
-          ...this._getDefaultErrorSettings(
-            'emitEvent',
-            error
-          ),
-  
-          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-500',
-          message: `socket(${this.params.name}) Event Emit (${event}) failed: ${this.params?.name}`,
-        });
-      }
-    } */
-    idIsSubscribed(id) {
-        try {
-            return !!this.presences.find((presence) => presence.issuerLocalId === id);
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('idIsSubscribed', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-IIS0`,
-                message: `socket (${this.params.name}) ID Subscription Check (${id}) failed`,
-            });
-        }
-    }
-    async emitError(presenceIssuerId, error, issuer) {
-        try {
-            await this.sendEventForId(presenceIssuerId, socket_1.DyFM_SocketEvent_Key.error, error, issuer);
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('emitError', error, presenceIssuerId),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-EE0`,
-                message: `socket (${this.params.name}) Error Emit (id: ${presenceIssuerId}) failed`,
-            });
-        }
-    }
-    async sendEventForId(id, event, content, issuer) {
-        try {
-            if (!event) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('sendEventForId', new Error('No event was provided'), content?.source),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI1`,
-                });
-            }
-            if (!id) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('sendEventForId', new Error('No ID was provided'), content?.source),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI2`,
-                });
-            }
-            const presence = this.presences.find((pres) => pres.issuerLocalId === id);
-            if (!presence) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`No active socket with this specific ID: "${id}"`), content?.source),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI3`,
-                });
-            }
-            presence.emitEvent(event, content, issuer);
-            if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
-                fsm_dynamo_1.DyFM_Log.success(` <--=  emitted socket (${this.params.name}) event: "${event}", ` +
-                    `\n         presenceId: "${id}", sockets: ${presence.sockets.length}` +
-                    `\n         content:`, content);
-            }
-            else {
-                fsm_dynamo_1.DyFM_Log.success(` <--=  emitted socket (${this.params.name}) event: "${event}", ` +
-                    `\n         presenceId: ${id}, sockets: ${presence.sockets.length}`);
-            }
-        }
-        catch (error) {
-            try {
-                if (error?.flag?.includes(fsm_dynamo_1.DyFM_errorFlag) && error?.additionalInfo?.inactiveSockets) {
-                    const sockets = error.additionalInfo.inactiveSockets;
-                    await fsm_dynamo_1.DyFM_Array.asyncForEach(sockets, async (socket) => {
-                        await this.removeSubscription(socket);
-                    });
-                    const presence = this.presences.find((pres) => pres.issuerLocalId === id);
-                    if (!presence) {
-                        throw new fsm_dynamo_1.DyFM_Error({
-                            ...this._getDefaultErrorSettings('sendEventForId', new Error(`No active socket (${this.params.name}) with this specific ID: "${id}"`), content?.source),
-                            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI4`,
-                        });
-                    }
-                }
-            }
-            catch (error) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('sendEventForId', error, content?.source),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI5`,
-                    message: `Error handling of inactive sockets (${this.params.name}) failed!` +
-                        `\n(Socket Event Emit for id (${id}, ${event}) failed)`,
-                });
-            }
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('sendEventForId', error, content?.source),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI0`,
-                message: `socket (${this.params.name}) Event Emit for id (${id}, ${event}) failed`,
-            });
-        }
-    }
-    async broadcastEvent(event, content, issuer) {
-        try {
-            fsm_dynamo_1.DyFM_Log.log(`<=-==  broadcasting socket (${this.params.name}) event: "${event}"`);
-            this.presences.forEach((presence) => {
-                presence.emitEvent(event, content, issuer);
-            });
-        }
-        catch (error) {
-            if (global_settings_const_1.DyNTS_global_settings.log_settings.detailedErrors) {
-                if (error instanceof fsm_dynamo_1.DyFM_Error) {
-                    error.logSimple(`socket (${this.params.name}) Event Broadcast (${event}) failed`);
-                }
-                else {
-                    fsm_dynamo_1.DyFM_Log.error(`socket (${this.params.name}) Event Broadcast (${event}) failed`, error);
-                }
-            }
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('broadcastEvent', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-BE0`,
-                message: `socket (${this.params.name}) Event Broadcast (${event}) failed`,
-            });
-        }
-    }
-    async sendError(error, issuer) {
-        try {
-            await this.sendEventForId(issuer, socket_1.DyFM_SocketEvent_Key.error, error, issuer);
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('sendError', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SE0`,
-                message: `socket (${this.params.name}) Error Send (${issuer}) failed`,
-            });
-        }
-    }
-    _getDefaultErrorSettings(fnName, error, issuer) {
-        return {
-            status: error?.___status ?? 500,
-            message: error?.message ??
-                error?._message ??
-                `${fnName} was UNSUCCESSFUL (NTS)`,
-            addECToUserMsg: !error?.__userMessage,
-            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
-            issuer: issuer,
-            issuerService: this.constructor?.name,
-            error: error,
-        };
-    }
-    /**
-     * You can setup tasks for the unsubscribe event in this function
-     */
-    /* protected getUnsubscribeTasks?(): DyFM_SocketEventTask<T_SubscriptionContent>[]; */
-    /**
-     * You can setup preprocesses for the unsubscribe event in this function
-     */
-    /* protected getUnsubscribePreProcesses?(): DyFM_SocketEventPreprocessTask[]; */
-    /**
-     * You can setup tasks for the error event in this function
-     */
-    errorHandling;
-}
-exports.DyNTS_SocketServerService = DyNTS_SocketServerService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_SocketServerService = void 0;
+const tslib_1 = require("tslib");
+const SocketIO = tslib_1.__importStar(require("socket.io"));
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const socket_1 = require("@futdevpro/fsm-dynamo/socket");
+const global_settings_const_1 = require("../../../_collections/global-settings.const");
+const singleton_service_1 = require("../../../_services/base/singleton.service");
+const socket_security_enum_1 = require("../_enums/socket-security.enum");
+/**
+ * You need to define the following functions:
+ * ```ts
+ * getServiceParams(): DyNTS_SocketServerServiceParams;
+ *
+ * getIncomingEvents(): DyFM_SocketEvent<any>[];
+ *
+ * getPresenceFromSubscriptionEventContent(
+ *  socketSubscription: T_SubscriptionContent,
+ *  socket: SocketIO.Socket
+ * ): Promise<T_Presence>;
+ * ```
+ */
+class DyNTS_SocketServerService extends singleton_service_1.DyNTS_SingletonService {
+    params;
+    get name() { return this.params.name; }
+    get port() { return this.params.port; }
+    get security() { return this.params.security; }
+    get activeSubscriptionsCount() { return this.presences.length; }
+    openSocketServer;
+    secureSocketServer;
+    /* private connectEvent: DyFM_SocketEvent<SocketIO.Socket>; */
+    incomingEvents;
+    /* private subscriptionEvent: DyFM_SocketEvent<any>; */
+    /* private unsubscribeEvent: DyFM_SocketEvent<any>; */
+    presences = [];
+    get logSetup() { return global_settings_const_1.DyNTS_global_settings.log_settings.setup; }
+    get highDetailedLogs() { return global_settings_const_1.DyNTS_global_settings.log_settings.highDetailedLogs; }
+    defaultErrorUserMsg = `We encountered an unhandled Socket Server Error, ` +
+        `\nplease contact the responsible development team.`;
+    /* readonly thisLocationStack: string; */
+    constructor() {
+        super();
+        /* this.thisLocationStack = DyNTS_getStackLocation(); */
+        this.asyncConstructor().catch((error) => {
+            fsm_dynamo_1.DyFM_Log.error(`Socket Server Service setup failed: "${this.params?.name}" (${this.params?.port})`, error);
+        });
+    }
+    async asyncConstructor() {
+        try {
+            this.params = this.getServiceParams();
+            this.incomingEvents = this.getIncomingEvents() ?? [];
+            await this.prepareEvents();
+            if (this.logSetup)
+                console.log(`Socket Server Service setup done: "${this.params.name}" (${this.params.port}) ` +
+                    `security: ${this.params.security}\n`);
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.error(`Socket Server Service setup failed: "${this.params?.name}" (${this.params?.port})`, error);
+            throw new fsm_dynamo_1.DyFM_Error({
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-GPFSRC0`,
+                error: error,
+            });
+        }
+    }
+    /**
+     * You must setup events and required services for this function
+     */
+    async prepareEvents() {
+        try {
+            /** Setup connect event */
+            /* const connectEventIndex = this.incomingEvents.findIndex(
+              (event: DyFM_SocketEvent<any>) =>
+                event.eventKey === DyFM_SocketEvent_Key.connection
+            );
+      
+            if (0 <= connectEventIndex) {
+              this.connectEvent = this.incomingEvents.splice(connectEventIndex)[0];
+            } else {
+              this.connectEvent = new DyFM_SocketEvent({
+                eventKey: DyFM_SocketEvent_Key.connection,
+              });
+            }
+            this.connectEvent.serviceName = this.params.name; */
+            if (!this.getPresenceFromSubscriptionEventContent) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    error: new Error('getPresenceFromSubscriptionEventContent must be set'),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-PPE1`,
+                });
+            }
+            if (!this.getSubscriptionTasks) {
+                fsm_dynamo_1.DyFM_Log.warn(`You should not set the subscription event, ` +
+                    `in case you need additional steps for your subscriptions.`, `${this.params.name} (${this.params.port})`);
+            }
+            if (this.incomingEvents.find((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.subscribe)) {
+                fsm_dynamo_1.DyFM_Log.warn(`You need to use getSubscriptionTasks() ` +
+                    `instead of setting the subscribe event in getIncomingEvents().`, `${this.params.name} (${this.params.port})`);
+            }
+            if (!this.incomingEvents.find((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.unsubscribe)) {
+                fsm_dynamo_1.DyFM_Log.warn(`You should not set the unsubscribe event, ` +
+                    `in case you need additional steps for your unsubscribe.`, `${this.params.name} (${this.params.port})`);
+            }
+            if (this.incomingEvents.find((event) => !event.eventKey)) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    error: new Error('eventKey must be set'),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-PPE2`,
+                });
+            }
+            this.incomingEvents.push(new socket_1.DyFM_SocketEvent({
+                eventKey: socket_1.DyFM_SocketEvent_Key.disconnect,
+                tasks: [
+                    async (socket, issuer) => this.disconnectBaseTask(socket, issuer),
+                ],
+            }));
+            if (this.errorHandling) {
+                this.incomingEvents.push(new socket_1.DyFM_SocketEvent({
+                    serviceName: this.params.name,
+                    eventKey: socket_1.DyFM_SocketEvent_Key.error,
+                    tasks: [
+                        async (content) => this.errorHandling(content),
+                    ],
+                }));
+            }
+            else {
+                fsm_dynamo_1.DyFM_Log.warn(`You should not set the error event, ` +
+                    `in case you need additional steps for your error.`, `${this.params.name} (${this.params.port})`);
+                this.incomingEvents.push(new socket_1.DyFM_SocketEvent({
+                    serviceName: this.params.name,
+                    eventKey: socket_1.DyFM_SocketEvent_Key.error,
+                    tasks: [
+                        async (content) => {
+                            if (content instanceof fsm_dynamo_1.DyFM_Error) {
+                                content.logSimple(`=-->   socket-client (${this.params.name}) ERROR`);
+                            }
+                            else {
+                                fsm_dynamo_1.DyFM_Log.error(`=-->   socket-client (${this.params.name}) ERROR:`, content);
+                            }
+                        }
+                    ],
+                }));
+            }
+            // Merge incoming events of the same eventKey
+            const eventKeys = this.incomingEvents.map((event) => event.eventKey).filter((eventKey, index, self) => self.indexOf(eventKey) === index);
+            const mergedEvents = [];
+            eventKeys.forEach((eventKey) => {
+                const events = this.incomingEvents.filter((event) => event.eventKey === eventKey);
+                mergedEvents.push(new socket_1.DyFM_SocketEvent({
+                    eventKey: eventKey,
+                    preProcesses: events.map((event) => event.preProcesses).flat(),
+                    tasks: events.map((event) => event.tasks).flat(),
+                }));
+            });
+            this.incomingEvents = mergedEvents;
+            if (global_settings_const_1.DyNTS_global_settings.log_settings.setup) {
+                fsm_dynamo_1.DyFM_Log.log(`Socket Server Service - Event Preparation setup done: ` +
+                    `"${this.params?.name}" (${this.params?.port})` +
+                    `\nincomingEvents:`, this.incomingEvents.map((event) => `\n\t"${event.eventKey}": preProcesses: ${event.preProcesses?.length} ` +
+                    `tasks: ${event.tasks?.length}`));
+            }
+            // Set incoming events serviceName
+            this.incomingEvents.forEach((event) => {
+                event.serviceName = this.params.name;
+            });
+        }
+        catch (error) {
+            fsm_dynamo_1.DyFM_Log.error(`Socket Server Service - Event Preparation setup failed: ` +
+                `"${this.params?.name}" (${this.params?.port})`, error);
+            throw error;
+        }
+    }
+    // eslint-disable-next-line max-lines-per-function
+    async setupSocketServer(newSocketServer, security, successCallback, options) {
+        try {
+            if (this.highDetailedLogs)
+                console.log('\nfn:. setupSocketServer');
+            const effectivePort = options?.effectivePort ?? this.params.port;
+            newSocketServer.on(socket_1.DyFM_SocketEvent_Key.incomingNewConnection, async (socket) => {
+                try {
+                    let issuer;
+                    /* await this.connectEvent.executeEventTasks(socket); */
+                    await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.incomingNewConnection), async (event) => {
+                        await event.executeEventTasks(socket);
+                    });
+                    if (this.getPresenceFromSubscriptionEventContent) {
+                        socket.on(socket_1.DyFM_SocketEvent_Key.subscribe, async (content) => {
+                            let presence;
+                            try {
+                                /**
+                                 * usually socket logs are in event.executeEventTasks(),
+                                 * but subscribe event is an exception from this,
+                                 * to be able to check content before getPresenceFromSubscriptionEventContent
+                                 */
+                                if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
+                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
+                                        `event: "${socket_1.DyFM_SocketEvent_Key.subscribe}";` +
+                                        `\ncontent:`, content);
+                                }
+                                else {
+                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
+                                        `event: "${socket_1.DyFM_SocketEvent_Key.subscribe}"`);
+                                }
+                                presence = await this.getPresenceFromSubscriptionEventContent(content, socket);
+                                presence.serviceName = this.params.name;
+                                issuer = presence.issuerLocalId;
+                                this.addSocketToPresence(presence);
+                                /* await this.subscriptionEvent.executeEventTasks(content, issuer); */
+                                if (this.getSubscriptionTasks) {
+                                    await fsm_dynamo_1.DyFM_Array.asyncForEach(this.getSubscriptionTasks(), async (task) => {
+                                        await task(content, issuer);
+                                    });
+                                }
+                                socket.emit(socket_1.DyFM_SocketEvent_Key.subscriptionSuccessful, 'subscribe was successful', error => {
+                                    fsm_dynamo_1.DyFM_Log.error(`Emitting subscriptionSuccessful event failed!` +
+                                        `\nerror:`, error);
+                                });
+                                fsm_dynamo_1.DyFM_Log.success(`<-==>  socket(${this.params.name}) subscription successful (${issuer})`);
+                            }
+                            catch (error) {
+                                if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                                    error.logShort(`Socket Subscription failed: "${this.params.name}" ` +
+                                        `(${this.params.port}) will disconnect now...`);
+                                }
+                                else if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
+                                    fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params.name}" ` +
+                                        `(${this.params.port}) will disconnect now...`, 
+                                    /* `${this.thisLocationStack}`, */
+                                    error);
+                                }
+                                else {
+                                    fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params.name}" `, `(${this.params.port}) will disconnect now...`);
+                                }
+                                await this.closeSocket(socket, issuer, error);
+                            }
+                        });
+                        socket.on(socket_1.DyFM_SocketEvent_Key.unsubscribe, async (issuer) => {
+                            try {
+                                /**
+                                 * usually socket logs are in event.executeEventTasks(),
+                                 * but unsubscribe event is an exception from this,
+                                 * to be able to check content before getPresenceFromSubscriptionEventContent
+                                 */
+                                if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
+                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
+                                        `event: ${socket_1.DyFM_SocketEvent_Key.unsubscribe};` +
+                                        `\ncontent:`, issuer);
+                                }
+                                else {
+                                    fsm_dynamo_1.DyFM_Log.log(`--=>   incoming socket (${this.params.name}) ` +
+                                        `event: ${socket_1.DyFM_SocketEvent_Key.unsubscribe}`);
+                                }
+                                /* await this.unsubscribeEvent.executeEventTasks(null, issuer); */
+                                await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.unsubscribe), async (event) => {
+                                    await event.executeEventTasks(null, issuer);
+                                });
+                                this.removeSubscription(socket, issuer);
+                                socket.emit(socket_1.DyFM_SocketEvent_Key.unsubscribeSuccessful, 'unsubscribe was successful', error => {
+                                    fsm_dynamo_1.DyFM_Log.error(`Emitting unsubscribeSuccessful event failed!` +
+                                        `\nerror:`, error);
+                                });
+                                fsm_dynamo_1.DyFM_Log.success(`< x >  socket(${this.params.name}) unsubscribe successful (${issuer})`);
+                            }
+                            catch (error) {
+                                if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                                    error.logSimple(`Socket Unsubscription failed: "${this.params.name}" ` +
+                                        `(${this.params.port}) will disconnect now...`);
+                                }
+                                else if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
+                                    fsm_dynamo_1.DyFM_Log.error(`Socket unsubscribe failed: "${this.params.name}" `, `(${this.params.port}) will disconnect now...`, error);
+                                }
+                                else {
+                                    fsm_dynamo_1.DyFM_Log.error(`Socket unsubscribe failed: "${this.params.name}" `, `(${this.params.port}) will disconnect now...`);
+                                }
+                                socket.emit(socket_1.DyFM_SocketEvent_Key.error, error);
+                                this.removeSubscription(socket, issuer);
+                            }
+                        });
+                    }
+                    this.incomingEvents.filter((event) => event.eventKey !== socket_1.DyFM_SocketEvent_Key.incomingNewConnection &&
+                        event.eventKey !== socket_1.DyFM_SocketEvent_Key.subscribe &&
+                        event.eventKey !== socket_1.DyFM_SocketEvent_Key.unsubscribe).forEach((event) => {
+                        socket.on(event.eventKey, async (content) => {
+                            try {
+                                await event.executeEventTasks(content, issuer);
+                            }
+                            catch (error) {
+                                if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                                    error.logSimple(`Socket Event failed: "${this.params.name}" (${this.params.port})`);
+                                }
+                                else {
+                                    fsm_dynamo_1.DyFM_Log.error(`Socket Event failed: "${this.params.name}" (${this.params.port})`, error);
+                                }
+                                socket.emit(socket_1.DyFM_SocketEvent_Key.error, error);
+                            }
+                        });
+                    });
+                    if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_mainEvents) {
+                        fsm_dynamo_1.DyFM_Log.success(`<   >  socket(${this.params.name}): new CONNECTION established`);
+                    }
+                }
+                catch (error) {
+                    if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                        error.logSimple(`Socket Connection failed: "${this.params.name}" ` +
+                            `(${this.params.port}) will disconnect now...`);
+                    }
+                    else {
+                        fsm_dynamo_1.DyFM_Log.error(`Socket Connection failed: "${this.params.name}" ` +
+                            `(${this.params.port}) will disconnect now...`, error);
+                    }
+                    await this.closeSocket(socket, `${this.params.name} on connection error`, error);
+                }
+            });
+            const isAttach = options?.attachedToExistingServer === true ||
+                (this.params.port === undefined && options?.effectivePort !== undefined);
+            if (isAttach) {
+                fsm_dynamo_1.DyFM_Log.success(`\nsocket server setup finished: "${this.params.name}"` +
+                    (effectivePort !== undefined ? ` (attached to server on port: ${effectivePort})` : ' (attached to existing server)'));
+                successCallback();
+            }
+            else {
+                try {
+                    const portToListen = this.params.port ?? options?.effectivePort;
+                    if (portToListen === undefined) {
+                        throw new Error(`PORT NOT SET: "${this.params.name}". ` +
+                            `Either set port in getServiceParams() or pass effectivePort in setupSocketServer options.`);
+                    }
+                    newSocketServer.listen(portToListen);
+                    fsm_dynamo_1.DyFM_Log.success(`\nsocket server setup finished: "${this.params.name}"` +
+                        `\nsocket server listening on port: "${portToListen}"`);
+                }
+                catch (listenError) {
+                    const portForMsg = this.params.port ?? options?.effectivePort;
+                    const errorMessage = `Failed to bind socket server "${this.params.name}" to port ${portForMsg}. ` +
+                        `This could be due to port already in use or insufficient permissions. ` +
+                        `Please ensure the port is available and try again.`;
+                    fsm_dynamo_1.DyFM_Log.error(errorMessage, listenError);
+                    throw new Error(errorMessage);
+                }
+                successCallback();
+            }
+            if (security === socket_security_enum_1.DyNTS_SocketSecurity.open) {
+                this.openSocketServer = newSocketServer;
+                return this.openSocketServer;
+            }
+            else {
+                this.secureSocketServer = newSocketServer;
+                return this.secureSocketServer;
+            }
+        }
+        catch (error) {
+            if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                error.logSimple(`Socket Server Service - Deep Setup failed: "${this.params?.name}" ` +
+                    `(${this.params?.port})`);
+            }
+            else {
+                fsm_dynamo_1.DyFM_Log.error(`Socket Server Service - Deep Setup failed: "${this.params?.name}" ` +
+                    `(${this.params?.port})`, error);
+            }
+            throw error;
+        }
+    }
+    async addSocketToPresence(newPresence) {
+        try {
+            const activePresence = this.presences.find((pres) => pres.issuerLocalId === newPresence.issuerLocalId);
+            if (activePresence) {
+                activePresence.sockets.push(...newPresence.sockets);
+            }
+            else {
+                this.presences.push(newPresence);
+            }
+        }
+        catch (error) {
+            if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                error.logShort(`Socket Subscription failed: "${this.params?.name}" (${this.params?.port})`);
+            }
+            else if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
+                fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params?.name}" (${this.params?.port})`, 
+                /* `${this.thisLocationStack}`, */
+                error);
+            }
+            else {
+                fsm_dynamo_1.DyFM_Log.error(`Socket Subscription failed: "${this.params?.name}" (${this.params?.port})`);
+            }
+            throw error;
+        }
+    }
+    async closeSocket(socket, issuer, withError) {
+        try {
+            if (withError) {
+                socket.emit(socket_1.DyFM_SocketEvent_Key.error, withError);
+            }
+            await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.disconnect), async (event) => {
+                await event.executeEventTasks(null, issuer);
+            });
+            /* if (this.getSubscriptionCloseTasks) {
+              await DyFM_Array.asyncForEach(
+                this.getSubscriptionCloseTasks(),
+                async (task: DyFM_SocketEventTask<null>) => {
+                  await task(null, issuer);
+                }
+              );
+            } */
+            socket.emit(socket_1.DyFM_SocketEvent_Key.disconnect);
+            socket.disconnect();
+            await this.removeSocketFromPresence(socket);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('closeSocket', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-CS0`,
+            });
+        }
+    }
+    async removeSocketFromPresence(socket) {
+        try {
+            const presence = this.presences.find((pres) => pres.sockets.includes(socket));
+            if (presence) {
+                const socketIndex = presence.sockets.indexOf(socket);
+                if (socketIndex !== -1) {
+                    presence.sockets.splice(socketIndex, 1);
+                }
+                if (presence.sockets.length === 0) {
+                    const presenceIndex = this.presences.indexOf(presence);
+                    if (presenceIndex !== -1) {
+                        this.presences.splice(presenceIndex, 1);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('removeSocketFromPresence', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RSO0`,
+            });
+        }
+    }
+    async disconnectBaseTask(socket, issuer) {
+        try {
+            if (!(socket instanceof SocketIO.Socket)) {
+                /* throw new DyFM_Error({
+                  ...this._getDefaultErrorSettings(
+                    'disconnectBaseTask',
+                    new Error('Socket is not a SocketIO.Socket, type: ' + typeof socket),
+                  ),
+                }); */
+                fsm_dynamo_1.DyFM_Log.error(`Socket is not a SocketIO.Socket, type: ${typeof socket}`, socket);
+                //TODO: remove all presences that have no socket
+            }
+            await this.removeSubscription(socket, issuer).catch(error => {
+                if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                    error.logShort(`Remove Subscription failed: "${this.params.name}" (${this.params.port})`);
+                }
+                else {
+                    fsm_dynamo_1.DyFM_Log.error(`Remove Subscription failed: "${this.params.name}" (${this.params.port})`, error);
+                }
+            });
+            fsm_dynamo_1.DyFM_Log.info(`< x >  socket(${this.params.name}) disconnected (${issuer})`);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('disconnectBaseTask', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-DBT0`,
+            });
+        }
+    }
+    async removeSubscription(socket, issuer) {
+        try {
+            if (!this.presences.length) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('removeSubscription', new Error(`No presences found (${this.params.name})`), issuer ?? 'unknown issuer'),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS1`,
+                });
+            }
+            const activePresenceIndex = this.presences.findIndex((pres) => pres.sockets.includes(socket));
+            if (activePresenceIndex === -1) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`closing socket (${this.params.name}) does not match any in the activePresences`), issuer ?? 'unknown issuer'),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS2`,
+                });
+            }
+            const activePresence = this.presences[activePresenceIndex];
+            if (issuer && activePresence.issuerLocalId !== issuer) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`socket unsubscription for "${issuer}" and ` +
+                        `"${activePresence.issuerLocalId}" does not match.`), issuer),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS3`,
+                });
+            }
+            const socketIndex = activePresence.sockets.findIndex((s) => s === socket);
+            if (socketIndex === -1) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`closing socket (${this.params.name}) does not match any in the activePresences`), activePresence.issuerLocalId),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS4`,
+                });
+            }
+            activePresence.sockets.splice(socketIndex);
+            await fsm_dynamo_1.DyFM_Array.asyncForEach(this.incomingEvents.filter((event) => event.eventKey === socket_1.DyFM_SocketEvent_Key.unsubscribeSuccessful), async (event) => {
+                await event.executeEventTasks(null, issuer);
+            });
+            /* if (this.getSubscriptionCloseTasks) {
+              await DyFM_Array.asyncForEach(
+                this.getSubscriptionCloseTasks(),
+                async (task: DyFM_SocketEventTask<null>) => {
+                  await task(null, issuer);
+                }
+              );
+            } */
+            if (activePresence.sockets.length === 0) {
+                this.presences.splice(activePresenceIndex);
+            }
+            socket.emit(socket_1.DyFM_SocketEvent_Key.unsubscribeSuccessful, 'unsubscribe was successful');
+            socket.disconnect();
+            fsm_dynamo_1.DyFM_Log.info(`<x==>  socket (${this.params.name}) unsubscription successful (${issuer})`);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('sendEventForId', error, issuer ?? 'unknown issuer'),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-RS0`,
+                message: `socket (${this.params.name}) Subscription Removal failed: "${this.params?.name}"`,
+            });
+        }
+    }
+    /* emitServerEvent(event: string, content: any): void {
+      try {
+        DyFM_Log.log(` <=--  emitting server socket(${this.params.name}) event: ${event}`);
+  
+        this.openSocketServer.emit(event, content, error => {
+          DyFM_Log.error(`Emitting server event '${event}' failed!\nerror:`, error);
+        });
+      } catch (error) {
+        throw new DyFM_Error({
+          ...this._getDefaultErrorSettings(
+            'emitEvent',
+            error
+          ),
+  
+          errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-500',
+          message: `socket(${this.params.name}) Event Emit (${event}) failed: ${this.params?.name}`,
+        });
+      }
+    } */
+    idIsSubscribed(id) {
+        try {
+            return !!this.presences.find((presence) => presence.issuerLocalId === id);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('idIsSubscribed', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-IIS0`,
+                message: `socket (${this.params.name}) ID Subscription Check (${id}) failed`,
+            });
+        }
+    }
+    async emitError(presenceIssuerId, error, issuer) {
+        try {
+            await this.sendEventForId(presenceIssuerId, socket_1.DyFM_SocketEvent_Key.error, error, issuer);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('emitError', error, presenceIssuerId),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-EE0`,
+                message: `socket (${this.params.name}) Error Emit (id: ${presenceIssuerId}) failed`,
+            });
+        }
+    }
+    async sendEventForId(id, event, content, issuer) {
+        try {
+            if (!event) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('sendEventForId', new Error('No event was provided'), content?.source),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI1`,
+                });
+            }
+            if (!id) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('sendEventForId', new Error('No ID was provided'), content?.source),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI2`,
+                });
+            }
+            const presence = this.presences.find((pres) => pres.issuerLocalId === id);
+            if (!presence) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('sendEventForId', new Error(`No active socket with this specific ID: "${id}"`), content?.source),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI3`,
+                });
+            }
+            presence.emitEvent(event, content, issuer);
+            if (global_settings_const_1.DyNTS_global_settings.log_settings.socket_eventContent) {
+                fsm_dynamo_1.DyFM_Log.success(` <--=  emitted socket (${this.params.name}) event: "${event}", ` +
+                    `\n         presenceId: "${id}", sockets: ${presence.sockets.length}` +
+                    `\n         content:`, content);
+            }
+            else {
+                fsm_dynamo_1.DyFM_Log.success(` <--=  emitted socket (${this.params.name}) event: "${event}", ` +
+                    `\n         presenceId: ${id}, sockets: ${presence.sockets.length}`);
+            }
+        }
+        catch (error) {
+            try {
+                if (error?.flag?.includes(fsm_dynamo_1.DyFM_errorFlag) && error?.additionalInfo?.inactiveSockets) {
+                    const sockets = error.additionalInfo.inactiveSockets;
+                    await fsm_dynamo_1.DyFM_Array.asyncForEach(sockets, async (socket) => {
+                        await this.removeSubscription(socket);
+                    });
+                    const presence = this.presences.find((pres) => pres.issuerLocalId === id);
+                    if (!presence) {
+                        throw new fsm_dynamo_1.DyFM_Error({
+                            ...this._getDefaultErrorSettings('sendEventForId', new Error(`No active socket (${this.params.name}) with this specific ID: "${id}"`), content?.source),
+                            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI4`,
+                        });
+                    }
+                }
+            }
+            catch (error) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('sendEventForId', error, content?.source),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI5`,
+                    message: `Error handling of inactive sockets (${this.params.name}) failed!` +
+                        `\n(Socket Event Emit for id (${id}, ${event}) failed)`,
+                });
+            }
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('sendEventForId', error, content?.source),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SEFI0`,
+                message: `socket (${this.params.name}) Event Emit for id (${id}, ${event}) failed`,
+            });
+        }
+    }
+    async broadcastEvent(event, content, issuer) {
+        try {
+            fsm_dynamo_1.DyFM_Log.log(`<=-==  broadcasting socket (${this.params.name}) event: "${event}"`);
+            this.presences.forEach((presence) => {
+                presence.emitEvent(event, content, issuer);
+            });
+        }
+        catch (error) {
+            if (global_settings_const_1.DyNTS_global_settings.log_settings.detailedErrors) {
+                if (error instanceof fsm_dynamo_1.DyFM_Error) {
+                    error.logSimple(`socket (${this.params.name}) Event Broadcast (${event}) failed`);
+                }
+                else {
+                    fsm_dynamo_1.DyFM_Log.error(`socket (${this.params.name}) Event Broadcast (${event}) failed`, error);
+                }
+            }
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('broadcastEvent', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-BE0`,
+                message: `socket (${this.params.name}) Event Broadcast (${event}) failed`,
+            });
+        }
+    }
+    async sendError(error, issuer) {
+        try {
+            await this.sendEventForId(issuer, socket_1.DyFM_SocketEvent_Key.error, error, issuer);
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('sendError', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-SSS-SE0`,
+                message: `socket (${this.params.name}) Error Send (${issuer}) failed`,
+            });
+        }
+    }
+    _getDefaultErrorSettings(fnName, error, issuer) {
+        return {
+            status: error?.___status ?? 500,
+            message: error?.message ??
+                error?._message ??
+                `${fnName} was UNSUCCESSFUL (NTS)`,
+            addECToUserMsg: !error?.__userMessage,
+            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
+            issuer: issuer,
+            issuerService: this.constructor?.name,
+            error: error,
+        };
+    }
+    /**
+     * You can setup tasks for the unsubscribe event in this function
+     */
+    /* protected getUnsubscribeTasks?(): DyFM_SocketEventTask<T_SubscriptionContent>[]; */
+    /**
+     * You can setup preprocesses for the unsubscribe event in this function
+     */
+    /* protected getUnsubscribePreProcesses?(): DyFM_SocketEventPreprocessTask[]; */
+    /**
+     * You can setup tasks for the error event in this function
+     */
+    errorHandling;
+}
+exports.DyNTS_SocketServerService = DyNTS_SocketServerService;
 //# sourceMappingURL=socket-server.service.js.map