@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
package/src/cli/routes.ts DELETED
@@ -1,265 +0,0 @@
1
- import fs from 'node:fs/promises'
2
- import path from 'node:path'
3
- import process from 'node:process'
4
- import { chalk } from './colors'
5
-
6
- /**
7
- * Options for the route:list command
8
- */
9
- export interface RouteListOptions {
10
- verbose?: boolean
11
- extraVerbose?: boolean
12
- path?: string
13
- exceptVendor?: boolean
14
- onlyVendor?: boolean
15
- }
16
-
17
- /**
18
- * Options for the route:types command
19
- */
20
- export interface GenerateRouteTypesOptions {
21
- output?: string
22
- watch?: boolean
23
- }
24
-
25
- /**
26
- * Display all registered routes in a formatted table
27
- */
28
- export async function displayRoutes(options: RouteListOptions): Promise<void> {
29
- try {
30
- // Try to load router instance from the application
31
- const routesFile = `${process.cwd()}/routes/index.ts`
32
- const { router } = await import(routesFile)
33
-
34
- if (!router) {
35
- console.error(chalk.red(`Could not find router instance in ${routesFile}.`))
36
- process.exit(1)
37
- }
38
-
39
- // Get routes from router
40
- const routes = (router as any).routes || []
41
-
42
- if (routes.length === 0) {
43
- console.log(chalk.yellow('No routes defined.'))
44
- return
45
- }
46
-
47
- // Filter routes based on options
48
- let filteredRoutes = routes
49
-
50
- if (options.path) {
51
- filteredRoutes = filteredRoutes.filter((route: any) =>
52
- route.path.startsWith(options.path),
53
- )
54
- }
55
-
56
- // Display route table
57
- console.log(chalk.bold('\nRoutes:'))
58
- console.log(chalk.dim('+-----------------+-------------------------+------------------+----------------+'))
59
- console.log(chalk.dim('| ') + chalk.bold('Method') + chalk.dim(' | ') + chalk.bold('URI') + chalk.dim(' | ') + chalk.bold('Name') + chalk.dim(' | ') + chalk.bold('Handler') + chalk.dim(' |'))
60
- console.log(chalk.dim('+-----------------+-------------------------+------------------+----------------+'))
61
-
62
- filteredRoutes.forEach((route: any) => {
63
- const method = padString(route.method, 15)
64
- const path = padString(route.path, 23)
65
- const name = padString(route.name || '', 16)
66
-
67
- let handler: string
68
- if (typeof route.handler === 'string') {
69
- handler = route.handler
70
- }
71
- else if (typeof route.handler === 'function') {
72
- handler = route.handler.name ? `${route.handler.name}()` : 'Anonymous Function'
73
- }
74
- else {
75
- handler = 'Class Handler'
76
- }
77
-
78
- handler = padString(handler, 14)
79
-
80
- console.log(chalk.dim('| ')
81
- + getMethodColor(route.method)(method) + chalk.dim(' | ')
82
- + chalk.green(path) + chalk.dim(' | ')
83
- + chalk.yellow(name) + chalk.dim(' | ')
84
- + chalk.blue(handler) + chalk.dim(' |'))
85
-
86
- // Show middleware if verbose flag is set
87
- if (options.verbose && route.middleware && route.middleware.length > 0) {
88
- console.log(chalk.dim('| | ') + chalk.dim('Middleware: ')
89
- + route.middleware.map((m: any) => typeof m === 'string' ? m : m.name || 'Anonymous').join(', ')
90
- + chalk.dim(' |'))
91
- }
92
- })
93
-
94
- console.log(chalk.dim('+-----------------+-------------------------+------------------+----------------+'))
95
- console.log(`\nShowing ${filteredRoutes.length} routes`)
96
- }
97
- catch (error: any) {
98
- console.error(chalk.red(`Error: ${error.message}`))
99
- console.error(chalk.yellow(`Make sure your routes are defined in ${process.cwd()}/routes/index.ts and export a 'router' instance.`))
100
- throw error
101
- }
102
- }
103
-
104
- /**
105
- * Generate TypeScript types for route names
106
- */
107
- export async function generateRouteTypes(outputPath: string): Promise<void> {
108
- try {
109
- // Try to load router instance from the application
110
- const routesFile = `${process.cwd()}/routes/index.ts`
111
- const { router } = await import(routesFile)
112
-
113
- if (!router) {
114
- console.error(chalk.red(`Could not find router instance in ${routesFile}.`))
115
- process.exit(1)
116
- }
117
-
118
- // Get routes from router
119
- const routes = (router as any).routes || []
120
-
121
- if (routes.length === 0) {
122
- console.log(chalk.yellow('No routes defined. Creating empty types file.'))
123
- }
124
-
125
- // Collect named routes or generate names for unnamed routes
126
- const routeNames = routes.map((route: any) => {
127
- // If route has a name, use it
128
- if (route.name)
129
- return route.name
130
-
131
- // Otherwise generate a name based on method and path
132
- const methodLower = route.method.toLowerCase()
133
- const pathFormatted = route.path
134
- .replace(/^\//, '') // Remove leading slash
135
- .replace(/\//g, '.') // Replace other slashes with dots
136
- .replace(/\{([^}]+)\}/g, ':$1') // Replace {param} with :param
137
-
138
- return pathFormatted ? `${methodLower}.${pathFormatted}` : methodLower
139
- })
140
-
141
- // Remove duplicates
142
- const uniqueRouteNames = [...new Set(routeNames)]
143
-
144
- // Generate type definition
145
- const typeContent = `/**
146
- * This file is auto-generated.
147
- * DO NOT EDIT THIS FILE DIRECTLY.
148
- * To update, run 'bun router route:types'
149
- */
150
-
151
- /**
152
- * String literal type for all available route names
153
- */
154
- export type RouteName = ${uniqueRouteNames.length > 0
155
- ? uniqueRouteNames.map(name => `'${name}'`).join(' | ')
156
- : 'string'}
157
-
158
- /**
159
- * Object type with route names as keys and string (for path generation) as values
160
- */
161
- export interface RouteNameMap {
162
- ${uniqueRouteNames.map(name => ` '${name}': string`).join('\n')}
163
- }
164
-
165
- /**
166
- * Type-safe function to generate a URL for a named route
167
- */
168
- export type RouteFunction = <T extends RouteName>(name: T, params?: Record<string, string>) => string
169
-
170
- /**
171
- * Validate that a string is a valid route name
172
- */
173
- export function isValidRouteName(name: string): name is RouteName {
174
- return [${uniqueRouteNames.map(name => `'${name}'`).join(', ')}].includes(name)
175
- }
176
- `
177
-
178
- // Write to file
179
- await fs.writeFile(outputPath, typeContent)
180
- console.log(chalk.green(`✨ Route types generated at ${outputPath}`))
181
- }
182
- catch (error: any) {
183
- if (error.code === 'ERR_MODULE_NOT_FOUND') {
184
- console.error(chalk.red(`Routes file not found at ${process.cwd()}/routes/index.ts`))
185
- console.error(chalk.yellow('Make sure your routes are defined and exported as "router" in routes/index.ts'))
186
- }
187
- else {
188
- console.error(chalk.red(`Error generating route types: ${error.message}`))
189
- }
190
- throw error
191
- }
192
- }
193
-
194
- /**
195
- * Watch for changes in the routes directory and regenerate types
196
- */
197
- export async function watchRoutesDirectory(outputPath: string): Promise<void> {
198
- const routesPath = path.join(process.cwd(), 'routes')
199
-
200
- // Check if routes directory exists
201
- try {
202
- await fs.access(routesPath)
203
- }
204
- catch {
205
- console.error(chalk.red(`Routes directory not found at ${routesPath}`))
206
- process.exit(1)
207
- }
208
-
209
- // Initial generation
210
- await generateRouteTypes(outputPath)
211
- console.log(chalk.green(`✨ Route types generated at ${outputPath}`))
212
- console.log(chalk.blue(`Watching for changes in ${routesPath}...`))
213
-
214
- // Setup file watcher
215
- let timeoutId: ReturnType<typeof setTimeout> | null = null
216
- const watcher = fs.watch(routesPath, { recursive: true })
217
-
218
- for await (const _event of watcher) {
219
- // Debounce to avoid multiple regenerations when multiple files change
220
- if (timeoutId) {
221
- clearTimeout(timeoutId)
222
- }
223
-
224
- timeoutId = setTimeout(async () => {
225
- console.log(chalk.yellow(`Changes detected in routes directory. Regenerating types...`))
226
- try {
227
- await generateRouteTypes(outputPath)
228
- console.log(chalk.green(`✨ Route types regenerated at ${outputPath}`))
229
- }
230
- catch (error: any) {
231
- console.error(chalk.red(`Error regenerating types: ${error.message}`))
232
- }
233
- timeoutId = null
234
- }, 500)
235
- }
236
- }
237
-
238
- /**
239
- * Pad a string to a specific length
240
- */
241
- function padString(str: string, length: number): string {
242
- return (str + ' '.repeat(length)).substring(0, length)
243
- }
244
-
245
- /**
246
- * Get the appropriate color for an HTTP method
247
- */
248
- function getMethodColor(method: string) {
249
- switch (method.toUpperCase()) {
250
- case 'GET':
251
- return chalk.cyan
252
- case 'POST':
253
- return chalk.green
254
- case 'PUT':
255
- return chalk.yellow
256
- case 'PATCH':
257
- return chalk.yellow
258
- case 'DELETE':
259
- return chalk.red
260
- case 'OPTIONS':
261
- return chalk.gray
262
- default:
263
- return chalk.white
264
- }
265
- }