@composed-di/observability 0.5.0-alpha

package/dist/dashboardServer.d.ts

@@ -0,0 +1,99 @@
+import { ServiceModule } from '@composed-di/core';
+import { DashboardEventListener } from './dashboardEventListener';
+import { ModuleGraph } from './moduleGraph';
+import { DashboardSnapshot, SpanEvent } from './events';
+export interface ServiceDashboardOptions {
+    /** How many recent events to keep for late-joining clients. Default 200. */
+    recentEventLimit?: number;
+}
+/**
+ * A realtime dashboard server for observed ServiceModules.
+ *
+ * Serves a self-contained HTML page that renders the dependency graph and
+ * streams service initialization, disposal, and method-call activity to it
+ * over Server-Sent Events. Uses only Node.js built-ins.
+ *
+ * Two ways to feed it, mirroring how OpenTelemetry separates SDK and
+ * collector:
+ *
+ * **Standalone (recommended):** run the server on its own — `npx
+ * composed-di-dashboard` or `new ServiceDashboard().listen(4321)` — and have
+ * the application export to it with a {@link DashboardClient}. The server
+ * accepts `POST /v1/graph` (the dependency graph) and `POST /v1/events`
+ * (batched span events).
+ *
+ * **In-process:** create the module with `dashboard.listener`, call
+ * `dashboard.attach(module)`, and `listen` from the same process.
+ *
+ * @example
+ * ```ts
+ * // dashboard process
+ * const dashboard = new ServiceDashboard();
+ * await dashboard.listen(4321);
+ *
+ * // application process
+ * const client = new DashboardClient({ url: 'http://localhost:4321' });
+ * const module = ServiceModule.from(factories, client.listener);
+ * client.attach(module);
+ * ```
+ */
+export declare class ServiceDashboard {
+    /** Pass this as the second argument to ServiceModule.from. */
+    readonly listener: DashboardEventListener;
+    private nodes;
+    private edges;
+    private services;
+    /** Open spans, so end events can be resolved to their start metadata. */
+    private openSpans;
+    private recent;
+    private readonly recentEventLimit;
+    /** Whether any graph was registered; ingest is refused (409) before that. */
+    private graphRegistered;
+    private clients;
+    private server;
+    private heartbeat;
+    constructor({ recentEventLimit }?: ServiceDashboardOptions);
+    /**
+     * In-process mode: reads the dependency graph out of the module. Call
+     * this with the module that was created with this dashboard's listener.
+     */
+    attach(module: ServiceModule): this;
+    /**
+     * Registers a dependency graph, resetting all aggregated state (a new
+     * registration means a new application run). Remote applications call this
+     * through `POST /v1/graph`.
+     */
+    registerGraph(graph: ModuleGraph): void;
+    /**
+     * Applies span events, e.g. exported by a remote DashboardClient through
+     * `POST /v1/events`. Services not present in the registered graph are
+     * added as standalone nodes rather than dropped.
+     */
+    ingest(events: SpanEvent[]): void;
+    /** The current full dashboard state, as sent to newly connected clients. */
+    snapshot(): DashboardSnapshot;
+    /**
+     * Starts the HTTP server.
+     *
+     * @param port The port to listen on; 0 picks a free port. Default 4321.
+     * @param host The host to bind. Default 127.0.0.1.
+     * @returns The URL the dashboard is reachable at.
+     */
+    listen(port?: number, host?: string): Promise<string>;
+    /** Stops the server and disconnects all clients. */
+    close(): Promise<void>;
+    private route;
+    private acceptEventStream;
+    /**
+     * Applies a raw span event to the aggregated per-service state and
+     * broadcasts the enriched event to connected clients.
+     */
+    private onSpanEvent;
+    private applyStart;
+    private applyEnd;
+    /** Walks to the parent span to find which service triggered this one. */
+    private parentServiceOf;
+    /** Pushes the full state to all connected clients, e.g. on graph changes. */
+    private broadcastSnapshot;
+}
+//# sourceMappingURL=dashboardServer.d.ts.map

package/dist/dashboardServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardServer.d.ts","sourceRoot":"","sources":["../src/dashboardServer.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAe,MAAM,eAAe,CAAC;AAEzD,OAAO,EACL,iBAAiB,EAIjB,SAAS,EAIV,MAAM,UAAU,CAAC;AAElB,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,qBAAa,gBAAgB;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,QAAQ,yBAAgC;IAEjD,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAAmC;IACnD,yEAAyE;IACzE,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,6EAA6E;IAC7E,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,SAAS,CAA+B;gBAEpC,EAAE,gBAAsB,EAAE,GAAE,uBAA4B;IAKpE;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKnC;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAYvC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;IAejC,4EAA4E;IAC5E,QAAQ,IAAI,iBAAiB;IAS7B;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,SAAO,EAAE,IAAI,SAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAyBxD,oDAAoD;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAgBd,KAAK;IA6DnB,OAAO,CAAC,iBAAiB;IAWzB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAqCnB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,QAAQ;IA2BhB,yEAAyE;IACzE,OAAO,CAAC,eAAe;IAKvB,6EAA6E;IAC7E,OAAO,CAAC,iBAAiB;CAI1B"}

package/dist/dashboardServer.js

@@ -0,0 +1,360 @@
+"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.ServiceDashboard = void 0;
+const node_http_1 = require("node:http");
+const dashboardEventListener_1 = require("./dashboardEventListener");
+const moduleGraph_1 = require("./moduleGraph");
+const dashboardHtml_1 = require("./dashboardHtml");
+const HEARTBEAT_INTERVAL_MS = 15000;
+/**
+ * A realtime dashboard server for observed ServiceModules.
+ *
+ * Serves a self-contained HTML page that renders the dependency graph and
+ * streams service initialization, disposal, and method-call activity to it
+ * over Server-Sent Events. Uses only Node.js built-ins.
+ *
+ * Two ways to feed it, mirroring how OpenTelemetry separates SDK and
+ * collector:
+ *
+ * **Standalone (recommended):** run the server on its own — `npx
+ * composed-di-dashboard` or `new ServiceDashboard().listen(4321)` — and have
+ * the application export to it with a {@link DashboardClient}. The server
+ * accepts `POST /v1/graph` (the dependency graph) and `POST /v1/events`
+ * (batched span events).
+ *
+ * **In-process:** create the module with `dashboard.listener`, call
+ * `dashboard.attach(module)`, and `listen` from the same process.
+ *
+ * @example
+ * ```ts
+ * // dashboard process
+ * const dashboard = new ServiceDashboard();
+ * await dashboard.listen(4321);
+ *
+ * // application process
+ * const client = new DashboardClient({ url: 'http://localhost:4321' });
+ * const module = ServiceModule.from(factories, client.listener);
+ * client.attach(module);
+ * ```
+ */
+class ServiceDashboard {
+    constructor({ recentEventLimit = 200 } = {}) {
+        /** Pass this as the second argument to ServiceModule.from. */
+        this.listener = new dashboardEventListener_1.DashboardEventListener();
+        this.nodes = [];
+        this.edges = [];
+        this.services = new Map();
+        /** Open spans, so end events can be resolved to their start metadata. */
+        this.openSpans = new Map();
+        this.recent = [];
+        /** Whether any graph was registered; ingest is refused (409) before that. */
+        this.graphRegistered = false;
+        this.clients = new Set();
+        this.server = null;
+        this.heartbeat = null;
+        this.recentEventLimit = recentEventLimit;
+        this.listener.subscribe((event) => this.onSpanEvent(event));
+    }
+    /**
+     * In-process mode: reads the dependency graph out of the module. Call
+     * this with the module that was created with this dashboard's listener.
+     */
+    attach(module) {
+        this.registerGraph((0, moduleGraph_1.moduleGraph)(module));
+        return this;
+    }
+    /**
+     * Registers a dependency graph, resetting all aggregated state (a new
+     * registration means a new application run). Remote applications call this
+     * through `POST /v1/graph`.
+     */
+    registerGraph(graph) {
+        this.graphRegistered = true;
+        this.nodes = graph.nodes;
+        this.edges = graph.edges;
+        this.services = new Map(this.nodes.map((node) => [node.name, freshStats()]));
+        this.openSpans.clear();
+        this.recent = [];
+        this.broadcastSnapshot();
+    }
+    /**
+     * Applies span events, e.g. exported by a remote DashboardClient through
+     * `POST /v1/events`. Services not present in the registered graph are
+     * added as standalone nodes rather than dropped.
+     */
+    ingest(events) {
+        for (const event of events) {
+            if (event.type === 'start' &&
+                event.service !== null &&
+                !this.services.has(event.service)) {
+                this.nodes.push({ name: event.service });
+                this.services.set(event.service, freshStats());
+                this.broadcastSnapshot();
+            }
+            this.onSpanEvent(event);
+        }
+    }
+    /** The current full dashboard state, as sent to newly connected clients. */
+    snapshot() {
+        return {
+            nodes: this.nodes,
+            edges: this.edges,
+            services: Object.fromEntries(this.services),
+            recent: this.recent,
+        };
+    }
+    /**
+     * Starts the HTTP server.
+     *
+     * @param port The port to listen on; 0 picks a free port. Default 4321.
+     * @param host The host to bind. Default 127.0.0.1.
+     * @returns The URL the dashboard is reachable at.
+     */
+    listen(port = 4321, host = '127.0.0.1') {
+        if (this.server) {
+            throw new Error('Dashboard server is already listening');
+        }
+        const server = (0, node_http_1.createServer)((request, response) => {
+            void this.route(request, response);
+        });
+        this.server = server;
+        this.heartbeat = setInterval(() => {
+            this.clients.forEach((client) => client.write(': ping\n\n'));
+        }, HEARTBEAT_INTERVAL_MS);
+        // Don't let an idle dashboard keep the process alive on its own.
+        this.heartbeat.unref();
+        return new Promise((resolve, reject) => {
+            server.once('error', reject);
+            server.listen(port, host, () => {
+                const address = server.address();
+                const shownHost = host === '0.0.0.0' || host === '::' ? 'localhost' : host;
+                resolve(`http://${shownHost}:${address.port}`);
+            });
+        });
+    }
+    /** Stops the server and disconnects all clients. */
+    close() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.heartbeat) {
+                clearInterval(this.heartbeat);
+                this.heartbeat = null;
+            }
+            this.clients.forEach((client) => client.end());
+            this.clients.clear();
+            const server = this.server;
+            this.server = null;
+            if (server) {
+                yield new Promise((resolve, reject) => {
+                    server.close((error) => (error ? reject(error) : resolve()));
+                });
+            }
+        });
+    }
+    route(request, response) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const path = (_a = request.url) === null || _a === void 0 ? void 0 : _a.split('?')[0];
+            const route = `${request.method} ${path}`;
+            try {
+                switch (route) {
+                    case 'GET /':
+                        response.writeHead(200, {
+                            'content-type': 'text/html; charset=utf-8',
+                        });
+                        response.end((0, dashboardHtml_1.renderDashboardHtml)());
+                        return;
+                    case 'GET /events':
+                        this.acceptEventStream(response);
+                        return;
+                    case 'GET /snapshot':
+                        response.writeHead(200, { 'content-type': 'application/json' });
+                        response.end(JSON.stringify(this.snapshot()));
+                        return;
+                    case 'POST /v1/graph': {
+                        const graph = yield readJsonBody(request);
+                        if (!Array.isArray(graph === null || graph === void 0 ? void 0 : graph.nodes) || !Array.isArray(graph === null || graph === void 0 ? void 0 : graph.edges)) {
+                            throw new BadRequestError('expected { nodes: [], edges: [] }');
+                        }
+                        this.registerGraph(graph);
+                        response.writeHead(204);
+                        response.end();
+                        return;
+                    }
+                    case 'POST /v1/events': {
+                        const body = yield readJsonBody(request);
+                        if (!Array.isArray(body === null || body === void 0 ? void 0 : body.events)) {
+                            throw new BadRequestError('expected { events: [] }');
+                        }
+                        // A restarted server has no graph; tell the client to re-register
+                        // before it sends events, so context isn't rendered nodeless.
+                        if (!this.graphRegistered) {
+                            response.writeHead(409, { 'content-type': 'text/plain' });
+                            response.end('no graph registered; POST /v1/graph first');
+                            return;
+                        }
+                        this.ingest(body.events);
+                        response.writeHead(204);
+                        response.end();
+                        return;
+                    }
+                    default:
+                        response.writeHead(404, { 'content-type': 'text/plain' });
+                        response.end('Not found');
+                }
+            }
+            catch (error) {
+                const badRequest = error instanceof BadRequestError;
+                response.writeHead(badRequest ? 400 : 500, {
+                    'content-type': 'text/plain',
+                });
+                response.end(badRequest ? error.message : 'Internal error');
+            }
+        });
+    }
+    acceptEventStream(response) {
+        response.writeHead(200, {
+            'content-type': 'text/event-stream',
+            'cache-control': 'no-cache',
+            connection: 'keep-alive',
+        });
+        response.write(sseMessage('snapshot', this.snapshot()));
+        this.clients.add(response);
+        response.on('close', () => this.clients.delete(response));
+    }
+    /**
+     * Applies a raw span event to the aggregated per-service state and
+     * broadcasts the enriched event to connected clients.
+     */
+    onSpanEvent(event) {
+        var _a, _b, _c;
+        let wire;
+        if (event.type === 'start') {
+            this.openSpans.set(event.id, event);
+            const stats = this.applyStart(event);
+            wire = {
+                span: event,
+                service: event.service,
+                method: event.method,
+                kind: event.kind,
+                parentService: this.parentServiceOf(event),
+                // Copy so the recent-events buffer keeps at-the-time values.
+                stats: stats ? Object.assign({}, stats) : null,
+            };
+        }
+        else {
+            const start = this.openSpans.get(event.id);
+            this.openSpans.delete(event.id);
+            const stats = start ? this.applyEnd(start, event) : null;
+            wire = {
+                span: event,
+                service: (_a = start === null || start === void 0 ? void 0 : start.service) !== null && _a !== void 0 ? _a : null,
+                method: (_b = start === null || start === void 0 ? void 0 : start.method) !== null && _b !== void 0 ? _b : '?',
+                kind: (_c = start === null || start === void 0 ? void 0 : start.kind) !== null && _c !== void 0 ? _c : 'call',
+                parentService: start ? this.parentServiceOf(start) : null,
+                stats: stats ? Object.assign({}, stats) : null,
+            };
+        }
+        this.recent.push(wire);
+        if (this.recent.length > this.recentEventLimit) {
+            this.recent.splice(0, this.recent.length - this.recentEventLimit);
+        }
+        const message = sseMessage('span', wire);
+        this.clients.forEach((client) => client.write(message));
+    }
+    applyStart(event) {
+        const stats = event.service ? this.services.get(event.service) : undefined;
+        if (!stats)
+            return null;
+        if (event.kind === 'initialize') {
+            stats.status = 'initializing';
+        }
+        return stats;
+    }
+    applyEnd(start, event) {
+        const stats = start.service ? this.services.get(start.service) : undefined;
+        if (!stats)
+            return null;
+        if (event.error !== null) {
+            stats.errors += 1;
+        }
+        const transitions = {
+            initialize: () => {
+                stats.status = event.error !== null ? 'error' : 'ready';
+                if (event.error === null)
+                    stats.initMs = event.durationMs;
+            },
+            dispose: () => {
+                if (event.error === null)
+                    stats.status = 'disposed';
+            },
+            call: () => {
+                stats.calls += 1;
+                stats.totalCallMs += event.durationMs;
+            },
+        };
+        transitions[start.kind]();
+        return stats;
+    }
+    /** Walks to the parent span to find which service triggered this one. */
+    parentServiceOf(event) {
+        var _a, _b;
+        if (event.parentId === null)
+            return null;
+        return (_b = (_a = this.openSpans.get(event.parentId)) === null || _a === void 0 ? void 0 : _a.service) !== null && _b !== void 0 ? _b : null;
+    }
+    /** Pushes the full state to all connected clients, e.g. on graph changes. */
+    broadcastSnapshot() {
+        const message = sseMessage('snapshot', this.snapshot());
+        this.clients.forEach((client) => client.write(message));
+    }
+}
+exports.ServiceDashboard = ServiceDashboard;
+function freshStats() {
+    return {
+        status: 'pending',
+        initMs: null,
+        calls: 0,
+        errors: 0,
+        totalCallMs: 0,
+    };
+}
+class BadRequestError extends Error {
+}
+const MAX_BODY_BYTES = 5 * 1024 * 1024;
+function readJsonBody(request) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        let size = 0;
+        request.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > MAX_BODY_BYTES) {
+                reject(new BadRequestError('request body too large'));
+                request.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        request.on('end', () => {
+            try {
+                resolve(JSON.parse(Buffer.concat(chunks).toString('utf8')));
+            }
+            catch (_a) {
+                reject(new BadRequestError('invalid JSON body'));
+            }
+        });
+        request.on('error', reject);
+    });
+}
+function sseMessage(event, data) {
+    return `event: ${event}\ndata: ${JSON.stringify(data)}\n\n`;
+}
+//# sourceMappingURL=dashboardServer.js.map

package/dist/dashboardServer.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Event and state types shared between the dashboard event listener, the
+ * dashboard server, and the browser client (over the SSE wire).
+ */
+/** Classifies what a span represents in the service lifecycle. */
+export type SpanKind = 'initialize' | 'dispose' | 'call';
+/** Emitted when a traced function starts executing. */
+export interface SpanStart {
+    type: 'start';
+    /** Monotonically increasing span id, unique per tracer. */
+    id: number;
+    /** Id of the span that was active when this one started, if any. */
+    parentId: number | null;
+    /** The qualified span name, e.g. "Database.query". */
+    name: string;
+    /** The service the span belongs to, or null if it could not be attributed. */
+    service: string | null;
+    /** The method or lifecycle step, e.g. "query" or "initialize". */
+    method: string;
+    kind: SpanKind;
+    /** Epoch milliseconds. */
+    time: number;
+}
+/** Emitted when a traced function finishes (or throws/rejects). */
+export interface SpanEnd {
+    type: 'end';
+    /** Matches the id of the corresponding SpanStart. */
+    id: number;
+    /** Epoch milliseconds. */
+    time: number;
+    durationMs: number;
+    /** The error message when the traced function threw or rejected. */
+    error: string | null;
+}
+export type SpanEvent = SpanStart | SpanEnd;
+export type ServiceStatus = 'pending' | 'initializing' | 'ready' | 'error' | 'disposed';
+/** Aggregated per-service counters maintained by the dashboard. */
+export interface ServiceStats {
+    status: ServiceStatus;
+    /** Duration of the last successful initialization, if any. */
+    initMs: number | null;
+    /** Number of completed method-call spans. */
+    calls: number;
+    /** Number of spans (of any kind) that ended with an error. */
+    errors: number;
+    /** Sum of completed method-call durations, for averaging. */
+    totalCallMs: number;
+}
+export interface GraphNode {
+    name: string;
+}
+/** A dependency edge: `from` depends on `to`. */
+export interface GraphEdge {
+    from: string;
+    to: string;
+}
+/**
+ * The enriched event broadcast to dashboard clients. The server resolves
+ * cross-span context (parent service, span metadata on end events) and the
+ * updated per-service stats so the client needs no correlation logic.
+ */
+export interface WireEvent {
+    span: SpanEvent;
+    /** Service of the span; on end events resolved from the matching start. */
+    service: string | null;
+    method: string;
+    kind: SpanKind;
+    /** Service of the parent span, when the span was started by another service. */
+    parentService: string | null;
+    /** Updated stats for `service`, present when the event changed them. */
+    stats: ServiceStats | null;
+}
+/** Full state sent to a client when it connects. */
+export interface DashboardSnapshot {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+    services: Record<string, ServiceStats>;
+    recent: WireEvent[];
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kEAAkE;AAClE,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,oEAAoE;IACpE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,mEAAmE;AACnE,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,KAAK,CAAC;IACZ,qDAAqD;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;AAE5C,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,cAAc,GACd,OAAO,GACP,OAAO,GACP,UAAU,CAAC;AAEf,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,iDAAiD;AACjD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,CAAC;IACf,gFAAgF;IAChF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,wEAAwE;IACxE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;CAC5B;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACvC,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB"}

package/dist/events.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Event and state types shared between the dashboard event listener, the
+ * dashboard server, and the browser client (over the SSE wire).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './events';
+export * from './dashboardEventListener';
+export * from './dashboardClient';
+export * from './dashboardServer';
+export * from './moduleGraph';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./events"), exports);
+__exportStar(require("./dashboardEventListener"), exports);
+__exportStar(require("./dashboardClient"), exports);
+__exportStar(require("./dashboardServer"), exports);
+__exportStar(require("./moduleGraph"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,2DAAyC;AACzC,oDAAkC;AAClC,oDAAkC;AAClC,gDAA8B"}

package/dist/moduleGraph.d.ts

@@ -0,0 +1,13 @@
+import { ServiceModule } from '@composed-di/core';
+import { GraphEdge, GraphNode } from './events';
+export interface ModuleGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+/**
+ * Extracts the dependency graph of a module: one node per factory, one edge
+ * per dependency. Selector dependencies expand to an edge per grouped key
+ * ("may resolve any of these").
+ */
+export declare function moduleGraph(module: ServiceModule): ModuleGraph;
+//# sourceMappingURL=moduleGraph.d.ts.map

package/dist/moduleGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moduleGraph.d.ts","sourceRoot":"","sources":["../src/moduleGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EAEd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAmB9D"}

package/dist/moduleGraph.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.moduleGraph = moduleGraph;
+const core_1 = require("@composed-di/core");
+/**
+ * Extracts the dependency graph of a module: one node per factory, one edge
+ * per dependency. Selector dependencies expand to an edge per grouped key
+ * ("may resolve any of these").
+ */
+function moduleGraph(module) {
+    const nodes = module.factories.map((factory) => ({
+        name: factory.provides.name,
+    }));
+    const edges = module.factories.flatMap((factory) => factory.dependsOn.flatMap((dependency) => {
+        const targets = dependency instanceof core_1.ServiceSelectorKey
+            ? dependency.values
+            : [dependency];
+        return targets.map((target) => ({
+            from: factory.provides.name,
+            to: target.name,
+        }));
+    }));
+    return { nodes, edges };
+}
+//# sourceMappingURL=moduleGraph.js.map