@futdevpro/nts-dynamo 1.9.40 → 1.9.42

package/src/_models/control-models/endpoint-params.control-model.ts

@@ -23,16 +23,17 @@ export class DyNTS_Endpoint_Params {
   /* TODO: ENCRYPTION !!EZTET
   useEncryptionKey?: string; */
 
-  private pathParams: string[];
+  private readonly pathParams: string[];
 
-  private preProcesses: ((req: Request, res: Response) => Promise<void>)[];
-  private tasks: ((req: Request, res: Response, issuer?: string) => Promise<void>)[];
+  private readonly preProcesses: ((req: Request, res: Response) => Promise<void>)[];
+  private readonly tasks: ((req: Request, res: Response, issuer?: string) => Promise<void>)[];
 
-  private logRequest: boolean;
-  private logRequestsParams: boolean;
-  private logRequestsContent: boolean;
-  private logResponseContent: boolean;
-  private stack: string;
+  private readonly logRequest: boolean;
+  private readonly logRequestsParams: boolean;
+  private readonly logRequestsContent: boolean;
+  private readonly logResponseContent: boolean;
+  private readonly stack: string;
+  private readonly autoResolveCirculation: boolean;
 
   constructor(
     set: {
@@ -85,6 +86,10 @@ export class DyNTS_Endpoint_Params {
        * log settings for response content
        */
       logResponseContent?: boolean,
+      /**
+       * auto resolve circulation errors
+       */
+      autoResolveCirculation?: boolean,
     }
   ) {
     try {
@@ -101,6 +106,8 @@ export class DyNTS_Endpoint_Params {
         set.logRequestsContent ?? DyNTS_global_settings.log_settings.requestsContent;
       this.logResponseContent = 
         set.logResponseContent ?? DyNTS_global_settings.log_settings.responseContent;
+      this.autoResolveCirculation = 
+        set.autoResolveCirculation ?? DyNTS_global_settings.autoResolveEndpointCirculationErrors;
 
       if (!this.endpoint) {
         throw new DyFM_Error({
@@ -233,7 +240,8 @@ export class DyNTS_Endpoint_Params {
     req: Request, 
     res: Response, 
     error: Error | DyFM_Error, 
-    issuer: string
+    issuer: string,
+    autoSecondTry?: boolean
   ): Promise<void> {
     try {
       let msg: string = `Endpoint caught an error. '${this.name}' (${this.endpoint})`;
@@ -284,10 +292,27 @@ export class DyNTS_Endpoint_Params {
 
       try {
         JSON.stringify(error);
-      } catch (error) {
-        DyFM_Log.H_error(
-          'DyNTS_Endpoint_Params: error object is not serializable!', error
-        );
+      } catch (stringifyError) {
+        if (this.autoResolveCirculation) {
+          try {
+            error = DyFM_Shared.resolveCirculation(error);
+            JSON.stringify(error);
+          } catch (resolveError) {
+            DyFM_Log.H_error(
+              'DyNTS_Endpoint_Params: error object is not serializable, and not resolvable!'
+            );
+
+            error = new DyFM_Error({
+              error: new Error('UNRESOLVABLE UNSERIALIZABLE ERROR'),
+            });
+          }
+        } else {
+          DyFM_Log.H_error('DyNTS_Endpoint_Params: error object is not serializable!');
+
+          error = new DyFM_Error({
+            error: new Error('UNSERIALIZABLE ERROR'),
+          });
+        }
       }
 
       res.status((error as DyFM_Error)?.___status ?? 501);
@@ -310,21 +335,28 @@ export class DyNTS_Endpoint_Params {
 
       DyFM_Log.error('');
           
-    } catch (error) {
+    } catch (errorLvl2) {
       this.multiLevelError(
-        error,
-        { req, res, error, issuer }
+        errorLvl2,
+        { 
+          req: req, 
+          res: res, 
+          error: error, 
+          issuer: issuer, 
+          autoSecondTry: autoSecondTry, 
+        }
       );
     }
   }
 
   private multiLevelError(
-    error: any, 
+    errorLvl2: any, 
     errorInputs: { 
       req: Request, 
       res: Response, 
       error: Error | DyFM_Error, 
-      issuer: string 
+      issuer: string,
+      autoSecondTry: boolean
     }
   ): void {
     if (DyNTS_global_settings.log_settings.highDetailedLogs) {
@@ -333,7 +365,7 @@ export class DyNTS_Endpoint_Params {
           `(${this.name}, ${this.endpoint})` +
         `\n(DYNAMO MULTILEVEL ERROR means, that the ERROR HANDLING is ALSO FAILED, ` +
           `and the error message was not sent.)` + 
-        `\nERROR:`, error, 
+        `\nERROR:`, errorLvl2, 
         '\n'
       );
     } else {
@@ -347,32 +379,48 @@ export class DyNTS_Endpoint_Params {
 
     try {
       JSON.stringify(errorInputs.error);
-    } catch (error) {
-      DyFM_Log.error('error object is not serializable!');
-      let unresolvable;
+    } catch (errorLvl2Replication) {
+      DyFM_Log.error('  ...response object is not serializable!');
+      let resolvedError: any;
 
       try {
-        DyFM_Shared.resolveCirculation(errorInputs.error);
-      } catch (error) {
-        unresolvable = true;
-        DyFM_Log.error('error object is not resolvable!');
+        resolvedError = DyFM_Shared.resolveCirculation(errorInputs.error);
+      } catch (errorLvl3) {
+        DyFM_Log.error('  ...response object is not resolvable!');
+        DyFM_Log.error('  ...', errorLvl3);
       }
       
-      if (!unresolvable) {
-        DyFM_Log.error('error object is resolvable! (use DyFM_Shared.resolveCirculation)');
+      if (resolvedError) {
+        if (this.autoResolveCirculation && !errorInputs.autoSecondTry) {
+          this.error(
+            errorInputs.req, 
+            errorInputs.res, 
+            resolvedError,
+            errorInputs.issuer,
+            true
+          );
+
+          DyFM_Log.warn('  ...automatic circulation error resolution was successful!');
+
+          return;
+        } else {
+          DyFM_Log.error(
+            '  ...response object is resolvable! (use DyFM_Shared.resolveCirculation)'
+          );
+        }
       }
     }
 
     if (
       DyNTS_global_settings.log_settings.highDetailedLogs ||
-      !(error instanceof DyFM_Error)
+      !(errorLvl2 instanceof DyFM_Error)
     ) {
       DyFM_Log.H_error(
         `Endpoint "${this.endpoint}" caught an error and FAILED TO RESOLVE. (${this.name})`,
-        '\n    ERROR:', error
+        '\n    ERROR:', errorLvl2
       );
     } else {
-      error.logSimple(
+      errorLvl2.logSimple(
         `Endpoint "${this.endpoint}" caught an error and FAILED TO RESOLVE. (${this.name})`
       );
     }

package/src/_models/interfaces/global-settings.interface.ts

@@ -30,6 +30,11 @@ export interface DyNTS_Global_Settings {
    */
   systemShortCodeName?: string;
 
+  /**
+   * 
+   */
+  autoResolveEndpointCirculationErrors: boolean;
+
   /**
    * this setting will set which logs will be shown
    */

package/src/_models/types/db-filter.type.ts

@@ -29,7 +29,7 @@ export type DyNTS_DBFilter<T> =
  * A simple filter for a DynamoDB query.
  */
 export type DyNTS_DBFilterSimple<T> = {
-  [K in keyof T]?: T[K] | DyNTS_DBFilterExpressions<T[K]>;
+  [K in keyof T]?: T[K] | DyNTS_DBFilterExpressions<T[K] | boolean>;
 } & {
   [path: string]: any;
 };

package/src/_modules/socket/_models/socket-presence.control-model.ts

@@ -53,7 +53,6 @@ export class DyNTS_SocketPresence {
           ),
           set?.issuer
         ),
-
         errorCode: 'NTS-SD0-C00',
         additionalContent: { set: set },
       });
@@ -101,6 +100,22 @@ export class DyNTS_SocketPresence {
     const errors: any = [];
     const inactiveSockets: SocketIO.Socket[] = [];
 
+    try {
+      JSON.stringify(content);
+    } catch (error) {
+      throw new DyFM_Error({
+        ...this._getDefaultErrorSettings(
+          'emitEvent',
+          new Error(
+            `Emitting event '${event}' on socket(s)(${this.serviceName}) failed!`+
+            `\n  ERROR: content is not stringify-able!`
+          ),
+          issuer
+        ),
+        errorCode: 'NTS-SPC-EE1',
+      });
+    }
+
     this.sockets.forEach((socket: SocketIO.Socket, index: number) => {
       if (!socket.connected) {
         DyFM_Log.warn(
@@ -111,7 +126,7 @@ export class DyNTS_SocketPresence {
         /* errors.push(
           new DyFM_Error({
             status: 500,
-            errorCode: 'NTS-SPC-EE1',
+            errorCode: 'NTS-SPC-EE2',
             addECToUserMsg: true,
             message: 
             `Emitting event '${event}' on socket(${this.serviceName})-(${index}) failed!`+
@@ -164,8 +179,7 @@ export class DyNTS_SocketPresence {
           issuer
         ),
 
-        status: 500,
-        errorCode: 'NTS-SPC-EE2',
+        errorCode: 'NTS-SPC-EE3',
         additionalContent: {
           inactiveSockets: inactiveSockets,
           errors: errors,
@@ -182,8 +196,6 @@ export class DyNTS_SocketPresence {
           ),
           issuer
         ),
-
-        status: 404,
         errorCode: 'NTS-SPC-EE3',
       });
     }
@@ -195,7 +207,7 @@ export class DyNTS_SocketPresence {
     issuer: string
   ): DyFM_Error_Settings {
     return {
-      status: (error as DyFM_Error)?.___status ?? 406,
+      status: (error as DyFM_Error)?.___status ?? 500,
       message: (error as Error)?.message ?? `${fnName} was UNSUCCESSFUL (NTS; ${this.serviceName})`,
       userMessage: (error as DyFM_Error)?.__userMessage ?? this.defaultErrorUserMsg,
       issuerService: this.serviceName + ` (${this?.constructor?.name}-DyNTS_SocketPresence)`,

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

@@ -119,7 +119,7 @@ import { DyNTS_global_settings } from '../../../_collections/global-settings.con
  */
 export abstract class DyNTS_AppExtended extends DyNTS_App {
   
-  private systemControlsExt: DyNTS_AppExtSysControls = new DyNTS_AppExtSysControls();
+  private readonly systemControlsExt: DyNTS_AppExtSysControls = new DyNTS_AppExtSysControls();
   override get started(): boolean { return this.systemControlsExt.appExtended.started; }
   private httpsSocketSettingUpCount: number = 0;
   private httpSocketSettingUpCount: number = 0;
@@ -138,12 +138,12 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
    * ];
    */
   protected socketServices: DyNTS_SocketServerService<any>[];
-  private allSocketServers: SocketIO.Server[] = [];
+  private readonly allSocketServers: SocketIO.Server[] = [];
 
   constructor(){
-    super(true);
+    super(/* true */);
 
-    this.asyncConstructExt().catch((error: DyFM_AnyError): void => {
+    /* this.asyncConstructExt().catch((error: DyFM_AnyError): void => {
       if (
         DyNTS_global_settings.log_settings.highDetailedLogs ||
         !(error instanceof DyFM_Error)
@@ -159,13 +159,15 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
           `(DyNTS_AppExtended constructor catch)`
         );
       }
-    });
+    }); */
   }
 
-  private async asyncConstructExt(): Promise<void> {
+  protected override async asyncConstruct(extended = true): Promise<void> {
     if (this.fnLogs && this.deepLog) console.log('\nfn:. asyncConstruct-extended');
 
     try {
+      await super.asyncConstruct(true);
+
       this.systemControlsExt.appExtended.init = true;
     
       this.socketServices = this.getSocketServices();
@@ -194,7 +196,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
       DyFM_Log.H_success(`"${this.params.name}" started successfully.`);
       
     } catch (error) {
-      if (
+      /* if (
         DyNTS_global_settings.log_settings.highDetailedLogs ||
         !(error instanceof DyFM_Error)
       ) {
@@ -206,7 +208,7 @@ export abstract class DyNTS_AppExtended extends DyNTS_App {
         error.logSimple(
           `Extended Application: "${this.params?.name}" start failed. (asyncConstructExt catch)`
         );
-      }
+      } */
 
       throw new DyFM_Error({
         errorCode: 'NTS-AES-001',

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

@@ -1,24 +1,25 @@
 
 import * as SocketIO from 'socket.io';
 
-import { 
-  DyFM_AnyError, DyFM_Array, DyFM_Error, DyFM_Error_Settings, DyFM_Log 
+import {
+  DyFM_AnyError, DyFM_Array, DyFM_Error, DyFM_Error_Settings, DyFM_errorFlag, DyFM_Log
 } from '@futdevpro/fsm-dynamo';
 
 
-import { 
-  DyFM_SocketEvent_Key, DyFM_SocketEventPreprocessTask, DyFM_SocketEventTask, DyFM_SocketEvent
+import {
+  DyFM_SocketEvent,
+  DyFM_SocketEvent_Key, DyFM_SocketEventPreprocessTask, DyFM_SocketEventTask
 } from '@futdevpro/fsm-dynamo/socket';
 
 import { DyNTS_global_settings } from '../../../_collections/global-settings.const';
 import { DyNTS_SingletonService } from '../../../_services/base/singleton.service';
 import { DyNTS_SocketSecurity } from '../_enums/socket-security.enum';
-import { 
-  DyNTS_SocketServerService_Params 
-} from '../_models/socket-server-service-params.control-model';
-import { 
-  DyNTS_SocketPresence 
+import {
+  DyNTS_SocketPresence
 } from '../_models/socket-presence.control-model';
+import {
+  DyNTS_SocketServerService_Params
+} from '../_models/socket-server-service-params.control-model';
 
 /**
  * You need to define the following functions:
@@ -101,7 +102,7 @@ export abstract class DyNTS_SocketServerService<
       );
 
       throw new DyFM_Error({
-        errorCode: 'NTS-SSS-001',
+        errorCode: 'NTS-SSS-GPFSRC0',
         error: error,        
       });
     }
@@ -484,7 +485,7 @@ export abstract class DyNTS_SocketServerService<
           issuer
         ),
 
-        errorCode: 'NTS-SSS-109',
+        errorCode: 'NTS-SSS-DBT0',
       });
     }
   }
@@ -505,7 +506,7 @@ export abstract class DyNTS_SocketServerService<
             issuer
           ),
 
-          errorCode: 'NTS-SSS-203',
+          errorCode: 'NTS-SSS-RS1',
         });
       }
 
@@ -522,7 +523,7 @@ export abstract class DyNTS_SocketServerService<
             issuer
           ),
 
-          errorCode: 'NTS-SSS-201',
+          errorCode: 'NTS-SSS-RS2',
         });
       }
 
@@ -538,7 +539,7 @@ export abstract class DyNTS_SocketServerService<
             issuer
           ),
 
-          errorCode: 'NTS-SSS-202',
+          errorCode: 'NTS-SSS-RS3',
         });
       }
 
@@ -567,7 +568,7 @@ export abstract class DyNTS_SocketServerService<
           issuer
         ),
 
-        errorCode: 'NTS-SSS-200',
+        errorCode: 'NTS-SSS-RS0',
         message: `socket(${this.params.name}) Subscription Removal failed: "${this.params?.name}"`,
       });
     }
@@ -605,7 +606,7 @@ export abstract class DyNTS_SocketServerService<
           error
         ),
 
-        errorCode: 'NTS-SSS-600',
+        errorCode: 'NTS-SSS-IIS0',
         message: `socket(${this.params.name}) ID Subscription Check (${id}) failed`,
       });
     }
@@ -621,8 +622,7 @@ export abstract class DyNTS_SocketServerService<
           error,
           presenceIssuerId
         ),
-
-        errorCode: 'NTS-SSS-700',
+        errorCode: 'NTS-SSS-EE0',
         message: `socket(${this.params.name}) Error Emit (id: ${presenceIssuerId}) failed`,
       });
     }
@@ -637,9 +637,7 @@ export abstract class DyNTS_SocketServerService<
             new Error('No event was provided'),
             content?.source
           ),
-
-          status: 400, 
-          errorCode: 'NTS-SSS-300',
+          errorCode: 'NTS-SSS-SEFI1',
         });
       }
 
@@ -650,9 +648,7 @@ export abstract class DyNTS_SocketServerService<
             new Error('No ID was provided'),
             content?.source
           ),
-
-          status: 400, 
-          errorCode: 'NTS-SSS-301',
+          errorCode: 'NTS-SSS-SEFI2',
         });
       }
 
@@ -667,9 +663,7 @@ export abstract class DyNTS_SocketServerService<
             new Error(`No active socket with this specific ID: "${id}"`),
             content?.source
           ),
-
-          status: 404, 
-          errorCode: 'NTS-SSS-301',
+          errorCode: 'NTS-SSS-SEFI3',
         });
       }
 
@@ -678,18 +672,18 @@ export abstract class DyNTS_SocketServerService<
       if (DyNTS_global_settings.log_settings.socket_eventContent) {
         DyFM_Log.success(
           ` <--=  emitted socket(${this.params.name}) event: "${event}", ` +
-          `\n  presenceId: "${id}", sockets: ${presence.sockets.length}` +
-          `\n  content:`, content
+          `\n         presenceId: "${id}", sockets: ${presence.sockets.length}` +
+          `\n         content:`, content
         );
       } else {
         DyFM_Log.success(
           ` <--=  emitted socket(${this.params.name}) event: "${event}", ` +
-          `\n  presenceId: ${id}, sockets: ${presence.sockets.length}`
+          `\n         presenceId: ${id}, sockets: ${presence.sockets.length}`
         );
       }
     } catch (error) {
       try {
-        if (error.flag.includes('DYNAMO') && error?.additionalInfo?.inactiveSockets) {
+        if (error?.flag?.includes(DyFM_errorFlag) && error?.additionalInfo?.inactiveSockets) {
           const sockets: SocketIO.Socket[] = error.additionalInfo.inactiveSockets;
 
           await DyFM_Array.asyncForEach(sockets, async (socket: SocketIO.Socket) => {
@@ -707,17 +701,14 @@ export abstract class DyNTS_SocketServerService<
                 new Error(`No active socket(${this.params.name}) with this specific ID: "${id}"`),
                 content?.source
               ),
-
-              status: 404, 
-              errorCode: 'NTS-SSS-302',
+              errorCode: 'NTS-SSS-SEFI4',
             });
           }
         }
       } catch (error) {
         throw new DyFM_Error({
           ...this._getDefaultErrorSettings('sendEventForId', error, content?.source),
-  
-          errorCode: 'NTS-SSS-310',
+          errorCode: 'NTS-SSS-SEFI5',
           message: 
             `Error handling of inactive sockets(${this.params.name}) failed!` +
             `\n(Socket Event Emit for id (${id}, ${event}) failed)`,
@@ -726,8 +717,7 @@ export abstract class DyNTS_SocketServerService<
 
       throw new DyFM_Error({
         ...this._getDefaultErrorSettings('sendEventForId', error, content?.source),
-
-        errorCode: 'NTS-SSS-310',
+        errorCode: 'NTS-SSS-SEFI0',
         message: `socket(${this.params.name}) Event Emit for id (${id}, ${event}) failed`,
       });
     }
@@ -746,7 +736,7 @@ export abstract class DyNTS_SocketServerService<
       throw new DyFM_Error({
         ...this._getDefaultErrorSettings('broadcastEvent', error),
         
-        errorCode: 'NTS-SSS-400',
+        errorCode: 'NTS-SSS-BE0',
         message: `socket(${this.params.name}) Event Broadcast (${event}) failed`,
       });
     }
@@ -759,9 +749,7 @@ export abstract class DyNTS_SocketServerService<
   ): DyFM_Error_Settings {
     return {
       status: (error as DyFM_Error)?.___status ?? 500,
-      message: (error as Error)?.message ?? 
-        (error as DyFM_Error)?._message ?? 
-        `${fnName} was UNSUCCESSFUL (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,

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

@@ -32,6 +32,10 @@ export class DyNTS_ArchiveDataService<T extends DyFM_Metadata> extends DyNTS_Dat
      */
     issuer: string
   ) {
+    if (!dataParams.addArchive) {
+      throw new Error('addArchive is missing from dataParams!');
+    }
+
     const originalDataParams = { ...dataParams };
     
     dataParams = {