driftdetect-dashboard 0.8.1 → 0.8.3

package/dist/server/dashboard-server.d.ts

@@ -0,0 +1,64 @@
+/**
+ * DashboardServer
+ *
+ * Main server class that orchestrates Express and WebSocket servers
+ * for the Drift Dashboard.
+ *
+ * @requirements 1.1 - Start an Express server on localhost:3847
+ * @requirements 1.2 - Start on the specified port
+ * @requirements 1.3 - Automatically open the default browser to the dashboard URL
+ * @requirements 1.5 - Handle port conflict errors gracefully
+ */
+import { type DashboardViolation } from './drift-data-reader.js';
+export interface DashboardServerOptions {
+    /** Port to listen on (default: 3847) */
+    port: number;
+    /** Path to the .drift directory */
+    driftDir: string;
+    /** Whether to automatically open browser on start */
+    openBrowser: boolean;
+}
+export declare class DashboardServer {
+    private readonly options;
+    private readonly reader;
+    private readonly wsManager;
+    private readonly patternWatcher;
+    private server;
+    constructor(options: DashboardServerOptions);
+    /**
+     * Get the configured port
+     */
+    get port(): number;
+    /**
+     * Get the drift directory path
+     */
+    get driftDir(): string;
+    /**
+     * Check if the server is running
+     */
+    get isRunning(): boolean;
+    /**
+     * Get the number of connected WebSocket clients
+     */
+    get connectedClients(): number;
+    /**
+     * Start the dashboard server
+     * @requirements 1.1, 1.2, 1.3
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the dashboard server
+     */
+    stop(): Promise<void>;
+    /**
+     * Broadcast a violation to all connected WebSocket clients
+     * @requirements 2.3
+     */
+    broadcastViolation(violation: DashboardViolation): void;
+    /**
+     * Open the default browser to the dashboard URL
+     * @requirements 1.3
+     */
+    private openBrowser;
+}
+//# sourceMappingURL=dashboard-server.d.ts.map

package/dist/server/dashboard-server.js

@@ -0,0 +1,154 @@
+/**
+ * DashboardServer
+ *
+ * Main server class that orchestrates Express and WebSocket servers
+ * for the Drift Dashboard.
+ *
+ * @requirements 1.1 - Start an Express server on localhost:3847
+ * @requirements 1.2 - Start on the specified port
+ * @requirements 1.3 - Automatically open the default browser to the dashboard URL
+ * @requirements 1.5 - Handle port conflict errors gracefully
+ */
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { DriftDataReader } from './drift-data-reader.js';
+import { createExpressApp } from './express-app.js';
+import { WebSocketManager } from './websocket-server.js';
+import { PatternWatcher } from './pattern-watcher.js';
+// Get the directory of this file for resolving static files
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+export class DashboardServer {
+    options;
+    reader;
+    wsManager;
+    patternWatcher;
+    server = null;
+    constructor(options) {
+        this.options = options;
+        this.reader = new DriftDataReader(options.driftDir);
+        this.wsManager = new WebSocketManager();
+        this.patternWatcher = new PatternWatcher({ driftDir: options.driftDir });
+        // Wire up pattern watcher to WebSocket broadcasts
+        this.patternWatcher.on('change', (event) => {
+            this.wsManager.broadcastPatternsChanged({
+                type: event.type,
+                category: event.category,
+                status: event.status,
+            });
+        });
+    }
+    /**
+     * Get the configured port
+     */
+    get port() {
+        return this.options.port;
+    }
+    /**
+     * Get the drift directory path
+     */
+    get driftDir() {
+        return this.options.driftDir;
+    }
+    /**
+     * Check if the server is running
+     */
+    get isRunning() {
+        return this.server !== null;
+    }
+    /**
+     * Get the number of connected WebSocket clients
+     */
+    get connectedClients() {
+        return this.wsManager.clientCount;
+    }
+    /**
+     * Start the dashboard server
+     * @requirements 1.1, 1.2, 1.3
+     */
+    async start() {
+        if (this.server) {
+            throw new Error('Server is already running');
+        }
+        // Resolve static files directory (dist/client relative to dist/server)
+        const staticDir = path.resolve(__dirname, '..', 'client');
+        // Create Express app
+        const app = createExpressApp({
+            reader: this.reader,
+            staticDir,
+            enableCors: true,
+        });
+        // Create HTTP server
+        return new Promise((resolve, reject) => {
+            this.server = app.listen(this.options.port, async () => {
+                console.log(`Dashboard server running at http://localhost:${this.options.port}`);
+                // Attach WebSocket server
+                this.wsManager.attach(this.server);
+                // Start pattern watcher for realtime updates
+                this.patternWatcher.start();
+                // Open browser if requested
+                if (this.options.openBrowser) {
+                    try {
+                        await this.openBrowser();
+                    }
+                    catch (error) {
+                        // Don't fail if browser can't be opened
+                        console.warn('Could not open browser:', error);
+                    }
+                }
+                resolve();
+            });
+            this.server.on('error', (error) => {
+                this.server = null;
+                if (error.code === 'EADDRINUSE') {
+                    reject(new Error(`Port ${this.options.port} is already in use. Try a different port with --port <number>`));
+                }
+                else {
+                    reject(error);
+                }
+            });
+        });
+    }
+    /**
+     * Stop the dashboard server
+     */
+    async stop() {
+        if (!this.server) {
+            return;
+        }
+        // Stop pattern watcher
+        this.patternWatcher.stop();
+        // Close WebSocket connections
+        this.wsManager.close();
+        // Close HTTP server
+        return new Promise((resolve, reject) => {
+            this.server.close((error) => {
+                this.server = null;
+                if (error) {
+                    reject(error);
+                }
+                else {
+                    console.log('Dashboard server stopped');
+                    resolve();
+                }
+            });
+        });
+    }
+    /**
+     * Broadcast a violation to all connected WebSocket clients
+     * @requirements 2.3
+     */
+    broadcastViolation(violation) {
+        this.wsManager.broadcastViolation(violation);
+    }
+    /**
+     * Open the default browser to the dashboard URL
+     * @requirements 1.3
+     */
+    async openBrowser() {
+        // Dynamic import to avoid issues with ESM
+        const open = await import('open');
+        await open.default(`http://localhost:${this.options.port}`);
+    }
+}
+//# sourceMappingURL=dashboard-server.js.map

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

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