@stacksjs/bun-router 0.0.12 → 0.0.14

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 (273) hide show
  1. package/CHANGELOG.md +770 -0
  2. package/README.md +584 -261
  3. package/package.json +43 -48
  4. package/bin/cli.ts +0 -9
  5. package/dist/auth.d.ts +0 -134
  6. package/dist/cache/lru-cache.d.ts +0 -139
  7. package/dist/cache/middleware-memoization.d.ts +0 -151
  8. package/dist/cache/route-cache-warmer.d.ts +0 -161
  9. package/dist/cache/sqlite-cache.d.ts +0 -209
  10. package/dist/cache/streaming-cache.d.ts +0 -132
  11. package/dist/chunk-1mvtv6jw.js +0 -13012
  12. package/dist/cli/colors.d.ts +0 -15
  13. package/dist/cli/index.d.ts +0 -10
  14. package/dist/cli/middleware.d.ts +0 -31
  15. package/dist/cli/openapi.d.ts +0 -17
  16. package/dist/cli/router.d.ts +0 -15
  17. package/dist/cli/routes.d.ts +0 -29
  18. package/dist/cli/utils.d.ts +0 -74
  19. package/dist/cli.d.ts +0 -1
  20. package/dist/cli.js +0 -3195
  21. package/dist/config.d.ts +0 -7
  22. package/dist/container/container.d.ts +0 -273
  23. package/dist/container/contextual-binding.d.ts +0 -240
  24. package/dist/container/decorators.d.ts +0 -141
  25. package/dist/container/service-provider.d.ts +0 -285
  26. package/dist/development/hot-reload.d.ts +0 -187
  27. package/dist/development/index.d.ts +0 -167
  28. package/dist/development/performance-profiler.d.ts +0 -217
  29. package/dist/development/route-debugger.d.ts +0 -154
  30. package/dist/development/route-inspector.d.ts +0 -211
  31. package/dist/development/typescript-utilities.d.ts +0 -209
  32. package/dist/docs.d.ts +0 -11
  33. package/dist/errors/circuit-breaker.d.ts +0 -195
  34. package/dist/errors/error-handler.d.ts +0 -88
  35. package/dist/errors/error-reporting.d.ts +0 -144
  36. package/dist/errors/exceptions.d.ts +0 -184
  37. package/dist/errors/graceful-degradation.d.ts +0 -154
  38. package/dist/errors/index.d.ts +0 -9
  39. package/dist/errors/router-errors.d.ts +0 -110
  40. package/dist/file-serving/static-files.d.ts +0 -143
  41. package/dist/index.d.ts +0 -14
  42. package/dist/index.js +0 -13933
  43. package/dist/middleware/auth.d.ts +0 -63
  44. package/dist/middleware/content_security_policy.d.ts +0 -53
  45. package/dist/middleware/cors.d.ts +0 -5
  46. package/dist/middleware/csrf.d.ts +0 -7
  47. package/dist/middleware/ddos_protection.d.ts +0 -39
  48. package/dist/middleware/file_security.d.ts +0 -26
  49. package/dist/middleware/file_upload.d.ts +0 -38
  50. package/dist/middleware/helmet.d.ts +0 -54
  51. package/dist/middleware/index.d.ts +0 -44
  52. package/dist/middleware/input_validation.d.ts +0 -45
  53. package/dist/middleware/json_body.d.ts +0 -4
  54. package/dist/middleware/performance_alerting.d.ts +0 -87
  55. package/dist/middleware/performance_dashboard.d.ts +0 -87
  56. package/dist/middleware/performance_monitor.d.ts +0 -209
  57. package/dist/middleware/pipeline.d.ts +0 -131
  58. package/dist/middleware/rate_limit.d.ts +0 -36
  59. package/dist/middleware/request_id.d.ts +0 -4
  60. package/dist/middleware/request_signing.d.ts +0 -153
  61. package/dist/middleware/request_tracer.d.ts +0 -72
  62. package/dist/middleware/response_cache.d.ts +0 -97
  63. package/dist/middleware/security.d.ts +0 -69
  64. package/dist/middleware/security_suite.d.ts +0 -46
  65. package/dist/middleware/session.d.ts +0 -23
  66. package/dist/model-binding/index.d.ts +0 -2
  67. package/dist/model-binding/model-middleware.d.ts +0 -118
  68. package/dist/model-binding/model-registry.d.ts +0 -164
  69. package/dist/model-binding.d.ts +0 -185
  70. package/dist/model-resolver-factory.d.ts +0 -31
  71. package/dist/observability/correlation.d.ts +0 -187
  72. package/dist/observability/health-checks.d.ts +0 -186
  73. package/dist/observability/index.d.ts +0 -60
  74. package/dist/observability/integration.d.ts +0 -147
  75. package/dist/observability/metrics.d.ts +0 -184
  76. package/dist/observability/tracing.d.ts +0 -187
  77. package/dist/optimization/bun-utilities.d.ts +0 -224
  78. package/dist/query-builder-integration.d.ts +0 -36
  79. package/dist/request/context.d.ts +0 -34
  80. package/dist/request/enhanced-request.d.ts +0 -213
  81. package/dist/request/macros.d.ts +0 -300
  82. package/dist/response/macros.d.ts +0 -245
  83. package/dist/response/response-factory.d.ts +0 -133
  84. package/dist/router/api-routes.d.ts +0 -5
  85. package/dist/router/file-based-routing.d.ts +0 -118
  86. package/dist/router/file-streaming.d.ts +0 -5
  87. package/dist/router/fluent-router.d.ts +0 -315
  88. package/dist/router/fluent-routing.d.ts +0 -271
  89. package/dist/router/group-organization.d.ts +0 -5
  90. package/dist/router/handler-resolver.d.ts +0 -24
  91. package/dist/router/http-methods.d.ts +0 -10
  92. package/dist/router/index.d.ts +0 -114
  93. package/dist/router/middleware-groups.d.ts +0 -94
  94. package/dist/router/middleware-integration.d.ts +0 -112
  95. package/dist/router/middleware.d.ts +0 -5
  96. package/dist/router/model-binding.d.ts +0 -5
  97. package/dist/router/optimized-route-matching.d.ts +0 -6
  98. package/dist/router/route-building.d.ts +0 -5
  99. package/dist/router/route-compiler.d.ts +0 -153
  100. package/dist/router/route-matching.d.ts +0 -5
  101. package/dist/router/route-trie.d.ts +0 -114
  102. package/dist/router/router.d.ts +0 -294
  103. package/dist/router/server.d.ts +0 -5
  104. package/dist/router/validation-integration.d.ts +0 -170
  105. package/dist/router/view-rendering.d.ts +0 -5
  106. package/dist/router/websocket.d.ts +0 -5
  107. package/dist/routing/route-caching.d.ts +0 -129
  108. package/dist/routing/route-throttling.d.ts +0 -150
  109. package/dist/routing/subdomain-routing.d.ts +0 -206
  110. package/dist/session/database-store.d.ts +0 -51
  111. package/dist/session/file-store.d.ts +0 -22
  112. package/dist/session/index.d.ts +0 -106
  113. package/dist/session/memory-store.d.ts +0 -21
  114. package/dist/session/redis-store.d.ts +0 -31
  115. package/dist/streaming/index.d.ts +0 -3
  116. package/dist/streaming/sse-handler.d.ts +0 -138
  117. package/dist/streaming/stream-handler.d.ts +0 -114
  118. package/dist/testing/auth-testing.d.ts +0 -156
  119. package/dist/testing/file-upload-testing.d.ts +0 -190
  120. package/dist/testing/index.d.ts +0 -10
  121. package/dist/testing/middleware-testing.d.ts +0 -138
  122. package/dist/testing/model-binding-testing.d.ts +0 -186
  123. package/dist/testing/performance-testing.d.ts +0 -235
  124. package/dist/testing/test-client.d.ts +0 -117
  125. package/dist/testing/test-request.d.ts +0 -85
  126. package/dist/testing/test-response.d.ts +0 -90
  127. package/dist/testing/types.d.ts +0 -207
  128. package/dist/testing/websocket-testing.d.ts +0 -227
  129. package/dist/types/controller-types.d.ts +0 -208
  130. package/dist/types/core.d.ts +0 -543
  131. package/dist/types/middleware-types.d.ts +0 -227
  132. package/dist/types/request-response-augmentation.d.ts +0 -261
  133. package/dist/types/route-inference.d.ts +0 -168
  134. package/dist/types.d.ts +0 -1782
  135. package/dist/url.d.ts +0 -56
  136. package/dist/utils/index.d.ts +0 -1
  137. package/dist/utils/query-preservation.d.ts +0 -48
  138. package/dist/utils.d.ts +0 -69
  139. package/dist/validation/validator.d.ts +0 -140
  140. package/dist/websocket/clustering.d.ts +0 -185
  141. package/src/auth.ts +0 -469
  142. package/src/cache/lru-cache.ts +0 -457
  143. package/src/cache/middleware-memoization.ts +0 -531
  144. package/src/cache/route-cache-warmer.ts +0 -486
  145. package/src/cache/sqlite-cache.ts +0 -783
  146. package/src/cache/streaming-cache.ts +0 -572
  147. package/src/cli/colors.ts +0 -29
  148. package/src/cli/index.ts +0 -287
  149. package/src/cli/middleware.ts +0 -291
  150. package/src/cli/openapi.ts +0 -407
  151. package/src/cli/router.ts +0 -188
  152. package/src/cli/routes.ts +0 -265
  153. package/src/cli/utils.ts +0 -531
  154. package/src/cli.ts +0 -5
  155. package/src/config.ts +0 -322
  156. package/src/container/container.ts +0 -740
  157. package/src/container/contextual-binding.ts +0 -603
  158. package/src/container/decorators.ts +0 -359
  159. package/src/container/service-provider.ts +0 -596
  160. package/src/development/hot-reload.ts +0 -673
  161. package/src/development/index.ts +0 -499
  162. package/src/development/performance-profiler.ts +0 -717
  163. package/src/development/route-debugger.ts +0 -527
  164. package/src/development/route-inspector.ts +0 -749
  165. package/src/development/typescript-utilities.ts +0 -682
  166. package/src/docs.ts +0 -397
  167. package/src/errors/circuit-breaker.ts +0 -732
  168. package/src/errors/error-handler.ts +0 -569
  169. package/src/errors/error-reporting.ts +0 -672
  170. package/src/errors/exceptions.ts +0 -536
  171. package/src/errors/graceful-degradation.ts +0 -621
  172. package/src/errors/index.ts +0 -21
  173. package/src/errors/router-errors.ts +0 -632
  174. package/src/file-serving/static-files.ts +0 -581
  175. package/src/index.ts +0 -14
  176. package/src/middleware/auth.ts +0 -219
  177. package/src/middleware/content_security_policy.ts +0 -215
  178. package/src/middleware/cors.ts +0 -74
  179. package/src/middleware/csrf.ts +0 -108
  180. package/src/middleware/ddos_protection.ts +0 -255
  181. package/src/middleware/file_security.ts +0 -191
  182. package/src/middleware/file_upload.ts +0 -264
  183. package/src/middleware/helmet.ts +0 -268
  184. package/src/middleware/index.ts +0 -117
  185. package/src/middleware/input_validation.ts +0 -449
  186. package/src/middleware/json_body.ts +0 -37
  187. package/src/middleware/performance_alerting.ts +0 -538
  188. package/src/middleware/performance_dashboard.ts +0 -661
  189. package/src/middleware/performance_monitor.ts +0 -943
  190. package/src/middleware/pipeline.ts +0 -489
  191. package/src/middleware/rate_limit.ts +0 -245
  192. package/src/middleware/request_id.ts +0 -36
  193. package/src/middleware/request_signing.ts +0 -636
  194. package/src/middleware/request_tracer.ts +0 -636
  195. package/src/middleware/response_cache.ts +0 -743
  196. package/src/middleware/security.ts +0 -482
  197. package/src/middleware/security_suite.ts +0 -257
  198. package/src/middleware/session.ts +0 -91
  199. package/src/model-binding/index.ts +0 -18
  200. package/src/model-binding/model-middleware.ts +0 -425
  201. package/src/model-binding/model-registry.ts +0 -550
  202. package/src/model-binding.ts +0 -370
  203. package/src/model-resolver-factory.ts +0 -106
  204. package/src/observability/correlation.ts +0 -691
  205. package/src/observability/health-checks.ts +0 -729
  206. package/src/observability/index.ts +0 -184
  207. package/src/observability/integration.ts +0 -548
  208. package/src/observability/metrics.ts +0 -753
  209. package/src/observability/tracing.ts +0 -638
  210. package/src/optimization/bun-utilities.ts +0 -778
  211. package/src/query-builder-integration.ts +0 -137
  212. package/src/request/context.ts +0 -62
  213. package/src/request/enhanced-request.ts +0 -857
  214. package/src/request/macros.ts +0 -688
  215. package/src/response/macros.ts +0 -612
  216. package/src/response/response-factory.ts +0 -596
  217. package/src/router/api-routes.ts +0 -243
  218. package/src/router/file-based-routing.ts +0 -670
  219. package/src/router/file-streaming.ts +0 -372
  220. package/src/router/fluent-router.ts +0 -927
  221. package/src/router/fluent-routing.ts +0 -797
  222. package/src/router/group-organization.ts +0 -213
  223. package/src/router/handler-resolver.ts +0 -291
  224. package/src/router/http-methods.ts +0 -377
  225. package/src/router/index.ts +0 -187
  226. package/src/router/middleware-groups.ts +0 -222
  227. package/src/router/middleware-integration.ts +0 -399
  228. package/src/router/middleware.ts +0 -231
  229. package/src/router/model-binding.ts +0 -215
  230. package/src/router/optimized-route-matching.ts +0 -253
  231. package/src/router/route-building.ts +0 -212
  232. package/src/router/route-compiler.ts +0 -702
  233. package/src/router/route-matching.ts +0 -349
  234. package/src/router/route-trie.ts +0 -464
  235. package/src/router/router.ts +0 -1581
  236. package/src/router/server.ts +0 -462
  237. package/src/router/validation-integration.ts +0 -443
  238. package/src/router/view-rendering.ts +0 -233
  239. package/src/router/websocket.ts +0 -100
  240. package/src/routing/route-caching.ts +0 -402
  241. package/src/routing/route-throttling.ts +0 -469
  242. package/src/routing/subdomain-routing.ts +0 -492
  243. package/src/session/database-store.ts +0 -109
  244. package/src/session/file-store.ts +0 -148
  245. package/src/session/index.ts +0 -244
  246. package/src/session/memory-store.ts +0 -88
  247. package/src/session/redis-store.ts +0 -93
  248. package/src/streaming/index.ts +0 -17
  249. package/src/streaming/sse-handler.ts +0 -482
  250. package/src/streaming/stream-handler.ts +0 -552
  251. package/src/testing/auth-testing.ts +0 -446
  252. package/src/testing/file-upload-testing.ts +0 -543
  253. package/src/testing/index.ts +0 -10
  254. package/src/testing/middleware-testing.ts +0 -322
  255. package/src/testing/model-binding-testing.ts +0 -645
  256. package/src/testing/performance-testing.ts +0 -738
  257. package/src/testing/test-client.ts +0 -310
  258. package/src/testing/test-request.ts +0 -315
  259. package/src/testing/test-response.ts +0 -332
  260. package/src/testing/types.ts +0 -224
  261. package/src/testing/websocket-testing.ts +0 -590
  262. package/src/types/controller-types.ts +0 -385
  263. package/src/types/core.ts +0 -683
  264. package/src/types/middleware-types.ts +0 -419
  265. package/src/types/request-response-augmentation.ts +0 -489
  266. package/src/types/route-inference.ts +0 -357
  267. package/src/types.ts +0 -2055
  268. package/src/url.ts +0 -126
  269. package/src/utils/index.ts +0 -1
  270. package/src/utils/query-preservation.ts +0 -201
  271. package/src/utils.ts +0 -327
  272. package/src/validation/validator.ts +0 -685
  273. 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'