@ti-engine/core 1.2.4 → 1.3.3

package/CHANGELOG.md

@@ -2,6 +2,50 @@
 
 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.3
+* feat(exceptions): add new parameter `includeData` to `Exception.asJSON` method which allows the exclusion of the data parameter from the returned JSON
+* feat(exceptions): remove several excessive exception codes that were unlikely to be used
+* fix(localization): add several missing exception labels
+
+## Version 1.3.2
+* feat(exceptions): add a set of new exception codes for the needs of any wrapping `web-server` standard communication
+* feat(exception)!: change the default prefix path for exception labels to `system.exceptions.`
+* feat(localization): add an Enum list of all language codes based on ISO 639-1 standard
+* feat(localization): add an option to the `getLabel` method to provide the language code to use for localization. If not provided, the system will use the language code from the `localization.language` setting
+* feat(localization)!: change the default structure of system labels from `labels.general.[...]` to `system.[...]`
+* refactor(localization): add typedefs and JSDoc structure for the objects used in localization
+* refactor(exceptions): refactor and fix various JSDoc descriptions
+* refactor(auditing): change the type name of `LogEntry` to `TiLogEntry` and fix some JSDoc descriptions
+* fix(exceptions): fix an issue which caused the exception to disregard the `description` value sent in the constructor and use the default one instead
+* fix(config): fix an issue with the `TI_LOCALIZATION_LABELS_PATH` variable not respecting that the underlying setting expected an array. Now it is expected to be a single path and it will be wrapped into an array automatically
+* fix(auditing): fix a potential problem with setting the log entry reporter from an ENV variable; instead, the system will now use the `ServiceInstance.instanceID` property
+
+## Version 1.3.1
+* feat(service caller): refactor the entire service call execution flow for clarity and better performance
+* feat(service caller): create a new private class `ServiceCallProcessor` to handle individual service calls in a contained scope
+* feat(message observer): add new property `priority` to the message observer class. It is used to determine the order in which the observers are notified about the messages
+* feat(message observer)!: change method `onMessage` to now return the message it received. This allows for the message to be modified before it is passed to the next observer based on `priority`
+* feat(message handler)!: change method `onMessage` to `notifyMessageObservers` for clarity. It now implements the `MessageObserver` functionality for prioritization and message modification
+* fix(service caller): fix an issue which did not allow for a service call to be marked as completed thus being entered into the trace log as still pending
+* fix(redis integration): remove hardcoded `#retryMaxAttempts` value in `#setupClient` method
+* fix(redis integration): fix an issue which was setting the client status to `DISCONNECTED` during a normal shut down procedure
+
+## Version 1.3.0
+* feat(redis integration)!: change `reconnectOnError` behavior to also resubmit the failed command in case the error was of type `READONLY`
+* feat(redis integration): improve the reliability and usage of the event notification mechanism for connection observers
+* feat(redis integration): implement listener to the `end` event on Redis connection to capture when connection can no longer be recovered
+* feat(redis integration): notify connection observers `onConnectionLost` event
+* feat(redis integration): add redis client platform-specific status. It is used internally by the platform and can also be accessed via `redisClient.clientStatus` property
+* feat(connection observer): add new event handler `onConnectionLost` that will be invoked when the observed connection is irrevocably lost
+* feat(cache)!: implement `onConnectionLost` handler that will cause the service instance to immediately stop since it cannot work without the cache
+* fix(service caller): fix multiple promise reject condition when a service call timed out and the service handler still attempted to complete with subsequent error
+* fix(service instance): limit health check reporting to one attempt at a time to avoid unnecessary cache requests and log spam
+* fix(redis integration): fix a multiple promise resolve condition on Redis `reconnect` event
+* fix(redis integration): fix broken event propagation on `disrupted` events to some connection observers
+
+## Version 1.2.5
+* feat(cache): extend method `expireValue` to work with has set fields as well
+
 ## Version 1.2.4
 * feat(cache): expose the cache module as export in `package.json`
 * feat(cache): add method `hashDeleteField` to remove a hash-set field. This implements the `hdel` Redis command

package/README.md

@@ -397,7 +397,7 @@ GCLOUD_PROJECT_ID (Alpha)
 LOCALIZATION_LABELS_PATH
 : JSON path `localization.labelsPath`, type `Array<string>`, default `[]`
 : ENV variable `TI_LOCALIZATION_LABELS_PATH`
-: This setting holds a list of paths to custom `.json` files containing additional localization information. By default, the framework also provides such a file with english texts that can be customized further. All additional JSONs in these files have to follow the rules and structure of the `localization` module.
+: This setting holds a list of paths to custom `.json` files containing additional localization information. By default, the framework also provides such a file with english texts that can be customized further. All additional JSONs in these files have to follow the rules and structure of the `localization` module. The ENV variable currently supports providing only a single custom path.
 
 LOCALIZATION_LANGUAGE
 : JSON path `localization.language`, type `string`, default `en`
@@ -501,20 +501,18 @@ OPERATION_MODE
 
 The **ti-engine** framework provides a localization mechanism that allows you to translate labels into localized text. The framework comes with a default set of labels that can be found in the `localization` module. You can add your own custom labels to this set by providing one or more JSON files with the same structure as the default one (see below). The path to these files should be specified in the `LOCALIZATION_LABELS_PATH` setting. On startup, the framework will load all the JSON files and merge them into a single repository.
 
-The following is an example of a custom localization file (the names in brackets can be replaced with your own values):
+The following is an example of a custom localization file. The names in brackets can be replaced with your own values. The depth of the three is unlimited and can be used to create a hierarchy of labels.
 
 ```json
 {
-  "labels": {
-    "[category]": {
-      "[sub-category]": {
-        "[label]": {
-          "en": "[localized label text]"
-        }
+  "[category]": {
+    "[sub-category]": {
+      "[label]": {
+        "[language code]": "[localized label text]"
       }
     }
   }
 }
 ```
 
-The individual languages are specified with a two-letter code. The default language is `en` (English). If you want to use a different language, you can set the `LOCALIZATION_LANGUAGE` setting to the desired language code.
+The individual languages are specified with a two-letter code according to ISO 639-1. The default language is `en` (English). If you want to use a different language, you can set the `LOCALIZATION_LANGUAGE` setting to the desired language code.

package/bin/localization/labels.json

@@ -1,64 +1,98 @@
 {
-  "labels": {
-    "general": {
-      "exceptions": {
-        "0": {
-          "en": "Unidentified error encountered or unrecognized exception code provided."
-        },
-        "1000": {
-          "en": "Error thrown by internal JS source."
-        },
-        "1001": {
-          "en": "Attempt to construct an abstract class detected."
-        },
-        "1002": {
-          "en": "Attempt to call an abstract method detected."
-        },
-        "1003": {
-          "en": "Invalid or no service domain name provided at microservice startup."
-        },
-        "1004": {
-          "en": "The system cache required for proper engine operation is unavailable."
-        },
-        "1005": {
-          "en": "The provided service handler is not a proper function."
-        },
-        "1006": {
-          "en": "The requested feature is not supported by current configuration or version."
-        },
-        "2000": {
-          "en": "Invalid authorization token provided."
-        },
-        "2001": {
-          "en": "Invalid or expired session encountered."
-        },
-        "2002": {
-          "en": "Attempt for unauthorized access detected."
-        },
-        "2003": {
-          "en": "The system detected tampering with the message received via message exchange."
-        },
-        "3000": {
-          "en": "General error during cross-application communication."
-        },
-        "3001": {
-          "en": "The message sender instance is currently unavailable."
-        },
-        "3002": {
-          "en": "The execution of a service could not complete within the allowed timeout."
-        },
-        "3003": {
-          "en": "The specified service is not found in the service registry."
-        },
-        "3004": {
-          "en": "The specified service is not found in the service definition interface."
-        },
-        "3005": {
-          "en": "No handler found in the interface for the specified service or service version."
-        },
-        "3010": {
-          "en": "Connection retry attempts exceeded the configured limit."
-        }
+  "system": {
+    "exceptions": {
+      "0": {
+        "en": "Unidentified error encountered or unrecognized exception code provided."
+      },
+      "1000": {
+        "en": "Error thrown by internal JS source."
+      },
+      "1001": {
+        "en": "Attempt to construct an abstract class detected."
+      },
+      "1002": {
+        "en": "Attempt to call an abstract method detected."
+      },
+      "1003": {
+        "en": "Invalid or no service domain name provided at microservice startup."
+      },
+      "1004": {
+        "en": "The system cache required for proper engine operation is unavailable."
+      },
+      "1005": {
+        "en": "The provided service handler is not a proper function."
+      },
+      "1006": {
+        "en": "The requested feature is not supported by current configuration or version."
+      },
+      "2000": {
+        "en": "Invalid authorization token provided."
+      },
+      "2001": {
+        "en": "Invalid or expired session encountered."
+      },
+      "2002": {
+        "en": "Attempt for unauthorized access detected."
+      },
+      "2003": {
+        "en": "The system detected tampering with the message received via message exchange."
+      },
+      "3000": {
+        "en": "General error during cross-application communication."
+      },
+      "3001": {
+        "en": "The message sender instance is currently unavailable."
+      },
+      "3002": {
+        "en": "The execution of a service could not complete within the allowed timeout."
+      },
+      "3003": {
+        "en": "The specified service is not found in the service registry."
+      },
+      "3004": {
+        "en": "The specified service is not found in the service definition interface."
+      },
+      "3005": {
+        "en": "No handler found in the interface for the specified service or service version."
+      },
+      "3006": {
+        "en": "The message receiver instance is currently unavailable."
+      },
+      "3007": {
+        "en": "The message exchange is irrevocably broken and cannot be used any longer."
+      },
+      "3010": {
+        "en": "Connection retry attempts exceeded the configured limit."
+      },
+      "4000": {
+        "en": "The request method is not recognized or not supported."
+      },
+      "4001": {
+        "en": "The request URI is not recognized or not supported."
+      },
+      "4002": {
+        "en": "The request body is not recognized or not supported."
+      },
+      "4003": {
+        "en": "The request query is not recognized or not supported."
+      },
+      "4004": {
+        "en": "The request headers are not recognized or not supported."
+      },
+      "4005": {
+        "en": "The request parameters are not recognized or not supported."
+      },
+      "4006": {
+        "en": "The request format is not recognized or not supported."
+      },
+      "4007": {
+        "en": "The request content type is not recognized or not supported."
+      },
+      "4008": {
+        "en": "The request content length is not recognized or not supported."
+      },
+      "4009": {
+        "en": "The request content encoding is not recognized or not supported."
       }
     }
   }

package/bin/start-instance.js

@@ -151,7 +151,7 @@ try {
             setImmediate( () => process.exit( 1 ) );
         } );
     } else {
-        logger.log( `Attempting to start a module that does not implement the ServiceInstance abstract class!`, logger.logSeverity.ERROR );
+        logger.log( `Attempting to start a module that does not implement the ServiceInstance abstract class!`, logger.logSeverity.CRITICAL );
         setImmediate( () => process.exit( 1 ) );
     }
 } catch ( error ) {

package/components/auditing.js

@@ -11,9 +11,10 @@ const tools = require( "#tools" );
 const logger = require( "#logger" );
 const config = require( "#config" );
 const gcloud = require( "#gcloud-integration" );
+const ServiceInstance = require( "#service-instance" );
 
 /**
- * @typedef {Object} LogEntry
+ * @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.
@@ -59,19 +60,19 @@ class Auditing {
      */
     log( message, severity = logger.logSeverity.DEFAULT, thread = "main", data = {} ) {
         try {
-            // log entries bellow the min allowed level will be ignored:
+            // Log entries below the minimum allowed level will be directly ignored:
             if ( severity >= config.getSetting( config.setting.AUDITING_LOG_MIN_LEVEL ) ) {
-                // obscure any passwords that might have landed in the data object;
-                // also make sure to convert a potential Error object to a JSON:
+                // Obscure any passwords that might have landed in the data object;
+                // Also make sure to convert a potential Error object to a JSON:
                 let copyOfData = ( config.getSetting( config.setting.AUDITING_LOG_DETAILS ) === true ) ? _.cloneDeep( data ) : undefined;
                 let logEntry = Auditing.#createLogEntry( severity, thread, message, copyOfData );
 
-                // make sure there is a console available:
+                // Make sure there is a console available (especially important for Cloud or containerized environments):
                 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 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 );
                 }
@@ -91,14 +92,14 @@ class Auditing {
      * @param {string} thread
      * @param {string} message
      * @param {Object} data
-     * @returns {LogEntry}
+     * @returns {TiLogEntry}
      * @private
      */
     static #createLogEntry( severity, thread, message, data ) {
         let currentDate = new Date();
         let logDate = tools.getUTCDateString( currentDate );
         let logTime = tools.getUTCTimeString( currentDate, true );
-        let reporter = process.env.TI_INSTANCE_ID;
+        let reporter = ServiceInstance.instanceID;
 
         return {
             _id: `${ logDate }-${ logTime }-${ thread }-${ reporter }-${ logger.getSeverityName( severity ) }-${ tools.getUUID() }`,
@@ -112,13 +113,13 @@ class Auditing {
     }
 
     /**
-     * Used to write the log entries to the system console (i.e. STD OUT and STD ERR).
+     * Used to write the log entries to the system console (i.e., STD OUT and STD ERR).
      * <br/>
      * NOTE: There was an issue in previous Node versions with console that can crash the application if the number of
-     *    outputs exceeds several thousands per second. To be monitored and adjusted as necessary!
+     * outputs exceeds several thousands per second. To be monitored and adjusted as necessary!
      *
      * @method
-     * @param {LogEntry} logEntry
+     * @param {TiLogEntry} logEntry
      * @private
      */
     static #logToConsole( logEntry ) {
@@ -140,7 +141,7 @@ class Auditing {
      * Used to format a log entry for the Node console.
      *
      * @method
-     * @param {LogEntry} logEntry
+     * @param {TiLogEntry} logEntry
      * @returns {string}
      * @private
      */
@@ -153,7 +154,7 @@ class Auditing {
      * Used to format a log entry data payload for the Node console.
      *
      * @method
-     * @param {LogEntry} logEntry
+     * @param {TiLogEntry} logEntry
      * @returns {string}
      * @private
      */

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-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
+ * Copyright © 2021-2025 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/>.
@@ -37,7 +37,8 @@ class ConnectionObserver {
      * @virtual
      * @public
      */
-    onConnectionDisrupted( identifier ) { }
+    onConnectionDisrupted( identifier ) {
+    }
 
     /**
      * Needs to be invoked by the connection handler when the connection is recovered.
@@ -49,8 +50,22 @@ class ConnectionObserver {
      * @virtual
      * @public
      */
-    onConnectionRecovered( identifier ) { }
+    onConnectionRecovered( identifier ) {
+    }
+
+    /**
+     * Needs to be invoked by the connection handler when the connection is irrevocably lost.
+     * <br/>
+     * NOTE: Override this to add custom functionality.
+     *
+     * @method
+     * @param {string} identifier The identifier of the observed connection.
+     * @virtual
+     * @public
+     */
+    onConnectionLost( identifier ) {
+    }
 
 }
 
-module.exports = ConnectionObserver;
+module.exports = ConnectionObserver;

package/components/exchange/message-exchange.js

@@ -74,7 +74,7 @@ class MessageExchange extends MessageObserver {
      * @param {string} serviceDomainName The domain name of the microservice using the message exchange.
      */
     constructor( instanceID, serviceDomainName ) {
-        super();
+        super( 9 );
 
         // make sure this abstract class cannot be instantiated:
         if ( new.target === MessageExchange ) {
@@ -394,12 +394,25 @@ class MessageExchange extends MessageObserver {
         _.pull( this.#disruptedConnections, identifier );
     }
 
+    /**
+     * Used to mark the connection with the provided identifier as disrupted.
+     *
+     * @method
+     * @param {string} identifier The identifier of the observed connection.
+     * @override
+     * @public
+     */
+    onConnectionLost( identifier ) {
+        // TODO: implement triggering of a graceful shutdown of the service instance
+    }
+
     /**
      * Used only for the purposes of the message tracer.
      *
      * @method
      * @param {string} identifier The identifier of the observed connection.
      * @param {Message} message The message for processing.
+     * @returns {Message} The message that was received.
      * @override
      * @public
      */
@@ -411,6 +424,8 @@ class MessageExchange extends MessageObserver {
         } else if ( MessageExchange.connectionNameResponsesIn === identifier ) {
             messageTracer.instance.recordTraceEntry( message, messageTracer.messageType.MESSAGE_RESPONSE, messageTracer.dispatchEvent.RECEIVED, messageTracer.messageState.PROCESSED );
         }
+
+        return message;
     }
 
     /**

package/components/exchange/message-handler.js

@@ -54,7 +54,9 @@ class MessageHandler extends ConnectionObserver {
      * @returns {boolean}
      * @public
      */
-    get isAvailable() { return this.#isAvailable; }
+    get isAvailable() {
+        return this.#isAvailable;
+    }
 
     /**
      * Used to set the isAvailable flag.
@@ -65,7 +67,9 @@ class MessageHandler extends ConnectionObserver {
      * @param {boolean} value
      * @public
      */
-    set isAvailable( value ) { this.#isAvailable = value; }
+    set isAvailable( value ) {
+        this.#isAvailable = value;
+    }
 
     /**
      * Returns the connection identifier.
@@ -74,7 +78,9 @@ class MessageHandler extends ConnectionObserver {
      * @returns {string}
      * @public
      */
-    get connectionIdentifier() { return this.#connectionIdentifier; }
+    get connectionIdentifier() {
+        return this.#connectionIdentifier;
+    }
 
     /**
      * Used to initialize and enable the communication capabilities of the handler.
@@ -128,9 +134,9 @@ class MessageHandler extends ConnectionObserver {
      */
     addMessageObserver( messageObserver ) {
         const MessageObserver = require( "#message-observer" );
-
         if ( messageObserver instanceof MessageObserver ) {
             this.#messageObservers.push( messageObserver );
+            this.#messageObservers = _.orderBy( this.#messageObservers, [ "priority" ], [ "desc" ] );
         } else {
             logger.log( `Attempting to add '${ messageObserver.constructor.name }' as message observer but it's not a child-class of 'MessageObserver'!`, logger.logSeverity.WARNING );
         }
@@ -138,19 +144,23 @@ class MessageHandler extends ConnectionObserver {
 
     /**
      * An event-triggered method that will notify any observers about a new message for handling.
+     * <br/>
+     * NOTE: Each observer will be notified in the order of their priority via their {@link MessageObserver.onMessage} method. Additionally, the message will be
+     * passed through each observer in the order of their priority. If the observer returns a modified message, it will be used instead of the original message!
      *
      * @method
      * @param {Message} message
      * @public
      */
-    onMessage( message ) {
+    notifyMessageObservers( message ) {
+        let modifiedMessage = message;
         _.forEach( this.#messageObservers, ( messageObserver ) => {
-            messageObserver.onMessage( this.#connectionIdentifier, message );
+            modifiedMessage = messageObserver.onMessage( this.#connectionIdentifier, modifiedMessage );
         } );
     }
 
     /**
-     * An event-triggered method that will notify any observers about primary connection recovered state.
+     * An event-triggered method that will notify any observers about the primary connection recovered state.
      * <br/>
      * NOTE: You can override this to add custom functionality but make sure to also call the base method
      * using: super.onConnectionRecovered( identifier )
@@ -189,6 +199,26 @@ class MessageHandler extends ConnectionObserver {
         }
     }
 
+    /**
+     * An event-triggered method that will notify any observers about the primary connection having been lost.
+     * <br/>
+     * NOTE: You can override this to add custom functionality but make sure to also call the base method
+     * using: super.onConnectionLost( identifier )
+     *
+     * @method
+     * @param {string} identifier The identifier of the observed connection.
+     * @override
+     * @private
+     */
+    onConnectionLost( identifier ) {
+        if ( identifier === this.#connectionIdentifier ) {
+            this.#isAvailable = false;
+            _.forEach( this.#messageObservers, ( messageObserver ) => {
+                messageObserver.onConnectionLost( this.#connectionIdentifier );
+            } );
+        }
+    }
+
 }
 
 module.exports = MessageHandler;

package/components/exchange/message-observer.js

@@ -1,12 +1,13 @@
 /*
  * 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-2025 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 ConnectionObserver = require( "#connection-observer" );
+const _ = require( "lodash" );
 const exceptions = require( "#exceptions" );
 
 /**
@@ -21,16 +22,45 @@ const exceptions = require( "#exceptions" );
  */
 class MessageObserver extends ConnectionObserver {
 
+    #priority = 0;
+
     /**
+     * @param {number} [priority=0] The priority of this observer. Higher values indicate higher priority.
      * @constructor
      */
-    constructor() {
+    constructor( priority = 0 ) {
         super();
 
         // make sure this abstract class cannot be instantiated:
         if ( new.target === MessageObserver ) {
             throw exceptions.raise( exceptions.exceptionCode.E_GEN_ABSTRACT_CLASS_INIT, { name: this.constructor.name } );
         }
+
+        this.#priority = _.isNumber( priority ) ? priority : 0;
+    }
+
+    /**
+     * Returns the priority of this observer.
+     * <br/>
+     * NOTE: Higher values indicate higher priority.
+     *
+     * @property
+     * @returns {number}
+     */
+    get priority() {
+        return this.#priority;
+    }
+
+    /**
+     * Used to set the priority of this observer.
+     * <br/>
+     * NOTE: Higher values indicate higher priority.
+     *
+     * @property
+     * @param {number} value
+     */
+    set priority( value ) {
+        this.#priority = _.isNumber( value ) ? value : 0;
     }
 
     /**
@@ -41,10 +71,13 @@ class MessageObserver extends ConnectionObserver {
      * @method
      * @param {string} identifier The identifier of the observed connection.
      * @param {Message} message The message for processing.
+     * @returns {Message} The message that was received.
      * @virtual
      * @public
      */
-    onMessage( identifier, message ) { }
+    onMessage( identifier, message ) {
+        return message;
+    }
 
     /**
      * Needs to be invoked by the connection handler when the connection is disrupted.
@@ -74,6 +107,20 @@ class MessageObserver extends ConnectionObserver {
         super.onConnectionRecovered( identifier );
     }
 
+    /**
+     * Needs to be invoked by the connection handler when the connection is irrevocably lost.
+     * <br/>
+     * NOTE: Override this to add custom functionality.
+     *
+     * @method
+     * @param {string} identifier The identifier of the observed connection.
+     * @virtual
+     * @public
+     */
+    onConnectionLost( identifier ) {
+        super.onConnectionLost( identifier );
+    }
+
 }
 
-module.exports = MessageObserver;
+module.exports = MessageObserver;

package/components/exchange/message-receiver.js

@@ -117,7 +117,7 @@ class MessageReceiver extends MessageHandler {
             this.onReceive().then( ( message ) => {
                 return this.#postReceive( message );
             } ).then( ( message ) => {
-                this.onMessage( message );
+                this.notifyMessageObservers( message );
             } ).catch( ( error ) => {
                 if ( error.code !== exceptions.exceptionCode.E_COM_MESSAGE_RECEIVER_UNAVAILABLE ) {
                     logger.log( `Error while trying to receive the next pending message from memory cache in receiver '${ this.connectionIdentifier }'! Resuming operation...`, logger.logSeverity.ERROR, error );