@stacksjs/bun-router 0.0.17 → 0.0.19

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 (153) hide show
  1. package/dist/chunk-2mx7fq49.js +4 -0
  2. package/dist/chunk-a8p83068.js +103 -0
  3. package/dist/{chunk-cgptvjdf.js → chunk-y3xq6wq6.js} +1 -1
  4. package/dist/cli.js +4 -3
  5. package/dist/container/index.js +1149 -211
  6. package/dist/container/service-provider.d.ts +3 -3
  7. package/dist/development/performance-profiler.d.ts +3 -3
  8. package/dist/development/route-debugger.d.ts +1 -1
  9. package/dist/development/route-inspector.d.ts +2 -2
  10. package/dist/index.js +369 -2209
  11. package/dist/observability/integration.d.ts +1 -1
  12. package/dist/response/macros.d.ts +1 -1
  13. package/dist/router/index.d.ts +7 -7
  14. package/dist/router/router.d.ts +0 -32
  15. package/dist/testing/performance-testing.d.ts +2 -2
  16. package/dist/testing/test-client.d.ts +1 -1
  17. package/dist/testing/websocket-testing.d.ts +1 -1
  18. package/package.json +7 -7
  19. package/dist/chunk-1ahs68ys.js +0 -18
  20. package/dist/chunk-g3ybefhg.js +0 -1923
  21. package/src/auth.ts +0 -489
  22. package/src/cache/lru-cache.ts +0 -457
  23. package/src/cache/middleware-memoization.ts +0 -531
  24. package/src/cache/route-cache-warmer.ts +0 -486
  25. package/src/cache/sqlite-cache.ts +0 -783
  26. package/src/cache/streaming-cache.ts +0 -572
  27. package/src/cli/colors.ts +0 -29
  28. package/src/cli/index.ts +0 -287
  29. package/src/cli/middleware.ts +0 -291
  30. package/src/cli/openapi.ts +0 -407
  31. package/src/cli/router.ts +0 -188
  32. package/src/cli/routes.ts +0 -265
  33. package/src/cli/utils.ts +0 -531
  34. package/src/cli.ts +0 -5
  35. package/src/config.ts +0 -322
  36. package/src/container/container.ts +0 -786
  37. package/src/container/contextual-binding.ts +0 -606
  38. package/src/container/decorators.ts +0 -368
  39. package/src/container/index.ts +0 -49
  40. package/src/container/service-provider.ts +0 -596
  41. package/src/development/hot-reload.ts +0 -673
  42. package/src/development/index.ts +0 -499
  43. package/src/development/performance-profiler.ts +0 -717
  44. package/src/development/route-debugger.ts +0 -527
  45. package/src/development/route-inspector.ts +0 -749
  46. package/src/development/typescript-utilities.ts +0 -682
  47. package/src/docs.ts +0 -397
  48. package/src/errors/circuit-breaker.ts +0 -733
  49. package/src/errors/error-handler.ts +0 -569
  50. package/src/errors/error-reporting.ts +0 -672
  51. package/src/errors/exceptions.ts +0 -536
  52. package/src/errors/graceful-degradation.ts +0 -623
  53. package/src/errors/index.ts +0 -21
  54. package/src/errors/router-errors.ts +0 -632
  55. package/src/file-serving/static-files.ts +0 -718
  56. package/src/index.ts +0 -66
  57. package/src/middleware/auth.ts +0 -220
  58. package/src/middleware/content_security_policy.ts +0 -215
  59. package/src/middleware/cors.ts +0 -142
  60. package/src/middleware/csrf.ts +0 -166
  61. package/src/middleware/ddos_protection.ts +0 -279
  62. package/src/middleware/file_security.ts +0 -191
  63. package/src/middleware/file_upload.ts +0 -275
  64. package/src/middleware/helmet.ts +0 -268
  65. package/src/middleware/index.ts +0 -117
  66. package/src/middleware/input_validation.ts +0 -453
  67. package/src/middleware/json_body.ts +0 -37
  68. package/src/middleware/performance_alerting.ts +0 -540
  69. package/src/middleware/performance_dashboard.ts +0 -661
  70. package/src/middleware/performance_monitor.ts +0 -945
  71. package/src/middleware/pipeline.ts +0 -489
  72. package/src/middleware/rate_limit.ts +0 -251
  73. package/src/middleware/request_id.ts +0 -36
  74. package/src/middleware/request_signing.ts +0 -638
  75. package/src/middleware/request_tracer.ts +0 -653
  76. package/src/middleware/response_cache.ts +0 -778
  77. package/src/middleware/security.ts +0 -482
  78. package/src/middleware/security_suite.ts +0 -257
  79. package/src/middleware/session.ts +0 -91
  80. package/src/model-binding/index.ts +0 -18
  81. package/src/model-binding/model-middleware.ts +0 -425
  82. package/src/model-binding/model-registry.ts +0 -550
  83. package/src/model-binding.ts +0 -370
  84. package/src/model-resolver-factory.ts +0 -106
  85. package/src/observability/correlation.ts +0 -691
  86. package/src/observability/health-checks.ts +0 -729
  87. package/src/observability/index.ts +0 -184
  88. package/src/observability/integration.ts +0 -548
  89. package/src/observability/metrics.ts +0 -753
  90. package/src/observability/tracing.ts +0 -638
  91. package/src/optimization/bun-utilities.ts +0 -778
  92. package/src/query-builder-integration.ts +0 -137
  93. package/src/request/context.ts +0 -109
  94. package/src/request/enhanced-request.ts +0 -876
  95. package/src/request/macros.ts +0 -822
  96. package/src/response/macros.ts +0 -665
  97. package/src/response/response-factory.ts +0 -596
  98. package/src/router/api-routes.ts +0 -243
  99. package/src/router/file-based-routing.ts +0 -697
  100. package/src/router/file-streaming.ts +0 -383
  101. package/src/router/fluent-routing.ts +0 -866
  102. package/src/router/group-organization.ts +0 -229
  103. package/src/router/handler-resolver.ts +0 -327
  104. package/src/router/http-methods.ts +0 -407
  105. package/src/router/index.ts +0 -193
  106. package/src/router/middleware-groups.ts +0 -222
  107. package/src/router/middleware-integration.ts +0 -399
  108. package/src/router/middleware.ts +0 -234
  109. package/src/router/model-binding.ts +0 -215
  110. package/src/router/optimized-route-matching.ts +0 -302
  111. package/src/router/route-building.ts +0 -221
  112. package/src/router/route-compiler.ts +0 -691
  113. package/src/router/route-matching.ts +0 -368
  114. package/src/router/route-trie.ts +0 -450
  115. package/src/router/router.ts +0 -1616
  116. package/src/router/server.ts +0 -684
  117. package/src/router/validation-integration.ts +0 -449
  118. package/src/router/view-rendering.ts +0 -233
  119. package/src/router/websocket.ts +0 -100
  120. package/src/routing/route-caching.ts +0 -402
  121. package/src/routing/route-throttling.ts +0 -469
  122. package/src/routing/subdomain-routing.ts +0 -492
  123. package/src/session/database-store.ts +0 -109
  124. package/src/session/file-store.ts +0 -148
  125. package/src/session/index.ts +0 -244
  126. package/src/session/memory-store.ts +0 -88
  127. package/src/session/redis-store.ts +0 -93
  128. package/src/streaming/index.ts +0 -17
  129. package/src/streaming/sse-handler.ts +0 -482
  130. package/src/streaming/stream-handler.ts +0 -552
  131. package/src/testing/auth-testing.ts +0 -448
  132. package/src/testing/file-upload-testing.ts +0 -543
  133. package/src/testing/index.ts +0 -10
  134. package/src/testing/middleware-testing.ts +0 -322
  135. package/src/testing/model-binding-testing.ts +0 -645
  136. package/src/testing/performance-testing.ts +0 -738
  137. package/src/testing/test-client.ts +0 -310
  138. package/src/testing/test-request.ts +0 -315
  139. package/src/testing/test-response.ts +0 -332
  140. package/src/testing/types.ts +0 -224
  141. package/src/testing/websocket-testing.ts +0 -590
  142. package/src/types/controller-types.ts +0 -385
  143. package/src/types/core.ts +0 -683
  144. package/src/types/middleware-types.ts +0 -422
  145. package/src/types/request-response-augmentation.ts +0 -489
  146. package/src/types/route-inference.ts +0 -372
  147. package/src/types.ts +0 -2123
  148. package/src/url.ts +0 -131
  149. package/src/utils/index.ts +0 -1
  150. package/src/utils/query-preservation.ts +0 -201
  151. package/src/utils.ts +0 -395
  152. package/src/validation/validator.ts +0 -688
  153. package/src/websocket/clustering.ts +0 -769
@@ -1,251 +0,0 @@
1
- import type { StorageProvider } from 'ts-rate-limiter'
2
- import type { EnhancedRequest, Middleware, MiddlewareHandler, NextFunction } from '../types'
3
- import { createRateLimiter } from 'ts-rate-limiter'
4
- import { config } from '../config'
5
-
6
- export interface RateLimitOptions {
7
- windowMs?: number
8
- maxRequests?: number
9
- standardHeaders?: boolean
10
- legacyHeaders?: boolean
11
- skipFailedRequests?: boolean
12
- keyGenerator?: (request: Request) => string | Promise<string>
13
- handler?: (request: Request, limit: { remaining: number, limit: number, resetTime: number }) => Response | Promise<Response>
14
- skip?: (request: Request) => boolean | Promise<boolean>
15
- /**
16
- * Custom storage backend (ts-rate-limiter `StorageProvider`), or the
17
- * string `'redis'` to use the built-in Redis store configured via
18
- * the `redis` option.
19
- */
20
- storage?: StorageProvider | 'redis'
21
- algorithm?: 'fixed-window' | 'sliding-window' | 'token-bucket'
22
- draftMode?: boolean
23
- redis?: {
24
- url?: string
25
- prefix?: string
26
- }
27
- tokenBucket?: {
28
- tokensPerInterval?: number
29
- interval?: number
30
- burst?: number
31
- }
32
- }
33
-
34
- // Factory function to create a callable middleware instance
35
- function createRateLimitMiddleware(options: RateLimitOptions = {}): MiddlewareHandler {
36
- const instance = new RateLimit(options)
37
- const middlewareHandler = async (req: EnhancedRequest, next: NextFunction): Promise<Response> => {
38
- return instance.handle(req, next)
39
- }
40
- return middlewareHandler
41
- }
42
-
43
- export default class RateLimit implements Middleware {
44
- private limiter: any // Will be initialized in constructor
45
- private options: RateLimitOptions
46
-
47
- constructor(options: RateLimitOptions = {}) {
48
- // Get rate limit config from server config if available
49
- const rateLimitConfig = config.server?.rateLimit || {}
50
- const securityRateLimitConfig = config.server?.security?.rateLimit || {}
51
-
52
- // Merge options with configuration (options take precedence)
53
- this.options = {
54
- // Basic settings
55
- windowMs: options.windowMs || rateLimitConfig.timeWindow || securityRateLimitConfig.timeWindow || 60 * 1000,
56
- maxRequests: options.maxRequests || rateLimitConfig.max || securityRateLimitConfig.max || 100,
57
-
58
- // Headers
59
- standardHeaders: options.standardHeaders ?? true,
60
- legacyHeaders: options.legacyHeaders ?? false,
61
-
62
- // Behavior options
63
- skipFailedRequests: options.skipFailedRequests
64
- ?? (rateLimitConfig.advanced?.skipFailedRequests)
65
- ?? (securityRateLimitConfig.advanced?.skipFailedRequests)
66
- ?? false,
67
- draftMode: options.draftMode ?? false,
68
-
69
- // Custom handlers
70
- keyGenerator: options.keyGenerator,
71
-
72
- handler: options.handler || (
73
- rateLimitConfig.message
74
- ? (_req: Request, _limit: any) => new Response(rateLimitConfig.message, { status: 429 })
75
- : undefined
76
- ),
77
-
78
- skip: options.skip,
79
-
80
- // Algorithm - advanced config can override
81
- algorithm: options.algorithm || 'fixed-window',
82
-
83
- // Storage configuration from config
84
- storage: options.storage,
85
- }
86
-
87
- // Enable storage from config if available
88
- if (!this.options.storage && rateLimitConfig.stores?.type === 'redis' && rateLimitConfig.stores.redis) {
89
- this.options.storage = 'redis'
90
-
91
- // Set up redis config if available
92
- if (rateLimitConfig.stores.redis) {
93
- this.options.redis = {
94
- url: rateLimitConfig.stores.redis.url,
95
- prefix: rateLimitConfig.stores.redis.prefix || 'ratelimit:',
96
- }
97
- }
98
- }
99
-
100
- // Advanced options from config
101
- if (rateLimitConfig.advanced) {
102
- if (rateLimitConfig.advanced.tokensPerInterval && this.options.algorithm === 'token-bucket') {
103
- this.options.tokenBucket = {
104
- tokensPerInterval: rateLimitConfig.advanced.tokensPerInterval,
105
- interval: rateLimitConfig.advanced.interval || this.options.windowMs,
106
- burst: rateLimitConfig.advanced.burst,
107
- }
108
- }
109
- }
110
-
111
- // Initialize the limiter (async)
112
- this.initLimiter()
113
- }
114
-
115
- private async initLimiter() {
116
- // Create a copy of the options to avoid modifying the original
117
- const limiterOptions: any = { ...this.options }
118
-
119
- // Assign specific properties for the rate limiter
120
- limiterOptions.windowMs = this.options.windowMs as number
121
- limiterOptions.maxRequests = this.options.maxRequests as number
122
- limiterOptions.standardHeaders = this.options.standardHeaders
123
- limiterOptions.legacyHeaders = this.options.legacyHeaders
124
- limiterOptions.skipFailedRequests = this.options.skipFailedRequests
125
- limiterOptions.keyGenerator = this.options.keyGenerator
126
- limiterOptions.skip = this.options.skip
127
- limiterOptions.algorithm = this.options.algorithm
128
- limiterOptions.draftMode = this.options.draftMode
129
-
130
- // Set up custom handler
131
- limiterOptions.handler = this.options.handler
132
- ? async (req: Request, result: any) => {
133
- return this.options.handler?.(req, {
134
- remaining: result.remaining,
135
- limit: result.limit,
136
- resetTime: result.resetTime,
137
- }) || this.defaultHandler(req, result)
138
- }
139
- : undefined
140
-
141
- // Initialize the rate limiter (suppress noisy logs from ts-rate-limiter)
142
- const originalConsoleLog = console.log
143
- const originalConsoleWarn = console.warn
144
- console.log = () => {}
145
- console.warn = () => {}
146
- try {
147
- this.limiter = await createRateLimiter(limiterOptions)
148
- }
149
- finally {
150
- console.log = originalConsoleLog
151
- console.warn = originalConsoleWarn
152
- }
153
- }
154
-
155
- private defaultHandler(req: Request, result: any): Response {
156
- const headers: Record<string, string> = {}
157
-
158
- if (this.options.standardHeaders) {
159
- headers['RateLimit-Limit'] = String(result.limit)
160
- headers['RateLimit-Remaining'] = String(Math.max(0, result.limit - result.current))
161
- headers['RateLimit-Reset'] = String(Math.ceil(result.resetTime / 1000))
162
- }
163
-
164
- if (this.options.legacyHeaders) {
165
- headers['X-RateLimit-Limit'] = String(result.limit)
166
- headers['X-RateLimit-Remaining'] = String(Math.max(0, result.limit - result.current))
167
- headers['X-RateLimit-Reset'] = String(Math.ceil(result.resetTime / 1000))
168
- headers['Retry-After'] = String(Math.ceil(result.remaining / 1000))
169
- }
170
-
171
- const message = config.server?.rateLimit?.message || 'Too Many Requests'
172
-
173
- return new Response(message, {
174
- status: 429,
175
- headers,
176
- })
177
- }
178
-
179
- // The middleware interface implementation
180
- async handle(req: EnhancedRequest, next: NextFunction): Promise<Response> {
181
- // If rate limiting is disabled in config, skip it
182
- if (config.server?.rateLimit?.enabled === false) {
183
- const response = await next()
184
- return response || new Response('Not Found', { status: 404 })
185
- }
186
-
187
- // If limiter isn't initialized yet, wait a bit and try again
188
- if (!this.limiter) {
189
- await new Promise(resolve => setTimeout(resolve, 50))
190
- if (!this.limiter) {
191
- // If still not initialized, just proceed
192
- const response = await next()
193
- return response || new Response('Not Found', { status: 404 })
194
- }
195
- }
196
-
197
- try {
198
- // Check if request exceeds rate limit
199
- const result = await this.limiter.check(req)
200
-
201
- if (!result.allowed) {
202
- return this.options.handler
203
- ? await this.options.handler(req, {
204
- remaining: result.remaining,
205
- limit: result.limit,
206
- resetTime: result.resetTime,
207
- })
208
- : this.defaultHandler(req, result)
209
- }
210
-
211
- // If allowed, proceed to next middleware
212
- const response = await next()
213
-
214
- if (!response) {
215
- return new Response('Not Found', { status: 404 })
216
- }
217
-
218
- // Add rate limit headers to response
219
- const headers = new Headers(response.headers)
220
-
221
- if (this.options.standardHeaders) {
222
- headers.set('RateLimit-Limit', String(result.limit))
223
- headers.set('RateLimit-Remaining', String(Math.max(0, result.limit - result.current)))
224
- headers.set('RateLimit-Reset', String(Math.ceil(result.resetTime / 1000)))
225
- }
226
-
227
- if (this.options.legacyHeaders) {
228
- headers.set('X-RateLimit-Limit', String(result.limit))
229
- headers.set('X-RateLimit-Remaining', String(Math.max(0, result.limit - result.current)))
230
- headers.set('X-RateLimit-Reset', String(Math.ceil(result.resetTime / 1000)))
231
- }
232
-
233
- return new Response(response.body, {
234
- status: response.status,
235
- statusText: response.statusText,
236
- headers,
237
- })
238
- }
239
- catch (error) {
240
- console.error('[RateLimit] Error during rate limiting:', error)
241
- // Proceed to next middleware in case of error
242
- const response = await next()
243
- return response || new Response('Not Found', { status: 404 })
244
- }
245
- }
246
- }
247
-
248
- // Export a factory function to create middleware handlers
249
- export function rateLimit(options: RateLimitOptions = {}): MiddlewareHandler {
250
- return createRateLimitMiddleware(options)
251
- }
@@ -1,36 +0,0 @@
1
- import type { EnhancedRequest, NextFunction } from '../types'
2
- import { randomUUID } from 'node:crypto'
3
-
4
- export default class RequestId {
5
- async handle(req: EnhancedRequest, next: NextFunction): Promise<Response> {
6
- // Check if there's already a request ID in the headers
7
- const requestId = req.headers.get('X-Request-ID') || randomUUID()
8
-
9
- // Store the request ID on the request object
10
- Object.defineProperty(req, 'requestId', {
11
- value: requestId,
12
- writable: false,
13
- enumerable: true,
14
- configurable: false,
15
- })
16
-
17
- // Continue to next middleware
18
- const response = await next()
19
-
20
- // Add request ID to response headers
21
- if (!response) {
22
- return new Response('Not Found', { status: 404 })
23
- }
24
- const newHeaders = new Headers(response.headers)
25
- if (!newHeaders.has('X-Request-ID')) {
26
- newHeaders.set('X-Request-ID', requestId)
27
- }
28
-
29
- // Return modified response
30
- return new Response(response.body, {
31
- status: response.status,
32
- statusText: response.statusText,
33
- headers: newHeaders,
34
- })
35
- }
36
- }