hono-status-monitor 1.0.0 → 1.0.2

package/README.md

@@ -5,7 +5,8 @@
 
 Real-time server monitoring dashboard for **Hono.js** applications with WebSocket updates. Express-status-monitor style metrics powered by Socket.io.
 
-![Status Monitor Dashboard](https://via.placeholder.com/800x450/1a1a1a/fff?text=Status+Monitor+Dashboard)
+<img width="403" height="736" alt="Screenshot 2026-01-01 at 11 58 25 AM" src="https://github.com/user-attachments/assets/f793b5f0-a10e-4699-98ab-b4708703d024" />
+
 
 ## ✨ Features
 
@@ -111,7 +112,10 @@ const monitor = statusMonitor({
         return path
             .replace(/\/users\/\d+/g, '/users/:id')
             .replace(/\/posts\/[a-f0-9]{24}/g, '/posts/:id');
-    }
+    },
+    
+    // Enable cluster mode for PM2 (auto-detected by default)
+    clusterMode: true
 });
 ```
 
@@ -281,6 +285,67 @@ const monitor = statusMonitor({
 });
 ```
 
+### PM2 / Cluster Mode Support
+
+To enable metrics aggregation across multiple processes (Cluster Mode), you need a specific entry point script that handles message relaying between workers.
+
+1. **Create a `cluster.ts` (or `.js`) entry file:**
+
+```typescript
+import cluster from 'node:cluster';
+import * as os from 'node:os';
+import { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const numCPUs = os.cpus().length;
+
+if (cluster.isPrimary) {
+    console.log(`Primary ${process.pid} is running`);
+
+    // Fork workers
+    for (let i = 0; i < numCPUs; i++) {
+        const worker = cluster.fork();
+        
+        // Relay messages between workers
+        worker.on('message', (message) => {
+            if (message?.type === 'worker-metrics') {
+                // Broadcast to all workers (including sender)
+                for (const id in cluster.workers) {
+                    cluster.workers[id]?.send(message);
+                }
+            }
+        });
+    }
+
+    cluster.on('exit', (worker) => {
+        console.log(`worker ${worker.process.pid} died`);
+        // Replace dead worker
+        const newWorker = cluster.fork();
+        newWorker.on('message', (message) => {
+            if (message?.type === 'worker-metrics') {
+                for (const id in cluster.workers) {
+                    cluster.workers[id]?.send(message);
+                }
+            }
+        });
+    });
+} else {
+    // Workers share the TCP connection in this file
+    await import('./index'); // Path to your main app file
+}
+```
+
+2. **Run this cluster script with PM2:**
+
+```bash
+# Start the cluster script as a SINGLE PM2 instance
+# (The script itself manages the worker processes)
+pm2 start cluster.ts --name my-app
+```
+
+**Note:** Do NOT use `pm2 start app.ts -i max` directly, as PM2's default isolation prevents workers from sharing metrics without an external adapter (like Redis). Using the script above provides a zero-dependency aggregation solution.
+
 ## 🛡️ Security Considerations
 
 The status dashboard exposes server metrics. Consider:
@@ -301,11 +366,64 @@ app.use('/status/*', basicAuth({
 app.route('/status', monitor.routes);
 ```
 
+## ☁️ Cloudflare Workers / Edge Support
+
+This package automatically detects Cloudflare Workers and edge runtimes, providing a lightweight monitor with available metrics.
+
+### Available Metrics in Edge Environments
+
+| Metric | Available | Notes |
+|--------|-----------|-------|
+| Request count & RPS | ✅ | Fully supported |
+| Response time percentiles | ✅ | P50, P95, P99, Avg |
+| Status code breakdown | ✅ | 2xx, 3xx, 4xx, 5xx |
+| Route analytics | ✅ | Top routes, slowest routes |
+| Error tracking | ✅ | Recent errors with timestamps |
+| CPU / Memory / Heap | ❌ | Not available in Workers |
+| Event loop lag | ❌ | Not available in Workers |
+| Load average | ❌ | Not available in Workers |
+| WebSocket real-time | ❌ | Uses polling (5s interval) |
+
+### Usage in Cloudflare Workers
+
+```typescript
+import { Hono } from 'hono';
+import { statusMonitor } from 'hono-status-monitor';
+
+const app = new Hono();
+
+// Create status monitor - automatically detects edge environment
+const monitor = statusMonitor();
+
+// Add middleware to track requests
+app.use('*', monitor.middleware);
+
+// Mount status dashboard
+app.route('/status', monitor.routes);
+
+// Your routes
+app.get('/', (c) => c.text('Hello from Cloudflare Workers!'));
+
+export default app;
+```
+
+> **Note:** In Cloudflare Workers, the dashboard uses HTTP polling (every 5 seconds) instead of WebSocket for updates. The dashboard will display an "Edge Mode" indicator.
+
+### Force Edge Mode
+
+You can explicitly use the edge-compatible monitor:
+
+```typescript
+import { statusMonitorEdge } from 'hono-status-monitor';
+
+const monitor = statusMonitorEdge();
+```
+
 ## 📋 Requirements
 
-- Node.js >= 18.0.0
+- Node.js >= 18.0.0 (for Node.js mode)
 - Hono.js >= 4.0.0
-- @hono/node-server >= 1.0.0
+- @hono/node-server >= 1.0.0 (for Node.js mode only)
 
 ## 🤝 Contributing
 
@@ -318,3 +436,4 @@ MIT © [Vinit Kumar Goel](https://github.com/vinitkumargoel)
 ---
 
 Made with ❤️ for the Hono.js community
+

package/dist/cluster.d.ts

@@ -0,0 +1,29 @@
+import type { MetricsSnapshot, ChartData, WorkerInfo, WorkerMetricsMessage } from './types.js';
+/**
+ * Check if running in cluster mode (PM2 or native Node.js cluster)
+ */
+export declare function isClusterWorker(): boolean;
+/**
+ * Check if this is the primary/master process
+ */
+export declare function isClusterMaster(): boolean;
+/**
+ * Get worker ID
+ */
+export declare function getWorkerId(): number;
+/**
+ * Send metrics from worker to parent process (for PM2 cluster mode)
+ */
+export declare function sendMetricsToMaster(metrics: Partial<MetricsSnapshot>, charts: ChartData): void;
+/**
+ * Create a cluster aggregator for the master process
+ */
+export declare function createClusterAggregator(): {
+    updateWorkerMetrics: (message: WorkerMetricsMessage) => void;
+    getWorkerInfo: () => WorkerInfo[];
+    aggregateMetrics: (baseSnapshot: MetricsSnapshot) => MetricsSnapshot;
+    aggregateCharts: (baseCharts: ChartData) => ChartData;
+    readonly workerCount: number;
+};
+export type ClusterAggregator = ReturnType<typeof createClusterAggregator>;
+//# sourceMappingURL=cluster.d.ts.map

package/dist/cluster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cluster.d.ts","sourceRoot":"","sources":["../src/cluster.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,eAAe,EACf,SAAS,EACT,UAAU,EACV,oBAAoB,EAIvB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAUpC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,MAAM,EAAE,SAAS,GAClB,IAAI,CAgBN;AAcD;;GAEG;AACH,wBAAgB,uBAAuB;mCAOG,oBAAoB,KAAG,IAAI;yBAwBvC,UAAU,EAAE;qCAeE,eAAe,KAAG,eAAe;kCAsHpC,SAAS,KAAG,SAAS;;EAsE7D;AAED,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/cluster.js

@@ -0,0 +1,256 @@
+// =============================================================================
+// HONO STATUS MONITOR - CLUSTER UTILITIES
+// PM2 / Node.js Cluster mode support for metrics aggregation
+// =============================================================================
+import cluster from 'cluster';
+/**
+ * Check if running in cluster mode (PM2 or native Node.js cluster)
+ */
+export function isClusterWorker() {
+    return cluster.isWorker || !!process.env.PM2_HOME || !!process.env.NODE_APP_INSTANCE;
+}
+/**
+ * Check if this is the primary/master process
+ */
+export function isClusterMaster() {
+    return cluster.isPrimary || cluster.isMaster;
+}
+/**
+ * Get worker ID
+ */
+export function getWorkerId() {
+    if (cluster.worker) {
+        return cluster.worker.id;
+    }
+    // PM2 instance ID
+    const instanceId = process.env.NODE_APP_INSTANCE;
+    if (instanceId) {
+        return parseInt(instanceId, 10);
+    }
+    return 0;
+}
+/**
+ * Send metrics from worker to parent process (for PM2 cluster mode)
+ */
+export function sendMetricsToMaster(metrics, charts) {
+    if (!process.send)
+        return;
+    const message = {
+        type: 'worker-metrics',
+        workerId: getWorkerId(),
+        pid: process.pid,
+        metrics,
+        charts
+    };
+    try {
+        process.send(message);
+    }
+    catch (error) {
+        // Silently ignore send errors (master may have died)
+    }
+}
+/**
+ * Create a cluster aggregator for the master process
+ */
+export function createClusterAggregator() {
+    const workerMetrics = {};
+    const WORKER_TIMEOUT_MS = 10000; // Consider worker dead after 10s no update
+    /**
+     * Update metrics from a worker
+     */
+    function updateWorkerMetrics(message) {
+        workerMetrics[message.workerId] = {
+            pid: message.pid,
+            metrics: message.metrics,
+            charts: message.charts,
+            lastUpdate: Date.now()
+        };
+    }
+    /**
+     * Clean up stale workers
+     */
+    function cleanupStaleWorkers() {
+        const now = Date.now();
+        for (const workerId of Object.keys(workerMetrics)) {
+            if (now - workerMetrics[parseInt(workerId)].lastUpdate > WORKER_TIMEOUT_MS) {
+                delete workerMetrics[parseInt(workerId)];
+            }
+        }
+    }
+    /**
+     * Get all active worker info
+     */
+    function getWorkerInfo() {
+        cleanupStaleWorkers();
+        return Object.values(workerMetrics).map(w => ({
+            pid: w.pid,
+            cpu: w.metrics.cpu || 0,
+            memoryMB: w.metrics.memoryMB || 0,
+            rps: w.metrics.rps || 0,
+            totalRequests: w.metrics.totalRequests || 0,
+            responseTime: w.metrics.responseTime || 0
+        }));
+    }
+    /**
+     * Aggregate metrics from all workers
+     */
+    function aggregateMetrics(baseSnapshot) {
+        cleanupStaleWorkers();
+        const workers = Object.values(workerMetrics);
+        if (workers.length === 0) {
+            return baseSnapshot;
+        }
+        // Sum metrics that should be totaled across workers
+        let totalRps = 0;
+        let totalRequests = 0;
+        let totalActiveConnections = 0;
+        let totalErrorRate = 0;
+        // Average metrics that should be averaged
+        let totalCpu = 0;
+        let totalResponseTime = 0;
+        let workerCount = 0;
+        // Aggregate status codes
+        const aggregatedStatusCodes = {};
+        // Aggregate rate limit stats
+        let totalRateLimitBlocked = 0;
+        let totalRateLimitTotal = 0;
+        // Aggregate routes
+        const routeMap = new Map();
+        for (const worker of workers) {
+            const m = worker.metrics;
+            workerCount++;
+            // Sum
+            totalRps += m.rps || 0;
+            totalRequests += m.totalRequests || 0;
+            totalActiveConnections += m.activeConnections || 0;
+            // For averaging
+            totalCpu += m.cpu || 0;
+            totalResponseTime += m.responseTime || 0;
+            totalErrorRate += m.errorRate || 0;
+            // Aggregate status codes
+            if (m.statusCodes) {
+                for (const [code, count] of Object.entries(m.statusCodes)) {
+                    aggregatedStatusCodes[code] = (aggregatedStatusCodes[code] || 0) + count;
+                }
+            }
+            // Aggregate rate limit stats
+            if (m.rateLimitStats) {
+                totalRateLimitBlocked += m.rateLimitStats.blocked || 0;
+                totalRateLimitTotal += m.rateLimitStats.total || 0;
+            }
+            // Aggregate routes
+            const allRoutes = [
+                ...(m.topRoutes || []),
+                ...(m.slowestRoutes || []),
+                ...(m.errorRoutes || [])
+            ];
+            for (const route of allRoutes) {
+                const key = `${route.method}:${route.path}`;
+                const existing = routeMap.get(key);
+                if (existing) {
+                    existing.count += route.count;
+                    existing.totalTime += route.totalTime;
+                    existing.avgTime = existing.totalTime / existing.count;
+                    existing.minTime = Math.min(existing.minTime, route.minTime);
+                    existing.maxTime = Math.max(existing.maxTime, route.maxTime);
+                    existing.errors += route.errors;
+                    existing.lastAccess = Math.max(existing.lastAccess, route.lastAccess);
+                }
+                else {
+                    routeMap.set(key, { ...route });
+                }
+            }
+        }
+        // Calculate averages
+        const avgCpu = workerCount > 0 ? totalCpu / workerCount : baseSnapshot.cpu;
+        const avgResponseTime = workerCount > 0 ? totalResponseTime / workerCount : baseSnapshot.responseTime;
+        const avgErrorRate = workerCount > 0 ? totalErrorRate / workerCount : baseSnapshot.errorRate;
+        // Get aggregated routes
+        const allRoutes = Array.from(routeMap.values());
+        const topRoutes = allRoutes.sort((a, b) => b.count - a.count).slice(0, 10);
+        const slowestRoutes = allRoutes.filter(r => r.count > 0).sort((a, b) => b.avgTime - a.avgTime).slice(0, 10);
+        const errorRoutes = allRoutes.filter(r => r.errors > 0).sort((a, b) => b.errors - a.errors).slice(0, 10);
+        return {
+            ...baseSnapshot,
+            cpu: Math.round(avgCpu * 10) / 10,
+            responseTime: Math.round(avgResponseTime * 100) / 100,
+            rps: totalRps,
+            totalRequests,
+            activeConnections: totalActiveConnections,
+            errorRate: Math.round(avgErrorRate * 100) / 100,
+            statusCodes: Object.keys(aggregatedStatusCodes).length > 0
+                ? aggregatedStatusCodes
+                : baseSnapshot.statusCodes,
+            rateLimitStats: {
+                blocked: totalRateLimitBlocked,
+                total: totalRateLimitTotal
+            },
+            topRoutes,
+            slowestRoutes,
+            errorRoutes,
+            workers: getWorkerInfo(),
+            workerCount
+        };
+    }
+    /**
+     * Aggregate chart data from all workers
+     */
+    function aggregateCharts(baseCharts) {
+        cleanupStaleWorkers();
+        const workers = Object.values(workerMetrics);
+        if (workers.length === 0) {
+            return baseCharts;
+        }
+        // For charts, we need to merge data points by timestamp
+        const mergeChartData = (base, workerCharts, key, aggregationType) => {
+            const timeMap = new Map();
+            // Add base data
+            for (const point of base) {
+                timeMap.set(point.timestamp, { sum: point.value, count: 1 });
+            }
+            // Add worker data
+            for (const wc of workerCharts) {
+                const data = wc[key];
+                for (const point of data) {
+                    const existing = timeMap.get(point.timestamp);
+                    if (existing) {
+                        existing.sum += point.value;
+                        existing.count++;
+                    }
+                    else {
+                        timeMap.set(point.timestamp, { sum: point.value, count: 1 });
+                    }
+                }
+            }
+            // Convert back to array
+            const result = [];
+            for (const [timestamp, { sum, count }] of timeMap.entries()) {
+                const value = aggregationType === 'sum' ? sum : sum / count;
+                result.push({ timestamp, value: Math.round(value * 100) / 100 });
+            }
+            return result.sort((a, b) => a.timestamp - b.timestamp);
+        };
+        const workerCharts = workers.map(w => w.charts);
+        return {
+            cpu: mergeChartData(baseCharts.cpu, workerCharts, 'cpu', 'avg'),
+            memory: mergeChartData(baseCharts.memory, workerCharts, 'memory', 'avg'),
+            heap: mergeChartData(baseCharts.heap, workerCharts, 'heap', 'avg'),
+            loadAvg: mergeChartData(baseCharts.loadAvg, workerCharts, 'loadAvg', 'avg'),
+            responseTime: mergeChartData(baseCharts.responseTime, workerCharts, 'responseTime', 'avg'),
+            rps: mergeChartData(baseCharts.rps, workerCharts, 'rps', 'sum'),
+            eventLoopLag: mergeChartData(baseCharts.eventLoopLag, workerCharts, 'eventLoopLag', 'avg'),
+            errorRate: mergeChartData(baseCharts.errorRate, workerCharts, 'errorRate', 'avg')
+        };
+    }
+    return {
+        updateWorkerMetrics,
+        getWorkerInfo,
+        aggregateMetrics,
+        aggregateCharts,
+        get workerCount() {
+            cleanupStaleWorkers();
+            return Object.keys(workerMetrics).length;
+        }
+    };
+}
+//# sourceMappingURL=cluster.js.map

package/dist/cluster.js.map

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

package/dist/dashboard.d.ts

@@ -3,4 +3,17 @@ import type { DashboardProps } from './types.js';
  * Generate the status dashboard HTML
  */
 export declare function generateDashboard({ hostname, uptime, socketPath, title }: DashboardProps): string;
+/**
+ * Edge Dashboard Props (no socketPath)
+ */
+export interface EdgeDashboardProps {
+    hostname: string;
+    uptime: string;
+    title: string;
+}
+/**
+ * Generate the edge-compatible status dashboard HTML
+ * Uses polling instead of WebSocket, only shows available metrics
+ */
+export declare function generateEdgeDashboard({ hostname, uptime, title }: EdgeDashboardProps): string;
 //# sourceMappingURL=dashboard.d.ts.map

package/dist/dashboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,MAAM,CA6bjG"}
+{"version":3,"file":"dashboard.d.ts","sourceRoot":"","sources":["../src/dashboard.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,cAAc,GAAG,MAAM,CA6bjG;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,kBAAkB,GAAG,MAAM,CAkY7F"}