@ti-engine/core 1.3.12 → 1.3.13

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 This document will contain the list of changes made to the framework. The format is based on the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification.
 
+## Version 1.3.13
+
+* feat(exceptions): add new exception code `E_GEN_UNALLOWED_OVERRIDE` (1009) for detecting attempts to override protected or private methods/properties
+* feat(auditing): enhance console data formatting with recursive, depth-limited formatting (max depth: 5), circular reference detection and handling, improved readability for nested objects and multi-line strings, and proper indentation and prefixing for structured output
+* fix(start instance): modified `start-instance.js` to initialize serviceConfig as undefined instead of an empty object when `TI_INSTANCE_CONFIG` environment variable is not provided
+* build(npm): update npm dependencies to their latest versions
+
 ## Version 1.3.12
 
 * feat(exceptions): add new exception code `E_COM_SERVICE_EXEC_FAILED`

package/bin/localization/labels.json

@@ -31,6 +31,9 @@
       "1008": {
         "en": "The invoked framework component is not initialized."
       },
+      "1009": {
+        "en": "Attempt to override a protected or private method or property detected."
+      },
       "2000": {
         "en": "Invalid authorization token provided."
       },

package/bin/start-instance.js

@@ -124,7 +124,7 @@ try {
     const serviceConstructor = require( path.join( process.cwd(), process.env.TI_INSTANCE_CLASS ) );
     const serviceConfigPath = process.env.TI_INSTANCE_CONFIG;
     /** @type ServiceConfiguration */
-    let serviceConfig = {};
+    let serviceConfig;
     if ( serviceConfigPath ) {
         serviceConfig = require( path.join( process.cwd(), process.env.TI_INSTANCE_CONFIG ) );
     }

package/components/auditing.js

@@ -6,6 +6,7 @@
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
 */
 
+const { EOL } = require( "node:os" )
 const _ = require( "lodash" );
 const tools = require( "#tools" );
 const logger = require( "#logger" );
@@ -132,7 +133,7 @@ class Auditing {
         } else {
             console.log( Auditing.#formatConsoleMessage( logEntry ) );
             if ( !_.isEmpty( logEntry.data ) ) {
-                console.log( `   » ${ Auditing.#formatConsoleData( logEntry ) }` );
+                console.log( Auditing.#formatConsoleData( logEntry.data, "   " ) );
             }
         }
     }
@@ -154,12 +155,53 @@ class Auditing {
      * Used to format a log entry data payload for the Node console.
      *
      * @method
-     * @param {TiLogEntry} logEntry
+     * @param {*} data
+     * @param {string} [prefix=""]
+     * @param {number} [currentDepth=0]
+     * @param {number} [maxDepth=5]
+     * @param {Set} [visited=new Set()]
      * @returns {string}
      * @private
      */
-    static #formatConsoleData( logEntry ) {
-        return tools.stringifyJSON( logEntry.data );
+    static #formatConsoleData( data, prefix = "", currentDepth = 0, maxDepth = 5, visited = new Set() ) {
+        if ( data === null || data === undefined || !_.isObjectLike( data ) ) {
+            // Handle null, undefined, and primitive values:
+            return prefix + "» " + String( data );
+        } else if ( currentDepth >= maxDepth ) {
+            // Check max depth:
+            return prefix + "! [max data depth reached]";
+        } else if ( visited.has( data ) ) {
+            // Check for circular references:
+            return prefix + "! [circular reference detected]";
+        } else {
+            let formattedData = "";
+            visited.add( data );
+
+            _.forOwn( data, ( value, key ) => {
+                let stackLines = ( _.isString( value ) ) ? value.split( "\n" ) : [ value ];
+                if ( stackLines.length > 1 ) {
+                    _.forEach( stackLines, ( line, idx ) => {
+                        if ( idx === 0 ) {
+                            formattedData += prefix + `» ${ key }: ${ _.trim( line ) }` + EOL;
+                        } else {
+                            formattedData += prefix + `- ${ _.trim( line ) }` + EOL;
+                        }
+                    } );
+                } else {
+                    if ( _.isObjectLike( value ) ) {
+                        formattedData += prefix + `» ${ key }:` + EOL + Auditing.#formatConsoleData( value, "   " + prefix, currentDepth + 1, maxDepth, visited ) + EOL;
+                    } else {
+                        formattedData += prefix + `» ${ key }: ${ value }` + EOL;
+                    }
+                }
+            } );
+
+            if ( formattedData.endsWith( EOL ) ) {
+                formattedData = formattedData.slice( 0, -EOL.length );
+            }
+
+            return formattedData;
+        }
     }
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ti-engine/core",
-  "version": "1.3.12",
+  "version": "1.3.13",
   "description": "The ti-engine is an open source, free to use—both for personal and commercial projects—framework for the creation of microservice-based solutions using node.js.",
   "keywords": [
     "microservices",
@@ -57,7 +57,7 @@
     "#tools": "./utils/tools.js"
   },
   "dependencies": {
-    "@dotenvx/dotenvx": "^1.51.0",
+    "@dotenvx/dotenvx": "^1.51.1",
     "blake2": "^5.0.0",
     "ioredis": "^5.8.2",
     "lodash": "^4.17.21",

package/utils/exceptions.js

@@ -28,6 +28,7 @@ const exceptionCodeEnum = tools.enum( {
     E_GEN_FEATURE_UNSUPPORTED: [ 1006, "feature unsupported", "The requested feature is not supported by current configuration or version." ],
     E_GEN_INVALID_ARGUMENT_TYPE: [ 1007, "invalid argument type", "The provided argument is not of the expected type." ],
     E_GEN_NOT_INITIALIZED: [ 1008, "not initialized", "The invoked framework component is not initialized." ],
+    E_GEN_UNALLOWED_OVERRIDE: [ 1009, "unallowed override", "Attempt to override a protected or private method or property detected." ],
     /** Security & Administration exceptions - codes under 2xxx */
     E_SEC_INVALID_AUTH_TOKEN: [ 2000, "invalid auth token", "Invalid authorization token provided." ],
     E_SEC_INVALID_EXPIRED_SESSION: [ 2001, "invalid or expired session", "Invalid or expired session encountered." ],