@ti-engine/core 1.1.4 → 1.1.8

package/integrations/redis-integration.js

@@ -1,7 +1,10 @@
 /*
- * SPDX-FileCopyrightText: © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
- * SPDX-License-Identifier: ICU
- */
+ * 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 ConnectionObserver = require( "#connection-observer" );
 const Redis = require( "ioredis" );
@@ -17,27 +20,27 @@ const _ = require( "lodash" );
  * @enum {string}
  */
 let cacheCommandsEnum = tools.enum( {
-    ADD_TO_SET: [ "sadd", "add to set", "https://redis.io/commands/sadd" ],
-    DELETE_VALUE: [ "del", "delete value", "https://redis.io/commands/del" ],
-    EXPIRE: [ "expire", "expire", "https://redis.io/commands/expire" ],
-    GET_ALL_FROM_SET: [ "smembers", "get all set members", "https://redis.io/commands/smembers" ],
-    GET_VALUE: [ "get", "get value", "https://redis.io/commands/get" ],
-    HASH_GET: [ "hget", "hash get", "https://redis.io/commands/hget" ],
-    HASH_GET_ALL: [ "hgetall", "hash get all", "https://redis.io/commands/hgetall" ],
-    HASH_REMOVE: [ "hdel", "hash remove", "https://redis.io/commands/hdel" ],
-    HASH_SET: [ "hset", "", "https://redis.io/commands/hset" ],
-    HASH_SET_MANY: [ "hmset", "", "https://redis.io/commands/hmset" ],
-    IS_SET_MEMBER: [ "sismember", "", "https://redis.io/commands/sismember" ],
-    JSON_ARRAY_APPEND: [ "json.arrappend", "", "https://redis.io/commands/json.arrappend" ],
-    JSON_GET: [ "json.get", "", "https://redis.io/commands/json.get" ],
-    JSON_SET: [ "json.set", "", "https://redis.io/commands/json.set" ],
-    KEYS: [ "keys", "", "https://redis.io/commands/keys" ],
-    LIST_PUSH: [ "lpush", "list push", "https://redis.io/commands/lpush" ],
-    LIST_POP_TAIL_BLOCKING: [ "brpop", "list pop tail blocking", "https://redis.io/commands/brpop" ],
-    LIST_POP_TAIL_PUSH_HEAD_BLOCKING: [ "brpoplpush", "list pop tail push head blocking", "https://redis.io/commands/brpoplpush" ],
-    LIST_REMOVE: [ "lrem", "list remove", "https://redis.io/commands/lrem" ],
-    SET_VALUE: [ "set", "set value", "https://redis.io/commands/set" ],
-    UNION_OF_SETS: [ "sunion", "union of sets", "https://redis.io/commands/sunion" ]
+    ADD_TO_SET: [ "sadd", "add to set", "https://redis.io/docs/latest/commands/sadd/" ],
+    DELETE_VALUE: [ "del", "delete value", "https://redis.io/docs/latest/commands/del/" ],
+    EXPIRE: [ "expire", "expire", "https://redis.io/docs/latest/commands/expire/" ],
+    GET_ALL_FROM_SET: [ "smembers", "get all set members", "https://redis.io/docs/latest/commands/smembers/" ],
+    GET_VALUE: [ "get", "get value", "https://redis.io/docs/latest/commands/get/" ],
+    HASH_GET: [ "hget", "hash get", "https://redis.io/docs/latest/commands/hget/" ],
+    HASH_GET_ALL: [ "hgetall", "hash get all", "https://redis.io/docs/latest/commands/hgetall/" ],
+    HASH_REMOVE: [ "hdel", "hash remove", "https://redis.io/docs/latest/commands/hdel/" ],
+    HASH_SET: [ "hset", "", "https://redis.io/docs/latest/commands/hset/" ],
+    HASH_SET_MANY: [ "hmset", "(deprecated) use HSET with multiple fields", "https://redis.io/docs/latest/commands/hmset/" ],
+    IS_SET_MEMBER: [ "sismember", "", "https://redis.io/docs/latest/commands/sismember/" ],
+    JSON_ARRAY_APPEND: [ "json.arrappend", "", "https://redis.io/docs/latest/commands/json.arrappend/" ],
+    JSON_GET: [ "json.get", "", "https://redis.io/docs/latest/commands/json.get/" ],
+    JSON_SET: [ "json.set", "", "https://redis.io/docs/latest/commands/json.set/" ],
+    KEYS: [ "keys", "(warning: O(N), use SCAN where possible)", "https://redis.io/docs/latest/commands/keys/" ],
+    LIST_PUSH: [ "lpush", "list push", "https://redis.io/docs/latest/commands/lpush/" ],
+    LIST_POP_TAIL_BLOCKING: [ "brpop", "list pop tail blocking", "https://redis.io/docs/latest/commands/brpop/" ],
+    LIST_POP_TAIL_PUSH_HEAD_BLOCKING: [ "brpoplpush", "list pop tail push head blocking", "https://redis.io/docs/latest/commands/brpoplpush/" ],
+    LIST_REMOVE: [ "lrem", "list remove", "https://redis.io/docs/latest/commands/lrem/" ],
+    SET_VALUE: [ "set", "set value", "https://redis.io/docs/latest/commands/set/" ],
+    UNION_OF_SETS: [ "sunion", "union of sets", "https://redis.io/docs/latest/commands/sunion/" ]
 } );
 
 /**
@@ -63,6 +66,9 @@ module.exports.cacheOverrideMode = cacheOverrideModeEnum;
 
 /**
  * Used to create a Redis Cache client.
+ * <br/>
+ * NOTE: This client is set to automatically resend all pending commands on connection recovery with no limit on the retry attempts.
+ * This is done to avoid losing any pending commands in case of a connection failure. For a different behavior, use custom implementation.
  *
  * @class RedisClient
  * @public
@@ -76,6 +82,7 @@ class RedisClient {
     #serverInfo = {};
     #serverFeatures = {};
     #connectionObservers = [];
+    #messageHandlersByChannel = new Map();
 
     /**
      * @constructor
@@ -85,11 +92,13 @@ class RedisClient {
      * @param {string} authKey
      * @param {string} user
      * @param {number} defaultDB
-     * @param {boolean} autoRetryUnfulfilled
-     * @param {number} maxRetries
+     * @param {number} [retryMaxIntervalMs=1000] Optional max backoff interval.
+     * @param {number|undefined} [retryMaxAttempts=undefined] Optional max (re)connection attempts before abort.
      */
-    constructor( identifier, host, port, authKey, user, defaultDB, autoRetryUnfulfilled, maxRetries ) {
+    constructor( identifier, host, port, authKey, user, defaultDB, retryMaxIntervalMs = 1000, retryMaxAttempts = undefined ) {
         this.#clientIdentifier = identifier || "redis-client-" + tools.getUUID();
+        this.#retryMaxInterval = retryMaxIntervalMs;
+        this.#retryMaxAttempts = retryMaxAttempts;
 
         let retryStrategy = ( attempt ) => {
             let result = Math.min( attempt * 50, this.#retryMaxInterval );
@@ -113,8 +122,8 @@ class RedisClient {
             username: user,
             password: authKey,
             db: defaultDB,
-            autoResendUnfulfilledCommands: autoRetryUnfulfilled,
-            maxRetriesPerRequest: maxRetries,
+            autoResendUnfulfilledCommands: true,
+            maxRetriesPerRequest: null,
             retryStrategy: retryStrategy,
             reconnectOnError: reconnectOnError
         };
@@ -205,7 +214,8 @@ class RedisClient {
      * @public
      */
     get isJSONSupported() {
-        return !_.isNil( this.#serverFeatures[ "ReJSON" ] );
+        // Detect RedisJSON module variants (e.g., ReJSON, ReJSON2):
+        return !_.isNil( this.#serverFeatures[ "ReJSON" ] ) || !_.isNil( this.#serverFeatures[ "ReJSON2" ] );
     }
 
     /**
@@ -283,25 +293,69 @@ class RedisClient {
 
     /**
      * Used to subscribe to the specified channel for messages.
+     * <br/>
+     * NOTE: Call unsubscribeCommand(channel) to detach later.
      *
      * @method
-     * @param {string} channel
+     * @param {string} channel Unique identifier of the channel to subscribe to.
      * @param {function( Object )} messageHandler Will execute this handler every time a new message is received.
      * @return {Promise}
      * @public
      */
     subscribeCommand( channel, messageHandler ) {
         return new Promise( ( resolve, reject ) => {
-            this.#redisClient.on( "subscribe", ( channel, count ) => {
-                logger.log( "Subscription to message channel '" + channel + "' successful.", logger.logSeverity.DEBUG );
+            // Avoid attaching multiple listeners for 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();
-            } );
-            this.#redisClient.on( "message", ( channel, message ) => {
-                if ( typeof ( messageHandler ) === "function" ) {
-                    messageHandler( tools.parseJSON( message ) );
-                }
-            } );
-            this.#redisClient.subscribe( channel ).catch( ( error ) => {
+            } else {
+                const onMessage = ( subscribedChannel, message ) => {
+                    if ( subscribedChannel === channel && typeof messageHandler === "function" ) {
+                        messageHandler( tools.parseJSON( message ) );
+                    }
+                };
+
+                this.#redisClient.once( "subscribe", ( subscribedChannel ) => {
+                    if ( subscribedChannel === channel ) {
+                        logger.log( "Subscription to message channel '" + channel + "' successful.", logger.logSeverity.DEBUG );
+                        resolve();
+                    }
+                } );
+
+                this.#redisClient.on( "message", onMessage );
+                this.#messageHandlersByChannel.set( channel, onMessage );
+
+                this.#redisClient.subscribe( channel ).catch( ( error ) => {
+                    // Cleanup partial state if subscribe fails:
+                    const handler = this.#messageHandlersByChannel.get( channel );
+                    if ( handler ) {
+                        this.#redisClient.off( "message", handler );
+                        this.#messageHandlersByChannel.delete( channel );
+                    }
+                    reject( exceptions.raise( error ) );
+                } );
+            }
+        } );
+    }
+
+    /**
+     * Used to unsubscribe from a channel and remove its message handler.
+     *
+     * @method
+     * @param {string} channel Unique identifier of the channel to unsubscribe from.
+     * @return {Promise}
+     * @public
+     */
+    unsubscribeCommand( channel ) {
+        return new Promise( ( resolve, reject ) => {
+            const handler = this.#messageHandlersByChannel.get( channel );
+            if ( handler ) {
+                this.#redisClient.off( "message", handler );
+                this.#messageHandlersByChannel.delete( channel );
+            }
+            this.#redisClient.unsubscribe( channel ).then( () => {
+                resolve();
+            } ).catch( ( error ) => {
                 reject( exceptions.raise( error ) );
             } );
         } );
@@ -329,6 +383,47 @@ class RedisClient {
         } );
     }
 
+    /**
+     * Used to gracefully close the Redis connection.
+     * Attempts to quit(), then falls back to disconnect() on timeout.
+     *
+     * @method
+     * @param {number} [timeoutMs=1000]
+     * @returns {Promise<Object>}
+     * @public
+     */
+    shutDown( timeoutMs = 1000 ) {
+        return new Promise( ( resolve ) => {
+            let finished = false;
+            const done = () => {
+                if ( !finished ) {
+                    finished = true;
+                    resolve();
+                }
+            };
+
+            const timeout = setTimeout( () => {
+                try {
+                    this.#redisClient.disconnect();
+                } catch ( error ) {
+                }
+                done();
+            }, timeoutMs );
+
+            this.#redisClient.quit().then( () => {
+                clearTimeout( timeout );
+                done();
+            } ).catch( () => {
+                clearTimeout( timeout );
+                try {
+                    this.#redisClient.disconnect();
+                } catch ( error ) {
+                }
+                done();
+            } );
+        } );
+    }
+
 }
 
 /**
@@ -341,11 +436,11 @@ class RedisClient {
  * @param {string} [authKey=undefined]
  * @param {string} [user="default"]
  * @param {number} [defaultDB=0]
- * @param {boolean} [autoRetryUnfulfilled=true]
- * @param {number} [maxRetries=20]
+ * @param {number} [retryMaxIntervalMs=1000]
+ * @param {number|undefined} [retryMaxAttempts=undefined]
  * @return {RedisClient}
  * @public
  */
-module.exports.createRedisClient = ( identifier, host, port = 6379, authKey = undefined, user = "default", defaultDB = 0, autoRetryUnfulfilled = true, maxRetries = 20 ) => {
-    return Object.freeze( new RedisClient( identifier, host, port, authKey, user, defaultDB, autoRetryUnfulfilled, maxRetries ) );
-};
+module.exports.createRedisClient = ( identifier, host, port = 6379, authKey = undefined, user = "default", defaultDB = 0, retryMaxIntervalMs = 1000, retryMaxAttempts = undefined ) => {
+    return Object.freeze( new RedisClient( identifier, host, port, authKey, user, defaultDB, retryMaxIntervalMs, retryMaxAttempts ) );
+};

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@ti-engine/core",
-  "version": "1.1.4",
+  "version": "1.1.8",
   "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": "ISC",
+  "license": "GPL-3.0-or-later",
   "exports": {
     "./exceptions": "./utils/exceptions.js",
     "./localization": "./utils/localization.js",
@@ -44,15 +44,15 @@
   },
   "dependencies": {
     "blake2": "^5.0.0",
-    "dotenv": "^16.3.1",
-    "fs-extra": "^11.2.0",
+    "dotenv": "^17.2.1",
+    "fs-extra": "^11.3.1",
     "lodash": "^4.17.21",
     "node-schedule": "^2.1.1",
-    "ioredis": "^5.3.2"
+    "ioredis": "^5.7.0"
   },
   "optionalDependencies": {
     "@google-cloud/error-reporting": "^3.0.5",
-    "zeromq": "^6.0.0-beta.19"
+    "zeromq": "^6.5.0"
   },
   "repository": {
     "type": "git",
@@ -61,4 +61,4 @@
   "engines": {
     "node": ">=14.17.0"
   }
-}
+}

package/utils/cache.js

@@ -1,7 +1,10 @@
 /*
- * SPDX-FileCopyrightText: © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
- * SPDX-License-Identifier: ICU
- */
+ * 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 ConnectionObserver = require( "#connection-observer" );
 const _ = require( "lodash" );
@@ -54,7 +57,9 @@ class CommonMemoryCache extends ConnectionObserver {
      * @returns {boolean}
      * @public
      */
-    get isOperational() { return this.#isOperational; }
+    get isOperational() {
+        return this.#isOperational;
+    }
 
     /**
      * Property returning the connection identifier of the cache service.
@@ -63,7 +68,20 @@ class CommonMemoryCache extends ConnectionObserver {
      * @returns {string}
      * @public
      */
-    get connectionIdentifier() { return this.#connectionIdentifier; }
+    get connectionIdentifier() {
+        return this.#connectionIdentifier;
+    }
+
+    /**
+     * Used to gracefully shut down the cache service.
+     *
+     * @method
+     * @return {Promise}
+     * @public
+     */
+    shutDown() {
+        return this.#redisClient.shutDown( 250 );
+    }
 
     /**
      * Needs to be invoked by the connection handler when the connection is disrupted.
@@ -105,7 +123,7 @@ class CommonMemoryCache extends ConnectionObserver {
     }
 
     /**
-     * Used to search for keys by given pattern.
+     * Used to search for keys by a given pattern.
      *
      * @method
      * @param {string} pattern
@@ -361,7 +379,7 @@ class CommonMemoryCache extends ConnectionObserver {
     /**
      * Used to add multiple values to multiple sets in one transactional request.
      * <br/>
-     * NOTE: The two arrays of keys and values must have correct index relations (i.e. first pair on keys[0] and values[0] and so on)!
+     * NOTE: The two arrays of keys and values must have correct index relations (i.e., first pair on keys[0] and values[0] and so on)!
      *
      * @method
      * @param {string[]} keys
@@ -388,7 +406,7 @@ class CommonMemoryCache extends ConnectionObserver {
     }
 
     /**
-     * Used to check if the provided value is member of the specified set.
+     * Used to check if the provided value is a member of the specified set.
      *
      * @method
      * @param {string} setName
@@ -467,6 +485,7 @@ class CommonMemoryCache extends ConnectionObserver {
      * Used to set a single hash field.
      *
      * @method
+     * @deprecated
      * @param {string} key
      * @param {string} name
      * @param {*} value
@@ -492,6 +511,7 @@ class CommonMemoryCache extends ConnectionObserver {
      * Used to set multiple hash fields.
      *
      * @method
+     * @deprecated
      * @param {string} key
      * @param {Object[]} fields
      * @param {string} fields[].name
@@ -643,4 +663,4 @@ class CommonMemoryCache extends ConnectionObserver {
 }
 
 const instance = new CommonMemoryCache();
-module.exports = Object.freeze( instance );
+module.exports.instance = Object.freeze( instance );

package/utils/config.js

@@ -1,7 +1,10 @@
 /*
- * SPDX-FileCopyrightText: © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
- * SPDX-License-Identifier: ICU
- */
+ * 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 tools = require( "#tools" );
@@ -30,6 +33,8 @@ const tools = require( "#tools" );
  * @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
@@ -77,6 +82,8 @@ const tools = require( "#tools" );
  * @property {number} redisDB
  * @property {string} redisHost
  * @property {number} redisPort
+ * @property {number} retryMaxAttempts
+ * @property {number} retryMaxInterval
  * @property {string} user
  */
 
@@ -119,6 +126,8 @@ let settingsEnum = tools.enum( {
     MEMORY_CACHE_REDIS_DB: [ "memoryCache.redisDB", "redisDB", "" ],
     MEMORY_CACHE_REDIS_HOST: [ "memoryCache.redisHost", "redisHost", "" ],
     MEMORY_CACHE_REDIS_PORT: [ "memoryCache.redisPort", "redisPort", "" ],
+    MEMORY_CACHE_RETRY_MAX_ATTEMPTS: [ "memoryCache.retryMaxAttempts", "retryMaxAttempts", "" ],
+    MEMORY_CACHE_RETRY_MAX_INTERVAL: [ "memoryCache.retryMaxInterval", "retryMaxInterval", "" ],
     MEMORY_CACHE_USER: [ "memoryCache.user", "user", "" ],
     MESSAGE_EXCHANGE_QUEUE_PREFIX: [ "messageExchange.messageQueuePrefix", "messageQueuePrefix", "" ],
     MESSAGE_EXCHANGE_MESSAGE_STORE: [ "messageExchange.messageStore", "messageStore", "" ],
@@ -159,6 +168,8 @@ if ( settings.memoryCache ) {
     settings.memoryCache.redisDB = ( process.env.TI_MEMORY_CACHE_REDIS_DB !== undefined ) ? process.env.TI_MEMORY_CACHE_REDIS_DB : settings.memoryCache.redisDB;
     settings.memoryCache.redisHost = ( process.env.TI_MEMORY_CACHE_REDIS_HOST !== undefined ) ? process.env.TI_MEMORY_CACHE_REDIS_HOST : settings.memoryCache.redisHost;
     settings.memoryCache.redisPort = ( process.env.TI_MEMORY_CACHE_REDIS_PORT !== undefined ) ? process.env.TI_MEMORY_CACHE_REDIS_PORT : settings.memoryCache.redisPort;
+    settings.memoryCache.retryMaxAttempts = ( process.env.TI_MEMORY_CACHE_RETRY_MAX_ATTEMPTS !== undefined ) ? process.env.TI_MEMORY_CACHE_RETRY_MAX_ATTEMPTS : settings.memoryCache.retryMaxAttempts;
+    settings.memoryCache.retryMaxInterval = ( process.env.TI_MEMORY_CACHE_RETRY_MAX_INTERVAL !== undefined ) ? process.env.TI_MEMORY_CACHE_RETRY_MAX_INTERVAL : settings.memoryCache.retryMaxInterval;
     settings.memoryCache.user = ( process.env.TI_MEMORY_CACHE_USER !== undefined ) ? process.env.TI_MEMORY_CACHE_USER : settings.memoryCache.user;
 }
 if ( settings.messageExchange ) {

package/utils/exceptions.js

@@ -1,7 +1,10 @@
 /*
- * SPDX-FileCopyrightText: © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
- * SPDX-License-Identifier: ICU
- */
+ * 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>
+ * 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 tools = require( "#tools" );

package/utils/localization.js

@@ -1,7 +1,10 @@
 /*
- * SPDX-FileCopyrightText: © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
- * SPDX-License-Identifier: ICU
- */
+ * 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" );
@@ -24,4 +27,4 @@ Object.freeze( labels );
  */
 module.exports.getLabel = ( label ) => {
     return _.get( labels, label + "." + config.getSetting( config.setting.LOCALIZATION_LANGUAGE ), defaultEmptyLabel );
-};
+};

package/utils/logger.js

@@ -1,7 +1,10 @@
 /*
- * SPDX-FileCopyrightText: © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
- * SPDX-License-Identifier: ICU
- */
+ * 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 tools = require( "#tools" );
@@ -69,7 +72,6 @@ const exceptionToLog = ( exception ) => {
  * @public
  */
 module.exports.log = ( message, level = logSeverityEnum.DEFAULT, data = {}, thread = "main" ) => {
-    /** @type {Auditing} */
     const auditing = require( "#auditing" );
 
     if ( data instanceof Error ) {
@@ -80,5 +82,5 @@ module.exports.log = ( message, level = logSeverityEnum.DEFAULT, data = {}, thre
         data.exception = exceptionToLog( data.exception );
     }
 
-    auditing.log( message, level, thread, data );
-};
+    auditing.instance.log( message, level, thread, data );
+};

package/utils/tools.js

@@ -1,7 +1,10 @@
 /*
- * SPDX-FileCopyrightText: © 2021-2023 Boris Kostadinov <kostadinov.boris@gmail.com>
- * SPDX-License-Identifier: ICU
- */
+ * 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>
+ * 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 fs = require( "fs-extra" );
@@ -250,7 +253,7 @@ module.exports.decycle = ( object, replacer ) => {
  * replaced with references to the value found by the PATH. This will restore cycles. The object will be mutated.
  *
  * The eval function is used to locate the values described by a PATH. The root object is kept in a $ variable. A
- * regular expression is used to assure that the PATH is extremely well formed. The regexp contains nested quantifiers.
+ * regular expression is used to assure that the PATH is extremely well-formed. The regexp contains nested quantifiers.
  * That has been known to have extremely bad performance problems on some browsers for very long strings. A PATH is
  * expected to be reasonably short. A PATH is allowed to belong to a very restricted subset of Goessner's JSONPath.
  *