@org-quicko/core 1.0.2 → 1.1.0

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "@org-quicko/core",
-  "version": "1.0.2",
+  "version": "1.1.0",
   "description": "A library in typescript for common entities and utilities across Quicko",
   "author": "Quicko",
-  "main": "dist/cjs/index.cjs",
-  "module": "dist/esm/index.js",
+  "main": "dist/cjs/build/node/index.cjs",
+  "module": "dist/esm/build/node/index.js",
+  "browser": "dist/browser/build/browser/index.js",
   "types": "dist/types/index.d.ts",
   "type": "module",
   "scripts": {
@@ -22,86 +23,57 @@
     ".": {
       "types": "./dist/types/index.d.ts",
       "node": {
-        "import": "./dist/esm/index.js",
-        "require": "./dist/cjs/index.cjs"
+        "import": "./dist/esm/build/node/index.js",
+        "require": "./dist/cjs/build/node/index.cjs"
       },
-      "browser": {
-        "import": "./dist/esm/index.js",
-        "require": "./dist/cjs/index.cjs"
-      },
-      "default": "./dist/esm/index.js"
+      "default": "./dist/browser/build/browser/index.js"
     },
     "./beans": {
       "types": "./dist/types/src/beans/index.d.ts",
       "node": {
-        "import": "./dist/esm/src/beans/index.js",
-        "require": "./dist/cjs/src/beans/index.cjs"
-      },
-      "browser": {
-        "import": "./dist/esm/src/beans/index.js",
-        "require": "./dist/cjs/src/beans/index.cjs"
+        "import": "./dist/esm/beans/index.js",
+        "require": "./dist/cjs/beans/index.cjs"
       },
-      "default": "./dist/esm/src/beans/index.js"
+      "default": "./dist/browser/beans/index.js"
     },
     "./types": {
       "types": "./dist/types/src/types/index.d.ts",
       "node": {
-        "import": "./dist/esm/src/types/index.js",
-        "require": "./dist/cjs/src/types/index.cjs"
-      },
-      "browser": {
-        "import": "./dist/esm/src/types/index.js",
-        "require": "./dist/cjs/src/types/index.cjs"
+        "import": "./dist/esm/types/index.js",
+        "require": "./dist/cjs/types/index.cjs"
       },
-      "default": "./dist/esm/src/types/index.js"
+      "default": "./dist/browser/types/index.js"
     },
     "./utils": {
       "types": "./dist/types/src/utils/index.d.ts",
       "node": {
-        "import": "./dist/esm/src/utils/index.js",
-        "require": "./dist/cjs/src/utils/index.cjs"
+        "import": "./dist/esm/utils/index.js",
+        "require": "./dist/cjs/utils/index.cjs"
       },
-      "browser": {
-        "import": "./dist/esm/src/utils/index.js",
-        "require": "./dist/cjs/src/utils/index.cjs"
-      },
-      "default": "./dist/esm/src/utils/index.js"
+      "default": "./dist/browser/utils/index.js"
     },
     "./utils/date": {
       "types": "./dist/types/src/utils/date/index.d.ts",
       "node": {
-        "import": "./dist/esm/src/utils/date/index.js",
-        "require": "./dist/cjs/src/utils/date/index.cjs"
-      },
-      "browser": {
-        "import": "./dist/esm/src/utils/date/index.js",
-        "require": "./dist/cjs/src/utils/date/index.cjs"
+        "import": "./dist/esm/utils/date/index.js",
+        "require": "./dist/cjs/utils/date/index.cjs"
       },
-      "default": "./dist/esm/src/utils/date/index.js"
+      "default": "./dist/browser/utils/date/index.js"
     },
     "./logger": {
       "types": "./dist/types/src/logger/index.d.ts",
       "node": {
-        "import": "./dist/esm/src/logger/index.js",
-        "require": "./dist/cjs/src/logger/index.cjs"
-      },
-      "browser": {
-        "import": "./dist/esm/src/logger/index.js",
-        "require": "./dist/cjs/src/logger/index.cjs"
-      },
-      "default": "./dist/esm/src/logger/index.js"
+        "import": "./dist/esm/logger/index.js",
+        "require": "./dist/cjs/logger/index.cjs"
+      }
     },
     "./exceptions": {
       "types": "./dist/types/src/exceptions/index.d.ts",
       "node": {
-        "import": "./dist/esm/src/exceptions/index.js",
-        "require": "./dist/cjs/src/exceptions/index.cjs"
-      },
-      "browser": {
-        "import": "./dist/esm/src/exceptions/index.js",
-        "require": "./dist/cjs/src/exceptions/index.cjs"
+        "import": "./dist/esm/exceptions/index.js",
+        "require": "./dist/cjs/exceptions/index.cjs"
       },
-      "default": "./dist/esm/src/exceptions/index.js"
+      "default": "./dist/browser/exceptions/index.js"
     },
     "./package.json": "./package.json"
   },
@@ -145,22 +117,20 @@
     "winston": "^3.17.0"
   },
   "devDependencies": {
-    "@types/node": "^22.7.0",
-    "@typescript-eslint/eslint-plugin": "^8.17.0",
-    "@typescript-eslint/parser": "^8.17.0",
     "@rollup/plugin-commonjs": "^28.0.3",
     "@rollup/plugin-node-resolve": "^16.0.1",
-    "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.1.2",
+    "@types/node": "^22.7.0",
+    "@typescript-eslint/eslint-plugin": "^8.33.1",
+    "@typescript-eslint/parser": "^8.33.1",
     "esbuild-plugin-eslint": "^0.3.7",
-    "rollup-plugin-bundle-size": "^1.0.3",
-    "rollup-plugin-dts": "^6.2.1",
-    "eslint": "^8.2.0",
-    "eslint-config-airbnb": "^19.0.4",
-    "eslint-config-prettier": "^9.1.0",
+    "eslint": "^9.28.0",
+    "eslint-config-prettier": "^10.1.5",
     "eslint-import-resolver-typescript": "^3.7.0",
+    "glob": "^11.0.2",
     "rollup": "^4.40.2",
+    "rollup-plugin-dts": "^6.2.1",
     "ts-node": "^10.9.2",
     "typescript": "^5.6.2"
   }
-}
+}

package/dist/cjs/exceptions/NullPointerException.cjs

@@ -1,15 +0,0 @@
-'use strict';
-
-var BaseException = require('./BaseException.cjs');
-
-/**
- * Exception thrown when an operation is attempted on a `null` or `undefined` value.
- */
-class NullPointerException extends BaseException.BaseException {
-    constructor(message, cause) {
-        super(message, cause, 500);
-    }
-}
-
-exports.NullPointerException = NullPointerException;
-//# sourceMappingURL=NullPointerException.cjs.map

package/dist/cjs/exceptions/NullPointerException.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"NullPointerException.cjs","sources":["../../../src/exceptions/NullPointerException.ts"],"sourcesContent":["import { BaseException } from \"./BaseException.js\";\r\n\r\n/**\r\n * Exception thrown when an operation is attempted on a `null` or `undefined` value.\r\n */\r\nexport class NullPointerException extends BaseException {\r\n\r\n    constructor(message: string, cause?: unknown) {\r\n        super(message, cause, 500);\r\n    }\r\n}\r\n\r\n"],"names":["BaseException"],"mappings":";;;;AAEA;;AAEG;AACG,MAAO,oBAAqB,SAAQA,2BAAa,CAAA;IAEnD,WAAY,CAAA,OAAe,EAAE,KAAe,EAAA;AACxC,QAAA,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC;;AAEjC;;;;"}

package/dist/cjs/index.cjs

@@ -1,48 +0,0 @@
-'use strict';
-
-var BadRequestException = require('./exceptions/BadRequestException.cjs');
-var BaseException = require('./exceptions/BaseException.cjs');
-var ClientException = require('./exceptions/ClientException.cjs');
-var ForbiddenAccessException = require('./exceptions/ForbiddenAccessException.cjs');
-var HTTPException = require('./exceptions/HTTPException.cjs');
-var IllegalArgumentException = require('./exceptions/IllegalArgumentException.cjs');
-var UnauthorizedException = require('./exceptions/UnauthorizedException.cjs');
-var NullPointerException = require('./exceptions/NullPointerException.cjs');
-var ConverterException = require('./exceptions/ConverterException.cjs');
-var ConsoleLoggerProvider = require('./logger/factory/ConsoleLoggerProvider.cjs');
-var LoggerFactory = require('./logger/factory/LoggerFactory.cjs');
-var MDC = require('./logger/MDC.cjs');
-var JSONObject = require('./types/JSONObject.cjs');
-var LoggingLevel = require('./types/LoggingLevel.cjs');
-var SortOrder = require('./types/SortOrder.cjs');
-var BaseObject = require('./beans/BaseObject.cjs');
-var DateUtil = require('./utils/date/DateUtil.cjs');
-
-
-
-exports.BadRequestException = BadRequestException.BadRequestException;
-exports.BaseException = BaseException.BaseException;
-exports.ClientException = ClientException.ClientException;
-exports.ForbiddenAccessException = ForbiddenAccessException.ForbiddenAccessException;
-exports.HTTPException = HTTPException.HTTPException;
-exports.IllegalArgumentException = IllegalArgumentException.IllegalArgumentException;
-exports.UnauthorizedException = UnauthorizedException.UnauthorizedException;
-exports.NullPointerException = NullPointerException.NullPointerException;
-exports.ConverterException = ConverterException.ConverterException;
-exports.ConsoleLoggerProvider = ConsoleLoggerProvider.ConsoleLoggerProvider;
-exports.LoggerFactory = LoggerFactory.LoggerFactory;
-exports.LoggerStorage = LoggerFactory.LoggerStorage;
-exports.MDC = MDC.MDC;
-exports.JSONArray = JSONObject.JSONArray;
-exports.JSONObject = JSONObject.JSONObject;
-Object.defineProperty(exports, "LoggingLevel", {
-	enumerable: true,
-	get: function () { return LoggingLevel.LoggingLevel; }
-});
-Object.defineProperty(exports, "SortOrder", {
-	enumerable: true,
-	get: function () { return SortOrder.SortOrder; }
-});
-exports.BaseObject = BaseObject.BaseObject;
-exports.DateUtil = DateUtil.DateUtil;
-//# sourceMappingURL=index.cjs.map

package/dist/cjs/logger/MDC.cjs

@@ -1,77 +0,0 @@
-'use strict';
-
-var async_hooks = require('async_hooks');
-
-/**
- * Mapped Diagnostic Context (MDC) implementation using `AsyncLocalStorage`.
- * MDC allows associating contextual information (key-value pairs) with the
- * current execution context, which can be useful for logging and tracing.
- *
- * Methods:
- * - `get(key: string)`: Retrieves the value associated with the given key in the current context.
- * - `put(key: string, value: string)`: Adds or updates a key-value pair in the current context.
- * - `putAll(context: ContextMap)`: Adds or updates multiple key-value pairs in the current context.
- * - `clear()`: Clears all key-value pairs in the current context.
- * - `runWithContext(context: ContextMap, callback: () => T)`: Runs a callback function with the provided context.
- */
-class MDC {
-    static { this.storage = new async_hooks.AsyncLocalStorage(); }
-    /**
-     * Retrieves the value associated with the given key in the current context.
-     *
-     * @param key The key to retrieve the value for.
-     * @returns The value associated with the key, or `undefined` if not found.
-     */
-    static get(key) {
-        const store = MDC.storage.getStore();
-        return store ? store[key] : undefined;
-    }
-    /**
-     * Adds or updates a key-value pair in the current context.
-     *
-     * @param key The key to add or update.
-     * @param value The value to associate with the key.
-     */
-    static put(key, value) {
-        let store = MDC.storage.getStore();
-        if (!store) {
-            store = {};
-        }
-        store[key] = value;
-        MDC.storage.enterWith(store);
-    }
-    /**
-     * Adds or updates multiple key-value pairs in the current context.
-     *
-     * @param context An object containing key-value pairs to add or update.
-     */
-    static putAll(context) {
-        let store = MDC.storage.getStore();
-        if (!store) {
-            store = {};
-        }
-        Object.entries(context).forEach(([key, value]) => {
-            store[key] = value;
-        });
-        MDC.storage.enterWith(context);
-    }
-    /**
-     * Clears all key-value pairs in the current context.
-     */
-    static clear() {
-        MDC.storage.enterWith({});
-    }
-    /**
-     * Runs a callback function with the provided context.
-     *
-     * @param context The context to associate with the callback execution.
-     * @param callback The callback function to execute.
-     * @returns The result of the callback function.
-     */
-    static runWithContext(context, callback) {
-        return MDC.storage.run(context, callback);
-    }
-}
-
-exports.MDC = MDC;
-//# sourceMappingURL=MDC.cjs.map

package/dist/cjs/logger/MDC.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"MDC.cjs","sources":["../../../src/logger/MDC.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'async_hooks';\r\n\r\nexport interface ContextMap {\r\n    [key: string]: string;\r\n}\r\n\r\n/**\r\n * Mapped Diagnostic Context (MDC) implementation using `AsyncLocalStorage`.\r\n * MDC allows associating contextual information (key-value pairs) with the\r\n * current execution context, which can be useful for logging and tracing.\r\n *\r\n * Methods:\r\n * - `get(key: string)`: Retrieves the value associated with the given key in the current context.\r\n * - `put(key: string, value: string)`: Adds or updates a key-value pair in the current context.\r\n * - `putAll(context: ContextMap)`: Adds or updates multiple key-value pairs in the current context.\r\n * - `clear()`: Clears all key-value pairs in the current context.\r\n * - `runWithContext(context: ContextMap, callback: () => T)`: Runs a callback function with the provided context.\r\n */\r\nexport class MDC {\r\n    private static storage = new AsyncLocalStorage<ContextMap>();\r\n\r\n    /**\r\n     * Retrieves the value associated with the given key in the current context.\r\n     * \r\n     * @param key The key to retrieve the value for.\r\n     * @returns The value associated with the key, or `undefined` if not found.\r\n     */\r\n    static get(key: string): string | undefined {\r\n        const store = MDC.storage.getStore()!;\r\n        return store ? store[key] : undefined;\r\n    }\r\n\r\n    /**\r\n     * Adds or updates a key-value pair in the current context.\r\n     * \r\n     * @param key The key to add or update.\r\n     * @param value The value to associate with the key.\r\n     */\r\n    static put(key: string, value: string) {\r\n        let store: ContextMap | undefined = MDC.storage.getStore();\r\n        if (!store) {\r\n            store = {};\r\n        }\r\n        store[key] = value;\r\n        MDC.storage.enterWith(store);\r\n    }\r\n\r\n    /**\r\n     * Adds or updates multiple key-value pairs in the current context.\r\n     * \r\n     * @param context An object containing key-value pairs to add or update.\r\n     */\r\n    static putAll(context: ContextMap) {\r\n        let store: ContextMap | undefined = MDC.storage.getStore();\r\n        if (!store) {\r\n            store = {};\r\n        }\r\n        Object.entries(context).forEach(([key, value]) => {\r\n            store[key] = value;\r\n        });\r\n        MDC.storage.enterWith(context);\r\n    }\r\n\r\n    /**\r\n     * Clears all key-value pairs in the current context.\r\n     */\r\n    static clear() {\r\n        MDC.storage.enterWith({});\r\n    }\r\n\r\n    /**\r\n     * Runs a callback function with the provided context.\r\n     * \r\n     * @param context The context to associate with the callback execution.\r\n     * @param callback The callback function to execute.\r\n     * @returns The result of the callback function.\r\n     */\r\n    static runWithContext<T>(context: ContextMap, callback: () => T): T {\r\n        return MDC.storage.run(context, callback);\r\n    }\r\n}\r\n"],"names":["AsyncLocalStorage"],"mappings":";;;;AAMA;;;;;;;;;;;AAWG;MACU,GAAG,CAAA;AACG,IAAA,SAAA,IAAA,CAAA,OAAO,GAAG,IAAIA,6BAAiB,EAAc,CAAC;AAE7D;;;;;AAKG;IACH,OAAO,GAAG,CAAC,GAAW,EAAA;QAClB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAG;AACrC,QAAA,OAAO,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS;;AAGzC;;;;;AAKG;AACH,IAAA,OAAO,GAAG,CAAC,GAAW,EAAE,KAAa,EAAA;QACjC,IAAI,KAAK,GAA2B,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC1D,IAAI,CAAC,KAAK,EAAE;YACR,KAAK,GAAG,EAAE;;AAEd,QAAA,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK;AAClB,QAAA,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;;AAGhC;;;;AAIG;IACH,OAAO,MAAM,CAAC,OAAmB,EAAA;QAC7B,IAAI,KAAK,GAA2B,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC1D,IAAI,CAAC,KAAK,EAAE;YACR,KAAK,GAAG,EAAE;;AAEd,QAAA,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AAC7C,YAAA,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK;AACtB,SAAC,CAAC;AACF,QAAA,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;;AAGlC;;AAEG;AACH,IAAA,OAAO,KAAK,GAAA;AACR,QAAA,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;;AAG7B;;;;;;AAMG;AACH,IAAA,OAAO,cAAc,CAAI,OAAmB,EAAE,QAAiB,EAAA;QAC3D,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;;;;;;"}

package/dist/cjs/logger/factory/ConsoleLoggerProvider.cjs

@@ -1,43 +0,0 @@
-'use strict';
-
-var winston = require('winston');
-var ClientException = require('../../exceptions/ClientException.cjs');
-var LoggingLevel = require('../../types/LoggingLevel.cjs');
-var MDC = require('../MDC.cjs');
-
-const addMdcDataFormat = winston.format((info) => {
-    info.path = MDC.MDC.get('path');
-    info.transaction_id = MDC.MDC.get('x-api-transaction-id');
-    return info;
-});
-/**
- * Implementation of the `LoggerProvider` interface that creates
- * a Winston logger configured to log to the console.
- */
-class ConsoleLoggerProvider {
-    /**
-     * Creates a Winston logger instance configured for console logging.
-     * The logger includes MDC (Mapped Diagnostic Context) data, timestamps,
-     * and JSON formatting.
-     *
-     * @returns A promise that resolves to a Winston logger instance.
-     * @throws ClientException If an error occurs while creating the logger.
-     */
-    async createLogger() {
-        try {
-            const logLevel = LoggingLevel.LoggingLevel[(process.env.LOG_LEVEL || 'info').trim().toLowerCase()];
-            const logger = winston.createLogger({
-                level: logLevel.toLowerCase(),
-                format: winston.format.combine(addMdcDataFormat(), winston.format.timestamp(), winston.format.json()),
-                transports: [new winston.transports.Console()]
-            });
-            return logger;
-        }
-        catch (error) {
-            throw new ClientException.ClientException(`Error creating logger`, error, 500);
-        }
-    }
-}
-
-exports.ConsoleLoggerProvider = ConsoleLoggerProvider;
-//# sourceMappingURL=ConsoleLoggerProvider.cjs.map

package/dist/cjs/logger/factory/ConsoleLoggerProvider.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConsoleLoggerProvider.cjs","sources":["../../../../src/logger/factory/ConsoleLoggerProvider.ts"],"sourcesContent":["import winston from 'winston';\r\nimport { ClientException } from '../../exceptions/ClientException.js';\r\nimport { LoggingLevel } from '../../types/LoggingLevel.js';\r\nimport { MDC } from '../MDC.js';\r\nimport { LoggerProvider } from './LoggerProvider.js';\r\n\r\nconst addMdcDataFormat = winston.format((info) => {\r\n    info.path = MDC.get('path');\r\n    info.transaction_id = MDC.get('x-api-transaction-id');\r\n    return info;\r\n});\r\n\r\n/**\r\n * Implementation of the `LoggerProvider` interface that creates\r\n * a Winston logger configured to log to the console.\r\n */\r\nexport class ConsoleLoggerProvider implements LoggerProvider {\r\n\r\n    /**\r\n     * Creates a Winston logger instance configured for console logging.\r\n     * The logger includes MDC (Mapped Diagnostic Context) data, timestamps,\r\n     * and JSON formatting.\r\n     *\r\n     * @returns A promise that resolves to a Winston logger instance.\r\n     * @throws ClientException If an error occurs while creating the logger.\r\n     */\r\n    async createLogger(): Promise<winston.Logger> {\r\n        try {\r\n            const logLevel = LoggingLevel[(process.env.LOG_LEVEL || 'info').trim().toLowerCase()];\r\n            const logger = winston.createLogger({\r\n                level: logLevel.toLowerCase(),\r\n                format: winston.format.combine(\r\n                    addMdcDataFormat(),\r\n                    winston.format.timestamp(),\r\n                    winston.format.json()\r\n                ),\r\n                transports: [new winston.transports.Console()]\r\n            });\r\n            return logger;\r\n        } catch (error) {\r\n            throw new ClientException(`Error creating logger`, error, 500);\r\n        }\r\n    }\r\n}"],"names":["MDC","LoggingLevel","ClientException"],"mappings":";;;;;;;AAMA,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,KAAI;IAC7C,IAAI,CAAC,IAAI,GAAGA,OAAG,CAAC,GAAG,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,cAAc,GAAGA,OAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC;AACrD,IAAA,OAAO,IAAI;AACf,CAAC,CAAC;AAEF;;;AAGG;MACU,qBAAqB,CAAA;AAE9B;;;;;;;AAOG;AACH,IAAA,MAAM,YAAY,GAAA;AACd,QAAA,IAAI;YACA,MAAM,QAAQ,GAAGC,yBAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACrF,YAAA,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;AAChC,gBAAA,KAAK,EAAE,QAAQ,CAAC,WAAW,EAAE;gBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC1B,gBAAgB,EAAE,EAClB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACxB;gBACD,UAAU,EAAE,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE;AAChD,aAAA,CAAC;AACF,YAAA,OAAO,MAAM;;QACf,OAAO,KAAK,EAAE;YACZ,MAAM,IAAIC,+BAAe,CAAC,CAAA,qBAAA,CAAuB,EAAE,KAAK,EAAE,GAAG,CAAC;;;AAGzE;;;;"}

package/dist/cjs/logger/factory/LoggerFactory.cjs

@@ -1,31 +0,0 @@
-'use strict';
-
-/**
- * A factory class for managing logger instances.
- * Provides methods to retrieve and store loggers in a shared storage.
- */
-const LoggerStorage = new Map();
-class LoggerFactory {
-    /**
-     * Retrieves a logger instance by its name.
-     *
-     * @param loggerName The name of the logger to retrieve.
-     * @returns The logger instance if found, otherwise `undefined`.
-     */
-    static getLogger(loggerName) {
-        return LoggerStorage.get(loggerName);
-    }
-    /**
-     * Stores a logger instance with the specified name.
-     *
-     * @param loggerName The name to associate with the logger.
-     * @param logger The logger instance to store.
-     */
-    static setLogger(loggerName, logger) {
-        LoggerStorage.set(loggerName, logger);
-    }
-}
-
-exports.LoggerFactory = LoggerFactory;
-exports.LoggerStorage = LoggerStorage;
-//# sourceMappingURL=LoggerFactory.cjs.map

package/dist/cjs/logger/factory/LoggerFactory.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"LoggerFactory.cjs","sources":["../../../../src/logger/factory/LoggerFactory.ts"],"sourcesContent":["import winston, { Logger } from 'winston';\r\n\r\n/**\r\n * A factory class for managing logger instances.\r\n * Provides methods to retrieve and store loggers in a shared storage.\r\n */\r\nexport const LoggerStorage: Map<string, winston.Logger> = new Map<string, winston.Logger>();\r\n\r\nexport class LoggerFactory {\r\n\r\n    /**\r\n     * Retrieves a logger instance by its name.\r\n     * \r\n     * @param loggerName The name of the logger to retrieve.\r\n     * @returns The logger instance if found, otherwise `undefined`.\r\n     */\r\n    static getLogger(loggerName: string): winston.Logger | undefined {\r\n        return LoggerStorage.get(loggerName);\r\n    }\r\n\r\n    /**\r\n     * Stores a logger instance with the specified name.\r\n     * \r\n     * @param loggerName The name to associate with the logger.\r\n     * @param logger The logger instance to store.\r\n     */\r\n    static setLogger(loggerName: string, logger: Logger) {\r\n        LoggerStorage.set(loggerName, logger);\r\n    }\r\n}"],"names":[],"mappings":";;AAEA;;;AAGG;AACU,MAAA,aAAa,GAAgC,IAAI,GAAG;MAEpD,aAAa,CAAA;AAEtB;;;;;AAKG;IACH,OAAO,SAAS,CAAC,UAAkB,EAAA;AAC/B,QAAA,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC;;AAGxC;;;;;AAKG;AACH,IAAA,OAAO,SAAS,CAAC,UAAkB,EAAE,MAAc,EAAA;AAC/C,QAAA,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC;;AAE5C;;;;;"}

package/dist/esm/exceptions/NullPointerException.js

@@ -1,13 +0,0 @@
-import { BaseException } from './BaseException.js';
-
-/**
- * Exception thrown when an operation is attempted on a `null` or `undefined` value.
- */
-class NullPointerException extends BaseException {
-    constructor(message, cause) {
-        super(message, cause, 500);
-    }
-}
-
-export { NullPointerException };
-//# sourceMappingURL=NullPointerException.js.map

package/dist/esm/exceptions/NullPointerException.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"NullPointerException.js","sources":["../../../src/exceptions/NullPointerException.ts"],"sourcesContent":["import { BaseException } from \"./BaseException.js\";\r\n\r\n/**\r\n * Exception thrown when an operation is attempted on a `null` or `undefined` value.\r\n */\r\nexport class NullPointerException extends BaseException {\r\n\r\n    constructor(message: string, cause?: unknown) {\r\n        super(message, cause, 500);\r\n    }\r\n}\r\n\r\n"],"names":[],"mappings":";;AAEA;;AAEG;AACG,MAAO,oBAAqB,SAAQ,aAAa,CAAA;IAEnD,WAAY,CAAA,OAAe,EAAE,KAAe,EAAA;AACxC,QAAA,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC;;AAEjC;;;;"}

package/dist/esm/index.js

@@ -1,18 +0,0 @@
-export { BadRequestException } from './exceptions/BadRequestException.js';
-export { BaseException } from './exceptions/BaseException.js';
-export { ClientException } from './exceptions/ClientException.js';
-export { ForbiddenAccessException } from './exceptions/ForbiddenAccessException.js';
-export { HTTPException } from './exceptions/HTTPException.js';
-export { IllegalArgumentException } from './exceptions/IllegalArgumentException.js';
-export { UnauthorizedException } from './exceptions/UnauthorizedException.js';
-export { NullPointerException } from './exceptions/NullPointerException.js';
-export { ConverterException } from './exceptions/ConverterException.js';
-export { ConsoleLoggerProvider } from './logger/factory/ConsoleLoggerProvider.js';
-export { LoggerFactory, LoggerStorage } from './logger/factory/LoggerFactory.js';
-export { MDC } from './logger/MDC.js';
-export { JSONArray, JSONObject } from './types/JSONObject.js';
-export { LoggingLevel } from './types/LoggingLevel.js';
-export { SortOrder } from './types/SortOrder.js';
-export { BaseObject } from './beans/BaseObject.js';
-export { DateUtil } from './utils/date/DateUtil.js';
-//# sourceMappingURL=index.js.map

package/dist/esm/logger/MDC.js

@@ -1,75 +0,0 @@
-import { AsyncLocalStorage } from 'async_hooks';
-
-/**
- * Mapped Diagnostic Context (MDC) implementation using `AsyncLocalStorage`.
- * MDC allows associating contextual information (key-value pairs) with the
- * current execution context, which can be useful for logging and tracing.
- *
- * Methods:
- * - `get(key: string)`: Retrieves the value associated with the given key in the current context.
- * - `put(key: string, value: string)`: Adds or updates a key-value pair in the current context.
- * - `putAll(context: ContextMap)`: Adds or updates multiple key-value pairs in the current context.
- * - `clear()`: Clears all key-value pairs in the current context.
- * - `runWithContext(context: ContextMap, callback: () => T)`: Runs a callback function with the provided context.
- */
-class MDC {
-    static { this.storage = new AsyncLocalStorage(); }
-    /**
-     * Retrieves the value associated with the given key in the current context.
-     *
-     * @param key The key to retrieve the value for.
-     * @returns The value associated with the key, or `undefined` if not found.
-     */
-    static get(key) {
-        const store = MDC.storage.getStore();
-        return store ? store[key] : undefined;
-    }
-    /**
-     * Adds or updates a key-value pair in the current context.
-     *
-     * @param key The key to add or update.
-     * @param value The value to associate with the key.
-     */
-    static put(key, value) {
-        let store = MDC.storage.getStore();
-        if (!store) {
-            store = {};
-        }
-        store[key] = value;
-        MDC.storage.enterWith(store);
-    }
-    /**
-     * Adds or updates multiple key-value pairs in the current context.
-     *
-     * @param context An object containing key-value pairs to add or update.
-     */
-    static putAll(context) {
-        let store = MDC.storage.getStore();
-        if (!store) {
-            store = {};
-        }
-        Object.entries(context).forEach(([key, value]) => {
-            store[key] = value;
-        });
-        MDC.storage.enterWith(context);
-    }
-    /**
-     * Clears all key-value pairs in the current context.
-     */
-    static clear() {
-        MDC.storage.enterWith({});
-    }
-    /**
-     * Runs a callback function with the provided context.
-     *
-     * @param context The context to associate with the callback execution.
-     * @param callback The callback function to execute.
-     * @returns The result of the callback function.
-     */
-    static runWithContext(context, callback) {
-        return MDC.storage.run(context, callback);
-    }
-}
-
-export { MDC };
-//# sourceMappingURL=MDC.js.map

package/dist/esm/logger/MDC.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MDC.js","sources":["../../../src/logger/MDC.ts"],"sourcesContent":["import { AsyncLocalStorage } from 'async_hooks';\r\n\r\nexport interface ContextMap {\r\n    [key: string]: string;\r\n}\r\n\r\n/**\r\n * Mapped Diagnostic Context (MDC) implementation using `AsyncLocalStorage`.\r\n * MDC allows associating contextual information (key-value pairs) with the\r\n * current execution context, which can be useful for logging and tracing.\r\n *\r\n * Methods:\r\n * - `get(key: string)`: Retrieves the value associated with the given key in the current context.\r\n * - `put(key: string, value: string)`: Adds or updates a key-value pair in the current context.\r\n * - `putAll(context: ContextMap)`: Adds or updates multiple key-value pairs in the current context.\r\n * - `clear()`: Clears all key-value pairs in the current context.\r\n * - `runWithContext(context: ContextMap, callback: () => T)`: Runs a callback function with the provided context.\r\n */\r\nexport class MDC {\r\n    private static storage = new AsyncLocalStorage<ContextMap>();\r\n\r\n    /**\r\n     * Retrieves the value associated with the given key in the current context.\r\n     * \r\n     * @param key The key to retrieve the value for.\r\n     * @returns The value associated with the key, or `undefined` if not found.\r\n     */\r\n    static get(key: string): string | undefined {\r\n        const store = MDC.storage.getStore()!;\r\n        return store ? store[key] : undefined;\r\n    }\r\n\r\n    /**\r\n     * Adds or updates a key-value pair in the current context.\r\n     * \r\n     * @param key The key to add or update.\r\n     * @param value The value to associate with the key.\r\n     */\r\n    static put(key: string, value: string) {\r\n        let store: ContextMap | undefined = MDC.storage.getStore();\r\n        if (!store) {\r\n            store = {};\r\n        }\r\n        store[key] = value;\r\n        MDC.storage.enterWith(store);\r\n    }\r\n\r\n    /**\r\n     * Adds or updates multiple key-value pairs in the current context.\r\n     * \r\n     * @param context An object containing key-value pairs to add or update.\r\n     */\r\n    static putAll(context: ContextMap) {\r\n        let store: ContextMap | undefined = MDC.storage.getStore();\r\n        if (!store) {\r\n            store = {};\r\n        }\r\n        Object.entries(context).forEach(([key, value]) => {\r\n            store[key] = value;\r\n        });\r\n        MDC.storage.enterWith(context);\r\n    }\r\n\r\n    /**\r\n     * Clears all key-value pairs in the current context.\r\n     */\r\n    static clear() {\r\n        MDC.storage.enterWith({});\r\n    }\r\n\r\n    /**\r\n     * Runs a callback function with the provided context.\r\n     * \r\n     * @param context The context to associate with the callback execution.\r\n     * @param callback The callback function to execute.\r\n     * @returns The result of the callback function.\r\n     */\r\n    static runWithContext<T>(context: ContextMap, callback: () => T): T {\r\n        return MDC.storage.run(context, callback);\r\n    }\r\n}\r\n"],"names":[],"mappings":";;AAMA;;;;;;;;;;;AAWG;MACU,GAAG,CAAA;AACG,IAAA,SAAA,IAAA,CAAA,OAAO,GAAG,IAAI,iBAAiB,EAAc,CAAC;AAE7D;;;;;AAKG;IACH,OAAO,GAAG,CAAC,GAAW,EAAA;QAClB,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAG;AACrC,QAAA,OAAO,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,SAAS;;AAGzC;;;;;AAKG;AACH,IAAA,OAAO,GAAG,CAAC,GAAW,EAAE,KAAa,EAAA;QACjC,IAAI,KAAK,GAA2B,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC1D,IAAI,CAAC,KAAK,EAAE;YACR,KAAK,GAAG,EAAE;;AAEd,QAAA,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK;AAClB,QAAA,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC;;AAGhC;;;;AAIG;IACH,OAAO,MAAM,CAAC,OAAmB,EAAA;QAC7B,IAAI,KAAK,GAA2B,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE;QAC1D,IAAI,CAAC,KAAK,EAAE;YACR,KAAK,GAAG,EAAE;;AAEd,QAAA,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAI;AAC7C,YAAA,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK;AACtB,SAAC,CAAC;AACF,QAAA,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC;;AAGlC;;AAEG;AACH,IAAA,OAAO,KAAK,GAAA;AACR,QAAA,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;;AAG7B;;;;;;AAMG;AACH,IAAA,OAAO,cAAc,CAAI,OAAmB,EAAE,QAAiB,EAAA;QAC3D,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC;;;;;;"}

package/dist/esm/logger/factory/ConsoleLoggerProvider.js

@@ -1,41 +0,0 @@
-import winston from 'winston';
-import { ClientException } from '../../exceptions/ClientException.js';
-import { LoggingLevel } from '../../types/LoggingLevel.js';
-import { MDC } from '../MDC.js';
-
-const addMdcDataFormat = winston.format((info) => {
-    info.path = MDC.get('path');
-    info.transaction_id = MDC.get('x-api-transaction-id');
-    return info;
-});
-/**
- * Implementation of the `LoggerProvider` interface that creates
- * a Winston logger configured to log to the console.
- */
-class ConsoleLoggerProvider {
-    /**
-     * Creates a Winston logger instance configured for console logging.
-     * The logger includes MDC (Mapped Diagnostic Context) data, timestamps,
-     * and JSON formatting.
-     *
-     * @returns A promise that resolves to a Winston logger instance.
-     * @throws ClientException If an error occurs while creating the logger.
-     */
-    async createLogger() {
-        try {
-            const logLevel = LoggingLevel[(process.env.LOG_LEVEL || 'info').trim().toLowerCase()];
-            const logger = winston.createLogger({
-                level: logLevel.toLowerCase(),
-                format: winston.format.combine(addMdcDataFormat(), winston.format.timestamp(), winston.format.json()),
-                transports: [new winston.transports.Console()]
-            });
-            return logger;
-        }
-        catch (error) {
-            throw new ClientException(`Error creating logger`, error, 500);
-        }
-    }
-}
-
-export { ConsoleLoggerProvider };
-//# sourceMappingURL=ConsoleLoggerProvider.js.map

package/dist/esm/logger/factory/ConsoleLoggerProvider.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConsoleLoggerProvider.js","sources":["../../../../src/logger/factory/ConsoleLoggerProvider.ts"],"sourcesContent":["import winston from 'winston';\r\nimport { ClientException } from '../../exceptions/ClientException.js';\r\nimport { LoggingLevel } from '../../types/LoggingLevel.js';\r\nimport { MDC } from '../MDC.js';\r\nimport { LoggerProvider } from './LoggerProvider.js';\r\n\r\nconst addMdcDataFormat = winston.format((info) => {\r\n    info.path = MDC.get('path');\r\n    info.transaction_id = MDC.get('x-api-transaction-id');\r\n    return info;\r\n});\r\n\r\n/**\r\n * Implementation of the `LoggerProvider` interface that creates\r\n * a Winston logger configured to log to the console.\r\n */\r\nexport class ConsoleLoggerProvider implements LoggerProvider {\r\n\r\n    /**\r\n     * Creates a Winston logger instance configured for console logging.\r\n     * The logger includes MDC (Mapped Diagnostic Context) data, timestamps,\r\n     * and JSON formatting.\r\n     *\r\n     * @returns A promise that resolves to a Winston logger instance.\r\n     * @throws ClientException If an error occurs while creating the logger.\r\n     */\r\n    async createLogger(): Promise<winston.Logger> {\r\n        try {\r\n            const logLevel = LoggingLevel[(process.env.LOG_LEVEL || 'info').trim().toLowerCase()];\r\n            const logger = winston.createLogger({\r\n                level: logLevel.toLowerCase(),\r\n                format: winston.format.combine(\r\n                    addMdcDataFormat(),\r\n                    winston.format.timestamp(),\r\n                    winston.format.json()\r\n                ),\r\n                transports: [new winston.transports.Console()]\r\n            });\r\n            return logger;\r\n        } catch (error) {\r\n            throw new ClientException(`Error creating logger`, error, 500);\r\n        }\r\n    }\r\n}"],"names":[],"mappings":";;;;;AAMA,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,KAAI;IAC7C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;IAC3B,IAAI,CAAC,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,sBAAsB,CAAC;AACrD,IAAA,OAAO,IAAI;AACf,CAAC,CAAC;AAEF;;;AAGG;MACU,qBAAqB,CAAA;AAE9B;;;;;;;AAOG;AACH,IAAA,MAAM,YAAY,GAAA;AACd,QAAA,IAAI;YACA,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AACrF,YAAA,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;AAChC,gBAAA,KAAK,EAAE,QAAQ,CAAC,WAAW,EAAE;gBAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC1B,gBAAgB,EAAE,EAClB,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACxB;gBACD,UAAU,EAAE,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,EAAE;AAChD,aAAA,CAAC;AACF,YAAA,OAAO,MAAM;;QACf,OAAO,KAAK,EAAE;YACZ,MAAM,IAAI,eAAe,CAAC,CAAA,qBAAA,CAAuB,EAAE,KAAK,EAAE,GAAG,CAAC;;;AAGzE;;;;"}

package/dist/esm/logger/factory/LoggerFactory.js

@@ -1,28 +0,0 @@
-/**
- * A factory class for managing logger instances.
- * Provides methods to retrieve and store loggers in a shared storage.
- */
-const LoggerStorage = new Map();
-class LoggerFactory {
-    /**
-     * Retrieves a logger instance by its name.
-     *
-     * @param loggerName The name of the logger to retrieve.
-     * @returns The logger instance if found, otherwise `undefined`.
-     */
-    static getLogger(loggerName) {
-        return LoggerStorage.get(loggerName);
-    }
-    /**
-     * Stores a logger instance with the specified name.
-     *
-     * @param loggerName The name to associate with the logger.
-     * @param logger The logger instance to store.
-     */
-    static setLogger(loggerName, logger) {
-        LoggerStorage.set(loggerName, logger);
-    }
-}
-
-export { LoggerFactory, LoggerStorage };
-//# sourceMappingURL=LoggerFactory.js.map

package/dist/esm/logger/factory/LoggerFactory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LoggerFactory.js","sources":["../../../../src/logger/factory/LoggerFactory.ts"],"sourcesContent":["import winston, { Logger } from 'winston';\r\n\r\n/**\r\n * A factory class for managing logger instances.\r\n * Provides methods to retrieve and store loggers in a shared storage.\r\n */\r\nexport const LoggerStorage: Map<string, winston.Logger> = new Map<string, winston.Logger>();\r\n\r\nexport class LoggerFactory {\r\n\r\n    /**\r\n     * Retrieves a logger instance by its name.\r\n     * \r\n     * @param loggerName The name of the logger to retrieve.\r\n     * @returns The logger instance if found, otherwise `undefined`.\r\n     */\r\n    static getLogger(loggerName: string): winston.Logger | undefined {\r\n        return LoggerStorage.get(loggerName);\r\n    }\r\n\r\n    /**\r\n     * Stores a logger instance with the specified name.\r\n     * \r\n     * @param loggerName The name to associate with the logger.\r\n     * @param logger The logger instance to store.\r\n     */\r\n    static setLogger(loggerName: string, logger: Logger) {\r\n        LoggerStorage.set(loggerName, logger);\r\n    }\r\n}"],"names":[],"mappings":"AAEA;;;AAGG;AACU,MAAA,aAAa,GAAgC,IAAI,GAAG;MAEpD,aAAa,CAAA;AAEtB;;;;;AAKG;IACH,OAAO,SAAS,CAAC,UAAkB,EAAA;AAC/B,QAAA,OAAO,aAAa,CAAC,GAAG,CAAC,UAAU,CAAC;;AAGxC;;;;;AAKG;AACH,IAAA,OAAO,SAAS,CAAC,UAAkB,EAAE,MAAc,EAAA;AAC/C,QAAA,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC;;AAE5C;;;;"}

package/dist/types/exceptions/NullPointerException.d.ts

@@ -1,10 +0,0 @@
-import { BaseException } from './BaseException.js';
-
-/**
- * Exception thrown when an operation is attempted on a `null` or `undefined` value.
- */
-declare class NullPointerException extends BaseException {
-    constructor(message: string, cause?: unknown);
-}
-
-export { NullPointerException };