npm - @stacksjs/bun-router - Versions diffs - 0.0.5 → 0.0.7 - Mend

@stacksjs/bun-router 0.0.5 → 0.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (269) hide show

package/dist/auth.d.ts +134 -0
package/dist/cache/lru-cache.d.ts +139 -0
package/dist/cache/middleware-memoization.d.ts +151 -0
package/dist/cache/route-cache-warmer.d.ts +161 -0
package/dist/cache/sqlite-cache.d.ts +209 -0
package/dist/cache/streaming-cache.d.ts +132 -0
package/dist/cli/colors.d.ts +15 -0
package/dist/cli/index.d.ts +10 -0
package/dist/cli/middleware.d.ts +31 -0
package/dist/cli/openapi.d.ts +17 -0
package/dist/cli/router.d.ts +15 -0
package/dist/cli/routes.d.ts +29 -0
package/dist/cli/utils.d.ts +74 -0
package/dist/cli.d.ts +1 -1
package/dist/cli.js +1 -1
package/dist/config.d.ts +7 -0
package/dist/container/container.d.ts +273 -0
package/dist/container/contextual-binding.d.ts +240 -0
package/dist/container/decorators.d.ts +141 -0
package/dist/container/service-provider.d.ts +285 -0
package/dist/development/hot-reload.d.ts +187 -0
package/dist/development/index.d.ts +167 -0
package/dist/development/performance-profiler.d.ts +217 -0
package/dist/development/route-debugger.d.ts +154 -0
package/dist/development/route-inspector.d.ts +211 -0
package/dist/development/typescript-utilities.d.ts +209 -0
package/dist/docs.d.ts +11 -0
package/dist/errors/circuit-breaker.d.ts +195 -0
package/dist/errors/error-handler.d.ts +88 -0
package/dist/errors/error-reporting.d.ts +144 -0
package/dist/errors/exceptions.d.ts +184 -0
package/dist/errors/graceful-degradation.d.ts +154 -0
package/dist/errors/index.d.ts +9 -0
package/dist/errors/router-errors.d.ts +110 -0
package/dist/file-serving/static-files.d.ts +143 -0
package/dist/index.d.ts +2 -0
package/dist/index.js +375 -227
package/dist/middleware/auth.d.ts +63 -0
package/dist/middleware/content_security_policy.d.ts +53 -0
package/dist/middleware/cors.d.ts +5 -0
package/dist/middleware/csrf.d.ts +7 -0
package/dist/middleware/ddos_protection.d.ts +39 -0
package/dist/middleware/file_security.d.ts +26 -0
package/dist/middleware/file_upload.d.ts +38 -0
package/dist/middleware/helmet.d.ts +54 -0
package/dist/middleware/index.d.ts +44 -0
package/dist/middleware/input_validation.d.ts +45 -0
package/dist/middleware/json_body.d.ts +4 -0
package/dist/middleware/performance_alerting.d.ts +87 -0
package/dist/middleware/performance_dashboard.d.ts +87 -0
package/dist/middleware/performance_monitor.d.ts +209 -0
package/dist/middleware/pipeline.d.ts +131 -0
package/dist/middleware/rate_limit.d.ts +36 -0
package/dist/middleware/request_id.d.ts +4 -0
package/dist/middleware/request_signing.d.ts +153 -0
package/dist/middleware/request_tracer.d.ts +72 -0
package/dist/middleware/response_cache.d.ts +97 -0
package/dist/middleware/security.d.ts +69 -0
package/dist/middleware/security_suite.d.ts +46 -0
package/dist/middleware/session.d.ts +23 -0
package/dist/model-binding/index.d.ts +2 -0
package/dist/model-binding/model-middleware.d.ts +118 -0
package/dist/model-binding/model-registry.d.ts +164 -0
package/dist/model-binding.d.ts +185 -0
package/dist/model-resolver-factory.d.ts +31 -0
package/dist/observability/correlation.d.ts +187 -0
package/dist/observability/health-checks.d.ts +186 -0
package/dist/observability/index.d.ts +60 -0
package/dist/observability/integration.d.ts +147 -0
package/dist/observability/metrics.d.ts +184 -0
package/dist/observability/tracing.d.ts +187 -0
package/dist/optimization/bun-utilities.d.ts +224 -0
package/dist/query-builder-integration.d.ts +36 -0
package/dist/request/context.d.ts +34 -0
package/dist/request/enhanced-request.d.ts +213 -0
package/dist/request/macros.d.ts +300 -0
package/dist/response/macros.d.ts +245 -0
package/dist/response/response-factory.d.ts +133 -0
package/dist/router/api-routes.d.ts +5 -0
package/dist/router/file-based-routing.d.ts +118 -0
package/dist/router/file-streaming.d.ts +5 -0
package/dist/router/fluent-router.d.ts +315 -0
package/dist/router/fluent-routing.d.ts +271 -0
package/dist/router/group-organization.d.ts +5 -0
package/dist/router/handler-resolver.d.ts +24 -0
package/dist/router/http-methods.d.ts +10 -0
package/dist/router/index.d.ts +113 -0
package/dist/router/middleware-groups.d.ts +94 -0
package/dist/router/middleware-integration.d.ts +112 -0
package/dist/router/middleware.d.ts +5 -0
package/dist/router/model-binding.d.ts +5 -0
package/dist/router/optimized-route-matching.d.ts +6 -0
package/dist/router/route-building.d.ts +5 -0
package/dist/router/route-compiler.d.ts +153 -0
package/dist/router/route-matching.d.ts +5 -0
package/dist/router/route-trie.d.ts +114 -0
package/dist/router/router.d.ts +276 -0
package/dist/router/server.d.ts +5 -0
package/dist/router/validation-integration.d.ts +170 -0
package/dist/router/view-rendering.d.ts +5 -0
package/dist/router/websocket.d.ts +5 -0
package/dist/routing/route-caching.d.ts +129 -0
package/dist/routing/route-throttling.d.ts +150 -0
package/dist/routing/subdomain-routing.d.ts +206 -0
package/dist/session/database-store.d.ts +51 -0
package/dist/session/file-store.d.ts +22 -0
package/dist/session/index.d.ts +106 -0
package/dist/session/memory-store.d.ts +21 -0
package/dist/session/redis-store.d.ts +31 -0
package/dist/streaming/index.d.ts +3 -0
package/dist/streaming/sse-handler.d.ts +138 -0
package/dist/streaming/stream-handler.d.ts +114 -0
package/dist/testing/auth-testing.d.ts +156 -0
package/dist/testing/file-upload-testing.d.ts +190 -0
package/dist/testing/index.d.ts +10 -0
package/dist/testing/middleware-testing.d.ts +138 -0
package/dist/testing/model-binding-testing.d.ts +186 -0
package/dist/testing/performance-testing.d.ts +235 -0
package/dist/testing/test-client.d.ts +117 -0
package/dist/testing/test-request.d.ts +85 -0
package/dist/testing/test-response.d.ts +90 -0
package/dist/testing/types.d.ts +207 -0
package/dist/testing/websocket-testing.d.ts +227 -0
package/dist/types/controller-types.d.ts +208 -0
package/dist/types/core.d.ts +543 -0
package/dist/types/middleware-types.d.ts +227 -0
package/dist/types/request-response-augmentation.d.ts +261 -0
package/dist/types/route-inference.d.ts +168 -0
package/dist/types.d.ts +1776 -0
package/dist/url.d.ts +56 -0
package/dist/utils/index.d.ts +1 -0
package/dist/utils/query-preservation.d.ts +48 -0
package/dist/utils.d.ts +69 -0
package/dist/validation/validator.d.ts +140 -0
package/dist/websocket/clustering.d.ts +185 -0
package/package.json +3 -2
package/src/auth.ts +469 -0
package/src/cache/lru-cache.ts +457 -0
package/src/cache/middleware-memoization.ts +531 -0
package/src/cache/route-cache-warmer.ts +486 -0
package/src/cache/sqlite-cache.ts +783 -0
package/src/cache/streaming-cache.ts +572 -0
package/src/cli/colors.ts +29 -0
package/src/cli/index.ts +287 -0
package/src/cli/middleware.ts +291 -0
package/src/cli/openapi.ts +407 -0
package/src/cli/router.ts +188 -0
package/src/cli/routes.ts +265 -0
package/src/cli/utils.ts +531 -0
package/src/cli.ts +5 -0
package/src/config.ts +322 -0
package/src/container/container.ts +740 -0
package/src/container/contextual-binding.ts +603 -0
package/src/container/decorators.ts +359 -0
package/src/container/service-provider.ts +596 -0
package/src/development/hot-reload.ts +673 -0
package/src/development/index.ts +499 -0
package/src/development/performance-profiler.ts +717 -0
package/src/development/route-debugger.ts +527 -0
package/src/development/route-inspector.ts +749 -0
package/src/development/typescript-utilities.ts +678 -0
package/src/docs.ts +397 -0
package/src/errors/circuit-breaker.ts +732 -0
package/src/errors/error-handler.ts +569 -0
package/src/errors/error-reporting.ts +672 -0
package/src/errors/exceptions.ts +536 -0
package/src/errors/graceful-degradation.ts +621 -0
package/src/errors/index.ts +21 -0
package/src/errors/router-errors.ts +632 -0
package/src/file-serving/static-files.ts +581 -0
package/src/index.ts +14 -0
package/src/middleware/auth.ts +219 -0
package/src/middleware/content_security_policy.ts +215 -0
package/src/middleware/cors.ts +74 -0
package/src/middleware/csrf.ts +108 -0
package/src/middleware/ddos_protection.ts +255 -0
package/src/middleware/file_security.ts +191 -0
package/src/middleware/file_upload.ts +264 -0
package/src/middleware/helmet.ts +268 -0
package/src/middleware/index.ts +117 -0
package/src/middleware/input_validation.ts +449 -0
package/src/middleware/json_body.ts +37 -0
package/src/middleware/performance_alerting.ts +538 -0
package/src/middleware/performance_dashboard.ts +661 -0
package/src/middleware/performance_monitor.ts +943 -0
package/src/middleware/pipeline.ts +489 -0
package/src/middleware/rate_limit.ts +245 -0
package/src/middleware/request_id.ts +36 -0
package/src/middleware/request_signing.ts +636 -0
package/src/middleware/request_tracer.ts +636 -0
package/src/middleware/response_cache.ts +743 -0
package/src/middleware/security.ts +482 -0
package/src/middleware/security_suite.ts +257 -0
package/src/middleware/session.ts +91 -0
package/src/model-binding/index.ts +18 -0
package/src/model-binding/model-middleware.ts +425 -0
package/src/model-binding/model-registry.ts +550 -0
package/src/model-binding.ts +370 -0
package/src/model-resolver-factory.ts +106 -0
package/src/observability/correlation.ts +691 -0
package/src/observability/health-checks.ts +729 -0
package/src/observability/index.ts +184 -0
package/src/observability/integration.ts +548 -0
package/src/observability/metrics.ts +753 -0
package/src/observability/tracing.ts +638 -0
package/src/optimization/bun-utilities.ts +778 -0
package/src/query-builder-integration.ts +137 -0
package/src/request/context.ts +62 -0
package/src/request/enhanced-request.ts +857 -0
package/src/request/macros.ts +688 -0
package/src/response/macros.ts +612 -0
package/src/response/response-factory.ts +588 -0
package/src/router/api-routes.ts +243 -0
package/src/router/file-based-routing.ts +670 -0
package/src/router/file-streaming.ts +372 -0
package/src/router/fluent-router.ts +927 -0
package/src/router/fluent-routing.ts +797 -0
package/src/router/group-organization.ts +213 -0
package/src/router/handler-resolver.ts +291 -0
package/src/router/http-methods.ts +377 -0
package/src/router/index.ts +185 -0
package/src/router/middleware-groups.ts +222 -0
package/src/router/middleware-integration.ts +399 -0
package/src/router/middleware.ts +231 -0
package/src/router/model-binding.ts +215 -0
package/src/router/optimized-route-matching.ts +253 -0
package/src/router/route-building.ts +212 -0
package/src/router/route-compiler.ts +702 -0
package/src/router/route-matching.ts +349 -0
package/src/router/route-trie.ts +464 -0
package/src/router/router.ts +1524 -0
package/src/router/server.ts +429 -0
package/src/router/validation-integration.ts +443 -0
package/src/router/view-rendering.ts +233 -0
package/src/router/websocket.ts +100 -0
package/src/routing/route-caching.ts +402 -0
package/src/routing/route-throttling.ts +469 -0
package/src/routing/subdomain-routing.ts +492 -0
package/src/session/database-store.ts +109 -0
package/src/session/file-store.ts +148 -0
package/src/session/index.ts +244 -0
package/src/session/memory-store.ts +88 -0
package/src/session/redis-store.ts +93 -0
package/src/streaming/index.ts +17 -0
package/src/streaming/sse-handler.ts +482 -0
package/src/streaming/stream-handler.ts +552 -0
package/src/testing/auth-testing.ts +446 -0
package/src/testing/file-upload-testing.ts +543 -0
package/src/testing/index.ts +10 -0
package/src/testing/middleware-testing.ts +322 -0
package/src/testing/model-binding-testing.ts +645 -0
package/src/testing/performance-testing.ts +738 -0
package/src/testing/test-client.ts +310 -0
package/src/testing/test-request.ts +315 -0
package/src/testing/test-response.ts +332 -0
package/src/testing/types.ts +224 -0
package/src/testing/websocket-testing.ts +590 -0
package/src/types/controller-types.ts +385 -0
package/src/types/core.ts +683 -0
package/src/types/middleware-types.ts +419 -0
package/src/types/request-response-augmentation.ts +489 -0
package/src/types/route-inference.ts +357 -0
package/src/types.ts +2049 -0
package/src/url.ts +126 -0
package/src/utils/index.ts +1 -0
package/src/utils/query-preservation.ts +201 -0
package/src/utils.ts +327 -0
package/src/validation/validator.ts +685 -0
package/src/websocket/clustering.ts +762 -0

package/src/middleware/performance_dashboard.ts ADDED Viewed

@@ -0,0 +1,661 @@
+import type { EnhancedRequest, NextFunction } from '../types'
+import type { TraceSpan } from './request_tracer'
+import process from 'node:process'
+export interface DashboardOptions {
+  enabled?: boolean
+  path?: string
+  title?: string
+  refreshInterval?: number
+  maxMetrics?: number
+  authentication?: {
+    enabled?: boolean
+    username?: string
+    password?: string
+    apiKey?: string
+  }
+  features?: {
+    realTimeMetrics?: boolean
+    historicalCharts?: boolean
+    alertsPanel?: boolean
+    tracingView?: boolean
+    systemMetrics?: boolean
+  }
+}
+export interface DashboardData {
+  metrics: {
+    current: {
+      totalRequests: number
+      averageResponseTime: number
+      errorRate: number
+      requestsPerSecond: number
+      memoryUsage: number
+      cpuUsage: number
+    }
+    historical: Array<{
+      timestamp: number
+      responseTime: number
+      memoryUsage: number
+      requestCount: number
+      errorCount: number
+    }>
+    distribution: {
+      statusCodes: Record<number, number>
+      paths: Record<string, number>
+      methods: Record<string, number>
+      responseTimes: Array<{ range: string, count: number }>
+    }
+  }
+  alerts: Array<{
+    id: string
+    type: 'warning' | 'critical'
+    message: string
+    timestamp: number
+    resolved: boolean
+  }>
+  traces: TraceSpan[]
+  system: {
+    uptime: number
+    nodeVersion: string
+    bunVersion: string
+    platform: string
+    arch: string
+    memory: NodeJS.MemoryUsage
+    cpu: NodeJS.CpuUsage
+  }
+}
+export default class PerformanceDashboard {
+  private options: DashboardOptions
+  private metricsHistory: Array<{
+    timestamp: number
+    responseTime: number
+    memoryUsage: number
+    requestCount: number
+    errorCount: number
+  }> = []
+  private alerts: Array<{
+    id: string
+    type: 'warning' | 'critical'
+    message: string
+    timestamp: number
+    resolved: boolean
+  }> = []
+  private startTime: number = Date.now()
+  constructor(options: DashboardOptions = {}) {
+    this.options = {
+      enabled: options.enabled ?? true,
+      path: options.path ?? '/performance',
+      title: options.title ?? 'Performance Dashboard',
+      refreshInterval: options.refreshInterval ?? 5000,
+      maxMetrics: options.maxMetrics ?? 1000,
+      authentication: {
+        enabled: false,
+        ...options.authentication,
+      },
+      features: {
+        realTimeMetrics: true,
+        historicalCharts: true,
+        alertsPanel: true,
+        tracingView: true,
+        systemMetrics: true,
+        ...options.features,
+      },
+    }
+  }
+  private isAuthenticated(req: EnhancedRequest): boolean {
+    if (!this.options.authentication?.enabled)
+      return true
+    const auth = req.headers.get('authorization')
+    const apiKey = req.headers.get('x-api-key')
+    if (this.options.authentication.apiKey && apiKey === this.options.authentication.apiKey) {
+      return true
+    }
+    if (auth && this.options.authentication.username && this.options.authentication.password) {
+      const [type, credentials] = auth.split(' ')
+      if (type === 'Basic') {
+        const decoded = atob(credentials)
+        const [username, password] = decoded.split(':')
+        return username === this.options.authentication.username
+          && password === this.options.authentication.password
+      }
+    }
+    return false
+  }
+  private generateDashboardHTML(data: DashboardData): string {
+    return `
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name='viewport' content='width=device-width, initial-scale=1.0'>
+    <title>${this.options.title}</title>
+    <style>
+        * { margin: 0; padding: 0; box-sizing: border-box; }
+        body {
+            font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+            background: #f5f5f5;
+            color: #333;
+            line-height: 1.6;
+        }
+        .header {
+            background: #2c3e50;
+            color: white;
+            padding: 1rem 2rem;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+        }
+        .header h1 { font-size: 1.5rem; }
+        .status {
+            display: flex;
+            gap: 1rem;
+            align-items: center;
+        }
+        .status-item {
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            font-size: 0.8rem;
+        }
+        .status-value {
+            font-size: 1.2rem;
+            font-weight: bold;
+        }
+        .container {
+            max-width: 1400px;
+            margin: 0 auto;
+            padding: 2rem;
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+            gap: 2rem;
+        }
+        .card {
+            background: white;
+            border-radius: 8px;
+            padding: 1.5rem;
+            box-shadow: 0 2px 4px rgba(0,0,0,0.1);
+        }
+        .card h2 {
+            margin-bottom: 1rem;
+            color: #2c3e50;
+            font-size: 1.2rem;
+        }
+        .metric {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            padding: 0.5rem 0;
+            border-bottom: 1px solid #eee;
+        }
+        .metric:last-child { border-bottom: none; }
+        .metric-label { font-weight: 500; }
+        .metric-value {
+            font-weight: bold;
+            color: #27ae60;
+        }
+        .metric-value.warning { color: #f39c12; }
+        .metric-value.critical { color: #e74c3c; }
+        .alert {
+            padding: 0.75rem;
+            margin: 0.5rem 0;
+            border-radius: 4px;
+            border-left: 4px solid;
+        }
+        .alert.warning {
+            background: #fff3cd;
+            border-color: #f39c12;
+            color: #856404;
+        }
+        .alert.critical {
+            background: #f8d7da;
+            border-color: #e74c3c;
+            color: #721c24;
+        }
+        .chart-container {
+            height: 200px;
+            background: #f8f9fa;
+            border-radius: 4px;
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            color: #666;
+        }
+        .distribution {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
+            gap: 1rem;
+            margin-top: 1rem;
+        }
+        .distribution-item {
+            text-align: center;
+            padding: 1rem;
+            background: #f8f9fa;
+            border-radius: 4px;
+        }
+        .distribution-value {
+            font-size: 1.5rem;
+            font-weight: bold;
+            color: #2c3e50;
+        }
+        .distribution-label {
+            font-size: 0.8rem;
+            color: #666;
+            margin-top: 0.5rem;
+        }
+        .trace {
+            padding: 0.75rem;
+            margin: 0.5rem 0;
+            background: #f8f9fa;
+            border-radius: 4px;
+            border-left: 4px solid #3498db;
+        }
+        .trace-header {
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            margin-bottom: 0.5rem;
+        }
+        .trace-operation {
+            font-weight: bold;
+            color: #2c3e50;
+        }
+        .trace-duration {
+            color: #666;
+            font-size: 0.9rem;
+        }
+        .trace-details {
+            font-size: 0.8rem;
+            color: #666;
+        }
+        .refresh-indicator {
+            position: fixed;
+            top: 1rem;
+            right: 1rem;
+            background: #27ae60;
+            color: white;
+            padding: 0.5rem 1rem;
+            border-radius: 4px;
+            font-size: 0.8rem;
+            opacity: 0;
+            transition: opacity 0.3s;
+        }
+        .refresh-indicator.active { opacity: 1; }
+        @media (max-width: 768px) {
+            .container {
+                grid-template-columns: 1fr;
+                padding: 1rem;
+            }
+            .header {
+                padding: 1rem;
+                flex-direction: column;
+                gap: 1rem;
+            }
+        }
+    </style>
+</head>
+<body>
+    <div class='header'>
+        <h1>${this.options.title}</h1>
+        <div class='status'>
+            <div class='status-item'>
+                <div class='status-value'>${data.metrics.current.totalRequests}</div>
+                <div>Total Requests</div>
+            </div>
+            <div class='status-item'>
+                <div class='status-value'>${Math.round(data.metrics.current.averageResponseTime)}ms</div>
+                <div>Avg Response</div>
+            </div>
+            <div class='status-item'>
+                <div class='status-value'>${Math.round(data.metrics.current.errorRate * 100)}%</div>
+                <div>Error Rate</div>
+            </div>
+            <div class='status-item'>
+                <div class='status-value'>${Math.round(data.metrics.current.requestsPerSecond)}/s</div>
+                <div>Requests/sec</div>
+            </div>
+        </div>
+    </div>
+    <div class='container'>
+        ${this.options.features?.realTimeMetrics
+          ? `
+        <div class='card'>
+            <h2>Real-time Metrics</h2>
+            <div class='metric'>
+                <span class='metric-label'>Response Time</span>
+                <span class='metric-value'>${Math.round(data.metrics.current.averageResponseTime)}ms</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>Memory Usage</span>
+                <span class='metric-value'>${Math.round(data.metrics.current.memoryUsage / 1024 / 1024)}MB</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>CPU Usage</span>
+                <span class='metric-value'>${Math.round(data.metrics.current.cpuUsage)}%</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>Requests/sec</span>
+                <span class='metric-value'>${Math.round(data.metrics.current.requestsPerSecond)}</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>Error Rate</span>
+                <span class='metric-value ${data.metrics.current.errorRate > 0.1 ? "critical" : data.metrics.current.errorRate > 0.05 ? "warning" : ""}'>${Math.round(data.metrics.current.errorRate * 100)}%</span>
+            </div>
+        </div>
+        `
+          : ''}
+        ${this.options.features?.historicalCharts
+          ? `
+        <div class='card'>
+            <h2>Historical Performance</h2>
+            <div class='chart-container'>
+                Response Time Chart (${data.metrics.historical.length} data points)
+            </div>
+        </div>
+        `
+          : ''}
+        <div class='card'>
+            <h2>Request Distribution</h2>
+            <div class='distribution'>
+                ${Object.entries(data.metrics.distribution.statusCodes).map(([code, count]) => `
+                    <div class='distribution-item'>
+                        <div class='distribution-value'>${count}</div>
+                        <div class='distribution-label'>HTTP ${code}</div>
+                    </div>
+                `).join('')}
+            </div>
+        </div>
+        <div class='card'>
+            <h2>Top Endpoints</h2>
+            ${Object.entries(data.metrics.distribution.paths)
+              .sort(([,a], [,b]) => b - a)
+              .slice(0, 10)
+              .map(([path, count]) => `
+                    <div class='metric'>
+                        <span class='metric-label'>${path}</span>
+                        <span class='metric-value'>${count}</span>
+                    </div>
+                `)
+              .join('')}
+        </div>
+        ${this.options.features?.alertsPanel
+          ? `
+        <div class='card'>
+            <h2>Active Alerts</h2>
+            ${data.alerts.length === 0 ? '<p>No active alerts</p>' : ''}
+            ${data.alerts.filter(alert => !alert.resolved).map(alert => `
+                <div class='${alert.type} alert'>
+                    <strong>${alert.type.toUpperCase()}:</strong> ${alert.message}
+                    <br><small>${new Date(alert.timestamp).toLocaleString()}</small>
+                </div>
+            `).join('')}
+        </div>
+        `
+          : ''}
+        ${this.options.features?.tracingView
+          ? `
+        <div class='card'>
+            <h2>Recent Traces</h2>
+            ${data.traces.slice(0, 10).map(trace => `
+                <div class='trace'>
+                    <div class='trace-header'>
+                        <span class='trace-operation'>${trace.operationName}</span>
+                        <span class='trace-duration'>${Math.round((trace.duration || 0) * 100) / 100}ms</span>
+                    </div>
+                    <div class='trace-details'>
+                        Trace ID: ${trace.traceId} | Status: ${trace.status}
+                        ${trace.error ? ` | Error: ${trace.error}` : ''}
+                    </div>
+                </div>
+            `).join('')}
+        </div>
+        `
+          : ''}
+        ${this.options.features?.systemMetrics
+          ? `
+        <div class='card'>
+            <h2>System Information</h2>
+            <div class='metric'>
+                <span class='metric-label'>Uptime</span>
+                <span class='metric-value'>${Math.round(data.system.uptime / 1000 / 60)} minutes</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>Node.js</span>
+                <span class='metric-value'>${data.system.nodeVersion}</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>Platform</span>
+                <span class='metric-value'>${data.system.platform} ${data.system.arch}</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>Heap Used</span>
+                <span class='metric-value'>${Math.round(data.system.memory.heapUsed / 1024 / 1024)}MB</span>
+            </div>
+            <div class='metric'>
+                <span class='metric-label'>RSS</span>
+                <span class='metric-value'>${Math.round(data.system.memory.rss / 1024 / 1024)}MB</span>
+            </div>
+        </div>
+        `
+          : ''}
+    </div>
+    <div class='refresh-indicator' id='refreshIndicator'>Updated</div>
+    <script>
+        let refreshInterval;
+        function startAutoRefresh() {
+            refreshInterval = setInterval(async () => {
+                try {
+                    const response = await fetch('${this.options.path}/api/data');
+                    if (response.ok) {
+                        const indicator = document.getElementById('refreshIndicator');
+                        indicator.classList.add('active');
+                        setTimeout(() => indicator.classList.remove('active'), 1000);
+                        // In a real implementation, we would update the DOM with new data
+                        // For now, we'll just refresh the page
+                        setTimeout(() => window.location.reload(), ${this.options.refreshInterval});
+                    }
+                }
+catch (error) {
+                    console.error('Failed to refresh data:', error);
+                }
+            }, ${this.options.refreshInterval});
+        }
+        // Start auto-refresh
+        startAutoRefresh();
+        // Stop refresh when page is hidden
+        document.addEventListener('visibilitychange', () => {
+            if (document.hidden) {
+                clearInterval(refreshInterval);
+            }
+else {
+                startAutoRefresh();
+            }
+        });
+    </script>
+</body>
+</html>
+    `
+  }
+  private async getDashboardData(
+    performanceMonitor?: any,
+    requestTracer?: any,
+  ): Promise<DashboardData> {
+    const now = Date.now()
+    // Get metrics from performance monitor if available
+    const metrics = {
+      current: {
+        totalRequests: 0,
+        averageResponseTime: 0,
+        errorRate: 0,
+        requestsPerSecond: 0,
+        memoryUsage: 0,
+        cpuUsage: 0,
+      },
+      historical: this.metricsHistory,
+      distribution: {
+        statusCodes: {} as Record<number, number>,
+        paths: {} as Record<string, number>,
+        methods: {} as Record<string, number>,
+        responseTimes: [] as Array<{ range: string, count: number }>,
+      },
+    }
+    if (performanceMonitor && typeof performanceMonitor.getAggregatedMetrics === 'function') {
+      const aggregated = performanceMonitor.getAggregatedMetrics(60000) // Last minute
+      metrics.current = {
+        totalRequests: aggregated.totalRequests,
+        averageResponseTime: aggregated.averageResponseTime,
+        errorRate: aggregated.errorRate,
+        requestsPerSecond: aggregated.requestsPerSecond,
+        memoryUsage: aggregated.averageMemoryUsage,
+        cpuUsage: 0, // Would need CPU monitoring
+      }
+      metrics.distribution.statusCodes = aggregated.statusCodeDistribution
+      metrics.distribution.paths = aggregated.pathDistribution
+    }
+    // Get traces from request tracer if available
+    let traces: TraceSpan[] = []
+    if (requestTracer && typeof requestTracer.getActiveSpans === 'function') {
+      traces = requestTracer.getActiveSpans()
+    }
+    // System information
+    const system = {
+      uptime: now - this.startTime,
+      nodeVersion: process.version,
+      bunVersion: process.versions.bun || 'N/A',
+      platform: process.platform,
+      arch: process.arch,
+      memory: process.memoryUsage(),
+      cpu: process.cpuUsage(),
+    }
+    return {
+      metrics,
+      alerts: this.alerts,
+      traces,
+      system,
+    }
+  }
+  async handle(req: EnhancedRequest, next: NextFunction): Promise<Response | null> {
+    if (!this.options.enabled) {
+      const response = await next()
+      return response || new Response('Internal Server Error', { status: 500 })
+    }
+    const url = new URL(req.url)
+    // Check if this is a dashboard request
+    if (url.pathname === this.options.path) {
+      if (!this.isAuthenticated(req)) {
+        return new Response('Unauthorized', {
+          status: 401,
+          headers: {
+            'WWW-Authenticate': 'Basic realm="Performance Dashboard"',
+          },
+        })
+      }
+      const data = await this.getDashboardData()
+      const html = this.generateDashboardHTML(data)
+      return new Response(html, {
+        headers: {
+          'Content-Type': 'text/html',
+          'Cache-Control': 'no-cache, no-store, must-revalidate',
+        },
+      })
+    }
+    // API endpoint for dashboard data
+    if (url.pathname === `${this.options.path}/api/data`) {
+      if (!this.isAuthenticated(req)) {
+        return new Response('Unauthorized', { status: 401 })
+      }
+      const data = await this.getDashboardData()
+      return new Response(JSON.stringify(data), {
+        headers: {
+          'Content-Type': 'application/json',
+          'Cache-Control': 'no-cache, no-store, must-revalidate',
+        },
+      })
+    }
+    return await next()
+  }
+  addAlert(type: 'warning' | 'critical', message: string): void {
+    this.alerts.push({
+      id: Math.random().toString(36).substring(2, 15),
+      type,
+      message,
+      timestamp: Date.now(),
+      resolved: false,
+    })
+    // Keep only recent alerts
+    if (this.alerts.length > 100) {
+      this.alerts = this.alerts.slice(-100)
+    }
+  }
+  resolveAlert(id: string): void {
+    const alert = this.alerts.find(a => a.id === id)
+    if (alert) {
+      alert.resolved = true
+    }
+  }
+  updateMetricsHistory(data: {
+    responseTime: number
+    memoryUsage: number
+    requestCount: number
+    errorCount: number
+  }): void {
+    this.metricsHistory.push({
+      timestamp: Date.now(),
+      ...data,
+    })
+    // Keep only recent history
+    const maxEntries = this.options.maxMetrics || 1000
+    if (this.metricsHistory.length > maxEntries) {
+      this.metricsHistory = this.metricsHistory.slice(-maxEntries)
+    }
+  }
+}
+// Factory function for easy use
+export function performanceDashboard(options: DashboardOptions = {}): (req: EnhancedRequest, next: NextFunction) => Promise<Response | null> {
+  const instance = new PerformanceDashboard(options)
+  return async (req: EnhancedRequest, next: NextFunction) => instance.handle(req, next)
+}