@n-dx/core 0.1.0

package/packages/web/dist/server/websocket.js

@@ -0,0 +1,512 @@
+/**
+ * WebSocket support for real-time updates.
+ *
+ * Implements the WebSocket protocol (RFC 6455) using only Node.js built-in
+ * modules — no external dependencies required.
+ *
+ * Supports:
+ * - Broadcasting PRD item changes to connected clients
+ * - Broadcasting file-change events (sourcevision data updates)
+ * - Immediate disconnect detection via socket events + pre-broadcast pruning
+ * - Ping/pong keepalive (reduced interval safety net)
+ * - Connection health tracking and lifecycle metrics
+ */
+import { createHash } from "node:crypto";
+// ── Health tracker ─────────────────────────────────────────────────────────
+/** Maximum number of recent cleanup events to retain for rolling stats. */
+const MAX_CLEANUP_HISTORY = 500;
+/** Window (ms) for "recent cleanups" count. */
+const RECENT_WINDOW_MS = 60_000;
+/** Window (ms) for average connection duration calculation. */
+const DURATION_WINDOW_MS = 5 * 60_000;
+/**
+ * WebSocket connection health tracker — records connection lifecycle events,
+ * cleanup metrics, and resource usage for dashboard monitoring.
+ *
+ * Instruments the WebSocket manager to collect:
+ * - Active vs total (historical peak) connection counts
+ * - Cleanup events: successful removals, reasons, timing
+ * - Broadcast statistics: total broadcasts, failed writes
+ * - Connection duration tracking
+ *
+ * Designed as a singleton that accumulates metrics over the server lifetime.
+ * Provides a snapshot API consumed by the REST endpoint and WS broadcast.
+ */
+export class WsHealthTracker {
+    startedAt = Date.now();
+    // Connection tracking
+    activeConnectionCount = 0;
+    peakConnectionCount = 0;
+    totalAccepted = 0;
+    totalRemoved = 0;
+    // Per-connection timestamps for duration tracking
+    connectionStartTimes = new Map();
+    connectionIdCounter = 0;
+    // Cleanup history (ring buffer)
+    cleanupHistory = [];
+    cleanupsByReason = {
+        close: 0,
+        error: 0,
+        end: 0,
+        ping_timeout: 0,
+        prune: 0,
+        shutdown: 0,
+        write_fail: 0,
+    };
+    // Broadcast tracking
+    totalBroadcasts = 0;
+    totalWriteFailures = 0;
+    // Cleanup timing: track ms from connection start to cleanup
+    // for "cleanup latency" (how quickly we detect dead connections)
+    cleanupLatencySum = 0;
+    cleanupLatencyCount = 0;
+    /**
+     * Record a new connection being accepted.
+     * Returns a connection ID to pass to `recordDisconnect()`.
+     */
+    recordConnect() {
+        const id = String(++this.connectionIdCounter);
+        this.connectionStartTimes.set(id, Date.now());
+        this.activeConnectionCount++;
+        this.totalAccepted++;
+        if (this.activeConnectionCount > this.peakConnectionCount) {
+            this.peakConnectionCount = this.activeConnectionCount;
+        }
+        return id;
+    }
+    /**
+     * Record a connection being removed.
+     */
+    recordDisconnect(connectionId, reason) {
+        const startTime = this.connectionStartTimes.get(connectionId);
+        if (!startTime)
+            return; // Already recorded or unknown
+        this.connectionStartTimes.delete(connectionId);
+        const now = Date.now();
+        const durationMs = now - startTime;
+        this.activeConnectionCount = Math.max(0, this.activeConnectionCount - 1);
+        this.totalRemoved++;
+        this.cleanupsByReason[reason]++;
+        const event = {
+            reason,
+            timestamp: now,
+            connectionDurationMs: durationMs,
+        };
+        // Ring buffer for cleanup history
+        if (this.cleanupHistory.length >= MAX_CLEANUP_HISTORY) {
+            this.cleanupHistory.shift();
+        }
+        this.cleanupHistory.push(event);
+        // Accumulate cleanup latency for averaging
+        this.cleanupLatencySum += durationMs;
+        this.cleanupLatencyCount++;
+    }
+    /** Record a broadcast attempt. */
+    recordBroadcast() {
+        this.totalBroadcasts++;
+    }
+    /** Record a failed write during broadcast. */
+    recordBroadcastWriteFailure() {
+        this.totalWriteFailures++;
+    }
+    /**
+     * Sync the active connection count with the actual client set size.
+     * Called periodically to correct any drift from missed events.
+     */
+    syncActiveCount(actualCount) {
+        this.activeConnectionCount = actualCount;
+        if (actualCount > this.peakConnectionCount) {
+            this.peakConnectionCount = actualCount;
+        }
+    }
+    /** Get a snapshot of current health metrics. */
+    getSnapshot() {
+        const now = Date.now();
+        // Recent cleanups (last 60s)
+        const recentCutoff = now - RECENT_WINDOW_MS;
+        const recentCleanups = this.cleanupHistory.filter((e) => e.timestamp >= recentCutoff).length;
+        // Average connection duration for connections closed in last 5 min
+        const durationCutoff = now - DURATION_WINDOW_MS;
+        const recentDurations = this.cleanupHistory
+            .filter((e) => e.timestamp >= durationCutoff)
+            .map((e) => e.connectionDurationMs);
+        const avgConnectionDurationMs = recentDurations.length > 0
+            ? Math.round(recentDurations.reduce((a, b) => a + b, 0) / recentDurations.length)
+            : 0;
+        // Cleanup success rate: event-driven cleanups (close/error/end) vs
+        // safety-net cleanups (ping_timeout/prune/write_fail)
+        const totalCleanups = this.totalRemoved;
+        const eventDrivenCleanups = this.cleanupsByReason.close +
+            this.cleanupsByReason.error +
+            this.cleanupsByReason.end +
+            this.cleanupsByReason.shutdown;
+        const cleanupSuccessRate = totalCleanups > 0 ? eventDrivenCleanups / totalCleanups : 1;
+        // Average cleanup latency
+        const avgCleanupLatencyMs = this.cleanupLatencyCount > 0
+            ? Math.round(this.cleanupLatencySum / this.cleanupLatencyCount)
+            : 0;
+        // Health level
+        const health = this.computeHealth(cleanupSuccessRate, recentCleanups);
+        return {
+            activeConnections: this.activeConnectionCount,
+            peakConnections: this.peakConnectionCount,
+            totalConnectionsAccepted: this.totalAccepted,
+            totalConnectionsRemoved: this.totalRemoved,
+            cleanupsByReason: { ...this.cleanupsByReason },
+            recentCleanups,
+            avgConnectionDurationMs,
+            totalBroadcasts: this.totalBroadcasts,
+            totalBroadcastWriteFailures: this.totalWriteFailures,
+            cleanupSuccessRate: Math.round(cleanupSuccessRate * 1000) / 1000,
+            avgCleanupLatencyMs,
+            health,
+            uptimeMs: now - this.startedAt,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    /** Reset all counters (for testing). */
+    reset() {
+        this.activeConnectionCount = 0;
+        this.peakConnectionCount = 0;
+        this.totalAccepted = 0;
+        this.totalRemoved = 0;
+        this.connectionStartTimes.clear();
+        this.connectionIdCounter = 0;
+        this.cleanupHistory.length = 0;
+        this.cleanupsByReason.close = 0;
+        this.cleanupsByReason.error = 0;
+        this.cleanupsByReason.end = 0;
+        this.cleanupsByReason.ping_timeout = 0;
+        this.cleanupsByReason.prune = 0;
+        this.cleanupsByReason.shutdown = 0;
+        this.cleanupsByReason.write_fail = 0;
+        this.totalBroadcasts = 0;
+        this.totalWriteFailures = 0;
+        this.cleanupLatencySum = 0;
+        this.cleanupLatencyCount = 0;
+    }
+    computeHealth(cleanupSuccessRate, recentCleanups) {
+        // Unhealthy: high rate of safety-net cleanups (>30% are prune/timeout/write_fail)
+        // or very high cleanup churn (>50 cleanups per minute)
+        if (cleanupSuccessRate < 0.7 || recentCleanups > 50) {
+            return "unhealthy";
+        }
+        // Degraded: moderate safety-net usage or moderate churn
+        if (cleanupSuccessRate < 0.9 || recentCleanups > 20) {
+            return "degraded";
+        }
+        return "healthy";
+    }
+}
+/**
+ * Keepalive ping interval (ms). Reduced from 30 s for faster detection
+ * of silently dropped connections. Primary disconnect detection is
+ * event-driven (close/error/end handlers); pings are a safety net for
+ * connections that go silent without a TCP FIN/RST.
+ */
+export const PING_INTERVAL_MS = 5_000;
+const WS_MAGIC = "258EAFA5-E914-47DA-95CA-5AB9DC65B11D";
+/** Compute the Sec-WebSocket-Accept header value. */
+function computeAcceptKey(key) {
+    return createHash("sha1").update(key + WS_MAGIC).digest("base64");
+}
+/** Encode a text message as a WebSocket frame. */
+function encodeFrame(data) {
+    const payload = Buffer.from(data, "utf-8");
+    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 (BigInt not needed for reasonable payloads)
+        header.writeUInt32BE(0, 2);
+        header.writeUInt32BE(len, 6);
+    }
+    return Buffer.concat([header, payload]);
+}
+/** Encode a close frame. */
+function encodeCloseFrame(code = 1000) {
+    const buf = Buffer.alloc(4);
+    buf[0] = 0x88; // FIN + close opcode
+    buf[1] = 2; // payload length
+    buf.writeUInt16BE(code, 2);
+    return buf;
+}
+/** Encode a pong frame. */
+function encodePongFrame(payload) {
+    if (!payload || payload.length === 0) {
+        const buf = Buffer.alloc(2);
+        buf[0] = 0x8a; // FIN + pong opcode
+        buf[1] = 0;
+        return buf;
+    }
+    const buf = Buffer.alloc(2 + payload.length);
+    buf[0] = 0x8a;
+    buf[1] = payload.length;
+    payload.copy(buf, 2);
+    return buf;
+}
+/** Encode a ping frame. */
+function encodePingFrame() {
+    const buf = Buffer.alloc(2);
+    buf[0] = 0x89; // FIN + ping opcode
+    buf[1] = 0;
+    return buf;
+}
+/**
+ * Create a WebSocket manager that handles upgrades and broadcasting.
+ *
+ * Usage:
+ * ```ts
+ * const ws = createWebSocketManager();
+ * server.on("upgrade", ws.handleUpgrade);
+ * ws.broadcast({ type: "rex:item-updated", itemId: "..." });
+ * ```
+ */
+export function createWebSocketManager(opts) {
+    const clients = new Set();
+    let pingInterval = null;
+    const tracker = opts?.healthTracker;
+    /**
+     * Idempotent client removal — safe to call from multiple event handlers.
+     *
+     * Performs full cleanup in a single call:
+     *  1. Removes from the broadcast set (stops future broadcasts immediately)
+     *  2. Strips event listeners (breaks closure references for GC)
+     *  3. Destroys the underlying socket (releases OS resources)
+     *
+     * Because listeners are removed before the socket is destroyed, the
+     * destroy → close → removeClient chain cannot recurse.
+     */
+    function removeClient(client, reason) {
+        if (!clients.delete(client))
+            return; // already removed — nothing to do
+        // Record the disconnect in the health tracker.
+        if (tracker && client.trackingId) {
+            tracker.recordDisconnect(client.trackingId, reason ?? "close");
+        }
+        // Break closure references so the client + socket can be GC'd immediately.
+        client.socket.removeAllListeners();
+        // Release the OS socket if still open.
+        if (!client.socket.destroyed) {
+            client.socket.destroy();
+        }
+    }
+    /**
+     * Remove clients whose underlying socket is no longer writable.
+     * Called before each broadcast to catch connections that died between
+     * event-loop ticks without emitting a socket event.
+     *
+     * Uses removeClient() for full cleanup (listener removal + socket destroy).
+     */
+    function pruneDeadClients() {
+        for (const client of clients) {
+            if (client.socket.destroyed || !client.socket.writable) {
+                removeClient(client, "prune");
+            }
+        }
+    }
+    // Keepalive pings — safety net for connections that go silent without
+    // a TCP FIN/RST (e.g. network drops). Primary detection is event-driven.
+    function startPingInterval() {
+        if (pingInterval)
+            return;
+        pingInterval = setInterval(() => {
+            for (const client of clients) {
+                if (!client.alive) {
+                    // Missed last ping — full cleanup via removeClient
+                    removeClient(client, "ping_timeout");
+                    continue;
+                }
+                client.alive = false;
+                try {
+                    client.socket.write(encodePingFrame());
+                }
+                catch {
+                    removeClient(client, "write_fail");
+                }
+            }
+        }, PING_INTERVAL_MS);
+    }
+    function handleUpgrade(req, socket, head) {
+        const key = req.headers["sec-websocket-key"];
+        if (!key) {
+            socket.destroy();
+            return;
+        }
+        // Enable TCP-level keepalive for OS-level dead-peer detection.
+        // The socket is typed as Duplex but is a net.Socket at runtime;
+        // guard with runtime checks so non-TCP transports still work.
+        const sock = socket;
+        if (typeof sock.setKeepAlive === "function") {
+            sock.setKeepAlive(true, 1000);
+        }
+        if (typeof sock.setNoDelay === "function") {
+            sock.setNoDelay(true);
+        }
+        const acceptKey = computeAcceptKey(key);
+        // Send the handshake response
+        const response = [
+            "HTTP/1.1 101 Switching Protocols",
+            "Upgrade: websocket",
+            "Connection: Upgrade",
+            `Sec-WebSocket-Accept: ${acceptKey}`,
+            "",
+            "",
+        ].join("\r\n");
+        socket.write(response);
+        const trackingId = tracker?.recordConnect();
+        const client = { socket, alive: true, trackingId };
+        clients.add(client);
+        startPingInterval();
+        // Process any data that was already buffered
+        if (head.length > 0) {
+            processData(client, head);
+        }
+        socket.on("data", (data) => {
+            processData(client, data);
+        });
+        // Immediate disconnect detection — every socket lifecycle event that
+        // signals the connection is gone triggers client removal. Set.delete
+        // is idempotent so overlapping events are harmless.
+        socket.on("close", () => removeClient(client, "close"));
+        socket.on("error", () => removeClient(client, "error"));
+        socket.on("end", () => removeClient(client, "end"));
+        // Send a welcome message
+        try {
+            const welcomeMsg = JSON.stringify({
+                type: "connected",
+                timestamp: new Date().toISOString(),
+            });
+            socket.write(encodeFrame(welcomeMsg));
+        }
+        catch {
+            // ignore
+        }
+    }
+    /** Parse incoming WebSocket frames (simplified — handles text, close, ping, pong). */
+    function processData(client, data) {
+        if (data.length < 2)
+            return;
+        const opcode = data[0] & 0x0f;
+        const masked = (data[1] & 0x80) !== 0;
+        let payloadLen = data[1] & 0x7f;
+        let offset = 2;
+        if (payloadLen === 126) {
+            if (data.length < 4)
+                return;
+            payloadLen = data.readUInt16BE(2);
+            offset = 4;
+        }
+        else if (payloadLen === 127) {
+            if (data.length < 10)
+                return;
+            payloadLen = data.readUInt32BE(6); // Ignore high 4 bytes
+            offset = 10;
+        }
+        let maskKey = null;
+        if (masked) {
+            if (data.length < offset + 4)
+                return;
+            maskKey = data.subarray(offset, offset + 4);
+            offset += 4;
+        }
+        if (data.length < offset + payloadLen)
+            return;
+        const payload = data.subarray(offset, offset + payloadLen);
+        if (maskKey) {
+            for (let i = 0; i < payload.length; i++) {
+                payload[i] ^= maskKey[i % 4];
+            }
+        }
+        switch (opcode) {
+            case 0x01: // Text frame
+                // Client messages are acknowledged but not processed further
+                client.alive = true;
+                break;
+            case 0x08: // Close
+                try {
+                    client.socket.write(encodeCloseFrame());
+                }
+                catch { /* ignore */ }
+                removeClient(client, "close");
+                break;
+            case 0x09: // Ping
+                client.alive = true;
+                try {
+                    client.socket.write(encodePongFrame(payload));
+                }
+                catch { /* ignore */ }
+                break;
+            case 0x0a: // Pong
+                client.alive = true;
+                break;
+        }
+    }
+    function broadcast(data) {
+        if (clients.size === 0)
+            return;
+        tracker?.recordBroadcast();
+        // Single-pass broadcast: inline health checks replace the separate
+        // pruneDeadClients() call, and JSON serialization is deferred until
+        // the first confirmed-active connection is found. This means:
+        //   1. JSON.stringify is never called unless an active client exists
+        //   2. Dead connections are skipped without attempting socket writes
+        //   3. Performance scales with active connection count, not set size
+        let msg = null;
+        for (const client of clients) {
+            if (client.socket.destroyed || !client.socket.writable) {
+                removeClient(client, "prune");
+                continue;
+            }
+            // Lazy serialization: only pay the JSON.stringify + frame encoding
+            // cost once we have a confirmed-active client to write to.
+            if (msg === null) {
+                msg = encodeFrame(JSON.stringify(data));
+            }
+            try {
+                client.socket.write(msg);
+            }
+            catch {
+                tracker?.recordBroadcastWriteFailure();
+                removeClient(client, "write_fail");
+            }
+        }
+    }
+    function clientCount() {
+        return clients.size;
+    }
+    function shutdown() {
+        if (pingInterval) {
+            clearInterval(pingInterval);
+            pingInterval = null;
+        }
+        for (const client of clients) {
+            if (tracker && client.trackingId) {
+                tracker.recordDisconnect(client.trackingId, "shutdown");
+            }
+            try {
+                client.socket.write(encodeCloseFrame());
+                client.socket.destroy();
+            }
+            catch {
+                // ignore
+            }
+        }
+        clients.clear();
+    }
+    return { handleUpgrade, broadcast, clientCount, shutdown };
+}
+//# sourceMappingURL=websocket.js.map

package/packages/web/dist/server/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../src/server/websocket.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0DzC,8EAA8E;AAE9E,2EAA2E;AAC3E,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC,+CAA+C;AAC/C,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,+DAA+D;AAC/D,MAAM,kBAAkB,GAAG,CAAC,GAAG,MAAM,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,eAAe;IACT,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAExC,sBAAsB;IACd,qBAAqB,GAAG,CAAC,CAAC;IAC1B,mBAAmB,GAAG,CAAC,CAAC;IACxB,aAAa,GAAG,CAAC,CAAC;IAClB,YAAY,GAAG,CAAC,CAAC;IAEzB,kDAAkD;IACjC,oBAAoB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC1D,mBAAmB,GAAG,CAAC,CAAC;IAEhC,gCAAgC;IACf,cAAc,GAAmB,EAAE,CAAC;IACpC,gBAAgB,GAAkC;QACjE,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,GAAG,EAAE,CAAC;QACN,YAAY,EAAE,CAAC;QACf,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;QACX,UAAU,EAAE,CAAC;KACd,CAAC;IAEF,qBAAqB;IACb,eAAe,GAAG,CAAC,CAAC;IACpB,kBAAkB,GAAG,CAAC,CAAC;IAE/B,4DAA4D;IAC5D,iEAAiE;IACzD,iBAAiB,GAAG,CAAC,CAAC;IACtB,mBAAmB,GAAG,CAAC,CAAC;IAEhC;;;OAGG;IACH,aAAa;QACX,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;QAC9C,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC1D,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,qBAAqB,CAAC;QACxD,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,YAAoB,EAAE,MAAqB;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS;YAAE,OAAO,CAAC,8BAA8B;QAEtD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,UAAU,GAAG,GAAG,GAAG,SAAS,CAAC;QAEnC,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,qBAAqB,GAAG,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAEhC,MAAM,KAAK,GAAiB;YAC1B,MAAM;YACN,SAAS,EAAE,GAAG;YACd,oBAAoB,EAAE,UAAU;SACjC,CAAC;QAEF,kCAAkC;QAClC,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,IAAI,mBAAmB,EAAE,CAAC;YACtD,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC9B,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhC,2CAA2C;QAC3C,IAAI,CAAC,iBAAiB,IAAI,UAAU,CAAC;QACrC,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAED,kCAAkC;IAClC,eAAe;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,8CAA8C;IAC9C,2BAA2B;QACzB,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,WAAmB;QACjC,IAAI,CAAC,qBAAqB,GAAG,WAAW,CAAC;QACzC,IAAI,WAAW,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3C,IAAI,CAAC,mBAAmB,GAAG,WAAW,CAAC;QACzC,CAAC;IACH,CAAC;IAED,gDAAgD;IAChD,WAAW;QACT,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAEvB,6BAA6B;QAC7B,MAAM,YAAY,GAAG,GAAG,GAAG,gBAAgB,CAAC;QAC5C,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC,MAAM,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,YAAY,CACnC,CAAC,MAAM,CAAC;QAET,mEAAmE;QACnE,MAAM,cAAc,GAAG,GAAG,GAAG,kBAAkB,CAAC;QAChD,MAAM,eAAe,GAAG,IAAI,CAAC,cAAc;aACxC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,cAAc,CAAC;aAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC;QACtC,MAAM,uBAAuB,GAC3B,eAAe,CAAC,MAAM,GAAG,CAAC;YACxB,CAAC,CAAC,IAAI,CAAC,KAAK,CACR,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,eAAe,CAAC,MAAM,CACpE;YACH,CAAC,CAAC,CAAC,CAAC;QAER,mEAAmE;QACnE,sDAAsD;QACtD,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC;QACxC,MAAM,mBAAmB,GACvB,IAAI,CAAC,gBAAgB,CAAC,KAAK;YAC3B,IAAI,CAAC,gBAAgB,CAAC,KAAK;YAC3B,IAAI,CAAC,gBAAgB,CAAC,GAAG;YACzB,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QACjC,MAAM,kBAAkB,GACtB,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,mBAAmB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9D,0BAA0B;QAC1B,MAAM,mBAAmB,GACvB,IAAI,CAAC,mBAAmB,GAAG,CAAC;YAC1B,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,mBAAmB,CAAC;YAC/D,CAAC,CAAC,CAAC,CAAC;QAER,eAAe;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAC;QAEtE,OAAO;YACL,iBAAiB,EAAE,IAAI,CAAC,qBAAqB;YAC7C,eAAe,EAAE,IAAI,CAAC,mBAAmB;YACzC,wBAAwB,EAAE,IAAI,CAAC,aAAa;YAC5C,uBAAuB,EAAE,IAAI,CAAC,YAAY;YAC1C,gBAAgB,EAAE,EAAE,GAAG,IAAI,CAAC,gBAAgB,EAAE;YAC9C,cAAc;YACd,uBAAuB;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,2BAA2B,EAAE,IAAI,CAAC,kBAAkB;YACpD,kBAAkB,EAAE,IAAI,CAAC,KAAK,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,IAAI;YAChE,mBAAmB;YACnB,MAAM;YACN,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC,SAAS;YAC9B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,KAAK;QACH,IAAI,CAAC,qBAAqB,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,oBAAoB,CAAC,KAAK,EAAE,CAAC;QAClC,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,gBAAgB,CAAC,GAAG,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,gBAAgB,CAAC,YAAY,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,KAAK,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,gBAAgB,CAAC,UAAU,GAAG,CAAC,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,kBAAkB,GAAG,CAAC,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;QAC3B,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;IAC/B,CAAC;IAEO,aAAa,CACnB,kBAA0B,EAC1B,cAAsB;QAEtB,kFAAkF;QAClF,uDAAuD;QACvD,IAAI,kBAAkB,GAAG,GAAG,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;YACpD,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,wDAAwD;QACxD,IAAI,kBAAkB,GAAG,GAAG,IAAI,cAAc,GAAG,EAAE,EAAE,CAAC;YACpD,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AAqBD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC;AAEtC,MAAM,QAAQ,GAAG,sCAAsC,CAAC;AAExD,qDAAqD;AACrD,SAAS,gBAAgB,CAAC,GAAW;IACnC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,GAAG,GAAG,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACpE,CAAC;AAED,kDAAkD;AAClD,SAAS,WAAW,CAAC,IAAY;IAC/B,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAE3B,IAAI,MAAc,CAAC;IACnB,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,oBAAoB;QACtC,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAClB,CAAC;SAAM,IAAI,GAAG,GAAG,KAAK,EAAE,CAAC;QACvB,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAChB,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;QAChB,yEAAyE;QACzE,MAAM,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC3B,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED,4BAA4B;AAC5B,SAAS,gBAAgB,CAAC,OAAe,IAAI;IAC3C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,qBAAqB;IACpC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAI,iBAAiB;IAChC,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2BAA2B;AAC3B,SAAS,eAAe,CAAC,OAAgB;IACvC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,oBAAoB;QACnC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IACd,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,2BAA2B;AAC3B,SAAS,eAAe;IACtB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5B,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,oBAAoB;IACnC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAA8B;IAMnE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAY,CAAC;IACpC,IAAI,YAAY,GAA0C,IAAI,CAAC;IAC/D,MAAM,OAAO,GAAG,IAAI,EAAE,aAAa,CAAC;IAEpC;;;;;;;;;;OAUG;IACH,SAAS,YAAY,CAAC,MAAgB,EAAE,MAAsB;QAC5D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YAAE,OAAO,CAAC,kCAAkC;QAEvE,+CAA+C;QAC/C,IAAI,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACjC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC;QACjE,CAAC;QAED,2EAA2E;QAC3E,MAAM,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;QAEnC,uCAAuC;QACvC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC7B,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,SAAS,gBAAgB;QACvB,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACvD,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;IACH,CAAC;IAED,sEAAsE;IACtE,yEAAyE;IACzE,SAAS,iBAAiB;QACxB,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;YAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBAClB,mDAAmD;oBACnD,YAAY,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;oBACrC,SAAS;gBACX,CAAC;gBACD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC;gBACzC,CAAC;gBAAC,MAAM,CAAC;oBACP,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;gBACrC,CAAC;YACH,CAAC;QACH,CAAC,EAAE,gBAAgB,CAAC,CAAC;IACvB,CAAC;IAED,SAAS,aAAa,CAAC,GAAoB,EAAE,MAAc,EAAE,IAAY;QACvE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QAED,+DAA+D;QAC/D,gEAAgE;QAChE,8DAA8D;QAC9D,MAAM,IAAI,GAAG,MAA4C,CAAC;QAC1D,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;YAC3C,IAAI,CAAC,YAAgE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YACzC,IAAI,CAAC,UAAyC,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC;QAED,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAExC,8BAA8B;QAC9B,MAAM,QAAQ,GAAG;YACf,kCAAkC;YAClC,oBAAoB;YACpB,qBAAqB;YACrB,yBAAyB,SAAS,EAAE;YACpC,EAAE;YACF,EAAE;SACH,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEf,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAEvB,MAAM,UAAU,GAAG,OAAO,EAAE,aAAa,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAa,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpB,iBAAiB,EAAE,CAAC;QAEpB,6CAA6C;QAC7C,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAY,EAAE,EAAE;YACjC,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;QAEH,qEAAqE;QACrE,qEAAqE;QACrE,oDAAoD;QACpD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;QAEpD,yBAAyB;QACzB,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC;gBAChC,IAAI,EAAE,WAAW;gBACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;aACpC,CAAC,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,SAAS,WAAW,CAAC,MAAgB,EAAE,IAAY;QACjD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO;QAE5B,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,UAAU,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;QAChC,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO;YAC5B,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,GAAG,CAAC,CAAC;QACb,CAAC;aAAM,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,MAAM,GAAG,EAAE;gBAAE,OAAO;YAC7B,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,sBAAsB;YACzD,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;QAED,IAAI,OAAO,GAAkB,IAAI,CAAC;QAClC,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC;gBAAE,OAAO;YACrC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC;YAC5C,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU;YAAE,OAAO;QAE9C,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC;QAC3D,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QAED,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,IAAI,EAAE,aAAa;gBACtB,6DAA6D;gBAC7D,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,MAAM;YACR,KAAK,IAAI,EAAE,QAAQ;gBACjB,IAAI,CAAC;oBAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBACvE,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,IAAI,EAAE,OAAO;gBAChB,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,IAAI,CAAC;oBAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBAC7E,MAAM;YACR,KAAK,IAAI,EAAE,OAAO;gBAChB,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,MAAM;QACV,CAAC;IACH,CAAC;IAED,SAAS,SAAS,CAAC,IAAa;QAC9B,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAE/B,OAAO,EAAE,eAAe,EAAE,CAAC;QAE3B,mEAAmE;QACnE,oEAAoE;QACpE,8DAA8D;QAC9D,qEAAqE;QACrE,qEAAqE;QACrE,qEAAqE;QACrE,IAAI,GAAG,GAAkB,IAAI,CAAC;QAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACvD,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAC9B,SAAS;YACX,CAAC;YAED,mEAAmE;YACnE,2DAA2D;YAC3D,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;gBACjB,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1C,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,EAAE,2BAA2B,EAAE,CAAC;gBACvC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,SAAS,WAAW;QAClB,OAAO,OAAO,CAAC,IAAI,CAAC;IACtB,CAAC;IAED,SAAS,QAAQ;QACf,IAAI,YAAY,EAAE,CAAC;YACjB,aAAa,CAAC,YAAY,CAAC,CAAC;YAC5B,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,OAAO,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACjC,OAAO,CAAC,gBAAgB,CAAC,MAAM,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;YAC1D,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC;gBACxC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;QACD,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AAC7D,CAAC"}

package/packages/web/dist/server/ws-health-tracker.d.ts

@@ -0,0 +1,86 @@
+/**
+ * WebSocket connection health tracker — records connection lifecycle events,
+ * cleanup metrics, and resource usage for dashboard monitoring.
+ *
+ * Instruments the WebSocket manager to collect:
+ * - Active vs total (historical peak) connection counts
+ * - Cleanup events: successful removals, reasons, timing
+ * - Broadcast statistics: total broadcasts, failed writes
+ * - Connection duration tracking
+ *
+ * Designed as a singleton that accumulates metrics over the server lifetime.
+ * Provides a snapshot API consumed by the REST endpoint and WS broadcast.
+ */
+/** Reason a client was removed from the connection set. */
+export type CleanupReason = "close" | "error" | "end" | "ping_timeout" | "prune" | "shutdown" | "write_fail";
+/** Health level derived from cleanup failure rate and connection trends. */
+export type WsHealthLevel = "healthy" | "degraded" | "unhealthy";
+/** Snapshot of WebSocket health metrics for API/broadcast consumption. */
+export interface WsHealthSnapshot {
+    /** Current number of active connections. */
+    activeConnections: number;
+    /** Peak concurrent connections seen since server start. */
+    peakConnections: number;
+    /** Total connections accepted since server start. */
+    totalConnectionsAccepted: number;
+    /** Total connections removed (for any reason) since server start. */
+    totalConnectionsRemoved: number;
+    /** Cleanup metrics broken down by reason. */
+    cleanupsByReason: Record<CleanupReason, number>;
+    /** Number of cleanups in the last 60 seconds. */
+    recentCleanups: number;
+    /** Average connection duration (ms) for connections closed in the last 5 minutes. */
+    avgConnectionDurationMs: number;
+    /** Total broadcasts sent since server start. */
+    totalBroadcasts: number;
+    /** Total failed writes during broadcasts. */
+    totalBroadcastWriteFailures: number;
+    /** Cleanup success rate (0–1): successful cleanups / total cleanups. */
+    cleanupSuccessRate: number;
+    /** Average cleanup timing (ms): how quickly dead connections are detected. */
+    avgCleanupLatencyMs: number;
+    /** Overall health level. */
+    health: WsHealthLevel;
+    /** Server uptime in milliseconds. */
+    uptimeMs: number;
+    /** ISO timestamp of this snapshot. */
+    timestamp: string;
+}
+export declare class WsHealthTracker {
+    private readonly startedAt;
+    private activeConnectionCount;
+    private peakConnectionCount;
+    private totalAccepted;
+    private totalRemoved;
+    private readonly connectionStartTimes;
+    private connectionIdCounter;
+    private readonly cleanupHistory;
+    private readonly cleanupsByReason;
+    private totalBroadcasts;
+    private totalWriteFailures;
+    private cleanupLatencySum;
+    private cleanupLatencyCount;
+    /**
+     * Record a new connection being accepted.
+     * Returns a connection ID to pass to `recordDisconnect()`.
+     */
+    recordConnect(): string;
+    /**
+     * Record a connection being removed.
+     */
+    recordDisconnect(connectionId: string, reason: CleanupReason): void;
+    /** Record a broadcast attempt. */
+    recordBroadcast(): void;
+    /** Record a failed write during broadcast. */
+    recordBroadcastWriteFailure(): void;
+    /**
+     * Sync the active connection count with the actual client set size.
+     * Called periodically to correct any drift from missed events.
+     */
+    syncActiveCount(actualCount: number): void;
+    /** Get a snapshot of current health metrics. */
+    getSnapshot(): WsHealthSnapshot;
+    /** Reset all counters (for testing). */
+    reset(): void;
+    private computeHealth;
+}