@stacksjs/bun-router 0.0.4 → 0.0.6

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 (272) hide show
  1. package/README.md +2 -2
  2. package/dist/auth.d.ts +134 -0
  3. package/dist/cache/lru-cache.d.ts +139 -0
  4. package/dist/cache/middleware-memoization.d.ts +151 -0
  5. package/dist/cache/route-cache-warmer.d.ts +161 -0
  6. package/dist/cache/sqlite-cache.d.ts +209 -0
  7. package/dist/cache/streaming-cache.d.ts +132 -0
  8. package/dist/chunk-jhsk5c5b.js +15758 -0
  9. package/dist/cli/colors.d.ts +15 -0
  10. package/dist/cli/index.d.ts +10 -0
  11. package/dist/cli/middleware.d.ts +31 -0
  12. package/dist/cli/openapi.d.ts +17 -0
  13. package/dist/cli/router.d.ts +15 -0
  14. package/dist/cli/routes.d.ts +29 -0
  15. package/dist/cli/utils.d.ts +74 -0
  16. package/dist/cli.d.ts +1 -1
  17. package/dist/cli.js +2 -2
  18. package/dist/config.d.ts +7 -0
  19. package/dist/container/container.d.ts +273 -0
  20. package/dist/container/contextual-binding.d.ts +240 -0
  21. package/dist/container/decorators.d.ts +141 -0
  22. package/dist/container/service-provider.d.ts +285 -0
  23. package/dist/development/hot-reload.d.ts +187 -0
  24. package/dist/development/index.d.ts +167 -0
  25. package/dist/development/performance-profiler.d.ts +217 -0
  26. package/dist/development/route-debugger.d.ts +154 -0
  27. package/dist/development/route-inspector.d.ts +211 -0
  28. package/dist/development/typescript-utilities.d.ts +209 -0
  29. package/dist/docs.d.ts +11 -0
  30. package/dist/errors/circuit-breaker.d.ts +195 -0
  31. package/dist/errors/error-handler.d.ts +88 -0
  32. package/dist/errors/error-reporting.d.ts +144 -0
  33. package/dist/errors/exceptions.d.ts +184 -0
  34. package/dist/errors/graceful-degradation.d.ts +154 -0
  35. package/dist/errors/index.d.ts +9 -0
  36. package/dist/errors/router-errors.d.ts +110 -0
  37. package/dist/file-serving/static-files.d.ts +143 -0
  38. package/dist/index.d.ts +2 -0
  39. package/dist/index.js +320 -206
  40. package/dist/middleware/auth.d.ts +63 -0
  41. package/dist/middleware/content_security_policy.d.ts +53 -0
  42. package/dist/middleware/cors.d.ts +5 -0
  43. package/dist/middleware/csrf.d.ts +7 -0
  44. package/dist/middleware/ddos_protection.d.ts +39 -0
  45. package/dist/middleware/file_security.d.ts +26 -0
  46. package/dist/middleware/file_upload.d.ts +38 -0
  47. package/dist/middleware/helmet.d.ts +54 -0
  48. package/dist/middleware/index.d.ts +44 -0
  49. package/dist/middleware/input_validation.d.ts +45 -0
  50. package/dist/middleware/json_body.d.ts +4 -0
  51. package/dist/middleware/performance_alerting.d.ts +87 -0
  52. package/dist/middleware/performance_dashboard.d.ts +87 -0
  53. package/dist/middleware/performance_monitor.d.ts +209 -0
  54. package/dist/middleware/pipeline.d.ts +131 -0
  55. package/dist/middleware/rate_limit.d.ts +36 -0
  56. package/dist/middleware/request_id.d.ts +4 -0
  57. package/dist/middleware/request_signing.d.ts +153 -0
  58. package/dist/middleware/request_tracer.d.ts +72 -0
  59. package/dist/middleware/response_cache.d.ts +97 -0
  60. package/dist/middleware/security.d.ts +69 -0
  61. package/dist/middleware/security_suite.d.ts +46 -0
  62. package/dist/middleware/session.d.ts +23 -0
  63. package/dist/model-binding/index.d.ts +2 -0
  64. package/dist/model-binding/model-middleware.d.ts +118 -0
  65. package/dist/model-binding/model-registry.d.ts +164 -0
  66. package/dist/model-binding.d.ts +185 -0
  67. package/dist/model-resolver-factory.d.ts +31 -0
  68. package/dist/observability/correlation.d.ts +187 -0
  69. package/dist/observability/health-checks.d.ts +186 -0
  70. package/dist/observability/index.d.ts +60 -0
  71. package/dist/observability/integration.d.ts +147 -0
  72. package/dist/observability/metrics.d.ts +184 -0
  73. package/dist/observability/tracing.d.ts +187 -0
  74. package/dist/optimization/bun-utilities.d.ts +224 -0
  75. package/dist/query-builder-integration.d.ts +36 -0
  76. package/dist/request/context.d.ts +34 -0
  77. package/dist/request/enhanced-request.d.ts +213 -0
  78. package/dist/request/macros.d.ts +300 -0
  79. package/dist/response/macros.d.ts +245 -0
  80. package/dist/response/response-factory.d.ts +133 -0
  81. package/dist/router/api-routes.d.ts +5 -0
  82. package/dist/router/file-based-routing.d.ts +118 -0
  83. package/dist/router/file-streaming.d.ts +5 -0
  84. package/dist/router/fluent-router.d.ts +315 -0
  85. package/dist/router/fluent-routing.d.ts +271 -0
  86. package/dist/router/group-organization.d.ts +5 -0
  87. package/dist/router/handler-resolver.d.ts +24 -0
  88. package/dist/router/http-methods.d.ts +10 -0
  89. package/dist/router/index.d.ts +113 -0
  90. package/dist/router/middleware-groups.d.ts +94 -0
  91. package/dist/router/middleware-integration.d.ts +112 -0
  92. package/dist/router/middleware.d.ts +5 -0
  93. package/dist/router/model-binding.d.ts +5 -0
  94. package/dist/router/optimized-route-matching.d.ts +6 -0
  95. package/dist/router/route-building.d.ts +5 -0
  96. package/dist/router/route-compiler.d.ts +153 -0
  97. package/dist/router/route-matching.d.ts +5 -0
  98. package/dist/router/route-trie.d.ts +114 -0
  99. package/dist/router/router.d.ts +276 -0
  100. package/dist/router/server.d.ts +5 -0
  101. package/dist/router/validation-integration.d.ts +170 -0
  102. package/dist/router/view-rendering.d.ts +5 -0
  103. package/dist/router/websocket.d.ts +5 -0
  104. package/dist/routing/route-caching.d.ts +129 -0
  105. package/dist/routing/route-throttling.d.ts +150 -0
  106. package/dist/routing/subdomain-routing.d.ts +206 -0
  107. package/dist/session/database-store.d.ts +51 -0
  108. package/dist/session/file-store.d.ts +22 -0
  109. package/dist/session/index.d.ts +106 -0
  110. package/dist/session/memory-store.d.ts +21 -0
  111. package/dist/session/redis-store.d.ts +31 -0
  112. package/dist/streaming/index.d.ts +3 -0
  113. package/dist/streaming/sse-handler.d.ts +138 -0
  114. package/dist/streaming/stream-handler.d.ts +114 -0
  115. package/dist/testing/auth-testing.d.ts +156 -0
  116. package/dist/testing/file-upload-testing.d.ts +190 -0
  117. package/dist/testing/index.d.ts +10 -0
  118. package/dist/testing/middleware-testing.d.ts +138 -0
  119. package/dist/testing/model-binding-testing.d.ts +186 -0
  120. package/dist/testing/performance-testing.d.ts +235 -0
  121. package/dist/testing/test-client.d.ts +117 -0
  122. package/dist/testing/test-request.d.ts +85 -0
  123. package/dist/testing/test-response.d.ts +90 -0
  124. package/dist/testing/types.d.ts +207 -0
  125. package/dist/testing/websocket-testing.d.ts +227 -0
  126. package/dist/types/controller-types.d.ts +208 -0
  127. package/dist/types/core.d.ts +543 -0
  128. package/dist/types/middleware-types.d.ts +227 -0
  129. package/dist/types/request-response-augmentation.d.ts +261 -0
  130. package/dist/types/route-inference.d.ts +168 -0
  131. package/dist/types.d.ts +1776 -0
  132. package/dist/url.d.ts +56 -0
  133. package/dist/utils/index.d.ts +1 -0
  134. package/dist/utils/query-preservation.d.ts +48 -0
  135. package/dist/utils.d.ts +69 -0
  136. package/dist/validation/validator.d.ts +140 -0
  137. package/dist/websocket/clustering.d.ts +185 -0
  138. package/package.json +18 -4
  139. package/src/auth.ts +469 -0
  140. package/src/cache/lru-cache.ts +457 -0
  141. package/src/cache/middleware-memoization.ts +531 -0
  142. package/src/cache/route-cache-warmer.ts +486 -0
  143. package/src/cache/sqlite-cache.ts +783 -0
  144. package/src/cache/streaming-cache.ts +572 -0
  145. package/src/cli/colors.ts +29 -0
  146. package/src/cli/index.ts +287 -0
  147. package/src/cli/middleware.ts +291 -0
  148. package/src/cli/openapi.ts +407 -0
  149. package/src/cli/router.ts +188 -0
  150. package/src/cli/routes.ts +265 -0
  151. package/src/cli/utils.ts +531 -0
  152. package/src/cli.ts +5 -0
  153. package/src/config.ts +322 -0
  154. package/src/container/container.ts +740 -0
  155. package/src/container/contextual-binding.ts +603 -0
  156. package/src/container/decorators.ts +359 -0
  157. package/src/container/service-provider.ts +596 -0
  158. package/src/development/hot-reload.ts +673 -0
  159. package/src/development/index.ts +499 -0
  160. package/src/development/performance-profiler.ts +717 -0
  161. package/src/development/route-debugger.ts +527 -0
  162. package/src/development/route-inspector.ts +749 -0
  163. package/src/development/typescript-utilities.ts +678 -0
  164. package/src/docs.ts +397 -0
  165. package/src/errors/circuit-breaker.ts +732 -0
  166. package/src/errors/error-handler.ts +569 -0
  167. package/src/errors/error-reporting.ts +672 -0
  168. package/src/errors/exceptions.ts +536 -0
  169. package/src/errors/graceful-degradation.ts +621 -0
  170. package/src/errors/index.ts +21 -0
  171. package/src/errors/router-errors.ts +632 -0
  172. package/src/file-serving/static-files.ts +581 -0
  173. package/src/index.ts +14 -0
  174. package/src/middleware/auth.ts +219 -0
  175. package/src/middleware/content_security_policy.ts +215 -0
  176. package/src/middleware/cors.ts +74 -0
  177. package/src/middleware/csrf.ts +108 -0
  178. package/src/middleware/ddos_protection.ts +255 -0
  179. package/src/middleware/file_security.ts +191 -0
  180. package/src/middleware/file_upload.ts +264 -0
  181. package/src/middleware/helmet.ts +268 -0
  182. package/src/middleware/index.ts +117 -0
  183. package/src/middleware/input_validation.ts +449 -0
  184. package/src/middleware/json_body.ts +37 -0
  185. package/src/middleware/performance_alerting.ts +538 -0
  186. package/src/middleware/performance_dashboard.ts +661 -0
  187. package/src/middleware/performance_monitor.ts +943 -0
  188. package/src/middleware/pipeline.ts +489 -0
  189. package/src/middleware/rate_limit.ts +245 -0
  190. package/src/middleware/request_id.ts +36 -0
  191. package/src/middleware/request_signing.ts +636 -0
  192. package/src/middleware/request_tracer.ts +636 -0
  193. package/src/middleware/response_cache.ts +743 -0
  194. package/src/middleware/security.ts +482 -0
  195. package/src/middleware/security_suite.ts +257 -0
  196. package/src/middleware/session.ts +91 -0
  197. package/src/model-binding/index.ts +18 -0
  198. package/src/model-binding/model-middleware.ts +425 -0
  199. package/src/model-binding/model-registry.ts +550 -0
  200. package/src/model-binding.ts +370 -0
  201. package/src/model-resolver-factory.ts +106 -0
  202. package/src/observability/correlation.ts +691 -0
  203. package/src/observability/health-checks.ts +729 -0
  204. package/src/observability/index.ts +184 -0
  205. package/src/observability/integration.ts +548 -0
  206. package/src/observability/metrics.ts +753 -0
  207. package/src/observability/tracing.ts +638 -0
  208. package/src/optimization/bun-utilities.ts +778 -0
  209. package/src/query-builder-integration.ts +137 -0
  210. package/src/request/context.ts +62 -0
  211. package/src/request/enhanced-request.ts +857 -0
  212. package/src/request/macros.ts +688 -0
  213. package/src/response/macros.ts +612 -0
  214. package/src/response/response-factory.ts +588 -0
  215. package/src/router/api-routes.ts +243 -0
  216. package/src/router/file-based-routing.ts +670 -0
  217. package/src/router/file-streaming.ts +372 -0
  218. package/src/router/fluent-router.ts +927 -0
  219. package/src/router/fluent-routing.ts +797 -0
  220. package/src/router/group-organization.ts +213 -0
  221. package/src/router/handler-resolver.ts +291 -0
  222. package/src/router/http-methods.ts +377 -0
  223. package/src/router/index.ts +185 -0
  224. package/src/router/middleware-groups.ts +222 -0
  225. package/src/router/middleware-integration.ts +399 -0
  226. package/src/router/middleware.ts +231 -0
  227. package/src/router/model-binding.ts +215 -0
  228. package/src/router/optimized-route-matching.ts +253 -0
  229. package/src/router/route-building.ts +212 -0
  230. package/src/router/route-compiler.ts +702 -0
  231. package/src/router/route-matching.ts +349 -0
  232. package/src/router/route-trie.ts +464 -0
  233. package/src/router/router.ts +1508 -0
  234. package/src/router/server.ts +406 -0
  235. package/src/router/validation-integration.ts +443 -0
  236. package/src/router/view-rendering.ts +233 -0
  237. package/src/router/websocket.ts +100 -0
  238. package/src/routing/route-caching.ts +402 -0
  239. package/src/routing/route-throttling.ts +469 -0
  240. package/src/routing/subdomain-routing.ts +492 -0
  241. package/src/session/database-store.ts +109 -0
  242. package/src/session/file-store.ts +148 -0
  243. package/src/session/index.ts +244 -0
  244. package/src/session/memory-store.ts +88 -0
  245. package/src/session/redis-store.ts +93 -0
  246. package/src/streaming/index.ts +17 -0
  247. package/src/streaming/sse-handler.ts +482 -0
  248. package/src/streaming/stream-handler.ts +552 -0
  249. package/src/testing/auth-testing.ts +446 -0
  250. package/src/testing/file-upload-testing.ts +543 -0
  251. package/src/testing/index.ts +10 -0
  252. package/src/testing/middleware-testing.ts +322 -0
  253. package/src/testing/model-binding-testing.ts +645 -0
  254. package/src/testing/performance-testing.ts +738 -0
  255. package/src/testing/test-client.ts +310 -0
  256. package/src/testing/test-request.ts +315 -0
  257. package/src/testing/test-response.ts +332 -0
  258. package/src/testing/types.ts +224 -0
  259. package/src/testing/websocket-testing.ts +590 -0
  260. package/src/types/controller-types.ts +385 -0
  261. package/src/types/core.ts +683 -0
  262. package/src/types/middleware-types.ts +419 -0
  263. package/src/types/request-response-augmentation.ts +489 -0
  264. package/src/types/route-inference.ts +357 -0
  265. package/src/types.ts +2049 -0
  266. package/src/url.ts +126 -0
  267. package/src/utils/index.ts +1 -0
  268. package/src/utils/query-preservation.ts +201 -0
  269. package/src/utils.ts +327 -0
  270. package/src/validation/validator.ts +685 -0
  271. package/src/websocket/clustering.ts +762 -0
  272. package/dist/chunk-cjdekj87.js +0 -25886
@@ -0,0 +1,212 @@
1
+ import type { Route, RouteDefinition } from '../types'
2
+ import type { Router } from './router'
3
+ import { matchPath } from '../utils'
4
+
5
+ /**
6
+ * Route building extension for Router class
7
+ */
8
+ export function registerRouteBuilding(RouterClass: typeof Router): void {
9
+ Object.defineProperties(RouterClass.prototype, {
10
+ /**
11
+ * Convert existing routes to the Bun.serve routes format
12
+ */
13
+ buildBunServeRoutes: {
14
+ value(): Record<string, any> {
15
+ const bunRoutes: Record<string, any> = {}
16
+
17
+ // Group routes by path to build method-specific handlers
18
+ const routesByPath = new Map<string, Route[]>()
19
+
20
+ for (const route of this.routes) {
21
+ if (!routesByPath.has(route.path)) {
22
+ routesByPath.set(route.path, [])
23
+ }
24
+ routesByPath.get(route.path)!.push(route)
25
+ }
26
+
27
+ // Build route handlers
28
+ for (const [path, routes] of routesByPath.entries()) {
29
+ if (routes.length === 1) {
30
+ // Single route handler
31
+ const route = routes[0]
32
+
33
+ // For static responses like health checks, use direct Response objects
34
+ if (
35
+ typeof route.handler === 'function'
36
+ && route.handler.toString().includes('new Response')
37
+ && !route.handler.toString().includes('await')
38
+ && route.middleware.length === 0
39
+ ) {
40
+ try {
41
+ // Create an enhanced request with empty params and cookie support
42
+ const mockReq = this.enhanceRequest(new Request('https://example.com'), {})
43
+ const testResult = (route.handler as any)(mockReq)
44
+
45
+ // If it returns a Response directly, use it as a static route
46
+ if (testResult instanceof Response) {
47
+ bunRoutes[path] = testResult
48
+ continue
49
+ }
50
+ }
51
+ catch {
52
+ // If there's an error, fall back to the dynamic handler
53
+ }
54
+ }
55
+
56
+ // Dynamic route handler
57
+ bunRoutes[path] = async (req: Request) => {
58
+ // Create enhanced request with params
59
+ const url = new URL(req.url)
60
+ const params: Record<string, string> = {}
61
+ const constraintsRecord = route.constraints && !Array.isArray(route.constraints)
62
+ ? route.constraints as Record<string, string>
63
+ : undefined
64
+ matchPath(path, url.pathname, params, constraintsRecord)
65
+ const enhancedReq = this.enhanceRequest(req, params)
66
+
67
+ // Run middleware
68
+ const middlewareResult = await this.runMiddleware(
69
+ enhancedReq,
70
+ [...this.globalMiddleware, ...route.middleware],
71
+ )
72
+ if (middlewareResult) {
73
+ return this.applyModifiedCookies(middlewareResult, enhancedReq)
74
+ }
75
+
76
+ // Run route handler
77
+ const response = await this.resolveHandler(route.handler, enhancedReq)
78
+ return this.applyModifiedCookies(response, enhancedReq)
79
+ }
80
+ }
81
+ else {
82
+ // Multiple routes for same path (method-specific)
83
+ const methodHandlers: Record<string, any> = {}
84
+
85
+ for (const route of routes) {
86
+ const method = route.method
87
+
88
+ methodHandlers[method] = async (req: Request) => {
89
+ // Create enhanced request with params
90
+ const url = new URL(req.url)
91
+ const params: Record<string, string> = {}
92
+ const constraintsRecord = route.constraints && !Array.isArray(route.constraints)
93
+ ? route.constraints as Record<string, string>
94
+ : undefined
95
+ matchPath(path, url.pathname, params, constraintsRecord)
96
+ const enhancedReq = this.enhanceRequest(req, params)
97
+
98
+ // Run middleware
99
+ const middlewareResult = await this.runMiddleware(
100
+ enhancedReq,
101
+ [...this.globalMiddleware, ...route.middleware],
102
+ )
103
+ if (middlewareResult) {
104
+ return this.applyModifiedCookies(middlewareResult, enhancedReq)
105
+ }
106
+
107
+ // Run route handler
108
+ const response = await this.resolveHandler(route.handler, enhancedReq)
109
+ return this.applyModifiedCookies(response, enhancedReq)
110
+ }
111
+ }
112
+
113
+ bunRoutes[path] = methodHandlers
114
+ }
115
+ }
116
+
117
+ return bunRoutes
118
+ },
119
+ writable: true,
120
+ configurable: true,
121
+ },
122
+
123
+ /**
124
+ * Load routes from files
125
+ */
126
+ loadRoutes: {
127
+ async value(): Promise<void> {
128
+ if (!this.config.routesPath) {
129
+ return
130
+ }
131
+
132
+ try {
133
+ // Try to import API routes if configured
134
+ if (this.config.apiRoutesPath) {
135
+ try {
136
+ const apiRoutes = await import(this.config.apiRoutesPath)
137
+ if (apiRoutes.default && Array.isArray(apiRoutes.default)) {
138
+ // Register each route
139
+ for (const route of apiRoutes.default) {
140
+ this.registerRoute(route, 'api')
141
+ }
142
+ }
143
+ }
144
+ catch (error) {
145
+ if (this.config.verbose) {
146
+ console.warn(`Failed to load API routes: ${error}`)
147
+ }
148
+ }
149
+ }
150
+
151
+ // Try to import Web routes if configured
152
+ if (this.config.webRoutesPath) {
153
+ try {
154
+ const webRoutes = await import(this.config.webRoutesPath)
155
+ if (webRoutes.default && Array.isArray(webRoutes.default)) {
156
+ // Register each route
157
+ for (const route of webRoutes.default) {
158
+ this.registerRoute(route, 'web')
159
+ }
160
+ }
161
+ }
162
+ catch (error) {
163
+ if (this.config.verbose) {
164
+ console.warn(`Failed to load Web routes: ${error}`)
165
+ }
166
+ }
167
+ }
168
+ }
169
+ catch (error) {
170
+ console.error('Error loading routes:', error)
171
+ }
172
+ },
173
+ writable: true,
174
+ configurable: true,
175
+ },
176
+
177
+ /**
178
+ * Register a route definition
179
+ */
180
+ registerRoute: {
181
+ value(route: RouteDefinition, type: 'api' | 'web'): void {
182
+ const { path, method, handler, middleware = [], name } = route
183
+
184
+ // Map HTTP method to Router method
185
+ switch (method) {
186
+ case 'GET':
187
+ this.get(path, handler, type, name, middleware)
188
+ break
189
+ case 'POST':
190
+ this.post(path, handler, type, name, middleware)
191
+ break
192
+ case 'PUT':
193
+ this.put(path, handler, type, name, middleware)
194
+ break
195
+ case 'DELETE':
196
+ this.delete(path, handler, type, name, middleware)
197
+ break
198
+ case 'PATCH':
199
+ this.patch(path, handler, type, name, middleware)
200
+ break
201
+ case 'OPTIONS':
202
+ this.options(path, handler, type, name, middleware)
203
+ break
204
+ default:
205
+ console.warn(`Unsupported HTTP method: ${method}`)
206
+ }
207
+ },
208
+ writable: true,
209
+ configurable: true,
210
+ },
211
+ })
212
+ }