@futdevpro/nts-dynamo 1.6.55 → 1.6.58

package/src/_constants/global-settings.const.ts

@@ -18,5 +18,8 @@ export const dynamoNTS_globalSettings: DynamoNTS_GlobalSettings = {
   logMainSocketEvents: true,
   logSocketEventContent: false,
 
-  logDetailedApiEvents: true,
+  logApiEvents: true,
+  logApiRequestContents: false,
+  logApiRequestSettings: false,
+  logApiResponseContents: false,
 };

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

@@ -10,50 +10,36 @@ export class DynamoNTS_AppParams {
   /**
    * title will be shown on the start of the application
    */
-  title: string;
+  title?: string;
   /**
    * version of the application
+   * you should set the version,
+   * probably, you should set from the package.json as follows:
+   * import { version } from '../package.json';
    */
   version: string;
   /**
    * name of your MongoDB table
+   * by default, its: `mongodb://localhost:27017/${this.dbName}`
    */
-  dbUri: string;
+  dbUri?: string;
   /**
-   * mongoDB uri, by default, its: `mongodb://localhost:27017/${this.dbName}`
+   * name of your MongoDB table
    */
   dbName: string;
+  /**
+   * name of the system, by default, its: this.name.replace(' ', '-')
+   */
+  systemName?: string;
 
   constructor(
-    set: {
-      /**
-       * name the application
-       */
-      name: string,
-      /**
-       * you can set a big f*in title to show on the start of the application
-       */
-      title?: string,
-      /**
-       * you should set the version,
-       * probably, you should set from the package.json as follows:
-       * import { version } from '../package.json';
-       */
-      version: string,
-      /**
-       * You need to name your MongoDB table
-       */
-      dbName: string,
-      /**
-       * you can change the mongoDB uri here. by default, its: `mongodb://localhost:27017/${this.dbName}`
-       */
-      dbUri?: string,
-    }
+    set: DynamoNTS_AppParams
   ) {
     this.name = set.name;
     this.title = set.title ?? '';
     this.version = set.version;
     this.dbName = set.dbName;
     this.dbUri = set.dbUri ?? `mongodb://localhost:27017/${this.dbName}`;
+    this.systemName = set.systemName ?? this.name.replace(' ', '-');
   }
 }

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

@@ -26,6 +26,7 @@ export class DynamoNTS_EndpointParams{
   private tasks: ((req: Request, res: Response, issuer?: string) => Promise<void>)[];
 
   private logRequest: boolean;
+  private logRequestsParams: boolean;
   private logRequestsContent: boolean;
   private logResponseContent: boolean;
 
@@ -68,6 +69,10 @@ export class DynamoNTS_EndpointParams{
        * this flag will enable the debug logs on this endpoint
        */
       logRequest?: boolean,
+      /**
+       * this flag will enable the debug logs on this endpoint's requests
+       */
+      logRequestsParams?: boolean,
       /**
        * this flag will enable the debug logs on this endpoint's requests
        */
@@ -104,11 +109,15 @@ export class DynamoNTS_EndpointParams{
       this.tasks = set.tasks;
 
       this.logRequest = set.logRequest ?? dynamoNTS_globalSettings.logRequest;
+      this.logRequestsParams = set.logRequestsParams ?? dynamoNTS_globalSettings.logRequestsParams;
       this.logRequestsContent = set.logRequestsContent ?? dynamoNTS_globalSettings.logRequestsContent;
-      /* this.logResponseContent = set.logResponseContent ?? dynamoNTS_globalSettings.logResponseContent; */
+      this.logResponseContent = set.logResponseContent ?? dynamoNTS_globalSettings.logResponseContent;
     } catch (error) {
       Dynamo_Log.error(
-        `\nEndpoint params setup failed: name: '${set.name}' (security: ${set.security}) endpoint: ${set.endpoint}\nERROR:\n`, error);
+        `\nEndpoint params setup failed: name: '${set.name}' (security: ${set.security}) endpoint: ${set.endpoint}` +
+        `\nERROR:` +
+        `\n`, error
+      );
       throw error;
     }
   }
@@ -120,17 +129,37 @@ export class DynamoNTS_EndpointParams{
   private async preLog(req: Request, res: Response, issuer: string): Promise<void> {
     try {
       if (this.logRequest) {
-        if (this.logRequestsContent) {
+        let msg: string = `===>   incoming ${this.name} request... (issuer: ${issuer})`;
+
+        if (this.logRequestsParams) {
+          const params = this.getPathParamsLogContent(req);
+          msg += `\npathParams: ${params}`;
+        }
+
+        if (this.logRequestsContent && req.body && 0 < Object.keys(req.body).length) {
+          Dynamo_Log.info(msg + `\nbody:`, req.body);
+        } else {
+          Dynamo_Log.info(msg);
+        }
+
+        /* if (this.logRequestsContent) {
           const params = this.getPathParamsLogContent(req);
 
           if (req.body && 0 < Object.keys(req.body).length) {
-            console.log(`===> incoming ${this.name} request... (issuer: ${issuer})\npathParams:${params}\nbody:`, req.body);
+            console.log(
+              `===>   incoming ${this.name} request... (issuer: ${issuer})` +
+              `\npathParams: ${params}` +
+              `\nbody:`, req.body
+            );
           } else {
-            console.log(`===> incoming ${this.name} request... (issuer: ${issuer})\npathParams:${params}`);
+            console.log(
+              `===>   incoming ${this.name} request... (issuer: ${issuer})` +
+              `\npathParams: ${params}`
+            );
           }
         } else {
-          console.log(`===> incoming ${this.name} request...`);
-        }
+          console.log(`===>   incoming ${this.name} request...`);
+        } */
       }
 
     } catch (error) {

package/src/_models/control-models/socket-event.control-model.ts

@@ -96,7 +96,10 @@ export class DynamoNTS_SocketEvent<T>{
   private async getPreLog(content: T, issuer?: string): Promise<void> {
     try {
       if (this.logEventContent && this.eventKey !== DynamoNTS_SocketEventKey.connection) {
-        Dynamo_Log.log(`--->   incoming socket(${this.serviceName}) event: ${this.eventKey};\ncontent:`, content);
+        Dynamo_Log.log(
+          `--->   incoming socket(${this.serviceName}) event: ${this.eventKey};
+          \ncontent:`, content
+        );
       } else {
         Dynamo_Log.log(`--->   incoming socket(${this.serviceName}) event: ${this.eventKey}...`);
       }

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

@@ -33,6 +33,10 @@ export interface DynamoNTS_GlobalSettings {
    * this is an application wide default setting for route debug logs
    */
   logRequest?: boolean;
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  logRequestsParams?: boolean;
   /**
    * this is an application wide default setting for route debug logs
    */
@@ -58,5 +62,17 @@ export interface DynamoNTS_GlobalSettings {
   /**
    * this is an application wide default setting for api debug logs
    */
-  logDetailedApiEvents?: boolean;
+  logApiEvents?: boolean;
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  logApiRequestContents?: boolean;
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  logApiRequestSettings?: boolean;
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  logApiResponseContents?: boolean;
 }

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

@@ -101,6 +101,21 @@ export class DynamoNTS_ApiService {
             callParams.httpOptions.params = httpParams;
         } */
 
+        if (dynamoNTS_globalSettings.logApiEvents) {
+            if (dynamoNTS_globalSettings.logApiRequestContents) {
+                Dynamo_Log.log(`<      outgoing API call: ${url} \nbody:`, inputParams?.body);
+            } else {
+                Dynamo_Log.log(`<      outgoing API call: ${url}`);
+            }
+            if (dynamoNTS_globalSettings.logApiRequestSettings) {
+                Dynamo_Log.log(`callParams:`, callParams);
+                Dynamo_Log.log('inputParams:', { 
+                    pathParams: inputParams.pathParams ?? {}, 
+                    body: inputParams.body ?? null 
+                });
+            }
+        }
+
         switch (callParams.type) {
             case DynamoNTS_HttpCallType.get:
                 if (inputParams?.body) {
@@ -113,10 +128,12 @@ export class DynamoNTS_ApiService {
                         a = res.data;
                     }
 
-                    if (dynamoNTS_globalSettings.logDetailedApiEvents) {
-                        Dynamo_Log.success(`${callParams.name} was successful`, res.data);
-                    } else {
-                        Dynamo_Log.success(`${callParams.name} was successful`);
+                    if (dynamoNTS_globalSettings.logApiEvents) {
+                        if (dynamoNTS_globalSettings.logApiResponseContents) {
+                            Dynamo_Log.success(`${callParams.name} was successful`, res.data);
+                        } else {
+                            Dynamo_Log.success(`${callParams.name} was successful`);
+                        }
                     }
                 });
             break;
@@ -129,10 +146,12 @@ export class DynamoNTS_ApiService {
                         a = res;
                     }
 
-                    if (dynamoNTS_globalSettings.logDetailedApiEvents) {
-                        Dynamo_Log.success(`${callParams.name} was successful`, res.data);
-                    } else {
-                        Dynamo_Log.success(`${callParams.name} was successful`);
+                    if (dynamoNTS_globalSettings.logApiEvents) {
+                        if (dynamoNTS_globalSettings.logApiResponseContents) {
+                            Dynamo_Log.success(`${callParams.name} was successful`, res.data);
+                        } else {
+                            Dynamo_Log.success(`${callParams.name} was successful`);
+                        }
                     }
                 });
             break;
@@ -152,10 +171,12 @@ export class DynamoNTS_ApiService {
                         a = res.data;
                     }
 
-                    if (dynamoNTS_globalSettings.logDetailedApiEvents) {
-                        Dynamo_Log.success(`${callParams.name} api call was successful`, res.data);
-                    } else {
-                        Dynamo_Log.success(`${callParams.name} api call was successful`);
+                    if (dynamoNTS_globalSettings.logApiEvents) {
+                        if (dynamoNTS_globalSettings.logApiResponseContents) {
+                            Dynamo_Log.success(`>      ${callParams.name} api call was successful`, res.data);
+                        } else {
+                            Dynamo_Log.success(`>      ${callParams.name} api call was successful`);
+                        }
                     }
                 });
             break;
@@ -170,8 +191,11 @@ export class DynamoNTS_ApiService {
             return a as T;
         }
     } catch (error) {
-        Dynamo_Log.error(`\nAPI ERROR: ${callParams?.name} failed...` +
-        `\n${callParams?.baseUrl}${callParams?.endPoint}\ncallParams:`, callParams);
+        Dynamo_Log.error(
+            `\n>      API ERROR: ${callParams?.name} failed...` +
+            `\n${callParams?.baseUrl}${callParams?.endPoint}` +
+            `\ncallParams:`, callParams
+        );
 
         if (callParams?.httpOptions?.responseType === DynamoNTS_HttpResponseType.text) {
             error.error = JSON.parse(error.error);

package/src/_services/server/app.server.ts

@@ -223,6 +223,13 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
 
   constructor(extended?: boolean){
     super();
+    
+    process.on('unhandledRejection', (reason, p) => {
+      Dynamo_Log.highlightedError(
+        'Unhandled Rejection at: ', p, 
+        '\nRejection reason:', reason
+      );
+    });
 
     this.asyncConstruct(extended).catch((error: any) => {
       Dynamo_Log.error(`\nApplication: ${this._params.name} start failed.\n`, error);
@@ -234,11 +241,11 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
     try {
       this.systemControls.app.init = true;
       this._params = this.getAppParams();
-      dynamo_error_default.issuerSystem = this._params.name;
+
+      dynamo_error_default.issuerSystem = this._params.systemName;
       
-      if (this.overrideDynamoNTSGlobalSettings) {
-        this.overrideDynamoNTSGlobalSettings();        
-      } 
+      this.overrideDynamoNTSGlobalSettings?.();        
+
       this.logSetup = dynamoNTS_globalSettings.logSetup;
       
       this.globalService = DynamoNTS_GlobalService.getInstance();
@@ -258,9 +265,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
         this._routingModules = this.getRoutingModules();
       }
 
-      if (this.createEntries) {
-        await this.createEntries();
-      }
+      await this.createEntries?.();
 
       console.log(`\n\n\nStarting ${this._params.name}... `);
 
@@ -288,9 +293,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
         this._rootServices = await this.getRootServices();
       }
       
-      if (this.postProcess) { 
-        await this.postProcess();
-      }
+      await this.postProcess?.();
 
 
       if (!extended) {

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

@@ -184,8 +184,11 @@ export abstract class DynamoNTS_SocketServerService<
                  * but subscribe event is an exception from this, 
                  * to be able to check content before getPresenceFromSubscrioptionEventContent 
                  */
-                if (dynamoNTS_globalSettings.logMainSocketEvents || dynamoNTS_globalSettings.logAllSocketEvent || dynamoNTS_globalSettings.logSocketEventContent) {
-                  Dynamo_Log.log(`--->   incoming socket(${this.params.name}) event: ${DynamoNTS_SocketEventKey.subscribe};\ncontent:`, content);
+                if (dynamoNTS_globalSettings.logSocketEventContent) {
+                  Dynamo_Log.log(
+                    `--->   incoming socket(${this.params.name}) event: ${DynamoNTS_SocketEventKey.subscribe};` +
+                    `\ncontent:`, content
+                  );
                 } else {
                   Dynamo_Log.log(`--->   incoming socket(${this.params.name}) event: ${DynamoNTS_SocketEventKey.subscribe}`);
                 }
@@ -391,9 +394,9 @@ export abstract class DynamoNTS_SocketServerService<
     }
   }
 
-  emitError(presenceIssuerId: string, error: any): void {
+  async emitError(presenceIssuerId: string, error: any): Promise<void> {
     try {
-      this.sendEventForId(presenceIssuerId, DynamoNTS_SocketEventKey.error, error);
+      await this.sendEventForId(presenceIssuerId, DynamoNTS_SocketEventKey.error, error);
     } catch (error) {
       throw new Dynamo_Error({
         ...this._getDefaultErrorSettings(