@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,257 +0,0 @@
1
- import type { EnhancedRequest, MiddlewareHandler, NextFunction } from '../types'
2
- import { config } from '../config'
3
- import ContentSecurityPolicy from './content_security_policy'
4
- import DDoSProtection from './ddos_protection'
5
- import Helmet from './helmet'
6
- import InputValidation from './input_validation'
7
- import Security from './security'
8
-
9
- export interface SecuritySuiteOptions {
10
- helmet?: boolean | object
11
- security?: boolean | object
12
- ddosProtection?: boolean | object
13
- inputValidation?: boolean | object
14
- contentSecurityPolicy?: boolean | object
15
- order?: string[]
16
- }
17
-
18
- /**
19
- * Comprehensive security middleware suite that combines multiple security layers
20
- */
21
- export default class SecuritySuite {
22
- private middlewares: MiddlewareHandler[] = []
23
-
24
- constructor(options: SecuritySuiteOptions = {}) {
25
- const securityConfig = (config.server?.security || {}) as any
26
-
27
- // Default order of security middleware execution
28
- const defaultOrder = [
29
- 'ddosProtection',
30
- 'security',
31
- 'helmet',
32
- 'contentSecurityPolicy',
33
- 'inputValidation',
34
- ]
35
-
36
- const order = options.order || defaultOrder
37
-
38
- // Initialize middleware based on configuration and order
39
- for (const middlewareName of order) {
40
- switch (middlewareName) {
41
- case 'ddosProtection':
42
- if (options.ddosProtection !== false && securityConfig.ddos?.enabled !== false) {
43
- const ddosOptions = typeof options.ddosProtection === 'object'
44
- ? options.ddosProtection
45
- : {}
46
- const ddosInstance = new DDoSProtection(ddosOptions)
47
- this.middlewares.push((req: EnhancedRequest, next: NextFunction) =>
48
- ddosInstance.handle(req, next),
49
- )
50
- }
51
- break
52
-
53
- case 'security':
54
- if (options.security !== false) {
55
- const securityOptions = typeof options.security === 'object'
56
- ? options.security
57
- : {}
58
- const securityInstance = new Security(securityOptions)
59
- this.middlewares.push((req: EnhancedRequest, next: NextFunction) =>
60
- securityInstance.handle(req, next),
61
- )
62
- }
63
- break
64
-
65
- case 'helmet':
66
- if (options.helmet !== false && securityConfig.helmet?.enabled !== false) {
67
- const helmetOptions = typeof options.helmet === 'object'
68
- ? options.helmet
69
- : {}
70
- const helmetInstance = new Helmet(helmetOptions)
71
- this.middlewares.push((req: EnhancedRequest, next: NextFunction) =>
72
- helmetInstance.handle(req, next),
73
- )
74
- }
75
- break
76
-
77
- case 'contentSecurityPolicy':
78
- if (options.contentSecurityPolicy !== false
79
- && securityConfig.helmet?.contentSecurityPolicy !== false) {
80
- const cspOptions = typeof options.contentSecurityPolicy === 'object'
81
- ? options.contentSecurityPolicy
82
- : {}
83
- const cspInstance = new ContentSecurityPolicy(cspOptions)
84
- this.middlewares.push((req: EnhancedRequest, next: NextFunction) =>
85
- cspInstance.handle(req, next),
86
- )
87
- }
88
- break
89
-
90
- case 'inputValidation':
91
- if (options.inputValidation !== false
92
- && securityConfig.inputValidation?.enabled !== false) {
93
- const validationOptions = typeof options.inputValidation === 'object'
94
- ? options.inputValidation
95
- : {}
96
- const validationInstance = new InputValidation(validationOptions)
97
- this.middlewares.push((req: EnhancedRequest, next: NextFunction) =>
98
- validationInstance.handle(req, next),
99
- )
100
- }
101
- break
102
- }
103
- }
104
- }
105
-
106
- async handle(req: EnhancedRequest, next: NextFunction): Promise<Response | null> {
107
- // Execute all security middleware in sequence
108
- let currentIndex = 0
109
-
110
- const executeNext = async (): Promise<Response | null> => {
111
- if (currentIndex >= this.middlewares.length) {
112
- return await next()
113
- }
114
-
115
- const middleware = this.middlewares[currentIndex++]
116
- return await middleware(req, executeNext)
117
- }
118
-
119
- return await executeNext()
120
- }
121
- }
122
-
123
- /**
124
- * Factory function to create a security suite middleware
125
- */
126
- export function securitySuite(options: SecuritySuiteOptions = {}): MiddlewareHandler {
127
- const instance = new SecuritySuite(options)
128
- return async (req: EnhancedRequest, next: NextFunction) => instance.handle(req, next)
129
- }
130
-
131
- /**
132
- * Preset configurations for different security levels
133
- */
134
- export const securityPresets = {
135
- /**
136
- * Basic security - minimal performance impact
137
- */
138
- basic: (): MiddlewareHandler => securitySuite({
139
- helmet: true,
140
- security: {
141
- attackPrevention: { enabled: true },
142
- requestFiltering: { enabled: true },
143
- responseSecurity: { enabled: true },
144
- },
145
- ddosProtection: false,
146
- inputValidation: false,
147
- contentSecurityPolicy: false,
148
- }),
149
-
150
- /**
151
- * Standard security - balanced security and performance
152
- */
153
- standard: (): MiddlewareHandler => securitySuite({
154
- helmet: true,
155
- security: true,
156
- ddosProtection: {
157
- enabled: true,
158
- maxRequestsPerMinute: 200,
159
- burstLimit: 50,
160
- },
161
- inputValidation: {
162
- enabled: true,
163
- sanitizeByDefault: true,
164
- },
165
- contentSecurityPolicy: false,
166
- }),
167
-
168
- /**
169
- * High security - maximum protection
170
- */
171
- high: (): MiddlewareHandler => securitySuite({
172
- helmet: true,
173
- security: true,
174
- ddosProtection: {
175
- enabled: true,
176
- maxRequestsPerMinute: 100,
177
- burstLimit: 20,
178
- blockDuration: 600000, // 10 minutes
179
- },
180
- inputValidation: {
181
- enabled: true,
182
- sanitizeByDefault: true,
183
- strictMode: true,
184
- },
185
- contentSecurityPolicy: {
186
- directives: {
187
- 'default-src': ['\'self\''],
188
- 'script-src': ['\'self\''],
189
- 'style-src': ['\'self\''],
190
- 'img-src': ['\'self\'', 'data:'],
191
- 'font-src': ['\'self\''],
192
- 'connect-src': ['\'self\''],
193
- 'media-src': ['\'self\''],
194
- 'object-src': ['\'none\''],
195
- 'child-src': ['\'none\''],
196
- 'worker-src': ['\'self\''],
197
- 'frame-ancestors': ['\'none\''],
198
- 'form-action': ['\'self\''],
199
- 'base-uri': ['\'self\''],
200
- 'manifest-src': ['\'self\''],
201
- },
202
- },
203
- }),
204
-
205
- /**
206
- * API security - optimized for API endpoints
207
- */
208
- api: (): MiddlewareHandler => securitySuite({
209
- helmet: {
210
- contentSecurityPolicy: false, // Not needed for APIs
211
- frameguard: false,
212
- },
213
- security: {
214
- attackPrevention: { enabled: true },
215
- requestFiltering: {
216
- enabled: true,
217
- allowedMethods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH'],
218
- },
219
- responseSecurity: { enabled: true },
220
- },
221
- ddosProtection: {
222
- enabled: true,
223
- maxRequestsPerMinute: 500,
224
- burstLimit: 100,
225
- },
226
- inputValidation: {
227
- enabled: true,
228
- sanitizeByDefault: true,
229
- },
230
- contentSecurityPolicy: false,
231
- }),
232
-
233
- /**
234
- * Development security - minimal restrictions for development
235
- */
236
- development: (): MiddlewareHandler => securitySuite({
237
- helmet: {
238
- contentSecurityPolicy: false,
239
- hsts: false,
240
- },
241
- security: {
242
- attackPrevention: { enabled: true },
243
- requestFiltering: {
244
- enabled: false,
245
- blockSuspiciousPatterns: false,
246
- },
247
- responseSecurity: { enabled: false },
248
- },
249
- ddosProtection: false,
250
- inputValidation: {
251
- enabled: true,
252
- sanitizeByDefault: false,
253
- strictMode: false,
254
- },
255
- contentSecurityPolicy: false,
256
- }),
257
- }
@@ -1,91 +0,0 @@
1
- import type { EnhancedRequest, NextFunction } from '../types'
2
- import type { SessionStore, SessionData } from '../types/core'
3
- import { config } from '../config'
4
- import { MemorySessionStore } from '../session/memory-store'
5
- import { SessionManager, generateSessionId } from '../session/index'
6
-
7
- /**
8
- * Session middleware with pluggable store support.
9
- *
10
- * By default uses an in-memory store. Configure with a different store
11
- * for persistent sessions (file, redis, database).
12
- *
13
- * @example
14
- * // Use default memory store
15
- * const session = new Session()
16
- *
17
- * // Use a custom store
18
- * import { RedisSessionStore } from 'bun-router/session'
19
- * const session = new Session({ store: new RedisSessionStore(redisClient) })
20
- */
21
- export default class Session {
22
- private store: SessionStore<SessionData>
23
-
24
- constructor(options?: { store?: SessionStore<SessionData> }) {
25
- this.store = options?.store || new MemorySessionStore()
26
- }
27
-
28
- async handle(req: EnhancedRequest, next: NextFunction): Promise<Response> {
29
- const sessionConfig = config.server?.security?.auth?.session
30
-
31
- const cookieName = sessionConfig?.name || 'session'
32
-
33
- // Get session ID from cookie or generate a new one
34
- let sessionId = req.cookies?.get(cookieName) || ''
35
- let isNewSession = false
36
-
37
- if (!sessionId) {
38
- sessionId = generateSessionId()
39
- isNewSession = true
40
- }
41
-
42
- // Load session data from store
43
- let sessionData = isNewSession ? null : await this.store.get(sessionId)
44
-
45
- if (!sessionData) {
46
- sessionData = { id: sessionId }
47
- isNewSession = true
48
- }
49
-
50
- // Create session manager and attach to request
51
- const manager = new SessionManager(sessionId, sessionData, this.store)
52
- req.session = manager as any
53
-
54
- // Continue to next middleware/handler
55
- const response = await next()
56
-
57
- // Save session after the response
58
- await manager.save()
59
-
60
- // Set session cookie on the response
61
- const cookieOptions: any = {
62
- maxAge: sessionConfig?.cookie?.maxAge || 86400000,
63
- path: sessionConfig?.cookie?.path || '/',
64
- }
65
-
66
- if (sessionConfig?.cookie?.httpOnly !== false) {
67
- cookieOptions.httpOnly = true
68
- }
69
-
70
- if (sessionConfig?.cookie?.secure) {
71
- cookieOptions.secure = true
72
- }
73
-
74
- if (sessionConfig?.cookie?.sameSite) {
75
- cookieOptions.sameSite = sessionConfig.cookie.sameSite
76
- }
77
-
78
- // Add cookie to response via _cookiesToSet array
79
- if (!req._cookiesToSet) {
80
- req._cookiesToSet = []
81
- }
82
-
83
- req._cookiesToSet.push({
84
- name: cookieName,
85
- value: manager.id,
86
- options: cookieOptions,
87
- })
88
-
89
- return response || new Response('Not Found', { status: 404 })
90
- }
91
- }
@@ -1,18 +0,0 @@
1
- export {
2
- bindModel,
3
- createModelBindingMiddleware,
4
- ModelBindingFactory,
5
- type ModelBindingMiddlewareOptions,
6
- ModelBindingUtils,
7
- TypedModelBinding,
8
- withModelBinding,
9
- } from './model-middleware'
10
-
11
- export {
12
- type ModelBindingConfig,
13
- ModelFactory,
14
- ModelRegistry,
15
- modelRegistry,
16
- type ModelResolutionResult,
17
- ModelUtils,
18
- } from './model-registry'