driftdetect-dashboard 0.8.1 → 0.8.3

package/dist/server/websocket-server.js

@@ -0,0 +1,189 @@
+/**
+ * WebSocket Server
+ *
+ * Manages WebSocket connections for realtime violation streaming.
+ *
+ * @requirements 2.1 - Expose a WebSocket endpoint at `/ws` for realtime communication
+ * @requirements 2.3 - Broadcast violations to all connected WebSocket clients
+ */
+import { WebSocketServer, WebSocket } from 'ws';
+// ============================================================================
+// WebSocket Manager
+// ============================================================================
+export class WebSocketManager {
+    wss = null;
+    clients = new Set();
+    pingInterval = null;
+    /**
+     * Get the number of connected clients
+     */
+    get clientCount() {
+        return this.clients.size;
+    }
+    /**
+     * Attach WebSocket server to an HTTP server
+     * @requirements 2.1 - WebSocket endpoint at /ws
+     */
+    attach(server) {
+        this.wss = new WebSocketServer({
+            server,
+            path: '/ws',
+        });
+        this.wss.on('connection', (ws) => {
+            this.handleConnection(ws);
+        });
+        // Start ping interval for connection health
+        this.startPingInterval();
+    }
+    /**
+     * Close the WebSocket server and all connections
+     */
+    close() {
+        // Stop ping interval
+        if (this.pingInterval) {
+            clearInterval(this.pingInterval);
+            this.pingInterval = null;
+        }
+        // Close all client connections
+        for (const client of this.clients) {
+            client.close(1000, 'Server shutting down');
+        }
+        this.clients.clear();
+        // Close the WebSocket server
+        if (this.wss) {
+            this.wss.close();
+            this.wss = null;
+        }
+    }
+    /**
+     * Broadcast a violation to all connected clients
+     * @requirements 2.3 - Broadcast violations to all connected clients
+     */
+    broadcastViolation(violation) {
+        this.broadcast({
+            type: 'violation',
+            payload: violation,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Broadcast a pattern update to all connected clients
+     */
+    broadcastPatternUpdate(update) {
+        this.broadcast({
+            type: 'pattern_updated',
+            payload: update,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Broadcast stats update to all connected clients
+     */
+    broadcastStatsUpdate(stats) {
+        this.broadcast({
+            type: 'stats_updated',
+            payload: stats,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    /**
+     * Broadcast patterns changed event to all connected clients
+     * Triggers client-side data refresh
+     */
+    broadcastPatternsChanged(payload) {
+        this.broadcast({
+            type: 'patterns_changed',
+            payload,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    // ==========================================================================
+    // Private Methods
+    // ==========================================================================
+    /**
+     * Handle a new WebSocket connection
+     */
+    handleConnection(ws) {
+        // Add to clients set
+        this.clients.add(ws);
+        // Send connected message
+        this.send(ws, {
+            type: 'connected',
+            payload: { clientCount: this.clients.size },
+            timestamp: new Date().toISOString(),
+        });
+        // Handle messages from client
+        ws.on('message', (data) => {
+            this.handleMessage(ws, data);
+        });
+        // Handle client disconnect
+        ws.on('close', () => {
+            this.clients.delete(ws);
+        });
+        // Handle errors
+        ws.on('error', (error) => {
+            console.error('WebSocket error:', error);
+            this.clients.delete(ws);
+        });
+    }
+    /**
+     * Handle incoming message from a client
+     */
+    handleMessage(ws, data) {
+        try {
+            const message = JSON.parse(data.toString());
+            // Handle ping/pong for connection health
+            if (message.type === 'ping') {
+                this.send(ws, {
+                    type: 'pong',
+                    timestamp: new Date().toISOString(),
+                });
+            }
+        }
+        catch (error) {
+            // Ignore invalid messages
+            console.error('Invalid WebSocket message:', error);
+        }
+    }
+    /**
+     * Send a message to a specific client
+     */
+    send(ws, message) {
+        if (ws.readyState === WebSocket.OPEN) {
+            ws.send(JSON.stringify(message));
+        }
+    }
+    /**
+     * Broadcast a message to all connected clients
+     */
+    broadcast(message) {
+        const messageStr = JSON.stringify(message);
+        for (const client of this.clients) {
+            if (client.readyState === WebSocket.OPEN) {
+                client.send(messageStr);
+            }
+        }
+    }
+    /**
+     * Start ping interval for connection health monitoring
+     */
+    startPingInterval() {
+        // Ping every 30 seconds
+        this.pingInterval = setInterval(() => {
+            const pingMessage = {
+                type: 'ping',
+                timestamp: new Date().toISOString(),
+            };
+            for (const client of this.clients) {
+                if (client.readyState === WebSocket.OPEN) {
+                    client.send(JSON.stringify(pingMessage));
+                }
+                else {
+                    // Remove dead connections
+                    this.clients.delete(client);
+                }
+            }
+        }, 30000);
+    }
+}
+//# sourceMappingURL=websocket-server.js.map

package/dist/server/websocket-server.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "driftdetect-dashboard",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "description": "Local web dashboard for Drift architectural drift detection",
   "license": "Apache-2.0",
   "repository": {
@@ -34,25 +34,9 @@
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "pnpm run build:server && pnpm run build:client",
-    "build:server": "tsc -p tsconfig.server.json",
-    "build:client": "vite build",
-    "clean": "rm -rf dist",
-    "dev": "pnpm run build:server && concurrently -n server,client -c blue,green \"pnpm run dev:backend\" \"pnpm run dev:client\"",
-    "dev:backend": "node --import tsx scripts/dev-server.ts",
-    "dev:server": "tsc -p tsconfig.server.json --watch",
-    "dev:client": "vite",
-    "lint": "eslint src --ext .ts,.tsx",
-    "lint:fix": "eslint src --ext .ts,.tsx --fix",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "typecheck": "tsc --noEmit -p tsconfig.server.json && tsc --noEmit -p tsconfig.client.json"
-  },
   "dependencies": {
-    "driftdetect-core": "^0.8.1",
-    "driftdetect-galaxy": "^0.8.1",
+    "driftdetect-core": "^0.8.2",
+    "driftdetect-galaxy": "^0.8.2",
     "express": "^4.18.2",
     "open": "^10.0.0",
     "ws": "^8.16.0"
@@ -91,5 +75,21 @@
   "peerDependencies": {
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
+  },
+  "scripts": {
+    "build": "pnpm run build:server && pnpm run build:client",
+    "build:server": "tsc -p tsconfig.server.json",
+    "build:client": "vite build",
+    "clean": "rm -rf dist",
+    "dev": "pnpm run build:server && concurrently -n server,client -c blue,green \"pnpm run dev:backend\" \"pnpm run dev:client\"",
+    "dev:backend": "node --import tsx scripts/dev-server.ts",
+    "dev:server": "tsc -p tsconfig.server.json --watch",
+    "dev:client": "vite",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "typecheck": "tsc --noEmit -p tsconfig.server.json && tsc --noEmit -p tsconfig.client.json"
   }
-}
+}