@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,349 +0,0 @@
1
- import type { HTTPMethod, MatchResult, Route } from '../types'
2
- import type { Router } from './router'
3
- import { matchPath } from '../utils'
4
-
5
- /**
6
- * Route matching extension for Router class
7
- */
8
- export function registerRouteMatching(RouterClass: typeof Router): void {
9
- Object.defineProperties(RouterClass.prototype, {
10
- /**
11
- * Match a route based on the path, method, and domain
12
- */
13
- matchRoute: {
14
- value(path: string, method: HTTPMethod, domain?: string): MatchResult | undefined {
15
- const url = new URL(path, 'http://localhost')
16
-
17
- // Generate cache key
18
- const cacheKey = `${domain || ''}:${method}:${url.pathname}`
19
-
20
- // Check cache first
21
- if (this.routeCache.has(cacheKey)) {
22
- return this.routeCache.get(cacheKey)
23
- }
24
-
25
- // Fast path for static routes
26
- if (this.staticRoutes.has(method)) {
27
- const staticRoute = this.staticRoutes.get(method)!.get(url.pathname)
28
- if (staticRoute && (!domain || !staticRoute.domain || staticRoute.domain === domain)) {
29
- const result = {
30
- route: staticRoute,
31
- params: {},
32
- }
33
- this.routeCache.set(cacheKey, result)
34
- return result
35
- }
36
- }
37
-
38
- // Get potential routes - either all routes or domain-specific routes
39
- const potentialRoutes: Route[] = domain && this.domains[domain]
40
- ? this.domains[domain]
41
- : this.routes
42
-
43
- // Filter routes to only those matching the HTTP method
44
- const methodRoutes = potentialRoutes.filter((route: Route) => route.method === method)
45
-
46
- // First, try to find an exact match
47
- for (const route of methodRoutes) {
48
- if (route.path === url.pathname) {
49
- const result = {
50
- route,
51
- params: {},
52
- }
53
- this.routeCache.set(cacheKey, result)
54
- return result
55
- }
56
- }
57
-
58
- // If no exact match, try matching patterns
59
- for (const route of methodRoutes) {
60
- if (route.pattern) {
61
- const match = route.pattern.exec(url)
62
- if (match) {
63
- const result = {
64
- route,
65
- params: match.pathname.groups,
66
- }
67
- this.routeCache.set(cacheKey, result)
68
- return result
69
- }
70
- }
71
- }
72
-
73
- // If still no match, try domain-specific * (wildcard) routes
74
- if (domain && this.domains[domain]) {
75
- const wildcardRoutes = this.domains[domain].filter((route: Route) =>
76
- route.method === method && route.path.endsWith('*'),
77
- )
78
-
79
- for (const route of wildcardRoutes) {
80
- const basePath = route.path.slice(0, -1) // Remove the '*'
81
- if (url.pathname.startsWith(basePath)) {
82
- const result = {
83
- route,
84
- params: {
85
- wildcard: url.pathname.slice(basePath.length),
86
- },
87
- }
88
- this.routeCache.set(cacheKey, result)
89
- return result
90
- }
91
- }
92
- }
93
-
94
- // If no match in domain-specific routes, try global wildcard routes
95
- const globalWildcardRoutes = this.routes.filter((route: Route) =>
96
- route.method === method && route.path.endsWith('*') && (!domain || !route.domain),
97
- )
98
-
99
- for (const route of globalWildcardRoutes) {
100
- const basePath = route.path.slice(0, -1) // Remove the '*'
101
- if (url.pathname.startsWith(basePath)) {
102
- const result = {
103
- route,
104
- params: {
105
- wildcard: url.pathname.slice(basePath.length),
106
- },
107
- }
108
- this.routeCache.set(cacheKey, result)
109
- return result
110
- }
111
- }
112
-
113
- // If no match for specific method, try HEAD for GET requests
114
- if (method === 'HEAD') {
115
- return this.matchRoute(path, 'GET', domain)
116
- }
117
-
118
- // Try to match any OPTIONS requests to a generic options handler or to a matching route of another method
119
- if (method === 'OPTIONS') {
120
- // Check if we have a specific OPTIONS handler first
121
- const optionsMatch = potentialRoutes.find((route: Route) =>
122
- route.method === 'OPTIONS' && route.path === '*',
123
- )
124
-
125
- if (optionsMatch) {
126
- const result = {
127
- route: optionsMatch,
128
- params: {},
129
- }
130
- this.routeCache.set(cacheKey, result)
131
- return result
132
- }
133
-
134
- // Check if the path matches any route of another method
135
- for (const otherMethod of ['GET', 'POST', 'PUT', 'PATCH', 'DELETE']) {
136
- const match = this.matchRoute(path, otherMethod as HTTPMethod, domain)
137
- if (match) {
138
- // We found a route that matches this path with another method,
139
- // so this is a valid OPTIONS request
140
- const result = {
141
- route: {
142
- ...match.route,
143
- method: 'OPTIONS',
144
- handler: (_req: Request) => new Response(null, { status: 204 }),
145
- },
146
- params: match.params,
147
- }
148
- this.routeCache.set(cacheKey, result)
149
- return result
150
- }
151
- }
152
- }
153
-
154
- // No matching route found
155
- return undefined
156
- },
157
- writable: true,
158
- configurable: true,
159
- },
160
-
161
- /**
162
- * Match a domain pattern against a hostname
163
- */
164
- matchDomain: {
165
- value(pattern: string, hostname: string): boolean {
166
- // Exact match
167
- if (pattern === hostname) {
168
- return true
169
- }
170
-
171
- // Wildcard subdomains (*.example.com)
172
- if (pattern.startsWith('*.')) {
173
- const domain = pattern.substring(2)
174
- return hostname === domain || hostname.endsWith(`.${domain}`)
175
- }
176
-
177
- // Dynamic parameters ({subdomain}.example.com)
178
- if (pattern.includes('{')) {
179
- let regex: RegExp
180
- if (!this.domainPatternCache.has(pattern)) {
181
- const regexStr = pattern.replace(/\./g, '\\.').replace(/\{[^}]+\}/g, '([^.]+)')
182
- regex = new RegExp(`^${regexStr}$`)
183
- this.domainPatternCache.set(pattern, regex)
184
- }
185
- else {
186
- regex = this.domainPatternCache.get(pattern)!
187
- }
188
- return regex.test(hostname)
189
- }
190
-
191
- return false
192
- },
193
- writable: true,
194
- configurable: true,
195
- },
196
-
197
- /**
198
- * Extract domain parameters from a hostname
199
- */
200
- extractDomainParams: {
201
- value(pattern: string, hostname: string): Record<string, string> {
202
- const params: Record<string, string> = {}
203
-
204
- if (!pattern.includes('{')) {
205
- return params
206
- }
207
-
208
- const paramNames = pattern.match(/\{([^}]+)\}/g)?.map(p => p.substring(1, p.length - 1)) || []
209
- const regex = pattern.replace(/\./g, '\\.').replace(/\{[^}]+\}/g, '([^.]+)')
210
- const matches = hostname.match(new RegExp(`^${regex}$`))
211
-
212
- if (matches && matches.length > 1) {
213
- for (let i = 0; i < paramNames.length; i++) {
214
- params[paramNames[i]] = matches[i + 1]
215
- }
216
- }
217
-
218
- return params
219
- },
220
- writable: true,
221
- configurable: true,
222
- },
223
-
224
- /**
225
- * Apply pattern constraints to routes
226
- */
227
- pattern: {
228
- value(name: string, pattern: string): Router {
229
- this.patterns.set(name, pattern)
230
- return this
231
- },
232
- writable: true,
233
- configurable: true,
234
- },
235
-
236
- /**
237
- * Apply constraints to route parameters
238
- */
239
- where: {
240
- value(params: Record<string, string>): Router {
241
- // Apply to the most recently added route(s)
242
- const lastRoute = this.routes[this.routes.length - 1]
243
- if (lastRoute) {
244
- // Update constraints
245
- lastRoute.constraints = { ...(lastRoute.constraints || {}), ...params }
246
-
247
- // Regenerate the route pattern with the new constraints
248
- const routePath = lastRoute.path
249
- const constraintsRecord = lastRoute.constraints && !Array.isArray(lastRoute.constraints)
250
- ? lastRoute.constraints as Record<string, string>
251
- : undefined
252
-
253
- // Recreate the pattern with the updated constraints
254
- lastRoute.pattern = {
255
- exec: (url: URL): { pathname: { groups: Record<string, string> } } | null => {
256
- const params: Record<string, string> = {}
257
- const isMatch = matchPath(routePath, url.pathname, params, constraintsRecord)
258
-
259
- if (!isMatch) {
260
- return null
261
- }
262
-
263
- return {
264
- pathname: {
265
- groups: params,
266
- },
267
- }
268
- },
269
- }
270
-
271
- // Clear route cache when constraints are added
272
- this.routeCache.clear()
273
-
274
- // Force recompilation of the route in the trie
275
- if (this.routeCompiler) {
276
- // We need to completely rebuild the trie to ensure constraints are applied
277
- // This is more reliable than trying to selectively update just one route
278
- const allRoutes = [...this.routes]
279
- this.routeCompiler.clear()
280
-
281
- // Re-add all routes to ensure proper ordering and constraint application
282
- for (const route of allRoutes) {
283
- this.routeCompiler.addRoute(route)
284
- }
285
- }
286
- }
287
-
288
- return this
289
- },
290
- writable: true,
291
- configurable: true,
292
- },
293
-
294
- /**
295
- * Apply a numeric constraint to a parameter
296
- */
297
- whereNumber: {
298
- value(param: string): Router {
299
- return this.where({ [param]: '\\d+' })
300
- },
301
- writable: true,
302
- configurable: true,
303
- },
304
-
305
- /**
306
- * Apply an alphabetic constraint to a parameter
307
- */
308
- whereAlpha: {
309
- value(param: string): Router {
310
- return this.where({ [param]: '[A-Za-z]+' })
311
- },
312
- writable: true,
313
- configurable: true,
314
- },
315
-
316
- /**
317
- * Apply an alphanumeric constraint to a parameter
318
- */
319
- whereAlphaNumeric: {
320
- value(param: string): Router {
321
- return this.where({ [param]: '[A-Za-z0-9]+' })
322
- },
323
- writable: true,
324
- configurable: true,
325
- },
326
-
327
- /**
328
- * Apply a UUID constraint to a parameter
329
- */
330
- whereUuid: {
331
- value(param: string): Router {
332
- return this.where({ [param]: '[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}' })
333
- },
334
- writable: true,
335
- configurable: true,
336
- },
337
-
338
- /**
339
- * Apply an "in array" constraint to a parameter
340
- */
341
- whereIn: {
342
- value(param: string, values: string[]): Router {
343
- return this.where({ [param]: values.join('|') })
344
- },
345
- writable: true,
346
- configurable: true,
347
- },
348
- })
349
- }