claude-mux 0.7.0

package/dist/server/ws-handlers.d.ts

@@ -0,0 +1,174 @@
+/**
+ * Shared WebSocket handler logic for both dev (ws) and production (Bun) servers.
+ * Abstracts the WebSocket-specific APIs behind a simple interface.
+ *
+ * Features:
+ * - Max clients limit to prevent server overload
+ * - Structured error logging
+ * - Backpressure handling for slow clients
+ */
+import { type Session } from '../db/index.js';
+export interface WsConfig {
+    /** Max clients for sessions endpoint (default: 50) */
+    maxSessionsClients?: number;
+    /** Max clients per terminal target (default: 10) */
+    maxTerminalClientsPerTarget?: number;
+    /** Max total terminal clients across all targets (default: 100) */
+    maxTerminalClientsTotal?: number;
+    /** Max queued messages before dropping slow client (default: 100) */
+    maxQueuedMessages?: number;
+    /** Enable debug logging (default: false) */
+    debug?: boolean;
+}
+export interface WsClient {
+    send: (data: string) => void;
+    isOpen: () => boolean;
+    close: () => void;
+    /** Optional: Get buffered amount for backpressure detection */
+    getBufferedAmount?: () => number;
+}
+export interface SessionsMessage {
+    type: 'sessions' | 'connected';
+    sessions: (Session & {
+        pane_title: string | null;
+    })[];
+    count: number;
+    timestamp: number;
+}
+export interface TerminalMessage {
+    type: 'output';
+    output: string;
+    timestamp: number;
+}
+export interface ResizeMessage {
+    type: 'resize';
+    cols: number;
+    rows: number;
+}
+export declare function getEnrichedSessions(): (Session & {
+    pane_title: string | null;
+})[];
+export declare function capturePaneOutput(target: string): string | null;
+export declare function resizePane(target: string, cols: number, rows: number): void;
+export declare class SessionsWsManager {
+    private clients;
+    private unsubscribe;
+    private interruptCheckTimer;
+    private lastHash;
+    private config;
+    private droppedClients;
+    constructor(config?: WsConfig);
+    /** Get current stats */
+    getStats(): {
+        clients: number;
+        droppedClients: number;
+    };
+    /**
+     * Add a client. Returns false if max clients reached.
+     */
+    addClient(client: WsClient): boolean;
+    removeClient(client: WsClient): void;
+    private createMessage;
+    private broadcastIfChanged;
+    private sendToClient;
+}
+export declare class TerminalWsManager {
+    private clients;
+    private pollTimers;
+    private lastOutput;
+    private config;
+    private totalClients;
+    private droppedClients;
+    constructor(config?: WsConfig);
+    /** Get current stats */
+    getStats(): {
+        totalClients: number;
+        targets: number;
+        droppedClients: number;
+    };
+    /**
+     * Add a client for a target. Returns false if max clients reached.
+     */
+    addClient(client: WsClient, target: string): boolean;
+    removeClient(client: WsClient, target?: string): void;
+    private startPolling;
+    private stopPolling;
+    private pollAndBroadcast;
+    private sendToClient;
+}
+/**
+ * Handle incoming WebSocket message. Returns 'pong' if ping, otherwise parses resize.
+ */
+export declare function handleWsMessage(msgStr: string, onResize?: (cols: number, rows: number) => void): 'pong' | null;
+export interface BeadsIssue {
+    id: string;
+    title: string;
+    status: 'open' | 'in_progress' | 'blocked' | 'deferred' | 'closed';
+    priority: number;
+    issue_type: string;
+    owner?: string;
+    assignee?: string;
+    created_at?: string;
+    updated_at?: string;
+    dependencies?: {
+        depends_on_id: string;
+        type: string;
+    }[];
+}
+export interface BeadsMessage {
+    type: 'issues' | 'connected';
+    issues: BeadsIssue[];
+    project: string;
+    timestamp: number;
+}
+/**
+ * Fetch beads issues using bd CLI
+ */
+export declare function getBeadsIssues(projectPath: string): BeadsIssue[];
+interface BeadsWatcherCallback {
+    (): void;
+}
+declare class BeadsProjectWatcher {
+    private subscribers;
+    private pollTimers;
+    private lastMtime;
+    private readonly pollInterval;
+    /**
+     * Subscribe to changes in a project's beads issues
+     */
+    subscribe(projectPath: string, callback: BeadsWatcherCallback): () => void;
+    private startWatching;
+    private stopWatching;
+    private checkForChanges;
+    private notifySubscribers;
+}
+export declare const beadsWatcher: BeadsProjectWatcher;
+export declare class BeadsWsManager {
+    private clients;
+    private unsubscribes;
+    private lastHash;
+    private config;
+    private totalClients;
+    constructor(config?: WsConfig);
+    getStats(): {
+        totalClients: number;
+        projects: number;
+    };
+    addClient(client: WsClient, projectPath: string): boolean;
+    removeClient(client: WsClient, projectPath?: string): void;
+    private createMessage;
+    private broadcastIfChanged;
+    private sendToClient;
+}
+export type WsPathResult = {
+    type: 'sessions';
+} | {
+    type: 'terminal';
+    target: string;
+} | {
+    type: 'beads';
+    project: string;
+} | null;
+export declare function parseWsPath(pathname: string, searchParams?: URLSearchParams): WsPathResult;
+export {};
+//# sourceMappingURL=ws-handlers.d.ts.map

package/dist/server/ws-handlers.d.ts.map

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