autotel-devtools 5.0.0 → 5.1.0

package/README.md

@@ -16,9 +16,9 @@ Standalone OTLP receiver with web UI for local development. Think TanStack Devto
 │  npx autotel-devtools                       │
 │  ┌───────────────────────────────────────┐ │
 │  │  HTTP Server (port 4318)               │ │
-│  │  ├── POST /v1/traces  ← OTLP JSON     │ │
-│  │  ├── POST /v1/logs     ← OTLP JSON     │ │
-│  │  ├── POST /v1/metrics  ← OTLP JSON     │ │
+│  │  ├── POST /v1/traces  ← OTLP JSON/PB │ │
+│  │  ├── POST /v1/logs     ← OTLP JSON/PB │ │
+│  │  ├── POST /v1/metrics  ← OTLP JSON/PB │ │
 │  │  ├── GET  /            → Full page UI  │ │
 │  │  ├── GET  /widget.js   → Widget bundle │ │
 │  │  ├── GET  /healthz     → Health check  │ │
@@ -41,6 +41,16 @@ OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 \
 node app.js
 ```
 
+The endpoints accept **both OTLP/JSON and OTLP/protobuf** (`application/x-protobuf`),
+selected automatically from the request `Content-Type`. That means SDKs that default
+to protobuf over OTLP HTTP — including the Python, Java, and Go OpenTelemetry SDKs —
+work without any extra configuration:
+
+```bash
+# Python / Java / Go SDKs default to http/protobuf — just point them at the receiver
+OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318 python app.py
+```
+
 Open http://localhost:4318 to see traces, logs, and metrics.
 
 ### Embedded Widget
@@ -100,7 +110,7 @@ const myFunction = trace((ctx) => async () => {
 ### Server (Node.js)
 
 - **DevtoolsServer** - WebSocket server + in-memory data store
-- **HTTP Routes** - OTLP receivers for traces/logs/metrics
+- **HTTP Routes** - OTLP receivers for traces/logs/metrics (JSON + protobuf)
 - **Exporters** - OpenTelemetry span/log exporters
 
 ### Widget (Preact)

package/dist/cli.cjs

@@ -6,8 +6,13 @@ var fs = require('fs');
 var path = require('path');
 var url = require('url');
 var ws = require('ws');
+var protobuf = require('protobufjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var protobuf__default = /*#__PURE__*/_interopDefault(protobuf);
+
 // src/server/error-aggregator.ts
 var ErrorAggregator = class {
   errorGroups = /* @__PURE__ */ new Map();
@@ -528,7 +533,7 @@ var SPAN_KIND_MAP = {
 function normalizeHexId(id) {
   if (!id) return "";
   const isBase64Like = /^[A-Za-z0-9+/=]+$/.test(id) && !/^[0-9a-f]+$/i.test(id);
-  const isLikelyBase64Id = isBase64Like && (id.length === 24 || id.length === 28 || id.length === 44 || id.length === 48);
+  const isLikelyBase64Id = isBase64Like && (id.length === 12 || id.length === 24 || id.length === 28 || id.length === 44 || id.length === 48);
   if (isLikelyBase64Id) {
     try {
       const bytes = Buffer.from(id, "base64");
@@ -660,13 +665,255 @@ async function readJsonBody(req) {
     req.on("error", reject);
   });
 }
+async function readRawBody(req) {
+  return new Promise((resolve3, reject) => {
+    const chunks = [];
+    req.on("data", (chunk) => chunks.push(chunk));
+    req.on("end", () => resolve3(Buffer.concat(chunks)));
+    req.on("error", reject);
+  });
+}
+function isProtobufContentType(contentType) {
+  if (!contentType) return false;
+  const value = contentType.toLowerCase();
+  return value.includes("application/x-protobuf") || value.includes("application/protobuf");
+}
 function sendJson(res, status, data) {
   const body = JSON.stringify(data);
   res.writeHead(status, { "Content-Type": "application/json", "Content-Length": Buffer.byteLength(body) });
   res.end(body);
 }
+var COMMON_PROTO = `
+syntax = "proto3";
+package opentelemetry.proto.common.v1;
+
+message AnyValue {
+  oneof value {
+    string string_value = 1;
+    bool bool_value = 2;
+    int64 int_value = 3;
+    double double_value = 4;
+    ArrayValue array_value = 5;
+    KeyValueList kvlist_value = 6;
+    bytes bytes_value = 7;
+  }
+}
+message ArrayValue { repeated AnyValue values = 1; }
+message KeyValueList { repeated KeyValue values = 1; }
+message KeyValue {
+  string key = 1;
+  AnyValue value = 2;
+}
+message InstrumentationScope {
+  string name = 1;
+  string version = 2;
+  repeated KeyValue attributes = 3;
+  uint32 dropped_attributes_count = 4;
+}
+`;
+var RESOURCE_PROTO = `
+syntax = "proto3";
+package opentelemetry.proto.resource.v1;
+
+message Resource {
+  repeated opentelemetry.proto.common.v1.KeyValue attributes = 1;
+  uint32 dropped_attributes_count = 2;
+}
+`;
+var TRACE_PROTO = `
+syntax = "proto3";
+package opentelemetry.proto.trace.v1;
+
+message ResourceSpans {
+  opentelemetry.proto.resource.v1.Resource resource = 1;
+  repeated ScopeSpans scope_spans = 2;
+  string schema_url = 3;
+}
+message ScopeSpans {
+  opentelemetry.proto.common.v1.InstrumentationScope scope = 1;
+  repeated Span spans = 2;
+  string schema_url = 3;
+}
+message Span {
+  bytes trace_id = 1;
+  bytes span_id = 2;
+  string trace_state = 3;
+  bytes parent_span_id = 4;
+  fixed32 flags = 16;
+  string name = 5;
+  SpanKind kind = 6;
+  fixed64 start_time_unix_nano = 7;
+  fixed64 end_time_unix_nano = 8;
+  repeated opentelemetry.proto.common.v1.KeyValue attributes = 9;
+  uint32 dropped_attributes_count = 10;
+  repeated Event events = 11;
+  uint32 dropped_events_count = 12;
+  repeated Link links = 13;
+  uint32 dropped_links_count = 14;
+  Status status = 15;
+
+  enum SpanKind {
+    SPAN_KIND_UNSPECIFIED = 0;
+    SPAN_KIND_INTERNAL = 1;
+    SPAN_KIND_SERVER = 2;
+    SPAN_KIND_CLIENT = 3;
+    SPAN_KIND_PRODUCER = 4;
+    SPAN_KIND_CONSUMER = 5;
+  }
+  message Event {
+    fixed64 time_unix_nano = 1;
+    string name = 2;
+    repeated opentelemetry.proto.common.v1.KeyValue attributes = 3;
+    uint32 dropped_attributes_count = 4;
+  }
+  message Link {
+    bytes trace_id = 1;
+    bytes span_id = 2;
+    string trace_state = 3;
+    repeated opentelemetry.proto.common.v1.KeyValue attributes = 4;
+    uint32 dropped_attributes_count = 5;
+    fixed32 flags = 6;
+  }
+}
+message Status {
+  reserved 1;
+  string message = 2;
+  StatusCode code = 3;
+
+  enum StatusCode {
+    STATUS_CODE_UNSET = 0;
+    STATUS_CODE_OK = 1;
+    STATUS_CODE_ERROR = 2;
+  }
+}
+message ExportTraceServiceRequest {
+  repeated ResourceSpans resource_spans = 1;
+}
+`;
+var LOGS_PROTO = `
+syntax = "proto3";
+package opentelemetry.proto.logs.v1;
+
+enum SeverityNumber {
+  SEVERITY_NUMBER_UNSPECIFIED = 0;
+  SEVERITY_NUMBER_TRACE = 1;
+  SEVERITY_NUMBER_TRACE2 = 2;
+  SEVERITY_NUMBER_TRACE3 = 3;
+  SEVERITY_NUMBER_TRACE4 = 4;
+  SEVERITY_NUMBER_DEBUG = 5;
+  SEVERITY_NUMBER_DEBUG2 = 6;
+  SEVERITY_NUMBER_DEBUG3 = 7;
+  SEVERITY_NUMBER_DEBUG4 = 8;
+  SEVERITY_NUMBER_INFO = 9;
+  SEVERITY_NUMBER_INFO2 = 10;
+  SEVERITY_NUMBER_INFO3 = 11;
+  SEVERITY_NUMBER_INFO4 = 12;
+  SEVERITY_NUMBER_WARN = 13;
+  SEVERITY_NUMBER_WARN2 = 14;
+  SEVERITY_NUMBER_WARN3 = 15;
+  SEVERITY_NUMBER_WARN4 = 16;
+  SEVERITY_NUMBER_ERROR = 17;
+  SEVERITY_NUMBER_ERROR2 = 18;
+  SEVERITY_NUMBER_ERROR3 = 19;
+  SEVERITY_NUMBER_ERROR4 = 20;
+  SEVERITY_NUMBER_FATAL = 21;
+  SEVERITY_NUMBER_FATAL2 = 22;
+  SEVERITY_NUMBER_FATAL3 = 23;
+  SEVERITY_NUMBER_FATAL4 = 24;
+}
+message ResourceLogs {
+  opentelemetry.proto.resource.v1.Resource resource = 1;
+  repeated ScopeLogs scope_logs = 2;
+  string schema_url = 3;
+}
+message ScopeLogs {
+  opentelemetry.proto.common.v1.InstrumentationScope scope = 1;
+  repeated LogRecord log_records = 2;
+  string schema_url = 3;
+}
+message LogRecord {
+  reserved 4;
+  fixed64 time_unix_nano = 1;
+  fixed64 observed_time_unix_nano = 11;
+  SeverityNumber severity_number = 2;
+  string severity_text = 3;
+  opentelemetry.proto.common.v1.AnyValue body = 5;
+  repeated opentelemetry.proto.common.v1.KeyValue attributes = 6;
+  uint32 dropped_attributes_count = 7;
+  fixed32 flags = 8;
+  bytes trace_id = 9;
+  bytes span_id = 10;
+}
+message ExportLogsServiceRequest {
+  repeated ResourceLogs resource_logs = 1;
+}
+`;
+var METRICS_PROTO = `
+syntax = "proto3";
+package opentelemetry.proto.metrics.v1;
+
+message ResourceMetrics {
+  opentelemetry.proto.resource.v1.Resource resource = 1;
+  repeated ScopeMetrics scope_metrics = 2;
+  string schema_url = 3;
+}
+message ScopeMetrics {
+  opentelemetry.proto.common.v1.InstrumentationScope scope = 1;
+  repeated Metric metrics = 2;
+  string schema_url = 3;
+}
+message Metric {
+  string name = 1;
+  string description = 2;
+  string unit = 3;
+}
+message ExportMetricsServiceRequest {
+  repeated ResourceMetrics resource_metrics = 1;
+}
+`;
+var TO_OBJECT_OPTIONS = {
+  longs: String,
+  bytes: String,
+  defaults: false
+};
+var cachedRoot = null;
+function getRoot() {
+  if (cachedRoot) return cachedRoot;
+  const root = new protobuf__default.default.Root();
+  for (const source of [COMMON_PROTO, RESOURCE_PROTO, TRACE_PROTO, LOGS_PROTO, METRICS_PROTO]) {
+    protobuf__default.default.parse(source, root, { keepCase: false });
+  }
+  root.resolveAll();
+  cachedRoot = root;
+  return root;
+}
+function decodeRequest(typeName, body) {
+  const messageType = getRoot().lookupType(typeName);
+  const message = messageType.decode(body);
+  return messageType.toObject(message, TO_OBJECT_OPTIONS);
+}
+function decodeOtlpTraceRequest(body) {
+  return decodeRequest("opentelemetry.proto.trace.v1.ExportTraceServiceRequest", body);
+}
+function decodeOtlpLogsRequest(body) {
+  return decodeRequest("opentelemetry.proto.logs.v1.ExportLogsServiceRequest", body);
+}
+function decodeOtlpMetricsRequest(body) {
+  return decodeRequest("opentelemetry.proto.metrics.v1.ExportMetricsServiceRequest", body);
+}
 
 // src/server/http.ts
+var PROTOBUF_DECODERS = {
+  traces: decodeOtlpTraceRequest,
+  logs: decodeOtlpLogsRequest,
+  metrics: decodeOtlpMetricsRequest
+};
+async function readOtlpPayload(req, signal) {
+  if (isProtobufContentType(req.headers["content-type"])) {
+    return PROTOBUF_DECODERS[signal](await readRawBody(req));
+  }
+  return readJsonBody(req);
+}
 function findPackageRoot() {
   let dir = path.dirname(url.fileURLToPath((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('cli.cjs', document.baseURI).href))));
   for (let i = 0; i < 5; i++) {
@@ -735,33 +982,33 @@ function attachDevtoolsRoutes(httpServer, devtools) {
     }
     if (req.method === "POST" && url === "/v1/traces") {
       try {
-        const payload = await readJsonBody(req);
+        const payload = await readOtlpPayload(req, "traces");
         const traces = parseOtlpTraces(payload);
         devtools.addTraces(traces);
         sendJson(res, 200, { acceptedTraces: traces.length });
       } catch (e) {
-        sendJson(res, 400, { error: "Invalid OTLP JSON", message: e instanceof Error ? e.message : String(e) });
+        sendJson(res, 400, { error: "Invalid OTLP payload", message: e instanceof Error ? e.message : String(e) });
       }
       return;
     }
     if (req.method === "POST" && url === "/v1/logs") {
       try {
-        const payload = await readJsonBody(req);
+        const payload = await readOtlpPayload(req, "logs");
         const logs = parseOtlpLogs(payload);
         devtools.addLogs(logs);
         sendJson(res, 200, { acceptedLogs: logs.length });
       } catch (e) {
-        sendJson(res, 400, { error: "Invalid OTLP JSON", message: e instanceof Error ? e.message : String(e) });
+        sendJson(res, 400, { error: "Invalid OTLP payload", message: e instanceof Error ? e.message : String(e) });
       }
       return;
     }
     if (req.method === "POST" && url === "/v1/metrics") {
       try {
-        const payload = await readJsonBody(req);
+        const payload = await readOtlpPayload(req, "metrics");
         const count = countOtlpMetrics(payload);
         sendJson(res, 200, { acceptedMetrics: count });
       } catch (e) {
-        sendJson(res, 400, { error: "Invalid OTLP JSON", message: e instanceof Error ? e.message : String(e) });
+        sendJson(res, 400, { error: "Invalid OTLP payload", message: e instanceof Error ? e.message : String(e) });
       }
       return;
     }