syncpoint-ai 0.1.0

package/dist/server/transport/sse-manager.js

@@ -0,0 +1,183 @@
+/**
+ * SSE (Server-Sent Events) connection management.
+ * Extracted from main.ts — handles connection lifecycle, heartbeat, replay, and broadcast.
+ */
+import { _getBus } from "../repositories/_shared.js";
+import { logger } from "../logger.js";
+// ── Constants ─────────────────────────────────────────
+export const SSE_HEARTBEAT_MS = 30_000;
+/** Number of consecutive heartbeat failures before connection is evicted. */
+const SSE_MAX_MISSED_BEATS = 2;
+const MAX_SSE_CONNECTIONS = 200;
+/** Maximum time (ms) without a successful write before eviction. */
+export const SSE_EVICTION_TTL_MS = SSE_MAX_MISSED_BEATS * SSE_HEARTBEAT_MS;
+const activeSseConnections = new Map();
+const bus = _getBus();
+// ── Write / Evict ─────────────────────────────────────
+/**
+ * Attempt a write to an SSE connection. Returns true if successful.
+ * Updates the connection's failure counter on error.
+ */
+export function sseWrite(state, data) {
+    try {
+        const ok = state.res.write(data);
+        if (ok) {
+            state.lastSuccessfulWrite = Date.now();
+            state.consecutiveFailures = 0;
+            state.awaitingDrain = false;
+        }
+        else {
+            state.awaitingDrain = true;
+        }
+        return true;
+    }
+    catch {
+        state.consecutiveFailures++;
+        return false;
+    }
+}
+/**
+ * Evict a dead SSE connection: clear heartbeat, remove from tracking,
+ * update metrics, and end the response.
+ */
+export function evictSseConnection(state, reason) {
+    clearInterval(state.heartbeat);
+    activeSseConnections.delete(state.res);
+    bus.connectionClosed();
+    logger.info("SSE connection evicted", {
+        reason,
+        activeConnections: activeSseConnections.size,
+        connectionAgeMs: Date.now() - state.createdAt,
+        consecutiveFailures: state.consecutiveFailures,
+    });
+    try {
+        state.res.end();
+    }
+    catch { /* ignore */ }
+}
+// ── Broadcast ─────────────────────────────────────────
+export function broadcastSse(data) {
+    const payload = `id: ${data.seq}\ndata: ${JSON.stringify(data)}\n\n`;
+    for (const state of activeSseConnections.values()) {
+        if (!sseWrite(state, payload)) {
+            evictSseConnection(state, "broadcast_write_error");
+        }
+    }
+}
+// ── Connection management ─────────────────────────────
+export function getActiveSseCount() {
+    return activeSseConnections.size;
+}
+export function getActiveSseConnections() {
+    return activeSseConnections;
+}
+export function getMaxSseConnections() {
+    return MAX_SSE_CONNECTIONS;
+}
+/**
+ * Set up an SSE connection — headers, heartbeat, replay, drain, cleanup.
+ * Call this from the request handler for GET /events.
+ */
+export function setupSseConnection(req, res) {
+    // Connection limit
+    if (activeSseConnections.size >= MAX_SSE_CONNECTIONS) {
+        res.writeHead(503, { "Content-Type": "application/json" });
+        res.end(JSON.stringify({ error: "Too many SSE connections", max: MAX_SSE_CONNECTIONS }));
+        return;
+    }
+    res.writeHead(200, {
+        "Content-Type": "text/event-stream",
+        "Cache-Control": "no-cache",
+        "Connection": "keep-alive",
+        "X-Accel-Buffering": "no",
+    });
+    const lastEventSeq = parseInt(req.headers["last-event-seq"] ?? "", 10);
+    const isReconnect = !isNaN(lastEventSeq) && lastEventSeq > 0;
+    const currentSeq = bus.currentSeq;
+    const now = Date.now();
+    const connState = {
+        res,
+        heartbeat: null,
+        consecutiveFailures: 0,
+        lastSuccessfulWrite: now,
+        awaitingDrain: false,
+        createdAt: now,
+    };
+    sseWrite(connState, `id: ${currentSeq}\ndata: {"type":"connected","seq":${currentSeq}}\n\n`);
+    activeSseConnections.set(res, connState);
+    bus.connectionOpened();
+    if (isReconnect)
+        bus.reconnectDetected();
+    logger.info("SSE client connected", {
+        activeConnections: activeSseConnections.size,
+        currentSeq,
+        isReconnect,
+        lastEventSeq,
+    });
+    // Replay missed events on reconnect
+    if (isReconnect) {
+        const missed = bus.replayAfter(lastEventSeq);
+        for (const event of missed) {
+            if (!sseWrite(connState, `id: ${event.seq}\ndata: ${JSON.stringify(event)}\n\n`)) {
+                evictSseConnection(connState, "replay_write_error");
+                return;
+            }
+        }
+    }
+    // Heartbeat
+    const heartbeat = setInterval(() => {
+        const timeSinceLastWrite = Date.now() - connState.lastSuccessfulWrite;
+        if (timeSinceLastWrite > SSE_EVICTION_TTL_MS) {
+            evictSseConnection(connState, "heartbeat_ttl_expired");
+            return;
+        }
+        if (connState.awaitingDrain) {
+            connState.consecutiveFailures++;
+        }
+        if (!sseWrite(connState, ": heartbeat\n\n")) {
+            connState.consecutiveFailures++;
+        }
+        if (connState.consecutiveFailures >= SSE_MAX_MISSED_BEATS) {
+            evictSseConnection(connState, "heartbeat_missed");
+            return;
+        }
+        const sock = connState.res.socket;
+        if (sock && sock.destroyed) {
+            evictSseConnection(connState, "socket_destroyed");
+        }
+    }, SSE_HEARTBEAT_MS);
+    connState.heartbeat = heartbeat;
+    // Drain event
+    res.on("drain", () => {
+        connState.awaitingDrain = false;
+        connState.lastSuccessfulWrite = Date.now();
+        connState.consecutiveFailures = 0;
+    });
+    // Cleanup on disconnect
+    const cleanup = () => {
+        const state = activeSseConnections.get(res);
+        if (state) {
+            clearInterval(state.heartbeat);
+            activeSseConnections.delete(res);
+            bus.connectionClosed();
+            logger.info("SSE client disconnected", { activeConnections: activeSseConnections.size });
+        }
+    };
+    req.on("close", cleanup);
+    res.on("close", cleanup);
+    res.on("finish", cleanup);
+}
+/**
+ * Close all active SSE connections. Called during graceful shutdown.
+ */
+export function closeAllSseConnections() {
+    for (const state of activeSseConnections.values()) {
+        clearInterval(state.heartbeat);
+        try {
+            state.res.end();
+        }
+        catch { /* ignore */ }
+    }
+    activeSseConnections.clear();
+}
+//# sourceMappingURL=sse-manager.js.map

package/dist/server/transport/sse-manager.js.map

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