@essentialai/cogent-server 2.0.0

package/dist/services/auth-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-service.js","sourceRoot":"","sources":["../../src/services/auth-service.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,WAAW;IACL,YAAY,CAAS;IAEtC,YAAY,YAAoB;QAC9B,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,WAAmB;QAClC,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,WAAmB,EAAE,IAAY;QAClD,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,aAAa;QACX,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC9B,CAAC;IAED;;;OAGG;IACH,SAAS,CAAC,KAAa;QACrB,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,CAAS,EAAE,CAAS;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;CACF"}

package/dist/services/connection-manager.d.ts

@@ -0,0 +1,108 @@
+import type { WSContext } from "hono/ws";
+import type WebSocket from "ws";
+/**
+ * Represents a single WebSocket connection from a peer.
+ * A peer may have multiple simultaneous connections (all receive messages).
+ */
+export interface PeerConnection {
+    /** Hono WSContext wrapper for sending application-level messages. */
+    ws: WSContext;
+    /** Underlying ws.WebSocket object for native ping/pong heartbeat. */
+    rawWs: WebSocket;
+    /** The peer this connection belongs to. */
+    peerId: string;
+    /** The session this connection belongs to. */
+    sessionId: string;
+    /** Timestamp (Date.now()) when this connection was established. */
+    connectedAt: number;
+    /** Heartbeat interval handle -- must be cleared on disconnect. */
+    heartbeatInterval: ReturnType<typeof setInterval>;
+}
+/**
+ * In-memory WebSocket connection tracker.
+ *
+ * Manages active connections per session and peer, supports multiple
+ * connections per peer, implements grace period timers for offline
+ * detection, and checks readyState before sending to avoid errors
+ * on closed sockets.
+ */
+export declare class ConnectionManager {
+    /**
+     * Nested map: sessionId -> peerId -> PeerConnection[]
+     * Supports O(1) lookup for a specific peer's connections.
+     */
+    private readonly connections;
+    /**
+     * Grace period timers: `${sessionId}:${peerId}` -> timeout handle.
+     * Started when last connection for a peer closes; cancelled if peer
+     * reconnects before expiry.
+     */
+    private readonly graceTimers;
+    /** How long to wait after last connection closes before marking peer offline. */
+    private readonly graceTimeoutMs;
+    /** Callback invoked when grace period expires without reconnection. */
+    private onPeerOffline?;
+    constructor(graceTimeoutMs?: number);
+    /**
+     * Register a callback for when a peer's grace period expires
+     * (all connections closed and no reconnection within the timeout).
+     */
+    setOnPeerOffline(callback: (sessionId: string, peerId: string) => void): void;
+    /**
+     * Add a new WebSocket connection for a peer.
+     * Cancels any active grace timer for this peer (Pitfall 4 prevention).
+     */
+    addConnection(conn: PeerConnection): void;
+    /**
+     * Remove a specific WebSocket connection for a peer.
+     * Clears the connection's heartbeat interval. If the peer has no
+     * remaining connections, starts a grace period timer.
+     */
+    removeConnection(sessionId: string, peerId: string, ws: WSContext): void;
+    /**
+     * Get all connections for a specific peer in a session.
+     * Returns an empty array if the peer has no connections.
+     */
+    getConnections(sessionId: string, peerId: string): PeerConnection[];
+    /**
+     * Get all connections in a session (flat array across all peers).
+     */
+    getAllSessionConnections(sessionId: string): PeerConnection[];
+    /**
+     * Get the list of peer IDs with active connections in a session.
+     */
+    getConnectedPeerIds(sessionId: string): string[];
+    /**
+     * Send data to all connections for a specific peer.
+     * Checks readyState === 1 (OPEN) before each send to avoid
+     * errors on closing/closed sockets (Pitfall 5 prevention).
+     */
+    sendToPeer(sessionId: string, peerId: string, data: string): void;
+    /**
+     * Broadcast data to all connections in a session.
+     * Optionally excludes a specific peer (e.g., the message sender).
+     */
+    broadcastToSession(sessionId: string, data: string, excludePeerId?: string): void;
+    /**
+     * Check whether a peer has at least one active connection.
+     */
+    isConnected(sessionId: string, peerId: string): boolean;
+    /**
+     * Get the total number of connected peers across all sessions.
+     * O(sessions) in-memory traversal, no disk I/O.
+     */
+    getTotalConnectedPeers(): number;
+    /**
+     * Close all WebSocket connections across all sessions.
+     * Clears all heartbeat intervals and grace timers.
+     * Used during SIGTERM graceful shutdown.
+     */
+    closeAll(code: number, reason: string): void;
+    /**
+     * Start a grace period timer for a peer that has lost all connections.
+     * If the timer fires without cancellation (from addConnection),
+     * the onPeerOffline callback is invoked.
+     */
+    private _startGraceTimer;
+}
+//# sourceMappingURL=connection-manager.d.ts.map

package/dist/services/connection-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../src/services/connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAEhC;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,qEAAqE;IACrE,EAAE,EAAE,SAAS,CAAC;IACd,qEAAqE;IACrE,KAAK,EAAE,SAAS,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;IACpB,kEAAkE;IAClE,iBAAiB,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;CACnD;AAED;;;;;;;GAOG;AACH,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IAEJ;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IAEJ,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,uEAAuE;IACvE,OAAO,CAAC,aAAa,CAAC,CAA8C;gBAExD,cAAc,GAAE,MAAe;IAI3C;;;OAGG;IACH,gBAAgB,CACd,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GACpD,IAAI;IAIP;;;OAGG;IACH,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IA4BzC;;;;OAIG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,EAAE,EAAE,SAAS,GACZ,IAAI;IA4BP;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,EAAE;IAMnE;;OAEG;IACH,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,EAAE;IAW7D;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE;IAMhD;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IASjE;;;OAGG;IACH,kBAAkB,CAChB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI;IAcP;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAOvD;;;OAGG;IACH,sBAAsB,IAAI,MAAM;IAQhC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAwB5C;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CAUzB"}

package/dist/services/connection-manager.js

@@ -0,0 +1,216 @@
+/**
+ * In-memory WebSocket connection tracker.
+ *
+ * Manages active connections per session and peer, supports multiple
+ * connections per peer, implements grace period timers for offline
+ * detection, and checks readyState before sending to avoid errors
+ * on closed sockets.
+ */
+export class ConnectionManager {
+    /**
+     * Nested map: sessionId -> peerId -> PeerConnection[]
+     * Supports O(1) lookup for a specific peer's connections.
+     */
+    connections = new Map();
+    /**
+     * Grace period timers: `${sessionId}:${peerId}` -> timeout handle.
+     * Started when last connection for a peer closes; cancelled if peer
+     * reconnects before expiry.
+     */
+    graceTimers = new Map();
+    /** How long to wait after last connection closes before marking peer offline. */
+    graceTimeoutMs;
+    /** Callback invoked when grace period expires without reconnection. */
+    onPeerOffline;
+    constructor(graceTimeoutMs = 30_000) {
+        this.graceTimeoutMs = graceTimeoutMs;
+    }
+    /**
+     * Register a callback for when a peer's grace period expires
+     * (all connections closed and no reconnection within the timeout).
+     */
+    setOnPeerOffline(callback) {
+        this.onPeerOffline = callback;
+    }
+    /**
+     * Add a new WebSocket connection for a peer.
+     * Cancels any active grace timer for this peer (Pitfall 4 prevention).
+     */
+    addConnection(conn) {
+        const { sessionId, peerId } = conn;
+        // Cancel grace timer if reconnecting within grace period
+        const timerKey = `${sessionId}:${peerId}`;
+        const existingTimer = this.graceTimers.get(timerKey);
+        if (existingTimer !== undefined) {
+            clearTimeout(existingTimer);
+            this.graceTimers.delete(timerKey);
+        }
+        // Get or create the session map
+        let sessionMap = this.connections.get(sessionId);
+        if (!sessionMap) {
+            sessionMap = new Map();
+            this.connections.set(sessionId, sessionMap);
+        }
+        // Get or create the connections array for this peer
+        let peerConns = sessionMap.get(peerId);
+        if (!peerConns) {
+            peerConns = [];
+            sessionMap.set(peerId, peerConns);
+        }
+        peerConns.push(conn);
+    }
+    /**
+     * Remove a specific WebSocket connection for a peer.
+     * Clears the connection's heartbeat interval. If the peer has no
+     * remaining connections, starts a grace period timer.
+     */
+    removeConnection(sessionId, peerId, ws) {
+        const sessionMap = this.connections.get(sessionId);
+        if (!sessionMap)
+            return;
+        const peerConns = sessionMap.get(peerId);
+        if (!peerConns)
+            return;
+        // Find and remove the specific connection by ws reference
+        const idx = peerConns.findIndex((c) => c.ws === ws);
+        if (idx === -1)
+            return;
+        // Clear the heartbeat interval for this connection
+        clearInterval(peerConns[idx].heartbeatInterval);
+        peerConns.splice(idx, 1);
+        // If no connections remain, start grace period
+        if (peerConns.length === 0) {
+            sessionMap.delete(peerId);
+            // Clean up empty session map
+            if (sessionMap.size === 0) {
+                this.connections.delete(sessionId);
+            }
+            this._startGraceTimer(sessionId, peerId);
+        }
+    }
+    /**
+     * Get all connections for a specific peer in a session.
+     * Returns an empty array if the peer has no connections.
+     */
+    getConnections(sessionId, peerId) {
+        const sessionMap = this.connections.get(sessionId);
+        if (!sessionMap)
+            return [];
+        return sessionMap.get(peerId) ?? [];
+    }
+    /**
+     * Get all connections in a session (flat array across all peers).
+     */
+    getAllSessionConnections(sessionId) {
+        const sessionMap = this.connections.get(sessionId);
+        if (!sessionMap)
+            return [];
+        const result = [];
+        for (const conns of sessionMap.values()) {
+            result.push(...conns);
+        }
+        return result;
+    }
+    /**
+     * Get the list of peer IDs with active connections in a session.
+     */
+    getConnectedPeerIds(sessionId) {
+        const sessionMap = this.connections.get(sessionId);
+        if (!sessionMap)
+            return [];
+        return Array.from(sessionMap.keys());
+    }
+    /**
+     * Send data to all connections for a specific peer.
+     * Checks readyState === 1 (OPEN) before each send to avoid
+     * errors on closing/closed sockets (Pitfall 5 prevention).
+     */
+    sendToPeer(sessionId, peerId, data) {
+        const conns = this.getConnections(sessionId, peerId);
+        for (const conn of conns) {
+            if (conn.ws.readyState === 1) {
+                conn.ws.send(data);
+            }
+        }
+    }
+    /**
+     * Broadcast data to all connections in a session.
+     * Optionally excludes a specific peer (e.g., the message sender).
+     */
+    broadcastToSession(sessionId, data, excludePeerId) {
+        const sessionMap = this.connections.get(sessionId);
+        if (!sessionMap)
+            return;
+        for (const [peerId, conns] of sessionMap) {
+            if (peerId === excludePeerId)
+                continue;
+            for (const conn of conns) {
+                if (conn.ws.readyState === 1) {
+                    conn.ws.send(data);
+                }
+            }
+        }
+    }
+    /**
+     * Check whether a peer has at least one active connection.
+     */
+    isConnected(sessionId, peerId) {
+        const sessionMap = this.connections.get(sessionId);
+        if (!sessionMap)
+            return false;
+        const conns = sessionMap.get(peerId);
+        return conns !== undefined && conns.length > 0;
+    }
+    /**
+     * Get the total number of connected peers across all sessions.
+     * O(sessions) in-memory traversal, no disk I/O.
+     */
+    getTotalConnectedPeers() {
+        let total = 0;
+        for (const sessionMap of this.connections.values()) {
+            total += sessionMap.size;
+        }
+        return total;
+    }
+    /**
+     * Close all WebSocket connections across all sessions.
+     * Clears all heartbeat intervals and grace timers.
+     * Used during SIGTERM graceful shutdown.
+     */
+    closeAll(code, reason) {
+        // Clear all grace timers first
+        for (const timer of this.graceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.graceTimers.clear();
+        // Close all connections
+        for (const sessionMap of this.connections.values()) {
+            for (const conns of sessionMap.values()) {
+                for (const conn of conns) {
+                    clearInterval(conn.heartbeatInterval);
+                    try {
+                        conn.ws.close(code, reason);
+                    }
+                    catch {
+                        // Ignore errors from already-closed sockets during shutdown
+                    }
+                }
+            }
+        }
+        this.connections.clear();
+    }
+    /**
+     * Start a grace period timer for a peer that has lost all connections.
+     * If the timer fires without cancellation (from addConnection),
+     * the onPeerOffline callback is invoked.
+     */
+    _startGraceTimer(sessionId, peerId) {
+        const timerKey = `${sessionId}:${peerId}`;
+        const timer = setTimeout(() => {
+            this.graceTimers.delete(timerKey);
+            this.onPeerOffline?.(sessionId, peerId);
+        }, this.graceTimeoutMs);
+        this.graceTimers.set(timerKey, timer);
+    }
+}
+//# sourceMappingURL=connection-manager.js.map

package/dist/services/connection-manager.js.map

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

package/dist/services/message-queue.d.ts

@@ -0,0 +1,56 @@
+import type { MessageRecord } from "@essentialai/cogent";
+import type { SessionStore } from "./session-store.js";
+/**
+ * Offline message queuing service with disk persistence and 7-day TTL.
+ *
+ * When a message is sent to a peer that is not connected via WebSocket,
+ * it is enqueued in the session file. On reconnect, all queued messages
+ * are flushed immediately (no batching, per user decision).
+ *
+ * Persistence is via SessionStore.updateSession(), so the queue survives
+ * server restarts. A periodic cleanup removes entries older than the
+ * configured TTL (default: 7 days).
+ */
+export declare class MessageQueueService {
+    private readonly sessionStore;
+    private readonly queueTtlMs;
+    private cleanupHandle;
+    constructor(sessionStore: SessionStore, queueTtlMs?: number);
+    /**
+     * Queue a message for offline delivery to a peer.
+     * Creates a QueuedMessage wrapper with the current timestamp as enqueuedAt.
+     * Initializes the messageQueue field to {} if not present on the state.
+     */
+    enqueue(sessionId: string, peerId: string, message: MessageRecord): Promise<void>;
+    /**
+     * Remove and return all queued messages for a peer.
+     * Returns the MessageRecord payloads (not the QueuedMessage wrappers).
+     * Returns an empty array if no queue exists for this peer.
+     */
+    dequeueAll(sessionId: string, peerId: string): Promise<MessageRecord[]>;
+    /**
+     * Get the number of queued messages for a peer without modifying state.
+     */
+    getQueueSize(sessionId: string, peerId: string): Promise<number>;
+    /**
+     * Start periodic cleanup of expired queue entries.
+     * Uses setInterval with .unref() so the timer does not prevent
+     * Node.js from exiting naturally during graceful shutdown.
+     *
+     * @param intervalMs How often to run cleanup (default: 6 hours)
+     */
+    startCleanup(intervalMs?: number): void;
+    /**
+     * Stop the periodic cleanup timer.
+     */
+    stopCleanup(): void;
+    /**
+     * Scan all sessions and remove expired queue entries (older than queueTtlMs).
+     * Public method for direct testing without relying on timers
+     * (matches PeerCleanup pattern).
+     *
+     * @returns Total number of expired messages removed across all sessions.
+     */
+    cleanup(): Promise<number>;
+}
+//# sourceMappingURL=message-queue.d.ts.map

package/dist/services/message-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-queue.d.ts","sourceRoot":"","sources":["../../src/services/message-queue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,aAAa,CAA+C;gBAGlE,YAAY,EAAE,YAAY,EAC1B,UAAU,GAAE,MAAgC;IAM9C;;;;OAIG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,IAAI,CAAC;IAsBhB;;;;OAIG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,aAAa,EAAE,CAAC;IA0B3B;;OAEG;IACG,YAAY,CAChB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,CAAC;IAQlB;;;;;;OAMG;IACH,YAAY,CAAC,UAAU,GAAE,MAAmB,GAAG,IAAI;IAenD;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;;;;;OAMG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CA6DjC"}

package/dist/services/message-queue.js

@@ -0,0 +1,164 @@
+/**
+ * Offline message queuing service with disk persistence and 7-day TTL.
+ *
+ * When a message is sent to a peer that is not connected via WebSocket,
+ * it is enqueued in the session file. On reconnect, all queued messages
+ * are flushed immediately (no batching, per user decision).
+ *
+ * Persistence is via SessionStore.updateSession(), so the queue survives
+ * server restarts. A periodic cleanup removes entries older than the
+ * configured TTL (default: 7 days).
+ */
+export class MessageQueueService {
+    sessionStore;
+    queueTtlMs;
+    cleanupHandle = null;
+    constructor(sessionStore, queueTtlMs = 7 * 24 * 60 * 60 * 1000) {
+        this.sessionStore = sessionStore;
+        this.queueTtlMs = queueTtlMs;
+    }
+    /**
+     * Queue a message for offline delivery to a peer.
+     * Creates a QueuedMessage wrapper with the current timestamp as enqueuedAt.
+     * Initializes the messageQueue field to {} if not present on the state.
+     */
+    async enqueue(sessionId, peerId, message) {
+        const entry = {
+            messageId: message.id,
+            enqueuedAt: new Date().toISOString(),
+            message,
+        };
+        await this.sessionStore.updateSession(sessionId, (state) => {
+            // Default messageQueue to {} for legacy session files
+            if (!state.messageQueue) {
+                state.messageQueue = {};
+            }
+            if (!state.messageQueue[peerId]) {
+                state.messageQueue[peerId] = [];
+            }
+            state.messageQueue[peerId].push(entry);
+            return state;
+        });
+    }
+    /**
+     * Remove and return all queued messages for a peer.
+     * Returns the MessageRecord payloads (not the QueuedMessage wrappers).
+     * Returns an empty array if no queue exists for this peer.
+     */
+    async dequeueAll(sessionId, peerId) {
+        let messages = [];
+        await this.sessionStore.updateSession(sessionId, (state) => {
+            // Default messageQueue to {} for legacy session files
+            if (!state.messageQueue) {
+                state.messageQueue = {};
+                return state;
+            }
+            const queue = state.messageQueue[peerId];
+            if (!queue || queue.length === 0) {
+                return state;
+            }
+            // Extract message payloads before clearing
+            messages = queue.map((entry) => entry.message);
+            // Remove the peer's queue entirely
+            delete state.messageQueue[peerId];
+            return state;
+        });
+        return messages;
+    }
+    /**
+     * Get the number of queued messages for a peer without modifying state.
+     */
+    async getQueueSize(sessionId, peerId) {
+        const session = await this.sessionStore.getSession(sessionId);
+        if (!session)
+            return 0;
+        const queue = session.messageQueue?.[peerId];
+        return queue?.length ?? 0;
+    }
+    /**
+     * Start periodic cleanup of expired queue entries.
+     * Uses setInterval with .unref() so the timer does not prevent
+     * Node.js from exiting naturally during graceful shutdown.
+     *
+     * @param intervalMs How often to run cleanup (default: 6 hours)
+     */
+    startCleanup(intervalMs = 21_600_000) {
+        if (this.cleanupHandle !== null) {
+            return; // Already running
+        }
+        this.cleanupHandle = setInterval(() => {
+            this.cleanup().catch((err) => {
+                console.error("Message queue cleanup error:", err);
+            });
+        }, intervalMs);
+        // Allow Node.js to exit even if the timer is still running
+        this.cleanupHandle.unref();
+    }
+    /**
+     * Stop the periodic cleanup timer.
+     */
+    stopCleanup() {
+        if (this.cleanupHandle !== null) {
+            clearInterval(this.cleanupHandle);
+            this.cleanupHandle = null;
+        }
+    }
+    /**
+     * Scan all sessions and remove expired queue entries (older than queueTtlMs).
+     * Public method for direct testing without relying on timers
+     * (matches PeerCleanup pattern).
+     *
+     * @returns Total number of expired messages removed across all sessions.
+     */
+    async cleanup() {
+        const sessionIds = await this.sessionStore.listSessions();
+        let totalRemoved = 0;
+        for (const sessionId of sessionIds) {
+            const session = await this.sessionStore.getSession(sessionId);
+            if (!session)
+                continue;
+            // Skip sessions without a message queue
+            if (!session.messageQueue)
+                continue;
+            const now = Date.now();
+            let sessionRemoved = 0;
+            // Check if any entries are expired across all peer queues
+            let hasExpired = false;
+            for (const queue of Object.values(session.messageQueue)) {
+                for (const entry of queue) {
+                    if (now - Date.parse(entry.enqueuedAt) > this.queueTtlMs) {
+                        hasExpired = true;
+                        break;
+                    }
+                }
+                if (hasExpired)
+                    break;
+            }
+            // Only update if there are expired entries (avoid unnecessary writes)
+            if (!hasExpired)
+                continue;
+            await this.sessionStore.updateSession(sessionId, (state) => {
+                if (!state.messageQueue)
+                    return state;
+                for (const peerId of Object.keys(state.messageQueue)) {
+                    const queue = state.messageQueue[peerId];
+                    const before = queue.length;
+                    state.messageQueue[peerId] = queue.filter((entry) => now - Date.parse(entry.enqueuedAt) <= this.queueTtlMs);
+                    const after = state.messageQueue[peerId].length;
+                    sessionRemoved += before - after;
+                    // Clean up empty arrays
+                    if (state.messageQueue[peerId].length === 0) {
+                        delete state.messageQueue[peerId];
+                    }
+                }
+                return state;
+            });
+            totalRemoved += sessionRemoved;
+        }
+        if (totalRemoved > 0) {
+            console.error(`Message queue cleanup: removed ${totalRemoved} expired message(s)`);
+        }
+        return totalRemoved;
+    }
+}
+//# sourceMappingURL=message-queue.js.map

package/dist/services/message-queue.js.map

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

package/dist/services/peer-cleanup.d.ts

@@ -0,0 +1,39 @@
+import type { SessionStore } from "./session-store.js";
+/**
+ * Background service that periodically scans all sessions and removes
+ * stale peers -- peers whose lastSeenAt timestamp exceeds the configured
+ * timeout. Removal adds peer_disconnected events to the session state
+ * so poll consumers are notified.
+ *
+ * Uses setInterval with unref() so the timer does not prevent Node.js
+ * from exiting naturally during graceful shutdown.
+ */
+export declare class PeerCleanup {
+    private readonly sessionStore;
+    private readonly staleTimeoutMs;
+    private intervalHandle;
+    constructor(sessionStore: SessionStore, staleTimeoutMs: number);
+    /**
+     * Start the periodic cleanup timer.
+     *
+     * @param intervalMs - How often to check for stale peers (default: 60 seconds)
+     */
+    start(intervalMs?: number): void;
+    /**
+     * Stop the periodic cleanup timer.
+     */
+    stop(): void;
+    /**
+     * Scan all sessions and remove stale peers.
+     *
+     * A peer is stale if `Date.now() - Date.parse(peer.lastSeenAt)` exceeds
+     * the configured staleTimeoutMs.
+     *
+     * For each removed peer, a peer_disconnected event is recorded in the
+     * session state so poll consumers are notified.
+     *
+     * @returns Total number of stale peers removed across all sessions.
+     */
+    cleanup(): Promise<number>;
+}
+//# sourceMappingURL=peer-cleanup.d.ts.map

package/dist/services/peer-cleanup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-cleanup.d.ts","sourceRoot":"","sources":["../../src/services/peer-cleanup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;GAQG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,cAAc,CAA+C;gBAEzD,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM;IAK9D;;;;OAIG;IACH,KAAK,CAAC,UAAU,GAAE,MAAe,GAAG,IAAI;IAexC;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;;;;;;;;;OAUG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;CAiDjC"}