@ti-engine/core 1.3.12 → 1.4.1

package/CHANGELOG.md

@@ -1,6 +1,41 @@
 # ti-engine changelog
 
-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.
+This document contains 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.4.1
+
+* build(deps): update `@dotenvx/dotenvx` from ^1.54.1 to ^1.55.1
+
+## Version 1.4.0
+
+* feat(redis integration): implement support for `JSON.MERGE` and `JSON.MGET` commands
+* feat(cache): add `editJSON` method
+* feat(cache): implement consistent RedisJSON path handling and uniform error wrapping
+* feat(exceptions): add new standardized exception code `E_GEN_NOT_IMPLEMENTED` to use for cases where a feature is not yet implemented
+* feat(exceptions): add new optional, flexible parameter `httpCode` to the `raise` method
+* refactor(exceptions)!: rename the exception class from `Exception` to `TiException` in all referred places
+* refactor(definitions): move all object definitions to a new `definitions.types.js` file
+* refactor(gcloud integration)!: remove file `gcloud-integration.js` and all related functionality (as it was obsolete and a security vulnerability)
+* fix(cache): fix a bug where RedisJSON methods would return `E_GEN_FEATURE_UNSUPPORTED` error while discarding the details of that error
+* fix(config): fix the ENV `TI_LOCALIZATION_LABELS_PATH` to properly support multiple paths to label files
+* build(deps): update `@dotenvx/dotenvx` from ^1.52.0 to ^1.54.1
+* build(deps): update `ioredis` from ^5.9.2 to ^5.10.0
+* build(deps)!: remove `@google-cloud/error-reporting`
+
+## Version 1.3.14
+
+* build(deps): update `@dotenvx/dotenvx` from ^1.51.1 to ^1.52.0
+* build(deps): update `blake2` from ^5.0.0 to ^5.0.1
+* build(deps): update `ioredis` from ^5.8.2 to ^5.9.2
+* build(deps): update `lodash` from ^4.17.21 to ^4.17.23
+* build(engines): update Node.js requirement from >=18.0.0 to >=20.0.0
+
+## 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
 

package/bin/localization/labels.json

@@ -31,6 +31,12 @@
       "1008": {
         "en": "The invoked framework component is not initialized."
       },
+      "1009": {
+        "en": "Attempt to override a protected or private method or property detected."
+      },
+      "1010": {
+        "en": "The requested functionality is not yet implemented."
+      },
       "2000": {
         "en": "Invalid authorization token provided."
       },
@@ -105,6 +111,12 @@
       },
       "4009": {
         "en": "The request content encoding is not recognized or not supported."
+      },
+      "5004": {
+        "en": "The requested resource cannot be found. See details for more information."
+      },
+      "5005": {
+        "en": "The application service encountered an error. See details for more information."
       }
     }
   }

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

@@ -1,29 +1,18 @@
 /*
  * 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.
- * Copyright © 2021-2025 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * 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" );
 const config = require( "#config" );
-const gcloud = require( "#gcloud-integration" );
 const ServiceInstance = require( "#service-instance" );
 
-/**
- * @typedef {Object} TiLogEntry
- * @property {string} _id Unique identifier that can be used to identify the document in a NoSQL database.
- * @property {TiLogSeverity} severity The log severity level.
- * @property {string} thread The categorization of the log message.
- * @property {string} reporter
- * @property {string} message The actual log message.
- * @property {number} timestamp The timestamp of the log entry in UTC time.
- * @property {Object} data Additional JSON data to go with the message.
- */
-
 /**
  * Used to create and/or return an Auditing System singleton instance.
  *
@@ -71,11 +60,6 @@ class Auditing {
                 if ( config.getSetting( config.setting.AUDITING_LOG_CONSOLE_ENABLED ) === true && console ) {
                     Auditing.#logToConsole( logEntry );
                 }
-
-                // If this is an actual error, then send it to GCloud error reporting system as well:
-                if ( logEntry.severity >= logger.logSeverity.WARNING && data instanceof Error && gcloud.isEnabled() ) {
-                    gcloud.reportError( data );
-                }
             }
         } catch {
             // do nothing here for now...
@@ -132,7 +116,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 +138,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/components/connection-observer.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2025 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
@@ -19,7 +19,7 @@ class ConnectionObserver {
 
     /**
      * @constructor
-     * @throws {Exception.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
+     * @throws {TiException.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
      */
     constructor() {
         // make sure this abstract class cannot be instantiated:

package/components/definitions.types.js

@@ -0,0 +1,248 @@
+/*
+ * 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.
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
+ * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
+*/
+
+// Configuration Definitions:
+
+/**
+ * @typedef {string} EnvironmentVariable
+ */
+
+/**
+ * @typedef {NodeJS.Process} Environment
+ * @property {ProcessEnv} env
+ * @property {EnvironmentVariable} env.TI_GCLOUD_API_KEY
+ * @property {EnvironmentVariable} env.TI_GCLOUD_ENABLED
+ * @property {EnvironmentVariable} env.TI_GCLOUD_PROJECT_ID
+ * @property {EnvironmentVariable} env.TI_INSTANCE_CLASS
+ * @property {EnvironmentVariable} env.TI_INSTANCE_CONFIG
+ * @property {EnvironmentVariable} env.TI_INSTANCE_ID
+ * @property {EnvironmentVariable} env.TI_INSTANCE_NAME
+ * @property {EnvironmentVariable} env.TI_AUDITING_LOG_CONSOLE_ENABLED
+ * @property {EnvironmentVariable} env.TI_AUDITING_LOG_DETAILS
+ * @property {EnvironmentVariable} env.TI_AUDITING_LOG_MIN_LEVEL
+ * @property {EnvironmentVariable} env.TI_AUDITING_LOG_USES_JSON
+ * @property {EnvironmentVariable} env.TI_LOCALIZATION_LABELS_PATH
+ * @property {EnvironmentVariable} env.TI_LOCALIZATION_LANGUAGE
+ * @property {EnvironmentVariable} env.TI_MEMORY_CACHE_AUTH_KEY
+ * @property {EnvironmentVariable} env.TI_MEMORY_CACHE_REDIS_DB
+ * @property {EnvironmentVariable} env.TI_MEMORY_CACHE_REDIS_HOST
+ * @property {EnvironmentVariable} env.TI_MEMORY_CACHE_REDIS_PORT
+ * @property {EnvironmentVariable} env.TI_MEMORY_CACHE_RETRY_MAX_ATTEMPTS
+ * @property {EnvironmentVariable} env.TI_MEMORY_CACHE_RETRY_MAX_INTERVAL
+ * @property {EnvironmentVariable} env.TI_MEMORY_CACHE_USER
+ * @property {EnvironmentVariable} env.TI_MESSAGE_EXCHANGE_SECURITY_HASH_ENABLED
+ * @property {EnvironmentVariable} env.TI_MESSAGE_EXCHANGE_SECURITY_HASH_KEY
+ * @property {EnvironmentVariable} env.TI_MESSAGE_EXCHANGE_TRACE_LOG_ENABLED
+ */
+
+/**
+ * @typedef {Object} SettingsMain
+ * @property {SettingsAuditing} auditing
+ * @property {SettingsGcloudIntegration} gcloudIntegration
+ * @property {SettingsLocalization} localization
+ * @property {SettingsMemoryCache} memoryCache
+ * @property {SettingsMessageExchange} messageExchange
+ * @property {SettingsServiceConfig} serviceConfig
+ * @property {string} operationMode
+ */
+
+/**
+ * @typedef {Object} SettingsAuditing
+ * @property {boolean} logConsoleEnabled
+ * @property {boolean} logDetails
+ * @property {TiLogSeverity} logMinLevel
+ * @property {boolean} logUsesJSON
+ */
+
+/**
+ * @typedef {Object} SettingsGcloudIntegration
+ * @property {string} apiKey
+ * @property {string} projectID
+ */
+
+/**
+ * @typedef {Object} SettingsLocalization
+ * @property {Array<string>} labelsPath
+ * @property {TiLocalizationLanguage} language
+ */
+
+/**
+ * @typedef {Object} SettingsMemoryCache
+ * @property {string} authKey
+ * @property {number} redisDB
+ * @property {string} redisHost
+ * @property {number} redisPort
+ * @property {number} retryMaxAttempts
+ * @property {number} retryMaxInterval
+ * @property {string} user
+ */
+
+/**
+ * @typedef {Object} SettingsMessageExchange
+ * @property {string} messageQueuePrefix
+ * @property {string} messageStore
+ * @property {boolean} securityHashEnabled
+ * @property {string} securityHashKey
+ * @property {number} traceExpirationTime
+ * @property {boolean} traceLogEnabled
+ * @property {string} traceRepository
+ */
+
+/**
+ * @typedef {Object} SettingsServiceConfig
+ * @property {number} executionTimeout
+ * @property {string} healthCheckAddress
+ * @property {CronString} healthCheckInterval
+ * @property {number} healthCheckTimeout
+ * @property {string} serviceRegistryAddress
+ */
+
+// Utility Definitions:
+
+/**
+ * @typedef {string} CronString
+ */
+
+/**
+ * @typedef {Object} TiEnumValue
+ * @property {number|string} value
+ * @property {string} name
+ * @property {string} [description]
+ */
+
+/**
+ * @typedef {Object} TiEnum
+ * @property {Object.<number|string,TiEnumValue>} properties
+ * @property {function( (number|string), [string] ): (string|undefined)} name
+ * @property {function( (number|string), [string] ): (string|undefined)} description
+ * @property {function( (number|string) ): boolean} contains
+ */
+
+/**
+ * @typedef {Object} TiLogEntry
+ * @property {string} _id Unique identifier that can be used to identify the document in a NoSQL database.
+ * @property {TiLogSeverity} severity The log severity level.
+ * @property {string} thread The categorization of the log message.
+ * @property {string} reporter
+ * @property {string} message The actual log message.
+ * @property {number} timestamp The timestamp of the log entry in UTC time.
+ * @property {Object} data Additional JSON data to go with the message.
+ */
+
+/**
+ * @typedef {Object} TiTraceEntry
+ * @property {string} chainID
+ * @property {string} dispatchEvent
+ * @property {string} fromAddress
+ * @property {string} messageID
+ * @property {Object} messageSnapshot
+ * @property {string} messageState
+ * @property {string} messageType
+ * @property {string} toAddress
+ * @property {string} traceID
+ * @property {number} traceTimestamp
+ */
+
+/**
+ * The key of this object is the language code, and the value is the textual representation of the label.
+ *
+ * @typedef {Object<TiLocalizationLanguage, string>} TiLocalizedLabel
+ */
+
+/**
+ * A nested labels tree where intermediate nodes are objects and leaf nodes are language-to-text maps.
+ *
+ * @typedef {Object<string, TiLocalizedLabel | TiLabelsTree>} TiLabelsTree
+ */
+
+// Service Bus Definitions:
+
+/**
+ * @typedef {Object} ServiceAddress
+ * @property {string} serviceAlias A valid service alias.
+ * @property {string} serviceDomainName A valid service domain name.
+ * @property {number|undefined} serviceVersion Optional service version. If not provided, the latest version will be assumed as a target.
+ */
+
+/**
+ * @typedef {Object} ServiceExecContext
+ * @property {string|undefined} authToken A valid authentication token that initialized the service call (if applicable).
+ * @property {ServiceCallPredecessor|undefined} previousServiceCall The previous service call in the execution chain (if such exists).
+ */
+
+/**
+ * @typedef {Message} ServiceCallPredecessor
+ * @property {string} predecessor The {@link Message.messageID} of the predecessor in the service call tree.
+ * @property {ServiceAddress} serviceAddress The address of the service that has to process the service call.
+ * @property {Object|undefined} serviceParams The named params to be provided to the API service.
+ */
+
+/**
+ * @typedef {ServiceCallPredecessor} ServiceCall
+ * @property {string} authToken A valid authentication token that initialized the service call.
+ * @property {number} createdOn A unix timestamp taken at creation time of the service call.
+ * @property {number} executionTime The total execution time of this service call in milliseconds.
+ * @property {Object|undefined} exception If there was exception during the service call processing, it will be set here. Otherwise, it will be 'undefined'.
+ * @property {number|undefined} finishedOn A unix timestamp taken at finish time of the service call.
+ * @property {boolean} isCompleted Flag to indicate if this service call has been completed.
+ * @property {boolean|undefined} isSuccessful A flag indicating if this service call can be considered successful or not. Will be 'undefined' until the service call is processed.
+ * @property {string[]} successors The service call IDs of the successors in the service call tree.
+ */
+
+/**
+ * @typedef {Object} ServiceCallResult
+ * @property {TiException|undefined} exception If there was exception during the service call processing, it will be set here. Otherwise, it will be 'undefined'.
+ * @property {boolean} isSuccessful A flag indicating if this service call can be considered successful or not.
+ * @property {Object|string|undefined} payload The payload containing the results from the service call processing. If a string, it is ID of the payload in the memory cache instead.
+ */
+
+/**
+ * @typedef {Object} ServiceDefinition
+ * @property {string} serviceAlias Service alias.
+ * @property {string} serviceFile The JS file containing the service itself. This has to be exposed via package.json import structure!
+ * @property {number} [serviceVersion] Service version.
+ */
+
+/**
+ * @typedef {Object.<string, ServiceInterfaceVersion>} ServiceInterface
+ */
+
+/**
+ * @typedef {Object.<number, ServiceHandlerMethod>} ServiceInterfaceVersion
+ */
+
+/**
+ * @typedef {Object} ServiceConfiguration
+ * @property {ServiceDefinition[]} [services] A list of service definitions to be registered with the {@link ServiceProvider}.
+ */
+
+// Message Exchange Definitions:
+
+/**
+ * @typedef {Object} MessageDestination
+ * @property {string|undefined} [instanceID] The instance ID of the message exchange by which the message was received (available after acceptance).
+ * @property {string} route The route to destination for the message. The exact structure will depend on the implementation of the message exchange.
+ */
+
+/**
+ * @typedef {Object} MessageSource
+ * @property {string} instanceID The instance ID of the message exchange from which the service call originated.
+ * @property {string} route The route from source of the message. The exact structure will depend on the implementation of the message exchange.
+ */
+
+/**
+ * @typedef {Object} Message
+ * @property {string} chainID Unique identifier of the message chain if the message is part of one.
+ * @property {number} chainLevel The node level of this message in the message chain tree.
+ * @property {MessageDestination} destination The destination of the message.
+ * @property {string} [hash] Security hash for the message if the mechanism is enabled.
+ * @property {string} messageID Unique message identifier.
+ * @property {Object|string|undefined} payload The message contents to be processed in destination. If a string, it is ID of the payload in the memory cache instead.
+ * Note that if this is not an Object or a string, there is no guarantee that it will be delivered in the same/proper format!
+ * @property {MessageSource} source The source of the message.
+ */

package/components/exchange/message-dispatcher.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2025 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

package/components/exchange/message-exchange.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
@@ -11,34 +11,10 @@ const _ = require( "lodash" );
 const exceptions = require( "#exceptions" );
 const messageTracer = require( "#message-tracer" );
 
-/**
- * @typedef {Object} MessageDestination
- * @property {string|undefined} [instanceID] The instance ID of the message exchange by which the message was received (available after acceptance).
- * @property {string} route The route to destination for the message. Exact structure will depend on the implementation of the message exchange.
- */
-
-/**
- * @typedef {Object} MessageSource
- * @property {string} instanceID The instance ID of the message exchange from which the service call originated.
- * @property {string} route The route from source of the message. Exact structure will depend on the implementation of the message exchange.
- */
-
-/**
- * @typedef {Object} Message
- * @property {string} chainID Unique identifier of the message chain if the message is part of one.
- * @property {number} chainLevel The node level of this message in the message chain tree.
- * @property {MessageDestination} destination The destination of the message.
- * @property {string} [hash] Security hash for the message if the mechanism is enabled.
- * @property {string} messageID Unique message identifier.
- * @property {Object|string|undefined} payload The message contents to be processed in destination. If string it is ID of the payload in the memory cache instead.
- * Note that if this is not an Object or a string, there is no guarantee that it will be delivered in the same/proper format!
- * @property {MessageSource} source The source of the message.
- */
-
 /**
  * An abstract class that defines a message exchange behavior.
  * <br/>
- * NOTE: While this sets the basis frame for the message based communication between microservices, it has to be inherited and
+ * NOTE: While this sets the basis frame for the message-based communication between microservices, it has to be inherited and
  * extended with additional logic that is NOT implemented here. For a working example please see {@link DefaultMessageExchange} class.
  * <br/>
  * NOTE: This class and its children are designed to be used internally by the {@link MessageDispatcher} and its related classes.
@@ -72,7 +48,7 @@ class MessageExchange extends MessageObserver {
      * @constructor
      * @param {string} instanceID The unique identifier of the microservice instance using the message exchange.
      * @param {string} serviceDomainName The domain name of the microservice using the message exchange.
-     * @throws {Exception.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
+     * @throws {TiException.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
      */
     constructor( instanceID, serviceDomainName ) {
         super( 9 );
@@ -408,7 +384,7 @@ class MessageExchange extends MessageObserver {
     }
 
     /**
-     * Used only for the purposes of the message tracer.
+     * Used only for the message tracer.
      *
      * @method
      * @param {string} identifier The identifier of the observed connection.
@@ -443,7 +419,7 @@ class MessageExchange extends MessageObserver {
 
     /**
      * Used to send a message request. Override of this method assumes that the message itself contains enough
-     * information to determine the send destination.
+     * information to determine the sending destination.
      *
      * @method
      * @param {Message} message The message request to send.
@@ -457,7 +433,7 @@ class MessageExchange extends MessageObserver {
 
     /**
      * Used to send a message response. Override of this method assumes that the message itself contains enough
-     * information to determine the send destination.
+     * information to determine the sending destination.
      *
      * @method
      * @param {Message} message The message response to send.

package/components/exchange/message-handler.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2025 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
@@ -33,7 +33,7 @@ class MessageHandler extends ConnectionObserver {
     /**
      * @constructor
      * @param {string} identifier An identifier for this message handler. Should be unique in the context of the message exchange.
-     * @throws {Exception.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
+     * @throws {TiException.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
      */
     constructor( identifier ) {
         super();

package/components/exchange/message-memory-cache.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2025 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.

package/components/exchange/message-observer.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2025 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
@@ -27,7 +27,7 @@ class MessageObserver extends ConnectionObserver {
     /**
      * @constructor
      * @param {number} [priority=0] The priority of this observer. Higher values indicate higher priority.
-     * @throws {Exception.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
+     * @throws {TiException.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
      */
     constructor( priority = 0 ) {
         super();

package/components/exchange/message-receiver.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2025 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
@@ -28,7 +28,7 @@ class MessageReceiver extends MessageHandler {
      * @constructor
      * @param {string} identifier An identifier for this message handler. Should be unique in the context of the message exchange.
      * @param {string} receiveQueue The queue from which the messages will be received.
-     * @throws {Exception.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
+     * @throws {TiException.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
      */
     constructor( identifier, receiveQueue ) {
         super( identifier );

package/components/exchange/message-sender.js

@@ -1,6 +1,6 @@
 /*
  * 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.
- * Copyright © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2026 Boris Kostadinov <kostadinov.boris@gmail.com>
  * This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
  * This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  * You should have received a copy of the GNU General Public License along with this program. If not, see <https://www.gnu.org/licenses/>.
@@ -23,7 +23,7 @@ class MessageSender extends MessageHandler {
     /**
      * @constructor
      * @param {string} identifier An identifier for this message handler. Should be unique in the context of the message exchange.
-     * @throws {Exception.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
+     * @throws {TiException.E_GEN_ABSTRACT_CLASS_INIT} If this class is instantiated directly.
      */
     constructor( identifier ) {
         super( identifier );