hono-status-monitor 1.0.2 → 1.0.3

package/README.md

@@ -368,7 +368,7 @@ 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.
+This package provides a separate edge entry point that has **zero Node.js dependencies**.
 
 ### Available Metrics in Edge Environments
 
@@ -386,13 +386,16 @@ This package automatically detects Cloudflare Workers and edge runtimes, providi
 
 ### Usage in Cloudflare Workers
 
+> **Important:** Use the `/edge` import path for Cloudflare Workers!
+
 ```typescript
 import { Hono } from 'hono';
-import { statusMonitor } from 'hono-status-monitor';
+// Use the edge-specific import (no Node.js dependencies)
+import { statusMonitor } from 'hono-status-monitor/edge';
 
 const app = new Hono();
 
-// Create status monitor - automatically detects edge environment
+// Create status monitor
 const monitor = statusMonitor();
 
 // Add middleware to track requests
@@ -407,16 +410,16 @@ 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.
+> **Note:** In edge environments, the dashboard uses HTTP polling (every 5 seconds) instead of WebSocket for updates. The dashboard will display an "Edge Mode" indicator.
 
-### Force Edge Mode
+### Force Edge Mode in Node.js
 
-You can explicitly use the edge-compatible monitor:
+You can also use the edge-compatible monitor in Node.js if you don't need system metrics:
 
 ```typescript
-import { statusMonitorEdge } from 'hono-status-monitor';
+import { statusMonitor } from 'hono-status-monitor/edge';
 
-const monitor = statusMonitorEdge();
+const monitor = statusMonitor();
 ```
 
 ## 📋 Requirements

package/dist/index-edge.d.ts

@@ -0,0 +1,58 @@
+import { Hono } from 'hono';
+import type { StatusMonitorConfig } from './types.js';
+export type { StatusMonitorConfig, MetricsSnapshot, ChartData, RouteStats, ErrorEntry, PercentileData, AlertStatus } from './types.js';
+export { createEdgeMonitor, type EdgeMonitor } from './monitor-edge.js';
+export { generateEdgeDashboard } from './dashboard.js';
+/**
+ * Create a status monitor for Edge/Cloudflare Workers environments
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { statusMonitor } from 'hono-status-monitor/edge';
+ *
+ * const app = new Hono();
+ * const monitor = statusMonitor();
+ *
+ * app.use('*', monitor.middleware);
+ * app.route('/status', monitor.routes);
+ *
+ * export default app;
+ * ```
+ */
+export declare function statusMonitor(config?: StatusMonitorConfig): {
+    /** Hono middleware for tracking all requests */
+    middleware: (c: any, next: () => Promise<void>) => Promise<void>;
+    /** Pre-configured Hono routes for dashboard and API */
+    routes: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+    /** Initialize Socket.io - not available in edge, returns null */
+    initSocket: () => any;
+    /** Track rate limit events for the dashboard */
+    trackRateLimit: (blocked: boolean) => void;
+    /** Get current metrics snapshot */
+    getMetrics: () => Promise<import("./types.js").MetricsSnapshot>;
+    /** Get chart data for all metrics */
+    getCharts: () => import("./types.js").ChartData;
+    /** Stop metrics collection */
+    stop: () => void;
+    /** Access to the underlying monitor instance */
+    monitor: {
+        config: Required<StatusMonitorConfig>;
+        trackRequest: (path: string, method: string) => void;
+        trackRequestComplete: (path: string, method: string, durationMs: number, statusCode: number) => void;
+        trackRateLimitEvent: (blocked: boolean) => void;
+        getMetricsSnapshot: () => Promise<import("./types.js").MetricsSnapshot>;
+        getChartData: () => import("./types.js").ChartData;
+        start: () => void;
+        stop: () => void;
+        initSocket: () => null;
+        formatUptime: (seconds: number) => string;
+        isEdgeMode: boolean;
+        readonly io: null;
+    };
+    /** Whether running in edge mode */
+    isEdgeMode: boolean;
+};
+export declare const statusMonitorEdge: typeof statusMonitor;
+export default statusMonitor;
+//# sourceMappingURL=index-edge.d.ts.map

package/dist/index-edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-edge.d.ts","sourceRoot":"","sources":["../src/index-edge.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAKtD,YAAY,EACR,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,UAAU,EACV,UAAU,EACV,cAAc,EACd,WAAW,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,mBAAwB;IAiDtD,gDAAgD;oBA5CvB,GAAG,QAAQ,MAAM,OAAO,CAAC,IAAI,CAAC;IA8CvD,uDAAuD;;IAEvD,iEAAiE;sBACvC,GAAG;IAC7B,gDAAgD;8BACtB,OAAO;IACjC,mCAAmC;;IAEnC,qCAAqC;;IAErC,8BAA8B;;IAE9B,gDAAgD;;;;;;;;;;;;;;;IAEhD,mCAAmC;;EAG1C;AAGD,eAAO,MAAM,iBAAiB,sBAAgB,CAAC;AAG/C,eAAe,aAAa,CAAC"}

package/dist/index-edge.js

@@ -0,0 +1,94 @@
+// =============================================================================
+// HONO STATUS MONITOR - EDGE ENTRY POINT
+// For Cloudflare Workers / Edge environments only
+// No Node.js dependencies (os, cluster, socket.io, etc.)
+// =============================================================================
+import { Hono } from 'hono';
+import { createEdgeMonitor } from './monitor-edge.js';
+import { generateEdgeDashboard } from './dashboard.js';
+export { createEdgeMonitor } from './monitor-edge.js';
+export { generateEdgeDashboard } from './dashboard.js';
+/**
+ * Create a status monitor for Edge/Cloudflare Workers environments
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { statusMonitor } from 'hono-status-monitor/edge';
+ *
+ * const app = new Hono();
+ * const monitor = statusMonitor();
+ *
+ * app.use('*', monitor.middleware);
+ * app.route('/status', monitor.routes);
+ *
+ * export default app;
+ * ```
+ */
+export function statusMonitor(config = {}) {
+    const monitor = createEdgeMonitor(config);
+    const routes = new Hono();
+    // Create middleware for edge
+    const middleware = async (c, next) => {
+        const path = new URL(c.req.url).pathname;
+        const method = c.req.method;
+        // Skip status route itself
+        if (path.startsWith(config.path || '/status')) {
+            return next();
+        }
+        const start = performance.now();
+        monitor.trackRequest(path, method);
+        try {
+            await next();
+        }
+        finally {
+            const duration = performance.now() - start;
+            const status = c.res?.status || 200;
+            monitor.trackRequestComplete(path, method, duration, status);
+        }
+    };
+    // Dashboard page - uses polling mode
+    routes.get('/', async (c) => {
+        const snapshot = await monitor.getMetricsSnapshot();
+        const html = generateEdgeDashboard({
+            hostname: snapshot.hostname,
+            uptime: monitor.formatUptime(snapshot.uptime),
+            title: monitor.config.title
+        });
+        return c.html(html);
+    });
+    // JSON API endpoint
+    routes.get('/api/metrics', async (c) => {
+        return c.json({
+            snapshot: await monitor.getMetricsSnapshot(),
+            charts: monitor.getChartData()
+        });
+    });
+    // Start (no-op in edge mode)
+    monitor.start();
+    return {
+        /** Hono middleware for tracking all requests */
+        middleware,
+        /** Pre-configured Hono routes for dashboard and API */
+        routes,
+        /** Initialize Socket.io - not available in edge, returns null */
+        initSocket: () => null,
+        /** Track rate limit events for the dashboard */
+        trackRateLimit: (blocked) => monitor.trackRateLimitEvent(blocked),
+        /** Get current metrics snapshot */
+        getMetrics: () => monitor.getMetricsSnapshot(),
+        /** Get chart data for all metrics */
+        getCharts: () => monitor.getChartData(),
+        /** Stop metrics collection */
+        stop: () => monitor.stop(),
+        /** Access to the underlying monitor instance */
+        monitor,
+        /** Whether running in edge mode */
+        isEdgeMode: true
+    };
+}
+// Also export as statusMonitorEdge for clarity
+export const statusMonitorEdge = statusMonitor;
+// Default export
+export default statusMonitor;
+//# sourceMappingURL=index-edge.js.map

package/dist/index-edge.js.map

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

package/package.json

@@ -1,10 +1,22 @@
 {
     "name": "hono-status-monitor",
-    "version": "1.0.2",
+    "version": "1.0.3",
     "description": "Real-time server monitoring dashboard for Hono.js with WebSocket updates. Works with Node.js and Cloudflare Workers. Express-status-monitor style metrics.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "type": "module",
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "require": "./dist/index.js"
+        },
+        "./edge": {
+            "types": "./dist/index-edge.d.ts",
+            "import": "./dist/index-edge.js",
+            "require": "./dist/index-edge.js"
+        }
+    },
     "files": [
         "dist"
     ],
@@ -41,16 +53,21 @@
         "url": "https://github.com/vinitkumargoel/hono-status-monitor/issues"
     },
     "peerDependencies": {
-        "@hono/node-server": ">=1.0.0",
         "hono": ">=4.0.0"
     },
-    "dependencies": {
+    "peerDependenciesMeta": {
+        "@hono/node-server": {
+            "optional": true
+        }
+    },
+    "optionalDependencies": {
         "socket.io": "^4.7.0"
     },
     "devDependencies": {
         "@hono/node-server": "^1.19.0",
         "@types/node": "^20.0.0",
         "hono": "^4.6.0",
+        "socket.io": "^4.7.0",
         "typescript": "^5.3.0",
         "vitest": "^4.0.16"
     },