network-ai 4.15.2 → 5.0.0

package/dist/lib/coverage-reporter.js

@@ -0,0 +1,177 @@
+"use strict";
+/**
+ * CoverageReporter — Lightweight code coverage reporting without external deps
+ *
+ * Integrates with Node.js built-in V8 coverage (`NODE_V8_COVERAGE`).
+ * Parses V8 coverage JSON output into a structured report with file-level
+ * line and function coverage metrics. Supports thresholds and reporters.
+ *
+ * Usage:
+ *   // Run tests with V8 coverage:
+ *   // NODE_V8_COVERAGE=./coverage npx ts-node test.ts
+ *
+ *   const reporter = new CoverageReporter({ coverageDir: './coverage' });
+ *   const report = await reporter.collect();
+ *   reporter.printSummary(report);
+ *   reporter.enforce(report, { linePct: 80, branchPct: 70 });
+ *
+ * @module CoverageReporter
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CoverageReporter = void 0;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+// ============================================================================
+// REPORTER
+// ============================================================================
+/**
+ * CoverageReporter — Collects and reports V8 code coverage data.
+ */
+class CoverageReporter {
+    config;
+    constructor(config) {
+        this.config = {
+            coverageDir: (0, path_1.resolve)(config.coverageDir),
+            projectRoot: config.projectRoot ?? process.cwd(),
+            include: config.include ?? ['.ts', '.js'],
+            exclude: config.exclude ?? ['node_modules', 'test-', 'dist/'],
+        };
+    }
+    /**
+     * Collect coverage data from V8 coverage directory.
+     */
+    async collect() {
+        const files = [];
+        const coverageFiles = await this.findCoverageFiles();
+        for (const cf of coverageFiles) {
+            const raw = await (0, promises_1.readFile)(cf, 'utf-8');
+            const data = JSON.parse(raw);
+            for (const script of data.result) {
+                if (!this.shouldInclude(script.url))
+                    continue;
+                const relPath = this.toRelativePath(script.url);
+                const existing = files.find((f) => f.file === relPath);
+                if (existing)
+                    continue; // Deduplicate
+                const totalFunctions = script.functions.length;
+                const coveredFunctions = script.functions.filter((fn) => fn.ranges.some((r) => r.count > 0)).length;
+                let totalRanges = 0;
+                let coveredRanges = 0;
+                for (const fn of script.functions) {
+                    for (const range of fn.ranges) {
+                        totalRanges++;
+                        if (range.count > 0)
+                            coveredRanges++;
+                    }
+                }
+                files.push({
+                    file: relPath,
+                    totalFunctions,
+                    coveredFunctions,
+                    functionPct: totalFunctions > 0 ? round((coveredFunctions / totalFunctions) * 100) : 100,
+                    totalRanges,
+                    coveredRanges,
+                    rangePct: totalRanges > 0 ? round((coveredRanges / totalRanges) * 100) : 100,
+                });
+            }
+        }
+        files.sort((a, b) => a.file.localeCompare(b.file));
+        const totalFns = files.reduce((s, f) => s + f.totalFunctions, 0);
+        const coveredFns = files.reduce((s, f) => s + f.coveredFunctions, 0);
+        const totalRng = files.reduce((s, f) => s + f.totalRanges, 0);
+        const coveredRng = files.reduce((s, f) => s + f.coveredRanges, 0);
+        return {
+            files,
+            totalFunctionPct: totalFns > 0 ? round((coveredFns / totalFns) * 100) : 100,
+            totalRangePct: totalRng > 0 ? round((coveredRng / totalRng) * 100) : 100,
+            fileCount: files.length,
+            generatedAt: Date.now(),
+        };
+    }
+    /**
+     * Print a summary table to console.
+     */
+    printSummary(report) {
+        const header = 'File'.padEnd(50) + 'Functions'.padEnd(15) + 'Ranges';
+        console.log('─'.repeat(75));
+        console.log(header);
+        console.log('─'.repeat(75));
+        for (const f of report.files) {
+            const name = f.file.length > 48 ? '…' + f.file.slice(-47) : f.file;
+            const fnCol = `${f.coveredFunctions}/${f.totalFunctions} (${f.functionPct}%)`.padEnd(15);
+            const rgCol = `${f.coveredRanges}/${f.totalRanges} (${f.rangePct}%)`;
+            console.log(name.padEnd(50) + fnCol + rgCol);
+        }
+        console.log('─'.repeat(75));
+        console.log(`Total: ${report.fileCount} files | ` +
+            `Functions: ${report.totalFunctionPct}% | ` +
+            `Ranges: ${report.totalRangePct}%`);
+        console.log('─'.repeat(75));
+    }
+    /**
+     * Enforce coverage thresholds. Throws if below threshold.
+     */
+    enforce(report, thresholds) {
+        const failures = [];
+        if (thresholds.functionPct !== undefined && report.totalFunctionPct < thresholds.functionPct) {
+            failures.push(`Function coverage ${report.totalFunctionPct}% below threshold ${thresholds.functionPct}%`);
+        }
+        if (thresholds.rangePct !== undefined && report.totalRangePct < thresholds.rangePct) {
+            failures.push(`Range coverage ${report.totalRangePct}% below threshold ${thresholds.rangePct}%`);
+        }
+        if (thresholds.perFileFunctionPct !== undefined) {
+            for (const f of report.files) {
+                if (f.functionPct < thresholds.perFileFunctionPct) {
+                    failures.push(`${f.file}: function coverage ${f.functionPct}% below per-file threshold ${thresholds.perFileFunctionPct}%`);
+                }
+            }
+        }
+        if (failures.length > 0) {
+            throw new Error(`Coverage thresholds not met:\n${failures.join('\n')}`);
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Internal
+    // --------------------------------------------------------------------------
+    async findCoverageFiles() {
+        const results = [];
+        try {
+            const entries = await (0, promises_1.readdir)(this.config.coverageDir);
+            for (const entry of entries) {
+                if (entry.endsWith('.json')) {
+                    results.push((0, path_1.join)(this.config.coverageDir, entry));
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist or not readable
+        }
+        return results;
+    }
+    shouldInclude(url) {
+        if (!url || url.startsWith('node:'))
+            return false;
+        const hasInclude = this.config.include.some((p) => url.includes(p));
+        const hasExclude = this.config.exclude.some((p) => url.includes(p));
+        return hasInclude && !hasExclude;
+    }
+    toRelativePath(url) {
+        let path = url;
+        // Strip file:// prefix
+        if (path.startsWith('file://')) {
+            path = path.slice(7);
+        }
+        // On Windows, strip leading slash before drive letter
+        if (/^\/[A-Za-z]:/.test(path)) {
+            path = path.slice(1);
+        }
+        return (0, path_1.relative)(this.config.projectRoot, path).replace(/\\/g, '/');
+    }
+}
+exports.CoverageReporter = CoverageReporter;
+/** Round to 1 decimal */
+function round(n) {
+    return Math.round(n * 10) / 10;
+}
+//# sourceMappingURL=coverage-reporter.js.map

package/dist/lib/coverage-reporter.js.map

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

package/dist/lib/dashboard-server.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Dashboard Server — Serves the live agent topology dashboard
+ *
+ * A zero-dependency HTTP + WebSocket server that streams topology events
+ * to a browser-based visualization. Uses only Node.js built-in modules.
+ *
+ * @module DashboardServer
+ * @version 1.0.0
+ */
+import { EventEmitter } from 'events';
+import type { TopologyTracker } from './topology';
+/** Options for creating a DashboardServer */
+export interface DashboardServerOptions {
+    /** TCP port to listen on (default: 4820) */
+    port?: number;
+    /** Hostname to bind to (default: '127.0.0.1') */
+    host?: string;
+    /** Whether to open the browser automatically (default: true) */
+    open?: boolean;
+}
+/**
+ * HTTP + WebSocket server for the live agent topology dashboard.
+ *
+ * Usage:
+ * ```typescript
+ * const topo = new TopologyTracker();
+ * const dashboard = new DashboardServer(topo, { port: 4820 });
+ * await dashboard.start();
+ * // Dashboard available at http://127.0.0.1:4820
+ * ```
+ */
+export declare class DashboardServer extends EventEmitter {
+    private readonly tracker;
+    private readonly port;
+    private readonly host;
+    private server;
+    private clients;
+    private pingInterval;
+    private eventHandler;
+    private clientCounter;
+    private deltaPending;
+    constructor(tracker: TopologyTracker, options?: DashboardServerOptions);
+    /**
+     * Start the dashboard server.
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the dashboard server.
+     */
+    stop(): Promise<void>;
+    /**
+     * Number of connected WebSocket clients.
+     */
+    clientCount(): number;
+    /**
+     * The URL the dashboard is serving on.
+     */
+    get url(): string;
+    private handleHTTP;
+    private handleUpgrade;
+    private handleClientMessage;
+    private broadcast;
+    /**
+     * Broadcast a delta patch to all connected clients.
+     * Each client tracks its own lastSeq so we can compute per-client deltas.
+     * For simplicity, we use a single shared delta and reset after broadcast.
+     */
+    private broadcastDelta;
+    private pingClients;
+}
+//# sourceMappingURL=dashboard-server.d.ts.map

package/dist/lib/dashboard-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-server.d.ts","sourceRoot":"","sources":["../../lib/dashboard-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,KAAK,EAAE,eAAe,EAAkD,MAAM,YAAY,CAAC;AAMlG,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA+FD;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,MAAM,CAAgD;IAC9D,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,YAAY,CAA+C;IACnE,OAAO,CAAC,YAAY,CAAiD;IACrE,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAS;gBAEjB,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAOtE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+B5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAMD,OAAO,CAAC,UAAU;IA8ClB,OAAO,CAAC,aAAa;IAoGrB,OAAO,CAAC,mBAAmB;IAY3B,OAAO,CAAC,SAAS;IAMjB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAqCtB,OAAO,CAAC,WAAW;CAqBpB"}

package/dist/lib/dashboard-server.js

@@ -0,0 +1,403 @@
+"use strict";
+/**
+ * Dashboard Server — Serves the live agent topology dashboard
+ *
+ * A zero-dependency HTTP + WebSocket server that streams topology events
+ * to a browser-based visualization. Uses only Node.js built-in modules.
+ *
+ * @module DashboardServer
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DashboardServer = void 0;
+const http_1 = require("http");
+const crypto_1 = require("crypto");
+const events_1 = require("events");
+const fs_1 = require("fs");
+const path_1 = require("path");
+// ============================================================================
+// WEBSOCKET HELPERS (RFC 6455, minimal implementation)
+// ============================================================================
+const WS_GUID = '258EAFA5-E914-47DA-95CA-C5AB0DC85B11';
+function computeAcceptKey(key) {
+    return (0, crypto_1.createHash)('sha1').update(key + WS_GUID).digest('base64');
+}
+function encodeWSFrame(data) {
+    const payload = Buffer.from(data, 'utf8');
+    const len = payload.length;
+    let header;
+    if (len < 126) {
+        header = Buffer.alloc(2);
+        header[0] = 0x81; // FIN + text opcode
+        header[1] = len;
+    }
+    else if (len < 65536) {
+        header = Buffer.alloc(4);
+        header[0] = 0x81;
+        header[1] = 126;
+        header.writeUInt16BE(len, 2);
+    }
+    else {
+        header = Buffer.alloc(10);
+        header[0] = 0x81;
+        header[1] = 127;
+        // Write as two 32-bit values (safe for strings < 4GB)
+        header.writeUInt32BE(0, 2);
+        header.writeUInt32BE(len, 6);
+    }
+    return Buffer.concat([header, payload]);
+}
+function decodeWSFrame(buf) {
+    if (buf.length < 2)
+        return null;
+    const opcode = buf[0] & 0x0f;
+    const masked = (buf[1] & 0x80) !== 0;
+    let payloadLen = buf[1] & 0x7f;
+    let offset = 2;
+    if (payloadLen === 126) {
+        if (buf.length < 4)
+            return null;
+        payloadLen = buf.readUInt16BE(2);
+        offset = 4;
+    }
+    else if (payloadLen === 127) {
+        if (buf.length < 10)
+            return null;
+        payloadLen = buf.readUInt32BE(6); // ignore high 32 bits
+        offset = 10;
+    }
+    if (masked) {
+        if (buf.length < offset + 4 + payloadLen)
+            return null;
+        const mask = buf.subarray(offset, offset + 4);
+        offset += 4;
+        const payload = Buffer.alloc(payloadLen);
+        for (let i = 0; i < payloadLen; i++) {
+            payload[i] = buf[offset + i] ^ mask[i % 4];
+        }
+        return { opcode, payload };
+    }
+    if (buf.length < offset + payloadLen)
+        return null;
+    return { opcode, payload: buf.subarray(offset, offset + payloadLen) };
+}
+// ============================================================================
+// DASHBOARD HTML (inline single-page app)
+// ============================================================================
+function getDashboardHTML(wsPort) {
+    // HTML loaded from the separate dashboard.html asset (Phase 1.2 extraction)
+    const htmlPath = (0, path_1.join)(__dirname, 'dashboard.html');
+    const html = (0, fs_1.readFileSync)(htmlPath, 'utf-8');
+    return html.replace('__WS_PORT__', String(wsPort));
+}
+// ============================================================================
+// DASHBOARD SERVER
+// ============================================================================
+/**
+ * HTTP + WebSocket server for the live agent topology dashboard.
+ *
+ * Usage:
+ * ```typescript
+ * const topo = new TopologyTracker();
+ * const dashboard = new DashboardServer(topo, { port: 4820 });
+ * await dashboard.start();
+ * // Dashboard available at http://127.0.0.1:4820
+ * ```
+ */
+class DashboardServer extends events_1.EventEmitter {
+    tracker;
+    port;
+    host;
+    server = null;
+    clients = new Map();
+    pingInterval = null;
+    eventHandler = null;
+    clientCounter = 0;
+    deltaPending = false;
+    constructor(tracker, options) {
+        super();
+        this.tracker = tracker;
+        this.port = options?.port ?? 4820;
+        this.host = options?.host ?? '127.0.0.1';
+    }
+    /**
+     * Start the dashboard server.
+     */
+    async start() {
+        return new Promise((resolve, reject) => {
+            const server = (0, http_1.createServer)((req, res) => this.handleHTTP(req, res));
+            server.on('upgrade', (req, socket) => {
+                this.handleUpgrade(req, socket);
+            });
+            server.on('error', (err) => {
+                this.emit('error', err);
+                reject(err);
+            });
+            server.listen(this.port, this.host, () => {
+                this.server = server;
+                // Subscribe to topology events and broadcast deltas
+                this.eventHandler = (_event) => {
+                    this.broadcastDelta();
+                };
+                this.tracker.on('event', this.eventHandler);
+                // Ping clients every 30s
+                this.pingInterval = setInterval(() => this.pingClients(), 30000);
+                this.emit('listening', { port: this.port, host: this.host });
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the dashboard server.
+     */
+    async stop() {
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+        if (this.eventHandler) {
+            this.tracker.off('event', this.eventHandler);
+            this.eventHandler = null;
+        }
+        // Close all WebSocket clients
+        for (const client of this.clients.values()) {
+            client.close();
+        }
+        this.clients.clear();
+        return new Promise((resolve) => {
+            if (!this.server) {
+                resolve();
+                return;
+            }
+            this.server.close(() => {
+                this.server = null;
+                resolve();
+            });
+        });
+    }
+    /**
+     * Number of connected WebSocket clients.
+     */
+    clientCount() {
+        return this.clients.size;
+    }
+    /**
+     * The URL the dashboard is serving on.
+     */
+    get url() {
+        return `http://${this.host}:${this.port}`;
+    }
+    // --------------------------------------------------------------------------
+    // HTTP HANDLER
+    // --------------------------------------------------------------------------
+    handleHTTP(req, res) {
+        const url = req.url ?? '/';
+        if (url === '/' || url === '/index.html') {
+            res.writeHead(200, {
+                'Content-Type': 'text/html; charset=utf-8',
+                'Cache-Control': 'no-cache',
+                'X-Content-Type-Options': 'nosniff',
+            });
+            res.end(getDashboardHTML(this.port));
+            return;
+        }
+        if (url === '/api/snapshot') {
+            const snapshot = this.tracker.snapshot();
+            res.writeHead(200, {
+                'Content-Type': 'application/json',
+                'Cache-Control': 'no-cache',
+                'X-Content-Type-Options': 'nosniff',
+            });
+            res.end(JSON.stringify(snapshot));
+            return;
+        }
+        if (url === '/api/health') {
+            res.writeHead(200, {
+                'Content-Type': 'application/json',
+                'X-Content-Type-Options': 'nosniff',
+            });
+            res.end(JSON.stringify({
+                status: 'ok',
+                clients: this.clients.size,
+                nodes: this.tracker.nodeCount(),
+                edges: this.tracker.edgeCount(),
+            }));
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'text/plain' });
+        res.end('Not Found');
+    }
+    // --------------------------------------------------------------------------
+    // WEBSOCKET UPGRADE
+    // --------------------------------------------------------------------------
+    handleUpgrade(req, socket) {
+        const key = req.headers['sec-websocket-key'];
+        if (!key) {
+            socket.destroy();
+            return;
+        }
+        const acceptKey = computeAcceptKey(key);
+        const headers = [
+            'HTTP/1.1 101 Switching Protocols',
+            'Upgrade: websocket',
+            'Connection: Upgrade',
+            `Sec-WebSocket-Accept: ${acceptKey}`,
+            '',
+            '',
+        ].join('\r\n');
+        socket.write(headers);
+        const clientId = `ws-${++this.clientCounter}`;
+        const client = {
+            id: clientId,
+            send: (data) => {
+                try {
+                    socket.write(encodeWSFrame(data));
+                }
+                catch {
+                    // Client disconnected
+                }
+            },
+            close: () => {
+                try {
+                    // Send close frame
+                    const closeFrame = Buffer.alloc(2);
+                    closeFrame[0] = 0x88; // FIN + close
+                    closeFrame[1] = 0x00;
+                    socket.write(closeFrame);
+                    socket.end();
+                }
+                catch {
+                    // Already closed
+                }
+            },
+            alive: true,
+            lastSeq: 0,
+        };
+        this.clients.set(clientId, client);
+        this.emit('client:connected', clientId);
+        // Send initial snapshot
+        const snapshot = this.tracker.snapshotQuiet();
+        client.send(JSON.stringify({ type: 'snapshot', data: snapshot }));
+        client.lastSeq = this.tracker.currentSeq();
+        // Handle incoming messages
+        let buffer = Buffer.alloc(0);
+        socket.on('data', (chunk) => {
+            buffer = Buffer.concat([buffer, chunk]);
+            const frame = decodeWSFrame(buffer);
+            if (!frame)
+                return;
+            buffer = Buffer.alloc(0);
+            if (frame.opcode === 0x08) {
+                // Close frame
+                this.clients.delete(clientId);
+                socket.end();
+                this.emit('client:disconnected', clientId);
+                return;
+            }
+            if (frame.opcode === 0x0a) {
+                // Pong
+                client.alive = true;
+                return;
+            }
+            if (frame.opcode === 0x01) {
+                // Text message — handle commands
+                try {
+                    const msg = JSON.parse(frame.payload.toString('utf8'));
+                    this.handleClientMessage(client, msg);
+                }
+                catch {
+                    // Ignore malformed messages
+                }
+            }
+        });
+        socket.on('close', () => {
+            this.clients.delete(clientId);
+            this.emit('client:disconnected', clientId);
+        });
+        socket.on('error', () => {
+            this.clients.delete(clientId);
+        });
+    }
+    // --------------------------------------------------------------------------
+    // WEBSOCKET MESSAGE HANDLING
+    // --------------------------------------------------------------------------
+    handleClientMessage(client, msg) {
+        if (msg.action === 'snapshot') {
+            const snapshot = this.tracker.snapshotQuiet();
+            snapshot.clusters = this.tracker.computeClusters();
+            client.send(JSON.stringify({ type: 'snapshot', data: snapshot }));
+            client.lastSeq = this.tracker.currentSeq();
+        }
+    }
+    broadcast(data) {
+        for (const client of this.clients.values()) {
+            client.send(data);
+        }
+    }
+    /**
+     * Broadcast a delta patch to all connected clients.
+     * Each client tracks its own lastSeq so we can compute per-client deltas.
+     * For simplicity, we use a single shared delta and reset after broadcast.
+     */
+    broadcastDelta() {
+        if (this.clients.size === 0)
+            return;
+        // Debounce: accumulate rapid events into one delta per tick
+        if (this.deltaPending)
+            return;
+        this.deltaPending = true;
+        // Use queueMicrotask so multiple sync events within one tick batch together
+        queueMicrotask(() => {
+            this.deltaPending = false;
+            if (this.clients.size === 0)
+                return;
+            // If there are many nodes (>200), send delta; otherwise send full snapshot
+            // for simplicity on small topologies
+            const nodeCount = this.tracker.nodeCount();
+            if (nodeCount <= 200) {
+                const snapshot = this.tracker.snapshotQuiet();
+                const data = JSON.stringify({ type: 'snapshot', data: snapshot });
+                for (const client of this.clients.values()) {
+                    client.send(data);
+                    client.lastSeq = this.tracker.currentSeq();
+                }
+            }
+            else {
+                // Delta protocol for large topologies
+                const minSeq = Math.min(...Array.from(this.clients.values()).map(c => c.lastSeq));
+                const delta = this.tracker.delta(minSeq);
+                delta.clusters = this.tracker.computeClusters();
+                const data = JSON.stringify({ type: 'delta', data: delta });
+                for (const client of this.clients.values()) {
+                    client.send(data);
+                    client.lastSeq = this.tracker.currentSeq();
+                }
+            }
+            this.tracker.resetDelta();
+        });
+    }
+    pingClients() {
+        for (const [id, client] of this.clients.entries()) {
+            if (!client.alive) {
+                this.clients.delete(id);
+                client.close();
+                this.emit('client:disconnected', id);
+                continue;
+            }
+            client.alive = false;
+            // Send ping frame
+            try {
+                const ping = Buffer.alloc(2);
+                ping[0] = 0x89; // FIN + ping
+                ping[1] = 0x00;
+                // We can't write directly to socket from here, so mark alive = false
+                // and wait for next data activity
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+exports.DashboardServer = DashboardServer;
+//# sourceMappingURL=dashboard-server.js.map