@pristine-ts/logging 2.0.2 → 2.0.4

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

@@ -15,13 +15,14 @@ import { inject, injectable, injectAll, Lifecycle, scoped } from "tsyringe";
 import { LoggingConfigurationKeys } from "../logging.configuration-keys";
 import { SeverityEnum } from "../enums/severity.enum";
 import { LogModel } from "../models/log.model";
-import { injectConfig, InternalContainerParameterEnum, moduleScoped, ServiceDefinitionTagEnum, tag, TracingContext } from "@pristine-ts/common";
+import { EventContextManager, injectConfig, InternalContainerParameterEnum, moduleScoped, ServiceDefinitionTagEnum, tag, TracingContext } from "@pristine-ts/common";
 import { Utils } from "../utils/utils";
 import { LoggingModuleKeyname } from "../logging.module";
 /**
- * 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.
- * It is registered with the tag LogHandlerInterface so that it can be injected as a LogHandlerInterface to facilitate mocking.
+ * The LogHandler emits structured log entries through every registered `LoggerInterface`.
+ * Logs carry their own content (message, severity, eventId, traceId, extra, highlights) —
+ * nothing more. "What happened around this log" lives in the trace, not the log: use the
+ * registered tracers (ConsoleTracer, FileTracer, X-Ray, etc.) to render the span tree.
  */
 let LogHandler = class LogHandler {
     /**
@@ -30,15 +31,13 @@ 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, breadcrumbHandler, tracingContext) {
+    constructor(loggers, logSeverityLevelConfiguration, activateDiagnostics, kernelInstantiationId, tracingContext) {
         this.loggers = loggers;
         this.logSeverityLevelConfiguration = logSeverityLevelConfiguration;
         this.activateDiagnostics = activateDiagnostics;
         this.kernelInstantiationId = kernelInstantiationId;
-        this.breadcrumbHandler = breadcrumbHandler;
         this.tracingContext = tracingContext;
     }
     /**
@@ -104,28 +103,37 @@ let LogHandler = class LogHandler {
      * @param data The data being passed to the log
      */
     log(message, severity, data) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         const log = new LogModel(severity, message);
         log.kernelInstantiationId = this.kernelInstantiationId;
-        log.traceId = this.tracingContext.traceId;
+        // Resolve the trace id from the active EventContext first (the path forward), with a
+        // fallback to the legacy `TracingContext` (the per-child-container service that was
+        // the original mechanism). Code that goes through `TracingManager.startTracing` writes
+        // both, so the common path works through either branch; the fallback exists for
+        // pre-ALS code that sets `tracingContext.traceId` directly without involving the
+        // manager. Once `TracingContext` is removed in a future major, this collapses to just
+        // the EventContext read.
+        log.traceId = (_a = EventContextManager.traceId()) !== null && _a !== void 0 ? _a : this.tracingContext.traceId;
         log.date = new Date();
+        // Resolve the eventId once. Explicit `data.eventId` always wins (callers that want
+        // to log against a different event — e.g. a parent log line during fan-out — keep
+        // their override). When the caller didn't pass one, fall back to the active
+        // EventContext so we don't have to thread `eventId: request.id` through every call
+        // site. Outside any EventContext (e.g. logs from boot, before the pipeline starts),
+        // both are undefined and the field is omitted from the output — same as today.
+        const resolvedEventId = (_b = data === null || data === void 0 ? void 0 : data.eventId) !== null && _b !== void 0 ? _b : EventContextManager.eventId();
         // 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') || data.hasOwnProperty('eventId'))) {
-                log.highlights = (_a = data.highlights) !== null && _a !== void 0 ? _a : {};
+                log.highlights = (_c = data.highlights) !== null && _c !== void 0 ? _c : {};
                 log.extra = data.extra;
-                log.eventId = data.eventId;
+                log.eventId = resolvedEventId;
             }
             else {
                 // Otherwise, treat the entire data object as 'extra'
                 log.extra = data;
-            }
-            if (data.breadcrumb) {
-                this.breadcrumbHandler.add(data.eventId, data.breadcrumb);
-            }
-            if (data.eventId) {
-                log.breadcrumbs = this.breadcrumbHandler.breadcrumbs[data.eventId];
+                log.eventId = resolvedEventId;
             }
             if (data.outputHints) {
                 log.outputHints = data.outputHints;
@@ -134,6 +142,11 @@ let LogHandler = class LogHandler {
                 log.eventGroupId = data.eventGroupId;
             }
         }
+        else {
+            // No `data` arg at all — still attach the eventId from the active context so a
+            // bare `logHandler.info("...")` from within a request gets correlated.
+            log.eventId = resolvedEventId;
+        }
         // 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) {
@@ -179,12 +192,12 @@ let LogHandler = class LogHandler {
                 }
             }
             catch (error) {
-                const name = (_c = (_b = logger === null || logger === void 0 ? void 0 : logger.constructor) === null || _b === void 0 ? void 0 : _b.name) !== null && _c !== void 0 ? _c : "UnknownLogger";
+                const name = (_e = (_d = logger === null || logger === void 0 ? void 0 : logger.constructor) === null || _d === void 0 ? void 0 : _d.name) !== null && _e !== void 0 ? _e : "UnknownLogger";
                 const message = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
                 try {
                     process.stderr.write(`[pristine][log-handler] logger '${name}' threw during dispatch: ${message}\n`);
                 }
-                catch (_d) {
+                catch (_f) {
                     // Nothing useful left to do if stderr is unavailable.
                 }
             }
@@ -200,8 +213,7 @@ LogHandler = __decorate([
     __param(1, injectConfig(LoggingConfigurationKeys.LogSeverityLevelConfiguration)),
     __param(2, injectConfig(LoggingConfigurationKeys.ActivateDiagnostics)),
     __param(3, inject(InternalContainerParameterEnum.KernelInstantiationId)),
-    __param(4, inject("BreadcrumbHandlerInterface")),
-    __metadata("design:paramtypes", [Array, Number, Boolean, String, Object, TracingContext])
+    __metadata("design:paramtypes", [Array, Number, Boolean, String, 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/interfaces.js

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

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

@@ -1,5 +1,9 @@
 /**
- * The model that represents a log
+ * The model that represents a log.
+ *
+ * Logs carry their own content only — no inline breadcrumb trail. To reconstruct "what
+ * happened" around a log entry, look at the trace via the registered tracers
+ * (ConsoleTracer, FileTracer, X-Ray, etc.) using the `traceId`/`eventId` on the log.
  */
 export class LogModel {
     /**
@@ -17,25 +21,17 @@ 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 = {};
         /**
-         * Define output hints that can be overriden. It's not authoritative. For example, even though outputBreadcrumbs might
-         * be false, if there's an error, the logger might decide to show them anyway.
+         * Output hints that loggers may use. Not authoritative; loggers retain final say.
          */
-        this.outputHints = {
-            outputBreadcrumbs: false,
-        };
+        this.outputHints = {};
     }
 }
 //# 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":"AAKA;;GAEG;AACH,MAAM,OAAO,QAAQ;IAyDnB;;;;OAIG;IACH,YAAmB,QAAsB,EAAS,OAAe;QAA9C,aAAQ,GAAR,QAAQ,CAAc;QAAS,YAAO,GAAP,OAAO,CAAQ;QAzCjE;;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;QAE/B;;;WAGG;QACH,gBAAW,GAAgB;YACzB,iBAAiB,EAAE,KAAK;SACzB,CAAA;IAQD,CAAC;CAEF"}
+{"version":3,"file":"log.model.js","sourceRoot":"","sources":["../../../../src/models/log.model.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,OAAO,QAAQ;IAgDnB;;;;OAIG;IACH,YAAmB,QAAsB,EAAS,OAAe;QAA9C,aAAQ,GAAR,QAAQ,CAAc;QAAS,YAAO,GAAP,OAAO,CAAQ;QAhCjE;;WAEG;QACH,SAAI,GAAS,IAAI,IAAI,EAAE,CAAC;QAExB;;;WAGG;QACH,WAAM,GAAW,aAAa,CAAC;QAO/B;;;WAGG;QACH,eAAU,GAAkB,EAAE,CAAC;QAE/B;;WAEG;QACH,gBAAW,GAAgB,EAAE,CAAC;IAQ9B,CAAC;CAEF"}

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

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