@stacksjs/bun-router 0.0.16 → 0.0.18

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