@pristine-ts/telemetry 1.0.440 → 2.0.2

package/dist/lib/esm/managers/tracing.manager.js

@@ -11,9 +11,10 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { inject, injectable, injectAll, singleton } from "tsyringe";
+import { TelemetryConfigurationKeys } from "../telemetry.configuration-keys";
 import { Trace } from "../models/trace.model";
 import { Span } from "../models/span.model";
-import { moduleScoped, ServiceDefinitionTagEnum, tag, TracingContext } from "@pristine-ts/common";
+import { injectConfig, moduleScoped, ServiceDefinitionTagEnum, tag, TracingContext } from "@pristine-ts/common";
 import { SpanKeynameEnum } from "../enums/span-keyname.enum";
 import { TelemetryModuleKeyname } from "../telemetry.module.keyname";
 /**
@@ -89,43 +90,55 @@ let TracingManager = class TracingManager {
      */
     startSpan(keyname, parentKeyname, parentId, context) {
         var _a;
-        // Check if there's an active trace. If not, start one.
+        // Make sure a trace exists. `startTracing` is the canonical entry point, but a direct
+        // `startSpan` call (e.g. from project code) should auto-start a trace rather than fail.
         if (this.trace === undefined) {
             this.startTracing(SpanKeynameEnum.RootExecution, undefined, context);
         }
-        // Create the new span
-        const span = new Span(keyname, context);
+        // Construct the span. NOTE the third constructor argument: `Span(keyname, id?, context?)`.
+        // A previous version of this code passed `context` in the `id` slot, which corrupted span
+        // identities and broke parent-by-id lookup at line 133 silently. Always pass `undefined`
+        // for the id so a fresh UUID is generated, and put context in the third slot.
+        const span = new Span(keyname, undefined, context);
+        // Defensive: tracing must never throw. If the trace is somehow still undefined here
+        // (an exception inside `startTracing` that we swallowed and logged), return the bare
+        // span so the caller can still call `.end()` on it without exploding.
         if (this.trace === undefined) {
-            this.loghandler.error("The trace should not be undefined at this point.");
-            return span; // Return because tracing should not throw.
+            this.loghandler.error("Trace is undefined after startTracing; returning unattached span.", { span });
+            return span;
         }
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         span.trace = this.trace;
-        // Retrieve the parent and add it to the span.
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        // Resolve the parent span. The default parent is the trace's rootSpan, but we may not
+        // have one if the trace was started via a path that didn't set it (programming error
+        // upstream, but we tolerate it). When no rootSpan exists, attach the new span as a
+        // top-level orphan and warn-log once instead of crashing.
         let parentSpan = this.trace.rootSpan;
-        // Check to find the parentKeyname in our internal map of spans. If n ot, the rootSpan will be the parent since every span
-        // needs at least one parent.
         if (parentKeyname) {
             const parentSpans = this.spans[parentKeyname];
-            // If multiple spans have the same keyname we need an id to find the parent
             if (parentSpans) {
                 if (parentSpans.length > 1) {
-                    if (!parentId) {
-                        //this.loghandler.error("Error finding the parent span, there are multiple spans with that keyname and no id is provided.", {parentKeyname});
-                    }
-                    else {
+                    if (parentId) {
                         parentSpan = (_a = parentSpans.find(span => span.id === parentId)) !== null && _a !== void 0 ? _a : parentSpan;
                     }
+                    // If multiple parents exist with the same keyname and no id was provided, fall back
+                    // to the existing default (rootSpan or whatever parentSpan was) — silent rather
+                    // than noisy because this is recoverable.
                 }
                 else if (parentSpans.length === 1) {
-                    // If only one span has the keyname we can use it
                     parentSpan = parentSpans[0];
                 }
             }
         }
-        // Add the new span as a child of its parent.
-        parentSpan.addChild(span);
+        if (parentSpan === undefined) {
+            this.loghandler.warning("startSpan: no parent span available (rootSpan is undefined). Attaching as orphan.", {
+                keyname,
+                parentKeyname,
+                traceId: this.trace.id,
+            });
+        }
+        else {
+            parentSpan.addChild(span);
+        }
         this.addSpan(span);
         return span;
     }
@@ -134,18 +147,14 @@ let TracingManager = class TracingManager {
      * @param span The span to add.
      */
     addSpan(span) {
-        // Check if there's an active trace. If not, log an error and return;
+        // Tracing must never throw. If there's no active trace, log and return the span
+        // unchanged — caller can still call `.end()` on it because Span.end uses optional
+        // chaining on tracingManager.
         if (this.trace === undefined) {
             this.loghandler.error("You cannot call 'addSpan' without having an existing Trace.", { span });
             return span;
         }
-        // Assign the tracing manager and the current trace to the span.
         span.tracingManager = this;
-        if (this.trace === undefined) {
-            this.loghandler.error("The trace should not be undefined at this point.");
-            return span; // Return because tracing should not throw.
-        }
-        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
         span.trace = this.trace;
         // Add it to the map of spans
         if (!this.spans[span.keyname]) {
@@ -240,23 +249,14 @@ let TracingManager = class TracingManager {
         if (this.isActive === false) {
             return;
         }
-        // Notify the TraceListeners that the Trace was ended.
+        // Notify every registered tracer that the trace ended. The tracers handle their own
+        // formatting + transport (console pretty-print, file dump, X-Ray export, etc.). The
+        // manager itself no longer logs a summary here — `ConsoleTracer` produces a richer
+        // tree-formatted output when the user opts into it.
         this.tracers.forEach((tracer) => {
             var _a;
             (_a = tracer.traceEndedStream) === null || _a === void 0 ? void 0 : _a.push(this.trace);
         });
-        // Trace time
-        // Top 5 longest spans
-        const longestSpans = Object.values(this.spans).flat(2).sort((a, b) => b.getDuration() - a.getDuration());
-        longestSpans.splice(5);
-        this.loghandler.debug("Ending the trace. \n" +
-            "Trace duration: " + this.trace.getDuration() + " ms \n" +
-            "Top 5 longest spans: \n" + longestSpans.map(span => "\t" + span.getDuration() + " ms - " + span.keyname).join("\n"), {
-            extra: {
-                trace: this.trace,
-            },
-            eventId: this.trace.id,
-        });
     }
 };
 TracingManager = __decorate([
@@ -264,10 +264,10 @@ TracingManager = __decorate([
     tag("TracingManagerInterface"),
     singleton(),
     injectable(),
-    __param(0, injectAll(ServiceDefinitionTagEnum.Tracer)),
+    __param(0, injectAll(ServiceDefinitionTagEnum.Tracer, { isOptional: true })),
     __param(1, inject("LogHandlerInterface")),
-    __param(2, inject("%pristine.telemetry.active%")),
-    __param(3, inject("%pristine.telemetry.debug%")),
+    __param(2, injectConfig(TelemetryConfigurationKeys.Active)),
+    __param(3, injectConfig(TelemetryConfigurationKeys.Debug)),
     __metadata("design:paramtypes", [Array, Object, Boolean, Boolean, TracingContext])
 ], TracingManager);
 export { TracingManager };

package/dist/lib/esm/managers/tracing.manager.js.map

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

package/dist/lib/esm/telemetry.configuration-keys.js

@@ -0,0 +1,23 @@
+/**
+ * Typed configuration keys for `@pristine-ts/telemetry`. Use these constants with `@injectConfig`
+ * for autocomplete + rename safety, instead of typing the parameter name as a string.
+ *
+ * ```ts
+ * import {injectConfig} from "@pristine-ts/common";
+ * import {TelemetryConfigurationKeys} from "@pristine-ts/telemetry";
+ *
+ * constructor(@injectConfig(TelemetryConfigurationKeys.Active) value: ...) {}
+ * ```
+ */
+export const TelemetryConfigurationKeys = {
+    Active: "pristine.telemetry.active",
+    Debug: "pristine.telemetry.debug",
+    ConsoleTracerActivated: "pristine.telemetry.console-tracer.activated",
+    ConsoleTracerOutputMode: "pristine.telemetry.console-tracer.output-mode",
+    ConsoleTracerMinimumDurationMs: "pristine.telemetry.console-tracer.minimum-duration-ms",
+    FileTracerActivated: "pristine.telemetry.file-tracer.activated",
+    FileTracerOutputMode: "pristine.telemetry.file-tracer.output-mode",
+    FileTracerDirectory: "pristine.telemetry.file-tracer.directory",
+    FileTracerFilenamePattern: "pristine.telemetry.file-tracer.filename-pattern",
+};
+//# sourceMappingURL=telemetry.configuration-keys.js.map

package/dist/lib/esm/telemetry.configuration-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.configuration-keys.js","sourceRoot":"","sources":["../../../src/telemetry.configuration-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,MAAM,EAAE,2BAA2B;IACnC,KAAK,EAAE,0BAA0B;IACjC,sBAAsB,EAAE,6CAA6C;IACrE,uBAAuB,EAAE,+CAA+C;IACxE,8BAA8B,EAAE,uDAAuD;IACvF,mBAAmB,EAAE,0CAA0C;IAC/D,oBAAoB,EAAE,4CAA4C;IAClE,mBAAmB,EAAE,0CAA0C;IAC/D,yBAAyB,EAAE,iDAAiD;CACpE,CAAC"}

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

@@ -1,12 +1,15 @@
 import { CommonModule } from "@pristine-ts/common";
 import { TelemetryModuleKeyname } from "./telemetry.module.keyname";
 import { LoggingModule } from "@pristine-ts/logging";
-import { BooleanResolver, EnvironmentVariableResolver } from "@pristine-ts/configuration";
+import { BooleanResolver, EnumResolver, EnvironmentVariableResolver, NumberResolver } from "@pristine-ts/configuration";
+import { ConsoleTracerOutputModeEnum } from "./enums/console-tracer-output-mode.enum";
 export * from "./enums/enums";
 export * from "./interfaces/interfaces";
 export * from "./managers/managers";
 export * from "./models/models";
 export * from "./tracers/tracers";
+export * from "./utils/utils";
+export * from "./telemetry.configuration-keys";
 export const TelemetryModule = {
     keyname: TelemetryModuleKeyname,
     importModules: [
@@ -37,6 +40,93 @@ export const TelemetryModule = {
             defaultResolvers: [
                 new BooleanResolver(new EnvironmentVariableResolver("PRISTINE_TRACING_DEBUG")),
             ]
+        },
+        /**
+         * Whether `ConsoleTracer` should print completed traces to stdout. Off by default —
+         * when on, every trace whose duration exceeds `console-tracer.minimum-duration-ms`
+         * is rendered. Best for local development; in production prefer a real backend.
+         */
+        {
+            parameterName: TelemetryModuleKeyname + ".console-tracer.activated",
+            defaultValue: false,
+            isRequired: false,
+            defaultResolvers: [
+                new BooleanResolver(new EnvironmentVariableResolver("PRISTINE_TELEMETRY_CONSOLE_TRACER_ACTIVATED")),
+            ]
+        },
+        /**
+         * Output format for `ConsoleTracer`. See `ConsoleTracerOutputModeEnum`.
+         */
+        {
+            parameterName: TelemetryModuleKeyname + ".console-tracer.output-mode",
+            defaultValue: ConsoleTracerOutputModeEnum.Tree,
+            isRequired: false,
+            defaultResolvers: [
+                new EnumResolver(new EnvironmentVariableResolver("PRISTINE_TELEMETRY_CONSOLE_TRACER_OUTPUT_MODE"), ConsoleTracerOutputModeEnum),
+            ]
+        },
+        /**
+         * Skip rendering traces shorter than this many milliseconds. Useful when most requests
+         * are fast and you only want to see the slow outliers. `0` means render everything.
+         */
+        {
+            parameterName: TelemetryModuleKeyname + ".console-tracer.minimum-duration-ms",
+            defaultValue: 0,
+            isRequired: false,
+            defaultResolvers: [
+                new NumberResolver(new EnvironmentVariableResolver("PRISTINE_TELEMETRY_CONSOLE_TRACER_MINIMUM_DURATION_MS")),
+            ]
+        },
+        /**
+         * Whether `FileTracer` should write completed traces to disk. Off by default. When on,
+         * one file per trace is written to `directory` using `filename-pattern`.
+         */
+        {
+            parameterName: TelemetryModuleKeyname + ".file-tracer.activated",
+            defaultValue: false,
+            isRequired: false,
+            defaultResolvers: [
+                new BooleanResolver(new EnvironmentVariableResolver("PRISTINE_TELEMETRY_FILE_TRACER_ACTIVATED")),
+            ]
+        },
+        /**
+         * Output format for `FileTracer`. Reuses the same enum as `ConsoleTracer` — `json`
+         * is the practical default for files since it's machine-readable.
+         */
+        {
+            parameterName: TelemetryModuleKeyname + ".file-tracer.output-mode",
+            defaultValue: ConsoleTracerOutputModeEnum.Json,
+            isRequired: false,
+            defaultResolvers: [
+                new EnumResolver(new EnvironmentVariableResolver("PRISTINE_TELEMETRY_FILE_TRACER_OUTPUT_MODE"), ConsoleTracerOutputModeEnum),
+            ]
+        },
+        /**
+         * Directory where `FileTracer` writes trace files. Resolved relative to `process.cwd()`
+         * if not absolute. The directory is created on demand if it doesn't exist.
+         */
+        {
+            parameterName: TelemetryModuleKeyname + ".file-tracer.directory",
+            defaultValue: "./traces",
+            isRequired: false,
+            defaultResolvers: [
+                new EnvironmentVariableResolver("PRISTINE_TELEMETRY_FILE_TRACER_DIRECTORY"),
+            ]
+        },
+        /**
+         * Filename pattern for `FileTracer`. Supports the placeholders:
+         *   - `<traceId>` — the trace's UUID (also used as the eventId throughout Pristine)
+         *   - `<date>`    — UTC date as `YYYY-MM-DD`
+         *   - `<timestamp>` — milliseconds since epoch at the moment the trace ended
+         * Default: `<traceId>.json` (or `.txt` if you change the output mode away from json).
+         */
+        {
+            parameterName: TelemetryModuleKeyname + ".file-tracer.filename-pattern",
+            defaultValue: "<traceId>.json",
+            isRequired: false,
+            defaultResolvers: [
+                new EnvironmentVariableResolver("PRISTINE_TELEMETRY_FILE_TRACER_FILENAME_PATTERN"),
+            ]
         }
     ]
 };

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

@@ -1 +1 @@
-{"version":3,"file":"telemetry.module.js","sourceRoot":"","sources":["../../../src/telemetry.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAkB,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAC,sBAAsB,EAAC,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAC,eAAe,EAAE,2BAA2B,EAAC,MAAM,4BAA4B,CAAC;AAExF,cAAc,eAAe,CAAC;AAC9B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAElC,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,OAAO,EAAE,sBAAsB;IAC/B,aAAa,EAAE;QACb,YAAY;QACZ,aAAa;KACd;IACD,qBAAqB,EAAE,EAAE;IACzB,wBAAwB,EAAE;QACxB;;WAEG;QACH;YACE,aAAa,EAAE,sBAAsB,GAAG,SAAS;YACjD,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,KAAK;YACjB,gBAAgB,EAAE;gBAChB,IAAI,eAAe,CAAC,IAAI,2BAA2B,CAAC,4BAA4B,CAAC,CAAC;aACnF;SACF;QACD;;;WAGG;QACH;YACE,aAAa,EAAE,sBAAsB,GAAG,QAAQ;YAChD,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,KAAK;YACjB,gBAAgB,EAAE;gBAChB,IAAI,eAAe,CAAC,IAAI,2BAA2B,CAAC,wBAAwB,CAAC,CAAC;aAC/E;SACF;KACF;CACF,CAAA"}
+{"version":3,"file":"telemetry.module.js","sourceRoot":"","sources":["../../../src/telemetry.module.ts"],"names":[],"mappings":"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"}

package/dist/lib/esm/tracers/console.tracer.js

@@ -0,0 +1,103 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject, injectable, singleton } from "tsyringe";
+import { Readable } from "stream";
+import { injectConfig, moduleScoped, ServiceDefinitionTagEnum, tag } from "@pristine-ts/common";
+import { ConsoleTracerOutputModeEnum } from "../enums/console-tracer-output-mode.enum";
+import { TelemetryConfigurationKeys } from "../telemetry.configuration-keys";
+import { TelemetryModuleKeyname } from "../telemetry.module.keyname";
+import { traceRenderer } from "../utils/trace-renderer";
+/**
+ * `ConsoleTracer` prints a completed trace to stdout when the trace ends. Its main purpose
+ * is **developer-readable feedback during local development**: see what spans ran, in what
+ * order, and which one was the bottleneck — without wiring up an external tracing backend.
+ *
+ * Off by default. Enable via `pristine.telemetry.console-tracer.activated = true` (or
+ * `PRISTINE_TELEMETRY_CONSOLE_TRACER_ACTIVATED=true`). Three output modes:
+ *   - `tree` (default): indented ASCII tree, durations right-aligned, slowest leaf flagged.
+ *   - `json`: pretty-printed JSON dump.
+ *   - `flat`: one line per span, no indentation, start-time-sorted.
+ *
+ * Crash-isolated: a throw inside the formatting code becomes a stderr line, never an
+ * unhandled error or process crash.
+ */
+let ConsoleTracer = class ConsoleTracer {
+    constructor(activated, outputMode, minimumDurationMs, logHandler) {
+        this.activated = activated;
+        this.outputMode = outputMode;
+        this.minimumDurationMs = minimumDurationMs;
+        this.logHandler = logHandler;
+        this.traceEndedStream = new Readable({
+            objectMode: true,
+            read(_size) { return true; },
+        });
+        this.traceEndedStream.on("data", (trace) => {
+            try {
+                this.handleTraceEnded(trace);
+            }
+            catch (error) {
+                this.reportFailure(error);
+            }
+        });
+        this.traceEndedStream.on("error", (error) => {
+            this.reportFailure(error);
+        });
+    }
+    handleTraceEnded(trace) {
+        if (this.activated === false) {
+            return;
+        }
+        if (trace.getDuration() < this.minimumDurationMs) {
+            return;
+        }
+        let output;
+        switch (this.outputMode) {
+            case ConsoleTracerOutputModeEnum.Json:
+                output = traceRenderer.renderJson(trace);
+                break;
+            case ConsoleTracerOutputModeEnum.Flat:
+                output = traceRenderer.renderFlat(trace);
+                break;
+            case ConsoleTracerOutputModeEnum.Tree:
+            default:
+                output = traceRenderer.renderTree(trace);
+                break;
+        }
+        // Write directly to stdout. Going through the LogHandler would (a) tag every trace
+        // line with severity headers the reader doesn't want, and (b) require the user's log
+        // level to be Debug to see anything — defeating the point of opting in.
+        process.stdout.write(output + "\n");
+    }
+    reportFailure(error) {
+        const message = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+        try {
+            process.stderr.write(`[pristine][tracer:ConsoleTracer] ${message}\n`);
+        }
+        catch (_a) {
+            // If stderr is unwritable too, there's nothing useful left to do.
+        }
+    }
+};
+ConsoleTracer = __decorate([
+    moduleScoped(TelemetryModuleKeyname),
+    singleton(),
+    tag(ServiceDefinitionTagEnum.Tracer),
+    injectable(),
+    __param(0, injectConfig(TelemetryConfigurationKeys.ConsoleTracerActivated)),
+    __param(1, injectConfig(TelemetryConfigurationKeys.ConsoleTracerOutputMode)),
+    __param(2, injectConfig(TelemetryConfigurationKeys.ConsoleTracerMinimumDurationMs)),
+    __param(3, inject("LogHandlerInterface")),
+    __metadata("design:paramtypes", [Boolean, String, Number, Object])
+], ConsoleTracer);
+export { ConsoleTracer };
+//# sourceMappingURL=console.tracer.js.map

package/dist/lib/esm/tracers/console.tracer.js.map

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

package/dist/lib/esm/tracers/file.tracer.js

@@ -0,0 +1,125 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import * as fs from "fs";
+import * as path from "path";
+import { Readable } from "stream";
+import { inject, injectable, singleton } from "tsyringe";
+import { injectConfig, moduleScoped, ServiceDefinitionTagEnum, tag } from "@pristine-ts/common";
+import { ConsoleTracerOutputModeEnum } from "../enums/console-tracer-output-mode.enum";
+import { TelemetryConfigurationKeys } from "../telemetry.configuration-keys";
+import { TelemetryModuleKeyname } from "../telemetry.module.keyname";
+import { traceRenderer } from "../utils/trace-renderer";
+/**
+ * `FileTracer` writes one file per completed trace to a configured directory. Files are
+ * named after the trace's id (= eventId throughout Pristine), so locating a request's
+ * trace is `cat traces/<eventId>.json`.
+ *
+ * Off by default. Enable via `pristine.telemetry.file-tracer.activated = true`.
+ *
+ * Configuration:
+ *   - `file-tracer.directory`         — defaults to `./traces`
+ *   - `file-tracer.filename-pattern`  — defaults to `<traceId>.json`. Placeholders:
+ *                                       `<traceId>`, `<date>` (UTC YYYY-MM-DD), `<timestamp>` (ms epoch).
+ *   - `file-tracer.output-mode`       — `json` (default), `tree`, or `flat`.
+ *
+ * Crash-isolated: a write failure (read-only fs, missing permissions, etc.) becomes a
+ * stderr line, never an unhandled error. The framework continues and the next trace is
+ * attempted independently.
+ */
+let FileTracer = class FileTracer {
+    constructor(activated, outputMode, directory, filenamePattern, logHandler) {
+        this.activated = activated;
+        this.outputMode = outputMode;
+        this.directory = directory;
+        this.filenamePattern = filenamePattern;
+        this.logHandler = logHandler;
+        this.traceEndedStream = new Readable({
+            objectMode: true,
+            read(_size) { return true; },
+        });
+        this.traceEndedStream.on("data", (trace) => {
+            try {
+                this.handleTraceEnded(trace);
+            }
+            catch (error) {
+                this.reportFailure(error);
+            }
+        });
+        this.traceEndedStream.on("error", (error) => {
+            this.reportFailure(error);
+        });
+    }
+    handleTraceEnded(trace) {
+        if (this.activated === false) {
+            return;
+        }
+        const content = this.renderTrace(trace);
+        const filename = this.expandFilenamePattern(trace);
+        const absoluteDir = path.resolve(process.cwd(), this.directory);
+        const absoluteFile = path.join(absoluteDir, filename);
+        // Make sure the file's parent directory exists. We mkdir on the file's parent rather
+        // than just `absoluteDir` because filename-pattern can introduce subdirectories
+        // (e.g. `<date>/<traceId>.json` partitions traces into per-day folders). `recursive:
+        // true` is a no-op if the path already exists.
+        fs.mkdirSync(path.dirname(absoluteFile), { recursive: true });
+        // Write the file. We use `writeFileSync` rather than the async equivalent because the
+        // tracer pipeline is synchronous (the framework `.push()`es into the stream and moves
+        // on), and a write that returns a Promise would silently leak rejections. The write
+        // is small (one trace's worth of JSON, typically <50KB), so the sync cost is bounded.
+        fs.writeFileSync(absoluteFile, content);
+    }
+    renderTrace(trace) {
+        switch (this.outputMode) {
+            case ConsoleTracerOutputModeEnum.Tree:
+                return traceRenderer.renderTree(trace);
+            case ConsoleTracerOutputModeEnum.Flat:
+                return traceRenderer.renderFlat(trace);
+            case ConsoleTracerOutputModeEnum.Json:
+            default:
+                return traceRenderer.renderJson(trace);
+        }
+    }
+    expandFilenamePattern(trace) {
+        var _a, _b;
+        const date = new Date((_a = trace.endDate) !== null && _a !== void 0 ? _a : Date.now());
+        const isoDate = date.toISOString().slice(0, 10); // YYYY-MM-DD
+        const timestamp = String((_b = trace.endDate) !== null && _b !== void 0 ? _b : Date.now());
+        return this.filenamePattern
+            .replace(/<traceId>/g, trace.id)
+            .replace(/<date>/g, isoDate)
+            .replace(/<timestamp>/g, timestamp);
+    }
+    reportFailure(error) {
+        const message = error instanceof Error ? `${error.name}: ${error.message}` : String(error);
+        try {
+            process.stderr.write(`[pristine][tracer:FileTracer] ${message}\n`);
+        }
+        catch (_a) {
+            // If stderr is unwritable too, there's nothing useful left to do.
+        }
+    }
+};
+FileTracer = __decorate([
+    moduleScoped(TelemetryModuleKeyname),
+    singleton(),
+    tag(ServiceDefinitionTagEnum.Tracer),
+    injectable(),
+    __param(0, injectConfig(TelemetryConfigurationKeys.FileTracerActivated)),
+    __param(1, injectConfig(TelemetryConfigurationKeys.FileTracerOutputMode)),
+    __param(2, injectConfig(TelemetryConfigurationKeys.FileTracerDirectory)),
+    __param(3, injectConfig(TelemetryConfigurationKeys.FileTracerFilenamePattern)),
+    __param(4, inject("LogHandlerInterface")),
+    __metadata("design:paramtypes", [Boolean, String, String, String, Object])
+], FileTracer);
+export { FileTracer };
+//# sourceMappingURL=file.tracer.js.map

package/dist/lib/esm/tracers/file.tracer.js.map

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

package/dist/lib/esm/tracers/tracers.js

@@ -1,2 +1,3 @@
-export * from "./basic.tracer";
+export * from "./console.tracer";
+export * from "./file.tracer";
 //# sourceMappingURL=tracers.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tracers.js","sourceRoot":"","sources":["../../../../src/tracers/tracers.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"tracers.js","sourceRoot":"","sources":["../../../../src/tracers/tracers.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC"}