@stacksjs/bun-router 0.0.12 → 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.
Files changed (273) hide show
  1. package/CHANGELOG.md +770 -0
  2. package/README.md +584 -261
  3. package/package.json +43 -48
  4. package/bin/cli.ts +0 -9
  5. package/dist/auth.d.ts +0 -134
  6. package/dist/cache/lru-cache.d.ts +0 -139
  7. package/dist/cache/middleware-memoization.d.ts +0 -151
  8. package/dist/cache/route-cache-warmer.d.ts +0 -161
  9. package/dist/cache/sqlite-cache.d.ts +0 -209
  10. package/dist/cache/streaming-cache.d.ts +0 -132
  11. package/dist/chunk-1mvtv6jw.js +0 -13012
  12. package/dist/cli/colors.d.ts +0 -15
  13. package/dist/cli/index.d.ts +0 -10
  14. package/dist/cli/middleware.d.ts +0 -31
  15. package/dist/cli/openapi.d.ts +0 -17
  16. package/dist/cli/router.d.ts +0 -15
  17. package/dist/cli/routes.d.ts +0 -29
  18. package/dist/cli/utils.d.ts +0 -74
  19. package/dist/cli.d.ts +0 -1
  20. package/dist/cli.js +0 -3195
  21. package/dist/config.d.ts +0 -7
  22. package/dist/container/container.d.ts +0 -273
  23. package/dist/container/contextual-binding.d.ts +0 -240
  24. package/dist/container/decorators.d.ts +0 -141
  25. package/dist/container/service-provider.d.ts +0 -285
  26. package/dist/development/hot-reload.d.ts +0 -187
  27. package/dist/development/index.d.ts +0 -167
  28. package/dist/development/performance-profiler.d.ts +0 -217
  29. package/dist/development/route-debugger.d.ts +0 -154
  30. package/dist/development/route-inspector.d.ts +0 -211
  31. package/dist/development/typescript-utilities.d.ts +0 -209
  32. package/dist/docs.d.ts +0 -11
  33. package/dist/errors/circuit-breaker.d.ts +0 -195
  34. package/dist/errors/error-handler.d.ts +0 -88
  35. package/dist/errors/error-reporting.d.ts +0 -144
  36. package/dist/errors/exceptions.d.ts +0 -184
  37. package/dist/errors/graceful-degradation.d.ts +0 -154
  38. package/dist/errors/index.d.ts +0 -9
  39. package/dist/errors/router-errors.d.ts +0 -110
  40. package/dist/file-serving/static-files.d.ts +0 -143
  41. package/dist/index.d.ts +0 -14
  42. package/dist/index.js +0 -13933
  43. package/dist/middleware/auth.d.ts +0 -63
  44. package/dist/middleware/content_security_policy.d.ts +0 -53
  45. package/dist/middleware/cors.d.ts +0 -5
  46. package/dist/middleware/csrf.d.ts +0 -7
  47. package/dist/middleware/ddos_protection.d.ts +0 -39
  48. package/dist/middleware/file_security.d.ts +0 -26
  49. package/dist/middleware/file_upload.d.ts +0 -38
  50. package/dist/middleware/helmet.d.ts +0 -54
  51. package/dist/middleware/index.d.ts +0 -44
  52. package/dist/middleware/input_validation.d.ts +0 -45
  53. package/dist/middleware/json_body.d.ts +0 -4
  54. package/dist/middleware/performance_alerting.d.ts +0 -87
  55. package/dist/middleware/performance_dashboard.d.ts +0 -87
  56. package/dist/middleware/performance_monitor.d.ts +0 -209
  57. package/dist/middleware/pipeline.d.ts +0 -131
  58. package/dist/middleware/rate_limit.d.ts +0 -36
  59. package/dist/middleware/request_id.d.ts +0 -4
  60. package/dist/middleware/request_signing.d.ts +0 -153
  61. package/dist/middleware/request_tracer.d.ts +0 -72
  62. package/dist/middleware/response_cache.d.ts +0 -97
  63. package/dist/middleware/security.d.ts +0 -69
  64. package/dist/middleware/security_suite.d.ts +0 -46
  65. package/dist/middleware/session.d.ts +0 -23
  66. package/dist/model-binding/index.d.ts +0 -2
  67. package/dist/model-binding/model-middleware.d.ts +0 -118
  68. package/dist/model-binding/model-registry.d.ts +0 -164
  69. package/dist/model-binding.d.ts +0 -185
  70. package/dist/model-resolver-factory.d.ts +0 -31
  71. package/dist/observability/correlation.d.ts +0 -187
  72. package/dist/observability/health-checks.d.ts +0 -186
  73. package/dist/observability/index.d.ts +0 -60
  74. package/dist/observability/integration.d.ts +0 -147
  75. package/dist/observability/metrics.d.ts +0 -184
  76. package/dist/observability/tracing.d.ts +0 -187
  77. package/dist/optimization/bun-utilities.d.ts +0 -224
  78. package/dist/query-builder-integration.d.ts +0 -36
  79. package/dist/request/context.d.ts +0 -34
  80. package/dist/request/enhanced-request.d.ts +0 -213
  81. package/dist/request/macros.d.ts +0 -300
  82. package/dist/response/macros.d.ts +0 -245
  83. package/dist/response/response-factory.d.ts +0 -133
  84. package/dist/router/api-routes.d.ts +0 -5
  85. package/dist/router/file-based-routing.d.ts +0 -118
  86. package/dist/router/file-streaming.d.ts +0 -5
  87. package/dist/router/fluent-router.d.ts +0 -315
  88. package/dist/router/fluent-routing.d.ts +0 -271
  89. package/dist/router/group-organization.d.ts +0 -5
  90. package/dist/router/handler-resolver.d.ts +0 -24
  91. package/dist/router/http-methods.d.ts +0 -10
  92. package/dist/router/index.d.ts +0 -114
  93. package/dist/router/middleware-groups.d.ts +0 -94
  94. package/dist/router/middleware-integration.d.ts +0 -112
  95. package/dist/router/middleware.d.ts +0 -5
  96. package/dist/router/model-binding.d.ts +0 -5
  97. package/dist/router/optimized-route-matching.d.ts +0 -6
  98. package/dist/router/route-building.d.ts +0 -5
  99. package/dist/router/route-compiler.d.ts +0 -153
  100. package/dist/router/route-matching.d.ts +0 -5
  101. package/dist/router/route-trie.d.ts +0 -114
  102. package/dist/router/router.d.ts +0 -294
  103. package/dist/router/server.d.ts +0 -5
  104. package/dist/router/validation-integration.d.ts +0 -170
  105. package/dist/router/view-rendering.d.ts +0 -5
  106. package/dist/router/websocket.d.ts +0 -5
  107. package/dist/routing/route-caching.d.ts +0 -129
  108. package/dist/routing/route-throttling.d.ts +0 -150
  109. package/dist/routing/subdomain-routing.d.ts +0 -206
  110. package/dist/session/database-store.d.ts +0 -51
  111. package/dist/session/file-store.d.ts +0 -22
  112. package/dist/session/index.d.ts +0 -106
  113. package/dist/session/memory-store.d.ts +0 -21
  114. package/dist/session/redis-store.d.ts +0 -31
  115. package/dist/streaming/index.d.ts +0 -3
  116. package/dist/streaming/sse-handler.d.ts +0 -138
  117. package/dist/streaming/stream-handler.d.ts +0 -114
  118. package/dist/testing/auth-testing.d.ts +0 -156
  119. package/dist/testing/file-upload-testing.d.ts +0 -190
  120. package/dist/testing/index.d.ts +0 -10
  121. package/dist/testing/middleware-testing.d.ts +0 -138
  122. package/dist/testing/model-binding-testing.d.ts +0 -186
  123. package/dist/testing/performance-testing.d.ts +0 -235
  124. package/dist/testing/test-client.d.ts +0 -117
  125. package/dist/testing/test-request.d.ts +0 -85
  126. package/dist/testing/test-response.d.ts +0 -90
  127. package/dist/testing/types.d.ts +0 -207
  128. package/dist/testing/websocket-testing.d.ts +0 -227
  129. package/dist/types/controller-types.d.ts +0 -208
  130. package/dist/types/core.d.ts +0 -543
  131. package/dist/types/middleware-types.d.ts +0 -227
  132. package/dist/types/request-response-augmentation.d.ts +0 -261
  133. package/dist/types/route-inference.d.ts +0 -168
  134. package/dist/types.d.ts +0 -1782
  135. package/dist/url.d.ts +0 -56
  136. package/dist/utils/index.d.ts +0 -1
  137. package/dist/utils/query-preservation.d.ts +0 -48
  138. package/dist/utils.d.ts +0 -69
  139. package/dist/validation/validator.d.ts +0 -140
  140. package/dist/websocket/clustering.d.ts +0 -185
  141. package/src/auth.ts +0 -469
  142. package/src/cache/lru-cache.ts +0 -457
  143. package/src/cache/middleware-memoization.ts +0 -531
  144. package/src/cache/route-cache-warmer.ts +0 -486
  145. package/src/cache/sqlite-cache.ts +0 -783
  146. package/src/cache/streaming-cache.ts +0 -572
  147. package/src/cli/colors.ts +0 -29
  148. package/src/cli/index.ts +0 -287
  149. package/src/cli/middleware.ts +0 -291
  150. package/src/cli/openapi.ts +0 -407
  151. package/src/cli/router.ts +0 -188
  152. package/src/cli/routes.ts +0 -265
  153. package/src/cli/utils.ts +0 -531
  154. package/src/cli.ts +0 -5
  155. package/src/config.ts +0 -322
  156. package/src/container/container.ts +0 -740
  157. package/src/container/contextual-binding.ts +0 -603
  158. package/src/container/decorators.ts +0 -359
  159. package/src/container/service-provider.ts +0 -596
  160. package/src/development/hot-reload.ts +0 -673
  161. package/src/development/index.ts +0 -499
  162. package/src/development/performance-profiler.ts +0 -717
  163. package/src/development/route-debugger.ts +0 -527
  164. package/src/development/route-inspector.ts +0 -749
  165. package/src/development/typescript-utilities.ts +0 -682
  166. package/src/docs.ts +0 -397
  167. package/src/errors/circuit-breaker.ts +0 -732
  168. package/src/errors/error-handler.ts +0 -569
  169. package/src/errors/error-reporting.ts +0 -672
  170. package/src/errors/exceptions.ts +0 -536
  171. package/src/errors/graceful-degradation.ts +0 -621
  172. package/src/errors/index.ts +0 -21
  173. package/src/errors/router-errors.ts +0 -632
  174. package/src/file-serving/static-files.ts +0 -581
  175. package/src/index.ts +0 -14
  176. package/src/middleware/auth.ts +0 -219
  177. package/src/middleware/content_security_policy.ts +0 -215
  178. package/src/middleware/cors.ts +0 -74
  179. package/src/middleware/csrf.ts +0 -108
  180. package/src/middleware/ddos_protection.ts +0 -255
  181. package/src/middleware/file_security.ts +0 -191
  182. package/src/middleware/file_upload.ts +0 -264
  183. package/src/middleware/helmet.ts +0 -268
  184. package/src/middleware/index.ts +0 -117
  185. package/src/middleware/input_validation.ts +0 -449
  186. package/src/middleware/json_body.ts +0 -37
  187. package/src/middleware/performance_alerting.ts +0 -538
  188. package/src/middleware/performance_dashboard.ts +0 -661
  189. package/src/middleware/performance_monitor.ts +0 -943
  190. package/src/middleware/pipeline.ts +0 -489
  191. package/src/middleware/rate_limit.ts +0 -245
  192. package/src/middleware/request_id.ts +0 -36
  193. package/src/middleware/request_signing.ts +0 -636
  194. package/src/middleware/request_tracer.ts +0 -636
  195. package/src/middleware/response_cache.ts +0 -743
  196. package/src/middleware/security.ts +0 -482
  197. package/src/middleware/security_suite.ts +0 -257
  198. package/src/middleware/session.ts +0 -91
  199. package/src/model-binding/index.ts +0 -18
  200. package/src/model-binding/model-middleware.ts +0 -425
  201. package/src/model-binding/model-registry.ts +0 -550
  202. package/src/model-binding.ts +0 -370
  203. package/src/model-resolver-factory.ts +0 -106
  204. package/src/observability/correlation.ts +0 -691
  205. package/src/observability/health-checks.ts +0 -729
  206. package/src/observability/index.ts +0 -184
  207. package/src/observability/integration.ts +0 -548
  208. package/src/observability/metrics.ts +0 -753
  209. package/src/observability/tracing.ts +0 -638
  210. package/src/optimization/bun-utilities.ts +0 -778
  211. package/src/query-builder-integration.ts +0 -137
  212. package/src/request/context.ts +0 -62
  213. package/src/request/enhanced-request.ts +0 -857
  214. package/src/request/macros.ts +0 -688
  215. package/src/response/macros.ts +0 -612
  216. package/src/response/response-factory.ts +0 -596
  217. package/src/router/api-routes.ts +0 -243
  218. package/src/router/file-based-routing.ts +0 -670
  219. package/src/router/file-streaming.ts +0 -372
  220. package/src/router/fluent-router.ts +0 -927
  221. package/src/router/fluent-routing.ts +0 -797
  222. package/src/router/group-organization.ts +0 -213
  223. package/src/router/handler-resolver.ts +0 -291
  224. package/src/router/http-methods.ts +0 -377
  225. package/src/router/index.ts +0 -187
  226. package/src/router/middleware-groups.ts +0 -222
  227. package/src/router/middleware-integration.ts +0 -399
  228. package/src/router/middleware.ts +0 -231
  229. package/src/router/model-binding.ts +0 -215
  230. package/src/router/optimized-route-matching.ts +0 -253
  231. package/src/router/route-building.ts +0 -212
  232. package/src/router/route-compiler.ts +0 -702
  233. package/src/router/route-matching.ts +0 -349
  234. package/src/router/route-trie.ts +0 -464
  235. package/src/router/router.ts +0 -1581
  236. package/src/router/server.ts +0 -462
  237. package/src/router/validation-integration.ts +0 -443
  238. package/src/router/view-rendering.ts +0 -233
  239. package/src/router/websocket.ts +0 -100
  240. package/src/routing/route-caching.ts +0 -402
  241. package/src/routing/route-throttling.ts +0 -469
  242. package/src/routing/subdomain-routing.ts +0 -492
  243. package/src/session/database-store.ts +0 -109
  244. package/src/session/file-store.ts +0 -148
  245. package/src/session/index.ts +0 -244
  246. package/src/session/memory-store.ts +0 -88
  247. package/src/session/redis-store.ts +0 -93
  248. package/src/streaming/index.ts +0 -17
  249. package/src/streaming/sse-handler.ts +0 -482
  250. package/src/streaming/stream-handler.ts +0 -552
  251. package/src/testing/auth-testing.ts +0 -446
  252. package/src/testing/file-upload-testing.ts +0 -543
  253. package/src/testing/index.ts +0 -10
  254. package/src/testing/middleware-testing.ts +0 -322
  255. package/src/testing/model-binding-testing.ts +0 -645
  256. package/src/testing/performance-testing.ts +0 -738
  257. package/src/testing/test-client.ts +0 -310
  258. package/src/testing/test-request.ts +0 -315
  259. package/src/testing/test-response.ts +0 -332
  260. package/src/testing/types.ts +0 -224
  261. package/src/testing/websocket-testing.ts +0 -590
  262. package/src/types/controller-types.ts +0 -385
  263. package/src/types/core.ts +0 -683
  264. package/src/types/middleware-types.ts +0 -419
  265. package/src/types/request-response-augmentation.ts +0 -489
  266. package/src/types/route-inference.ts +0 -357
  267. package/src/types.ts +0 -2055
  268. package/src/url.ts +0 -126
  269. package/src/utils/index.ts +0 -1
  270. package/src/utils/query-preservation.ts +0 -201
  271. package/src/utils.ts +0 -327
  272. package/src/validation/validator.ts +0 -685
  273. 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
- }