@futdevpro/nts-dynamo 1.9.8 → 1.9.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/nts-dynamo",
-  "version": "01.09.08",
+  "version": "01.09.10",
   "description": "Dynamic NodeTS (NodeJS-Typescript), MongoDB Backend System Framework by Future Development Program Ltd.",
   "scripts": {
     "prep": "npm i rimraf nodemon -g",

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

@@ -22,4 +22,6 @@ export const DynamoNTS_globalSettings: DynamoNTS_Global_Settings = {
   logApiRequestContents: false,
   logApiRequestSettings: false,
   logApiResponseContents: false,
+
+  logDetailedErrors: false,
 };

package/src/_constants/mocks/auth-service.mock.ts

@@ -10,11 +10,11 @@ export class AuthService_Mock extends DynamoNTS_AuthService {
     return AuthService_Mock.getSingletonInstance();
   }
 
-  async authenticateToken(req: Request, res: Response): Promise<void> {}
+  authenticate_token = async (req: Request, res: Response): Promise<void> => {};
 
-  async authenticateTokenSelf(req: Request, res: Response): Promise<void> {}
+  authenticate_tokenSelf = async (req: Request, res: Response): Promise<void> => {};
   
-  async authTokenPermAccUsageData(req: Request, res: Response): Promise<void> {}
+  authenticate_tokenPermAccUsageData = async (req: Request, res: Response): Promise<void> => {};
 
   getIssuerFromRequest(req: Request): string {
     return 'accountId_mock';

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

@@ -230,6 +230,8 @@ export class DynamoNTS_Endpoint_Params {
           (error as DynamoFM_Error).additionalContent = {};
         }
         (error as DynamoFM_Error).additionalContent.endpointInfo = msg;
+        DynamoFM_Log.error(`ErrorMessage: ${(error as DynamoFM_Error)._message}`);
+        DynamoFM_Log.error(`ErrorCode: ${(error as DynamoFM_Error)._errorCode}`);
       }
 
       await DynamoNTS_GlobalService.globalErrorHandler?.(
@@ -262,6 +264,7 @@ export class DynamoNTS_Endpoint_Params {
           );
         }
       }
+          
     } catch (error) {
       DynamoFM_Log.H_error(
         `\n\nDYNAMO MULTILEVEL ERROR:DynamoNTS_EndpointParams: error: ` +
@@ -271,6 +274,11 @@ export class DynamoNTS_Endpoint_Params {
         `\nERROR:`, error, 
         '\n'
       );
+
+      if (error?.flag?.includes?.('DYNAMO-ERROR-OBJECT')) {
+        DynamoFM_Log.error(`ErrorMessage: ${(error as DynamoFM_Error)._message}`);
+        DynamoFM_Log.error(`ErrorCode: ${(error as DynamoFM_Error)._errorCode}`);
+      }
     }
   }
 

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

@@ -75,4 +75,9 @@ export interface DynamoNTS_Global_Settings {
    * this is an application wide default setting for api debug logs
    */
   logApiResponseContents?: boolean;
+
+  /**
+   * this is an application wide default setting for detailed error logs
+   */
+  logDetailedErrors?: boolean;
 }

package/src/_modules/usage/usage.controller.ts

@@ -99,7 +99,7 @@ export class DynamoNTS_Usage_Controller extends DynamoNTS_Controller {
         name: 'getUsageData',
         type: DynamoNTS_HttpCallType.get,
         endpoint: DynamoFM_usageModule_settings.endPoints.getUsageData,
-        preProcesses: [this.authService.authTokenPermAccUsageData],
+        preProcesses: [ this.authService.authenticate_tokenPermAccUsageData ],
         tasks: [
           async (req: Request, res: Response): Promise<void> => {
             const range: DynamoFM_RelativeDate = req.params.range as DynamoFM_RelativeDate;

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

@@ -1,7 +1,7 @@
 
 import { 
   DynamoFM_Metadata, DynamoFM_DataModel_Params, DynamoFM_DataProperty_Params, DynamoFM_Error,
-  DynamoFM_Log, DynamoFM_AnyError, DynamoFM_Error_Settings 
+  DynamoFM_Log, DynamoFM_AnyError, DynamoFM_Error_Settings, DynamoFM_ErrorLevel 
 } from '@futdevpro/fsm-dynamo';
 import { DynamoNTS_DBFilter } from '../../_models/types/db-filter.type';
 import { DynamoNTS_DBUpdate } from '../../_models/types/db-update.type';
@@ -74,14 +74,23 @@ export class DynamoNTS_DataService<T extends DynamoFM_Metadata> {
       this.lookForDependencyDataSettings();
       this.issuer = issuer;
     } catch (error) {
-      DynamoFM_Log.error(
+      throw new DynamoFM_Error({
+        ...this._getDefaultErrorSettings('constructor', error),
+        message: `The dataService construction failed for ${dataParams?.dataName}. ` +
+          `${this.serviceName} (${this.constructor.name})` +
+          `\nMaybe you forgot to add the dbService to the GlobalService?\n\n`,
+        level: DynamoFM_ErrorLevel.critical,
+        
+        errorCode: 'NTS-DS0-C00',
+      });
+      /* DynamoFM_Log.error(
         `\nDynamoNTS_DataService ERROR: ` +
         `\nThe dataService construction failed for ` +
         `${dataParams?.dataName}. ${this.serviceName} (${this.constructor.name})` +
         `\nMaybe you forgot to add the dbService to the GlobalService?` +
         `\n\n`, 
         new Error()
-      );
+      ); */
     }
   }
 

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

@@ -4,7 +4,7 @@ import { Schema } from 'mongoose';
 
 import { 
   DynamoFM_Metadata, DynamoFM_DataModel_Params, DynamoFM_DataProperty_Params, DynamoFM_Error, 
-  DynamoFM_Log, DynamoFM_AnyError, DynamoFM_Error_Settings 
+  DynamoFM_Log, DynamoFM_AnyError, DynamoFM_Error_Settings, DynamoFM_ErrorLevel 
 } from '@futdevpro/fsm-dynamo';
 import { DynamoNTS_DBFilter } from '../../_models/types/db-filter.type';
 import { DynamoNTS_DBUpdate } from '../../_models/types/db-update.type';
@@ -48,12 +48,20 @@ export class DynamoNTS_DBService<T extends DynamoFM_Metadata> {
 
       this.lookForDependencyDataSettings();
     } catch (error) {
-      DynamoFM_Log.error(
+      throw new DynamoFM_Error({
+        message: 
+          `DynamoNTS_DBService construction failed! ${dataParams.dataName} - ${this.serviceName}`,
+        errorCode: 'NTS-DBS-C00',
+        level: DynamoFM_ErrorLevel.critical,
+        additionalContent: { dataParams: this.dataParams },
+        error,
+      });
+      /* DynamoFM_Log.error(
         `\nDynamoNTS_DBService ERROR, ` +
         `The dbService construction failed for ${dataParams.dataName}. ${this.serviceName}` +
         `\nERROR: `, error,
         new Error()
-      );
+      ); */
     }
   }
 

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

@@ -106,7 +106,18 @@ export class DynamoNTS_ApiService {
           break;
 
         default:
-          DynamoFM_Log.error('DYNAMOBE ERROR: \n wrong api call type'/* , '\n\n', new Error() */);
+          throw new DynamoFM_Error({
+            ...this._getDefaultErrorSettings(
+              'startApiCall',
+              new Error('wrong api call type')
+            ),
+            errorCode: 'NTS-API-SAC0',
+            additionalContent: {
+              callParams,
+              inputParams,
+            },
+          });
+          //DynamoFM_Log.error('DYNAMO-NTS ERROR: \n wrong api call type'/* , '\n\n', new Error() */);
           break;
       }
 
@@ -137,7 +148,7 @@ export class DynamoNTS_ApiService {
             break;
 
           default:
-            console.error('DYNAMOBE ERROR: \n wrong query param type', '\n\n', new Error());
+            console.error('DYNAMO-NTS ERROR: \n wrong query param type', '\n\n', new Error());
             break;
         }
       }
@@ -212,11 +223,11 @@ export class DynamoNTS_ApiService {
 
         status: 404,
         errorCode: 'NTS-API-SAC3',
-        message: `Can't connect to the endpoin!`,
+        message: `Can't connect to the endpoint!`,
         additionalContent: {
           callParams,
           inputParams,
-        }
+        },
       });
 
     } else if (error.config && error.message) {
@@ -235,7 +246,10 @@ export class DynamoNTS_ApiService {
         },
       });
     } else {
-      DynamoFM_Log.error(`\n${callParams.name} was UNSUCCESSFUL`, error /*, '\n\n' , new Error() */);
+      DynamoFM_Log.error(
+        `\n${callParams.name} was UNSUCCESSFUL`, 
+        error /*, '\n\n' , new Error() */
+      );
 
       throw error;
     }
@@ -345,10 +359,13 @@ export class DynamoNTS_ApiService {
         axios.defaults.headers.common[headerKey] = callParams.httpOptions.headers[headerKey];
 
       } else {
-        DynamoFM_Log.error(
-          'DYNAMOBE ERROR: \n missing header:',
-          headerKey
-        );
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings(
+            'setupHeaders',
+            new Error(`missing header: ${headerKey}`)
+          ),
+          errorCode: 'NTS-API-SH0',
+        });
       }
     }
   }
@@ -374,20 +391,38 @@ export class DynamoNTS_ApiService {
             break;
 
           default:
-            DynamoFM_Log.error(
-              `DYNAMOBE ERROR: \n wrong path param type: (${pathParamKey}): ${paramType} ` +
+            /* DynamoFM_Log.error(
+              `DYNAMO-NTS ERROR:`+
+              `\nwrong path param type: (${pathParamKey}): ${paramType} ` +
               `\n${pathParams[pathParamKey]}` +
               `\nMUST BE string or number` +
               `\n\n`,
               new Error()
-            );
+            ); */
+            throw new DynamoFM_Error({
+              ...this._getDefaultErrorSettings(
+                'setupPathParams',
+                new Error(
+                  `wrong path param type: (${pathParamKey}): ${paramType}` +
+                  `\n${pathParams[pathParamKey]}`
+                )
+              ),
+              errorCode: 'NTS-API-SP1',
+              additionalContent: {
+                pathParams: pathParams,
+                url: url,
+              },
+            });
             break;
         }
       } else {
-        DynamoFM_Log.error(
-          'DYNAMOBE ERROR: \n missing pathParam:',
-          pathParamKey /* , '\n\n', new Error() */
-        );
+        throw new DynamoFM_Error({
+          ...this._getDefaultErrorSettings(
+            'setupPathParams',
+            new Error(`missing pathParam: ${pathParamKey}`)
+          ),
+          errorCode: 'NTS-API-SP0',
+        });
       }
     }
 

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

@@ -92,7 +92,7 @@ export abstract class DynamoNTS_AuthService extends DynamoNTS_SingletonService {
    *   }
    * }
    * */
-  abstract authenticateToken(req: Request, res: Response): Promise<void>;
+  abstract authenticate_token: (req: Request, res: Response) => Promise<void>;
 
   /**
    * You need to implement a token validation logic, 
@@ -128,7 +128,7 @@ export abstract class DynamoNTS_AuthService extends DynamoNTS_SingletonService {
    * }
    * 
    */
-  abstract authenticateTokenSelf(req: Request, res: Response): Promise<void>;
+  abstract authenticate_tokenSelf: (req: Request, res: Response) => Promise<void>;
   
   /**
    * Authenticate Token for Permission to Access UsageData
@@ -144,7 +144,7 @@ export abstract class DynamoNTS_AuthService extends DynamoNTS_SingletonService {
    *   AuthService.authTokenAndPerm(req, res, next, Permission.accessUsageData);
    * }
    */
-  abstract authTokenPermAccUsageData(req: Request, res: Response): Promise<void>;
+  abstract authenticate_tokenPermAccUsageData: (req: Request, res: Response) => Promise<void>;
 
   /**
    * The DynamoBE System is using this to get issuer, that will be set on DBServices

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

@@ -18,6 +18,7 @@ import { DynamoNTS_EmailService } from './email.service';
 import { DynamoNTS_Service_Collection } from './service-collection.service';
 /* import { DynamoNTS_EmailServiceCollection } from './email-service-collection.service'; */
 import { DynamoNTS_SingletonService } from '../base/singleton.service';
+import { DynamoNTS_globalSettings } from '../../_constants';
 
 /**
  * This is the main Global/Core Service Collection used by DynamoBE, 
@@ -105,7 +106,15 @@ export class DynamoNTS_GlobalService extends DynamoNTS_SingletonService {
         set.errorHandler ?? 
         (async (error: any): Promise<void> => {
           DynamoFM_Log.warn(`globalErrorHandler not set!`);
-          DynamoFM_Log.error(`ERROR:\n`, error);
+
+          if (DynamoNTS_globalSettings.logDetailedErrors) {
+            DynamoFM_Log.error(`ERROR:\n`, error);
+          }
+          
+          if (error?.flag?.includes?.('DYNAMO-ERROR-OBJECT')) {
+            DynamoFM_Log.error(`\nErrorMessage: ${(error as DynamoFM_Error)._message}`);
+            DynamoFM_Log.error(`ErrorCode: ${(error as DynamoFM_Error)._errorCode}`);
+          }
         });
     } catch (error) {
       throw new DynamoFM_Error({
@@ -125,7 +134,7 @@ export class DynamoNTS_GlobalService extends DynamoNTS_SingletonService {
    * @returns 
    */
   static getAuthService(): DynamoNTS_AuthService {
-    if (!this.instance?.authService?.authenticateToken) {
+    if (!(this.instance?.authService as DynamoNTS_AuthService)?.authenticate_token) {
       throw new Error(
         `\n  Unique Authentication Service missing!` + 
         `\n    Please create a Unique Authentication Service extending DynamoNTS_AuthService, ` + 

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

@@ -288,7 +288,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
         );
 
       } catch (error) {
-        DynamoFM_Log.error('getGlobalErrorHandler ERROR:', error);
+        DynamoFM_Log.error('globalErrorHandler (MULTILEVEL) ERROR:', error);
       }
     });
 
@@ -299,7 +299,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
       );
 
       if (error?.flag?.includes?.('DYNAMO-ERROR-OBJECT')) {
-        DynamoFM_Log.error(`\nError: ${(error as DynamoFM_Error)._message}`);
+        DynamoFM_Log.error(`\nErrorMessage: ${(error as DynamoFM_Error)._message}`);
         DynamoFM_Log.error(`ErrorCode: ${(error as DynamoFM_Error)._errorCode}`);
       }
     });
@@ -389,7 +389,11 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
       }
     } catch (error) {
       this.constructErrors.push(error);
-      DynamoFM_Log.error(`${this._params.name} start failed. ERRORS`, this.constructErrors);
+      DynamoFM_Log.error(
+        `${this._params.name} start failed. ERRORS`, 
+        this.constructErrors,
+        error
+      );
 
       throw new DynamoFM_Error({
         ...this._getDefaultErrorSettings(
@@ -418,7 +422,10 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
     const start: number = +new Date();
 
     if (this.constructErrors.length) {
-      DynamoFM_Log.error(`${this._params.name} start failed. ERRORS`, this.constructErrors);
+      DynamoFM_Log.error(
+        `${this._params.name} start failed. \nERRORS:`, 
+        this.constructErrors
+      );
 
       throw new DynamoFM_Error({ 
         ...this._getDefaultErrorSettings(
@@ -426,7 +433,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
           new Error(`${this._params.name} start failed. ERRORS`)
         ),
 
-        errorCode: 'NTS-AS0-R1',
+        errorCode: 'NTS-AS0-R01',
         additionalContent: 
           this.constructErrors.length === 1 ? 
             this.constructErrors[0] : 
@@ -459,7 +466,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
           new Error(`${this._params.name} start failed. TIMEOUT`)
         ),
 
-        errorCode: 'NTS-AS0-R2',
+        errorCode: 'NTS-AS0-R02',
         additionalContent: {
           constructErrors: this.constructErrors,
           systemControls: this.systemControls,
@@ -481,7 +488,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
           new Error(`${this._params.name} start failed. ERROR`)
         ),
 
-        errorCode: 'NTS-AS0-R3',
+        errorCode: 'NTS-AS0-R03',
         additionalContent: this.constructErrors,
       });
     }
@@ -517,7 +524,7 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
           new Error(msg)
         ),
 
-        errorCode: 'NTS-AS0-R4',
+        errorCode: 'NTS-AS0-R04',
         additionalContent: {
           constructErrors: this.constructErrors,
           systemControls: this.systemControls,
@@ -915,11 +922,11 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
                 DynamoNTS_GlobalService.globalErrorHandler?.(d_error);
               }
             })
-            .on('uncaughtException', (ex): void => {
+            .on('uncaughtException', (exception): void => {
               const d_error: DynamoFM_Error = new DynamoFM_Error({
                 ...this._getDefaultErrorSettings(
                   'httpServer.on(uncaughtException)',
-                  ex
+                  exception
                 ),
 
                 errorCode: 'NTS-AS0-SE5',
@@ -927,7 +934,9 @@ export abstract class DynamoNTS_App extends DynamoNTS_SingletonService {
                 level: DynamoFM_ErrorLevel.critical,
               });
 
-              if (this.debugLog) DynamoFM_Log.warn(`\nHTTP (open) server uncaughtException`, d_error);
+              if (this.debugLog) {
+                DynamoFM_Log.warn(`\nHTTP (open) server uncaughtException`, d_error);
+              }
 
               DynamoNTS_GlobalService.globalErrorHandler?.(d_error);
             });

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

@@ -79,6 +79,11 @@ export abstract class DynamoNTS_SocketClientService extends DynamoNTS_SingletonS
 
     this.asyncConstructor().catch((error: any) => {
       DynamoFM_Log.error(`socket-client(${this.params?.name}) Service setup failed! ERROR:`, error);
+      
+      if (error?.flag?.includes?.('DYNAMO-ERROR-OBJECT')) {
+        DynamoFM_Log.error(`\nErrorMessage: ${(error as DynamoFM_Error)._message}`);
+        DynamoFM_Log.error(`ErrorCode: ${(error as DynamoFM_Error)._errorCode}`);
+      }
     });
   }
 

package/tsconfig.json

@@ -18,9 +18,9 @@
     "moduleResolution": "node",
     "esModuleInterop": true,
     "skipLibCheck": true,
+    "noImplicitOverride": true,
     "allowSyntheticDefaultImports": true,
     "forceConsistentCasingInFileNames": true,
-    "noImplicitOverride": true,
     "resolveJsonModule": true,
     "paths": {