autotel-devtools 22.0.0 → 23.0.0

package/dist/index.cjs

@@ -1,6 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_http = require('./http-CXSzX4ee.cjs');
-const require_listen = require('./listen-CEJ3nYJf.cjs');
+const require_http = require('./http-Cqm_MAtc.cjs');
+const require_listen = require('./listen-l09RRHht.cjs');
 const require_server_exporter = require('./server/exporter.cjs');
 const require_server_log_exporter = require('./server/log-exporter.cjs');
 const require_server_remote_exporter = require('./server/remote-exporter.cjs');
@@ -19,7 +19,12 @@ function createDevtools(options = {}) {
 		maxHistory: options.maxHistory,
 		maxTraceCount: options.maxTraceCount,
 		maxLogCount: options.maxLogCount,
-		maxMetricCount: options.maxMetricCount
+		maxMetricCount: options.maxMetricCount,
+		dbPath: options.dbPath,
+		maxTraces: options.maxTraces,
+		maxLogs: options.maxLogs,
+		maxDbBytes: options.maxDbBytes,
+		retentionIntervalMs: options.retentionIntervalMs
 	});
 	const sourceRoot = require_http.resolveSourceRoot(options.sourceRoot === false ? "false" : options.sourceRoot ?? process.env.AUTOTEL_DEVTOOLS_SOURCE_ROOT, process.cwd(), loopbackOnly);
 	require_http.attachDevtoolsRoutes(httpServer, wsServer, {
@@ -30,10 +35,13 @@ function createDevtools(options = {}) {
 		primary: httpServer,
 		port,
 		host,
-		attachSecondary: (s) => require_http.attachDevtoolsRoutes(s, wsServer, {
-			loopbackOnly,
-			sourceRoot
-		})
+		attachSecondary: (s) => {
+			require_http.attachDevtoolsRoutes(s, wsServer, {
+				loopbackOnly,
+				sourceRoot
+			});
+			wsServer.attachWebSocket(s);
+		}
 	});
 	if (options.verbose) listeners.ready.then(({ warnings }) => {
 		for (const w of warnings) console.warn(`[autotel-devtools] ${w}`);
@@ -43,6 +51,16 @@ function createDevtools(options = {}) {
 		httpServer,
 		exporter: new require_server_exporter.DevtoolsSpanExporter(wsServer),
 		port,
+		/**
+		* Resolves once both loopback listeners are up, with the port actually
+		* bound.
+		*
+		* `port` above is what was *asked for*, which is not the same thing: pass
+		* `port: 0` and it stays 0, and a busy port falls forward to the next free
+		* one. An embedder that wants to print a URL or point an exporter at this
+		* receiver needs the resolved value, and until now had no way to get it.
+		*/
+		ready: listeners.ready,
 		close: async () => {
 			await wsServer.close();
 			await listeners.closeSibling();

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 import { n as SpanAttributes, t as AttributeValue } from "./types-DHDvZnnn.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-Dt4kx128.cjs";
+import { a as SpanData, i as LogData, n as ErrorGroup, o as TraceData, t as DevtoolsData } from "./types-B0tjwFqj.cjs";
+import { n as DevtoolsServer, t as DevtoolsSpanExporter } from "./exporter-C4uKgo7l.cjs";
 import { DevtoolsLogExporter } from "./server/log-exporter.cjs";
 import { DevtoolsRemoteExporter } from "./server/remote-exporter.cjs";
-import { t as ErrorAggregator } from "./error-aggregator-DCEKMOm3.cjs";
+import { t as ErrorAggregator } from "./error-aggregator-DSwUvgFF.cjs";
 import { Server } from "node:http";
 //#region src/index.d.ts
 interface CreateDevtoolsOptions {
@@ -21,14 +22,40 @@ interface CreateDevtoolsOptions {
    * otherwise. `false` disables it. See `resolveSourceRoot`.
    */
   sourceRoot?: string | false;
+  /**
+   * Path to the sqlite file backing the store.
+   *
+   * Omit for in-memory, which is the default: an embedder gets querying and
+   * paging without this call suddenly writing a database file it did not ask
+   * for. Set it to keep telemetry across restarts.
+   */
+  dbPath?: string;
+  /** Maximum traces retained in the store before the oldest are pruned. */
+  maxTraces?: number;
+  /** Maximum logs retained in the store before the oldest are pruned. */
+  maxLogs?: number;
+  /** Maximum logical sqlite size before oldest telemetry is pruned. */
+  maxDbBytes?: number;
+  /** How often to prune the store past its caps, in ms. `0` disables it. */
+  retentionIntervalMs?: number;
 }
 interface DevtoolsInstance {
   server: DevtoolsServer;
   httpServer: Server;
   exporter: DevtoolsSpanExporter;
+  /** The port that was *requested*. See `ready` for the one actually bound. */
   port: number;
+  /**
+   * Resolves once both loopback listeners are up, carrying the bound port,
+   * every address bound, and any warnings raised while binding.
+   */
+  ready: Promise<{
+    addresses: string[];
+    port: number;
+    warnings: string[];
+  }>;
   close: () => Promise<void>;
 }
 declare function createDevtools(options?: CreateDevtoolsOptions): DevtoolsInstance;
 //#endregion
-export { type AttributeValue, CreateDevtoolsOptions, type DevtoolsData, DevtoolsInstance, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, ErrorAggregator, type ErrorGroup, type LogData, type MetricData, type SpanAttributes, type SpanData, type TraceData, createDevtools };
+export { type AttributeValue, CreateDevtoolsOptions, type DevtoolsData, DevtoolsInstance, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, ErrorAggregator, type ErrorGroup, type LogData, type SpanAttributes, type SpanData, type TraceData, createDevtools };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { n as SpanAttributes, t as AttributeValue } from "./types-DHDvZnnn.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-Due9Rd4s.js";
+import { a as SpanData, i as LogData, n as ErrorGroup, o as TraceData, t as DevtoolsData } from "./types-DM8y4A9Z.js";
+import { n as DevtoolsServer, t as DevtoolsSpanExporter } from "./exporter-BrEcnzoT.js";
 import { DevtoolsLogExporter } from "./server/log-exporter.js";
 import { DevtoolsRemoteExporter } from "./server/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";
 //#region src/index.d.ts
 interface CreateDevtoolsOptions {
@@ -21,14 +22,40 @@ interface CreateDevtoolsOptions {
    * otherwise. `false` disables it. See `resolveSourceRoot`.
    */
   sourceRoot?: string | false;
+  /**
+   * Path to the sqlite file backing the store.
+   *
+   * Omit for in-memory, which is the default: an embedder gets querying and
+   * paging without this call suddenly writing a database file it did not ask
+   * for. Set it to keep telemetry across restarts.
+   */
+  dbPath?: string;
+  /** Maximum traces retained in the store before the oldest are pruned. */
+  maxTraces?: number;
+  /** Maximum logs retained in the store before the oldest are pruned. */
+  maxLogs?: number;
+  /** Maximum logical sqlite size before oldest telemetry is pruned. */
+  maxDbBytes?: number;
+  /** How often to prune the store past its caps, in ms. `0` disables it. */
+  retentionIntervalMs?: number;
 }
 interface DevtoolsInstance {
   server: DevtoolsServer;
   httpServer: Server;
   exporter: DevtoolsSpanExporter;
+  /** The port that was *requested*. See `ready` for the one actually bound. */
   port: number;
+  /**
+   * Resolves once both loopback listeners are up, carrying the bound port,
+   * every address bound, and any warnings raised while binding.
+   */
+  ready: Promise<{
+    addresses: string[];
+    port: number;
+    warnings: string[];
+  }>;
   close: () => Promise<void>;
 }
 declare function createDevtools(options?: CreateDevtoolsOptions): DevtoolsInstance;
 //#endregion
-export { type AttributeValue, CreateDevtoolsOptions, type DevtoolsData, DevtoolsInstance, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, ErrorAggregator, type ErrorGroup, type LogData, type MetricData, type SpanAttributes, type SpanData, type TraceData, createDevtools };
+export { type AttributeValue, CreateDevtoolsOptions, type DevtoolsData, DevtoolsInstance, DevtoolsLogExporter, DevtoolsRemoteExporter, DevtoolsServer, DevtoolsSpanExporter, ErrorAggregator, type ErrorGroup, type LogData, type SpanAttributes, type SpanData, type TraceData, createDevtools };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { f as DevtoolsServer, m as hostHeaderIsLoopback, r as resolveSourceRoot, t as attachDevtoolsRoutes, x as ErrorAggregator } from "./http-CNZMrnzv.js";
-import { t as listenLoopbackDualStack } from "./listen-DBfsfcdd.js";
+import { C as ErrorAggregator, g as hostHeaderIsLoopback, l as DevtoolsServer, r as resolveSourceRoot, t as attachDevtoolsRoutes } from "./http-Dbd9TIYU.js";
+import { t as listenLoopbackDualStack } from "./listen-D-lLgfro.js";
 import { DevtoolsSpanExporter } from "./server/exporter.js";
 import { DevtoolsLogExporter } from "./server/log-exporter.js";
 import { DevtoolsRemoteExporter } from "./server/remote-exporter.js";
@@ -18,7 +18,12 @@ function createDevtools(options = {}) {
 		maxHistory: options.maxHistory,
 		maxTraceCount: options.maxTraceCount,
 		maxLogCount: options.maxLogCount,
-		maxMetricCount: options.maxMetricCount
+		maxMetricCount: options.maxMetricCount,
+		dbPath: options.dbPath,
+		maxTraces: options.maxTraces,
+		maxLogs: options.maxLogs,
+		maxDbBytes: options.maxDbBytes,
+		retentionIntervalMs: options.retentionIntervalMs
 	});
 	const sourceRoot = resolveSourceRoot(options.sourceRoot === false ? "false" : options.sourceRoot ?? process.env.AUTOTEL_DEVTOOLS_SOURCE_ROOT, process.cwd(), loopbackOnly);
 	attachDevtoolsRoutes(httpServer, wsServer, {
@@ -29,10 +34,13 @@ function createDevtools(options = {}) {
 		primary: httpServer,
 		port,
 		host,
-		attachSecondary: (s) => attachDevtoolsRoutes(s, wsServer, {
-			loopbackOnly,
-			sourceRoot
-		})
+		attachSecondary: (s) => {
+			attachDevtoolsRoutes(s, wsServer, {
+				loopbackOnly,
+				sourceRoot
+			});
+			wsServer.attachWebSocket(s);
+		}
 	});
 	if (options.verbose) listeners.ready.then(({ warnings }) => {
 		for (const w of warnings) console.warn(`[autotel-devtools] ${w}`);
@@ -42,6 +50,16 @@ function createDevtools(options = {}) {
 		httpServer,
 		exporter: new DevtoolsSpanExporter(wsServer),
 		port,
+		/**
+		* Resolves once both loopback listeners are up, with the port actually
+		* bound.
+		*
+		* `port` above is what was *asked for*, which is not the same thing: pass
+		* `port: 0` and it stays 0, and a busy port falls forward to the next free
+		* one. An embedder that wants to print a URL or point an exporter at this
+		* receiver needs the resolved value, and until now had no way to get it.
+		*/
+		ready: listeners.ready,
 		close: async () => {
 			await wsServer.close();
 			await listeners.closeSibling();

package/dist/{listen-DBfsfcdd.js → listen-D-lLgfro.js}

@@ -31,8 +31,11 @@ function formatAddress(host, port) {
 * is returned in `ready` so callers can print correct URLs and OTLP
 * endpoints. Each fallback produces a warning.
 *
-* The sibling listener serves the same HTTP routes (via `attachSecondary`);
-* the WebSocket/UI stays on the primary address. If the sibling cannot bind
+* The sibling listener serves the same HTTP routes *and the WebSocket* via
+* `attachSecondary`: a caller that attaches only routes leaves a client on the
+* other IP family able to read telemetry over HTTP while its live tail never
+* connects, which looks like a hung UI rather than a bind problem. If the
+* sibling cannot bind
 * (e.g. no IPv6, or the port is taken on that family), it is reported as a
 * warning rather than a fatal error.
 */

package/dist/{listen-CEJ3nYJf.cjs → listen-l09RRHht.cjs}

@@ -31,8 +31,11 @@ function formatAddress(host, port) {
 * is returned in `ready` so callers can print correct URLs and OTLP
 * endpoints. Each fallback produces a warning.
 *
-* The sibling listener serves the same HTTP routes (via `attachSecondary`);
-* the WebSocket/UI stays on the primary address. If the sibling cannot bind
+* The sibling listener serves the same HTTP routes *and the WebSocket* via
+* `attachSecondary`: a caller that attaches only routes leaves a client on the
+* other IP family able to read telemetry over HTTP while its live tail never
+* connects, which looks like a hung UI rather than a bind problem. If the
+* sibling cannot bind
 * (e.g. no IPv6, or the port is taken on that family), it is reported as a
 * warning rather than a fatal error.
 */