autotel-devtools 22.0.0 → 23.0.0

package/dist/server/index.d.cts

@@ -1,9 +1,11 @@
-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-Dt4kx128.cjs";
+import "../types-DHDvZnnn.cjs";
+import { a as SpanData, i as LogData, n as ErrorGroup, o as TraceData, r as ErrorOccurrence, t as DevtoolsData } from "../types-B0tjwFqj.cjs";
+import { a as DevtoolsStoreOptions, c as QueryLogsArgs, d as QueryTracesArgs, f as QueryTracesResult, i as DevtoolsStore, l as QueryLogsResult, m as TimeWindow, n as DevtoolsServer, o as MetricCatalogEntry, p as SPAN_SCHEMA, r as DevtoolsServerOptions, s as MetricSeries, t as DevtoolsSpanExporter, u as QueryMetricSeriesArgs } from "../exporter-C4uKgo7l.cjs";
 import { DevtoolsLogExporter } from "./log-exporter.cjs";
 import { DevtoolsRemoteExporter, DevtoolsRemoteExporterOptions } from "./remote-exporter.cjs";
-import { t as ErrorAggregator } from "../error-aggregator-DCEKMOm3.cjs";
-import { Server } from "node:http";
+import { t as ErrorAggregator } from "../error-aggregator-DSwUvgFF.cjs";
 import { AgentRawEvent, OtelMetricRecord } from "autotel-agents";
+import { Server } from "node:http";
 //#region src/server/http.d.ts
 interface HttpServerOptions {
   port?: number;
@@ -60,6 +62,19 @@ declare function parseOtlpLogs(payload: unknown): LogData[];
  */
 declare function isProtobufContentType(contentType?: string): boolean;
 //#endregion
+//#region src/server/grpc.d.ts
+interface GrpcReceiver {
+  port: number;
+  address: string;
+  close: () => Promise<void>;
+}
+declare function startOtlpGrpcReceiver(options: {
+  devtools: DevtoolsServer;
+  host?: string;
+  port?: number;
+  maxPortAttempts?: number;
+}): Promise<GrpcReceiver>;
+//#endregion
 //#region src/server/identity.d.ts
 /** Value of the `x-autotel-devtools` response header and the /healthz `service` field. */
 declare const DEVTOOLS_IDENTITY = "autotel-devtools";
@@ -89,13 +104,11 @@ declare function decodeOtlpMetricsRequest(body: Uint8Array): Record<string, unkn
 interface TelemetryLimits {
   maxTraceCount: number;
   maxLogCount: number;
-  maxMetricCount: number;
 }
 interface ResolveTelemetryLimitsArgs {
   maxHistory?: number;
   maxTraceCount?: number;
   maxLogCount?: number;
-  maxMetricCount?: number;
   env?: NodeJS.ProcessEnv;
 }
 declare function resolveTelemetryLimits(args?: ResolveTelemetryLimitsArgs): TelemetryLimits;
@@ -103,4 +116,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;
 //#endregion
-export { DEVTOOLS_IDENTITY, type DevtoolsData, DevtoolsLogExporter, DevtoolsRemoteExporter, type DevtoolsRemoteExporterOptions, type DevtoolsRoutesOptions, DevtoolsServer, type DevtoolsServerOptions, DevtoolsSpanExporter, ErrorAggregator, type ErrorGroup, type ErrorOccurrence, type HttpServerOptions, type LogData, type MetricData, type PortHolder, type SpanData, type TelemetryLimits, type TraceData, allowSensitiveRequest, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, hostHeaderIsLoopback, isLoopbackHostname, isProtobufContentType, originIsLoopback, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits };
+export { DEVTOOLS_IDENTITY, type DevtoolsData, DevtoolsLogExporter, DevtoolsRemoteExporter, type DevtoolsRemoteExporterOptions, type DevtoolsRoutesOptions, DevtoolsServer, type DevtoolsServerOptions, DevtoolsSpanExporter, DevtoolsStore, type DevtoolsStoreOptions, ErrorAggregator, type ErrorGroup, type ErrorOccurrence, type HttpServerOptions, type LogData, type MetricCatalogEntry, type MetricSeries, type PortHolder, type QueryLogsArgs, type QueryLogsResult, type QueryMetricSeriesArgs, type QueryTracesArgs, type QueryTracesResult, SPAN_SCHEMA, type SpanData, type TelemetryLimits, type TimeWindow, type TraceData, allowSensitiveRequest, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, hostHeaderIsLoopback, isLoopbackHostname, isProtobufContentType, originIsLoopback, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits, startOtlpGrpcReceiver };

package/dist/server/index.d.ts

@@ -1,7 +1,9 @@
-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-Due9Rd4s.js";
+import "../types-DHDvZnnn.js";
+import { a as SpanData, i as LogData, n as ErrorGroup, o as TraceData, r as ErrorOccurrence, t as DevtoolsData } from "../types-DM8y4A9Z.js";
+import { a as DevtoolsStoreOptions, c as QueryLogsArgs, d as QueryTracesArgs, f as QueryTracesResult, i as DevtoolsStore, l as QueryLogsResult, m as TimeWindow, n as DevtoolsServer, o as MetricCatalogEntry, p as SPAN_SCHEMA, r as DevtoolsServerOptions, s as MetricSeries, t as DevtoolsSpanExporter, u as QueryMetricSeriesArgs } from "../exporter-BrEcnzoT.js";
 import { DevtoolsLogExporter } from "./log-exporter.js";
 import { DevtoolsRemoteExporter, DevtoolsRemoteExporterOptions } from "./remote-exporter.js";
-import { t as ErrorAggregator } from "../error-aggregator-D8VKciLY.js";
+import { t as ErrorAggregator } from "../error-aggregator-B52JI8jL.js";
 import { Server } from "node:http";
 import { AgentRawEvent, OtelMetricRecord } from "autotel-agents";
 //#region src/server/http.d.ts
@@ -60,6 +62,19 @@ declare function parseOtlpLogs(payload: unknown): LogData[];
  */
 declare function isProtobufContentType(contentType?: string): boolean;
 //#endregion
+//#region src/server/grpc.d.ts
+interface GrpcReceiver {
+  port: number;
+  address: string;
+  close: () => Promise<void>;
+}
+declare function startOtlpGrpcReceiver(options: {
+  devtools: DevtoolsServer;
+  host?: string;
+  port?: number;
+  maxPortAttempts?: number;
+}): Promise<GrpcReceiver>;
+//#endregion
 //#region src/server/identity.d.ts
 /** Value of the `x-autotel-devtools` response header and the /healthz `service` field. */
 declare const DEVTOOLS_IDENTITY = "autotel-devtools";
@@ -89,13 +104,11 @@ declare function decodeOtlpMetricsRequest(body: Uint8Array): Record<string, unkn
 interface TelemetryLimits {
   maxTraceCount: number;
   maxLogCount: number;
-  maxMetricCount: number;
 }
 interface ResolveTelemetryLimitsArgs {
   maxHistory?: number;
   maxTraceCount?: number;
   maxLogCount?: number;
-  maxMetricCount?: number;
   env?: NodeJS.ProcessEnv;
 }
 declare function resolveTelemetryLimits(args?: ResolveTelemetryLimitsArgs): TelemetryLimits;
@@ -103,4 +116,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;
 //#endregion
-export { DEVTOOLS_IDENTITY, type DevtoolsData, DevtoolsLogExporter, DevtoolsRemoteExporter, type DevtoolsRemoteExporterOptions, type DevtoolsRoutesOptions, DevtoolsServer, type DevtoolsServerOptions, DevtoolsSpanExporter, ErrorAggregator, type ErrorGroup, type ErrorOccurrence, type HttpServerOptions, type LogData, type MetricData, type PortHolder, type SpanData, type TelemetryLimits, type TraceData, allowSensitiveRequest, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, hostHeaderIsLoopback, isLoopbackHostname, isProtobufContentType, originIsLoopback, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits };
+export { DEVTOOLS_IDENTITY, type DevtoolsData, DevtoolsLogExporter, DevtoolsRemoteExporter, type DevtoolsRemoteExporterOptions, type DevtoolsRoutesOptions, DevtoolsServer, type DevtoolsServerOptions, DevtoolsSpanExporter, DevtoolsStore, type DevtoolsStoreOptions, ErrorAggregator, type ErrorGroup, type ErrorOccurrence, type HttpServerOptions, type LogData, type MetricCatalogEntry, type MetricSeries, type PortHolder, type QueryLogsArgs, type QueryLogsResult, type QueryMetricSeriesArgs, type QueryTracesArgs, type QueryTracesResult, SPAN_SCHEMA, type SpanData, type TelemetryLimits, type TimeWindow, type TraceData, allowSensitiveRequest, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, hostHeaderIsLoopback, isLoopbackHostname, isProtobufContentType, originIsLoopback, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits, startOtlpGrpcReceiver };

package/dist/server/index.js

@@ -1,6 +1,7 @@
-import { _ as appendManyWithLimit, a as probePortHolder, b as resolveTelemetryLimits, c as decodeOtlpTraceRequest, d as parseOtlpTraces, f as DevtoolsServer, g as originIsLoopback, h as isLoopbackHostname, i as DEVTOOLS_IDENTITY, l as isProtobufContentType, m as hostHeaderIsLoopback, n as createDevtoolsHttpServer, o as decodeOtlpLogsRequest, p as allowSensitiveRequest, s as decodeOtlpMetricsRequest, t as attachDevtoolsRoutes, u as parseOtlpLogs, v as appendWithLimit, x as ErrorAggregator, y as applyTelemetryLimits } from "../http-CNZMrnzv.js";
+import { C as ErrorAggregator, S as resolveTelemetryLimits, _ as isLoopbackHostname, a as probePortHolder, b as appendWithLimit, c as decodeOtlpTraceRequest, d as parseOtlpLogs, f as parseOtlpTraces, g as hostHeaderIsLoopback, h as allowSensitiveRequest, i as DEVTOOLS_IDENTITY, l as DevtoolsServer, m as SPAN_SCHEMA, n as createDevtoolsHttpServer, o as decodeOtlpLogsRequest, p as DevtoolsStore, s as decodeOtlpMetricsRequest, t as attachDevtoolsRoutes, u as isProtobufContentType, v as originIsLoopback, x as applyTelemetryLimits, y as appendManyWithLimit } from "../http-Dbd9TIYU.js";
 import { DevtoolsSpanExporter } from "./exporter.js";
 import { DevtoolsLogExporter } from "./log-exporter.js";
 import { DevtoolsRemoteExporter } from "./remote-exporter.js";
+import { t as startOtlpGrpcReceiver } from "../grpc-CZEDUYCM.js";
 
-export { DEVTOOLS_IDENTITY, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, ErrorAggregator, allowSensitiveRequest, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, hostHeaderIsLoopback, isLoopbackHostname, isProtobufContentType, originIsLoopback, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits };
+export { DEVTOOLS_IDENTITY, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, DevtoolsStore, ErrorAggregator, SPAN_SCHEMA, allowSensitiveRequest, appendManyWithLimit, appendWithLimit, applyTelemetryLimits, attachDevtoolsRoutes, createDevtoolsHttpServer, decodeOtlpLogsRequest, decodeOtlpMetricsRequest, decodeOtlpTraceRequest, hostHeaderIsLoopback, isLoopbackHostname, isProtobufContentType, originIsLoopback, parseOtlpLogs, parseOtlpTraces, probePortHolder, resolveTelemetryLimits, startOtlpGrpcReceiver };

package/dist/types-B0tjwFqj.d.cts

@@ -0,0 +1,107 @@
+import { n as SpanAttributes } from "./types-DHDvZnnn.cjs";
+import { AgentSession } from "autotel-agents";
+//#region src/server/types.d.ts
+interface SpanData {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+  name: string;
+  kind: 'INTERNAL' | 'SERVER' | 'CLIENT' | 'PRODUCER' | 'CONSUMER';
+  startTime: number;
+  endTime: number;
+  duration: number;
+  attributes: SpanAttributes;
+  status: {
+    code: 'OK' | 'ERROR' | 'UNSET';
+    message?: string;
+  };
+  events?: Array<{
+    name: string;
+    timestamp: number;
+    attributes?: SpanAttributes;
+  }>;
+  links?: Array<{
+    traceId: string;
+    spanId: string;
+    attributes?: SpanAttributes;
+  }>;
+  scope?: {
+    name?: string;
+    version?: string;
+  };
+}
+interface TraceData {
+  traceId: string;
+  correlationId: string;
+  rootSpan: SpanData;
+  spans: SpanData[];
+  startTime: number;
+  endTime: number;
+  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;
+  traceId?: string;
+  spanId?: string;
+  resourceName?: string;
+  severityText?: string;
+  severityNumber?: number;
+  body: string | Record<string, unknown>;
+  timestamp: number;
+  attributes?: SpanAttributes;
+  resource?: Record<string, unknown>;
+}
+interface ErrorGroup {
+  fingerprint: string;
+  type: string;
+  message: string;
+  stackTrace?: string;
+  count: number;
+  firstSeen: number;
+  lastSeen: number;
+  affectedTraces: string[];
+  affectedSpans: string[];
+  service?: string;
+  attributes?: SpanAttributes;
+}
+interface ErrorOccurrence {
+  traceId: string;
+  spanId: string;
+  spanName: string;
+  service: string;
+  timestamp: number;
+  error: {
+    type: string;
+    message: string;
+    stackTrace?: string;
+    /**
+     * Grouping key the emitting SDK already decided on (`exception.fingerprint`,
+     * written by autotel's `exceptionFingerprint()` enricher). When present the
+     * aggregator groups by it instead of re-deriving one from the stack string,
+     * so this tab agrees with every other backend receiving the same spans.
+     */
+    fingerprint?: string;
+  };
+  attributes?: SpanAttributes;
+}
+interface DevtoolsData {
+  traces: TraceData[];
+  logs: LogData[];
+  errors: ErrorGroup[];
+  /** Full-state on every broadcast (client replaces, like `errors`). Coding-agent
+   *  sessions reconstructed from agent metrics + log events. */
+  agents?: AgentSession[];
+}
+//#endregion
+export { SpanData as a, LogData as i, ErrorGroup as n, TraceData as o, ErrorOccurrence as r, DevtoolsData as t };

package/dist/types-DM8y4A9Z.d.ts

@@ -0,0 +1,107 @@
+import { n as SpanAttributes } from "./types-DHDvZnnn.js";
+import { AgentSession } from "autotel-agents";
+//#region src/server/types.d.ts
+interface SpanData {
+  traceId: string;
+  spanId: string;
+  parentSpanId?: string;
+  name: string;
+  kind: 'INTERNAL' | 'SERVER' | 'CLIENT' | 'PRODUCER' | 'CONSUMER';
+  startTime: number;
+  endTime: number;
+  duration: number;
+  attributes: SpanAttributes;
+  status: {
+    code: 'OK' | 'ERROR' | 'UNSET';
+    message?: string;
+  };
+  events?: Array<{
+    name: string;
+    timestamp: number;
+    attributes?: SpanAttributes;
+  }>;
+  links?: Array<{
+    traceId: string;
+    spanId: string;
+    attributes?: SpanAttributes;
+  }>;
+  scope?: {
+    name?: string;
+    version?: string;
+  };
+}
+interface TraceData {
+  traceId: string;
+  correlationId: string;
+  rootSpan: SpanData;
+  spans: SpanData[];
+  startTime: number;
+  endTime: number;
+  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;
+  traceId?: string;
+  spanId?: string;
+  resourceName?: string;
+  severityText?: string;
+  severityNumber?: number;
+  body: string | Record<string, unknown>;
+  timestamp: number;
+  attributes?: SpanAttributes;
+  resource?: Record<string, unknown>;
+}
+interface ErrorGroup {
+  fingerprint: string;
+  type: string;
+  message: string;
+  stackTrace?: string;
+  count: number;
+  firstSeen: number;
+  lastSeen: number;
+  affectedTraces: string[];
+  affectedSpans: string[];
+  service?: string;
+  attributes?: SpanAttributes;
+}
+interface ErrorOccurrence {
+  traceId: string;
+  spanId: string;
+  spanName: string;
+  service: string;
+  timestamp: number;
+  error: {
+    type: string;
+    message: string;
+    stackTrace?: string;
+    /**
+     * Grouping key the emitting SDK already decided on (`exception.fingerprint`,
+     * written by autotel's `exceptionFingerprint()` enricher). When present the
+     * aggregator groups by it instead of re-deriving one from the stack string,
+     * so this tab agrees with every other backend receiving the same spans.
+     */
+    fingerprint?: string;
+  };
+  attributes?: SpanAttributes;
+}
+interface DevtoolsData {
+  traces: TraceData[];
+  logs: LogData[];
+  errors: ErrorGroup[];
+  /** Full-state on every broadcast (client replaces, like `errors`). Coding-agent
+   *  sessions reconstructed from agent metrics + log events. */
+  agents?: AgentSession[];
+}
+//#endregion
+export { SpanData as a, LogData as i, ErrorGroup as n, TraceData as o, ErrorOccurrence as r, DevtoolsData as t };