@ti-engine/core 1.3.3 → 1.3.6

package/bin/localization/labels.json

@@ -1,99 +1,102 @@
-{
-  "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."
-      }
-    }
-  }
+{
+  "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."
+      },
+      "1007": {
+        "en": "The provided argument is not of the expected type."
+      },
+      "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/components/exchange/message-dispatcher.js

@@ -95,8 +95,8 @@ class MessageDispatcher {
             retry.onFailedAttempt( ( error ) => {
                 logger.log( `Failed to send message request with chain ID: ${ message.chainID }`, logger.logSeverity.WARNING, error );
             } );
-            retry.onRetry( ( attempt ) => {
-                logger.log( `Retrying to send message response with chain ID: ${ message.chainID }. This is attempt ${ attempt }...`, logger.logSeverity.NOTICE );
+            retry.onRetry( ( attempt, error ) => {
+                logger.log( `Retrying to send message response with chain ID: ${ message.chainID }. This is attempt ${ attempt }...`, logger.logSeverity.NOTICE, ( error ) ? { error: tools.errorToJSON( error ) } : undefined );
             } );
 
             messageTracer.instance.recordTraceEntry( message, messageTracer.messageType.MESSAGE_REQUEST, messageTracer.dispatchEvent.SENT, messageTracer.messageState.PENDING );
@@ -125,8 +125,8 @@ class MessageDispatcher {
             retry.onFailedAttempt( ( error ) => {
                 logger.log( `Failed to send message response with chain ID: ${ message.chainID }`, logger.logSeverity.WARNING, error );
             } );
-            retry.onRetry( ( attempt ) => {
-                logger.log( `Retrying to send message response with chain ID: ${ message.chainID }. This is attempt ${ attempt }...`, logger.logSeverity.NOTICE );
+            retry.onRetry( ( attempt, error ) => {
+                logger.log( `Retrying to send message response with chain ID: ${ message.chainID }. This is attempt ${ attempt }...`, logger.logSeverity.NOTICE, ( error ) ? { error: tools.errorToJSON( error ) } : undefined );
             } );
 
             messageTracer.instance.recordTraceEntry( message, messageTracer.messageType.MESSAGE_RESPONSE, messageTracer.dispatchEvent.SENT, messageTracer.messageState.PROCESSED );

package/components/exchange/message-tracer.js

@@ -30,6 +30,7 @@ const cache = require( "#cache" );
 const traceRoot = {
     trace: []
 };
+const UNKNOWN_TOKEN = "UNKNOWN";
 
 /**
  * Enum for listing message types.
@@ -155,12 +156,12 @@ class MessageTracer {
         /** @type TiTraceEntry */
         let traceEntry = {
             chainID: message.chainID,
-            dispatchEvent: tools.getEnumName( dispatchEventEnum, dispatchEvent ),
+            dispatchEvent: dispatchEventEnum.name( dispatchEvent, UNKNOWN_TOKEN ),
             fromAddress: ( messageType === messageTypeEnum.MESSAGE_REQUEST ) ? source : destination,
             messageID: message.messageID,
             messageSnapshot: messageSnapshot,
-            messageState: tools.getEnumName( messageStateEnum, messageState ),
-            messageType: tools.getEnumName( messageTypeEnum, messageType ),
+            messageState: messageStateEnum.name( messageState, UNKNOWN_TOKEN ),
+            messageType: messageTypeEnum.name( messageType, UNKNOWN_TOKEN ),
             toAddress: ( messageType === messageTypeEnum.MESSAGE_REQUEST ) ? destination : source,
             traceTimestamp: currentDate.getTime(),
             traceID: tools.getUUID()

package/components/service-caller.js

@@ -187,7 +187,7 @@ class ServiceCallProcessor {
         } ).catch( ( error ) => {
             clearTimeout( this.#timeoutHandle );
             this.#isProcessed = true;
-            logger.log( `Error during service call execution!`, logger.logSeverity.ERROR, error );
+            logger.log( `Error during service call execution!`, logger.logSeverity.DEBUG, error );
             return {
                 isSuccessful: false,
                 exception: exceptions.raise( error ),

package/components/service-consumer.js

@@ -32,9 +32,9 @@ class ServiceConsumer extends ServiceInstance {
     /**
      * @constructor
      * @param {string} serviceDomainName The service domain name for this service instance.
-     * @param {Object} [serviceConfig={}] The JSON configuration for this service.
+     * @param {ServiceConfiguration} [serviceConfig] The JSON configuration for this service.
      */
-    constructor( serviceDomainName, serviceConfig = {} ) {
+    constructor( serviceDomainName, serviceConfig ) {
         super( serviceDomainName, serviceConfig );
 
         // make sure this abstract class cannot be instantiated:

package/components/service-instance.js

@@ -17,7 +17,7 @@ const messageDispatcher = require( "#message-dispatcher" );
 
 /**
  * @typedef {Object} ServiceConfiguration
- * @property {ServiceDefinition[]} services A list of service definitions to be registered with the {@link ServiceProvider}.
+ * @property {ServiceDefinition[]} [services] A list of service definitions to be registered with the {@link ServiceProvider}.
  */
 
 /**
@@ -42,9 +42,9 @@ class ServiceInstance {
     /**
      * @constructor
      * @param {string} serviceDomainName The service domain name for this service instance.
-     * @param {Object} [serviceConfig={}] The JSON configuration for this service.
+     * @param {ServiceConfiguration} [serviceConfig={ services: [] }] The JSON configuration for this service.
      */
-    constructor( serviceDomainName, serviceConfig = {} ) {
+    constructor( serviceDomainName, serviceConfig = { services: [] } ) {
         // Ensure this abstract class cannot be instantiated:
         if ( new.target === ServiceInstance ) {
             throw exceptions.raise( exceptions.exceptionCode.E_GEN_ABSTRACT_CLASS_INIT, { name: this.constructor.name } );

package/components/service-provider.js

@@ -37,9 +37,9 @@ class ServiceProvider extends ServiceConsumer {
     /**
      * @constructor
      * @param {string} serviceDomainName The service domain name for this service instance.
-     * @param {Object} [serviceConfig={}] The JSON configuration for this service.
+     * @param {ServiceConfiguration} [serviceConfig] The JSON configuration for this service.
      */
-    constructor( serviceDomainName, serviceConfig = {} ) {
+    constructor( serviceDomainName, serviceConfig ) {
         super( serviceDomainName, serviceConfig );
 
         // make sure this abstract class cannot be instantiated:

package/integrations/redis-integration.js

@@ -118,7 +118,7 @@ class RedisClient {
     /* Public interface */
 
     /**
-     * Used to return the Redis client identifier.
+     * Used to return the Redis client identifier assigned internally.
      *
      * @property
      * @returns {string}
@@ -129,7 +129,7 @@ class RedisClient {
     }
 
     /**
-     * Used to return the Redis client ID.
+     * Used to return the client ID assigned by the Redis server.
      *
      * @property
      * @returns {number}
@@ -195,9 +195,9 @@ class RedisClient {
                     // Fetch the server information and store it:
                     return this.#fetchServerInfo();
                 } ).then( () => {
-                    return this.#getClientId();
+                    return this.#getClientID();
                 } ).then( ( clientID ) => {
-                    // Store the client ID:
+                    // Store the connection ID:
                     this.#redisClientID = clientID;
                     resolve();
                 } ).catch( ( error ) => {
@@ -476,10 +476,12 @@ class RedisClient {
 
                 this.#redisConnection.once( "ready", () => {
                     this.#clientStatus = clientStatusEnum.CONNECTED;
+                    logger.log( `Connection to Redis server '${ this.#redisConnection.options.host }:${ this.#redisConnection.options.port }' established by client '${ this.identifier }' and is ready to be used.`, logger.logSeverity.INFO );
                     this.#notifyConnectionObservers();
 
                     this.#redisConnection.on( "ready", () => {
                         this.#clientStatus = clientStatusEnum.CONNECTED;
+                        logger.log( `Connection to Redis server '${ this.#redisConnection.options.host }:${ this.#redisConnection.options.port }' reestablished by client '${ this.identifier }' and is ready to be used.`, logger.logSeverity.INFO );
                         this.#notifyConnectionObservers();
                     } );
 
@@ -515,14 +517,13 @@ class RedisClient {
      */
     #notifyConnectionObservers() {
         // Notify all connection observers about the event:
-        _.forEach( this.#connectionObservers, ( connectionObservers ) => {
+        _.forEach( this.#connectionObservers, ( connectionObserver ) => {
             if ( this.#clientStatus === clientStatusEnum.CONNECTED ) {
-                logger.log( `Connection to Redis server ${ this.#redisConnection.options.host }:${ this.#redisConnection.options.port } (re)established by client '${ this.identifier }' and is ready to be used.`, logger.logSeverity.INFO );
-                connectionObservers.onConnectionRecovered( this.#clientIdentifier );
+                connectionObserver.onConnectionRecovered( this.#clientIdentifier );
             } else if ( this.#clientStatus === clientStatusEnum.DISRUPTED ) {
-                connectionObservers.onConnectionDisrupted( this.#clientIdentifier );
+                connectionObserver.onConnectionDisrupted( this.#clientIdentifier );
             } else if ( this.#clientStatus === clientStatusEnum.DISCONNECTED ) {
-                connectionObservers.onConnectionLost( this.#clientIdentifier );
+                connectionObserver.onConnectionLost( this.#clientIdentifier );
             }
         } );
     }
@@ -574,7 +575,7 @@ class RedisClient {
      * @returns {Promise<number>}
      * @private
      */
-    #getClientId() {
+    #getClientID() {
         let commandArguments = [ "client", "id" ];
         return this.callCommand( commandArguments ).then( ( clientID ) => Number( clientID ) );
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ti-engine/core",
-  "version": "1.3.3",
+  "version": "1.3.6",
   "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",
@@ -47,8 +47,7 @@
   },
   "dependencies": {
     "blake2": "^5.0.0",
-    "@dotenvx/dotenvx": "^1.49.0",
-    "fs-extra": "^11.3.1",
+    "@dotenvx/dotenvx": "^1.49.1",
     "lodash": "^4.17.21",
     "node-schedule": "^2.1.1",
     "ioredis": "^5.7.0"
@@ -62,6 +61,6 @@
     "url": "git+https://github.com/Belleal/ti-engine.git"
   },
   "engines": {
-    "node": ">=14.17.0"
+    "node": ">=18.0.0"
   }
 }

package/utils/exceptions.js

@@ -25,6 +25,7 @@ const exceptionCodeEnum = tools.enum( {
     E_GEN_SYSTEM_CACHE_UNAVAILABLE: [ 1004, "system cache unavailable", "The system cache required for proper engine operation is unavailable." ],
     E_GEN_BAD_SERVICE_HANDLER: [ 1005, "bad service handler", "The provided service handler is not a proper function." ],
     E_GEN_FEATURE_UNSUPPORTED: [ 1006, "feature unsupported", "The requested feature is not supported by current configuration or version." ],
+    E_GEN_INVALID_ARGUMENT_TYPE: [ 1007, "invalid argument type", "The provided argument is not of the expected type." ],
     /** Security & Administration exceptions - codes under 2xxx */
     E_SEC_INVALID_AUTH_TOKEN: [ 2000, "invalid auth token", "Invalid authorization token provided." ],
     E_SEC_INVALID_EXPIRED_SESSION: [ 2001, "invalid or expired session", "Invalid or expired session encountered." ],
@@ -53,11 +54,89 @@ const exceptionCodeEnum = tools.enum( {
     E_WEB_INVALID_REQUEST_CONTENT_ENCODING: [ 4009, "invalid request content encoding", "The request content encoding is not recognized or not supported." ]
 } );
 
+/**
+ * Enum for listing all HTTP codes.
+ *
+ * @readonly
+ * @enum {number}
+ */
+const httpCodeEnum = tools.enum( {
+    /** 1xx informational response */
+    C_100: [ 100, "Continue", "The server has received the request headers and the client should proceed to send the request body." ],
+    C_101: [ 101, "Switching Protocols", "The requester has asked the server to switch protocols and the server has agreed to do so." ],
+    C_102: [ 102, "Processing", "This code indicates that the server has received and is processing the request, but no response is available yet." ],
+    C_103: [ 103, "Early Hints", "Used to return some response headers before final HTTP message." ],
+    /** 2xx success */
+    C_200: [ 200, "OK", "Standard response for successful HTTP requests." ],
+    C_201: [ 201, "Created", "The request has been fulfilled, resulting in the creation of a new resource." ],
+    C_202: [ 202, "Accepted", "The request has been accepted for processing, but the processing has not been completed." ],
+    C_203: [ 203, "Non-Authoritative Information", "The server is a transforming proxy that received a 200 OK from its origin, but is returning a modified version of the origin's response." ],
+    C_204: [ 204, "No Content", "The server successfully processed the request, and is not returning any content." ],
+    C_205: [ 205, "Reset Content", "The server successfully processed the request, asks that the requester reset its document view, and is not returning any content." ],
+    C_206: [ 206, "Partial Content", "The server is delivering only part of the resource (byte serving) due to a range header sent by the client." ],
+    C_207: [ 207, "Multi-Status", "The message body that follows is by default an XML message and can contain a number of separate response codes, depending on how many sub-requests were made." ],
+    C_208: [ 208, "Already Reported", "The members of a DAV binding have already been enumerated in a preceding part of the (multistatus) response, and are not being included again." ],
+    C_226: [ 226, "IM Used", "The server has fulfilled a request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance." ],
+    /** 3xx redirection */
+    C_300: [ 300, "Multiple Choices", "Indicates multiple options for the resource from which the client may choose." ],
+    C_301: [ 301, "Moved Permanently", "This and all future requests should be directed to the given URI." ],
+    C_302: [ 302, "Found", "Tells the client to look at (browse to) another URL." ],
+    C_303: [ 303, "See Other", "The response to the request can be found under another URI using the GET method." ],
+    C_304: [ 304, "Not Modified", "Indicates that the resource has not been modified since the version specified by the request headers If-Modified-Since or If-None-Match." ],
+    C_307: [ 307, "Temporary Redirect", "In this case, the request should be repeated with another URI; however, future requests should still use the original URI." ],
+    C_308: [ 308, "Permanent Redirect", "This and all future requests should be directed to the given URI. 308 parallels the behavior of 301, but does not allow the HTTP method to change." ],
+    /** 4xx client errors */
+    C_400: [ 400, "Bad Request", "The server cannot or will not process the request due to an apparent client error." ],
+    C_401: [ 401, "Unauthorized", "Similar to 403 Forbidden, but specifically for use when authentication is required and has failed or has not yet been provided." ],
+    C_403: [ 403, "Forbidden", "The request contained valid data and was understood by the server, but the server is refusing action. This may be due to the user not having the necessary permissions for a resource or needing an account of some sort, or attempting a prohibited action." ],
+    C_404: [ 404, "Not Found", "The requested resource could not be found but may be available in the future. Subsequent requests by the client are permissible." ],
+    C_405: [ 405, "Method Not Allowed", "A request method is not supported for the requested resource; for example, a GET request on a form that requires data to be presented via POST, or a PUT request on a read-only resource." ],
+    C_406: [ 406, "Not Acceptable", "The requested resource is capable of generating only content not acceptable according to the Accept headers sent in the request." ],
+    C_407: [ 407, "Proxy Authentication Required", "The client must first authenticate itself with the proxy." ],
+    C_408: [ 408, "Request Timeout", "The server timed out waiting for the request." ],
+    C_409: [ 409, "Conflict", "Indicates that the request could not be processed because of conflict in the current state of the resource, such as an edit conflict between multiple simultaneous updates." ],
+    C_410: [ 410, "Gone", "Indicates that the resource requested was previously in use but is no longer available and will not be available again." ],
+    C_411: [ 411, "Length Required", "The request did not specify the length of its content, which is required by the requested resource." ],
+    C_412: [ 412, "Precondition Failed", "The server does not meet one of the preconditions that the requester put on the request header fields." ],
+    C_413: [ 413, "Payload Too Large", "The request is larger than the server is willing or able to process." ],
+    C_414: [ 414, "URI Too Long", "The URI provided was too long for the server to process." ],
+    C_415: [ 415, "Unsupported Media Type", "The request entity has a media type which the server or resource does not support." ],
+    C_416: [ 416, "Range Not Satisfiable", "The client has asked for a portion of the file (byte serving), but the server cannot supply that portion." ],
+    C_417: [ 417, "Expectation Failed", "The server cannot meet the requirements of the Expect request-header field." ],
+    C_421: [ 421, "Misdirected Request", "The request was directed at a server that is not able to produce a response (for example because of connection reuse)." ],
+    C_422: [ 422, "Unprocessable Content", "The request was well-formed (i.e., syntactically correct) but could not be processed." ],
+    C_423: [ 423, "Locked", "The resource that is being accessed is locked." ],
+    C_424: [ 424, "Failed Dependency", "The request failed because it depended on another request and that request failed." ],
+    C_425: [ 425, "Too Early", "Indicates that the server is unwilling to risk processing a request that might be replayed." ],
+    C_426: [ 426, "Upgrade Required", "The client should switch to a different protocol such as TLS/1.3, given in the Upgrade header field." ],
+    C_428: [ 428, "Precondition Required", "The origin server requires the request to be conditional." ],
+    C_429: [ 429, "Too Many Requests", "The user has sent too many requests in a given amount of time. Intended for use with rate-limiting schemes." ],
+    C_431: [ 431, "Request Header Fields Too Large", "The server is unwilling to process the request because either an individual header field, or all the header fields collectively, are too large." ],
+    C_451: [ 451, "Unavailable For Legal Reasons", "A server operator has received a legal demand to deny access to a resource or to a set of resources that includes the requested resource." ],
+    /** 5xx server errors */
+    C_500: [ 500, "Internal Server Error", "A generic error message, given when an unexpected condition was encountered and no more specific message is suitable." ],
+    C_501: [ 501, "Not Implemented", "The server either does not recognize the request method, or it lacks the ability to fulfil the request." ],
+    C_502: [ 502, "Bad Gateway", "The server was acting as a gateway or proxy and received an invalid response from the upstream server." ],
+    C_503: [ 503, "Service Unavailable", "The server cannot handle the request (because it is overloaded or down for maintenance)." ],
+    C_504: [ 504, "Gateway Timeout", "The server was acting as a gateway or proxy and did not receive a timely response from the upstream server." ],
+    C_505: [ 505, "HTTP Version Not Supported", "The server does not support the HTTP version used in the request." ],
+    C_506: [ 506, "Variant Also Negotiates", "Transparent content negotiation for the request results in a circular reference." ],
+    C_507: [ 507, "Insufficient Storage", "The server is unable to store the representation needed to complete the request." ],
+    C_508: [ 508, "Loop Detected", "The server detected an infinite loop while processing the request." ],
+    C_510: [ 510, "Not Extended", "Further extensions to the request are required for the server to fulfil it." ],
+    C_511: [ 511, "Network Authentication Required", "The client needs to authenticate to gain network access. Intended for use by intercepting proxies used to control access to the network." ]
+} );
+
 /**
  * @typedef {number} TiExceptionCode
  */
 module.exports.exceptionCode = exceptionCodeEnum;
 
+/**
+ * @typedef {number} TiHttpCode
+ */
+module.exports.httpCode = httpCodeEnum;
+
 const labelPath = "system.exceptions.";
 
 /**
@@ -68,28 +147,27 @@ const labelPath = "system.exceptions.";
  */
 class Exception {
 
-    #id = undefined;
-    #code = undefined;
-    #httpCode = undefined;
-    #label = undefined;
-    #description = undefined;
-    #data = undefined;
+    #id;
+    #code;
+    #httpCode;
+    #label;
+    #description;
+    #data;
 
     /**
      * @constructor
      * @param {string} id The unique ID to be assigned to this exception.
      * @param {TiExceptionCode} exceptionCode An unique exception identifier. If this is not recognized, the default error code will be used instead.
-     * @param {Object} [data] Any additional data to insert into the exception.
-     * @param {string} [description] Description of the exception.
+     * @param {Object} [data={}] Any additional data to insert into the exception.
+     * @param {string} [description=undefined] Description of the exception.
      */
     constructor( id, exceptionCode, data, description ) {
-        exceptionCode = ( exceptionCodeEnum.properties[ exceptionCode ] ) ? exceptionCode : module.exports.exceptionCode.E_UNKNOWN_ERROR;
+        exceptionCode = exceptionCodeEnum.contains( exceptionCode ) ? exceptionCode : exceptionCodeEnum.E_UNKNOWN_ERROR;
 
         this.#id = id;
         this.#code = exceptionCode;
-        this.#httpCode = undefined;
         this.#label = labelPath + exceptionCode;
-        this.#description = description || exceptionCodeEnum.properties[ exceptionCode ].description;
+        this.#description = description || exceptionCodeEnum.description( exceptionCode );
         this.#data = data || {};
     }
 
@@ -121,7 +199,7 @@ class Exception {
      * HTTP error code if relevant.
      *
      * @property
-     * @returns {number}
+     * @returns {TiHttpCode}
      * @public
      */
     get httpCode() {
@@ -132,11 +210,15 @@ class Exception {
      * HTTP error code if relevant.
      *
      * @property
-     * @param {number} httpCode
+     * @param {TiHttpCode} httpCode
      * @public
      */
     set httpCode( httpCode ) {
-        this.#httpCode = httpCode;
+        if ( httpCodeEnum.contains( httpCode ) ) {
+            this.#httpCode = httpCode;
+        } else {
+            this.#httpCode = undefined;
+        }
     }
 
     /**
@@ -192,14 +274,19 @@ class Exception {
      * @public
      */
     asJSON( includeData = true ) {
-        return {
+        let json = {
             id: this.id,
             code: this.code,
-            httpCode: this.httpCode,
             label: this.label,
-            description: this.description,
-            data: ( includeData === true ) ? this.data : undefined
+            description: this.description
         };
+        if ( this.#httpCode !== undefined ) {
+            json.httpCode = this.#httpCode;
+        }
+        if ( includeData === true ) {
+            json.data = this.#data;
+        }
+        return json;
     }
 }
 
@@ -218,17 +305,25 @@ module.exports.raise = ( source, data, exceptionID ) => {
     let exception;
 
     if ( source instanceof Error ) {
-        exception = new Exception( exceptionID || tools.getUUID(), module.exports.exceptionCode.E_GEN_JS_INTERNAL_ERROR, tools.errorToJSON( source ) );
+        exception = new Exception( exceptionID || tools.getUUID(), exceptionCodeEnum.E_GEN_JS_INTERNAL_ERROR, tools.errorToJSON( source ) );
     } else if ( source instanceof Exception ) {
         exception = source;
     } else if ( _.isString( source ) ) {
-        exception = new Exception( exceptionID || tools.getUUID(), module.exports.exceptionCode.E_GEN_JS_INTERNAL_ERROR, {
+        exception = new Exception( exceptionID || tools.getUUID(), exceptionCodeEnum.E_GEN_JS_INTERNAL_ERROR, {
             message: source
         } );
     } else if ( _.isObjectLike( source ) ) {
-        exception = new Exception( exceptionID || ( source.id || tools.getUUID() ), source.code || module.exports.exceptionCode.E_GEN_JS_INTERNAL_ERROR, source.data, source.description );
+        exception = new Exception(
+            exceptionID || ( source.id || tools.getUUID() ),
+            source.code || exceptionCodeEnum.E_GEN_JS_INTERNAL_ERROR,
+            source.data,
+            source.description
+        );
+        if ( httpCodeEnum.contains( source.httpCode ) ) {
+            exception.httpCode = source.httpCode;
+        }
     } else {
-        exception = new Exception( exceptionID || tools.getUUID(), ( exceptionCodeEnum.properties[ source ] ) ? source : module.exports.exceptionCode.E_UNKNOWN_ERROR );
+        exception = new Exception( exceptionID || tools.getUUID(), ( exceptionCodeEnum.contains( source ) ) ? source : exceptionCodeEnum.E_UNKNOWN_ERROR );
     }
 
     // Merge the default exception data with the additional one if it's provided:

package/utils/logger.js

@@ -42,7 +42,7 @@ module.exports.logSeverity = logSeverityEnum;
  * @returns {string}
  */
 module.exports.getSeverityName = ( severity ) => {
-    return tools.getEnumName( logSeverityEnum, severity, "unknown" );
+    return logSeverityEnum.name( severity, "unknown" );
 };
 
 /**