@pristine-ts/logging 0.0.370 → 0.0.371

package/dist/lib/cjs/handlers/breadcrumb.handler.js

@@ -0,0 +1,32 @@
+"use strict";
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BreadcrumbHandler = void 0;
+const logging_module_keyname_1 = require("../logging.module.keyname");
+const tsyringe_1 = require("tsyringe");
+const common_1 = require("@pristine-ts/common");
+const breadcrumb_model_1 = require("../models/breadcrumb.model");
+let BreadcrumbHandler = class BreadcrumbHandler {
+    constructor() {
+        this.breadcrumbs = [];
+    }
+    add(message, extra) {
+        this.addBreadcrumb(new breadcrumb_model_1.BreadcrumbModel(message, extra));
+    }
+    addBreadcrumb(breadcrumb) {
+        this.breadcrumbs.push(breadcrumb);
+    }
+};
+exports.BreadcrumbHandler = BreadcrumbHandler;
+exports.BreadcrumbHandler = BreadcrumbHandler = __decorate([
+    (0, common_1.moduleScoped)(logging_module_keyname_1.LoggingModuleKeyname),
+    (0, common_1.tag)("BreadcrumbHandlerInterface"),
+    (0, tsyringe_1.injectable)(),
+    (0, tsyringe_1.scoped)(tsyringe_1.Lifecycle.ContainerScoped)
+], BreadcrumbHandler);
+//# sourceMappingURL=breadcrumb.handler.js.map

package/dist/lib/cjs/handlers/breadcrumb.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.handler.js","sourceRoot":"","sources":["../../../../src/handlers/breadcrumb.handler.ts"],"names":[],"mappings":";;;;;;;;;AAAA,sEAA+D;AAE/D,uCAAqF;AACrF,gDAM6B;AAC7B,iEAA2D;AAMpD,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAAvB;QACW,gBAAW,GAAsB,EAAE,CAAC;IAStD,CAAC;IAPC,GAAG,CAAC,OAAe,EAAE,KAAU;QAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,kCAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,aAAa,CAAC,UAA2B;QACvC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AAVY,8CAAiB;4BAAjB,iBAAiB;IAJ7B,IAAA,qBAAY,EAAC,6CAAoB,CAAC;IAClC,IAAA,YAAG,EAAC,4BAA4B,CAAC;IACjC,IAAA,qBAAU,GAAE;IACZ,IAAA,iBAAM,EAAC,oBAAS,CAAC,eAAe,CAAC;GACrB,iBAAiB,CAU7B"}

package/dist/lib/cjs/handlers/handlers.js

@@ -14,5 +14,6 @@ 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("./breadcrumb.handler"), exports);
 __exportStar(require("./log.handler"), exports);
 //# sourceMappingURL=handlers.js.map

package/dist/lib/cjs/handlers/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../../src/handlers/handlers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../../src/handlers/handlers.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,gDAA8B"}

package/dist/lib/cjs/handlers/log.handler.js

@@ -32,13 +32,15 @@ let LogHandler = class LogHandler {
      * @param logSeverityLevelConfiguration The severity from which to start logging the logs.
      * @param activateDiagnostics Whether or not the outputted logs should contain the diagnostic part. This is an intensive process and can dramatically reduce the performance of the code.
      * @param kernelInstantiationId The id of instantiation of the kernel.
+     * @param breadcrumbHandler The Breadcrumb handler to get all the latest breadcrumbs.
      * @param tracingContext The context of the tracing.
      */
-    constructor(loggers, logSeverityLevelConfiguration, activateDiagnostics, kernelInstantiationId, tracingContext) {
+    constructor(loggers, logSeverityLevelConfiguration, activateDiagnostics, kernelInstantiationId, breadcrumbHandler, tracingContext) {
         this.loggers = loggers;
         this.logSeverityLevelConfiguration = logSeverityLevelConfiguration;
         this.activateDiagnostics = activateDiagnostics;
         this.kernelInstantiationId = kernelInstantiationId;
+        this.breadcrumbHandler = breadcrumbHandler;
         this.tracingContext = tracingContext;
     }
     /**
@@ -51,69 +53,78 @@ let LogHandler = class LogHandler {
     }
     /**
      * Logs the message if the severity is set to critical or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    critical(message, extra, module = "application") {
-        return this.log(message, severity_enum_1.SeverityEnum.Critical, extra, module);
+    critical(message, data, breadcrumb) {
+        return this.log(message, severity_enum_1.SeverityEnum.Critical, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to error or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    error(message, extra, module = "application") {
-        return this.log(message, severity_enum_1.SeverityEnum.Error, extra, module);
+    error(message, data, breadcrumb) {
+        return this.log(message, severity_enum_1.SeverityEnum.Error, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to warning or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    warning(message, extra, module = "application") {
-        return this.log(message, severity_enum_1.SeverityEnum.Warning, extra, module);
+    warning(message, data, breadcrumb) {
+        return this.log(message, severity_enum_1.SeverityEnum.Warning, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to info or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    info(message, extra, module = "application") {
-        return this.log(message, severity_enum_1.SeverityEnum.Info, extra, module);
+    info(message, data, breadcrumb) {
+        return this.log(message, severity_enum_1.SeverityEnum.Info, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to debug or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    debug(message, extra, module = "application") {
-        return this.log(message, severity_enum_1.SeverityEnum.Debug, extra, module);
+    debug(message, data, breadcrumb) {
+        return this.log(message, severity_enum_1.SeverityEnum.Debug, data, breadcrumb);
     }
     /**
      * Logs the message based on the severity.
      * @param message The message to log.
      * @param severity The minimum severity to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    log(message, severity = severity_enum_1.SeverityEnum.Error, extra, module = "application") {
-        var _a;
+    log(message, severity, data, breadcrumb) {
+        var _a, _b;
         const log = new log_model_1.LogModel(severity, message);
         log.kernelInstantiationId = this.kernelInstantiationId;
         log.traceId = this.tracingContext.traceId;
-        log.extra = extra;
-        log.module = module;
         log.date = new Date();
+        if (breadcrumb) {
+            this.breadcrumbHandler.add(breadcrumb);
+        }
+        log.breadcrumbs = this.breadcrumbHandler.breadcrumbs;
+        // Handle the data parameter to extract highlights and extra information.
+        if (data) {
+            // Check if data is in the structured format { highlights, extra }
+            if (typeof data === 'object' && data !== null && !Array.isArray(data) && (data.hasOwnProperty('highlights') || data.hasOwnProperty('extra'))) {
+                log.highlights = (_a = data.highlights) !== null && _a !== void 0 ? _a : {};
+                log.extra = data.extra;
+            }
+            else {
+                // Otherwise, treat the entire data object as 'extra'
+                log.extra = data;
+            }
+        }
         // If the activateDiagnostics configuration is set to true, we will include additional information into a __diagnostics path into extra.
         // This is an intensive process so be careful, it will dramatically slow down your calls.
         if (this.activateDiagnostics) {
@@ -127,12 +138,16 @@ let LogHandler = class LogHandler {
                 diagnostics.lastStackTrace = stackTrace;
                 break;
             }
+            // Ensure log.extra is an object before adding diagnostics
+            if (typeof log.extra !== 'object' || log.extra === null) {
+                log.extra = { originalData: log.extra };
+            }
             log.extra["__diagnostics"] = diagnostics;
         }
         // Log in every logger that is activated.
         for (const logger of this.loggers) {
             if (logger.isActive()) {
-                (_a = logger.readableStream) === null || _a === void 0 ? void 0 : _a.push(log);
+                (_b = logger.readableStream) === null || _b === void 0 ? void 0 : _b.push(log);
             }
         }
     }
@@ -147,6 +162,7 @@ exports.LogHandler = LogHandler = __decorate([
     __param(1, (0, tsyringe_1.inject)("%pristine.logging.logSeverityLevelConfiguration%")),
     __param(2, (0, tsyringe_1.inject)("%pristine.logging.activateDiagnostics%")),
     __param(3, (0, tsyringe_1.inject)(common_1.InternalContainerParameterEnum.KernelInstantiationId)),
-    __metadata("design:paramtypes", [Array, Number, Boolean, String, common_1.TracingContext])
+    __param(4, (0, tsyringe_1.inject)("BreadcrumbHandlerInterface")),
+    __metadata("design:paramtypes", [Array, Number, Boolean, String, Object, common_1.TracingContext])
 ], LogHandler);
 //# sourceMappingURL=log.handler.js.map

package/dist/lib/cjs/handlers/log.handler.js.map

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

package/dist/lib/cjs/interfaces/breadcrumb-handler.interface.js

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

package/dist/lib/cjs/interfaces/breadcrumb-handler.interface.js.map

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

package/dist/lib/cjs/interfaces/interfaces.js

@@ -14,6 +14,7 @@ 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("./breadcrumb-handler.interface"), exports);
 __exportStar(require("./logger.interface"), exports);
 __exportStar(require("./log-handler.interface"), exports);
 //# sourceMappingURL=interfaces.js.map

package/dist/lib/cjs/interfaces/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,0DAAwC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iEAA+C;AAC/C,qDAAmC;AACnC,0DAAwC"}

package/dist/lib/cjs/logging.module.js

@@ -24,9 +24,10 @@ __exportStar(require("./enums/enums"), exports);
 __exportStar(require("./interfaces/interfaces"), exports);
 __exportStar(require("./loggers/loggers"), exports);
 __exportStar(require("./models/models"), exports);
-__exportStar(require("./utils/utils"), exports);
 __exportStar(require("./logging.module.keyname"), exports);
 __exportStar(require("./handlers/handlers"), exports);
+__exportStar(require("./types/types"), exports);
+__exportStar(require("./utils/utils"), exports);
 exports.LoggingModule = {
     keyname: logging_module_keyname_1.LoggingModuleKeyname,
     configurationDefinitions: [

package/dist/lib/cjs/logging.module.js.map

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

package/dist/lib/cjs/models/breadcrumb.model.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BreadcrumbModel = void 0;
+class BreadcrumbModel {
+    constructor(message, extra) {
+        /**
+         * The date at which the breadcrumb was created.
+         */
+        this.date = new Date();
+        this.message = message;
+        this.extra = extra;
+    }
+}
+exports.BreadcrumbModel = BreadcrumbModel;
+//# sourceMappingURL=breadcrumb.model.js.map

package/dist/lib/cjs/models/breadcrumb.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.model.js","sourceRoot":"","sources":["../../../../src/models/breadcrumb.model.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAe;IAgB1B,YACE,OAAe,EACf,KAAW;QAjBb;;WAEG;QACH,SAAI,GAAS,IAAI,IAAI,EAAE,CAAC;QAgBtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAvBD,0CAuBC"}

package/dist/lib/cjs/models/log.model.js

@@ -20,8 +20,18 @@ class LogModel {
         /**
          * The module from which the log originated.
          * By default it will be the application module.
+         * @deprecated: Use breadcrumbs instead.
          */
         this.module = "application";
+        /**
+         * The list of breadcrumbs that led to this log.
+         */
+        this.breadcrumbs = [];
+        /**
+         * This is an object that is data that you want to "highlights" and show as logs. Select and be careful about what
+         * you choose to highlight to avoid showing to many useless things.
+         */
+        this.highlights = {};
     }
 }
 exports.LogModel = LogModel;

package/dist/lib/cjs/models/log.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.model.js","sourceRoot":"","sources":["../../../../src/models/log.model.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,QAAQ;IA2BnB;;;;OAIG;IACH,YAAmB,QAAsB,EAAS,OAAe;QAA9C,aAAQ,GAAR,QAAQ,CAAc;QAAS,YAAO,GAAP,OAAO,CAAQ;QArBjE;;WAEG;QACH,SAAI,GAAS,IAAI,IAAI,EAAE,CAAC;QAExB;;;WAGG;QACH,WAAM,GAAW,aAAa,CAAC;IAa/B,CAAC;CAEF;AAnCD,4BAmCC"}
+{"version":3,"file":"log.model.js","sourceRoot":"","sources":["../../../../src/models/log.model.ts"],"names":[],"mappings":";;;AAIA;;GAEG;AACH,MAAa,QAAQ;IAuCnB;;;;OAIG;IACH,YAAmB,QAAsB,EAAS,OAAe;QAA9C,aAAQ,GAAR,QAAQ,CAAc;QAAS,YAAO,GAAP,OAAO,CAAQ;QAjCjE;;WAEG;QACH,SAAI,GAAS,IAAI,IAAI,EAAE,CAAC;QAExB;;;;WAIG;QACH,WAAM,GAAW,aAAa,CAAC;QAO/B;;WAEG;QACH,gBAAW,GAAsB,EAAE,CAAC;QAEpC;;;WAGG;QACH,eAAU,GAAkB,EAAE,CAAC;IAQ/B,CAAC;CAEF;AA/CD,4BA+CC"}

package/dist/lib/cjs/models/models.js

@@ -14,6 +14,7 @@ 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("./breadcrumb.model"), exports);
 __exportStar(require("./diagnostics.model"), exports);
 __exportStar(require("./log.model"), exports);
 //# sourceMappingURL=models.js.map

package/dist/lib/cjs/models/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/models/models.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,8CAA4B"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/models/models.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,sDAAoC;AACpC,8CAA4B"}

package/dist/lib/cjs/types/log-highlights.type.js

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

package/dist/lib/cjs/types/log-highlights.type.js.map

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

package/dist/lib/cjs/types/types.js

@@ -0,0 +1,18 @@
+"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("./log-highlights.type"), exports);
+//# sourceMappingURL=types.js.map

package/dist/lib/cjs/types/types.js.map

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

package/dist/lib/esm/handlers/breadcrumb.handler.js

@@ -0,0 +1,29 @@
+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;
+};
+import { LoggingModuleKeyname } from "../logging.module.keyname";
+import { injectable, scoped, Lifecycle } from "tsyringe";
+import { tag, moduleScoped } from "@pristine-ts/common";
+import { BreadcrumbModel } from "../models/breadcrumb.model";
+let BreadcrumbHandler = class BreadcrumbHandler {
+    constructor() {
+        this.breadcrumbs = [];
+    }
+    add(message, extra) {
+        this.addBreadcrumb(new BreadcrumbModel(message, extra));
+    }
+    addBreadcrumb(breadcrumb) {
+        this.breadcrumbs.push(breadcrumb);
+    }
+};
+BreadcrumbHandler = __decorate([
+    moduleScoped(LoggingModuleKeyname),
+    tag("BreadcrumbHandlerInterface"),
+    injectable(),
+    scoped(Lifecycle.ContainerScoped)
+], BreadcrumbHandler);
+export { BreadcrumbHandler };
+//# sourceMappingURL=breadcrumb.handler.js.map

package/dist/lib/esm/handlers/breadcrumb.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.handler.js","sourceRoot":"","sources":["../../../../src/handlers/breadcrumb.handler.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAC,UAAU,EAAgC,MAAM,EAAE,SAAS,EAAC,MAAM,UAAU,CAAC;AACrF,OAAO,EAEL,GAAG,EAGH,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAC,eAAe,EAAC,MAAM,4BAA4B,CAAC;AAMpD,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;IAAvB;QACW,gBAAW,GAAsB,EAAE,CAAC;IAStD,CAAC;IAPC,GAAG,CAAC,OAAe,EAAE,KAAU;QAC7B,IAAI,CAAC,aAAa,CAAC,IAAI,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,aAAa,CAAC,UAA2B;QACvC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,CAAC;CACF,CAAA;AAVY,iBAAiB;IAJ7B,YAAY,CAAC,oBAAoB,CAAC;IAClC,GAAG,CAAC,4BAA4B,CAAC;IACjC,UAAU,EAAE;IACZ,MAAM,CAAC,SAAS,CAAC,eAAe,CAAC;GACrB,iBAAiB,CAU7B"}

package/dist/lib/esm/handlers/handlers.js

@@ -1,2 +1,3 @@
+export * from "./breadcrumb.handler";
 export * from "./log.handler";
 //# sourceMappingURL=handlers.js.map

package/dist/lib/esm/handlers/handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../../src/handlers/handlers.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../../../../src/handlers/handlers.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/lib/esm/handlers/log.handler.js

@@ -29,13 +29,15 @@ let LogHandler = class LogHandler {
      * @param logSeverityLevelConfiguration The severity from which to start logging the logs.
      * @param activateDiagnostics Whether or not the outputted logs should contain the diagnostic part. This is an intensive process and can dramatically reduce the performance of the code.
      * @param kernelInstantiationId The id of instantiation of the kernel.
+     * @param breadcrumbHandler The Breadcrumb handler to get all the latest breadcrumbs.
      * @param tracingContext The context of the tracing.
      */
-    constructor(loggers, logSeverityLevelConfiguration, activateDiagnostics, kernelInstantiationId, tracingContext) {
+    constructor(loggers, logSeverityLevelConfiguration, activateDiagnostics, kernelInstantiationId, breadcrumbHandler, tracingContext) {
         this.loggers = loggers;
         this.logSeverityLevelConfiguration = logSeverityLevelConfiguration;
         this.activateDiagnostics = activateDiagnostics;
         this.kernelInstantiationId = kernelInstantiationId;
+        this.breadcrumbHandler = breadcrumbHandler;
         this.tracingContext = tracingContext;
     }
     /**
@@ -48,69 +50,78 @@ let LogHandler = class LogHandler {
     }
     /**
      * Logs the message if the severity is set to critical or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    critical(message, extra, module = "application") {
-        return this.log(message, SeverityEnum.Critical, extra, module);
+    critical(message, data, breadcrumb) {
+        return this.log(message, SeverityEnum.Critical, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to error or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    error(message, extra, module = "application") {
-        return this.log(message, SeverityEnum.Error, extra, module);
+    error(message, data, breadcrumb) {
+        return this.log(message, SeverityEnum.Error, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to warning or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    warning(message, extra, module = "application") {
-        return this.log(message, SeverityEnum.Warning, extra, module);
+    warning(message, data, breadcrumb) {
+        return this.log(message, SeverityEnum.Warning, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to info or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    info(message, extra, module = "application") {
-        return this.log(message, SeverityEnum.Info, extra, module);
+    info(message, data, breadcrumb) {
+        return this.log(message, SeverityEnum.Info, data, breadcrumb);
     }
     /**
      * Logs the message if the severity is set to debug or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    debug(message, extra, module = "application") {
-        return this.log(message, SeverityEnum.Debug, extra, module);
+    debug(message, data, breadcrumb) {
+        return this.log(message, SeverityEnum.Debug, data, breadcrumb);
     }
     /**
      * Logs the message based on the severity.
      * @param message The message to log.
      * @param severity The minimum severity to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    log(message, severity = SeverityEnum.Error, extra, module = "application") {
-        var _a;
+    log(message, severity, data, breadcrumb) {
+        var _a, _b;
         const log = new LogModel(severity, message);
         log.kernelInstantiationId = this.kernelInstantiationId;
         log.traceId = this.tracingContext.traceId;
-        log.extra = extra;
-        log.module = module;
         log.date = new Date();
+        if (breadcrumb) {
+            this.breadcrumbHandler.add(breadcrumb);
+        }
+        log.breadcrumbs = this.breadcrumbHandler.breadcrumbs;
+        // Handle the data parameter to extract highlights and extra information.
+        if (data) {
+            // Check if data is in the structured format { highlights, extra }
+            if (typeof data === 'object' && data !== null && !Array.isArray(data) && (data.hasOwnProperty('highlights') || data.hasOwnProperty('extra'))) {
+                log.highlights = (_a = data.highlights) !== null && _a !== void 0 ? _a : {};
+                log.extra = data.extra;
+            }
+            else {
+                // Otherwise, treat the entire data object as 'extra'
+                log.extra = data;
+            }
+        }
         // If the activateDiagnostics configuration is set to true, we will include additional information into a __diagnostics path into extra.
         // This is an intensive process so be careful, it will dramatically slow down your calls.
         if (this.activateDiagnostics) {
@@ -124,12 +135,16 @@ let LogHandler = class LogHandler {
                 diagnostics.lastStackTrace = stackTrace;
                 break;
             }
+            // Ensure log.extra is an object before adding diagnostics
+            if (typeof log.extra !== 'object' || log.extra === null) {
+                log.extra = { originalData: log.extra };
+            }
             log.extra["__diagnostics"] = diagnostics;
         }
         // Log in every logger that is activated.
         for (const logger of this.loggers) {
             if (logger.isActive()) {
-                (_a = logger.readableStream) === null || _a === void 0 ? void 0 : _a.push(log);
+                (_b = logger.readableStream) === null || _b === void 0 ? void 0 : _b.push(log);
             }
         }
     }
@@ -143,7 +158,8 @@ LogHandler = __decorate([
     __param(1, inject("%pristine.logging.logSeverityLevelConfiguration%")),
     __param(2, inject("%pristine.logging.activateDiagnostics%")),
     __param(3, inject(InternalContainerParameterEnum.KernelInstantiationId)),
-    __metadata("design:paramtypes", [Array, Number, Boolean, String, TracingContext])
+    __param(4, inject("BreadcrumbHandlerInterface")),
+    __metadata("design:paramtypes", [Array, Number, Boolean, String, Object, TracingContext])
 ], LogHandler);
 export { LogHandler };
 //# sourceMappingURL=log.handler.js.map

package/dist/lib/esm/handlers/log.handler.js.map

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

package/dist/lib/esm/interfaces/breadcrumb-handler.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=breadcrumb-handler.interface.js.map

package/dist/lib/esm/interfaces/breadcrumb-handler.interface.js.map

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

package/dist/lib/esm/interfaces/interfaces.js

@@ -1,3 +1,4 @@
+export * from "./breadcrumb-handler.interface";
 export * from "./logger.interface";
 export * from "./log-handler.interface";
 //# sourceMappingURL=interfaces.js.map

package/dist/lib/esm/interfaces/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../../src/interfaces/interfaces.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC"}

package/dist/lib/esm/logging.module.js

@@ -7,9 +7,10 @@ export * from "./enums/enums";
 export * from "./interfaces/interfaces";
 export * from "./loggers/loggers";
 export * from "./models/models";
-export * from "./utils/utils";
 export * from "./logging.module.keyname";
 export * from "./handlers/handlers";
+export * from "./types/types";
+export * from "./utils/utils";
 export const LoggingModule = {
     keyname: LoggingModuleKeyname,
     configurationDefinitions: [

package/dist/lib/esm/logging.module.js.map

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

package/dist/lib/esm/models/breadcrumb.model.js

@@ -0,0 +1,11 @@
+export class BreadcrumbModel {
+    constructor(message, extra) {
+        /**
+         * The date at which the breadcrumb was created.
+         */
+        this.date = new Date();
+        this.message = message;
+        this.extra = extra;
+    }
+}
+//# sourceMappingURL=breadcrumb.model.js.map

package/dist/lib/esm/models/breadcrumb.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumb.model.js","sourceRoot":"","sources":["../../../../src/models/breadcrumb.model.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAe;IAgB1B,YACE,OAAe,EACf,KAAW;QAjBb;;WAEG;QACH,SAAI,GAAS,IAAI,IAAI,EAAE,CAAC;QAgBtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/dist/lib/esm/models/log.model.js

@@ -17,8 +17,18 @@ export class LogModel {
         /**
          * The module from which the log originated.
          * By default it will be the application module.
+         * @deprecated: Use breadcrumbs instead.
          */
         this.module = "application";
+        /**
+         * The list of breadcrumbs that led to this log.
+         */
+        this.breadcrumbs = [];
+        /**
+         * This is an object that is data that you want to "highlights" and show as logs. Select and be careful about what
+         * you choose to highlight to avoid showing to many useless things.
+         */
+        this.highlights = {};
     }
 }
 //# sourceMappingURL=log.model.js.map

package/dist/lib/esm/models/log.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"log.model.js","sourceRoot":"","sources":["../../../../src/models/log.model.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,QAAQ;IA2BnB;;;;OAIG;IACH,YAAmB,QAAsB,EAAS,OAAe;QAA9C,aAAQ,GAAR,QAAQ,CAAc;QAAS,YAAO,GAAP,OAAO,CAAQ;QArBjE;;WAEG;QACH,SAAI,GAAS,IAAI,IAAI,EAAE,CAAC;QAExB;;;WAGG;QACH,WAAM,GAAW,aAAa,CAAC;IAa/B,CAAC;CAEF"}
+{"version":3,"file":"log.model.js","sourceRoot":"","sources":["../../../../src/models/log.model.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,QAAQ;IAuCnB;;;;OAIG;IACH,YAAmB,QAAsB,EAAS,OAAe;QAA9C,aAAQ,GAAR,QAAQ,CAAc;QAAS,YAAO,GAAP,OAAO,CAAQ;QAjCjE;;WAEG;QACH,SAAI,GAAS,IAAI,IAAI,EAAE,CAAC;QAExB;;;;WAIG;QACH,WAAM,GAAW,aAAa,CAAC;QAO/B;;WAEG;QACH,gBAAW,GAAsB,EAAE,CAAC;QAEpC;;;WAGG;QACH,eAAU,GAAkB,EAAE,CAAC;IAQ/B,CAAC;CAEF"}

package/dist/lib/esm/models/models.js

@@ -1,3 +1,4 @@
+export * from "./breadcrumb.model";
 export * from "./diagnostics.model";
 export * from "./log.model";
 //# sourceMappingURL=models.js.map

package/dist/lib/esm/models/models.js.map

@@ -1 +1 @@
-{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/models/models.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC"}
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/models/models.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC"}

package/dist/lib/esm/types/log-highlights.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-highlights.type.js.map

package/dist/lib/esm/types/log-highlights.type.js.map

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

package/dist/lib/esm/types/types.js

@@ -0,0 +1,2 @@
+export * from './log-highlights.type';
+//# sourceMappingURL=types.js.map

package/dist/lib/esm/types/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/types/types.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAA"}

package/dist/types/handlers/breadcrumb.handler.d.ts

@@ -0,0 +1,7 @@
+import { BreadcrumbHandlerInterface } from "../interfaces/breadcrumb-handler.interface";
+import { BreadcrumbModel } from "../models/breadcrumb.model";
+export declare class BreadcrumbHandler implements BreadcrumbHandlerInterface {
+    readonly breadcrumbs: BreadcrumbModel[];
+    add(message: string, extra?: any): void;
+    addBreadcrumb(breadcrumb: BreadcrumbModel): void;
+}

package/dist/types/handlers/handlers.d.ts

@@ -1 +1,2 @@
+export * from "./breadcrumb.handler";
 export * from "./log.handler";

package/dist/types/handlers/log.handler.d.ts

@@ -2,6 +2,8 @@ import "reflect-metadata";
 import { LoggerInterface } from "../interfaces/logger.interface";
 import { TracingContext } from "@pristine-ts/common";
 import { LogHandlerInterface } from "../interfaces/log-handler.interface";
+import { BreadcrumbHandlerInterface } from "../interfaces/breadcrumb-handler.interface";
+import { LogHighlights } from "../types/log-highlights.type";
 /**
  * The LogHandler to use when we want to output some logs.
  * This handler makes sure that only the right level of logs are outputted, stacks logs, and logs with different loggers.
@@ -12,6 +14,7 @@ export declare class LogHandler implements LogHandlerInterface {
     private readonly logSeverityLevelConfiguration;
     private readonly activateDiagnostics;
     private readonly kernelInstantiationId;
+    private readonly breadcrumbHandler;
     private readonly tracingContext;
     /**
      * The LogHandler to use when we want to output some logs.
@@ -19,59 +22,70 @@ export declare class LogHandler implements LogHandlerInterface {
      * @param logSeverityLevelConfiguration The severity from which to start logging the logs.
      * @param activateDiagnostics Whether or not the outputted logs should contain the diagnostic part. This is an intensive process and can dramatically reduce the performance of the code.
      * @param kernelInstantiationId The id of instantiation of the kernel.
+     * @param breadcrumbHandler The Breadcrumb handler to get all the latest breadcrumbs.
      * @param tracingContext The context of the tracing.
      */
-    constructor(loggers: LoggerInterface[], logSeverityLevelConfiguration: number, activateDiagnostics: boolean, kernelInstantiationId: string, tracingContext: TracingContext);
+    constructor(loggers: LoggerInterface[], logSeverityLevelConfiguration: number, activateDiagnostics: boolean, kernelInstantiationId: string, breadcrumbHandler: BreadcrumbHandlerInterface, tracingContext: TracingContext);
     /**
      * This method terminates the loggers.
      */
     terminate(): void;
     /**
      * Logs the message if the severity is set to critical or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    critical(message: string, extra?: any, module?: string): void;
+    critical(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
      * Logs the message if the severity is set to error or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    error(message: string, extra?: any, module?: string): void;
+    error(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
      * Logs the message if the severity is set to warning or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    warning(message: string, extra?: any, module?: string): void;
+    warning(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
      * Logs the message if the severity is set to info or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    info(message: string, extra?: any, module?: string): void;
+    info(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
      * Logs the message if the severity is set to debug or above.
-     * This function is wrapper function for the log method with the proper severity to make it cleaner when using it in the code.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    debug(message: string, extra?: any, module?: string): void;
+    debug(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
      * Logs the message based on the severity.
      * @param message The message to log.
      * @param severity The minimum severity to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
     private log;
 }

package/dist/types/interfaces/breadcrumb-handler.interface.d.ts

@@ -0,0 +1,14 @@
+import { BreadcrumbModel } from "../models/breadcrumb.model";
+export interface BreadcrumbHandlerInterface {
+    /**
+     * The list of breadcrumbs that led to this point.
+     */
+    breadcrumbs: BreadcrumbModel[];
+    /**
+     * Adds a new breadcrumb to the trail.
+     *
+     * @param message
+     * @param extra
+     */
+    add(message: string, extra?: any): void;
+}

package/dist/types/interfaces/interfaces.d.ts

@@ -1,2 +1,3 @@
+export * from "./breadcrumb-handler.interface";
 export * from "./logger.interface";
 export * from "./log-handler.interface";

package/dist/types/interfaces/log-handler.interface.d.ts

@@ -1,3 +1,4 @@
+import { LogHighlights } from "../types/log-highlights.type";
 /**
  * This interface defines what functions should be implemented by a LogHandler.
  * This interface is what should be injected when you want a LogHandler so that mocking can be done easier.
@@ -6,38 +7,53 @@ export interface LogHandlerInterface {
     /**
      * Logs the message if the severity is set to critical or above.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    critical(message: string, extra?: any, module?: string): void;
+    critical(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
-     * Logs the message if the severity is set to critical or above.
+     * Logs the message if the severity is set to error or above.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    error(message: string, extra?: any, module?: string): void;
+    error(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
-     * Logs the message if the severity is set to critical or above.
+     * Logs the message if the severity is set to warning or above.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    warning(message: string, extra?: any, module?: string): void;
+    warning(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
-     * Logs the message if the severity is set to critical or above.
+     * Logs the message if the severity is set to info or above.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    info(message: string, extra?: any, module?: string): void;
+    info(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
-     * Logs the message if the severity is set to critical or above.
+     * Logs the message if the severity is set to debug or above.
      * @param message The message to log.
-     * @param extra The extra object to log.
-     * @param module The module from where the log was created.
+     * @param data The data being passed to the log
+     * @param breadcrumb The breadcrumb passed to the log to identify where the error originated from.
      */
-    debug(message: string, extra?: any, module?: string): void;
+    debug(message: string, data?: {
+        highlights?: LogHighlights;
+        extra?: any;
+    } | any, breadcrumb?: string): void;
     /**
      * This is called when the log handler is to terminate
      */

package/dist/types/logging.module.d.ts

@@ -3,7 +3,8 @@ export * from "./enums/enums";
 export * from "./interfaces/interfaces";
 export * from "./loggers/loggers";
 export * from "./models/models";
-export * from "./utils/utils";
 export * from "./logging.module.keyname";
 export * from "./handlers/handlers";
+export * from "./types/types";
+export * from "./utils/utils";
 export declare const LoggingModule: ModuleInterface;

package/dist/types/models/breadcrumb.model.d.ts

@@ -0,0 +1,15 @@
+export declare class BreadcrumbModel {
+    /**
+     * The date at which the breadcrumb was created.
+     */
+    date: Date;
+    /**
+     * The message identifying the breadcrumb.
+     */
+    message: string;
+    /**
+     * Extra information attached to the breadcrumb.
+     */
+    extra?: any;
+    constructor(message: string, extra?: any);
+}

package/dist/types/models/log.model.d.ts

@@ -1,4 +1,6 @@
 import { SeverityEnum } from "../enums/severity.enum";
+import { BreadcrumbModel } from "./breadcrumb.model";
+import { LogHighlights } from "../types/log-highlights.type";
 /**
  * The model that represents a log
  */
@@ -20,12 +22,22 @@ export declare class LogModel {
     /**
      * The module from which the log originated.
      * By default it will be the application module.
+     * @deprecated: Use breadcrumbs instead.
      */
     module: string;
     /**
-     * Any extras that need to be outputted along with the message.
+     * Extras are additional data that provide extra context. They should be shown only when deeply investigating.
      */
     extra: any;
+    /**
+     * The list of breadcrumbs that led to this log.
+     */
+    breadcrumbs: BreadcrumbModel[];
+    /**
+     * This is an object that is data that you want to "highlights" and show as logs. Select and be careful about what
+     * you choose to highlight to avoid showing to many useless things.
+     */
+    highlights: LogHighlights;
     /**
      * The model that represents a log
      * @param severity The log severity.

package/dist/types/models/models.d.ts

@@ -1,2 +1,3 @@
+export * from "./breadcrumb.model";
 export * from "./diagnostics.model";
 export * from "./log.model";

package/dist/types/types/log-highlights.type.d.ts

@@ -0,0 +1,3 @@
+export type LogHighlights = {
+    [key in (string | number)]: string | Date | number | boolean;
+};

package/dist/types/types/types.d.ts

@@ -0,0 +1 @@
+export * from './log-highlights.type';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pristine-ts/logging",
-  "version": "0.0.370",
+  "version": "0.0.371",
   "description": "",
   "module": "dist/lib/esm/logging.module.js",
   "main": "dist/lib/cjs/logging.module.js",
@@ -12,8 +12,8 @@
     "test:cov": "jest --coverage"
   },
   "dependencies": {
-    "@pristine-ts/common": "^0.0.370",
-    "@pristine-ts/configuration": "^0.0.370",
+    "@pristine-ts/common": "^0.0.371",
+    "@pristine-ts/configuration": "^0.0.371",
     "date-fns": "^2.30.0"
   },
   "files": [
@@ -58,5 +58,5 @@
       "src/*.{js,ts}"
     ]
   },
-  "gitHead": "10bb6f02300652a66479a51462c38879c6081cc9"
+  "gitHead": "b15f627fcefc822ba75ab4e22568d8cc9aa3e80a"
 }