@eqxjs/nest-logger 3.1.0-beta.13 → 3.1.0-beta.14

package/dist/helpers/message-formatter.helper.d.ts

@@ -1,20 +1,87 @@
 /**
- * Format a message of any type to string
- * Optimized for common cases (strings) for better performance
+ * Formats a message of any type to string representation.
+ *
+ * Optimized for performance with fast paths for common cases (strings, numbers).
+ * Handles various input types:
+ * - Strings: returned as-is (fast path)
+ * - Numbers: converted to string
+ * - Functions: executed and result converted to string
+ * - null/undefined: returns empty string
+ * - Objects: JSON stringified with sensitive field masking
+ *
+ * @param message - The message to format (can be any type)
+ * @returns String representation of the message
+ *
+ * @example
+ * ```typescript
+ * formatMessage('Hello'); // "Hello"
+ * formatMessage(123); // "123"
+ * formatMessage({ key: 'value' }); // "{\"key\":\"value\"}"
+ * formatMessage(null); // ""
+ * formatMessage(() => 'computed'); // "computed"
+ * ```
  */
 export declare function formatMessage(message: any): string;
 /**
- * Set value or return default 'none'
- * Optimized for performance with faster checks
+ * Returns the provided value or the default 'none' string if the value is empty.
+ *
+ * Optimized for performance with faster checks. Returns DEFAULT_VALUES.NONE if:
+ * - value is undefined
+ * - value is an empty string
+ * - value has length of 0
+ *
+ * @param value - The value to check (optional string)
+ * @returns The original value if non-empty, or DEFAULT_VALUES.NONE ('none')
+ *
+ * @example
+ * ```typescript
+ * setValueOrDefault('test'); // "test"
+ * setValueOrDefault(''); // "none"
+ * setValueOrDefault(undefined); // "none"
+ * setValueOrDefault('  '); // "  " (whitespace is considered non-empty)
+ * ```
  */
 export declare function setValueOrDefault(value?: string): string;
 /**
- * Truncate message if it exceeds max length
- * Optimized with early return for messages within limit
+ * Truncates a message if it exceeds the specified maximum length.
+ *
+ * Optimized with early return for messages within the limit. Adds '...' to indicate truncation.
+ * Uses DEFAULT_VALUES.MAX_MESSAGE_LENGTH as the default limit.
+ *
+ * @param message - The message string to truncate
+ * @param maxLength - Maximum allowed length (default: DEFAULT_VALUES.MAX_MESSAGE_LENGTH)
+ * @returns The original message if within limit, or truncated message with '...' appended
+ *
+ * @example
+ * ```typescript
+ * truncateMessage('Short', 100); // "Short"
+ * truncateMessage('A very long message...', 10); // "A very lon..."
+ * truncateMessage('Hello World'); // Uses default max length
+ * ```
  */
 export declare function truncateMessage(message: string, maxLength?: number): string;
 /**
- * Merge broker option into LoggerOpt
+ * Merges broker information into a LoggerOpt object.
+ *
+ * Creates a new object with the broker field merged in. If opt is provided,
+ * spreads its properties and adds/overwrites the broker field. If opt is undefined,
+ * creates a new object with only the broker field.
+ *
+ * @param opt - Optional configuration object to merge with
+ * @param broker - Broker identifier to add to the configuration
+ * @returns New object with broker field merged in
+ *
+ * @example
+ * ```typescript
+ * // With existing options
+ * const opts = { customField: 'value' };
+ * mergeBrokerOption(opts, 'kafka');
+ * // Result: { customField: 'value', broker: 'kafka' }
+ *
+ * // Without existing options
+ * mergeBrokerOption(undefined, 'rabbitmq');
+ * // Result: { broker: 'rabbitmq' }
+ * ```
  */
 export declare function mergeBrokerOption<T extends {
     broker?: string;

package/dist/helpers/message-formatter.helper.js

@@ -40,8 +40,27 @@ exports.mergeBrokerOption = mergeBrokerOption;
 const logger_constants_1 = require("../constants/logger.constants");
 const logUtil = __importStar(require("./log.helper"));
 /**
- * Format a message of any type to string
- * Optimized for common cases (strings) for better performance
+ * Formats a message of any type to string representation.
+ *
+ * Optimized for performance with fast paths for common cases (strings, numbers).
+ * Handles various input types:
+ * - Strings: returned as-is (fast path)
+ * - Numbers: converted to string
+ * - Functions: executed and result converted to string
+ * - null/undefined: returns empty string
+ * - Objects: JSON stringified with sensitive field masking
+ *
+ * @param message - The message to format (can be any type)
+ * @returns String representation of the message
+ *
+ * @example
+ * ```typescript
+ * formatMessage('Hello'); // "Hello"
+ * formatMessage(123); // "123"
+ * formatMessage({ key: 'value' }); // "{\"key\":\"value\"}"
+ * formatMessage(null); // ""
+ * formatMessage(() => 'computed'); // "computed"
+ * ```
  */
 function formatMessage(message) {
     // Fast path for most common case
@@ -63,15 +82,43 @@ function formatMessage(message) {
     return logUtil.logStringify(message);
 }
 /**
- * Set value or return default 'none'
- * Optimized for performance with faster checks
+ * Returns the provided value or the default 'none' string if the value is empty.
+ *
+ * Optimized for performance with faster checks. Returns DEFAULT_VALUES.NONE if:
+ * - value is undefined
+ * - value is an empty string
+ * - value has length of 0
+ *
+ * @param value - The value to check (optional string)
+ * @returns The original value if non-empty, or DEFAULT_VALUES.NONE ('none')
+ *
+ * @example
+ * ```typescript
+ * setValueOrDefault('test'); // "test"
+ * setValueOrDefault(''); // "none"
+ * setValueOrDefault(undefined); // "none"
+ * setValueOrDefault('  '); // "  " (whitespace is considered non-empty)
+ * ```
  */
 function setValueOrDefault(value) {
     return (value && value.length > 0) ? value : logger_constants_1.DEFAULT_VALUES.NONE;
 }
 /**
- * Truncate message if it exceeds max length
- * Optimized with early return for messages within limit
+ * Truncates a message if it exceeds the specified maximum length.
+ *
+ * Optimized with early return for messages within the limit. Adds '...' to indicate truncation.
+ * Uses DEFAULT_VALUES.MAX_MESSAGE_LENGTH as the default limit.
+ *
+ * @param message - The message string to truncate
+ * @param maxLength - Maximum allowed length (default: DEFAULT_VALUES.MAX_MESSAGE_LENGTH)
+ * @returns The original message if within limit, or truncated message with '...' appended
+ *
+ * @example
+ * ```typescript
+ * truncateMessage('Short', 100); // "Short"
+ * truncateMessage('A very long message...', 10); // "A very lon..."
+ * truncateMessage('Hello World'); // Uses default max length
+ * ```
  */
 function truncateMessage(message, maxLength = logger_constants_1.DEFAULT_VALUES.MAX_MESSAGE_LENGTH) {
     // Fast path: most messages are within limit
@@ -81,7 +128,27 @@ function truncateMessage(message, maxLength = logger_constants_1.DEFAULT_VALUES.
     return message.substring(0, maxLength) + '...';
 }
 /**
- * Merge broker option into LoggerOpt
+ * Merges broker information into a LoggerOpt object.
+ *
+ * Creates a new object with the broker field merged in. If opt is provided,
+ * spreads its properties and adds/overwrites the broker field. If opt is undefined,
+ * creates a new object with only the broker field.
+ *
+ * @param opt - Optional configuration object to merge with
+ * @param broker - Broker identifier to add to the configuration
+ * @returns New object with broker field merged in
+ *
+ * @example
+ * ```typescript
+ * // With existing options
+ * const opts = { customField: 'value' };
+ * mergeBrokerOption(opts, 'kafka');
+ * // Result: { customField: 'value', broker: 'kafka' }
+ *
+ * // Without existing options
+ * mergeBrokerOption(undefined, 'rabbitmq');
+ * // Result: { broker: 'rabbitmq' }
+ * ```
  */
 function mergeBrokerOption(opt, broker) {
     if (opt) {

package/dist/helpers/message-formatter.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"message-formatter.helper.js","sourceRoot":"","sources":["../../src/helpers/message-formatter.helper.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOA,sCAsBC;AAMD,8CAEC;AAMD,0CAMC;AAKD,8CAQC;AA9DD,oEAA+D;AAC/D,sDAAwC;AAExC;;;GAGG;AACH,SAAgB,aAAa,CAAC,OAAY;IACxC,iCAAiC;IACjC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,sCAAsC;IACtC,OAAO,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iCAAc,CAAC,IAAI,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,SAAgB,eAAe,CAAC,OAAe,EAAE,YAAoB,iCAAc,CAAC,kBAAkB;IACpG,4CAA4C;IAC5C,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,GAAkB,EAClB,MAAe;IAEf,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,MAAM,EAAO,CAAC;AACzB,CAAC"}
+{"version":3,"file":"message-formatter.helper.js","sourceRoot":"","sources":["../../src/helpers/message-formatter.helper.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,sCAsBC;AAqBD,8CAEC;AAmBD,0CAMC;AAyBD,8CAQC;AAjID,oEAA+D;AAC/D,sDAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,aAAa,CAAC,OAAY;IACxC,iCAAiC;IACjC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,qBAAqB;IACrB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,OAAO,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,sCAAsC;IACtC,OAAO,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iCAAc,CAAC,IAAI,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAAC,OAAe,EAAE,YAAoB,iCAAc,CAAC,kBAAkB;IACpG,4CAA4C;IAC5C,IAAI,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QAChC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;AACjD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,SAAgB,iBAAiB,CAC/B,GAAkB,EAClB,MAAe;IAEf,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,MAAM,EAAO,CAAC;AACzB,CAAC"}

package/dist/helpers/time-performance.helper.d.ts

@@ -1,7 +1,68 @@
+/**
+ * TimeDiff - High-resolution timer for measuring elapsed time.
+ *
+ * Uses Node.js performance API to provide precise time measurements in milliseconds.
+ * Useful for tracking operation duration, performance monitoring, and logging service times.
+ *
+ * @example
+ * ```typescript
+ * const timer = new TimeDiff();
+ * await someOperation();
+ * const duration = timer.diff();
+ * console.log(`Operation took ${duration}ms`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using static start method
+ * const timer = TimeDiff.start();
+ * processData();
+ * console.log(`Elapsed: ${timer.end()}ms`);
+ * ```
+ */
 export declare class TimeDiff {
     private startTime;
+    /**
+     * Creates a new TimeDiff instance and starts the timer.
+     * The start time is captured immediately using high-resolution performance timer.
+     */
     constructor();
+    /**
+     * Static factory method to create and start a new timer instance.
+     *
+     * @returns A new TimeDiff instance with the timer started
+     *
+     * @example
+     * ```typescript
+     * const timer = TimeDiff.start();
+     * ```
+     */
     static start(): TimeDiff;
+    /**
+     * Calculates and returns the elapsed time since the timer was started.
+     * Returns the duration in milliseconds with 3 decimal places precision.
+     *
+     * @returns Elapsed time in milliseconds (e.g., 123.456)
+     *
+     * @example
+     * ```typescript
+     * const timer = new TimeDiff();
+     * await operation();
+     * const ms = timer.diff(); // e.g., 150.234
+     * ```
+     */
     diff(): number;
+    /**
+     * Alias for diff() method. Returns the elapsed time since the timer was started.
+     *
+     * @returns Elapsed time in milliseconds
+     *
+     * @example
+     * ```typescript
+     * const timer = TimeDiff.start();
+     * processData();
+     * const duration = timer.end();
+     * ```
+     */
     end(): number;
 }

package/dist/helpers/time-performance.helper.js

@@ -2,17 +2,78 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TimeDiff = void 0;
 const perf_hooks_1 = require("perf_hooks");
+/**
+ * TimeDiff - High-resolution timer for measuring elapsed time.
+ *
+ * Uses Node.js performance API to provide precise time measurements in milliseconds.
+ * Useful for tracking operation duration, performance monitoring, and logging service times.
+ *
+ * @example
+ * ```typescript
+ * const timer = new TimeDiff();
+ * await someOperation();
+ * const duration = timer.diff();
+ * console.log(`Operation took ${duration}ms`);
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // Using static start method
+ * const timer = TimeDiff.start();
+ * processData();
+ * console.log(`Elapsed: ${timer.end()}ms`);
+ * ```
+ */
 class TimeDiff {
     startTime;
+    /**
+     * Creates a new TimeDiff instance and starts the timer.
+     * The start time is captured immediately using high-resolution performance timer.
+     */
     constructor() {
         this.startTime = perf_hooks_1.performance.now();
     }
+    /**
+     * Static factory method to create and start a new timer instance.
+     *
+     * @returns A new TimeDiff instance with the timer started
+     *
+     * @example
+     * ```typescript
+     * const timer = TimeDiff.start();
+     * ```
+     */
     static start() {
         return new TimeDiff();
     }
+    /**
+     * Calculates and returns the elapsed time since the timer was started.
+     * Returns the duration in milliseconds with 3 decimal places precision.
+     *
+     * @returns Elapsed time in milliseconds (e.g., 123.456)
+     *
+     * @example
+     * ```typescript
+     * const timer = new TimeDiff();
+     * await operation();
+     * const ms = timer.diff(); // e.g., 150.234
+     * ```
+     */
     diff() {
-        return Math.round(perf_hooks_1.performance.now() - this.startTime);
+        return parseFloat((perf_hooks_1.performance.now() - this.startTime).toFixed(3));
     }
+    /**
+     * Alias for diff() method. Returns the elapsed time since the timer was started.
+     *
+     * @returns Elapsed time in milliseconds
+     *
+     * @example
+     * ```typescript
+     * const timer = TimeDiff.start();
+     * processData();
+     * const duration = timer.end();
+     * ```
+     */
     end() {
         return this.diff();
     }

package/dist/helpers/time-performance.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"time-performance.helper.js","sourceRoot":"","sources":["../../src/helpers/time-performance.helper.ts"],"names":[],"mappings":";;;AAAA,2CAAyC;AAEzC,MAAa,QAAQ;IACX,SAAS,CAAS;IAE1B;QACE,IAAI,CAAC,SAAS,GAAG,wBAAW,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAEM,MAAM,CAAC,KAAK;QACjB,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAEM,IAAI;QACT,OAAO,IAAI,CAAC,KAAK,CAAC,wBAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;IACxD,CAAC;IAEM,GAAG;QACR,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF;AAlBD,4BAkBC"}
+{"version":3,"file":"time-performance.helper.js","sourceRoot":"","sources":["../../src/helpers/time-performance.helper.ts"],"names":[],"mappings":";;;AAAA,2CAAyC;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAa,QAAQ;IACX,SAAS,CAAS;IAE1B;;;OAGG;IACH;QACE,IAAI,CAAC,SAAS,GAAG,wBAAW,CAAC,GAAG,EAAE,CAAC;IACrC,CAAC;IAED;;;;;;;;;OASG;IACI,MAAM,CAAC,KAAK;QACjB,OAAO,IAAI,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,IAAI;QACT,OAAO,UAAU,CAAC,CAAC,wBAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;;;;OAWG;IACI,GAAG;QACR,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IACrB,CAAC;CACF;AAzDD,4BAyDC"}

package/dist/models/logger.dto.d.ts

@@ -1,28 +1,71 @@
+/**
+ * LoggerDto - Data Transfer Object for structured log entries.
+ *
+ * Represents a complete log record with all metadata fields used throughout the logging system.
+ * This DTO is used to standardize log format across different logger types and ensure
+ * consistent structure for log aggregation, analysis, and monitoring.
+ *
+ * @example
+ * ```typescript
+ * const dto = new LoggerDto();
+ * dto.level = 'info';
+ * dto.timestamp = '2026-01-12T10:00:00.000Z';
+ * dto.message = 'User logged in';
+ * dto.appName = 'MyApp';
+ * dto.sessionId = 'sess-123';
+ * ```
+ */
 export declare class LoggerDto {
+    /** Log level (e.g., 'debug', 'info', 'warn', 'error', 'verbose') */
     level: string;
+    /** ISO 8601 formatted timestamp of the log entry */
     timestamp: string;
+    /** Name of the application generating the log */
     appName: string;
+    /** Name of the component or service within the application */
     componentName: string;
+    /** Version of the component */
     componentVersion: string;
+    /** Device identifier(s) - can be a single string or array of strings */
     device: string | string[];
+    /** Action tag categorizing the log entry (e.g., '[HTTP_REQUEST]', '[DB_QUERY]') */
     action: string;
+    /** The main log message content */
     message: string;
+    /** Global unique identifier for the log entry */
     guid: string;
+    /** Instance identifier (hostname, container ID, or pod name) */
     instance: string;
+    /** Name of the service that originated the log */
     originateServiceName: string;
+    /** Record identifier (e.g., order ID, user ID, transaction reference) */
     recordName: string;
+    /** Type of record ('detail' for regular logs, 'summary' for aggregated logs) */
     recordType: string;
+    /** Session identifier for tracking user sessions */
     sessionId: string;
+    /** Transaction identifier for distributed tracing */
     transactionId: string;
+    /** Public identifier(s) - can be a single string or array */
     public: string | string[];
+    /** Message broker identifier (e.g., 'kafka', 'rabbitmq', 'redis') */
     broker: string;
+    /** Communication channel (e.g., 'web', 'mobile', 'api', 'queue') */
     channel: string;
+    /** Use case name being executed */
     useCase: string;
+    /** Specific step within the use case */
     useCaseStep: string;
+    /** User identifier (email, username, or user ID) */
     user: string;
+    /** Application result description (e.g., 'Success', 'Failed', 'Completed') */
     appResult: string;
+    /** Application result code (e.g., '200', '500', 'ERR_001') */
     appResultCode: string;
+    /** Service processing time in milliseconds */
     serviceTime: number;
+    /** Error stack trace as array of strings (populated for error logs) */
     stack: string[];
+    /** DateTime string (alternative timestamp format, optional) */
     dateTime?: string;
 }

package/dist/models/logger.dto.js

@@ -1,32 +1,75 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoggerDto = void 0;
+/**
+ * LoggerDto - Data Transfer Object for structured log entries.
+ *
+ * Represents a complete log record with all metadata fields used throughout the logging system.
+ * This DTO is used to standardize log format across different logger types and ensure
+ * consistent structure for log aggregation, analysis, and monitoring.
+ *
+ * @example
+ * ```typescript
+ * const dto = new LoggerDto();
+ * dto.level = 'info';
+ * dto.timestamp = '2026-01-12T10:00:00.000Z';
+ * dto.message = 'User logged in';
+ * dto.appName = 'MyApp';
+ * dto.sessionId = 'sess-123';
+ * ```
+ */
 class LoggerDto {
+    /** Log level (e.g., 'debug', 'info', 'warn', 'error', 'verbose') */
     level;
+    /** ISO 8601 formatted timestamp of the log entry */
     timestamp;
+    /** Name of the application generating the log */
     appName;
+    /** Name of the component or service within the application */
     componentName;
+    /** Version of the component */
     componentVersion;
+    /** Device identifier(s) - can be a single string or array of strings */
     device;
+    /** Action tag categorizing the log entry (e.g., '[HTTP_REQUEST]', '[DB_QUERY]') */
     action;
+    /** The main log message content */
     message;
+    /** Global unique identifier for the log entry */
     guid;
+    /** Instance identifier (hostname, container ID, or pod name) */
     instance;
+    /** Name of the service that originated the log */
     originateServiceName;
+    /** Record identifier (e.g., order ID, user ID, transaction reference) */
     recordName;
+    /** Type of record ('detail' for regular logs, 'summary' for aggregated logs) */
     recordType;
+    /** Session identifier for tracking user sessions */
     sessionId;
+    /** Transaction identifier for distributed tracing */
     transactionId;
+    /** Public identifier(s) - can be a single string or array */
     public;
+    /** Message broker identifier (e.g., 'kafka', 'rabbitmq', 'redis') */
     broker;
+    /** Communication channel (e.g., 'web', 'mobile', 'api', 'queue') */
     channel;
+    /** Use case name being executed */
     useCase;
+    /** Specific step within the use case */
     useCaseStep;
+    /** User identifier (email, username, or user ID) */
     user;
+    /** Application result description (e.g., 'Success', 'Failed', 'Completed') */
     appResult;
+    /** Application result code (e.g., '200', '500', 'ERR_001') */
     appResultCode;
+    /** Service processing time in milliseconds */
     serviceTime;
+    /** Error stack trace as array of strings (populated for error logs) */
     stack;
+    /** DateTime string (alternative timestamp format, optional) */
     dateTime;
 }
 exports.LoggerDto = LoggerDto;

package/dist/models/logger.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.dto.js","sourceRoot":"","sources":["../../src/models/logger.dto.ts"],"names":[],"mappings":";;;AAAA,MAAa,SAAS;IACpB,KAAK,CAAU;IACf,SAAS,CAAU;IACnB,OAAO,CAAU;IACjB,aAAa,CAAU;IACvB,gBAAgB,CAAU;IAC1B,MAAM,CAAqB;IAC3B,MAAM,CAAU;IAChB,OAAO,CAAU;IACjB,IAAI,CAAU;IACd,QAAQ,CAAU;IAClB,oBAAoB,CAAU;IAC9B,UAAU,CAAU;IACpB,UAAU,CAAU;IACpB,SAAS,CAAU;IACnB,aAAa,CAAU;IACvB,MAAM,CAAqB;IAC3B,MAAM,CAAU;IAChB,OAAO,CAAU;IAEjB,OAAO,CAAU;IACjB,WAAW,CAAU;IACrB,IAAI,CAAU;IAEd,SAAS,CAAU;IACnB,aAAa,CAAU;IACvB,WAAW,CAAU;IACrB,KAAK,CAAY;IAEjB,QAAQ,CAAU;CACnB;AA9BD,8BA8BC"}
+{"version":3,"file":"logger.dto.js","sourceRoot":"","sources":["../../src/models/logger.dto.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,SAAS;IACpB,oEAAoE;IACpE,KAAK,CAAU;IAEf,oDAAoD;IACpD,SAAS,CAAU;IAEnB,iDAAiD;IACjD,OAAO,CAAU;IAEjB,8DAA8D;IAC9D,aAAa,CAAU;IAEvB,+BAA+B;IAC/B,gBAAgB,CAAU;IAE1B,wEAAwE;IACxE,MAAM,CAAqB;IAE3B,mFAAmF;IACnF,MAAM,CAAU;IAEhB,mCAAmC;IACnC,OAAO,CAAU;IAEjB,iDAAiD;IACjD,IAAI,CAAU;IAEd,gEAAgE;IAChE,QAAQ,CAAU;IAElB,kDAAkD;IAClD,oBAAoB,CAAU;IAE9B,yEAAyE;IACzE,UAAU,CAAU;IAEpB,gFAAgF;IAChF,UAAU,CAAU;IAEpB,oDAAoD;IACpD,SAAS,CAAU;IAEnB,qDAAqD;IACrD,aAAa,CAAU;IAEvB,6DAA6D;IAC7D,MAAM,CAAqB;IAE3B,qEAAqE;IACrE,MAAM,CAAU;IAEhB,oEAAoE;IACpE,OAAO,CAAU;IAEjB,mCAAmC;IACnC,OAAO,CAAU;IAEjB,wCAAwC;IACxC,WAAW,CAAU;IAErB,oDAAoD;IACpD,IAAI,CAAU;IAEd,8EAA8E;IAC9E,SAAS,CAAU;IAEnB,8DAA8D;IAC9D,aAAa,CAAU;IAEvB,8CAA8C;IAC9C,WAAW,CAAU;IAErB,uEAAuE;IACvE,KAAK,CAAY;IAEjB,+DAA+D;IAC/D,QAAQ,CAAU;CACnB;AA9ED,8BA8EC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eqxjs/nest-logger",
-  "version": "3.1.0-beta.13",
+  "version": "3.1.0-beta.14",
   "description": "NestJS logger module for EQXJS",
   "author": "Atit Plangson",
   "license": "ISC",