@stacksjs/bun-router 0.0.13 → 0.0.14
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.
- package/CHANGELOG.md +770 -0
- package/README.md +584 -261
- package/package.json +43 -47
- package/bin/cli.ts +0 -9
- package/dist/auth.d.ts +0 -134
- package/dist/cache/lru-cache.d.ts +0 -139
- package/dist/cache/middleware-memoization.d.ts +0 -151
- package/dist/cache/route-cache-warmer.d.ts +0 -161
- package/dist/cache/sqlite-cache.d.ts +0 -209
- package/dist/cache/streaming-cache.d.ts +0 -132
- package/dist/chunk-1mvtv6jw.js +0 -13012
- package/dist/cli/colors.d.ts +0 -15
- package/dist/cli/index.d.ts +0 -10
- package/dist/cli/middleware.d.ts +0 -31
- package/dist/cli/openapi.d.ts +0 -17
- package/dist/cli/router.d.ts +0 -15
- package/dist/cli/routes.d.ts +0 -29
- package/dist/cli/utils.d.ts +0 -74
- package/dist/cli.d.ts +0 -1
- package/dist/cli.js +0 -3195
- package/dist/config.d.ts +0 -7
- package/dist/container/container.d.ts +0 -273
- package/dist/container/contextual-binding.d.ts +0 -240
- package/dist/container/decorators.d.ts +0 -141
- package/dist/container/service-provider.d.ts +0 -285
- package/dist/development/hot-reload.d.ts +0 -187
- package/dist/development/index.d.ts +0 -167
- package/dist/development/performance-profiler.d.ts +0 -217
- package/dist/development/route-debugger.d.ts +0 -154
- package/dist/development/route-inspector.d.ts +0 -211
- package/dist/development/typescript-utilities.d.ts +0 -209
- package/dist/docs.d.ts +0 -11
- package/dist/errors/circuit-breaker.d.ts +0 -195
- package/dist/errors/error-handler.d.ts +0 -88
- package/dist/errors/error-reporting.d.ts +0 -144
- package/dist/errors/exceptions.d.ts +0 -184
- package/dist/errors/graceful-degradation.d.ts +0 -154
- package/dist/errors/index.d.ts +0 -9
- package/dist/errors/router-errors.d.ts +0 -110
- package/dist/file-serving/static-files.d.ts +0 -143
- package/dist/index.d.ts +0 -14
- package/dist/index.js +0 -13933
- package/dist/middleware/auth.d.ts +0 -63
- package/dist/middleware/content_security_policy.d.ts +0 -53
- package/dist/middleware/cors.d.ts +0 -5
- package/dist/middleware/csrf.d.ts +0 -7
- package/dist/middleware/ddos_protection.d.ts +0 -39
- package/dist/middleware/file_security.d.ts +0 -26
- package/dist/middleware/file_upload.d.ts +0 -38
- package/dist/middleware/helmet.d.ts +0 -54
- package/dist/middleware/index.d.ts +0 -44
- package/dist/middleware/input_validation.d.ts +0 -45
- package/dist/middleware/json_body.d.ts +0 -4
- package/dist/middleware/performance_alerting.d.ts +0 -87
- package/dist/middleware/performance_dashboard.d.ts +0 -87
- package/dist/middleware/performance_monitor.d.ts +0 -209
- package/dist/middleware/pipeline.d.ts +0 -131
- package/dist/middleware/rate_limit.d.ts +0 -36
- package/dist/middleware/request_id.d.ts +0 -4
- package/dist/middleware/request_signing.d.ts +0 -153
- package/dist/middleware/request_tracer.d.ts +0 -72
- package/dist/middleware/response_cache.d.ts +0 -97
- package/dist/middleware/security.d.ts +0 -69
- package/dist/middleware/security_suite.d.ts +0 -46
- package/dist/middleware/session.d.ts +0 -23
- package/dist/model-binding/index.d.ts +0 -2
- package/dist/model-binding/model-middleware.d.ts +0 -118
- package/dist/model-binding/model-registry.d.ts +0 -164
- package/dist/model-binding.d.ts +0 -185
- package/dist/model-resolver-factory.d.ts +0 -31
- package/dist/observability/correlation.d.ts +0 -187
- package/dist/observability/health-checks.d.ts +0 -186
- package/dist/observability/index.d.ts +0 -60
- package/dist/observability/integration.d.ts +0 -147
- package/dist/observability/metrics.d.ts +0 -184
- package/dist/observability/tracing.d.ts +0 -187
- package/dist/optimization/bun-utilities.d.ts +0 -224
- package/dist/query-builder-integration.d.ts +0 -36
- package/dist/request/context.d.ts +0 -34
- package/dist/request/enhanced-request.d.ts +0 -213
- package/dist/request/macros.d.ts +0 -300
- package/dist/response/macros.d.ts +0 -245
- package/dist/response/response-factory.d.ts +0 -133
- package/dist/router/api-routes.d.ts +0 -5
- package/dist/router/file-based-routing.d.ts +0 -118
- package/dist/router/file-streaming.d.ts +0 -5
- package/dist/router/fluent-router.d.ts +0 -315
- package/dist/router/fluent-routing.d.ts +0 -271
- package/dist/router/group-organization.d.ts +0 -5
- package/dist/router/handler-resolver.d.ts +0 -24
- package/dist/router/http-methods.d.ts +0 -10
- package/dist/router/index.d.ts +0 -114
- package/dist/router/middleware-groups.d.ts +0 -94
- package/dist/router/middleware-integration.d.ts +0 -112
- package/dist/router/middleware.d.ts +0 -5
- package/dist/router/model-binding.d.ts +0 -5
- package/dist/router/optimized-route-matching.d.ts +0 -6
- package/dist/router/route-building.d.ts +0 -5
- package/dist/router/route-compiler.d.ts +0 -153
- package/dist/router/route-matching.d.ts +0 -5
- package/dist/router/route-trie.d.ts +0 -114
- package/dist/router/router.d.ts +0 -294
- package/dist/router/server.d.ts +0 -5
- package/dist/router/validation-integration.d.ts +0 -170
- package/dist/router/view-rendering.d.ts +0 -5
- package/dist/router/websocket.d.ts +0 -5
- package/dist/routing/route-caching.d.ts +0 -129
- package/dist/routing/route-throttling.d.ts +0 -150
- package/dist/routing/subdomain-routing.d.ts +0 -206
- package/dist/session/database-store.d.ts +0 -51
- package/dist/session/file-store.d.ts +0 -22
- package/dist/session/index.d.ts +0 -106
- package/dist/session/memory-store.d.ts +0 -21
- package/dist/session/redis-store.d.ts +0 -31
- package/dist/streaming/index.d.ts +0 -3
- package/dist/streaming/sse-handler.d.ts +0 -138
- package/dist/streaming/stream-handler.d.ts +0 -114
- package/dist/testing/auth-testing.d.ts +0 -156
- package/dist/testing/file-upload-testing.d.ts +0 -190
- package/dist/testing/index.d.ts +0 -10
- package/dist/testing/middleware-testing.d.ts +0 -138
- package/dist/testing/model-binding-testing.d.ts +0 -186
- package/dist/testing/performance-testing.d.ts +0 -235
- package/dist/testing/test-client.d.ts +0 -117
- package/dist/testing/test-request.d.ts +0 -85
- package/dist/testing/test-response.d.ts +0 -90
- package/dist/testing/types.d.ts +0 -207
- package/dist/testing/websocket-testing.d.ts +0 -227
- package/dist/types/controller-types.d.ts +0 -208
- package/dist/types/core.d.ts +0 -543
- package/dist/types/middleware-types.d.ts +0 -227
- package/dist/types/request-response-augmentation.d.ts +0 -261
- package/dist/types/route-inference.d.ts +0 -168
- package/dist/types.d.ts +0 -1782
- package/dist/url.d.ts +0 -56
- package/dist/utils/index.d.ts +0 -1
- package/dist/utils/query-preservation.d.ts +0 -48
- package/dist/utils.d.ts +0 -69
- package/dist/validation/validator.d.ts +0 -140
- package/dist/websocket/clustering.d.ts +0 -185
- package/src/auth.ts +0 -469
- package/src/cache/lru-cache.ts +0 -457
- package/src/cache/middleware-memoization.ts +0 -531
- package/src/cache/route-cache-warmer.ts +0 -486
- package/src/cache/sqlite-cache.ts +0 -783
- package/src/cache/streaming-cache.ts +0 -572
- package/src/cli/colors.ts +0 -29
- package/src/cli/index.ts +0 -287
- package/src/cli/middleware.ts +0 -291
- package/src/cli/openapi.ts +0 -407
- package/src/cli/router.ts +0 -188
- package/src/cli/routes.ts +0 -265
- package/src/cli/utils.ts +0 -531
- package/src/cli.ts +0 -5
- package/src/config.ts +0 -322
- package/src/container/container.ts +0 -740
- package/src/container/contextual-binding.ts +0 -603
- package/src/container/decorators.ts +0 -359
- package/src/container/service-provider.ts +0 -596
- package/src/development/hot-reload.ts +0 -673
- package/src/development/index.ts +0 -499
- package/src/development/performance-profiler.ts +0 -717
- package/src/development/route-debugger.ts +0 -527
- package/src/development/route-inspector.ts +0 -749
- package/src/development/typescript-utilities.ts +0 -682
- package/src/docs.ts +0 -397
- package/src/errors/circuit-breaker.ts +0 -732
- package/src/errors/error-handler.ts +0 -569
- package/src/errors/error-reporting.ts +0 -672
- package/src/errors/exceptions.ts +0 -536
- package/src/errors/graceful-degradation.ts +0 -621
- package/src/errors/index.ts +0 -21
- package/src/errors/router-errors.ts +0 -632
- package/src/file-serving/static-files.ts +0 -581
- package/src/index.ts +0 -14
- package/src/middleware/auth.ts +0 -219
- package/src/middleware/content_security_policy.ts +0 -215
- package/src/middleware/cors.ts +0 -74
- package/src/middleware/csrf.ts +0 -108
- package/src/middleware/ddos_protection.ts +0 -255
- package/src/middleware/file_security.ts +0 -191
- package/src/middleware/file_upload.ts +0 -264
- package/src/middleware/helmet.ts +0 -268
- package/src/middleware/index.ts +0 -117
- package/src/middleware/input_validation.ts +0 -449
- package/src/middleware/json_body.ts +0 -37
- package/src/middleware/performance_alerting.ts +0 -538
- package/src/middleware/performance_dashboard.ts +0 -661
- package/src/middleware/performance_monitor.ts +0 -943
- package/src/middleware/pipeline.ts +0 -489
- package/src/middleware/rate_limit.ts +0 -245
- package/src/middleware/request_id.ts +0 -36
- package/src/middleware/request_signing.ts +0 -636
- package/src/middleware/request_tracer.ts +0 -636
- package/src/middleware/response_cache.ts +0 -743
- package/src/middleware/security.ts +0 -482
- package/src/middleware/security_suite.ts +0 -257
- package/src/middleware/session.ts +0 -91
- package/src/model-binding/index.ts +0 -18
- package/src/model-binding/model-middleware.ts +0 -425
- package/src/model-binding/model-registry.ts +0 -550
- package/src/model-binding.ts +0 -370
- package/src/model-resolver-factory.ts +0 -106
- package/src/observability/correlation.ts +0 -691
- package/src/observability/health-checks.ts +0 -729
- package/src/observability/index.ts +0 -184
- package/src/observability/integration.ts +0 -548
- package/src/observability/metrics.ts +0 -753
- package/src/observability/tracing.ts +0 -638
- package/src/optimization/bun-utilities.ts +0 -778
- package/src/query-builder-integration.ts +0 -137
- package/src/request/context.ts +0 -62
- package/src/request/enhanced-request.ts +0 -857
- package/src/request/macros.ts +0 -688
- package/src/response/macros.ts +0 -612
- package/src/response/response-factory.ts +0 -596
- package/src/router/api-routes.ts +0 -243
- package/src/router/file-based-routing.ts +0 -670
- package/src/router/file-streaming.ts +0 -372
- package/src/router/fluent-router.ts +0 -927
- package/src/router/fluent-routing.ts +0 -797
- package/src/router/group-organization.ts +0 -213
- package/src/router/handler-resolver.ts +0 -291
- package/src/router/http-methods.ts +0 -377
- package/src/router/index.ts +0 -187
- package/src/router/middleware-groups.ts +0 -222
- package/src/router/middleware-integration.ts +0 -399
- package/src/router/middleware.ts +0 -231
- package/src/router/model-binding.ts +0 -215
- package/src/router/optimized-route-matching.ts +0 -253
- package/src/router/route-building.ts +0 -212
- package/src/router/route-compiler.ts +0 -702
- package/src/router/route-matching.ts +0 -349
- package/src/router/route-trie.ts +0 -464
- package/src/router/router.ts +0 -1581
- package/src/router/server.ts +0 -462
- package/src/router/validation-integration.ts +0 -443
- package/src/router/view-rendering.ts +0 -233
- package/src/router/websocket.ts +0 -100
- package/src/routing/route-caching.ts +0 -402
- package/src/routing/route-throttling.ts +0 -469
- package/src/routing/subdomain-routing.ts +0 -492
- package/src/session/database-store.ts +0 -109
- package/src/session/file-store.ts +0 -148
- package/src/session/index.ts +0 -244
- package/src/session/memory-store.ts +0 -88
- package/src/session/redis-store.ts +0 -93
- package/src/streaming/index.ts +0 -17
- package/src/streaming/sse-handler.ts +0 -482
- package/src/streaming/stream-handler.ts +0 -552
- package/src/testing/auth-testing.ts +0 -446
- package/src/testing/file-upload-testing.ts +0 -543
- package/src/testing/index.ts +0 -10
- package/src/testing/middleware-testing.ts +0 -322
- package/src/testing/model-binding-testing.ts +0 -645
- package/src/testing/performance-testing.ts +0 -738
- package/src/testing/test-client.ts +0 -310
- package/src/testing/test-request.ts +0 -315
- package/src/testing/test-response.ts +0 -332
- package/src/testing/types.ts +0 -224
- package/src/testing/websocket-testing.ts +0 -590
- package/src/types/controller-types.ts +0 -385
- package/src/types/core.ts +0 -683
- package/src/types/middleware-types.ts +0 -419
- package/src/types/request-response-augmentation.ts +0 -489
- package/src/types/route-inference.ts +0 -357
- package/src/types.ts +0 -2055
- package/src/url.ts +0 -126
- package/src/utils/index.ts +0 -1
- package/src/utils/query-preservation.ts +0 -201
- package/src/utils.ts +0 -327
- package/src/validation/validator.ts +0 -685
- package/src/websocket/clustering.ts +0 -762
|
@@ -1,661 +0,0 @@
|
|
|
1
|
-
import type { EnhancedRequest, NextFunction } from '../types'
|
|
2
|
-
import type { TraceSpan } from './request_tracer'
|
|
3
|
-
import process from 'node:process'
|
|
4
|
-
|
|
5
|
-
export interface DashboardOptions {
|
|
6
|
-
enabled?: boolean
|
|
7
|
-
path?: string
|
|
8
|
-
title?: string
|
|
9
|
-
refreshInterval?: number
|
|
10
|
-
maxMetrics?: number
|
|
11
|
-
authentication?: {
|
|
12
|
-
enabled?: boolean
|
|
13
|
-
username?: string
|
|
14
|
-
password?: string
|
|
15
|
-
apiKey?: string
|
|
16
|
-
}
|
|
17
|
-
features?: {
|
|
18
|
-
realTimeMetrics?: boolean
|
|
19
|
-
historicalCharts?: boolean
|
|
20
|
-
alertsPanel?: boolean
|
|
21
|
-
tracingView?: boolean
|
|
22
|
-
systemMetrics?: boolean
|
|
23
|
-
}
|
|
24
|
-
}
|
|
25
|
-
|
|
26
|
-
export interface DashboardData {
|
|
27
|
-
metrics: {
|
|
28
|
-
current: {
|
|
29
|
-
totalRequests: number
|
|
30
|
-
averageResponseTime: number
|
|
31
|
-
errorRate: number
|
|
32
|
-
requestsPerSecond: number
|
|
33
|
-
memoryUsage: number
|
|
34
|
-
cpuUsage: number
|
|
35
|
-
}
|
|
36
|
-
historical: Array<{
|
|
37
|
-
timestamp: number
|
|
38
|
-
responseTime: number
|
|
39
|
-
memoryUsage: number
|
|
40
|
-
requestCount: number
|
|
41
|
-
errorCount: number
|
|
42
|
-
}>
|
|
43
|
-
distribution: {
|
|
44
|
-
statusCodes: Record<number, number>
|
|
45
|
-
paths: Record<string, number>
|
|
46
|
-
methods: Record<string, number>
|
|
47
|
-
responseTimes: Array<{ range: string, count: number }>
|
|
48
|
-
}
|
|
49
|
-
}
|
|
50
|
-
alerts: Array<{
|
|
51
|
-
id: string
|
|
52
|
-
type: 'warning' | 'critical'
|
|
53
|
-
message: string
|
|
54
|
-
timestamp: number
|
|
55
|
-
resolved: boolean
|
|
56
|
-
}>
|
|
57
|
-
traces: TraceSpan[]
|
|
58
|
-
system: {
|
|
59
|
-
uptime: number
|
|
60
|
-
nodeVersion: string
|
|
61
|
-
bunVersion: string
|
|
62
|
-
platform: string
|
|
63
|
-
arch: string
|
|
64
|
-
memory: NodeJS.MemoryUsage
|
|
65
|
-
cpu: NodeJS.CpuUsage
|
|
66
|
-
}
|
|
67
|
-
}
|
|
68
|
-
|
|
69
|
-
export default class PerformanceDashboard {
|
|
70
|
-
private options: DashboardOptions
|
|
71
|
-
private metricsHistory: Array<{
|
|
72
|
-
timestamp: number
|
|
73
|
-
responseTime: number
|
|
74
|
-
memoryUsage: number
|
|
75
|
-
requestCount: number
|
|
76
|
-
errorCount: number
|
|
77
|
-
}> = []
|
|
78
|
-
|
|
79
|
-
private alerts: Array<{
|
|
80
|
-
id: string
|
|
81
|
-
type: 'warning' | 'critical'
|
|
82
|
-
message: string
|
|
83
|
-
timestamp: number
|
|
84
|
-
resolved: boolean
|
|
85
|
-
}> = []
|
|
86
|
-
|
|
87
|
-
private startTime: number = Date.now()
|
|
88
|
-
|
|
89
|
-
constructor(options: DashboardOptions = {}) {
|
|
90
|
-
this.options = {
|
|
91
|
-
enabled: options.enabled ?? true,
|
|
92
|
-
path: options.path ?? '/performance',
|
|
93
|
-
title: options.title ?? 'Performance Dashboard',
|
|
94
|
-
refreshInterval: options.refreshInterval ?? 5000,
|
|
95
|
-
maxMetrics: options.maxMetrics ?? 1000,
|
|
96
|
-
authentication: {
|
|
97
|
-
enabled: false,
|
|
98
|
-
...options.authentication,
|
|
99
|
-
},
|
|
100
|
-
features: {
|
|
101
|
-
realTimeMetrics: true,
|
|
102
|
-
historicalCharts: true,
|
|
103
|
-
alertsPanel: true,
|
|
104
|
-
tracingView: true,
|
|
105
|
-
systemMetrics: true,
|
|
106
|
-
...options.features,
|
|
107
|
-
},
|
|
108
|
-
}
|
|
109
|
-
}
|
|
110
|
-
|
|
111
|
-
private isAuthenticated(req: EnhancedRequest): boolean {
|
|
112
|
-
if (!this.options.authentication?.enabled)
|
|
113
|
-
return true
|
|
114
|
-
|
|
115
|
-
const auth = req.headers.get('authorization')
|
|
116
|
-
const apiKey = req.headers.get('x-api-key')
|
|
117
|
-
|
|
118
|
-
if (this.options.authentication.apiKey && apiKey === this.options.authentication.apiKey) {
|
|
119
|
-
return true
|
|
120
|
-
}
|
|
121
|
-
|
|
122
|
-
if (auth && this.options.authentication.username && this.options.authentication.password) {
|
|
123
|
-
const [type, credentials] = auth.split(' ')
|
|
124
|
-
if (type === 'Basic') {
|
|
125
|
-
const decoded = atob(credentials)
|
|
126
|
-
const [username, password] = decoded.split(':')
|
|
127
|
-
return username === this.options.authentication.username
|
|
128
|
-
&& password === this.options.authentication.password
|
|
129
|
-
}
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
return false
|
|
133
|
-
}
|
|
134
|
-
|
|
135
|
-
private generateDashboardHTML(data: DashboardData): string {
|
|
136
|
-
return `
|
|
137
|
-
<!DOCTYPE html>
|
|
138
|
-
<html lang="en">
|
|
139
|
-
<head>
|
|
140
|
-
<meta charset="UTF-8">
|
|
141
|
-
<meta name='viewport' content='width=device-width, initial-scale=1.0'>
|
|
142
|
-
<title>${this.options.title}</title>
|
|
143
|
-
<style>
|
|
144
|
-
* { margin: 0; padding: 0; box-sizing: border-box; }
|
|
145
|
-
body {
|
|
146
|
-
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
|
|
147
|
-
background: #f5f5f5;
|
|
148
|
-
color: #333;
|
|
149
|
-
line-height: 1.6;
|
|
150
|
-
}
|
|
151
|
-
.header {
|
|
152
|
-
background: #2c3e50;
|
|
153
|
-
color: white;
|
|
154
|
-
padding: 1rem 2rem;
|
|
155
|
-
display: flex;
|
|
156
|
-
justify-content: space-between;
|
|
157
|
-
align-items: center;
|
|
158
|
-
}
|
|
159
|
-
.header h1 { font-size: 1.5rem; }
|
|
160
|
-
.status {
|
|
161
|
-
display: flex;
|
|
162
|
-
gap: 1rem;
|
|
163
|
-
align-items: center;
|
|
164
|
-
}
|
|
165
|
-
.status-item {
|
|
166
|
-
display: flex;
|
|
167
|
-
flex-direction: column;
|
|
168
|
-
align-items: center;
|
|
169
|
-
font-size: 0.8rem;
|
|
170
|
-
}
|
|
171
|
-
.status-value {
|
|
172
|
-
font-size: 1.2rem;
|
|
173
|
-
font-weight: bold;
|
|
174
|
-
}
|
|
175
|
-
.container {
|
|
176
|
-
max-width: 1400px;
|
|
177
|
-
margin: 0 auto;
|
|
178
|
-
padding: 2rem;
|
|
179
|
-
display: grid;
|
|
180
|
-
grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
|
|
181
|
-
gap: 2rem;
|
|
182
|
-
}
|
|
183
|
-
.card {
|
|
184
|
-
background: white;
|
|
185
|
-
border-radius: 8px;
|
|
186
|
-
padding: 1.5rem;
|
|
187
|
-
box-shadow: 0 2px 4px rgba(0,0,0,0.1);
|
|
188
|
-
}
|
|
189
|
-
.card h2 {
|
|
190
|
-
margin-bottom: 1rem;
|
|
191
|
-
color: #2c3e50;
|
|
192
|
-
font-size: 1.2rem;
|
|
193
|
-
}
|
|
194
|
-
.metric {
|
|
195
|
-
display: flex;
|
|
196
|
-
justify-content: space-between;
|
|
197
|
-
align-items: center;
|
|
198
|
-
padding: 0.5rem 0;
|
|
199
|
-
border-bottom: 1px solid #eee;
|
|
200
|
-
}
|
|
201
|
-
.metric:last-child { border-bottom: none; }
|
|
202
|
-
.metric-label { font-weight: 500; }
|
|
203
|
-
.metric-value {
|
|
204
|
-
font-weight: bold;
|
|
205
|
-
color: #27ae60;
|
|
206
|
-
}
|
|
207
|
-
.metric-value.warning { color: #f39c12; }
|
|
208
|
-
.metric-value.critical { color: #e74c3c; }
|
|
209
|
-
.alert {
|
|
210
|
-
padding: 0.75rem;
|
|
211
|
-
margin: 0.5rem 0;
|
|
212
|
-
border-radius: 4px;
|
|
213
|
-
border-left: 4px solid;
|
|
214
|
-
}
|
|
215
|
-
.alert.warning {
|
|
216
|
-
background: #fff3cd;
|
|
217
|
-
border-color: #f39c12;
|
|
218
|
-
color: #856404;
|
|
219
|
-
}
|
|
220
|
-
.alert.critical {
|
|
221
|
-
background: #f8d7da;
|
|
222
|
-
border-color: #e74c3c;
|
|
223
|
-
color: #721c24;
|
|
224
|
-
}
|
|
225
|
-
.chart-container {
|
|
226
|
-
height: 200px;
|
|
227
|
-
background: #f8f9fa;
|
|
228
|
-
border-radius: 4px;
|
|
229
|
-
display: flex;
|
|
230
|
-
align-items: center;
|
|
231
|
-
justify-content: center;
|
|
232
|
-
color: #666;
|
|
233
|
-
}
|
|
234
|
-
.distribution {
|
|
235
|
-
display: grid;
|
|
236
|
-
grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
|
|
237
|
-
gap: 1rem;
|
|
238
|
-
margin-top: 1rem;
|
|
239
|
-
}
|
|
240
|
-
.distribution-item {
|
|
241
|
-
text-align: center;
|
|
242
|
-
padding: 1rem;
|
|
243
|
-
background: #f8f9fa;
|
|
244
|
-
border-radius: 4px;
|
|
245
|
-
}
|
|
246
|
-
.distribution-value {
|
|
247
|
-
font-size: 1.5rem;
|
|
248
|
-
font-weight: bold;
|
|
249
|
-
color: #2c3e50;
|
|
250
|
-
}
|
|
251
|
-
.distribution-label {
|
|
252
|
-
font-size: 0.8rem;
|
|
253
|
-
color: #666;
|
|
254
|
-
margin-top: 0.5rem;
|
|
255
|
-
}
|
|
256
|
-
.trace {
|
|
257
|
-
padding: 0.75rem;
|
|
258
|
-
margin: 0.5rem 0;
|
|
259
|
-
background: #f8f9fa;
|
|
260
|
-
border-radius: 4px;
|
|
261
|
-
border-left: 4px solid #3498db;
|
|
262
|
-
}
|
|
263
|
-
.trace-header {
|
|
264
|
-
display: flex;
|
|
265
|
-
justify-content: space-between;
|
|
266
|
-
align-items: center;
|
|
267
|
-
margin-bottom: 0.5rem;
|
|
268
|
-
}
|
|
269
|
-
.trace-operation {
|
|
270
|
-
font-weight: bold;
|
|
271
|
-
color: #2c3e50;
|
|
272
|
-
}
|
|
273
|
-
.trace-duration {
|
|
274
|
-
color: #666;
|
|
275
|
-
font-size: 0.9rem;
|
|
276
|
-
}
|
|
277
|
-
.trace-details {
|
|
278
|
-
font-size: 0.8rem;
|
|
279
|
-
color: #666;
|
|
280
|
-
}
|
|
281
|
-
.refresh-indicator {
|
|
282
|
-
position: fixed;
|
|
283
|
-
top: 1rem;
|
|
284
|
-
right: 1rem;
|
|
285
|
-
background: #27ae60;
|
|
286
|
-
color: white;
|
|
287
|
-
padding: 0.5rem 1rem;
|
|
288
|
-
border-radius: 4px;
|
|
289
|
-
font-size: 0.8rem;
|
|
290
|
-
opacity: 0;
|
|
291
|
-
transition: opacity 0.3s;
|
|
292
|
-
}
|
|
293
|
-
.refresh-indicator.active { opacity: 1; }
|
|
294
|
-
@media (max-width: 768px) {
|
|
295
|
-
.container {
|
|
296
|
-
grid-template-columns: 1fr;
|
|
297
|
-
padding: 1rem;
|
|
298
|
-
}
|
|
299
|
-
.header {
|
|
300
|
-
padding: 1rem;
|
|
301
|
-
flex-direction: column;
|
|
302
|
-
gap: 1rem;
|
|
303
|
-
}
|
|
304
|
-
}
|
|
305
|
-
</style>
|
|
306
|
-
</head>
|
|
307
|
-
<body>
|
|
308
|
-
<div class='header'>
|
|
309
|
-
<h1>${this.options.title}</h1>
|
|
310
|
-
<div class='status'>
|
|
311
|
-
<div class='status-item'>
|
|
312
|
-
<div class='status-value'>${data.metrics.current.totalRequests}</div>
|
|
313
|
-
<div>Total Requests</div>
|
|
314
|
-
</div>
|
|
315
|
-
<div class='status-item'>
|
|
316
|
-
<div class='status-value'>${Math.round(data.metrics.current.averageResponseTime)}ms</div>
|
|
317
|
-
<div>Avg Response</div>
|
|
318
|
-
</div>
|
|
319
|
-
<div class='status-item'>
|
|
320
|
-
<div class='status-value'>${Math.round(data.metrics.current.errorRate * 100)}%</div>
|
|
321
|
-
<div>Error Rate</div>
|
|
322
|
-
</div>
|
|
323
|
-
<div class='status-item'>
|
|
324
|
-
<div class='status-value'>${Math.round(data.metrics.current.requestsPerSecond)}/s</div>
|
|
325
|
-
<div>Requests/sec</div>
|
|
326
|
-
</div>
|
|
327
|
-
</div>
|
|
328
|
-
</div>
|
|
329
|
-
|
|
330
|
-
<div class='container'>
|
|
331
|
-
${this.options.features?.realTimeMetrics
|
|
332
|
-
? `
|
|
333
|
-
<div class='card'>
|
|
334
|
-
<h2>Real-time Metrics</h2>
|
|
335
|
-
<div class='metric'>
|
|
336
|
-
<span class='metric-label'>Response Time</span>
|
|
337
|
-
<span class='metric-value'>${Math.round(data.metrics.current.averageResponseTime)}ms</span>
|
|
338
|
-
</div>
|
|
339
|
-
<div class='metric'>
|
|
340
|
-
<span class='metric-label'>Memory Usage</span>
|
|
341
|
-
<span class='metric-value'>${Math.round(data.metrics.current.memoryUsage / 1024 / 1024)}MB</span>
|
|
342
|
-
</div>
|
|
343
|
-
<div class='metric'>
|
|
344
|
-
<span class='metric-label'>CPU Usage</span>
|
|
345
|
-
<span class='metric-value'>${Math.round(data.metrics.current.cpuUsage)}%</span>
|
|
346
|
-
</div>
|
|
347
|
-
<div class='metric'>
|
|
348
|
-
<span class='metric-label'>Requests/sec</span>
|
|
349
|
-
<span class='metric-value'>${Math.round(data.metrics.current.requestsPerSecond)}</span>
|
|
350
|
-
</div>
|
|
351
|
-
<div class='metric'>
|
|
352
|
-
<span class='metric-label'>Error Rate</span>
|
|
353
|
-
<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>
|
|
354
|
-
</div>
|
|
355
|
-
</div>
|
|
356
|
-
`
|
|
357
|
-
: ''}
|
|
358
|
-
|
|
359
|
-
${this.options.features?.historicalCharts
|
|
360
|
-
? `
|
|
361
|
-
<div class='card'>
|
|
362
|
-
<h2>Historical Performance</h2>
|
|
363
|
-
<div class='chart-container'>
|
|
364
|
-
Response Time Chart (${data.metrics.historical.length} data points)
|
|
365
|
-
</div>
|
|
366
|
-
</div>
|
|
367
|
-
`
|
|
368
|
-
: ''}
|
|
369
|
-
|
|
370
|
-
<div class='card'>
|
|
371
|
-
<h2>Request Distribution</h2>
|
|
372
|
-
<div class='distribution'>
|
|
373
|
-
${Object.entries(data.metrics.distribution.statusCodes).map(([code, count]) => `
|
|
374
|
-
<div class='distribution-item'>
|
|
375
|
-
<div class='distribution-value'>${count}</div>
|
|
376
|
-
<div class='distribution-label'>HTTP ${code}</div>
|
|
377
|
-
</div>
|
|
378
|
-
`).join('')}
|
|
379
|
-
</div>
|
|
380
|
-
</div>
|
|
381
|
-
|
|
382
|
-
<div class='card'>
|
|
383
|
-
<h2>Top Endpoints</h2>
|
|
384
|
-
${Object.entries(data.metrics.distribution.paths)
|
|
385
|
-
.sort(([,a], [,b]) => b - a)
|
|
386
|
-
.slice(0, 10)
|
|
387
|
-
.map(([path, count]) => `
|
|
388
|
-
<div class='metric'>
|
|
389
|
-
<span class='metric-label'>${path}</span>
|
|
390
|
-
<span class='metric-value'>${count}</span>
|
|
391
|
-
</div>
|
|
392
|
-
`)
|
|
393
|
-
.join('')}
|
|
394
|
-
</div>
|
|
395
|
-
|
|
396
|
-
${this.options.features?.alertsPanel
|
|
397
|
-
? `
|
|
398
|
-
<div class='card'>
|
|
399
|
-
<h2>Active Alerts</h2>
|
|
400
|
-
${data.alerts.length === 0 ? '<p>No active alerts</p>' : ''}
|
|
401
|
-
${data.alerts.filter(alert => !alert.resolved).map(alert => `
|
|
402
|
-
<div class='${alert.type} alert'>
|
|
403
|
-
<strong>${alert.type.toUpperCase()}:</strong> ${alert.message}
|
|
404
|
-
<br><small>${new Date(alert.timestamp).toLocaleString()}</small>
|
|
405
|
-
</div>
|
|
406
|
-
`).join('')}
|
|
407
|
-
</div>
|
|
408
|
-
`
|
|
409
|
-
: ''}
|
|
410
|
-
|
|
411
|
-
${this.options.features?.tracingView
|
|
412
|
-
? `
|
|
413
|
-
<div class='card'>
|
|
414
|
-
<h2>Recent Traces</h2>
|
|
415
|
-
${data.traces.slice(0, 10).map(trace => `
|
|
416
|
-
<div class='trace'>
|
|
417
|
-
<div class='trace-header'>
|
|
418
|
-
<span class='trace-operation'>${trace.operationName}</span>
|
|
419
|
-
<span class='trace-duration'>${Math.round((trace.duration || 0) * 100) / 100}ms</span>
|
|
420
|
-
</div>
|
|
421
|
-
<div class='trace-details'>
|
|
422
|
-
Trace ID: ${trace.traceId} | Status: ${trace.status}
|
|
423
|
-
${trace.error ? ` | Error: ${trace.error}` : ''}
|
|
424
|
-
</div>
|
|
425
|
-
</div>
|
|
426
|
-
`).join('')}
|
|
427
|
-
</div>
|
|
428
|
-
`
|
|
429
|
-
: ''}
|
|
430
|
-
|
|
431
|
-
${this.options.features?.systemMetrics
|
|
432
|
-
? `
|
|
433
|
-
<div class='card'>
|
|
434
|
-
<h2>System Information</h2>
|
|
435
|
-
<div class='metric'>
|
|
436
|
-
<span class='metric-label'>Uptime</span>
|
|
437
|
-
<span class='metric-value'>${Math.round(data.system.uptime / 1000 / 60)} minutes</span>
|
|
438
|
-
</div>
|
|
439
|
-
<div class='metric'>
|
|
440
|
-
<span class='metric-label'>Node.js</span>
|
|
441
|
-
<span class='metric-value'>${data.system.nodeVersion}</span>
|
|
442
|
-
</div>
|
|
443
|
-
<div class='metric'>
|
|
444
|
-
<span class='metric-label'>Platform</span>
|
|
445
|
-
<span class='metric-value'>${data.system.platform} ${data.system.arch}</span>
|
|
446
|
-
</div>
|
|
447
|
-
<div class='metric'>
|
|
448
|
-
<span class='metric-label'>Heap Used</span>
|
|
449
|
-
<span class='metric-value'>${Math.round(data.system.memory.heapUsed / 1024 / 1024)}MB</span>
|
|
450
|
-
</div>
|
|
451
|
-
<div class='metric'>
|
|
452
|
-
<span class='metric-label'>RSS</span>
|
|
453
|
-
<span class='metric-value'>${Math.round(data.system.memory.rss / 1024 / 1024)}MB</span>
|
|
454
|
-
</div>
|
|
455
|
-
</div>
|
|
456
|
-
`
|
|
457
|
-
: ''}
|
|
458
|
-
</div>
|
|
459
|
-
|
|
460
|
-
<div class='refresh-indicator' id='refreshIndicator'>Updated</div>
|
|
461
|
-
|
|
462
|
-
<script>
|
|
463
|
-
let refreshInterval;
|
|
464
|
-
|
|
465
|
-
function startAutoRefresh() {
|
|
466
|
-
refreshInterval = setInterval(async () => {
|
|
467
|
-
try {
|
|
468
|
-
const response = await fetch('${this.options.path}/api/data');
|
|
469
|
-
if (response.ok) {
|
|
470
|
-
const indicator = document.getElementById('refreshIndicator');
|
|
471
|
-
indicator.classList.add('active');
|
|
472
|
-
setTimeout(() => indicator.classList.remove('active'), 1000);
|
|
473
|
-
|
|
474
|
-
// In a real implementation, we would update the DOM with new data
|
|
475
|
-
// For now, we'll just refresh the page
|
|
476
|
-
setTimeout(() => window.location.reload(), ${this.options.refreshInterval});
|
|
477
|
-
}
|
|
478
|
-
}
|
|
479
|
-
catch (error) {
|
|
480
|
-
console.error('Failed to refresh data:', error);
|
|
481
|
-
}
|
|
482
|
-
}, ${this.options.refreshInterval});
|
|
483
|
-
}
|
|
484
|
-
|
|
485
|
-
// Start auto-refresh
|
|
486
|
-
startAutoRefresh();
|
|
487
|
-
|
|
488
|
-
// Stop refresh when page is hidden
|
|
489
|
-
document.addEventListener('visibilitychange', () => {
|
|
490
|
-
if (document.hidden) {
|
|
491
|
-
clearInterval(refreshInterval);
|
|
492
|
-
}
|
|
493
|
-
else {
|
|
494
|
-
startAutoRefresh();
|
|
495
|
-
}
|
|
496
|
-
});
|
|
497
|
-
</script>
|
|
498
|
-
</body>
|
|
499
|
-
</html>
|
|
500
|
-
`
|
|
501
|
-
}
|
|
502
|
-
|
|
503
|
-
private async getDashboardData(
|
|
504
|
-
performanceMonitor?: any,
|
|
505
|
-
requestTracer?: any,
|
|
506
|
-
): Promise<DashboardData> {
|
|
507
|
-
const now = Date.now()
|
|
508
|
-
|
|
509
|
-
// Get metrics from performance monitor if available
|
|
510
|
-
const metrics = {
|
|
511
|
-
current: {
|
|
512
|
-
totalRequests: 0,
|
|
513
|
-
averageResponseTime: 0,
|
|
514
|
-
errorRate: 0,
|
|
515
|
-
requestsPerSecond: 0,
|
|
516
|
-
memoryUsage: 0,
|
|
517
|
-
cpuUsage: 0,
|
|
518
|
-
},
|
|
519
|
-
historical: this.metricsHistory,
|
|
520
|
-
distribution: {
|
|
521
|
-
statusCodes: {} as Record<number, number>,
|
|
522
|
-
paths: {} as Record<string, number>,
|
|
523
|
-
methods: {} as Record<string, number>,
|
|
524
|
-
responseTimes: [] as Array<{ range: string, count: number }>,
|
|
525
|
-
},
|
|
526
|
-
}
|
|
527
|
-
|
|
528
|
-
if (performanceMonitor && typeof performanceMonitor.getAggregatedMetrics === 'function') {
|
|
529
|
-
const aggregated = performanceMonitor.getAggregatedMetrics(60000) // Last minute
|
|
530
|
-
metrics.current = {
|
|
531
|
-
totalRequests: aggregated.totalRequests,
|
|
532
|
-
averageResponseTime: aggregated.averageResponseTime,
|
|
533
|
-
errorRate: aggregated.errorRate,
|
|
534
|
-
requestsPerSecond: aggregated.requestsPerSecond,
|
|
535
|
-
memoryUsage: aggregated.averageMemoryUsage,
|
|
536
|
-
cpuUsage: 0, // Would need CPU monitoring
|
|
537
|
-
}
|
|
538
|
-
metrics.distribution.statusCodes = aggregated.statusCodeDistribution
|
|
539
|
-
metrics.distribution.paths = aggregated.pathDistribution
|
|
540
|
-
}
|
|
541
|
-
|
|
542
|
-
// Get traces from request tracer if available
|
|
543
|
-
let traces: TraceSpan[] = []
|
|
544
|
-
if (requestTracer && typeof requestTracer.getActiveSpans === 'function') {
|
|
545
|
-
traces = requestTracer.getActiveSpans()
|
|
546
|
-
}
|
|
547
|
-
|
|
548
|
-
// System information
|
|
549
|
-
const system = {
|
|
550
|
-
uptime: now - this.startTime,
|
|
551
|
-
nodeVersion: process.version,
|
|
552
|
-
bunVersion: process.versions.bun || 'N/A',
|
|
553
|
-
platform: process.platform,
|
|
554
|
-
arch: process.arch,
|
|
555
|
-
memory: process.memoryUsage(),
|
|
556
|
-
cpu: process.cpuUsage(),
|
|
557
|
-
}
|
|
558
|
-
|
|
559
|
-
return {
|
|
560
|
-
metrics,
|
|
561
|
-
alerts: this.alerts,
|
|
562
|
-
traces,
|
|
563
|
-
system,
|
|
564
|
-
}
|
|
565
|
-
}
|
|
566
|
-
|
|
567
|
-
async handle(req: EnhancedRequest, next: NextFunction): Promise<Response | null> {
|
|
568
|
-
if (!this.options.enabled) {
|
|
569
|
-
const response = await next()
|
|
570
|
-
return response || new Response('Internal Server Error', { status: 500 })
|
|
571
|
-
}
|
|
572
|
-
|
|
573
|
-
const url = new URL(req.url)
|
|
574
|
-
|
|
575
|
-
// Check if this is a dashboard request
|
|
576
|
-
if (url.pathname === this.options.path) {
|
|
577
|
-
if (!this.isAuthenticated(req)) {
|
|
578
|
-
return new Response('Unauthorized', {
|
|
579
|
-
status: 401,
|
|
580
|
-
headers: {
|
|
581
|
-
'WWW-Authenticate': 'Basic realm="Performance Dashboard"',
|
|
582
|
-
},
|
|
583
|
-
})
|
|
584
|
-
}
|
|
585
|
-
|
|
586
|
-
const data = await this.getDashboardData()
|
|
587
|
-
const html = this.generateDashboardHTML(data)
|
|
588
|
-
|
|
589
|
-
return new Response(html, {
|
|
590
|
-
headers: {
|
|
591
|
-
'Content-Type': 'text/html',
|
|
592
|
-
'Cache-Control': 'no-cache, no-store, must-revalidate',
|
|
593
|
-
},
|
|
594
|
-
})
|
|
595
|
-
}
|
|
596
|
-
|
|
597
|
-
// API endpoint for dashboard data
|
|
598
|
-
if (url.pathname === `${this.options.path}/api/data`) {
|
|
599
|
-
if (!this.isAuthenticated(req)) {
|
|
600
|
-
return new Response('Unauthorized', { status: 401 })
|
|
601
|
-
}
|
|
602
|
-
|
|
603
|
-
const data = await this.getDashboardData()
|
|
604
|
-
|
|
605
|
-
return new Response(JSON.stringify(data), {
|
|
606
|
-
headers: {
|
|
607
|
-
'Content-Type': 'application/json',
|
|
608
|
-
'Cache-Control': 'no-cache, no-store, must-revalidate',
|
|
609
|
-
},
|
|
610
|
-
})
|
|
611
|
-
}
|
|
612
|
-
|
|
613
|
-
return await next()
|
|
614
|
-
}
|
|
615
|
-
|
|
616
|
-
addAlert(type: 'warning' | 'critical', message: string): void {
|
|
617
|
-
this.alerts.push({
|
|
618
|
-
id: Math.random().toString(36).substring(2, 15),
|
|
619
|
-
type,
|
|
620
|
-
message,
|
|
621
|
-
timestamp: Date.now(),
|
|
622
|
-
resolved: false,
|
|
623
|
-
})
|
|
624
|
-
|
|
625
|
-
// Keep only recent alerts
|
|
626
|
-
if (this.alerts.length > 100) {
|
|
627
|
-
this.alerts = this.alerts.slice(-100)
|
|
628
|
-
}
|
|
629
|
-
}
|
|
630
|
-
|
|
631
|
-
resolveAlert(id: string): void {
|
|
632
|
-
const alert = this.alerts.find(a => a.id === id)
|
|
633
|
-
if (alert) {
|
|
634
|
-
alert.resolved = true
|
|
635
|
-
}
|
|
636
|
-
}
|
|
637
|
-
|
|
638
|
-
updateMetricsHistory(data: {
|
|
639
|
-
responseTime: number
|
|
640
|
-
memoryUsage: number
|
|
641
|
-
requestCount: number
|
|
642
|
-
errorCount: number
|
|
643
|
-
}): void {
|
|
644
|
-
this.metricsHistory.push({
|
|
645
|
-
timestamp: Date.now(),
|
|
646
|
-
...data,
|
|
647
|
-
})
|
|
648
|
-
|
|
649
|
-
// Keep only recent history
|
|
650
|
-
const maxEntries = this.options.maxMetrics || 1000
|
|
651
|
-
if (this.metricsHistory.length > maxEntries) {
|
|
652
|
-
this.metricsHistory = this.metricsHistory.slice(-maxEntries)
|
|
653
|
-
}
|
|
654
|
-
}
|
|
655
|
-
}
|
|
656
|
-
|
|
657
|
-
// Factory function for easy use
|
|
658
|
-
export function performanceDashboard(options: DashboardOptions = {}): (req: EnhancedRequest, next: NextFunction) => Promise<Response | null> {
|
|
659
|
-
const instance = new PerformanceDashboard(options)
|
|
660
|
-
return async (req: EnhancedRequest, next: NextFunction) => instance.handle(req, next)
|
|
661
|
-
}
|