@futdevpro/fsm-dynamo 1.9.28 → 1.9.30

package/build/_modules/socket/_services/sck-client.service-base.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_SocketClient_ServiceBase = void 0;
+const tslib_1 = require("tslib");
+const SocketIOClient = tslib_1.__importStar(require("socket.io-client"));
+const global_settings_const_1 = require("../../../_collections/constants/global-settings.const");
+const error_control_model_1 = require("../../../_models/control-models/error.control-model");
+const log_util_1 = require("../../../_collections/utils/log.util");
+const array_util_1 = require("../../../_collections/utils/array.util");
+const utilities_util_1 = require("../../../_collections/utils/utilities.util");
+const sck_event_key_enum_1 = require("../_enums/sck-event-key.enum");
+const sck_socket_event_control_model_1 = require("../_models/sck-socket-event.control-model");
+class DyFM_SocketClient_ServiceBase {
+    _params;
+    get params() { return this._params; }
+    get name() { return this.params.name; }
+    socket;
+    incomingEvents;
+    _connected = false;
+    get connected() { return this._connected; }
+    debugLog = global_settings_const_1.DyFM_global_settings.log_settings.setup;
+    logFn = global_settings_const_1.DyFM_global_settings.log_settings.functions;
+    defaultEvents = [
+        new sck_socket_event_control_model_1.DyFM_SocketEvent({
+            eventKey: sck_event_key_enum_1.DyFM_SocketEvent_Key.connect,
+            tasks: [
+                async () => {
+                    this._connected = true;
+                    log_util_1.DyFM_Log.success(`<   >  socket-client(${this.params.name}) connected!`);
+                },
+            ],
+        }),
+        new sck_socket_event_control_model_1.DyFM_SocketEvent({
+            eventKey: sck_event_key_enum_1.DyFM_SocketEvent_Key.disconnect,
+            tasks: [
+                async () => {
+                    this._connected = false;
+                    log_util_1.DyFM_Log.warn(`<x  >  socket-client(${this.params.name}) disconnected!`);
+                    if (this._params.reconnect) {
+                        await (0, utilities_util_1.DyFM_delay)(this._params.reconnectDelay);
+                        this.connectSocket();
+                    }
+                },
+            ],
+        }),
+        new sck_socket_event_control_model_1.DyFM_SocketEvent({
+            eventKey: sck_event_key_enum_1.DyFM_SocketEvent_Key.subscriptionSuccessful,
+            tasks: [
+                async () => {
+                    log_util_1.DyFM_Log.success(`<=-->  socket-client(${this.params.name}) subscription successful!`);
+                },
+            ],
+        }),
+        new sck_socket_event_control_model_1.DyFM_SocketEvent({
+            eventKey: sck_event_key_enum_1.DyFM_SocketEvent_Key.error,
+            tasks: [
+                async (content) => {
+                    log_util_1.DyFM_Log.error(`=-->   socket-client(${this.params.name}) ERROR!:`, content);
+                },
+            ],
+        }),
+    ];
+    constructor() {
+        this.asyncConstructor().catch((error) => {
+            if (global_settings_const_1.DyFM_global_settings.log_settings.highDetailedLogs ||
+                !(error instanceof error_control_model_1.DyFM_Error)) {
+                log_util_1.DyFM_Log.H_error(`socket-client "${this.params?.name}" Service setup failed! ` +
+                    `(DyFM_SocketClientService constructor catch)`, `\n    ERROR:`, error);
+            }
+            else {
+                error.logSimple(`socket-client "${this.params?.name}" Service setup failed! ` +
+                    `(DyFM_SocketClientService constructor catch)`);
+            }
+        });
+    }
+    async asyncConstructor() {
+        try {
+            this._params = this.getParams();
+            this.incomingEvents = this.getIncomingEvents() ?? [];
+            this.socket = SocketIOClient.io(`${this.params.address}:${this.params.port}`, {
+                reconnection: this.params.reconnect,
+                reconnectionDelay: this.params.reconnectDelay,
+                ...this.params.socketOptions,
+            });
+            await this.setupDefaultEvents();
+            await this.setupSocketEvents();
+            log_util_1.DyFM_Log.success(`\nsocket-client(${this.params?.name}) Service setup finished`);
+            await this.connectSocket();
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`socket-client(${this.params?.name}) Service setup failed!`, error);
+            throw new error_control_model_1.DyFM_Error({
+                errorCode: 'FM-SCS-001',
+                error: error,
+            });
+        }
+    }
+    async setupDefaultEvents() {
+        try {
+            if (this.logFn)
+                console.log('\nFn:. setupDefaultEvents');
+            this.defaultEvents.forEach((defaultEvent) => {
+                defaultEvent.serviceName = this.params.name;
+                const eventDeclared = this.incomingEvents.find((event) => event.eventKey === defaultEvent.eventKey);
+                if (!eventDeclared) {
+                    this.incomingEvents.push(defaultEvent);
+                }
+                else {
+                    eventDeclared.tasks.unshift(...defaultEvent.tasks);
+                }
+            });
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`socket-client(${this.params.name}) Service Setup Default Events failed, ` +
+                `ERROR:`, error);
+            throw error;
+        }
+    }
+    async setupSocketEvents() {
+        try {
+            if (this.debugLog)
+                console.log(`Setup socket-client(${this.params.name}) Events...`);
+            await array_util_1.DyFM_Array.asyncForEach(this.incomingEvents, async (event) => {
+                event.serviceName = this.params.name;
+                this.socket.on(event.eventKey, async (content) => {
+                    try {
+                        await event.executeEventTasks(content, this.params.service);
+                    }
+                    catch (error) {
+                        log_util_1.DyFM_Log.error(`socket-client(${this.params.name}) Event failed, ERROR:`, error);
+                        await this.emitEvent(sck_event_key_enum_1.DyFM_SocketEvent_Key.error, error);
+                    }
+                });
+            });
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`socket-client(${this.params.name}) Service Setup Socket Events failed, ` +
+                `ERROR:`, error);
+            throw error;
+        }
+    }
+    async connectSocket() {
+        try {
+            log_util_1.DyFM_Log.info(`< .. > socket-client(${this.params.name}) ` +
+                `connecting to ${this.params.address}:${this.params.port} ...`);
+            this.socket.connect();
+            if (this.params.reconnect) {
+                await this.tryReconnectIfNeeded();
+            }
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`socket-client(${this.params.name}) Service Connect Socket failed, ` +
+                `ERROR:`, error);
+            throw error;
+        }
+    }
+    async tryReconnectIfNeeded() {
+        try {
+            if (this.logFn)
+                console.log(`\nFn:. tryReconnectIfNeeded`);
+            await (0, utilities_util_1.DyFM_delay)(this._params.reconnectDelay);
+            if (!this._connected) {
+                await this.connectSocket();
+            }
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`socket-client(${this.params.name}) Service Try Reconnect failed, ` +
+                `ERROR:`, error);
+            throw error;
+        }
+    }
+    /**
+     * Emit event to the socket
+     * @param eventType event name
+     * @param content event content
+     */
+    async emitEvent(eventType, content) {
+        try {
+            log_util_1.DyFM_Log.log(`<=--   outgoing socket-client(${this.params.name}) event: ${eventType}`);
+            this.socket.emit(eventType, content);
+        }
+        catch (error) {
+            log_util_1.DyFM_Log.error(`socket-client(${this.params.name}) ` +
+                `Service Emit Event failed: ${this.params?.name} (${this.params?.port})`, error);
+            throw error;
+        }
+    }
+}
+exports.DyFM_SocketClient_ServiceBase = DyFM_SocketClient_ServiceBase;
+//# sourceMappingURL=sck-client.service-base.js.map

package/build/_modules/socket/_services/sck-client.service-base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sck-client.service-base.js","sourceRoot":"","sources":["../../../../src/_modules/socket/_services/sck-client.service-base.ts"],"names":[],"mappings":"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"}

package/build/_modules/socket/index.d.ts

@@ -1,2 +1,5 @@
+export * from './_enums/sck-event-key.enum';
 export * from './_models/sck-client-params.control-model';
+export * from './_models/sck-socket-event.control-model';
+export * from './_services/sck-client.service-base';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/socket/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/socket/index.ts"],"names":[],"mappings":"AAGA,cAAc,2CAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/_modules/socket/index.ts"],"names":[],"mappings":"AAIA,cAAc,6BAA6B,CAAC;AAI5C,cAAc,2CAA2C,CAAC;AAC1D,cAAc,0CAA0C,CAAC;AAIzD,cAAc,qCAAqC,CAAC"}

package/build/_modules/socket/index.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+// ENUMS
+tslib_1.__exportStar(require("./_enums/sck-event-key.enum"), exports);
 // MODELS
 tslib_1.__exportStar(require("./_models/sck-client-params.control-model"), exports);
+tslib_1.__exportStar(require("./_models/sck-socket-event.control-model"), exports);
+// SERVICES
+tslib_1.__exportStar(require("./_services/sck-client.service-base"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/socket/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/socket/index.ts"],"names":[],"mappings":";;;AAEA,SAAS;AACT,oFAA0D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/_modules/socket/index.ts"],"names":[],"mappings":";;;AAGA,QAAQ;AACR,sEAA4C;AAG5C,SAAS;AACT,oFAA0D;AAC1D,mFAAyD;AAGzD,WAAW;AACX,8EAAoD"}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export * from './_collections/constants/error-defaults.const';
+export * from './_collections/constants/global-settings.const';
 export * from './_collections/constants/times.const';
 export * from './_collections/utils/array.util';
 export * from './_collections/utils/log.util';
@@ -34,4 +35,6 @@ export * from './_models/interfaces/paged.interface';
 export * from './_models/interfaces/random-weight.interface';
 export * from './_models/interfaces/route-settings.interface';
 export * from './_models/interfaces/vector2.interface';
+export * from './_models/interfaces/environment/global-settings.interface';
+export * from './_models/interfaces/environment/global-log-settings.interface';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,+CAA+C,CAAC;AAC9D,cAAc,sCAAsC,CAAC;AAGrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iDAAiD,CAAC;AAChE,cAAc,qCAAqC,CAAC;AAGpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AAGvD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC;AAI/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AAKjD,cAAc,0DAA0D,CAAC;AACzE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,oDAAoD,CAAC;AAGnE,cAAc,2CAA2C,CAAC;AAG1D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,sCAAsC,CAAC;AACrD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,wCAAwC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,+CAA+C,CAAC;AAC9D,cAAc,gDAAgD,CAAC;AAC/D,cAAc,sCAAsC,CAAC;AAGrD,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,gCAAgC,CAAC;AAC/C,cAAc,iDAAiD,CAAC;AAChE,cAAc,qCAAqC,CAAC;AAGpD,cAAc,2CAA2C,CAAC;AAC1D,cAAc,qCAAqC,CAAC;AACpD,cAAc,uCAAuC,CAAC;AACtD,cAAc,6CAA6C,CAAC;AAC5D,cAAc,wCAAwC,CAAC;AAGvD,cAAc,gDAAgD,CAAC;AAC/D,cAAc,uCAAuC,CAAC;AACtD,cAAc,gDAAgD,CAAC;AAI/D,cAAc,mCAAmC,CAAC;AAClD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AAKjD,cAAc,0DAA0D,CAAC;AACzE,cAAc,6DAA6D,CAAC;AAC5E,cAAc,8CAA8C,CAAC;AAC7D,cAAc,6CAA6C,CAAC;AAC5D,cAAc,oDAAoD,CAAC;AAGnE,cAAc,2CAA2C,CAAC;AAG1D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,sCAAsC,CAAC;AACrD,cAAc,8CAA8C,CAAC;AAC7D,cAAc,+CAA+C,CAAC;AAC9D,cAAc,wCAAwC,CAAC;AAGvD,cAAc,4DAA4D,CAAC;AAC3E,cAAc,gEAAgE,CAAC"}

package/build/index.js

@@ -4,6 +4,7 @@ const tslib_1 = require("tslib");
 // COLLECTIONS
 // collections/CONSTANTS
 tslib_1.__exportStar(require("./_collections/constants/error-defaults.const"), exports);
+tslib_1.__exportStar(require("./_collections/constants/global-settings.const"), exports);
 tslib_1.__exportStar(require("./_collections/constants/times.const"), exports);
 // collections/UTILS
 tslib_1.__exportStar(require("./_collections/utils/array.util"), exports);
@@ -48,4 +49,7 @@ tslib_1.__exportStar(require("./_models/interfaces/paged.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/random-weight.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/route-settings.interface"), exports);
 tslib_1.__exportStar(require("./_models/interfaces/vector2.interface"), exports);
+// models/interfaces/ENVIRONMENT
+tslib_1.__exportStar(require("./_models/interfaces/environment/global-settings.interface"), exports);
+tslib_1.__exportStar(require("./_models/interfaces/environment/global-log-settings.interface"), exports);
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,wBAAwB;AACxB,wFAA8D;AAC9D,+EAAqD;AAErD,oBAAoB;AACpB,0EAAgD;AAChD,wEAA8C;AAC9C,+EAAqD;AACrD,qFAA2D;AAC3D,yEAA+C;AAC/C,0FAAgE;AAChE,8EAAoD;AAEpD,yBAAyB;AACzB,oFAA0D;AAC1D,8EAAoD;AACpD,gFAAsD;AACtD,sFAA4D;AAC5D,iFAAuD;AAEvD,2BAA2B;AAC3B,yFAA+D;AAC/D,gFAAsD;AACtD,yFAA+D;AAG/D,QAAQ;AACR,4EAAkD;AAClD,wEAA8C;AAC9C,oEAA0C;AAC1C,oEAA0C;AAC1C,kEAAwC;AAExC,aAAa;AACb,yEAA+C;AAC/C,mEAAyC;AACzC,2EAAiD;AAGjD,SAAS;AACT,wBAAwB;AACxB,mGAAyE;AACzE,sGAA4E;AAC5E,uFAA6D;AAC7D,sFAA4D;AAC5D,6FAAmE;AAEnE,qBAAqB;AACrB,oFAA0D;AAE1D,oBAAoB;AACpB,wFAA8D;AAC9D,+EAAqD;AACrD,uFAA6D;AAC7D,wFAA8D;AAC9D,iFAAuD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AACA,cAAc;AACd,wBAAwB;AACxB,wFAA8D;AAC9D,yFAA+D;AAC/D,+EAAqD;AAErD,oBAAoB;AACpB,0EAAgD;AAChD,wEAA8C;AAC9C,+EAAqD;AACrD,qFAA2D;AAC3D,yEAA+C;AAC/C,0FAAgE;AAChE,8EAAoD;AAEpD,yBAAyB;AACzB,oFAA0D;AAC1D,8EAAoD;AACpD,gFAAsD;AACtD,sFAA4D;AAC5D,iFAAuD;AAEvD,2BAA2B;AAC3B,yFAA+D;AAC/D,gFAAsD;AACtD,yFAA+D;AAG/D,QAAQ;AACR,4EAAkD;AAClD,wEAA8C;AAC9C,oEAA0C;AAC1C,oEAA0C;AAC1C,kEAAwC;AAExC,aAAa;AACb,yEAA+C;AAC/C,mEAAyC;AACzC,2EAAiD;AAGjD,SAAS;AACT,wBAAwB;AACxB,mGAAyE;AACzE,sGAA4E;AAC5E,uFAA6D;AAC7D,sFAA4D;AAC5D,6FAAmE;AAEnE,qBAAqB;AACrB,oFAA0D;AAE1D,oBAAoB;AACpB,wFAA8D;AAC9D,+EAAqD;AACrD,uFAA6D;AAC7D,wFAA8D;AAC9D,iFAAuD;AAEvD,gCAAgC;AAChC,qGAA2E;AAC3E,yGAA+E"}

package/nodemon.json

@@ -4,7 +4,9 @@
   "delay": "3000",
   "ext": ".ts,json",
   "watch": [
-    "./src/*"
+    "./src/*",
+    "package.json",
+    "tsconfig.json"
   ],
   "ignore": [
     "./node_modules",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@futdevpro/fsm-dynamo",
-  "version": "01.09.28",
+  "version": "01.09.30",
   "description": "Full Stack Model Collection for Dynamic (NodeJS-Typescript) Framework called Dynamo, by Future Development Ltd.",
   "scripts": {
     "prep": "npm i pnpm -g && npm i rimraf nodemon -g",

package/src/_collections/constants/global-settings.const.ts

@@ -0,0 +1,14 @@
+
+
+import { 
+  DyFM_Global_Settings 
+} from '../../_models/interfaces/environment/global-settings.interface';
+
+
+
+export const DyFM_global_settings: DyFM_Global_Settings = {
+  baseUrl: '/api',
+  
+  log_settings: {},
+};
+

package/src/_collections/utils/log.util.ts

@@ -4,6 +4,11 @@ import { DyFM_LogStyle } from '../../_enums/log-style.enum';
 /* export class D_Log implements DyFM_Log {}; */
 export type DyFM_L = DyFM_Log;
 
+/**
+ * DyFM_Log is a class that provides a set of methods to log messages to the console.
+ * This class have methods to log messages with different styles and colors, 
+ * such as success, error, warn, info and highlighted for each of them.
+ */
 export class DyFM_Log {
 
   static setStyle(styles: DyFM_LogStyle[]): void {
@@ -12,6 +17,7 @@ export class DyFM_Log {
     styles.forEach((style: DyFM_LogStyle): void => {
       styleSets += style;
     });
+    
     console.log(styleSets);
   }
   static resetStyle(): void {
@@ -24,6 +30,7 @@ export class DyFM_Log {
     styles.forEach((style: DyFM_LogStyle): void => {
       result += style;
     });
+
     result += input;
 
     if (!dontReset) {
@@ -36,70 +43,72 @@ export class DyFM_Log {
   static success(message: string, ...optionalParams: any[]): void {
     if (0 < optionalParams.length) {
       console.log(
-        `${DyFM_LogStyle.green}${DyFM_LogStyle.bright}${message}`, 
+        `${DyFM_LogStyle.green}${message}`, 
+        /* `${DyFM_LogStyle.green}${DyFM_LogStyle.bright}${message}`,  */
         ...optionalParams, DyFM_LogStyle.reset
       );
     } else {
       console.log(
-        `${DyFM_LogStyle.green}${DyFM_LogStyle.bright}${message}${DyFM_LogStyle.reset}`
+        `${DyFM_LogStyle.green}${message}${DyFM_LogStyle.reset}`
+        /* `${DyFM_LogStyle.green}${DyFM_LogStyle.bright}${message}${DyFM_LogStyle.reset}` */
       );
     }
   }
   /** 
    * @deprecated use DyFM_Log.success instead
    */
-  static logSuccess(message: string, ...optionalParams: any[]): void {
-    this.success(message, ...optionalParams);
-  } 
+  static readonly logSuccess = this.success;
 
   static error(message: string, ...optionalParams: any[]): void {
     if (0 < optionalParams.length) {
       console.error(
-        `${DyFM_LogStyle.red}${DyFM_LogStyle.bright}${message}`,
+        `${DyFM_LogStyle.red}${message}`,
+        /* `${DyFM_LogStyle.red}${DyFM_LogStyle.bright}${message}`, */
         ...optionalParams, DyFM_LogStyle.reset
       );
     } else {
       console.error(
-        `${DyFM_LogStyle.red}${DyFM_LogStyle.bright}${message}${DyFM_LogStyle.reset}`
+        `${DyFM_LogStyle.red}${message}${DyFM_LogStyle.reset}`
+        /* `${DyFM_LogStyle.red}${DyFM_LogStyle.bright}${message}${DyFM_LogStyle.reset}` */
       );
     }
   }
   /** 
    * @deprecated use DyFM_Log.error instead
    */
-  static logError(message: string, ...optionalParams: any[]): void {
-    this.error(message, ...optionalParams);
-  }
+  static readonly logError = this.error;
 
   static warn(message: string, ...optionalParams: any[]): void {
     if (0 < optionalParams.length) {
       console.warn(
-        `${DyFM_LogStyle.yellow}${DyFM_LogStyle.bright}${message}`, 
+        `${DyFM_LogStyle.yellow}${message}`, 
+        /* `${DyFM_LogStyle.yellow}${DyFM_LogStyle.bright}${message}`,  */
         ...optionalParams, DyFM_LogStyle.reset
       );
     } else {
       console.warn(
-        `${DyFM_LogStyle.yellow}${DyFM_LogStyle.bright}${message}${DyFM_LogStyle.reset}`
+        `${DyFM_LogStyle.yellow}${message}${DyFM_LogStyle.reset}`
+        /* `${DyFM_LogStyle.yellow}${DyFM_LogStyle.bright}${message}${DyFM_LogStyle.reset}` */
       );
     }
   }
   /** 
    * @deprecated use DyFM_Log.warn instead
    */
-  static warning(message: string, ...optionalParams: any[]): void {
-    this.warn(message, ...optionalParams);
-  }
+  static readonly warning = this.warn;
   /** 
    * @deprecated use DyFM_Log.warn instead
    */
-  static logWarning(message: string, ...optionalParams: any[]): void {
-    this.warn(message, ...optionalParams);
-  }
+  static readonly logWarning = this.warn;
 
+  // ez azért nem egy sima "static readonly info = console.info;", 
+  // mert azon nincs rajta az első input típusa, ami csak string lehet
   static info(message: string, ...optionalParams: any[]): void {
     console.info(message, ...optionalParams);
   }
 
+  // ez azért nem egy sima "static readonly log = console.log;", 
+  // mert azon nincs rajta az első input típusa, ami csak string lehet
   static log(message: string, ...optionalParams: any[]): void {
     console.log(message, ...optionalParams);
   }

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

@@ -0,0 +1,81 @@
+
+export interface DyFM_GlobalLog_Settings {
+  /**
+   * this setting will set which logs will be shown
+   */
+  highDetailedLogs?: boolean;
+
+  deep?: boolean;
+
+  /**
+   * this setting will enable debug logs for setting up the application
+   */
+  setup?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  request?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  requestsParams?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  requestsContent?: boolean;
+
+  /**
+   * this is an application wide default setting for route debug logs
+   */
+  responseContent?: boolean;
+  
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_allEvents?: boolean;
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_mainEvents?: boolean;
+
+  /**
+   * this is an application wide default setting for socket debug logs
+   */
+  socket_eventContent?: boolean;
+
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_events?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_requestContents?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_requestSettings?: boolean;
+
+  /**
+   * this is an application wide default setting for api debug logs
+   */
+  api_responseContents?: boolean;
+
+
+  /**
+   * this is an application wide default setting for detailed error logs
+   */
+  detailedErrors?: boolean;
+
+  server_debug?: boolean;
+
+  functions?: boolean;
+}

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

@@ -0,0 +1,22 @@
+
+import { DyFM_GlobalLog_Settings } from './global-log-settings.interface';
+
+/**
+ * 
+ * @param logRequestsContent only will log if the specific logRequest is also true
+ * 
+ * @param logEventContent only will log if the specific socket event is also set to log
+ * 
+ */
+export interface DyFM_Global_Settings {
+  /**
+   * this will be used as the main baseUrl for the application,
+   * this is not required, but we suggest to use at least a '/api' as base route
+   */
+  baseUrl: string;
+
+  /**
+   * this setting will set which logs will be shown
+   */
+  log_settings: DyFM_GlobalLog_Settings;
+}

package/src/_modules/socket/_enums/sck-event-key.enum.ts

@@ -0,0 +1,18 @@
+
+export enum DyFM_SocketEvent_Key {
+  /** incoming connection */
+  connection = 'connection',
+  /** outgoing connection */
+  connect = 'connect',
+
+  subscribe = 'subscribe',
+  subscriptionSuccessful = 'subscriptionSuccessful',
+  unsubscribe = 'unsubscribe',
+  unsubscribeSuccessful = 'unsubscribeSuccessful',
+  disconnect = 'disconnection',
+  
+  ping = 'ping',
+  event = 'event',
+  error = 'error',
+}
+

package/src/_modules/socket/_models/sck-client-params.control-model.ts

@@ -3,9 +3,10 @@ import * as SocketIOClient from 'socket.io-client';
 import { second } from '../../../_collections/constants/times.const';
 
 export class DyFM_SocketClient_Params {
+  name?: string;
   service?: string;
-  address: string;
-  port: number;
+  address?: string;
+  port?: number;
   reconnectDelay?: number = second * 10;
   reconnect?: boolean = true;
   socketOptions?: Partial<SocketIOClient.ManagerOptions & SocketIOClient.SocketOptions>;
@@ -21,4 +22,6 @@ export class DyFM_SocketClient_Params {
       this.reconnect = false;
     }
   }
-}
+}
+
+