autotel-devtools 6.0.1 → 6.1.0

package/dist/server/index.d.cts

@@ -24,6 +24,22 @@ declare function parseOtlpLogs(payload: unknown): LogData[];
  */
 declare function isProtobufContentType(contentType?: string): boolean;
 
+/** Value of the `x-autotel-devtools` response header and the /healthz `service` field. */
+declare const DEVTOOLS_IDENTITY = "autotel-devtools";
+/** Who is holding a TCP port, as far as we can tell over HTTP:
+ *  - `autotel-devtools` — another instance of us (benign; the user has two running)
+ *  - `foreign`          — an HTTP server that is NOT us (e.g. an IDE's OTLP collector)
+ *  - `none`             — nothing answered HTTP (refused, timed out, or non-HTTP listener) */
+type PortHolder = 'autotel-devtools' | 'foreign' | 'none';
+/**
+ * Probe `host:port` over HTTP and classify what is listening. Used when our
+ * requested port is busy: it lets us tell "a stale autotel-devtools is still
+ * up" (benign) apart from "a foreign collector owns this port" — the latter is
+ * the silent footgun where apps keep exporting OTLP to the busy port and reach
+ * the wrong process, so the devtools UI stays empty and the app sees errors.
+ */
+declare function probePortHolder(host: string, port: number, timeoutMs?: number): Promise<PortHolder>;
+
 /** Decode an OTLP/protobuf `ExportTraceServiceRequest` into the OTLP/JSON object shape. */
 declare function decodeOtlpTraceRequest(body: Uint8Array): Record<string, unknown>;
 /** Decode an OTLP/protobuf `ExportLogsServiceRequest` into the OTLP/JSON object shape. */
@@ -48,4 +64,4 @@ declare function appendWithLimit<T>(items: T[], item: T, limit: number): T[];
 declare function appendManyWithLimit<T>(items: T[], incoming: T[], limit: number): T[];
 declare function applyTelemetryLimits(data: DevtoolsData, limits: TelemetryLimits): DevtoolsData;
 
-export { DevtoolsData, DevtoolsServer, type HttpServerOptions, LogData, type TelemetryLimits, TraceData, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, isProtobufContentType, parseOtlpLogs, parseOtlpTraces, resolveTelemetryLimits };
+export { DEVTOOLS_IDENTITY, DevtoolsData, DevtoolsServer, type HttpServerOptions, LogData, type PortHolder, type TelemetryLimits, TraceData, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, isProtobufContentType, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits };

package/dist/server/index.d.ts

@@ -24,6 +24,22 @@ declare function parseOtlpLogs(payload: unknown): LogData[];
  */
 declare function isProtobufContentType(contentType?: string): boolean;
 
+/** Value of the `x-autotel-devtools` response header and the /healthz `service` field. */
+declare const DEVTOOLS_IDENTITY = "autotel-devtools";
+/** Who is holding a TCP port, as far as we can tell over HTTP:
+ *  - `autotel-devtools` — another instance of us (benign; the user has two running)
+ *  - `foreign`          — an HTTP server that is NOT us (e.g. an IDE's OTLP collector)
+ *  - `none`             — nothing answered HTTP (refused, timed out, or non-HTTP listener) */
+type PortHolder = 'autotel-devtools' | 'foreign' | 'none';
+/**
+ * Probe `host:port` over HTTP and classify what is listening. Used when our
+ * requested port is busy: it lets us tell "a stale autotel-devtools is still
+ * up" (benign) apart from "a foreign collector owns this port" — the latter is
+ * the silent footgun where apps keep exporting OTLP to the busy port and reach
+ * the wrong process, so the devtools UI stays empty and the app sees errors.
+ */
+declare function probePortHolder(host: string, port: number, timeoutMs?: number): Promise<PortHolder>;
+
 /** Decode an OTLP/protobuf `ExportTraceServiceRequest` into the OTLP/JSON object shape. */
 declare function decodeOtlpTraceRequest(body: Uint8Array): Record<string, unknown>;
 /** Decode an OTLP/protobuf `ExportLogsServiceRequest` into the OTLP/JSON object shape. */
@@ -48,4 +64,4 @@ declare function appendWithLimit<T>(items: T[], item: T, limit: number): T[];
 declare function appendManyWithLimit<T>(items: T[], incoming: T[], limit: number): T[];
 declare function applyTelemetryLimits(data: DevtoolsData, limits: TelemetryLimits): DevtoolsData;
 
-export { DevtoolsData, DevtoolsServer, type HttpServerOptions, LogData, type TelemetryLimits, TraceData, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, isProtobufContentType, parseOtlpLogs, parseOtlpTraces, resolveTelemetryLimits };
+export { DEVTOOLS_IDENTITY, DevtoolsData, DevtoolsServer, type HttpServerOptions, LogData, type PortHolder, type TelemetryLimits, TraceData, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, isProtobufContentType, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits };

package/dist/server/index.js

@@ -1386,7 +1386,38 @@ function decodeOtlpMetricsRequest(body) {
   return decodeRequest("opentelemetry.proto.metrics.v1.ExportMetricsServiceRequest", body);
 }
 
+// src/server/identity.ts
+var DEVTOOLS_IDENTITY = "autotel-devtools";
+async function probePortHolder(host, port, timeoutMs = 500) {
+  const authority = host.includes(":") ? `[${host}]` : host;
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    const res = await fetch(`http://${authority}:${port}/healthz`, {
+      signal: controller.signal
+    });
+    if (res.headers.get("x-autotel-devtools")) return "autotel-devtools";
+    try {
+      const body = await res.json();
+      if (body && body.service === DEVTOOLS_IDENTITY) return "autotel-devtools";
+    } catch {
+    }
+    return "foreign";
+  } catch {
+    return "none";
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 // src/server/http.ts
+function sendOtlpError(res, req, e) {
+  sendJson(res, 400, {
+    error: "Invalid OTLP payload",
+    message: e instanceof Error ? e.message : String(e),
+    contentType: req.headers["content-type"] ?? null
+  });
+}
 var PROTOBUF_DECODERS = {
   traces: decodeOtlpTraceRequest,
   logs: decodeOtlpLogsRequest,
@@ -1407,6 +1438,18 @@ function findPackageRoot() {
   return dir;
 }
 var FULLPAGE_HTML = `<!DOCTYPE html><html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>autotel-devtools</title><style>*{margin:0;padding:0;box-sizing:border-box}html,body{height:100%;width:100%;overflow:hidden}</style></head><body><script src="/widget.js?mode=fullpage"></script></body></html>`;
+var cachedVersion = null;
+function getVersion() {
+  if (cachedVersion !== null) return cachedVersion;
+  let version = "unknown";
+  try {
+    const pkg = JSON.parse(readFileSync(resolve(findPackageRoot(), "package.json"), "utf8"));
+    if (typeof pkg.version === "string") version = pkg.version;
+  } catch {
+  }
+  cachedVersion = version;
+  return version;
+}
 var cachedWidgetJs = null;
 function getWidgetJs() {
   if (!cachedWidgetJs) {
@@ -1433,6 +1476,8 @@ function attachDevtoolsRoutes(httpServer, devtools) {
     res.setHeader("Access-Control-Allow-Origin", "*");
     res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
     res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+    res.setHeader("x-autotel-devtools", getVersion());
+    res.setHeader("Access-Control-Expose-Headers", "x-autotel-devtools");
     if (req.method === "OPTIONS") {
       res.writeHead(204);
       res.end();
@@ -1451,7 +1496,12 @@ function attachDevtoolsRoutes(httpServer, devtools) {
       return;
     }
     if (req.method === "GET" && url === "/healthz") {
-      sendJson(res, 200, { ok: true, clients: devtools.clientCount });
+      sendJson(res, 200, {
+        ok: true,
+        service: DEVTOOLS_IDENTITY,
+        version: getVersion(),
+        clients: devtools.clientCount
+      });
       return;
     }
     if (req.method === "GET" && url === "/v1/traces") {
@@ -1471,7 +1521,7 @@ function attachDevtoolsRoutes(httpServer, devtools) {
         devtools.addTraces(traces);
         sendJson(res, 200, { acceptedTraces: traces.length });
       } catch (e) {
-        sendJson(res, 400, { error: "Invalid OTLP payload", message: e instanceof Error ? e.message : String(e) });
+        sendOtlpError(res, req, e);
       }
       return;
     }
@@ -1482,7 +1532,7 @@ function attachDevtoolsRoutes(httpServer, devtools) {
         devtools.addLogs(logs);
         sendJson(res, 200, { acceptedLogs: logs.length });
       } catch (e) {
-        sendJson(res, 400, { error: "Invalid OTLP payload", message: e instanceof Error ? e.message : String(e) });
+        sendOtlpError(res, req, e);
       }
       return;
     }
@@ -1492,7 +1542,7 @@ function attachDevtoolsRoutes(httpServer, devtools) {
         const count = countOtlpMetrics(payload);
         sendJson(res, 200, { acceptedMetrics: count });
       } catch (e) {
-        sendJson(res, 400, { error: "Invalid OTLP payload", message: e instanceof Error ? e.message : String(e) });
+        sendOtlpError(res, req, e);
       }
       return;
     }
@@ -1505,6 +1555,6 @@ function createDevtoolsHttpServer(devtools, _options = {}) {
   return server;
 }
 
-export { DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, ErrorAggregator, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, isProtobufContentType, parseOtlpLogs, parseOtlpTraces, resolveTelemetryLimits };
+export { DEVTOOLS_IDENTITY, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, ErrorAggregator, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, isProtobufContentType, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map