@gennext/lb-infra 0.1.4 → 0.2.0

package/dist/src/helpers/logger/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/helpers/logger/config.ts"],"names":[],"mappings":";;;;;;AAAA,uCAAqC;AACrC,0DAA6B;AAC7B,sDAA8B;AAC9B,qCAAmC;AAEnC,qCAA+B;AAC/B,6DAAgD;AAChD,2CAA0E;AAG1E,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,0BAA0B,IAAI,IAAI,CAAC;AAC1E,MAAM,aAAa,GAAG,YAAG,CAAC,gBAAgB,CAAC;AAC3C,MAAM,CAAC,GAAG,iBAAO,CAAC,MAAM,CAAC;AAEzB,MAAM,gBAAgB,GAAG,CAAC,CAAC,OAAO,CAChC,CAAC,CAAC,MAAM,EAAE,EACV,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,EACjC,CAAC,CAAC,SAAS,EAAE,EACb,CAAC,CAAC,KAAK,EAAE,EACT,CAAC,CAAC,KAAK,EAAE,EACT,CAAC,CAAC,QAAQ,EAAE,EACZ,CAAC,CAAC,MAAM,CACN,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,CAAC,GAAG,SAAS,KAAK,KAAK,KAAK,KAAK,KAAK,OAAO,EAAE,CACzF,EACD,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAC1B,CAAC;AAEK,MAAM,kBAAkB,GAAG,CAAC,IAQlC,EAAE,EAAE;IACH,MAAM,EACJ,SAAS,GAAG,gBAAgB,EAC5B,SAAS,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAC7F,SAAS,GAAG;QACV,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,MAAM;QACf,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;KACd,EACD,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,GACjD,GAAG,IAAI,CAAC;IAET,MAAM,gBAAgB,GAAG,IAAI,iBAAO,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IAC5E,MAAM,OAAO,GAAwB,CAAC,gBAAgB,CAAC,CAAC;IACxD,MAAM,SAAS,GAAwB,CAAC,gBAAgB,CAAC,CAAC;IAE1D,MAAM,gBAAgB,GAAG,CACvB,QAA4C,EAC5C,KAAa,EACb,WAAW,GAAG,KAAK,EACnB,EAAE;QACF,MAAM,CAAC,GAAG,IAAI,iBAAO,CAAC,UAAU,CAAC,eAAe,CAAC;YAC/C,SAAS,EAAE,IAAI;YACf,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,aAAa;YAC1B,QAAQ,EAAE,mBAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,QAAQ,CAAC,MAAM,IAAI,KAAK,aAAa,CAAC;YAC/E,KAAK;SACN,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,IAAI,WAAW,EAAE,CAAC;YAChB,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;QAClB,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;QACnB,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI;QAC7B,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACzB,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC;KACpB,EAAE,CAAC;QACX,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,0BAAc,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACnE,IAAI,CAAC,EAAE,CAAC;YACL,GAA2B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED,iBAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IAE7B,OAAO,iBAAO,CAAC,YAAY,CAAC;QAC1B,MAAM,EAAE,SAAS;QACjB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,KAAK;QAClB,UAAU,EAAE,OAAO;QACnB,iBAAiB,EAAE,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC,CAAC;AA1EW,QAAA,kBAAkB,sBA0E7B;AAEF,6CAA6C;AAChC,QAAA,iBAAiB,GAAG,IAAA,0BAAkB,EAAC;IAClD,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE;YAC3D,KAAK,EAAE;gBACL,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC/B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;gBAC3C,IAAI,EAAE,IAAA,mBAAG,EAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;gBAChD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B;gBAC7C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;aACvF;SACF;QACD,KAAK,EAAE;YACL,IAAI,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,aAAa,EAAE;YAC3D,KAAK,EAAE;gBACL,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;gBAC/B,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB;gBAC3C,IAAI,EAAE,IAAA,mBAAG,EAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;gBAChD,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,0BAA0B;gBAC7C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE;aACvF;SACF;KACF;CACF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAEjE,QAAA,yBAAyB,GAAG;IACvC,cAAc,EAAE;QACd;YACE,MAAM,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,iBAAiB,EAAE,CAAC,EAAE;YAC/C,MAAM,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;SAC1F;KACF;CACF,CAAC;AAEK,MAAM,iBAAiB,GAAG,CAAC,IAAS,EAAE,OAAa,EAAO,EAAE,CACjE,IAAA,oBAAS,EAAC,IAAI,EAAE,OAAO,IAAI,iCAAyB,CAAC,CAAC;AAD3C,QAAA,iBAAiB,qBAC0B;AAExD,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,MAAM,cAAc,GAAyB;IAC3C,sBAAsB,EAAE,gBAAgB;IACxC,eAAe,EAAE,IAAI;IACrB,wBAAwB,EAAE,KAAK;CAChC,CAAC;AAEF,MAAa,0BAA0B;aACtB,WAAM,GAAyB,EAAE,GAAG,cAAc,EAAE,CAAC;IAEpE,MAAM,CAAC,SAAS,CAAC,MAAqC;QACpD,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,IAAI,CAAC,MAAM;YACd,GAAG,MAAM;YACT,GAAG,CAAC,MAAM,CAAC,kBAAkB,IAAI;gBAC/B,kBAAkB,EAAE;oBAClB,eAAe,EAAE,iCAAyB;oBAC1C,GAAG,MAAM,CAAC,kBAAkB;iBAC7B;aACF,CAAC;SACH,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,4BAA4B;QACjC,OAAO,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,IAAI,iCAAyB,CAAC;IACtF,CAAC;IAED,MAAM,CAAC,yBAAyB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,sBAAsB,IAAI,gBAAgB,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,kBAAkB;QACvB,OAAO,IAAI,CAAC,MAAM,CAAC,eAAe,IAAI,IAAI,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,2BAA2B;QAChC,OAAO,IAAI,CAAC,MAAM,CAAC,wBAAwB,IAAI,KAAK,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,QAA0C;QAClE,MAAM,QAAQ,GAA2B;YACvC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,eAAe;YAC5C,wBAAwB,EAAE,IAAI,CAAC,MAAM,CAAC,wBAAwB;YAC9D,iBAAiB,EAAE,IAAI;YACvB,mBAAmB,EAAE,IAAI;YACzB,iBAAiB,EAAE;gBACjB,eAAe,EACb,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,eAAe,IAAI,iCAAyB;aAC/E;YACD,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,sBAAsB;SACpD,CAAC;QAEF,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO;YACL,GAAG,QAAQ;YACX,GAAG,QAAQ;YACX,iBAAiB,EAAE,EAAE,GAAG,QAAQ,CAAC,iBAAiB,EAAE,GAAG,QAAQ,CAAC,iBAAiB,EAAE;SACpF,CAAC;IACJ,CAAC;;AA1DH,gEA2DC"}

package/dist/src/helpers/logger/factory.d.ts

@@ -0,0 +1,20 @@
+import { HttpAccessLogger } from './http';
+import { Logger } from './logger';
+import type { IEnhancedLoggerOptions, ILoggerFactoryConfig } from './types';
+export interface IEnhancedLogger {
+    application: Logger;
+    http: HttpAccessLogger | null;
+}
+export declare class LoggerFactory {
+    private static httpLoggers;
+    static config(config: Partial<ILoggerFactoryConfig>): void;
+    static getConfig(): ILoggerFactoryConfig;
+    /** Logger cơ bản với scope prefix. */
+    static getLogger(scopes: string[], base?: Logger): Logger;
+    /** Logger + optional HttpAccessLogger. */
+    static getEnhancedLogger(scopes: string[], httpOptions?: Partial<IEnhancedLoggerOptions>, base?: Logger): IEnhancedLogger;
+    /** Express/Hono-compatible middleware. */
+    static createHttpMiddleware(scopes: string[], options?: Partial<IEnhancedLoggerOptions>): (req: import("../..").AnyType, res: import("../..").AnyType, next: () => void) => void;
+    static maskData(data: any, customOptions?: any): any;
+}
+//# sourceMappingURL=factory.d.ts.map

package/dist/src/helpers/logger/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/helpers/logger/factory.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC/B;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,WAAW,CAAuC;IAEjE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,IAAI;IAI1D,MAAM,CAAC,SAAS,IAAI,oBAAoB;IAIxC,sCAAsC;IACtC,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM;IAMzD,0CAA0C;IAC1C,MAAM,CAAC,iBAAiB,CACtB,MAAM,EAAE,MAAM,EAAE,EAChB,WAAW,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,EAC7C,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe;IAmBlB,0CAA0C;IAC1C,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC;IAevF,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,GAAG,GAAG,GAAG;CAMrD"}

package/dist/src/helpers/logger/factory.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoggerFactory = void 0;
+const maskdata_1 = require("maskdata");
+const config_1 = require("./config");
+const http_1 = require("./http");
+const logger_1 = require("./logger");
+class LoggerFactory {
+    static { this.httpLoggers = new Map(); }
+    static config(config) {
+        config_1.LoggerFactoryConfigManager.setConfig(config);
+    }
+    static getConfig() {
+        return config_1.LoggerFactoryConfigManager.getConfig();
+    }
+    /** Logger cơ bản với scope prefix. */
+    static getLogger(scopes, base) {
+        const logger = base ?? new logger_1.Logger();
+        logger.withScope(scopes.join('-'));
+        return logger;
+    }
+    /** Logger + optional HttpAccessLogger. */
+    static getEnhancedLogger(scopes, httpOptions, base) {
+        const opts = config_1.LoggerFactoryConfigManager.mergeLoggerOptions(httpOptions);
+        const logger = base ?? new logger_1.Logger();
+        logger.withScope(scopes.join('-'));
+        let http = null;
+        if (opts.enableAccessLog) {
+            const key = scopes.join('-');
+            if (!this.httpLoggers.has(key)) {
+                http = new http_1.HttpAccessLogger(logger, opts);
+                this.httpLoggers.set(key, http);
+            }
+            else {
+                http = this.httpLoggers.get(key);
+            }
+        }
+        return { application: logger, http };
+    }
+    /** Express/Hono-compatible middleware. */
+    static createHttpMiddleware(scopes, options) {
+        const opts = config_1.LoggerFactoryConfigManager.mergeLoggerOptions(options);
+        const key = scopes.join('-');
+        let httpLogger = this.httpLoggers.get(key) ?? null;
+        if (!httpLogger) {
+            const logger = new logger_1.Logger();
+            logger.withScope(key);
+            httpLogger = new http_1.HttpAccessLogger(logger, opts);
+            this.httpLoggers.set(key, httpLogger);
+        }
+        return http_1.HttpAccessLogger.createMiddleware(httpLogger);
+    }
+    static maskData(data, customOptions) {
+        return (0, maskdata_1.maskJSON2)(data, customOptions ?? config_1.LoggerFactoryConfigManager.getDefaultDataMaskingOptions());
+    }
+}
+exports.LoggerFactory = LoggerFactory;
+//# sourceMappingURL=factory.js.map

package/dist/src/helpers/logger/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/helpers/logger/factory.ts"],"names":[],"mappings":";;;AAAA,uCAAqC;AAErC,qCAAsD;AACtD,iCAA0C;AAC1C,qCAAkC;AAQlC,MAAa,aAAa;aACT,gBAAW,GAAG,IAAI,GAAG,EAA4B,CAAC;IAEjE,MAAM,CAAC,MAAM,CAAC,MAAqC;QACjD,mCAA0B,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,CAAC,SAAS;QACd,OAAO,mCAA0B,CAAC,SAAS,EAAE,CAAC;IAChD,CAAC;IAED,sCAAsC;IACtC,MAAM,CAAC,SAAS,CAAC,MAAgB,EAAE,IAAa;QAC9C,MAAM,MAAM,GAAG,IAAI,IAAI,IAAI,eAAM,EAAE,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,iBAAiB,CACtB,MAAgB,EAChB,WAA6C,EAC7C,IAAa;QAEb,MAAM,IAAI,GAAG,mCAA0B,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,IAAI,IAAI,eAAM,EAAE,CAAC;QACpC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAEnC,IAAI,IAAI,GAA4B,IAAI,CAAC;QACzC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC/B,IAAI,GAAG,IAAI,uBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;gBAC1C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAClC,CAAC;iBAAM,CAAC;gBACN,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;YACpC,CAAC;QACH,CAAC;QAED,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACvC,CAAC;IAED,0CAA0C;IAC1C,MAAM,CAAC,oBAAoB,CAAC,MAAgB,EAAE,OAAyC;QACrF,MAAM,IAAI,GAAG,mCAA0B,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACpE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE7B,IAAI,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QACnD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,eAAM,EAAE,CAAC;YAC5B,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACtB,UAAU,GAAG,IAAI,uBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAChD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,uBAAgB,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,QAAQ,CAAC,IAAS,EAAE,aAAmB;QAC5C,OAAO,IAAA,oBAAS,EACd,IAAI,EACJ,aAAa,IAAI,mCAA0B,CAAC,4BAA4B,EAAE,CAC3E,CAAC;IACJ,CAAC;;AA/DH,sCAgEC"}

package/dist/src/helpers/logger/http.d.ts

@@ -0,0 +1,38 @@
+import type { AnyType } from '@/common';
+import { Logger } from './logger';
+import type { IAccessLogEntry, IEnhancedLoggerOptions, IPerformanceMetrics, IRequestContext, TLogLevel } from './types';
+export declare const RequestContext: {
+    set(context: Partial<IRequestContext> & {
+        requestId: string;
+    }): void;
+    update(partial: Partial<IRequestContext>): void;
+    run<T>(context: Partial<IRequestContext> & {
+        requestId: string;
+    }, fn: () => T): T;
+    get(): IRequestContext | undefined;
+    getRequestId(): string;
+    getUserId(): string | undefined;
+    getClientIP(): string | undefined;
+    getUserAgent(): string | undefined;
+    getStartTime(): number | undefined;
+    generateRequestId(existing?: string | string[]): string;
+};
+export declare const getClientIP: (req: AnyType, opts?: {
+    trustProxy?: boolean;
+    ipHeaders?: string[];
+}) => string | undefined;
+export declare class HttpAccessLogger {
+    private logger;
+    private opts;
+    constructor(logger: Logger, options?: IEnhancedLoggerOptions);
+    logAccess(entry: IAccessLogEntry): void;
+    logPerformance(metrics: IPerformanceMetrics): void;
+    logRequestData(data: AnyType, level: TLogLevel): void;
+    static createMiddleware(httpLogger: HttpAccessLogger): (req: AnyType, res: AnyType, next: () => void) => void;
+    private buildEntry;
+    private formatAccess;
+    private formatPerformance;
+    private emit;
+    private sanitize;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/src/helpers/logger/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../../src/helpers/logger/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACnB,eAAe,EACf,SAAS,EACV,MAAM,SAAS,CAAC;AAQjB,eAAO,MAAM,cAAc;iBACZ,OAAO,CAAC,eAAe,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;oBAKpD,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;QAO3C,CAAC,WAAW,OAAO,CAAC,eAAe,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,MAAM,MAAM,CAAC,GAAG,CAAC;WAK1E,eAAe,GAAG,SAAS;oBAGlB,MAAM;iBAGT,MAAM,GAAG,SAAS;mBAGhB,MAAM,GAAG,SAAS;oBAGjB,MAAM,GAAG,SAAS;oBAGlB,MAAM,GAAG,SAAS;iCAIL,MAAM,GAAG,MAAM,EAAE,GAAG,MAAM;CAIxD,CAAC;AAqBF,eAAO,MAAM,WAAW,GACtB,KAAK,OAAO,EACZ,OAAO;IAAE,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,KACpD,MAAM,GAAG,SAgBX,CAAC;AAMF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAMqE;gBAErE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B;IAahE,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IAOvC,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI;IAOlD,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAiBrD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,IAC1C,KAAK,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,MAAM,IAAI;IAiDtD,OAAO,CAAC,UAAU;IA6BlB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,IAAI;IAIZ,OAAO,CAAC,QAAQ;CAajB"}

package/dist/src/helpers/logger/http.js

@@ -0,0 +1,217 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpAccessLogger = exports.getClientIP = exports.RequestContext = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const utilities_1 = require("@/utilities");
+const config_1 = require("./config");
+// ---------------------------------------------------------------------------
+// Request Context (AsyncLocalStorage)
+// ---------------------------------------------------------------------------
+const contextStorage = new node_async_hooks_1.AsyncLocalStorage();
+exports.RequestContext = {
+    set(context) {
+        const current = contextStorage.getStore() ?? {};
+        contextStorage.enterWith({ ...current, ...context });
+    },
+    update(partial) {
+        const current = contextStorage.getStore();
+        if (current) {
+            contextStorage.enterWith({ ...current, ...partial });
+        }
+    },
+    run(context, fn) {
+        const current = contextStorage.getStore() ?? {};
+        return contextStorage.run({ ...current, ...context }, fn);
+    },
+    get() {
+        return contextStorage.getStore();
+    },
+    getRequestId() {
+        return contextStorage.getStore()?.requestId ?? 'unknown';
+    },
+    getUserId() {
+        return contextStorage.getStore()?.userId;
+    },
+    getClientIP() {
+        return contextStorage.getStore()?.clientIP;
+    },
+    getUserAgent() {
+        return contextStorage.getStore()?.userAgent;
+    },
+    getStartTime() {
+        return contextStorage.getStore()?.startTime;
+    },
+    generateRequestId(existing) {
+        const id = Array.isArray(existing) ? existing[0] : existing;
+        return (0, utilities_1.genHTTPRequestId)(id);
+    },
+};
+// ---------------------------------------------------------------------------
+// Client IP Detection
+// ---------------------------------------------------------------------------
+const DEFAULT_IP_HEADERS = ['x-forwarded-for', 'x-real-ip', 'cf-connecting-ip', 'x-client-ip'];
+const IPV4_REGEX = /^(?:(?:25[0-5]|2[0-4]\d|[01]?\d\d?)\.){3}(?:25[0-5]|2[0-4]\d|[01]?\d\d?)$/;
+const IPV6_REGEX = /^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$/;
+const isValidIP = (ip) => IPV4_REGEX.test(ip) || IPV6_REGEX.test(ip);
+const extractIPFromHeader = (header) => {
+    if (!header) {
+        return undefined;
+    }
+    const value = Array.isArray(header) ? header[0] : header;
+    const ip = value?.split(',')[0]?.trim();
+    return ip && isValidIP(ip) ? ip : undefined;
+};
+const getClientIP = (req, opts) => {
+    const socketAddr = req.connection?.remoteAddress ?? req.socket?.remoteAddress ?? req.ip ?? req.remoteAddress;
+    if (!opts?.trustProxy) {
+        return socketAddr;
+    }
+    for (const header of opts?.ipHeaders ?? DEFAULT_IP_HEADERS) {
+        const ip = extractIPFromHeader(req.headers?.[header]);
+        if (ip) {
+            return ip;
+        }
+    }
+    return socketAddr;
+};
+exports.getClientIP = getClientIP;
+// ---------------------------------------------------------------------------
+// HttpAccessLogger
+// ---------------------------------------------------------------------------
+class HttpAccessLogger {
+    constructor(logger, options = {}) {
+        this.logger = logger;
+        this.opts = {
+            enableAccessLog: options.enableAccessLog ?? true,
+            enablePerformanceMetrics: options.enablePerformanceMetrics ?? true,
+            enableDataMasking: options.enableDataMasking ?? true,
+            sanitizeRequestData: options.sanitizeRequestData ?? true,
+            dataMaskingConfig: options.dataMaskingConfig,
+            trustProxy: options.trustProxy,
+            ipHeaders: options.ipHeaders,
+        };
+    }
+    logAccess(entry) {
+        if (!this.opts.enableAccessLog) {
+            return;
+        }
+        this.emit(entry.level, this.formatAccess(entry), { type: 'access', ...entry });
+    }
+    logPerformance(metrics) {
+        if (!this.opts.enablePerformanceMetrics) {
+            return;
+        }
+        this.emit('info', this.formatPerformance(metrics), { type: 'performance', ...metrics });
+    }
+    logRequestData(data, level) {
+        let sanitized = this.opts.enableDataMasking && this.opts.dataMaskingConfig?.useMaskDataLib
+            ? (0, config_1.maskSensitiveData)(data, this.opts.dataMaskingConfig.maskDataOptions)
+            : data;
+        if (this.opts.sanitizeRequestData) {
+            sanitized = this.sanitize(sanitized);
+        }
+        this.emit(level, 'Request data', {
+            type: 'request_data',
+            data: sanitized,
+            requestId: exports.RequestContext.getRequestId(),
+        });
+    }
+    static createMiddleware(httpLogger) {
+        return (req, res, next) => {
+            const startTime = Date.now();
+            const rawId = req.headers['x-request-id'] ?? req.headers['x-correlation-id'];
+            const requestId = exports.RequestContext.generateRequestId(rawId);
+            req.headers['x-request-id'] = requestId;
+            res.setHeader('x-request-id', requestId);
+            exports.RequestContext.set({
+                requestId,
+                clientIP: (0, exports.getClientIP)(req, {
+                    trustProxy: httpLogger.opts.trustProxy,
+                    ipHeaders: httpLogger.opts.ipHeaders,
+                }),
+                userAgent: req.headers['user-agent'],
+                startTime,
+            });
+            httpLogger.logRequestData({
+                method: req.method,
+                url: req.url,
+                headers: req.headers,
+                query: req.query,
+                body: req.body,
+            }, 'info');
+            const originalSend = res.send;
+            res.send = function (data) {
+                const entry = httpLogger.buildEntry({ request: req, response: res, startTime });
+                setImmediate(() => {
+                    httpLogger.logAccess(entry);
+                    httpLogger.logPerformance({
+                        duration: Date.now() - startTime,
+                        memoryUsage: process.memoryUsage(),
+                        cpuUsage: process.cpuUsage(),
+                        timestamp: new Date().toISOString(),
+                        requestId,
+                    });
+                });
+                return originalSend.call(this, data);
+            };
+            next();
+        };
+    }
+    buildEntry(opts) {
+        const { request, response, startTime, requestId } = opts;
+        const responseTime = Array.isArray(startTime)
+            ? (process.hrtime(startTime)[0] * 1e9 + process.hrtime(startTime)[1]) / 1e6
+            : Date.now() - startTime;
+        return {
+            timestamp: new Date().toISOString(),
+            requestId: requestId ?? exports.RequestContext.getRequestId(),
+            method: request.method.toUpperCase(),
+            url: request.url,
+            statusCode: response.statusCode,
+            responseTime,
+            userAgent: request.headers?.['user-agent'],
+            clientIP: exports.RequestContext.getClientIP() ??
+                (0, exports.getClientIP)(request, { trustProxy: this.opts.trustProxy, ipHeaders: this.opts.ipHeaders }),
+            contentLength: response.get?.('content-length') ?? response.getHeader?.('content-length'),
+            referer: request.headers?.['referer'],
+            userId: exports.RequestContext.getUserId(),
+            level: response.statusCode >= 400 ? 'warn' : 'info',
+        };
+    }
+    formatAccess(entry) {
+        const parts = [
+            entry.method,
+            entry.url,
+            entry.statusCode,
+            `${entry.responseTime}ms`,
+        ];
+        if (entry.clientIP) {
+            parts.push(`IP:${entry.clientIP}`);
+        }
+        if (entry.userId) {
+            parts.push(`User:${entry.userId}`);
+        }
+        return parts.join(' | ');
+    }
+    formatPerformance(m) {
+        return `Performance | Duration: ${m.duration}ms | Memory: ${m.memoryUsage ? JSON.stringify(m.memoryUsage) : '-'} | CPU: ${m.cpuUsage ? JSON.stringify(m.cpuUsage) : '-'}`;
+    }
+    emit(level, message, meta) {
+        this.logger.log(level, message, meta);
+    }
+    sanitize(data) {
+        if (typeof data !== 'object' || data === null) {
+            return data;
+        }
+        const EXCLUDE = ['authorization', 'cookie', 'session', 'csrf'];
+        const out = {};
+        for (const [k, v] of Object.entries(data)) {
+            if (!EXCLUDE.some(f => k.toLowerCase().includes(f))) {
+                out[k] = typeof v === 'object' && v !== null ? this.sanitize(v) : v;
+            }
+        }
+        return out;
+    }
+}
+exports.HttpAccessLogger = HttpAccessLogger;
+//# sourceMappingURL=http.js.map

package/dist/src/helpers/logger/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../../src/helpers/logger/http.ts"],"names":[],"mappings":"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"}

package/dist/src/helpers/logger/index.d.ts

@@ -0,0 +1,7 @@
+export * from './config';
+export * from './factory';
+export * from './http';
+export * from './logger';
+export * from './transport';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/helpers/logger/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/helpers/logger/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}

package/dist/src/helpers/logger/index.js

@@ -0,0 +1,23 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config"), exports);
+__exportStar(require("./factory"), exports);
+__exportStar(require("./http"), exports);
+__exportStar(require("./logger"), exports);
+__exportStar(require("./transport"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/src/helpers/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/logger/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,4CAA0B;AAC1B,yCAAuB;AACvB,2CAAyB;AACzB,8CAA4B;AAC5B,0CAAwB"}

package/dist/src/helpers/logger/logger.d.ts

@@ -0,0 +1,28 @@
+import winston from 'winston';
+import type { AnyType } from '@/common';
+import type { TLogLevel } from './types';
+export declare class Logger {
+    private readonly env;
+    private scopes;
+    private customLogger?;
+    private children;
+    constructor(opts?: {
+        scope?: string;
+        customLogger?: winston.Logger;
+    });
+    getCustomLogger(): winston.Logger | undefined;
+    private getLogger;
+    private buildPrefix;
+    withScope(scope: string): this;
+    /**
+     * Trả về child Logger có scope "ParentScope-method".
+     * @example this.logger.for('getAll').info('Fetching...')
+     */
+    for(method: string): Logger;
+    log(level: TLogLevel, message: string, ...args: AnyType[]): void;
+    debug(message: string, ...args: AnyType[]): void;
+    info(message: string, ...args: AnyType[]): void;
+    warn(message: string, ...args: AnyType[]): void;
+    error(message: string, ...args: AnyType[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/helpers/logger/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../../src/helpers/logger/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAGxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAkBzC,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;IAC5C,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,QAAQ,CAA6B;gBAEjC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAC,MAAM,CAAA;KAAE;IAOpE,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS;IAI7C,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,WAAW;IAKnB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B;;;OAGG;IACH,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAU3B,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAQzD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAUzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAGxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;IAGxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE;CAG1C"}

package/dist/src/helpers/logger/logger.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const utilities_1 = require("@/utilities");
+const config_1 = require("./config");
+// ---------------------------------------------------------------------------
+// Environments cho phép log debug
+// ---------------------------------------------------------------------------
+const LOG_ENVIRONMENTS = new Set([
+    'local',
+    'development',
+    'alpha',
+    'beta',
+    'staging',
+    ...String(process.env.APP_ENV_EXTRA_LOG_ENVS)
+        .split(',')
+        .map(s => s.trim())
+        .filter(Boolean),
+]);
+class Logger {
+    constructor(opts) {
+        this.env = process.env.NODE_ENV;
+        this.scopes = [];
+        this.children = new Map();
+        this.customLogger = opts?.customLogger;
+        if (opts?.scope) {
+            this.scopes.push(opts.scope);
+        }
+    }
+    getCustomLogger() {
+        return this.customLogger;
+    }
+    getLogger() {
+        return this.customLogger ?? config_1.applicationLogger;
+    }
+    buildPrefix(message) {
+        const prefix = this.scopes.filter(s => !utilities_1.Lodash.isEmpty(s)).join('-');
+        return prefix ? `[${prefix}] ${message}` : message;
+    }
+    withScope(scope) {
+        this.scopes.push(scope);
+        return this;
+    }
+    /**
+     * Trả về child Logger có scope "ParentScope-method".
+     * @example this.logger.for('getAll').info('Fetching...')
+     */
+    for(method) {
+        if (!this.children.has(method)) {
+            const child = new Logger({ customLogger: this.customLogger });
+            this.scopes.forEach(s => child.withScope(s));
+            child.withScope(method);
+            this.children.set(method, child);
+        }
+        return this.children.get(method);
+    }
+    log(level, message, ...args) {
+        const logger = this.getLogger();
+        if (!logger) {
+            throw (0, utilities_1.getError)({ message: `[Log] Level: ${level} | Invalid logger instance!` });
+        }
+        logger.log(level, this.buildPrefix(message), ...args);
+    }
+    debug(message, ...args) {
+        if (this.env && !LOG_ENVIRONMENTS.has(this.env)) {
+            return;
+        }
+        if (!process.env.DEBUG) {
+            return;
+        }
+        this.log('debug', message, ...args);
+    }
+    info(message, ...args) {
+        this.log('info', message, ...args);
+    }
+    warn(message, ...args) {
+        this.log('warn', message, ...args);
+    }
+    error(message, ...args) {
+        this.log('error', message, ...args);
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/src/helpers/logger/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../../src/helpers/logger/logger.ts"],"names":[],"mappings":"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"}

package/dist/{helpers/logger/transports/dgram.transport.d.ts → src/helpers/logger/transport.d.ts}

@@ -4,7 +4,7 @@ export interface IDgramTransportOptions extends Transport.TransportStreamOptions
     label: string;
     host: string;
     port: number;
-    levels: Array<string>;
+    levels: string[];
     socketOptions: dgram.SocketOptions;
 }
 export declare class DgramTransport extends Transport {
@@ -13,10 +13,10 @@ export declare class DgramTransport extends Transport {
     private port;
     private triggerLevels;
     private socketOptions;
+    private client;
     constructor(opts: IDgramTransportOptions);
     static fromPartial(opts?: Partial<IDgramTransportOptions>): DgramTransport | null;
     private establish;
-    private formatMessage;
     log(opts: {
         level: string;
         message: string;
@@ -25,4 +25,4 @@ export declare class DgramTransport extends Transport {
         [extra: symbol]: any;
     }, callback: Function): void;
 }
-//# sourceMappingURL=dgram.transport.d.ts.map
+//# sourceMappingURL=transport.d.ts.map

package/dist/src/helpers/logger/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../src/helpers/logger/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAC;AAC/B,OAAO,SAAS,MAAM,mBAAmB,CAAC;AAK1C,MAAM,WAAW,sBAAuB,SAAQ,SAAS,CAAC,sBAAsB;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,EAAE,KAAK,CAAC,aAAa,CAAC;CACpC;AAED,qBAAa,cAAe,SAAQ,SAAS;IAC3C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,aAAa,CAAc;IACnC,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,MAAM,CAAuB;gBAEzB,IAAI,EAAE,sBAAsB;IAWxC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,cAAc,GAAG,IAAI;IAajF,OAAO,CAAC,SAAS;IAYR,GAAG,CACV,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAAC;KACtB,EACD,QAAQ,EAAE,QAAQ;CA4BrB"}