@eqxjs/nest-logger 3.1.0-beta.9 → 3.1.1-beta.0

package/dist/core/loggers/custom.logger.d.ts

@@ -0,0 +1,127 @@
+import { LoggerService } from '@nestjs/common';
+/**
+ * CustomLogger - Basic logger implementation with standard log levels.
+ *
+ * Implements NestJS LoggerService interface and uses Winston for actual logging.
+ * Provides simple logging methods (log, error, warn, debug, verbose) for basic use cases.
+ *
+ * For advanced structured logging with OpenTelemetry integration, use BaseAppLogger or AppLogger.
+ *
+ * @example
+ * ```typescript
+ * const logger = new CustomLogger('MyService');
+ * logger.log('Application started');
+ * logger.error('An error occurred', 'Error stack trace');
+ * logger.warn('Warning message');
+ * logger.debug('Debug information');
+ * ```
+ *
+ * @implements {LoggerService}
+ */
+export declare class CustomLogger implements LoggerService {
+    protected appName: string;
+    private logger;
+    protected readonly cachedHostname: string;
+    constructor();
+    constructor(appName?: string);
+    /**
+     * Formats a Date object to ISO 8601 string with UTC+7 timezone offset.
+     *
+     * @param date - The date to format
+     * @returns ISO 8601 formatted string (e.g., "2026-01-12T10:00:00.000Z")
+     * @protected
+     */
+    protected dateFormat(date: Date): string;
+    /**
+     * Initializes a LoggerDto with basic log information.
+     *
+     * Creates a structured log entry from the provided message and parameters.
+     * Handles message formatting, truncation, and sets default values for required fields.
+     *
+     * @param level - Log level
+     * @param message - Log message (any type)
+     * @param optionalParams - Additional parameters (last parameter becomes componentName)
+     * @returns Initialized LoggerDto object
+     * @private
+     */
+    private initializeLogger;
+    /**
+     * Logs an informational message.
+     * Alias for standard console.log behavior in NestJS applications.
+     *
+     * @param message - Message to log (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.log('User created successfully');
+     * logger.log('Request processed', 'UserController');
+     * logger.log({ userId: 123, action: 'create' });
+     * ```
+     */
+    log(message: any, ...optionalParams: any[]): void;
+    /**
+     * Logs an error message.
+     * Use for logging error conditions and failures.
+     *
+     * @param message - Error message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.error('Database connection failed');
+     * logger.error('Query error', 'DatabaseService');
+     * logger.error(new Error('Something went wrong'));
+     * ```
+     */
+    error(message: any, ...optionalParams: any[]): void;
+    /**
+     * Logs a warning message.
+     * Use for potentially harmful situations or deprecated functionality.
+     *
+     * @param message - Warning message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.warn('API rate limit approaching');
+     * logger.warn('Using deprecated method', 'PaymentService');
+     * ```
+     */
+    warn(message: any, ...optionalParams: any[]): void;
+    /**
+     * Logs a debug message.
+     * Use for detailed diagnostic information during development.
+     *
+     * @param message - Debug message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.debug('Processing request payload');
+     * logger.debug({ requestId: '123', payload: data }, 'RequestHandler');
+     * ```
+     */
+    debug(message: any, ...optionalParams: any[]): void;
+    /**
+     * Logs a verbose message.
+     * Use for the most detailed information, typically only needed for deep debugging.
+     *
+     * @param message - Verbose message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.verbose('Internal state dump');
+     * logger.verbose({ state: internalState }, 'StateMachine');
+     * ```
+     */
+    verbose(message: any, ...optionalParams: any[]): void;
+    /**
+     * Flushes the log message to Winston logger.
+     *
+     * @param message - Message to be logged
+     * @protected
+     */
+    protected flushLog(message: any): void;
+}

package/dist/core/loggers/custom.logger.js

@@ -0,0 +1,260 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomLogger = void 0;
+const common_1 = require("@nestjs/common");
+const moment_1 = __importDefault(require("moment"));
+const os = __importStar(require("os"));
+const winston = __importStar(require("winston"));
+const logger_dto_1 = require("../../models/logger.dto");
+const logger_constants_1 = require("../../constants/logger.constants");
+const message_formatter_helper_1 = require("../../helpers/message-formatter.helper");
+const logUtil = __importStar(require("../../helpers/log.helper"));
+/**
+ * CustomLogger - Basic logger implementation with standard log levels.
+ *
+ * Implements NestJS LoggerService interface and uses Winston for actual logging.
+ * Provides simple logging methods (log, error, warn, debug, verbose) for basic use cases.
+ *
+ * For advanced structured logging with OpenTelemetry integration, use BaseAppLogger or AppLogger.
+ *
+ * @example
+ * ```typescript
+ * const logger = new CustomLogger('MyService');
+ * logger.log('Application started');
+ * logger.error('An error occurred', 'Error stack trace');
+ * logger.warn('Warning message');
+ * logger.debug('Debug information');
+ * ```
+ *
+ * @implements {LoggerService}
+ */
+let CustomLogger = class CustomLogger {
+    appName;
+    logger;
+    cachedHostname;
+    /**
+     * Creates a new CustomLogger instance.
+     *
+     * Initializes Winston logger with console transport and caches the hostname
+     * for performance optimization.
+     *
+     * @param appName - Name of the application (default: 'EQXJS')
+     */
+    constructor(appName = logger_constants_1.DEFAULT_VALUES.DEFAULT_APP_NAME) {
+        this.appName = appName;
+        this.logger = winston.createLogger({
+            level: 'silly',
+            transports: [new winston.transports.Console()],
+        });
+        this.cachedHostname = os.hostname();
+    }
+    /**
+     * Formats a Date object to ISO 8601 string with UTC+7 timezone offset.
+     *
+     * @param date - The date to format
+     * @returns ISO 8601 formatted string (e.g., "2026-01-12T10:00:00.000Z")
+     * @protected
+     */
+    dateFormat(date) {
+        return (0, moment_1.default)(date).utcOffset('+0700').format('YYYY-MM-DDTHH:mm:ss.SSS\\Z');
+    }
+    /**
+     * Initializes a LoggerDto with basic log information.
+     *
+     * Creates a structured log entry from the provided message and parameters.
+     * Handles message formatting, truncation, and sets default values for required fields.
+     *
+     * @param level - Log level
+     * @param message - Log message (any type)
+     * @param optionalParams - Additional parameters (last parameter becomes componentName)
+     * @returns Initialized LoggerDto object
+     * @private
+     */
+    initializeLogger(level, message, ...optionalParams) {
+        const componentName = optionalParams.length > 0 ? optionalParams.pop() : undefined;
+        const formattedMessage = (0, message_formatter_helper_1.formatMessage)(message);
+        const truncatedMessage = (0, message_formatter_helper_1.truncateMessage)(formattedMessage);
+        // Direct object creation for better performance
+        const dto = new logger_dto_1.LoggerDto();
+        dto.level = level;
+        dto.timestamp = this.dateFormat(new Date());
+        dto.appName = this.appName;
+        dto.componentName = componentName || logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.action = '[SYSTEM]';
+        dto.message = truncatedMessage;
+        dto.instance = this.cachedHostname;
+        dto.originateServiceName = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.recordName = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.recordType = logger_constants_1.DEFAULT_VALUES.RECORD_TYPE_DETAIL;
+        dto.sessionId = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.transactionId = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.channel = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.componentVersion = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.useCase = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.useCaseStep = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.user = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.device = logger_constants_1.DEFAULT_VALUES.NONE;
+        dto.public = logger_constants_1.DEFAULT_VALUES.NONE;
+        return dto;
+    }
+    /**
+     * Logs an informational message.
+     * Alias for standard console.log behavior in NestJS applications.
+     *
+     * @param message - Message to log (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.log('User created successfully');
+     * logger.log('Request processed', 'UserController');
+     * logger.log({ userId: 123, action: 'create' });
+     * ```
+     */
+    log(message, ...optionalParams) {
+        if (!logUtil.isLevelEnable(logger_constants_1.LOG_LEVELS.LOG))
+            return;
+        const loggerDto = this.initializeLogger(logger_constants_1.LOG_LEVELS.INFO, message, ...optionalParams);
+        this.logger.log(loggerDto);
+    }
+    /**
+     * Logs an error message.
+     * Use for logging error conditions and failures.
+     *
+     * @param message - Error message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.error('Database connection failed');
+     * logger.error('Query error', 'DatabaseService');
+     * logger.error(new Error('Something went wrong'));
+     * ```
+     */
+    error(message, ...optionalParams) {
+        if (!logUtil.isLevelEnable(logger_constants_1.LOG_LEVELS.ERROR))
+            return;
+        const loggerDto = this.initializeLogger(logger_constants_1.LOG_LEVELS.ERROR, message, ...optionalParams);
+        this.logger.log(loggerDto);
+    }
+    /**
+     * Logs a warning message.
+     * Use for potentially harmful situations or deprecated functionality.
+     *
+     * @param message - Warning message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.warn('API rate limit approaching');
+     * logger.warn('Using deprecated method', 'PaymentService');
+     * ```
+     */
+    warn(message, ...optionalParams) {
+        if (!logUtil.isLevelEnable(logger_constants_1.LOG_LEVELS.WARN))
+            return;
+        const loggerDto = this.initializeLogger(logger_constants_1.LOG_LEVELS.WARN, message, ...optionalParams);
+        this.logger.log(loggerDto);
+    }
+    /**
+     * Logs a debug message.
+     * Use for detailed diagnostic information during development.
+     *
+     * @param message - Debug message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.debug('Processing request payload');
+     * logger.debug({ requestId: '123', payload: data }, 'RequestHandler');
+     * ```
+     */
+    debug(message, ...optionalParams) {
+        if (!logUtil.isLevelEnable(logger_constants_1.LOG_LEVELS.DEBUG))
+            return;
+        const loggerDto = this.initializeLogger(logger_constants_1.LOG_LEVELS.DEBUG, message, ...optionalParams);
+        this.logger.log(loggerDto);
+    }
+    /**
+     * Logs a verbose message.
+     * Use for the most detailed information, typically only needed for deep debugging.
+     *
+     * @param message - Verbose message (any type)
+     * @param optionalParams - Additional parameters (last one becomes component name)
+     *
+     * @example
+     * ```typescript
+     * logger.verbose('Internal state dump');
+     * logger.verbose({ state: internalState }, 'StateMachine');
+     * ```
+     */
+    verbose(message, ...optionalParams) {
+        if (!logUtil.isLevelEnable(logger_constants_1.LOG_LEVELS.VERBOSE))
+            return;
+        const loggerDto = this.initializeLogger(logger_constants_1.LOG_LEVELS.VERBOSE, message, ...optionalParams);
+        this.logger.log(loggerDto);
+    }
+    /**
+     * Flushes the log message to Winston logger.
+     *
+     * @param message - Message to be logged
+     * @protected
+     */
+    flushLog(message) {
+        this.logger.log(message);
+    }
+};
+exports.CustomLogger = CustomLogger;
+exports.CustomLogger = CustomLogger = __decorate([
+    __param(0, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [String])
+], CustomLogger);
+//# sourceMappingURL=custom.logger.js.map

package/dist/core/loggers/custom.logger.js.map

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

package/dist/core/loggers/index.d.ts

@@ -0,0 +1,3 @@
+export { CustomLogger } from './custom.logger';
+export { BaseAppLogger } from './base-app.logger';
+export { AppLogger } from './app.logger';

package/dist/core/loggers/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppLogger = exports.BaseAppLogger = exports.CustomLogger = void 0;
+var custom_logger_1 = require("./custom.logger");
+Object.defineProperty(exports, "CustomLogger", { enumerable: true, get: function () { return custom_logger_1.CustomLogger; } });
+var base_app_logger_1 = require("./base-app.logger");
+Object.defineProperty(exports, "BaseAppLogger", { enumerable: true, get: function () { return base_app_logger_1.BaseAppLogger; } });
+var app_logger_1 = require("./app.logger");
+Object.defineProperty(exports, "AppLogger", { enumerable: true, get: function () { return app_logger_1.AppLogger; } });
+//# sourceMappingURL=index.js.map

package/dist/core/loggers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/loggers/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,qDAAkD;AAAzC,gHAAA,aAAa,OAAA;AACtB,2CAAyC;AAAhC,uGAAA,SAAS,OAAA"}

package/dist/helpers/datetime.helper.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Formats the current date and time to ISO 8601 format with UTC+7 timezone offset.
+ *
+ * Returns a string representation of the current timestamp in the format:
+ * `YYYY-MM-DDTHH:mm:ss.SSSZ` (e.g., "2026-01-12T15:30:45.123Z")
+ *
+ * The timestamp is adjusted to UTC+7 timezone (Bangkok/Jakarta timezone).
+ *
+ * @returns ISO 8601 formatted timestamp string with UTC+7 offset
+ *
+ * @example
+ * ```typescript
+ * const timestamp = dateFormat();
+ * console.log(timestamp); // "2026-01-12T15:30:45.123Z"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use in logging
+ * const dto = new LoggerDto();
+ * dto.timestamp = dateFormat();
+ * ```
+ */
+export declare function dateFormat(): string;

package/dist/helpers/datetime.helper.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dateFormat = dateFormat;
+const moment_1 = __importDefault(require("moment"));
+/**
+ * Formats the current date and time to ISO 8601 format with UTC+7 timezone offset.
+ *
+ * Returns a string representation of the current timestamp in the format:
+ * `YYYY-MM-DDTHH:mm:ss.SSSZ` (e.g., "2026-01-12T15:30:45.123Z")
+ *
+ * The timestamp is adjusted to UTC+7 timezone (Bangkok/Jakarta timezone).
+ *
+ * @returns ISO 8601 formatted timestamp string with UTC+7 offset
+ *
+ * @example
+ * ```typescript
+ * const timestamp = dateFormat();
+ * console.log(timestamp); // "2026-01-12T15:30:45.123Z"
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Use in logging
+ * const dto = new LoggerDto();
+ * dto.timestamp = dateFormat();
+ * ```
+ */
+function dateFormat() {
+    return (0, moment_1.default)(new Date())
+        .utcOffset('+0700')
+        .format('YYYY-MM-DDTHH:mm:ss.SSS\\Z');
+}
+//# sourceMappingURL=datetime.helper.js.map

package/dist/helpers/datetime.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.helper.js","sourceRoot":"","sources":["../../src/helpers/datetime.helper.ts"],"names":[],"mappings":";;;;;AAyBA,gCAIC;AA7BD,oDAA4B;AAE5B;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,UAAU;IACxB,OAAO,IAAA,gBAAM,EAAC,IAAI,IAAI,EAAE,CAAC;SACtB,SAAS,CAAC,OAAO,CAAC;SAClB,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAC1C,CAAC"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export { isLevelEnable, logStringify, maskMessageReplacer } from './log.helper';
+export { TimeDiff } from './time-performance.helper';
+export { dateFormat } from './datetime.helper';
+export { LoggerDtoBuilder } from './logger-builder.helper';
+export { formatMessage, setValueOrDefault } from './message-formatter.helper';

package/dist/helpers/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setValueOrDefault = exports.formatMessage = exports.LoggerDtoBuilder = exports.dateFormat = exports.TimeDiff = exports.maskMessageReplacer = exports.logStringify = exports.isLevelEnable = void 0;
+var log_helper_1 = require("./log.helper");
+Object.defineProperty(exports, "isLevelEnable", { enumerable: true, get: function () { return log_helper_1.isLevelEnable; } });
+Object.defineProperty(exports, "logStringify", { enumerable: true, get: function () { return log_helper_1.logStringify; } });
+Object.defineProperty(exports, "maskMessageReplacer", { enumerable: true, get: function () { return log_helper_1.maskMessageReplacer; } });
+var time_performance_helper_1 = require("./time-performance.helper");
+Object.defineProperty(exports, "TimeDiff", { enumerable: true, get: function () { return time_performance_helper_1.TimeDiff; } });
+var datetime_helper_1 = require("./datetime.helper");
+Object.defineProperty(exports, "dateFormat", { enumerable: true, get: function () { return datetime_helper_1.dateFormat; } });
+var logger_builder_helper_1 = require("./logger-builder.helper");
+Object.defineProperty(exports, "LoggerDtoBuilder", { enumerable: true, get: function () { return logger_builder_helper_1.LoggerDtoBuilder; } });
+var message_formatter_helper_1 = require("./message-formatter.helper");
+Object.defineProperty(exports, "formatMessage", { enumerable: true, get: function () { return message_formatter_helper_1.formatMessage; } });
+Object.defineProperty(exports, "setValueOrDefault", { enumerable: true, get: function () { return message_formatter_helper_1.setValueOrDefault; } });
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";;;AAAA,2CAAgF;AAAvE,2GAAA,aAAa,OAAA;AAAE,0GAAA,YAAY,OAAA;AAAE,iHAAA,mBAAmB,OAAA;AACzD,qEAAqD;AAA5C,mHAAA,QAAQ,OAAA;AACjB,qDAA+C;AAAtC,6GAAA,UAAU,OAAA;AACnB,iEAA2D;AAAlD,yHAAA,gBAAgB,OAAA;AACzB,uEAA8E;AAArE,yHAAA,aAAa,OAAA;AAAE,6HAAA,iBAAiB,OAAA"}

package/dist/helpers/log.helper.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Checks if a specific log level is enabled based on the LOG_LEVEL environment variable.
+ *
+ * The LOG_LEVEL environment variable should contain a comma-separated list of enabled levels.
+ * Common log levels: 'debug', 'info', 'log', 'warn', 'error', 'verbose'
+ *
+ * @param level - The log level to check (e.g., 'info', 'debug', 'error')
+ * @returns True if the level is enabled, false otherwise
+ *
+ * @example
+ * ```typescript
+ * process.env.LOG_LEVEL = 'info,error,warn';
+ *
+ * if (isLevelEnable('debug')) {
+ *   // Won't execute - debug is not enabled
+ *   console.log('Debug info');
+ * }
+ *
+ * if (isLevelEnable('info')) {
+ *   // Will execute - info is enabled
+ *   console.log('Info message');
+ * }
+ * ```
+ */
+export declare function isLevelEnable(level: string): boolean;
+/**
+ * JSON replacer function that masks sensitive field values.
+ *
+ * Used with JSON.stringify to automatically replace sensitive field values with '*****'.
+ * Sensitive fields are configured via the LOG_MASK_KEYS environment variable.
+ *
+ * @param key - The property key being stringified
+ * @param value - The property value being stringified
+ * @returns The original value if not sensitive, or '*****' if the key is in the mask list
+ *
+ * @example
+ * ```typescript
+ * process.env.LOG_MASK_KEYS = 'password,apiKey,secret';
+ *
+ * const data = {
+ *   username: 'john',
+ *   password: 'secret123',
+ *   apiKey: 'abc-def-ghi'
+ * };
+ *
+ * const masked = JSON.stringify(data, maskMessageReplacer);
+ * // {"username":"john","password":"*****","apiKey":"*****"}
+ * ```
+ *
+ * @see logStringify
+ */
+export declare function maskMessageReplacer(key: string, value: any): any;
+/**
+ * Converts any value to a string with automatic masking of sensitive fields.
+ *
+ * Handles various input types:
+ * - Strings: returned as-is
+ * - Objects: JSON stringified with automatic masking via maskMessageReplacer
+ * - Others: converted using String()
+ *
+ * Sensitive fields are masked based on the LOG_MASK_KEYS environment variable.
+ *
+ * @param message - The value to stringify (can be any type)
+ * @returns String representation of the message with sensitive fields masked
+ *
+ * @example
+ * ```typescript
+ * process.env.LOG_MASK_KEYS = 'password,token';
+ *
+ * // String input
+ * logStringify('Hello'); // "Hello"
+ *
+ * // Object with sensitive data
+ * const user = { name: 'John', password: 'secret' };
+ * logStringify(user); // '{"name":"John","password":"*****"}'
+ *
+ * // Nested objects
+ * const data = { user: { token: 'abc123' }, message: 'test' };
+ * logStringify(data); // '{"user":{"token":"*****"},"message":"test"}'
+ * ```
+ *
+ * @see maskMessageReplacer
+ */
+export declare function logStringify(message: any): string;