autotel-devtools 17.0.0 → 17.1.1

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_http = require('./http-BUHnkhrC.cjs');
+const require_http = require('./http-bOYC2_Z0.cjs');
 const require_listen = require('./listen-DGzVi7DE.cjs');
 let node_http = require("node:http");
 let node_fs = require("node:fs");

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { d as DevtoolsServer, i as probePortHolder, p as hostHeaderIsLoopback, t as attachDevtoolsRoutes } from "./http-yIS667nX.js";
+import { d as DevtoolsServer, i as probePortHolder, p as hostHeaderIsLoopback, t as attachDevtoolsRoutes } from "./http-BLmWVZP0.js";
 import { t as listenLoopbackDualStack } from "./listen-NVMbBWHw.js";
 import { createServer } from "node:http";
 import { readFileSync } from "node:fs";

package/dist/{error-aggregator-bZ-prq97.d.cts → error-aggregator-CGgWr2OH.d.cts}

@@ -1,4 +1,4 @@
-import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-BSIS3Qgy.cjs";
+import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-CEKKJTci.cjs";
 //#region src/server/error-aggregator.d.ts
 interface ErrorAggregatorOptions {
   /**

package/dist/{error-aggregator-BrgYNNoC.d.ts → error-aggregator-DufjI2IG.d.ts}

@@ -1,4 +1,4 @@
-import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-BLqTs00O.js";
+import { a as ErrorGroup, o as ErrorOccurrence, u as TraceData } from "./exporter-BJwufQwg.js";
 //#region src/server/error-aggregator.d.ts
 interface ErrorAggregatorOptions {
   /**

package/dist/{exporter-BLqTs00O.d.ts → exporter-BJwufQwg.d.ts}

@@ -42,6 +42,15 @@ interface TraceData {
   duration: number;
   status: 'OK' | 'ERROR' | 'UNSET';
   service: string;
+  /**
+   * True when no span in this trace is a true root: every span received has a
+   * parent that did not arrive. The trace is a fragment, normally because
+   * sampling kept only part of it or because the rest is still in flight.
+   * `rootSpan` is then the earliest span whose parent is absent rather than the
+   * real root, and the duration covers only the part present. Recomputed as
+   * spans merge, so it clears once the real root arrives.
+   */
+  partial?: boolean;
 }
 interface LogData {
   id: string;

package/dist/{exporter-BSIS3Qgy.d.cts → exporter-CEKKJTci.d.cts}

@@ -42,6 +42,15 @@ interface TraceData {
   duration: number;
   status: 'OK' | 'ERROR' | 'UNSET';
   service: string;
+  /**
+   * True when no span in this trace is a true root: every span received has a
+   * parent that did not arrive. The trace is a fragment, normally because
+   * sampling kept only part of it or because the rest is still in flight.
+   * `rootSpan` is then the earliest span whose parent is absent rather than the
+   * real root, and the duration covers only the part present. Recomputed as
+   * spans merge, so it clears once the real root arrives.
+   */
+  partial?: boolean;
 }
 interface LogData {
   id: string;

package/dist/{http-yIS667nX.js → http-BLmWVZP0.js}

@@ -1,3 +1,4 @@
+import { t as pickRoot } from "./trace-root-EHnvuA7f.js";
 import { t as getResourceName } from "./resource-utils-B4UVvfnH.js";
 import { createServer } from "node:http";
 import { WebSocket, WebSocketServer } from "ws";
@@ -426,10 +427,13 @@ var DevtoolsServer = class {
 			existing.endTime = Math.max(existing.endTime, trace.endTime);
 			existing.duration = existing.endTime - existing.startTime;
 			if (trace.status === "ERROR") existing.status = "ERROR";
-			const root = existing.spans.find((s) => !s.parentSpanId);
-			if (root) {
-				existing.rootSpan = root;
-				const rootService = root.attributes?.["service.name"];
+			existing.spans.sort((a, b) => a.startTime - b.startTime);
+			const { rootSpan, partial } = pickRoot(existing.spans);
+			existing.rootSpan = rootSpan;
+			if (partial) existing.partial = true;
+			else {
+				delete existing.partial;
+				const rootService = rootSpan.attributes?.["service.name"];
 				if (typeof rootService === "string" && rootService.length > 0) existing.service = rootService;
 			}
 		} else this.traces = appendWithLimit(this.traces, trace, this.limits.maxTraceCount);
@@ -635,7 +639,7 @@ function parseOtlpTraces(payload) {
 	const traces = [];
 	for (const [traceId, { spans, service }] of traceMap) {
 		const sorted = spans.sort((a, b) => a.startTime - b.startTime);
-		const rootSpan = sorted.find((s) => !s.parentSpanId) || sorted[0];
+		const { rootSpan, partial } = pickRoot(sorted);
 		const startTime = Math.min(...sorted.map((s) => s.startTime));
 		const endTime = Math.max(...sorted.map((s) => s.endTime));
 		const hasError = sorted.some((s) => s.status.code === "ERROR");
@@ -648,7 +652,8 @@ function parseOtlpTraces(payload) {
 			endTime,
 			duration: endTime - startTime,
 			status: hasError ? "ERROR" : "OK",
-			service
+			service,
+			...partial ? { partial: true } : {}
 		});
 	}
 	return traces;

package/dist/{http-BUHnkhrC.cjs → http-bOYC2_Z0.cjs}

@@ -25,6 +25,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
+const require_trace_root = require('./trace-root-BMa667jK.cjs');
 const require_resource_utils = require('./resource-utils-DjHJB6uc.cjs');
 let node_http = require("node:http");
 let ws = require("ws");
@@ -454,10 +455,13 @@ var DevtoolsServer = class {
 			existing.endTime = Math.max(existing.endTime, trace.endTime);
 			existing.duration = existing.endTime - existing.startTime;
 			if (trace.status === "ERROR") existing.status = "ERROR";
-			const root = existing.spans.find((s) => !s.parentSpanId);
-			if (root) {
-				existing.rootSpan = root;
-				const rootService = root.attributes?.["service.name"];
+			existing.spans.sort((a, b) => a.startTime - b.startTime);
+			const { rootSpan, partial } = require_trace_root.pickRoot(existing.spans);
+			existing.rootSpan = rootSpan;
+			if (partial) existing.partial = true;
+			else {
+				delete existing.partial;
+				const rootService = rootSpan.attributes?.["service.name"];
 				if (typeof rootService === "string" && rootService.length > 0) existing.service = rootService;
 			}
 		} else this.traces = appendWithLimit(this.traces, trace, this.limits.maxTraceCount);
@@ -663,7 +667,7 @@ function parseOtlpTraces(payload) {
 	const traces = [];
 	for (const [traceId, { spans, service }] of traceMap) {
 		const sorted = spans.sort((a, b) => a.startTime - b.startTime);
-		const rootSpan = sorted.find((s) => !s.parentSpanId) || sorted[0];
+		const { rootSpan, partial } = require_trace_root.pickRoot(sorted);
 		const startTime = Math.min(...sorted.map((s) => s.startTime));
 		const endTime = Math.max(...sorted.map((s) => s.endTime));
 		const hasError = sorted.some((s) => s.status.code === "ERROR");
@@ -676,7 +680,8 @@ function parseOtlpTraces(payload) {
 			endTime,
 			duration: endTime - startTime,
 			status: hasError ? "ERROR" : "OK",
-			service
+			service,
+			...partial ? { partial: true } : {}
 		});
 	}
 	return traces;

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_http = require('./http-BUHnkhrC.cjs');
+const require_http = require('./http-bOYC2_Z0.cjs');
 const require_listen = require('./listen-DGzVi7DE.cjs');
 const require_server_exporter = require('./server/exporter.cjs');
 const require_server_log_exporter = require('./server/log-exporter.cjs');

package/dist/index.d.cts

@@ -1,7 +1,7 @@
-import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "./exporter-BSIS3Qgy.cjs";
+import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "./exporter-CEKKJTci.cjs";
 import { DevtoolsLogExporter } from "./server/log-exporter.cjs";
 import { DevtoolsRemoteExporter } from "./server/remote-exporter.cjs";
-import { t as ErrorAggregator } from "./error-aggregator-bZ-prq97.cjs";
+import { t as ErrorAggregator } from "./error-aggregator-CGgWr2OH.cjs";
 import { Server } from "node:http";
 //#region src/index.d.ts
 interface CreateDevtoolsOptions {

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "./exporter-BLqTs00O.js";
+import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "./exporter-BJwufQwg.js";
 import { DevtoolsLogExporter } from "./server/log-exporter.js";
 import { DevtoolsRemoteExporter } from "./server/remote-exporter.js";
-import { t as ErrorAggregator } from "./error-aggregator-BrgYNNoC.js";
+import { t as ErrorAggregator } from "./error-aggregator-DufjI2IG.js";
 import { Server } from "node:http";
 //#region src/index.d.ts
 interface CreateDevtoolsOptions {

package/dist/index.js

@@ -1,4 +1,4 @@
-import { b as ErrorAggregator, d as DevtoolsServer, p as hostHeaderIsLoopback, t as attachDevtoolsRoutes } from "./http-yIS667nX.js";
+import { b as ErrorAggregator, d as DevtoolsServer, p as hostHeaderIsLoopback, t as attachDevtoolsRoutes } from "./http-BLmWVZP0.js";
 import { t as listenLoopbackDualStack } from "./listen-NVMbBWHw.js";
 import { DevtoolsSpanExporter } from "./server/exporter.js";
 import { DevtoolsLogExporter } from "./server/log-exporter.js";

package/dist/server/exporter.cjs

@@ -1,4 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_trace_root = require('../trace-root-BMa667jK.cjs');
 
 //#region src/server/exporter.ts
 var DevtoolsSpanExporter = class {
@@ -45,8 +46,8 @@ var DevtoolsSpanExporter = class {
 	*/
 	convertToTraceData(traceId, spans) {
 		const spanData = spans.map((span) => this.convertSpan(span));
-		const rootSpan = spanData.find((s) => !s.parentSpanId) || spanData[0];
 		spanData.sort((a, b) => a.startTime - b.startTime);
+		const { rootSpan, partial } = require_trace_root.pickRoot(spanData);
 		const startTime = Math.min(...spanData.map((s) => s.startTime));
 		const endTime = Math.max(...spanData.map((s) => s.endTime));
 		const status = spanData.some((s) => s.status.code === "ERROR") ? "ERROR" : "OK";
@@ -59,7 +60,8 @@ var DevtoolsSpanExporter = class {
 			endTime,
 			duration: endTime - startTime,
 			status,
-			service: this.serviceName
+			service: this.serviceName,
+			...partial ? { partial: true } : {}
 		};
 	}
 	/**

package/dist/server/exporter.d.cts

@@ -1,2 +1,2 @@
-import { t as DevtoolsSpanExporter } from "../exporter-BSIS3Qgy.cjs";
+import { t as DevtoolsSpanExporter } from "../exporter-CEKKJTci.cjs";
 export { DevtoolsSpanExporter };

package/dist/server/exporter.d.ts

@@ -1,2 +1,2 @@
-import { t as DevtoolsSpanExporter } from "../exporter-BLqTs00O.js";
+import { t as DevtoolsSpanExporter } from "../exporter-BJwufQwg.js";
 export { DevtoolsSpanExporter };

package/dist/server/exporter.js

@@ -1,3 +1,5 @@
+import { t as pickRoot } from "../trace-root-EHnvuA7f.js";
+
 //#region src/server/exporter.ts
 var DevtoolsSpanExporter = class {
 	server;
@@ -43,8 +45,8 @@ var DevtoolsSpanExporter = class {
 	*/
 	convertToTraceData(traceId, spans) {
 		const spanData = spans.map((span) => this.convertSpan(span));
-		const rootSpan = spanData.find((s) => !s.parentSpanId) || spanData[0];
 		spanData.sort((a, b) => a.startTime - b.startTime);
+		const { rootSpan, partial } = pickRoot(spanData);
 		const startTime = Math.min(...spanData.map((s) => s.startTime));
 		const endTime = Math.max(...spanData.map((s) => s.endTime));
 		const status = spanData.some((s) => s.status.code === "ERROR") ? "ERROR" : "OK";
@@ -57,7 +59,8 @@ var DevtoolsSpanExporter = class {
 			endTime,
 			duration: endTime - startTime,
 			status,
-			service: this.serviceName
+			service: this.serviceName,
+			...partial ? { partial: true } : {}
 		};
 	}
 	/**

package/dist/server/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_http = require('../http-BUHnkhrC.cjs');
+const require_http = require('../http-bOYC2_Z0.cjs');
 const require_server_exporter = require('./exporter.cjs');
 const require_server_log_exporter = require('./log-exporter.cjs');
 const require_server_remote_exporter = require('./remote-exporter.cjs');

package/dist/server/index.d.cts

@@ -1,7 +1,7 @@
-import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, o as ErrorOccurrence, r as DevtoolsServerOptions, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "../exporter-BSIS3Qgy.cjs";
+import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, o as ErrorOccurrence, r as DevtoolsServerOptions, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "../exporter-CEKKJTci.cjs";
 import { DevtoolsLogExporter } from "./log-exporter.cjs";
 import { DevtoolsRemoteExporter, DevtoolsRemoteExporterOptions } from "./remote-exporter.cjs";
-import { t as ErrorAggregator } from "../error-aggregator-bZ-prq97.cjs";
+import { t as ErrorAggregator } from "../error-aggregator-CGgWr2OH.cjs";
 import { Server } from "node:http";
 import { AgentRawEvent, OtelMetricRecord } from "autotel-agents";
 //#region src/server/http.d.ts

package/dist/server/index.d.ts

@@ -1,7 +1,7 @@
-import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, o as ErrorOccurrence, r as DevtoolsServerOptions, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "../exporter-BLqTs00O.js";
+import { a as ErrorGroup, c as MetricData, i as DevtoolsData, l as SpanData, n as DevtoolsServer, o as ErrorOccurrence, r as DevtoolsServerOptions, s as LogData, t as DevtoolsSpanExporter, u as TraceData } from "../exporter-BJwufQwg.js";
 import { DevtoolsLogExporter } from "./log-exporter.js";
 import { DevtoolsRemoteExporter, DevtoolsRemoteExporterOptions } from "./remote-exporter.js";
-import { t as ErrorAggregator } from "../error-aggregator-BrgYNNoC.js";
+import { t as ErrorAggregator } from "../error-aggregator-DufjI2IG.js";
 import { Server } from "node:http";
 import { AgentRawEvent, OtelMetricRecord } from "autotel-agents";
 //#region src/server/http.d.ts

package/dist/server/index.js

@@ -1,4 +1,4 @@
-import { _ as appendWithLimit, a as decodeOtlpLogsRequest, b as ErrorAggregator, c as isProtobufContentType, d as DevtoolsServer, f as allowSensitiveRequest, g as appendManyWithLimit, h as originIsLoopback, i as probePortHolder, l as parseOtlpLogs, m as isLoopbackHostname, n as createDevtoolsHttpServer, o as decodeOtlpMetricsRequest, p as hostHeaderIsLoopback, r as DEVTOOLS_IDENTITY, s as decodeOtlpTraceRequest, t as attachDevtoolsRoutes, u as parseOtlpTraces, v as applyTelemetryLimits, y as resolveTelemetryLimits } from "../http-yIS667nX.js";
+import { _ as appendWithLimit, a as decodeOtlpLogsRequest, b as ErrorAggregator, c as isProtobufContentType, d as DevtoolsServer, f as allowSensitiveRequest, g as appendManyWithLimit, h as originIsLoopback, i as probePortHolder, l as parseOtlpLogs, m as isLoopbackHostname, n as createDevtoolsHttpServer, o as decodeOtlpMetricsRequest, p as hostHeaderIsLoopback, r as DEVTOOLS_IDENTITY, s as decodeOtlpTraceRequest, t as attachDevtoolsRoutes, u as parseOtlpTraces, v as applyTelemetryLimits, y as resolveTelemetryLimits } from "../http-BLmWVZP0.js";
 import { DevtoolsSpanExporter } from "./exporter.js";
 import { DevtoolsLogExporter } from "./log-exporter.js";
 import { DevtoolsRemoteExporter } from "./remote-exporter.js";

package/dist/trace-root-BMa667jK.cjs

@@ -0,0 +1,36 @@
+
+//#region src/server/trace-root.ts
+/**
+* Pick the span to present as the top of a trace, and report whether the real
+* root is missing from `spans`.
+*
+* A true root has no parent at all. Failing that the trace is a fragment, so
+* fall back to the earliest span whose parent did not arrive rather than
+* presenting an arbitrary child as though it were the root. Sampling makes this
+* ordinary: a sender may keep a failed span and drop the routine parent above
+* it, and a receiver that hides the difference makes a half-trace look complete.
+*
+* `partial` is a fact about the span set passed in, not about a batch — spans of
+* one trace arrive across several exports, so recompute this wherever the set
+* grows instead of caching the first answer.
+*
+* Pass spans sorted by start time; the fallbacks then pick the earliest
+* candidate rather than whichever one the caller happened to receive first.
+*/
+function pickRoot(spans) {
+	const present = new Set(spans.map((s) => s.spanId));
+	const trueRoot = spans.find((s) => !s.parentSpanId);
+	const orphan = spans.find((s) => s.parentSpanId && !present.has(s.parentSpanId));
+	return {
+		rootSpan: trueRoot ?? orphan ?? spans[0],
+		partial: !trueRoot
+	};
+}
+
+//#endregion
+Object.defineProperty(exports, 'pickRoot', {
+  enumerable: true,
+  get: function () {
+    return pickRoot;
+  }
+});

package/dist/trace-root-EHnvuA7f.js

@@ -0,0 +1,30 @@
+//#region src/server/trace-root.ts
+/**
+* Pick the span to present as the top of a trace, and report whether the real
+* root is missing from `spans`.
+*
+* A true root has no parent at all. Failing that the trace is a fragment, so
+* fall back to the earliest span whose parent did not arrive rather than
+* presenting an arbitrary child as though it were the root. Sampling makes this
+* ordinary: a sender may keep a failed span and drop the routine parent above
+* it, and a receiver that hides the difference makes a half-trace look complete.
+*
+* `partial` is a fact about the span set passed in, not about a batch — spans of
+* one trace arrive across several exports, so recompute this wherever the set
+* grows instead of caching the first answer.
+*
+* Pass spans sorted by start time; the fallbacks then pick the earliest
+* candidate rather than whichever one the caller happened to receive first.
+*/
+function pickRoot(spans) {
+	const present = new Set(spans.map((s) => s.spanId));
+	const trueRoot = spans.find((s) => !s.parentSpanId);
+	const orphan = spans.find((s) => s.parentSpanId && !present.has(s.parentSpanId));
+	return {
+		rootSpan: trueRoot ?? orphan ?? spans[0],
+		partial: !trueRoot
+	};
+}
+
+//#endregion
+export { pickRoot as t };