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

package/dist/helpers/logger-builder.helper.js.map

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

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

@@ -0,0 +1,88 @@
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * 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;
+/**
+ * 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;
+}>(opt: T | undefined, broker?: string): T;

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

@@ -0,0 +1,159 @@
+"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 __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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatMessage = formatMessage;
+exports.setValueOrDefault = setValueOrDefault;
+exports.truncateMessage = truncateMessage;
+exports.mergeBrokerOption = mergeBrokerOption;
+const logger_constants_1 = require("../constants/logger.constants");
+const logUtil = __importStar(require("./log.helper"));
+/**
+ * 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
+    if (typeof message === 'string') {
+        return message;
+    }
+    // Handle other types
+    if (typeof message === 'number') {
+        return String(message);
+    }
+    if (typeof message === 'function') {
+        return String(message());
+    }
+    // Handle null/undefined
+    if (message == null) {
+        return '';
+    }
+    // Object serialization (slowest path)
+    return logUtil.logStringify(message);
+}
+/**
+ * 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;
+}
+/**
+ * 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
+    if (message.length <= maxLength) {
+        return message;
+    }
+    return message.substring(0, maxLength) + '...';
+}
+/**
+ * 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) {
+        return { ...opt, broker };
+    }
+    return { broker };
+}
+//# sourceMappingURL=message-formatter.helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message-formatter.helper.js","sourceRoot":"","sources":["../../src/helpers/message-formatter.helper.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,sCAsBC;AAqBD,8CAEC;AAmBD,0CASC;AAyBD,8CAQC;AApID,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,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,iCAAc,CAAC,IAAI,CAAC;AACjE,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAC7B,OAAe,EACf,YAAoB,iCAAc,CAAC,kBAAkB;IAErD,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

@@ -0,0 +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

@@ -0,0 +1,82 @@
+"use strict";
+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 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();
+    }
+}
+exports.TimeDiff = TimeDiff;
+//# sourceMappingURL=time-performance.helper.js.map

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

@@ -0,0 +1 @@
+{"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/index.d.ts

@@ -1,7 +1,15 @@
 import 'reflect-metadata';
-export { CustomLogger } from './logger.service';
+export { CustomLogger } from './core/loggers/custom.logger';
+export { AppLogger } from './core/loggers/app.logger';
+export { BaseAppLogger } from './core/loggers/base-app.logger';
 export { CustomLoggerModule } from './logger.module';
-export { AppLogger } from './logger.app';
-export { ActionMessage } from './utils/action.common';
-export { LoggerOpt } from './utils/logger.opt';
-export { TimeDiff } from './utils/time.performance';
+export { DataM, DataM1I, DataM2I, DataM3I, IDataM, } from './interfaces/data.interface';
+export { DataHeaderI } from './interfaces/data-header.interface';
+export { DataProtocolI } from './interfaces/data-protocol.interface';
+export { DataServiceI } from './interfaces/data-service.interface';
+export { LoggerOpt } from './interfaces/logger-opt.interface';
+export { LoggerDto } from './models/logger.dto';
+export { ActionMessage } from './constants/action-message.constant';
+export { TimeDiff } from './helpers/time-performance.helper';
+export { dateFormat } from './helpers/datetime.helper';
+export { isLevelEnable, logStringify, maskMessageReplacer, } from './helpers/log.helper';

package/dist/index.js

@@ -1,15 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TimeDiff = exports.ActionMessage = exports.AppLogger = exports.CustomLoggerModule = exports.CustomLogger = void 0;
+exports.maskMessageReplacer = exports.logStringify = exports.isLevelEnable = exports.dateFormat = exports.TimeDiff = exports.ActionMessage = exports.LoggerDto = exports.CustomLoggerModule = exports.BaseAppLogger = exports.AppLogger = exports.CustomLogger = void 0;
 require("reflect-metadata");
-var logger_service_1 = require("./logger.service");
-Object.defineProperty(exports, "CustomLogger", { enumerable: true, get: function () { return logger_service_1.CustomLogger; } });
+// Core loggers
+var custom_logger_1 = require("./core/loggers/custom.logger");
+Object.defineProperty(exports, "CustomLogger", { enumerable: true, get: function () { return custom_logger_1.CustomLogger; } });
+var app_logger_1 = require("./core/loggers/app.logger");
+Object.defineProperty(exports, "AppLogger", { enumerable: true, get: function () { return app_logger_1.AppLogger; } });
+var base_app_logger_1 = require("./core/loggers/base-app.logger");
+Object.defineProperty(exports, "BaseAppLogger", { enumerable: true, get: function () { return base_app_logger_1.BaseAppLogger; } });
+// Module
 var logger_module_1 = require("./logger.module");
 Object.defineProperty(exports, "CustomLoggerModule", { enumerable: true, get: function () { return logger_module_1.CustomLoggerModule; } });
-var logger_app_1 = require("./logger.app");
-Object.defineProperty(exports, "AppLogger", { enumerable: true, get: function () { return logger_app_1.AppLogger; } });
-var action_common_1 = require("./utils/action.common");
-Object.defineProperty(exports, "ActionMessage", { enumerable: true, get: function () { return action_common_1.ActionMessage; } });
-var time_performance_1 = require("./utils/time.performance");
-Object.defineProperty(exports, "TimeDiff", { enumerable: true, get: function () { return time_performance_1.TimeDiff; } });
+// Models
+var logger_dto_1 = require("./models/logger.dto");
+Object.defineProperty(exports, "LoggerDto", { enumerable: true, get: function () { return logger_dto_1.LoggerDto; } });
+// Constants
+var action_message_constant_1 = require("./constants/action-message.constant");
+Object.defineProperty(exports, "ActionMessage", { enumerable: true, get: function () { return action_message_constant_1.ActionMessage; } });
+// Helpers
+var time_performance_helper_1 = require("./helpers/time-performance.helper");
+Object.defineProperty(exports, "TimeDiff", { enumerable: true, get: function () { return time_performance_helper_1.TimeDiff; } });
+var datetime_helper_1 = require("./helpers/datetime.helper");
+Object.defineProperty(exports, "dateFormat", { enumerable: true, get: function () { return datetime_helper_1.dateFormat; } });
+var log_helper_1 = require("./helpers/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; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAE1B,mDAAgD;AAAvC,8GAAA,YAAY,OAAA;AACrB,iDAAqD;AAA5C,mHAAA,kBAAkB,OAAA;AAC3B,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,uDAAsD;AAA7C,8GAAA,aAAa,OAAA;AAEtB,6DAAoD;AAA3C,4GAAA,QAAQ,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAE1B,eAAe;AACf,8DAA4D;AAAnD,6GAAA,YAAY,OAAA;AACrB,wDAAsD;AAA7C,uGAAA,SAAS,OAAA;AAClB,kEAA+D;AAAtD,gHAAA,aAAa,OAAA;AAEtB,SAAS;AACT,iDAAqD;AAA5C,mHAAA,kBAAkB,OAAA;AAe3B,SAAS;AACT,kDAAgD;AAAvC,uGAAA,SAAS,OAAA;AAElB,YAAY;AACZ,+EAAoE;AAA3D,wHAAA,aAAa,OAAA;AAEtB,UAAU;AACV,6EAA6D;AAApD,mHAAA,QAAQ,OAAA;AACjB,6DAAuD;AAA9C,6GAAA,UAAU,OAAA;AACnB,mDAI8B;AAH5B,2GAAA,aAAa,OAAA;AACb,0GAAA,YAAY,OAAA;AACZ,iHAAA,mBAAmB,OAAA"}

package/dist/interfaces/data-header.interface.d.ts

@@ -0,0 +1,21 @@
+export interface DataHeaderI extends Record<string, unknown> {
+    version?: string;
+    timestamp?: string;
+    orgService?: string;
+    channel?: string;
+    broker?: string;
+    useCase?: string;
+    useCaseStep?: string;
+    session?: string;
+    transaction?: string;
+    communication?: string;
+    groupTags?: [];
+    identity: {
+        device?: string | string[];
+        public?: string;
+        user?: string;
+    };
+    tmfSpec?: string;
+    baseApiVersion?: string;
+    instanceData?: string;
+}

package/dist/{dto/m2.dto.js → interfaces/data-header.interface.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=m2.dto.js.map
+//# sourceMappingURL=data-header.interface.js.map

package/dist/interfaces/data-header.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-header.interface.js","sourceRoot":"","sources":["../../src/interfaces/data-header.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/data-protocol.interface.d.ts

@@ -0,0 +1,14 @@
+export interface DataProtocolI extends Record<string, unknown> {
+    version?: string;
+    command?: string;
+    subCommand?: string;
+    invoke?: string;
+    qos?: string;
+    topic?: string;
+    token?: string;
+    service?: string;
+    locationInfo?: string;
+    networkInfo?: string;
+    deviceInfo?: string;
+    diagMessage?: string;
+}

package/dist/interfaces/data-protocol.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data-protocol.interface.js.map

package/dist/interfaces/data-protocol.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-protocol.interface.js","sourceRoot":"","sources":["../../src/interfaces/data-protocol.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/data-service.interface.d.ts

@@ -0,0 +1,21 @@
+export interface DataServiceI extends Record<string, unknown> {
+    version?: string;
+    timestamp?: string;
+    channel?: string;
+    broker?: string;
+    useCase?: string;
+    useCaseStep?: string;
+    name?: string;
+    invoke?: string;
+    session?: string;
+    transaction?: string;
+    token?: string;
+    orgService?: string;
+    communication?: string;
+    groupTags?: string[];
+    identity: {
+        device?: string | string[];
+        public?: string;
+        user?: string;
+    };
+}

package/dist/{dto/m3.dto.js → interfaces/data-service.interface.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=m3.dto.js.map
+//# sourceMappingURL=data-service.interface.js.map

package/dist/interfaces/data-service.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-service.interface.js","sourceRoot":"","sources":["../../src/interfaces/data-service.interface.ts"],"names":[],"mappings":""}

package/dist/{types.d.ts → interfaces/data.interface.d.ts}

@@ -1,6 +1,6 @@
-import { DataHeaderI } from './dto/header.dto';
-import { DataProtocolI } from './dto/protocol.dto';
-import { DataServiceI } from './dto/service.dto';
+import { DataHeaderI } from './data-header.interface';
+import { DataProtocolI } from './data-protocol.interface';
+import { DataServiceI } from './data-service.interface';
 export interface IDataM {
     protocol?: DataProtocolI;
     header?: DataHeaderI;
@@ -16,4 +16,4 @@ export interface DataM2I extends IDataM {
 export interface DataM3I extends IDataM {
     service: DataServiceI;
 }
-export type DataM = DataM1I | DataM2I | DataM3I;
+export type DataM = any;

package/dist/{dto/m1.dto.js → interfaces/data.interface.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=m1.dto.js.map
+//# sourceMappingURL=data.interface.js.map

package/dist/interfaces/data.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.interface.js","sourceRoot":"","sources":["../../src/interfaces/data.interface.ts"],"names":[],"mappings":""}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,5 @@
+export { DataM, DataM1I, DataM2I, DataM3I, IDataM } from './data.interface';
+export { DataHeaderI } from './data-header.interface';
+export { DataProtocolI } from './data-protocol.interface';
+export { DataServiceI } from './data-service.interface';
+export { LoggerOpt } from './logger-opt.interface';

package/dist/{types.js → interfaces/index.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=types.js.map
+//# sourceMappingURL=index.js.map

package/dist/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":""}

package/dist/{dto/header.dto.js → interfaces/logger-opt.interface.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=header.dto.js.map
+//# sourceMappingURL=logger-opt.interface.js.map

package/dist/interfaces/logger-opt.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-opt.interface.js","sourceRoot":"","sources":["../../src/interfaces/logger-opt.interface.ts"],"names":[],"mappings":""}

package/dist/logger.module.js

@@ -8,15 +8,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CustomLoggerModule = void 0;
 const common_1 = require("@nestjs/common");
-const logger_app_1 = require("./logger.app");
-const logger_service_1 = require("./logger.service");
+const app_logger_1 = require("./core/loggers/app.logger");
+const custom_logger_1 = require("./core/loggers/custom.logger");
 let CustomLoggerModule = class CustomLoggerModule {
 };
 exports.CustomLoggerModule = CustomLoggerModule;
 exports.CustomLoggerModule = CustomLoggerModule = __decorate([
     (0, common_1.Module)({
-        providers: [logger_service_1.CustomLogger, logger_app_1.AppLogger],
-        exports: [logger_service_1.CustomLogger, logger_app_1.AppLogger],
+        providers: [custom_logger_1.CustomLogger, app_logger_1.AppLogger],
+        exports: [custom_logger_1.CustomLogger, app_logger_1.AppLogger],
     })
 ], CustomLoggerModule);
 //# sourceMappingURL=logger.module.js.map