@stacksjs/bun-router 0.0.17 → 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 (146) hide show
  1. package/dist/cli.js +1 -1
  2. package/dist/container/service-provider.d.ts +3 -3
  3. package/dist/development/performance-profiler.d.ts +3 -3
  4. package/dist/development/route-debugger.d.ts +1 -1
  5. package/dist/development/route-inspector.d.ts +2 -2
  6. package/dist/observability/integration.d.ts +1 -1
  7. package/dist/response/macros.d.ts +1 -1
  8. package/dist/router/index.d.ts +7 -7
  9. package/dist/router/router.d.ts +0 -32
  10. package/dist/testing/performance-testing.d.ts +2 -2
  11. package/dist/testing/test-client.d.ts +1 -1
  12. package/dist/testing/websocket-testing.d.ts +1 -1
  13. package/package.json +2 -3
  14. package/src/auth.ts +0 -489
  15. package/src/cache/lru-cache.ts +0 -457
  16. package/src/cache/middleware-memoization.ts +0 -531
  17. package/src/cache/route-cache-warmer.ts +0 -486
  18. package/src/cache/sqlite-cache.ts +0 -783
  19. package/src/cache/streaming-cache.ts +0 -572
  20. package/src/cli/colors.ts +0 -29
  21. package/src/cli/index.ts +0 -287
  22. package/src/cli/middleware.ts +0 -291
  23. package/src/cli/openapi.ts +0 -407
  24. package/src/cli/router.ts +0 -188
  25. package/src/cli/routes.ts +0 -265
  26. package/src/cli/utils.ts +0 -531
  27. package/src/cli.ts +0 -5
  28. package/src/config.ts +0 -322
  29. package/src/container/container.ts +0 -786
  30. package/src/container/contextual-binding.ts +0 -606
  31. package/src/container/decorators.ts +0 -368
  32. package/src/container/index.ts +0 -49
  33. package/src/container/service-provider.ts +0 -596
  34. package/src/development/hot-reload.ts +0 -673
  35. package/src/development/index.ts +0 -499
  36. package/src/development/performance-profiler.ts +0 -717
  37. package/src/development/route-debugger.ts +0 -527
  38. package/src/development/route-inspector.ts +0 -749
  39. package/src/development/typescript-utilities.ts +0 -682
  40. package/src/docs.ts +0 -397
  41. package/src/errors/circuit-breaker.ts +0 -733
  42. package/src/errors/error-handler.ts +0 -569
  43. package/src/errors/error-reporting.ts +0 -672
  44. package/src/errors/exceptions.ts +0 -536
  45. package/src/errors/graceful-degradation.ts +0 -623
  46. package/src/errors/index.ts +0 -21
  47. package/src/errors/router-errors.ts +0 -632
  48. package/src/file-serving/static-files.ts +0 -718
  49. package/src/index.ts +0 -66
  50. package/src/middleware/auth.ts +0 -220
  51. package/src/middleware/content_security_policy.ts +0 -215
  52. package/src/middleware/cors.ts +0 -142
  53. package/src/middleware/csrf.ts +0 -166
  54. package/src/middleware/ddos_protection.ts +0 -279
  55. package/src/middleware/file_security.ts +0 -191
  56. package/src/middleware/file_upload.ts +0 -275
  57. package/src/middleware/helmet.ts +0 -268
  58. package/src/middleware/index.ts +0 -117
  59. package/src/middleware/input_validation.ts +0 -453
  60. package/src/middleware/json_body.ts +0 -37
  61. package/src/middleware/performance_alerting.ts +0 -540
  62. package/src/middleware/performance_dashboard.ts +0 -661
  63. package/src/middleware/performance_monitor.ts +0 -945
  64. package/src/middleware/pipeline.ts +0 -489
  65. package/src/middleware/rate_limit.ts +0 -251
  66. package/src/middleware/request_id.ts +0 -36
  67. package/src/middleware/request_signing.ts +0 -638
  68. package/src/middleware/request_tracer.ts +0 -653
  69. package/src/middleware/response_cache.ts +0 -778
  70. package/src/middleware/security.ts +0 -482
  71. package/src/middleware/security_suite.ts +0 -257
  72. package/src/middleware/session.ts +0 -91
  73. package/src/model-binding/index.ts +0 -18
  74. package/src/model-binding/model-middleware.ts +0 -425
  75. package/src/model-binding/model-registry.ts +0 -550
  76. package/src/model-binding.ts +0 -370
  77. package/src/model-resolver-factory.ts +0 -106
  78. package/src/observability/correlation.ts +0 -691
  79. package/src/observability/health-checks.ts +0 -729
  80. package/src/observability/index.ts +0 -184
  81. package/src/observability/integration.ts +0 -548
  82. package/src/observability/metrics.ts +0 -753
  83. package/src/observability/tracing.ts +0 -638
  84. package/src/optimization/bun-utilities.ts +0 -778
  85. package/src/query-builder-integration.ts +0 -137
  86. package/src/request/context.ts +0 -109
  87. package/src/request/enhanced-request.ts +0 -876
  88. package/src/request/macros.ts +0 -822
  89. package/src/response/macros.ts +0 -665
  90. package/src/response/response-factory.ts +0 -596
  91. package/src/router/api-routes.ts +0 -243
  92. package/src/router/file-based-routing.ts +0 -697
  93. package/src/router/file-streaming.ts +0 -383
  94. package/src/router/fluent-routing.ts +0 -866
  95. package/src/router/group-organization.ts +0 -229
  96. package/src/router/handler-resolver.ts +0 -327
  97. package/src/router/http-methods.ts +0 -407
  98. package/src/router/index.ts +0 -193
  99. package/src/router/middleware-groups.ts +0 -222
  100. package/src/router/middleware-integration.ts +0 -399
  101. package/src/router/middleware.ts +0 -234
  102. package/src/router/model-binding.ts +0 -215
  103. package/src/router/optimized-route-matching.ts +0 -302
  104. package/src/router/route-building.ts +0 -221
  105. package/src/router/route-compiler.ts +0 -691
  106. package/src/router/route-matching.ts +0 -368
  107. package/src/router/route-trie.ts +0 -450
  108. package/src/router/router.ts +0 -1616
  109. package/src/router/server.ts +0 -684
  110. package/src/router/validation-integration.ts +0 -449
  111. package/src/router/view-rendering.ts +0 -233
  112. package/src/router/websocket.ts +0 -100
  113. package/src/routing/route-caching.ts +0 -402
  114. package/src/routing/route-throttling.ts +0 -469
  115. package/src/routing/subdomain-routing.ts +0 -492
  116. package/src/session/database-store.ts +0 -109
  117. package/src/session/file-store.ts +0 -148
  118. package/src/session/index.ts +0 -244
  119. package/src/session/memory-store.ts +0 -88
  120. package/src/session/redis-store.ts +0 -93
  121. package/src/streaming/index.ts +0 -17
  122. package/src/streaming/sse-handler.ts +0 -482
  123. package/src/streaming/stream-handler.ts +0 -552
  124. package/src/testing/auth-testing.ts +0 -448
  125. package/src/testing/file-upload-testing.ts +0 -543
  126. package/src/testing/index.ts +0 -10
  127. package/src/testing/middleware-testing.ts +0 -322
  128. package/src/testing/model-binding-testing.ts +0 -645
  129. package/src/testing/performance-testing.ts +0 -738
  130. package/src/testing/test-client.ts +0 -310
  131. package/src/testing/test-request.ts +0 -315
  132. package/src/testing/test-response.ts +0 -332
  133. package/src/testing/types.ts +0 -224
  134. package/src/testing/websocket-testing.ts +0 -590
  135. package/src/types/controller-types.ts +0 -385
  136. package/src/types/core.ts +0 -683
  137. package/src/types/middleware-types.ts +0 -422
  138. package/src/types/request-response-augmentation.ts +0 -489
  139. package/src/types/route-inference.ts +0 -372
  140. package/src/types.ts +0 -2123
  141. package/src/url.ts +0 -131
  142. package/src/utils/index.ts +0 -1
  143. package/src/utils/query-preservation.ts +0 -201
  144. package/src/utils.ts +0 -395
  145. package/src/validation/validator.ts +0 -688
  146. package/src/websocket/clustering.ts +0 -769
@@ -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 { CookieOptions, 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
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: CookieOptions = {
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'