@ti-engine/core 1.1.10 → 1.2.0

package/integrations/redis-integration.js

@@ -78,7 +78,8 @@ class RedisClient {
     #clientIdentifier;
     #retryMaxInterval = 1000;
     #retryMaxAttempts = undefined;
-    #redisClient = undefined;
+    #redisConnection = undefined;
+    #redisClientID;
     #serverInfo = {};
     #serverFeatures = {};
     #connectionObservers = [];
@@ -106,6 +107,17 @@ class RedisClient {
         return this.#clientIdentifier;
     }
 
+    /**
+     * Used to return the Redis client ID.
+     *
+     * @property
+     * @returns {number}
+     * @public
+     */
+    get clientID() {
+        return this.#redisClientID;
+    }
+
     /**
      * Used to return the Redis server version.
      *
@@ -144,73 +156,27 @@ class RedisClient {
      */
     initialize( host, port, authKey, user, defaultDB, retryMaxIntervalMs = 1000, retryMaxAttempts = undefined ) {
         return new Promise( ( resolve, reject ) => {
-            if ( this.#redisClient ) {
+            if ( this.#redisConnection ) {
                 resolve();
             } else {
-                try {
-                    this.#retryMaxInterval = retryMaxIntervalMs;
-                    this.#retryMaxAttempts = retryMaxAttempts;
-
-                    let retryStrategy = ( attempt ) => {
-                        let result = Math.min( attempt * 50, this.#retryMaxInterval );
-
-                        if ( this.#retryMaxAttempts != null && attempt > this.#retryMaxAttempts ) {
-                            logger.log( "In Redis retry strategy: reached max attempts for command retry. Aborting...", logger.logSeverity.WARNING, { attempts: attempt } );
-                            result = exceptions.raise( exceptions.exceptionCode.E_COM_RETRY_ATTEMPTS_EXCEEDED );
-                        }
-
-                        return result;
-                    };
-
-                    let reconnectOnError = ( error ) => {
-                        logger.log( `In Redis reconnect on error strategy: ${ error.message }`, logger.logSeverity.ERROR, error );
-                        return !!error.message.includes( "READONLY" );
-                    };
-
-                    let options = {
-                        port: port,
-                        host: host,
-                        username: user,
-                        password: authKey,
-                        db: defaultDB,
-                        autoResendUnfulfilledCommands: true,
-                        maxRetriesPerRequest: null,
-                        retryStrategy: retryStrategy,
-                        reconnectOnError: reconnectOnError
-                    };
-
-                    /** @type Redis */
-                    this.#redisClient = new Redis( options );
-
-                    this.#redisClient.on( "ready", () => {
-                        logger.log( `Connection to Redis server ${ host }:${ port } (re)established by client '${ this.identifier }' and is ready to be used.`, logger.logSeverity.INFO );
-
-                        // Notify all connection observers about this event:
-                        _.forEach( this.#connectionObservers, ( connectionObservers ) => {
-                            connectionObservers.onConnectionRecovered( this.#clientIdentifier );
-                        } );
-
-                        // Fetch the server information and store it:
-                        this.#fetchServerInfo();
-
-                        resolve();
+                this.#setupClient( host, port, authKey, user, defaultDB, retryMaxIntervalMs, retryMaxAttempts ).then( () => {
+                    // Fetch the server information and store it:
+                    return this.#fetchServerInfo();
+                } ).then( () => {
+                    return this.#getClientId();
+                } ).then( ( clientID ) => {
+                    // Store the client ID:
+                    this.#redisClientID = clientID;
+
+                    // Notify all connection observers about the initialization success:
+                    _.forEach( this.#connectionObservers, ( connectionObservers ) => {
+                        connectionObservers.onConnectionRecovered( this.#clientIdentifier );
                     } );
-                    this.#redisClient.on( "error", ( error ) => {
-                        logger.log( `Error received in Redis client '${ this.identifier }'.`, logger.logSeverity.ERROR, error );
 
-                        // Notify all connection observers about this event:
-                        _.forEach( this.#connectionObservers, ( connectionObservers ) => {
-                            connectionObservers.onConnectionDisrupted( this.#clientIdentifier );
-                        } );
-                    } );
-                    this.#redisClient.on( "reconnecting", ( info ) => {
-                        if ( info.attempt > 1 ) {
-                            logger.log( `Client '${ this.identifier }' reconnecting to Redis server after ${ info.delay } ms. This is attempt ${ info.attempt }.`, logger.logSeverity.DEBUG );
-                        }
-                    } );
-                } catch ( error ) {
+                    resolve();
+                } ).catch( ( error ) => {
                     reject( exceptions.raise( error ) );
-                }
+                } );
             }
         } );
     }
@@ -240,7 +206,7 @@ class RedisClient {
      */
     executeCommands( commands ) {
         return new Promise( ( resolve, reject ) => {
-            this.#redisClient.multi( commands ).exec().then( ( results ) => {
+            this.#redisConnection.multi( commands ).exec().then( ( results ) => {
                 resolve( results );
             } ).catch( ( error ) => {
                 reject( exceptions.raise( error ) );
@@ -261,7 +227,7 @@ class RedisClient {
      */
     blockingCommand( command, commandArguments ) {
         return new Promise( ( resolve, reject ) => {
-            this.#redisClient[ command ].apply( this.#redisClient, commandArguments ).then( ( results ) => {
+            this.#redisConnection[ command ].apply( this.#redisConnection, commandArguments ).then( ( results ) => {
                 resolve( results );
             } ).catch( ( error ) => {
                 reject( exceptions.raise( error ) );
@@ -280,7 +246,7 @@ class RedisClient {
      */
     publishCommand( channel, message ) {
         return new Promise( ( resolve, reject ) => {
-            this.#redisClient.publish( channel, tools.stringifyJSON( message ) ).then( ( receivedBy ) => {
+            this.#redisConnection.publish( channel, tools.stringifyJSON( message ) ).then( ( receivedBy ) => {
                 resolve( receivedBy );
             } ).catch( ( error ) => {
                 reject( exceptions.raise( error ) );
@@ -301,7 +267,7 @@ class RedisClient {
      */
     subscribeCommand( channel, messageHandler ) {
         return new Promise( ( resolve, reject ) => {
-            // Avoid attaching multiple listeners for the same channel:
+            // Avoid attaching multiple listeners to the same channel:
             if ( this.#messageHandlersByChannel.has( channel ) ) {
                 logger.log( "Attempting to subscribe to message channel '" + channel + "' while already subscribed to it.", logger.logSeverity.WARNING );
                 resolve();
@@ -312,21 +278,21 @@ class RedisClient {
                     }
                 };
 
-                this.#redisClient.once( "subscribe", ( subscribedChannel ) => {
+                this.#redisConnection.once( "subscribe", ( subscribedChannel ) => {
                     if ( subscribedChannel === channel ) {
                         logger.log( "Subscription to message channel '" + channel + "' successful.", logger.logSeverity.DEBUG );
                         resolve();
                     }
                 } );
 
-                this.#redisClient.on( "message", onMessage );
+                this.#redisConnection.on( "message", onMessage );
                 this.#messageHandlersByChannel.set( channel, onMessage );
 
-                this.#redisClient.subscribe( channel ).catch( ( error ) => {
+                this.#redisConnection.subscribe( channel ).catch( ( error ) => {
                     // Cleanup partial state if subscribe fails:
                     const handler = this.#messageHandlersByChannel.get( channel );
                     if ( handler ) {
-                        this.#redisClient.off( "message", handler );
+                        this.#redisConnection.off( "message", handler );
                         this.#messageHandlersByChannel.delete( channel );
                     }
                     reject( exceptions.raise( error ) );
@@ -347,10 +313,11 @@ class RedisClient {
         return new Promise( ( resolve, reject ) => {
             const handler = this.#messageHandlersByChannel.get( channel );
             if ( handler ) {
-                this.#redisClient.off( "message", handler );
+                this.#redisConnection.off( "message", handler );
                 this.#messageHandlersByChannel.delete( channel );
             }
-            this.#redisClient.unsubscribe( channel ).then( () => {
+
+            this.#redisConnection.unsubscribe( channel ).then( () => {
                 resolve();
             } ).catch( ( error ) => {
                 reject( exceptions.raise( error ) );
@@ -372,7 +339,7 @@ class RedisClient {
      */
     callCommand( commandArguments ) {
         return new Promise( ( resolve, reject ) => {
-            this.#redisClient[ "call" ].apply( this.#redisClient, commandArguments ).then( ( result ) => {
+            this.#redisConnection[ "call" ].apply( this.#redisConnection, commandArguments ).then( ( result ) => {
                 resolve( result );
             } ).catch( ( error ) => {
                 reject( exceptions.raise( error ) );
@@ -386,7 +353,7 @@ class RedisClient {
      *
      * @method
      * @param {number} [timeoutMs=1000]
-     * @returns {Promise<Object>}
+     * @returns {Promise}
      * @public
      */
     shutDown( timeoutMs = 1000 ) {
@@ -401,19 +368,19 @@ class RedisClient {
 
             const timeout = setTimeout( () => {
                 try {
-                    this.#redisClient.disconnect();
+                    this.#redisConnection.disconnect();
                 } catch ( error ) {
                 }
                 done();
             }, timeoutMs );
 
-            this.#redisClient.quit().then( () => {
+            this.#redisConnection.quit().then( () => {
                 clearTimeout( timeout );
                 done();
             } ).catch( () => {
                 clearTimeout( timeout );
                 try {
-                    this.#redisClient.disconnect();
+                    this.#redisConnection.disconnect();
                 } catch ( error ) {
                 }
                 done();
@@ -424,40 +391,131 @@ class RedisClient {
     /* Private interface */
 
     /**
-     * Used to fetch and store Redis server information.
+     * Used to set up the connection to Redis server.
+     * <br/>
+     * NOTE: This method will only resolve once the server sends a 'ready' event.
      *
      * @method
-     * @private
+     * @param {string} host
+     * @param {number} port
+     * @param {string} authKey
+     * @param {string} user
+     * @param {number} defaultDB
+     * @param {number} [retryMaxIntervalMs=1000] Optional max backoff interval.
+     * @param {number|undefined} [retryMaxAttempts=undefined] Optional max (re)connection attempts before abort.
+     * @public
      */
-    #fetchServerInfo() {
-        this.#redisClient.info().then( ( result ) => {
-            this.#serverInfo = {};
-            if ( _.isString( result ) ) {
-                let rawData = _.split( result, "\r\n" );
-                _.forEach( rawData, ( entry ) => {
-                    let details = _.split( entry, ":" );
-                    if ( !_.startsWith( details[ 0 ], "#" ) && details[ 0 ] !== "" && details[ 0 ] ) {
-                        if ( _.isNaN( _.toNumber( details[ 1 ] ) ) ) {
-                            this.#serverInfo[ details[ 0 ] ] = details[ 1 ];
-                        } else {
-                            this.#serverInfo[ details[ 0 ] ] = _.toNumber( details[ 1 ] );
-                        }
+    #setupClient( host, port, authKey, user, defaultDB, retryMaxIntervalMs, retryMaxAttempts ) {
+        return new Promise( ( resolve, reject ) => {
+            try {
+                this.#retryMaxInterval = retryMaxIntervalMs;
+                this.#retryMaxAttempts = retryMaxAttempts;
+
+                let retryStrategy = ( attempt ) => {
+                    let result = Math.min( attempt * 50, this.#retryMaxInterval );
+
+                    if ( this.#retryMaxAttempts != null && attempt > this.#retryMaxAttempts ) {
+                        logger.log( "In Redis retry strategy: reached max attempts for command retry. Aborting...", logger.logSeverity.WARNING, { attempts: attempt } );
+                        result = exceptions.raise( exceptions.exceptionCode.E_COM_RETRY_ATTEMPTS_EXCEEDED );
                     }
+
+                    return result;
+                };
+
+                let reconnectOnError = ( error ) => {
+                    logger.log( `In Redis reconnect on error strategy: ${ error.message }`, logger.logSeverity.ERROR, error );
+                    return !!error.message.includes( "READONLY" );
+                };
+
+                let options = {
+                    port: port,
+                    host: host,
+                    username: user,
+                    password: authKey,
+                    db: defaultDB,
+                    autoResendUnfulfilledCommands: true,
+                    maxRetriesPerRequest: null,
+                    retryStrategy: retryStrategy,
+                    reconnectOnError: reconnectOnError
+                };
+
+                /** @type Redis */
+                this.#redisConnection = new Redis( options );
+
+                this.#redisConnection.on( "ready", () => {
+                    logger.log( `Connection to Redis server ${ host }:${ port } (re)established by client '${ this.identifier }' and is ready to be used.`, logger.logSeverity.INFO );
+                    resolve();
                 } );
-            }
-            return this.#redisClient.module( "LIST" );
-        } ).then( ( result ) => {
-            this.#serverFeatures = {};
-            if ( _.isArray( result ) ) {
-                _.forEach( result, ( entry ) => {
-                    this.#serverFeatures[ entry[ 1 ] ] = entry[ 3 ];
+                this.#redisConnection.on( "error", ( error ) => {
+                    logger.log( `Error received in Redis client '${ this.identifier }'.`, logger.logSeverity.ERROR, error );
+
+                    // Notify all connection observers about this event:
+                    _.forEach( this.#connectionObservers, ( connectionObservers ) => {
+                        connectionObservers.onConnectionDisrupted( this.#clientIdentifier );
+                    } );
+                } );
+                this.#redisConnection.on( "reconnecting", ( info ) => {
+                    if ( info.attempt > 1 ) {
+                        logger.log( `Client '${ this.identifier }' reconnecting to Redis server after ${ info.delay } ms. This is attempt ${ info.attempt }.`, logger.logSeverity.DEBUG );
+                    }
                 } );
+            } catch ( error ) {
+                reject( exceptions.raise( error ) );
             }
-        } ).catch( ( error ) => {
-            logger.log( `Failed to fetch server information by client '${ this.identifier }'!`, logger.logSeverity.WARNING, error );
         } );
     }
 
+    /**
+     * Used to fetch and store Redis server information.
+     *
+     * @method
+     * @private
+     */
+    #fetchServerInfo() {
+        return new Promise( ( resolve, reject ) => {
+            this.#redisConnection.info().then( ( result ) => {
+                this.#serverInfo = {};
+                if ( _.isString( result ) ) {
+                    let rawData = _.split( result, "\r\n" );
+                    _.forEach( rawData, ( entry ) => {
+                        let details = _.split( entry, ":" );
+                        if ( !_.startsWith( details[ 0 ], "#" ) && details[ 0 ] !== "" && details[ 0 ] ) {
+                            if ( _.isNaN( _.toNumber( details[ 1 ] ) ) ) {
+                                this.#serverInfo[ details[ 0 ] ] = details[ 1 ];
+                            } else {
+                                this.#serverInfo[ details[ 0 ] ] = _.toNumber( details[ 1 ] );
+                            }
+                        }
+                    } );
+                }
+                return this.#redisConnection.module( "LIST" );
+            } ).then( ( result ) => {
+                this.#serverFeatures = {};
+                if ( _.isArray( result ) ) {
+                    _.forEach( result, ( entry ) => {
+                        this.#serverFeatures[ entry[ 1 ] ] = entry[ 3 ];
+                    } );
+                }
+                resolve();
+            } ).catch( ( error ) => {
+                logger.log( `Failed to fetch Redis server information by client '${ this.identifier }'!`, logger.logSeverity.WARNING, error );
+                reject( exceptions.raise( error ) );
+            } );
+        } );
+    }
+
+    /**
+     * Used to fetch and store the Redis client ID.
+     *
+     * @method
+     * @returns {Promise<number>}
+     * @private
+     */
+    #getClientId() {
+        let commandArguments = [ "client", "id" ];
+        return this.callCommand( commandArguments ).then( ( clientID ) => Number( clientID ) );
+    }
+
 }
 
 /**

package/package.json

@@ -1,64 +1,66 @@
-{
-  "name": "@ti-engine/core",
-  "version": "1.1.10",
-  "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.",
-  "author": "Boris Kostadinov <kostadinov.boris@gmail.com>",
-  "license": "GPL-3.0-or-later",
-  "exports": {
-    "./exceptions": "./utils/exceptions.js",
-    "./localization": "./utils/localization.js",
-    "./logger": "./utils/logger.js",
-    "./service-consumer": "./components/service-consumer.js",
-    "./service-instance": "./components/service-instance.js",
-    "./service-provider": "./components/service-provider.js",
-    "./tools": "./utils/tools.js"
-  },
-  "imports": {
-    "#auditing": "./components/auditing.js",
-    "#cache": "./utils/cache.js",
-    "#config": "./utils/config.js",
-    "#connection-observer": "./components/connection-observer.js",
-    "#default-message-exchange": "./components/exchange/default/default-message-exchange.js",
-    "#default-message-receiver": "./components/exchange/default/default-message-receiver.js",
-    "#default-message-sender": "./components/exchange/default/default-message-sender.js",
-    "#exceptions": "./utils/exceptions.js",
-    "#gcloud-integration": "./integrations/gcloud-integration.js",
-    "#localization": "./utils/localization.js",
-    "#logger": "./utils/logger.js",
-    "#message-dispatcher": "./components/exchange/message-dispatcher.js",
-    "#message-exchange": "./components/exchange/message-exchange.js",
-    "#message-handler": "./components/exchange/message-handler.js",
-    "#message-memory-cache": "./components/exchange/message-memory-cache.js",
-    "#message-observer": "./components/exchange/message-observer.js",
-    "#message-receiver": "./components/exchange/message-receiver.js",
-    "#message-sender": "./components/exchange/message-sender.js",
-    "#message-tracer": "./components/exchange/message-tracer.js",
-    "#redis-integration": "./integrations/redis-integration.js",
-    "#service-caller": "./components/service-caller.js",
-    "#service-consumer": "./components/service-consumer.js",
-    "#service-executor": "./components/service-executor.js",
-    "#service-instance": "./components/service-instance.js",
-    "#service-provider": "./components/service-provider.js",
-    "#settings": "./bin/settings.json",
-    "#tools": "./utils/tools.js"
-  },
-  "dependencies": {
-    "blake2": "^5.0.0",
-    "dotenv": "^17.2.1",
-    "fs-extra": "^11.3.1",
-    "lodash": "^4.17.21",
-    "node-schedule": "^2.1.1",
-    "ioredis": "^5.7.0"
-  },
-  "optionalDependencies": {
-    "@google-cloud/error-reporting": "^3.0.5",
-    "zeromq": "^6.5.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Belleal/ti-engine.git"
-  },
-  "engines": {
-    "node": ">=14.17.0"
-  }
+{
+  "name": "@ti-engine/core",
+  "version": "1.2.0",
+  "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.",
+  "author": "Boris Kostadinov <kostadinov.boris@gmail.com>",
+  "license": "GPL-3.0-or-later",
+  "exports": {
+    ".": "./bin/start-instance.js",
+    "./exceptions": "./utils/exceptions.js",
+    "./localization": "./utils/localization.js",
+    "./logger": "./utils/logger.js",
+    "./service-consumer": "./components/service-consumer.js",
+    "./service-instance": "./components/service-instance.js",
+    "./service-provider": "./components/service-provider.js",
+    "./tools": "./utils/tools.js"
+  },
+  "imports": {
+    "#auditing": "./components/auditing.js",
+    "#cache": "./utils/cache.js",
+    "#config": "./utils/config.js",
+    "#connection-observer": "./components/connection-observer.js",
+    "#default-message-exchange": "./components/exchange/default/default-message-exchange.js",
+    "#default-message-receiver": "./components/exchange/default/default-message-receiver.js",
+    "#default-message-sender": "./components/exchange/default/default-message-sender.js",
+    "#exceptions": "./utils/exceptions.js",
+    "#gcloud-integration": "./integrations/gcloud-integration.js",
+    "#labels": "./bin/localization/labels.json",
+    "#localization": "./utils/localization.js",
+    "#logger": "./utils/logger.js",
+    "#message-dispatcher": "./components/exchange/message-dispatcher.js",
+    "#message-exchange": "./components/exchange/message-exchange.js",
+    "#message-handler": "./components/exchange/message-handler.js",
+    "#message-memory-cache": "./components/exchange/message-memory-cache.js",
+    "#message-observer": "./components/exchange/message-observer.js",
+    "#message-receiver": "./components/exchange/message-receiver.js",
+    "#message-sender": "./components/exchange/message-sender.js",
+    "#message-tracer": "./components/exchange/message-tracer.js",
+    "#redis-integration": "./integrations/redis-integration.js",
+    "#service-caller": "./components/service-caller.js",
+    "#service-consumer": "./components/service-consumer.js",
+    "#service-executor": "./components/service-executor.js",
+    "#service-instance": "./components/service-instance.js",
+    "#service-provider": "./components/service-provider.js",
+    "#settings": "./bin/settings.json",
+    "#tools": "./utils/tools.js"
+  },
+  "dependencies": {
+    "blake2": "^5.0.0",
+    "dotenv": "^17.2.1",
+    "fs-extra": "^11.3.1",
+    "lodash": "^4.17.21",
+    "node-schedule": "^2.1.1",
+    "ioredis": "^5.7.0"
+  },
+  "optionalDependencies": {
+    "@google-cloud/error-reporting": "^3.0.5",
+    "zeromq": "^6.5.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Belleal/ti-engine.git"
+  },
+  "engines": {
+    "node": ">=14.17.0"
+  }
 }

package/utils/config.js

@@ -72,7 +72,7 @@ const tools = require( "#tools" );
 
 /**
  * @typedef {Object} SettingsLocalization
- * @property {string} labelsPath
+ * @property {Array<string>} labelsPath
  * @property {string} language
  */
 
@@ -200,4 +200,4 @@ Object.freeze( settings );
  */
 module.exports.getSetting = ( setting, defaultValue ) => {
     return _.get( settings, setting, defaultValue );
-};
+};

package/utils/exceptions.js

@@ -37,6 +37,7 @@ let exceptionCodeEnum = tools.enum( {
     E_COM_SERVICE_NOT_REGISTERED: [ 3003, "service not registered", "The specified service is not found in the service registry." ],
     E_COM_SERVICE_NOT_FOUND: [ 3004, "service not found", "The specified service is not found in the service definition interface." ],
     E_COM_SERVICE_HANDLER_NOT_FOUND: [ 3005, "service handler not found", "No handler found in the interface for the specified service or service version." ],
+    E_COM_MESSAGE_RECEIVER_UNAVAILABLE: [ 3006, "message receiver unavailable", "The message receiver instance is currently unavailable." ],
     // E_COM_UNRECOGNIZED_API_URL: [ 301, "unrecognized api url", "Attempt to access unrecognized or invalid API URL." ],
     // E_COM_MISSING_REQUIRED_ARGUMENTS: [ 302, "missing required arguments", "Attempt to execute operation without all required arguments." ],
     // E_COM_UNRECOGNIZED_RESPONSE_STRUCTURE: [ 303, "unrecognized response structure", "The received response has unrecognized structure and cannot be parsed or examined." ],

package/utils/localization.js

@@ -1,30 +1,33 @@
-/*
- * 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>
- * 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 _ = require( "lodash" );
-const path = require( "path" );
-const config = require( "#config" );
-
-const labelsPath = path.normalize( path.join( process.cwd(), config.getSetting( config.setting.LOCALIZATION_LABELS_PATH ) ) );
-const labels = require( labelsPath );
-const defaultEmptyLabel = "!!! label not found !!!";
-
-// prevent further modifications to the labels object:
-Object.freeze( labels );
-
-/**
- * Used to return the textual value for a label based on the current system language.
- *
- * @method
- * @param {string} label This should be a dot-separated JSON path string.
- * @returns {string}
- * @public
- */
-module.exports.getLabel = ( label ) => {
-    return _.get( labels, label + "." + config.getSetting( config.setting.LOCALIZATION_LANGUAGE ), defaultEmptyLabel );
+/*
+ * 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>
+ * 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 _ = require( "lodash" );
+const path = require( "path" );
+const config = require( "#config" );
+
+// const labelsPath = path.normalize( path.join( process.cwd(), config.getSetting( config.setting.LOCALIZATION_LABELS_PATH ) ) );
+// const labels = require( labelsPath );
+const labels = require( "#labels" );
+const defaultEmptyLabel = "!!! label not found !!!";
+
+// TODO: Add functionality to import additional custom labels.
+
+// prevent further modifications to the labels object:
+Object.freeze( labels );
+
+/**
+ * Used to return the textual value for a label based on the current system language.
+ *
+ * @method
+ * @param {string} label This should be a dot-separated JSON path string.
+ * @returns {string}
+ * @public
+ */
+module.exports.getLabel = ( label ) => {
+    return _.get( labels, label + "." + config.getSetting( config.setting.LOCALIZATION_LANGUAGE ), defaultEmptyLabel );
 };

package/testRedis.js

@@ -1,22 +0,0 @@
-import Redis from "ioredis";
-
-const redisClient = new Redis( {
-    port: 17467,
-    host: "redis-17467.c300.eu-central-1-1.ec2.redns.redis-cloud.com",
-    username: "default",
-    password: "o49Iyj2JYnmD7NSFWa32x2iYqulWkIM1",
-    db: 0,
-    autoResendUnfulfilledCommands: true,
-    maxRetriesPerRequest: null,
-    retryStrategy: ( attempt ) => {
-        let result = Math.min( attempt * 50, 1000 );
-    }
-});
-
-redisClient.on('error', err => console.log('Redis Client Error', err));
-
-//await redisClient.connect();
-
-await redisClient.set('foo', 'bar');
-const result = await redisClient.get('foo');
-console.log(result);