@composed-di/observability 0.5.0-alpha

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Standalone dashboard server:
+ *
+ *   composed-di-dashboard [--port 4321] [--host 127.0.0.1]
+ *
+ * Applications export their service events to it with DashboardClient.
+ */
+const dashboardServer_1 = require("./dashboardServer");
+function argValue(flag) {
+    const index = process.argv.indexOf(flag);
+    return index >= 0 ? process.argv[index + 1] : undefined;
+}
+function main() {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const port = Number((_b = (_a = argValue('--port')) !== null && _a !== void 0 ? _a : process.env.PORT) !== null && _b !== void 0 ? _b : 4321);
+        const host = (_c = argValue('--host')) !== null && _c !== void 0 ? _c : '127.0.0.1';
+        if (!Number.isInteger(port) || port < 0 || port > 65535) {
+            console.error(`Invalid port: ${(_d = argValue('--port')) !== null && _d !== void 0 ? _d : process.env.PORT}`);
+            process.exit(1);
+        }
+        const dashboard = new dashboardServer_1.ServiceDashboard();
+        const url = yield dashboard.listen(port, host);
+        console.log(`composed-di dashboard listening at ${url}`);
+        console.log('Waiting for an application to connect (see DashboardClient in @composed-di/observability).');
+        const shutdown = () => __awaiter(this, void 0, void 0, function* () {
+            yield dashboard.close();
+            process.exit(0);
+        });
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+    });
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA;;;;;;GAMG;AACH,uDAAqD;AAErD,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1D,CAAC;AAED,SAAe,IAAI;;;QACjB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAA,MAAA,QAAQ,CAAC,QAAQ,CAAC,mCAAI,OAAO,CAAC,GAAG,CAAC,IAAI,mCAAI,IAAI,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,MAAA,QAAQ,CAAC,QAAQ,CAAC,mCAAI,WAAW,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;YACxD,OAAO,CAAC,KAAK,CAAC,iBAAiB,MAAA,QAAQ,CAAC,QAAQ,CAAC,mCAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,kCAAgB,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,sCAAsC,GAAG,EAAE,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CACT,4FAA4F,CAC7F,CAAC;QAEF,MAAM,QAAQ,GAAG,GAAS,EAAE;YAC1B,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC,CAAA,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;CAAA;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/dashboardClient.d.ts

@@ -0,0 +1,67 @@
+import { ServiceModule } from '@composed-di/core';
+import { DashboardEventListener } from './dashboardEventListener';
+export interface DashboardClientOptions {
+    /** Base URL of the standalone dashboard server, e.g. "http://localhost:4321". */
+    url: string;
+    /** How long to buffer events before exporting a batch. Default 250ms. */
+    flushIntervalMs?: number;
+    /** Export immediately once this many events are buffered. Default 64. */
+    maxBatchSize?: number;
+    /** Events kept while the server is unreachable; oldest are dropped. Default 5000. */
+    maxQueueSize?: number;
+    /**
+     * Called when an export fails. Defaults to a single console.warn per
+     * failure streak; exports never throw into application code.
+     */
+    onError?: (error: Error) => void;
+}
+/**
+ * Exports service observability to a standalone dashboard server, the way
+ * an OpenTelemetry SDK exports spans to a collector.
+ *
+ * The application owns only this client: pass `client.listener` to
+ * `ServiceModule.from`, then `attach` the module to register its dependency
+ * graph with the server. Span events are buffered and shipped in batches;
+ * export failures are retried on the next flush and never affect the
+ * application.
+ *
+ * @example
+ * ```ts
+ * const client = new DashboardClient({ url: 'http://localhost:4321' });
+ * const module = ServiceModule.from(factories, client.listener);
+ * client.attach(module);
+ * ```
+ */
+export declare class DashboardClient {
+    /** Pass this as the second argument to ServiceModule.from. */
+    readonly listener: DashboardEventListener;
+    private readonly url;
+    private readonly flushIntervalMs;
+    private readonly maxBatchSize;
+    private readonly maxQueueSize;
+    private readonly onError;
+    private queue;
+    private graph;
+    private graphSent;
+    private timer;
+    /** Serializes exports so events reach the server in order. */
+    private exporting;
+    private warned;
+    private closed;
+    constructor({ url, flushIntervalMs, maxBatchSize, maxQueueSize, onError, }: DashboardClientOptions);
+    /**
+     * Registers the module's dependency graph with the dashboard server.
+     */
+    attach(module: ServiceModule): this;
+    /** Exports everything buffered so far. Resolves once the attempt finishes. */
+    flush(): Promise<void>;
+    /** Flushes remaining events and stops the export timer. */
+    close(): Promise<void>;
+    private enqueue;
+    private scheduleFlush;
+    private export;
+    /** After a failed export, retry even if no new events arrive. */
+    private retryLater;
+    private post;
+}
+//# sourceMappingURL=dashboardClient.d.ts.map

package/dist/dashboardClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardClient.d.ts","sourceRoot":"","sources":["../src/dashboardClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAIlE,MAAM,WAAW,sBAAsB;IACrC,iFAAiF;IACjF,GAAG,EAAE,MAAM,CAAC;IACZ,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAe;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,yBAAgC;IAEjD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IAEjD,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAA4B;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAA+B;IAC5C,8DAA8D;IAC9D,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,EACV,GAAG,EACH,eAAqB,EACrB,YAAiB,EACjB,YAAmB,EACnB,OAAO,GACR,EAAE,sBAAsB;IAiBzB;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAOnC,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,2DAA2D;IACrD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,OAAO;IAaf,OAAO,CAAC,aAAa;YASP,MAAM;IAgCpB,iEAAiE;IACjE,OAAO,CAAC,UAAU;YAMJ,IAAI;CAqBnB"}

package/dist/dashboardClient.js

@@ -0,0 +1,168 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardClient = void 0;
+const dashboardEventListener_1 = require("./dashboardEventListener");
+const moduleGraph_1 = require("./moduleGraph");
+/**
+ * Exports service observability to a standalone dashboard server, the way
+ * an OpenTelemetry SDK exports spans to a collector.
+ *
+ * The application owns only this client: pass `client.listener` to
+ * `ServiceModule.from`, then `attach` the module to register its dependency
+ * graph with the server. Span events are buffered and shipped in batches;
+ * export failures are retried on the next flush and never affect the
+ * application.
+ *
+ * @example
+ * ```ts
+ * const client = new DashboardClient({ url: 'http://localhost:4321' });
+ * const module = ServiceModule.from(factories, client.listener);
+ * client.attach(module);
+ * ```
+ */
+class DashboardClient {
+    constructor({ url, flushIntervalMs = 250, maxBatchSize = 64, maxQueueSize = 5000, onError, }) {
+        /** Pass this as the second argument to ServiceModule.from. */
+        this.listener = new dashboardEventListener_1.DashboardEventListener();
+        this.queue = [];
+        this.graph = null;
+        this.graphSent = false;
+        this.timer = null;
+        /** Serializes exports so events reach the server in order. */
+        this.exporting = Promise.resolve();
+        this.warned = false;
+        this.closed = false;
+        this.url = url.replace(/\/$/, '');
+        this.flushIntervalMs = flushIntervalMs;
+        this.maxBatchSize = maxBatchSize;
+        this.maxQueueSize = maxQueueSize;
+        this.onError =
+            onError !== null && onError !== void 0 ? onError : ((error) => {
+                if (this.warned)
+                    return;
+                this.warned = true;
+                console.warn(`[composed-di] dashboard export to ${this.url} failed (will keep retrying): ${error.message}`);
+            });
+        this.listener.subscribe((event) => this.enqueue(event));
+    }
+    /**
+     * Registers the module's dependency graph with the dashboard server.
+     */
+    attach(module) {
+        this.graph = (0, moduleGraph_1.moduleGraph)(module);
+        this.graphSent = false;
+        void this.flush();
+        return this;
+    }
+    /** Exports everything buffered so far. Resolves once the attempt finishes. */
+    flush() {
+        this.exporting = this.exporting.then(() => this.export());
+        return this.exporting;
+    }
+    /** Flushes remaining events and stops the export timer. */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.closed = true;
+            if (this.timer) {
+                clearTimeout(this.timer);
+                this.timer = null;
+            }
+            yield this.flush();
+        });
+    }
+    enqueue(event) {
+        if (this.closed)
+            return;
+        this.queue.push(event);
+        if (this.queue.length > this.maxQueueSize) {
+            this.queue.splice(0, this.queue.length - this.maxQueueSize);
+        }
+        if (this.queue.length >= this.maxBatchSize) {
+            void this.flush();
+            return;
+        }
+        this.scheduleFlush(this.flushIntervalMs);
+    }
+    scheduleFlush(delayMs) {
+        var _a, _b;
+        if (this.timer || this.closed)
+            return;
+        this.timer = setTimeout(() => {
+            this.timer = null;
+            void this.flush();
+        }, delayMs);
+        (_b = (_a = this.timer).unref) === null || _b === void 0 ? void 0 : _b.call(_a);
+    }
+    export() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // The graph must reach the server before any events that reference it.
+            if (this.graph && !this.graphSent) {
+                if ((yield this.post('/v1/graph', this.graph)) !== 'ok') {
+                    this.retryLater();
+                    return;
+                }
+                this.graphSent = true;
+            }
+            let reRegistrations = 0;
+            while (this.queue.length > 0) {
+                const batch = this.queue.slice(0, this.maxBatchSize);
+                const result = yield this.post('/v1/events', { events: batch });
+                // A restarted server lost the graph — re-register and resend the batch.
+                if (result === 'graph-required' && this.graph && reRegistrations < 3) {
+                    reRegistrations += 1;
+                    this.graphSent = false;
+                    if ((yield this.post('/v1/graph', this.graph)) !== 'ok') {
+                        this.retryLater();
+                        return;
+                    }
+                    this.graphSent = true;
+                    continue;
+                }
+                if (result !== 'ok') {
+                    this.retryLater();
+                    return;
+                }
+                this.queue.splice(0, batch.length);
+            }
+        });
+    }
+    /** After a failed export, retry even if no new events arrive. */
+    retryLater() {
+        if (this.queue.length > 0 || (this.graph && !this.graphSent)) {
+            this.scheduleFlush(Math.max(this.flushIntervalMs, 2000));
+        }
+    }
+    post(path, body) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const response = yield fetch(this.url + path, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json' },
+                    body: JSON.stringify(body),
+                });
+                if (response.status === 409)
+                    return 'graph-required';
+                if (!response.ok) {
+                    throw new Error(`server responded ${response.status}`);
+                }
+                this.warned = false;
+                return 'ok';
+            }
+            catch (error) {
+                this.onError(error instanceof Error ? error : new Error(String(error)));
+                return 'failed';
+            }
+        });
+    }
+}
+exports.DashboardClient = DashboardClient;
+//# sourceMappingURL=dashboardClient.js.map

package/dist/dashboardClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardClient.js","sourceRoot":"","sources":["../src/dashboardClient.ts"],"names":[],"mappings":"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"}

package/dist/dashboardEventListener.d.ts

@@ -0,0 +1,32 @@
+import type { DisposeContext, EventSpan, InitializeContext, MethodCallContext, ServiceEventListener } from '@composed-di/core';
+import { SpanEvent } from './events';
+/**
+ * A ServiceEventListener that turns service events into structured
+ * start/end span events for the realtime dashboard.
+ *
+ * - Uses AsyncLocalStorage to link spans to the span that was active when
+ *   they started, which lets the dashboard draw cross-service call edges
+ *   (e.g. UserService.getUser -> Database.query). Because a listener does
+ *   not control the invocation of the operation it observes, the context
+ *   is entered with `enterWith` and can outlive the span within the same
+ *   synchronous frame; the dashboard tolerates this, as parents are only
+ *   resolved among still-open spans.
+ * - Emits events synchronously to subscribers; it never buffers.
+ */
+export declare class DashboardEventListener implements ServiceEventListener {
+    private readonly context;
+    private readonly listeners;
+    private nextId;
+    /**
+     * Subscribes to span events.
+     *
+     * @returns A function that removes the subscription.
+     */
+    subscribe(listener: (event: SpanEvent) => void): () => void;
+    onInitialize({ key }: InitializeContext): EventSpan;
+    onDispose({ key }: DisposeContext): EventSpan;
+    onMethodCall({ key, methodName }: MethodCallContext): EventSpan;
+    private startSpan;
+    private emit;
+}
+//# sourceMappingURL=dashboardEventListener.d.ts.map

package/dist/dashboardEventListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardEventListener.d.ts","sourceRoot":"","sources":["../src/dashboardEventListener.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAY,MAAM,UAAU,CAAC;AAO/C;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,YAAW,oBAAoB;IACjE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,MAAM,CAAK;IAEnB;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAK3D,YAAY,CAAC,EAAE,GAAG,EAAE,EAAE,iBAAiB,GAAG,SAAS;IAInD,SAAS,CAAC,EAAE,GAAG,EAAE,EAAE,cAAc,GAAG,SAAS;IAI7C,YAAY,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,iBAAiB,GAAG,SAAS;IAI/D,OAAO,CAAC,SAAS;IAwCjB,OAAO,CAAC,IAAI;CAGb"}

package/dist/dashboardEventListener.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardEventListener = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const node_perf_hooks_1 = require("node:perf_hooks");
+/**
+ * A ServiceEventListener that turns service events into structured
+ * start/end span events for the realtime dashboard.
+ *
+ * - Uses AsyncLocalStorage to link spans to the span that was active when
+ *   they started, which lets the dashboard draw cross-service call edges
+ *   (e.g. UserService.getUser -> Database.query). Because a listener does
+ *   not control the invocation of the operation it observes, the context
+ *   is entered with `enterWith` and can outlive the span within the same
+ *   synchronous frame; the dashboard tolerates this, as parents are only
+ *   resolved among still-open spans.
+ * - Emits events synchronously to subscribers; it never buffers.
+ */
+class DashboardEventListener {
+    constructor() {
+        this.context = new node_async_hooks_1.AsyncLocalStorage();
+        this.listeners = new Set();
+        this.nextId = 1;
+    }
+    /**
+     * Subscribes to span events.
+     *
+     * @returns A function that removes the subscription.
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    onInitialize({ key }) {
+        return this.startSpan(key.name, 'initialize', 'initialize');
+    }
+    onDispose({ key }) {
+        return this.startSpan(key.name, 'dispose', 'dispose');
+    }
+    onMethodCall({ key, methodName }) {
+        return this.startSpan(key.name, methodName, 'call');
+    }
+    startSpan(service, method, kind) {
+        var _a;
+        const id = this.nextId++;
+        const parent = this.context.getStore();
+        this.emit({
+            type: 'start',
+            id,
+            parentId: (_a = parent === null || parent === void 0 ? void 0 : parent.id) !== null && _a !== void 0 ? _a : null,
+            name: `${service}.${method}`,
+            service,
+            method,
+            kind,
+            time: Date.now(),
+        });
+        const startedAt = node_perf_hooks_1.performance.now();
+        let ended = false;
+        const end = (error) => {
+            if (ended)
+                return;
+            ended = true;
+            this.emit({
+                type: 'end',
+                id,
+                time: Date.now(),
+                durationMs: node_perf_hooks_1.performance.now() - startedAt,
+                error,
+            });
+        };
+        // The observed operation runs right after this hook returns, in the
+        // same synchronous frame, so entering the context here makes this span
+        // the parent of any spans started inside the operation.
+        this.context.enterWith({ id });
+        return {
+            end: () => end(null),
+            error: (error) => end(errorMessage(error)),
+        };
+    }
+    emit(event) {
+        this.listeners.forEach((listener) => listener(event));
+    }
+}
+exports.DashboardEventListener = DashboardEventListener;
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=dashboardEventListener.js.map

package/dist/dashboardEventListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardEventListener.js","sourceRoot":"","sources":["../src/dashboardEventListener.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AACrD,qDAA8C;AAe9C;;;;;;;;;;;;GAYG;AACH,MAAa,sBAAsB;IAAnC;QACmB,YAAO,GAAG,IAAI,oCAAiB,EAAe,CAAC;QAC/C,cAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;QAC3D,WAAM,GAAG,CAAC,CAAC;IAmErB,CAAC;IAjEC;;;;OAIG;IACH,SAAS,CAAC,QAAoC;QAC5C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,YAAY,CAAC,EAAE,GAAG,EAAqB;QACrC,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,CAAC,EAAE,GAAG,EAAkB;QAC/B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACxD,CAAC;IAED,YAAY,CAAC,EAAE,GAAG,EAAE,UAAU,EAAqB;QACjD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IACtD,CAAC;IAEO,SAAS,CAAC,OAAe,EAAE,MAAc,EAAE,IAAc;;QAC/D,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QAEvC,IAAI,CAAC,IAAI,CAAC;YACR,IAAI,EAAE,OAAO;YACb,EAAE;YACF,QAAQ,EAAE,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,EAAE,mCAAI,IAAI;YAC5B,IAAI,EAAE,GAAG,OAAO,IAAI,MAAM,EAAE;YAC5B,OAAO;YACP,MAAM;YACN,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;SACjB,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,6BAAW,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,MAAM,GAAG,GAAG,CAAC,KAAoB,EAAE,EAAE;YACnC,IAAI,KAAK;gBAAE,OAAO;YAClB,KAAK,GAAG,IAAI,CAAC;YACb,IAAI,CAAC,IAAI,CAAC;gBACR,IAAI,EAAE,KAAK;gBACX,EAAE;gBACF,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE;gBAChB,UAAU,EAAE,6BAAW,CAAC,GAAG,EAAE,GAAG,SAAS;gBACzC,KAAK;aACN,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,oEAAoE;QACpE,uEAAuE;QACvE,wDAAwD;QACxD,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAE/B,OAAO;YACL,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;YACpB,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;SAC3C,CAAC;IACJ,CAAC;IAEO,IAAI,CAAC,KAAgB;QAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;IACxD,CAAC;CACF;AAtED,wDAsEC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/dashboardHtml.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The dashboard page, served at "/". Self-contained: no build step, no CDN.
+ *
+ * Connects to "/events" (Server-Sent Events), receives a full snapshot, then
+ * live span events. Renders the dependency graph as SVG (services laid out in
+ * dependency ranks, dependencies on the left), a stat-tile row, a services
+ * table, and an event log. Service state is shown as a status glyph + word,
+ * never color alone.
+ */
+export declare function renderDashboardHtml(): string;
+//# sourceMappingURL=dashboardHtml.d.ts.map

package/dist/dashboardHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardHtml.d.ts","sourceRoot":"","sources":["../src/dashboardHtml.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C"}