@futdevpro/nts-dynamo 1.9.26 → 1.9.28

package/src/_modules/socket/_services/socket-server.service.ts

@@ -5,8 +5,13 @@ import {
   DyFM_AnyError, DyFM_Array, DyFM_Error, DyFM_Error_Settings, DyFM_Log 
 } from '@futdevpro/fsm-dynamo';
 
+
+import { 
+  DyFM_SocketEvent_Key, DyFM_SocketEventPreprocessTask, DyFM_SocketEventTask, DyFM_SocketEvent
+} from '@futdevpro/fsm-dynamo/socket';
+
+import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
 import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
-import { DyNTS_SocketEventKey } from '../_enums/socket-event-key.enum';
 import { DyNTS_SocketSecurity } from '../_enums/socket-security.enum';
 import { 
   DyNTS_SocketServerService_Params 
@@ -14,19 +19,15 @@ import {
 import { 
   DyNTS_SocketPresence 
 } from '../_models/socket-presence.control-model';
-import { 
-  DyNTS_SocketEvent, DyNTS_SocketEventPreprocessTask, DyNTS_SocketEventTask 
-} from '../_models/socket-event.control-model';
-import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
 
 /**
  * You need to define the following functions:
  * ```ts
  * getServiceParams(): DyNTS_SocketServerServiceParams;
  * 
- * getIncomingEvents(): DyNTS_SocketEvent<any>[];
+ * getIncomingEvents(): DyFM_SocketEvent<any>[];
  * 
- * getPresenceFromSubscrioptionEventContent(  
+ * getPresenceFromSubscriptionEventContent(  
  *  socketSubscription: T_SubscriptionContent,  
  *  socket: SocketIO.Socket  
  * ): Promise<T_Presence>;  
@@ -47,27 +48,16 @@ export abstract class DyNTS_SocketServerService<
   protected openSocketServer: SocketIO.Server;
   protected secureSocketServer: SocketIO.Server;
 
-  private connectEvent: DyNTS_SocketEvent<SocketIO.Socket>;
-  protected incomingEvents: DyNTS_SocketEvent<any>[];
+  private connectEvent: DyFM_SocketEvent<SocketIO.Socket>;
+  protected incomingEvents: DyFM_SocketEvent<any>[];
 
-  private subscriptionEvent: DyNTS_SocketEvent<any>;
-  private unsubscribeEvent: DyNTS_SocketEvent<any>;
-
-  /**
-   * You need to setup a function that converts subscription event content to presence.
-   * You should do authentication and authorization here.
-   */
-  protected abstract getPresenceFromSubscrioptionEventContent(
-    socketSubscription: T_SubscriptionContent, socket: SocketIO.Socket
-  ): Promise<T_Presence>;
+  private subscriptionEvent: DyFM_SocketEvent<any>;
+  private unsubscribeEvent: DyFM_SocketEvent<any>;
+  
   protected presences: T_Presence[] = [];
 
-  get logSetup(): boolean {
-    return DyNTS_global_settings.log_settings.setup;
-  }
-  get highDetailedLogs(): boolean {
-    return DyNTS_global_settings.log_settings.highDetailedLogs;
-  }
+  get logSetup(): boolean { return DyNTS_global_settings.log_settings.setup; }
+  get highDetailedLogs(): boolean { return DyNTS_global_settings.log_settings.highDetailedLogs; }
 
   defaultErrorUserMsg = 
     `We encountered an unhandled Socket Server Error, ` +
@@ -84,6 +74,15 @@ export abstract class DyNTS_SocketServerService<
     });
   }
 
+  /**
+   * You need to setup a function that converts subscription event content to presence.
+   * You should do authentication and authorization here.
+   */
+  protected abstract getPresenceFromSubscriptionEventContent(
+    socketSubscription: T_SubscriptionContent, 
+    socket: SocketIO.Socket
+  ): Promise<T_Presence>;
+
   private async asyncConstructor(): Promise<void> {
     try {
       this.params = this.getServiceParams();
@@ -93,7 +92,7 @@ export abstract class DyNTS_SocketServerService<
 
       if (this.logSetup) console.log(
         `Socket Server Service setup done: ${this.params.name} (${this.params.port}) ` +
-        `serurity: ${this.params.security}\n`
+        `security: ${this.params.security}\n`
       );
     } catch (error) {
       DyFM_Log.error(
@@ -115,25 +114,25 @@ export abstract class DyNTS_SocketServerService<
     try {
       /** Setup connect event */
       const connectEventIndex = this.incomingEvents.findIndex(
-        (event: DyNTS_SocketEvent<any>) => 
-          event.eventKey === DyNTS_SocketEventKey.connection
+        (event: DyFM_SocketEvent<any>) => 
+          event.eventKey === DyFM_SocketEvent_Key.connection
       );
 
       if (0 <= connectEventIndex) {
         this.connectEvent = this.incomingEvents.splice(connectEventIndex)[0];
       } else {
-        this.connectEvent = new DyNTS_SocketEvent({
-          eventKey: DyNTS_SocketEventKey.connection,
+        this.connectEvent = new DyFM_SocketEvent({
+          eventKey: DyFM_SocketEvent_Key.connection,
         });
       }
       this.connectEvent.serviceName = this.params.name;
 
       /** Setup subscriptions events */
-      if (this.getPresenceFromSubscrioptionEventContent) {
+      if (this.getPresenceFromSubscriptionEventContent) {
         /** Setup subscription event */ 
         const subscriptionEventIndex = this.incomingEvents.findIndex(
-          (event: DyNTS_SocketEvent<any>) => 
-            event.eventKey === DyNTS_SocketEventKey.subscribe
+          (event: DyFM_SocketEvent<any>) => 
+            event.eventKey === DyFM_SocketEvent_Key.subscribe
         );
 
         if (0 <= subscriptionEventIndex) {
@@ -144,13 +143,13 @@ export abstract class DyNTS_SocketServerService<
             `${this.params.name} (${this.params.port})`
           );
         } else {
-          this.subscriptionEvent = new DyNTS_SocketEvent<T_SubscriptionContent>({ 
-            eventKey: DyNTS_SocketEventKey.subscribe,
+          this.subscriptionEvent = new DyFM_SocketEvent<T_SubscriptionContent>({ 
+            eventKey: DyFM_SocketEvent_Key.subscribe,
           });
         }
 
-        if (this.getSubscriptionPreProcessess) {
-          this.subscriptionEvent.preProcesses.push(...this.getSubscriptionPreProcessess());
+        if (this.getSubscriptionPreProcesses) {
+          this.subscriptionEvent.preProcesses.push(...this.getSubscriptionPreProcesses());
         }
 
         if (this.getSubscriptionTasks) {
@@ -160,8 +159,8 @@ export abstract class DyNTS_SocketServerService<
         
         /** Setup subscription event */ 
         const unsubscribeEventIndex = this.incomingEvents.findIndex(
-          (event: DyNTS_SocketEvent<any>) => 
-            event.eventKey === DyNTS_SocketEventKey.unsubscribe
+          (event: DyFM_SocketEvent<any>) => 
+            event.eventKey === DyFM_SocketEvent_Key.unsubscribe
         );
 
         if (0 <= unsubscribeEventIndex) {
@@ -172,13 +171,13 @@ export abstract class DyNTS_SocketServerService<
             `${this.params.name} (${this.params.port})`
           );
         } else {
-          this.unsubscribeEvent = new DyNTS_SocketEvent<T_SubscriptionContent>({ 
-            eventKey: DyNTS_SocketEventKey.unsubscribe,
+          this.unsubscribeEvent = new DyFM_SocketEvent<T_SubscriptionContent>({ 
+            eventKey: DyFM_SocketEvent_Key.unsubscribe,
           });
         }
 
-        if (this.getUnsubscribePreProcessess) {
-          this.unsubscribeEvent.preProcesses.push(...this.getUnsubscribePreProcessess());
+        if (this.getUnsubscribePreProcesses) {
+          this.unsubscribeEvent.preProcesses.push(...this.getUnsubscribePreProcesses());
         }
 
         if (this.getUnsubscribeTasks) {
@@ -188,8 +187,8 @@ export abstract class DyNTS_SocketServerService<
 
         /** Setup disconnect event */
         const disconnectEventIndex = this.incomingEvents.findIndex(
-          (event: DyNTS_SocketEvent<any>) => 
-            event.eventKey === DyNTS_SocketEventKey.disconnect
+          (event: DyFM_SocketEvent<any>) => 
+            event.eventKey === DyFM_SocketEvent_Key.disconnect
         );
 
         if (0 <= disconnectEventIndex) {
@@ -197,9 +196,9 @@ export abstract class DyNTS_SocketServerService<
           this.incomingEvents[disconnectEventIndex].tasks.push(this.disconnectBaseTask);
         } else {
           this.incomingEvents.push(
-            new DyNTS_SocketEvent({
+            new DyFM_SocketEvent({
               serviceName: this.params.name,
-              eventKey: DyNTS_SocketEventKey.disconnect,
+              eventKey: DyFM_SocketEvent_Key.disconnect,
               tasks: [
                 this.disconnectBaseTask,
               ],
@@ -209,13 +208,13 @@ export abstract class DyNTS_SocketServerService<
 
         /** Setup error event */
         const errorEventIndex = this.incomingEvents.findIndex(
-          (event: DyNTS_SocketEvent<any>) => event.eventKey === DyNTS_SocketEventKey.error
+          (event: DyFM_SocketEvent<any>) => event.eventKey === DyFM_SocketEvent_Key.error
         );
 
         if (errorEventIndex == -1 && this.errorHandling) {
-          this.incomingEvents.push(new DyNTS_SocketEvent<T_ErrorContent>({
+          this.incomingEvents.push(new DyFM_SocketEvent<T_ErrorContent>({
             serviceName: this.params.name,
-            eventKey: DyNTS_SocketEventKey.error,
+            eventKey: DyFM_SocketEvent_Key.error,
             tasks: [
               this.errorHandling,
             ],
@@ -225,13 +224,13 @@ export abstract class DyNTS_SocketServerService<
         this.subscriptionEvent.socketName = this.params.name;
       } else {
         DyFM_Log.error(
-          'getPresenceFromSubscrioptionEventContent is not set', 
+          'getPresenceFromSubscriptionEventContent is not set', 
           `${this.params.name} (${this.params.port})`
         );
       }
 
       /** Set incoming events serviceName */
-      this.incomingEvents.forEach((event: DyNTS_SocketEvent<any>) => {
+      this.incomingEvents.forEach((event: DyFM_SocketEvent<any>) => {
         event.serviceName = this.params.name;
       });
     } catch (error) {
@@ -254,47 +253,47 @@ export abstract class DyNTS_SocketServerService<
     try {
       if (this.highDetailedLogs) console.log('\nfn:. setupSocketServer');
 
-      newSocketServer.on(DyNTS_SocketEventKey.connection, async (socket: SocketIO.Socket) => {
+      newSocketServer.on(DyFM_SocketEvent_Key.connection, async (socket: SocketIO.Socket) => {
         try {
           let issuer: string;
 
           await this.connectEvent.executeEventTasks(socket);
 
-          if (this.getPresenceFromSubscrioptionEventContent) {
+          if (this.getPresenceFromSubscriptionEventContent) {
             socket.on(
-              DyNTS_SocketEventKey.subscribe, 
+              DyFM_SocketEvent_Key.subscribe, 
               async (content: any) => {
                 try {
                   /** 
                    * usually socket logs are in event.executeEventTasks(), 
                    * but subscribe event is an exception from this, 
-                   * to be able to check content before getPresenceFromSubscrioptionEventContent 
+                   * to be able to check content before getPresenceFromSubscriptionEventContent 
                    */
                   if (DyNTS_global_settings.log_settings.socket_eventContent) {
                     DyFM_Log.log(
                       `--=>   incoming socket(${this.params.name}) ` +
-                      `event: ${DyNTS_SocketEventKey.subscribe};` +
+                      `event: ${DyFM_SocketEvent_Key.subscribe};` +
                       `\ncontent:`, content
                     );
                   } else {
                     DyFM_Log.log(
                       `--=>   incoming socket(${this.params.name}) ` +
-                      `event: ${DyNTS_SocketEventKey.subscribe}`
+                      `event: ${DyFM_SocketEvent_Key.subscribe}`
                     );
                   }
 
-                  const presence: T_Presence = await this.getPresenceFromSubscrioptionEventContent(
+                  const presence: T_Presence = await this.getPresenceFromSubscriptionEventContent(
                     content, socket
                   );
 
                   presence.serviceName = this.params.name;
-                  issuer = presence.issuerId;
+                  issuer = presence.issuerLocalId;
         
                   this.addSocketToPresence(presence);
                   await this.subscriptionEvent.executeEventTasks(content, issuer);
 
                   socket.emit(
-                    DyNTS_SocketEventKey.subscriptionSuccessful, 
+                    DyFM_SocketEvent_Key.subscriptionSuccessful, 
                     'subscribe was successful', 
                     error => {
                       DyFM_Log.error(
@@ -305,48 +304,55 @@ export abstract class DyNTS_SocketServerService<
                   );
                   
                   DyFM_Log.success(
-                    `<-==>  socket(${this.params.name}) subscription successfull (${issuer})`
+                    `<-==>  socket(${this.params.name}) subscription successful (${issuer})`
                   );
                 } catch (error) {
-                  DyFM_Log.error(
-                    `Socket Subscription failed: ${this.params.name} ` ,
-                    `(${this.params.port}) will disconnect now...`, 
-                    error
-                  );
-                  socket.emit(DyNTS_SocketEventKey.error, error);
+                  if (DyNTS_global_settings.log_settings.socket_eventContent) {
+                    DyFM_Log.error(
+                      `Socket Subscription failed: ${this.params.name} ` ,
+                      `(${this.params.port}) will disconnect now...`, 
+                      error
+                    );
+                  } else {
+                    DyFM_Log.error(
+                      `Socket Subscription failed: ${this.params.name} ` ,
+                      `(${this.params.port}) will disconnect now...`
+                    );
+                  }
+                  socket.emit(DyFM_SocketEvent_Key.error, error);
                   socket.disconnect();
                 }
               }
             );
             
             socket.on(
-              DyNTS_SocketEventKey.unsubscribe, 
+              DyFM_SocketEvent_Key.unsubscribe, 
               async (issuer: string) => {
                 try {
                   /** 
                    * usually socket logs are in event.executeEventTasks(), 
                    * but unsubscribe event is an exception from this, 
-                   * to be able to check content before getPresenceFromSubscrioptionEventContent 
+                   * to be able to check content before getPresenceFromSubscriptionEventContent 
                    */
                   if (DyNTS_global_settings.log_settings.socket_eventContent) {
                     DyFM_Log.log(
                       `--=>   incoming socket(${this.params.name}) ` +
-                      `event: ${DyNTS_SocketEventKey.unsubscribe};` +
+                      `event: ${DyFM_SocketEvent_Key.unsubscribe};` +
                       `\ncontent:`, issuer
                     );
                   } else {
                     DyFM_Log.log(
                       `--=>   incoming socket(${this.params.name}) ` +
-                      `event: ${DyNTS_SocketEventKey.unsubscribe}`
+                      `event: ${DyFM_SocketEvent_Key.unsubscribe}`
                     );
                   }
                   
                   this.removeSubscription(socket, issuer);
 
-                  await this.subscriptionEvent.executeEventTasks(issuer, issuer);
+                  await this.unsubscribeEvent.executeEventTasks(issuer, issuer);
 
                   socket.emit(
-                    DyNTS_SocketEventKey.unsubscribeSuccessful, 
+                    DyFM_SocketEvent_Key.unsubscribeSuccessful, 
                     'unsubscribe was successful', 
                     error => {
                       DyFM_Log.error(
@@ -357,21 +363,28 @@ export abstract class DyNTS_SocketServerService<
                   );
                   
                   DyFM_Log.success(
-                    `< x >  socket(${this.params.name}) unsubscribe successfull (${issuer})`
+                    `< x >  socket(${this.params.name}) unsubscribe successful (${issuer})`
                   );
                 } catch (error) {
-                  DyFM_Log.error(
-                    `Socket unsubscribe failed: ${this.params.name} ` ,
-                    `(${this.params.port}) will disconnect now...`, 
-                    error
-                  );
-                  socket.emit(DyNTS_SocketEventKey.error, error);
+                  if (DyNTS_global_settings.log_settings.socket_eventContent) {
+                    DyFM_Log.error(
+                      `Socket unsubscribe failed: ${this.params.name} ` ,
+                      `(${this.params.port}) will disconnect now...`, 
+                      error
+                    );
+                  } else {
+                    DyFM_Log.error(
+                      `Socket unsubscribe failed: ${this.params.name} ` ,
+                      `(${this.params.port}) will disconnect now...`
+                    );
+                  }
+                  socket.emit(DyFM_SocketEvent_Key.error, error);
                 }
               }
             );
           }
 
-          this.incomingEvents.forEach((event: DyNTS_SocketEvent<any>) => {
+          this.incomingEvents.forEach((event: DyFM_SocketEvent<any>) => {
             socket.on(
               event.eventKey, 
               async (content: any) => { 
@@ -382,7 +395,7 @@ export abstract class DyNTS_SocketServerService<
                     `Socket Event failed: ${this.params.name} (${this.params.port})`, 
                     error
                   );
-                  socket.emit(DyNTS_SocketEventKey.error, error);
+                  socket.emit(DyFM_SocketEvent_Key.error, error);
                 }
               }
             );
@@ -397,7 +410,7 @@ export abstract class DyNTS_SocketServerService<
             `(${this.params.port}) will disconnect now...`, 
             error
           );
-          socket.emit(DyNTS_SocketEventKey.error, error);
+          socket.emit(DyFM_SocketEvent_Key.error, error);
           socket.disconnect();
         }
       });
@@ -434,7 +447,7 @@ export abstract class DyNTS_SocketServerService<
   protected async addSocketToPresence(newPresence: T_Presence): Promise<void> {
     try {
       const activePresence: T_Presence = this.presences.find(
-        (pres: T_Presence) => pres.issuerId === newPresence.issuerId
+        (pres: T_Presence) => pres.issuerLocalId === newPresence.issuerLocalId
       );
       
       if (activePresence) {
@@ -443,10 +456,16 @@ export abstract class DyNTS_SocketServerService<
         this.presences.push(newPresence);
       }
     } catch (error) {
-      DyFM_Log.error(
-        `Socket Subscription failed: ${this.params?.name} (${this.params?.port})`, 
-        error
-      );
+      if (DyNTS_global_settings.log_settings.socket_eventContent) {
+        DyFM_Log.error(
+          `Socket Subscription failed: ${this.params?.name} (${this.params?.port})`, 
+          error
+        );
+      } else {
+        DyFM_Log.error(
+          `Socket Subscription failed: ${this.params?.name} (${this.params?.port})`
+        );
+      }
 
       throw error;
     }
@@ -492,12 +511,13 @@ export abstract class DyNTS_SocketServerService<
 
       const activePresence: DyNTS_SocketPresence = this.presences[activePresenceIndex];
 
-      if (activePresence.issuerId !== issuer) {
+      if (activePresence.issuerLocalId !== issuer) {
         throw new DyFM_Error({
           ...this._getDefaultErrorSettings(
             'sendEventForId',
             new Error(
-              `socket subscription for ${issuer} and ${activePresence.issuerId} does not match.`
+              `socket subscription for ${issuer} and ` +
+              `${activePresence.issuerLocalId} does not match.`
             ),
             issuer
           ),
@@ -527,7 +547,7 @@ export abstract class DyNTS_SocketServerService<
       if (this.getSubscriptionCloseTasks) {
         await DyFM_Array.asyncForEach(
           this.getSubscriptionCloseTasks(), 
-          async (task: DyNTS_SocketEventTask<null>) => {
+          async (task: DyFM_SocketEventTask<null>) => {
             await task(null, issuer);
           }
         );
@@ -538,7 +558,7 @@ export abstract class DyNTS_SocketServerService<
       }
 
       socket.disconnect();
-      DyFM_Log.info(`<x==>  socket(${this.params.name}) unsubscription successfull (${issuer})`);
+      DyFM_Log.info(`<x==>  socket(${this.params.name}) unsubscription successful (${issuer})`);
     } catch (error) {
       throw new DyFM_Error({
         ...this._getDefaultErrorSettings(
@@ -576,7 +596,7 @@ export abstract class DyNTS_SocketServerService<
   idIsSubscribed(id: string): boolean {
     try {
       return !!this.presences.find(
-        (presence: DyNTS_SocketPresence) => presence.issuerId === id
+        (presence: DyNTS_SocketPresence) => presence.issuerLocalId === id
       );
     } catch (error) {
       throw new DyFM_Error({
@@ -593,7 +613,7 @@ export abstract class DyNTS_SocketServerService<
 
   async emitError(presenceIssuerId: string, error: any, issuer: string): Promise<void> {
     try {
-      await this.sendEventForId(presenceIssuerId, DyNTS_SocketEventKey.error, error, issuer);
+      await this.sendEventForId(presenceIssuerId, DyFM_SocketEvent_Key.error, error, issuer);
     } catch (error) {
       throw new DyFM_Error({
         ...this._getDefaultErrorSettings(
@@ -611,7 +631,7 @@ export abstract class DyNTS_SocketServerService<
   async sendEventForId(id: string, event: string, content: any, issuer: string): Promise<void> {
     try {
       const presence: DyNTS_SocketPresence = this.presences.find(
-        (pres: DyNTS_SocketPresence) => pres.issuerId === id
+        (pres: DyNTS_SocketPresence) => pres.issuerLocalId === id
       );
 
       if (!presence) {
@@ -643,15 +663,15 @@ export abstract class DyNTS_SocketServerService<
       }
     } catch (error) {
       try {
-        if (error.flag.includes('DYNAMO') && error?.accitionalInfo?.inactiveSockets) {
-          const sockets: SocketIO.Socket[] = error.accitionalInfo.inactiveSockets;
+        if (error.flag.includes('DYNAMO') && error?.additionalInfo?.inactiveSockets) {
+          const sockets: SocketIO.Socket[] = error.additionalInfo.inactiveSockets;
 
           await DyFM_Array.asyncForEach(sockets, async (socket: SocketIO.Socket) => {
             await this.removeSubscription(socket);
           });
 
           const presence: DyNTS_SocketPresence = this.presences.find(
-            (pres: DyNTS_SocketPresence) => pres.issuerId === id
+            (pres: DyNTS_SocketPresence) => pres.issuerLocalId === id
           );
 
           if (!presence) {
@@ -713,7 +733,7 @@ export abstract class DyNTS_SocketServerService<
   ): DyFM_Error_Settings {
     return {
       status: (error as DyFM_Error)?.___status ?? 500,
-      message: (error as Error)?.message ?? `${fnName} was UNSUCCESFUL (NTS)`,
+      message: (error as Error)?.message ?? `${fnName} was UNSUCCESSFUL (NTS)`,
       addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
       userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
       issuer: issuer,
@@ -730,35 +750,35 @@ export abstract class DyNTS_SocketServerService<
   /**
    * You must setup events and required services in this function
    */
-  protected abstract getIncomingEvents(): DyNTS_SocketEvent<any>[];
+  protected abstract getIncomingEvents(): DyFM_SocketEvent<any>[];
 
   /**
    * You can setup tasks for the subscription event in this function
    */
-  protected getSubscriptionTasks?(): DyNTS_SocketEventTask<T_SubscriptionContent>[];
+  protected getSubscriptionTasks?(): DyFM_SocketEventTask<T_SubscriptionContent>[];
   
   /**
    * You can setup tasks for the subscription event in this function
    */
-  protected getSubscriptionCloseTasks?(): DyNTS_SocketEventTask<null>[];
+  protected getSubscriptionCloseTasks?(): DyFM_SocketEventTask<null>[];
 
   /**
-   * You can setup preprocessess for the subscription event in this function
+   * You can setup preprocesses for the subscription event in this function
    */
-  protected getSubscriptionPreProcessess?(): DyNTS_SocketEventPreprocessTask[];
+  protected getSubscriptionPreProcesses?(): DyFM_SocketEventPreprocessTask[];
 
   /**
    * You can setup tasks for the unsubscribe event in this function
    */
-  protected getUnsubscribeTasks?(): DyNTS_SocketEventTask<T_SubscriptionContent>[];
+  protected getUnsubscribeTasks?(): DyFM_SocketEventTask<T_SubscriptionContent>[];
 
   /**
-   * You can setup preprocessess for the unsubscribe event in this function
+   * You can setup preprocesses for the unsubscribe event in this function
    */
-  protected getUnsubscribePreProcessess?(): DyNTS_SocketEventPreprocessTask[];
+  protected getUnsubscribePreProcesses?(): DyFM_SocketEventPreprocessTask[];
 
   /**
    * You can setup tasks for the error event in this function
    */
-  protected errorHandling?: DyNTS_SocketEventTask<T_ErrorContent>;
+  protected errorHandling?: DyFM_SocketEventTask<T_ErrorContent>;
 }

package/src/_modules/socket/index.ts

@@ -2,13 +2,11 @@
 
 
 // ENUMS
-export * from './_enums/socket-event-key.enum';
 export * from './_enums/socket-security.enum';
 
 
 // MODELS
 export * from './_models/socket-client-service-params.control-model';
-export * from './_models/socket-event.control-model';
 export * from './_models/socket-presence.control-model';
 export * from './_models/socket-server-service-params.control-model';
 

package/src/_modules/usage/usage.data-service.ts

@@ -161,7 +161,7 @@ export class DyNTS_Usage_DataService extends DyNTS_DataService<DyFM_UsageSession
   )/* : DyFM_ErrorSettings */ {
     return {
       status: (error as DyFM_Error)?.___status ?? 417,
-      message: (error as Error)?.message ?? `${fnName} was UNSUCCESFUL (NTS; ${this.serviceName})`,
+      message: (error as Error)?.message ?? `${fnName} was UNSUCCESSFUL (NTS; ${this.serviceName})`,
       addECToUserMsg: true,
       userMessage: this.defaultErrorUserMsg,
       issuer: this.issuer,

package/src/_services/base/data.service.ts

@@ -800,7 +800,7 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               )
             ),
 
-            status: 422, 
+            status: 522, 
             errorCode: 'NTS-DS0-VD1',
             userMessage: this.defaultValidationErrorUserMsg,
           });
@@ -819,7 +819,7 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
               )
             ),
 
-            status: 422, 
+            status: 522, 
             errorCode: 'NTS-DS0-VD2',
             userMessage: this.defaultValidationErrorUserMsg,
           });
@@ -841,7 +841,7 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
         throw new DyFM_Error({ 
           ...this._getDefaultErrorSettings('validateForSave', error),
 
-          status: 422, 
+          status: 522, 
           errorCode: 'NTS-DS0-VD0',
         });
       }
@@ -910,7 +910,7 @@ export class DyNTS_DataService<T extends DyFM_Metadata> {
       status: (error as DyFM_Error)?.___status ?? 500,
       message: 
         (error as Error)?.message ?? 
-        `${fnName} was UNSUCCESFUL (NTS; ${this.dataParams.dataName})`,
+        `${fnName} was UNSUCCESSFUL (NTS; ${this.dataParams.dataName})`,
       addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
       userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
       issuer: this.issuer,

package/src/_services/base/db.service.ts

@@ -91,7 +91,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
             issuer
           ),
 
-          status: 204, 
+          status: 544, 
           errorCode: 'NTS-DBS-CD1',
           additionalContent: { data },
           issuer,
@@ -105,7 +105,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
         throw new DyFM_Error({ 
           ...this._getDefaultErrorSettings('createData', error, issuer),
 
-          status: 422, 
+          status: 522, 
           errorCode: 'NTS-DBS-CD0',
           additionalContent: { data, dataModel },
           message: 
@@ -920,7 +920,7 @@ export class DyNTS_DBService<T extends DyFM_Metadata> {
   ): DyFM_Error_Settings {
     return {
       status: (error as DyFM_Error)?.___status ?? 500,
-      message: (error as Error)?.message ?? `${fnName} was UNSUCCESFUL (NTS-DB)`,
+      message: (error as Error)?.message ?? `${fnName} was UNSUCCESSFUL (NTS-DB)`,
       addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
       userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
       issuer: issuer,

package/src/_services/core/email.service.ts

@@ -669,7 +669,7 @@ export class DyNTS_EmailService {
   ): DyFM_Error_Settings {
     return {
       status: (error as DyFM_Error)?.___status ?? 500,
-      message: (error as Error)?.message ?? `${fnName} was UNSUCCESFUL (NTS; ${this.serviceName})`,
+      message: (error as Error)?.message ?? `${fnName} was UNSUCCESSFUL (NTS; ${this.serviceName})`,
       addECToUserMsg: !(error as DyFM_Error)?.__userMessage,
       userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
       issuer: issuer,