@stacksjs/bun-router 0.0.13 → 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 -47
  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,446 +0,0 @@
1
- import type { CookieAccessor, CookieOptions, EnhancedRequest } from '../types'
2
- import type { JWTTestOptions, SessionTestOptions, TestUser } from './types'
3
- import { mock } from 'bun:test'
4
- import { createMockRequest } from './test-request'
5
-
6
- /**
7
- * Creates a CookieAccessor from a plain Record<string, string>
8
- */
9
- function createCookieAccessor(cookies: Record<string, string>): CookieAccessor {
10
- const cookieStore = { ...cookies }
11
- return {
12
- get: (name: string) => cookieStore[name],
13
- set: (name: string, value: string, _options?: CookieOptions) => {
14
- cookieStore[name] = value
15
- },
16
- delete: (name: string, _options?: CookieOptions) => {
17
- delete cookieStore[name]
18
- },
19
- getAll: () => ({ ...cookieStore }),
20
- }
21
- }
22
-
23
- /**
24
- * Authentication testing utilities
25
- */
26
- export class AuthTester {
27
- private request: EnhancedRequest
28
-
29
- constructor(request?: EnhancedRequest) {
30
- this.request = request || createMockRequest()
31
- }
32
-
33
- /**
34
- * Set authenticated user
35
- */
36
- as(user: TestUser): AuthTester {
37
- this.request.user = user
38
- return this
39
- }
40
-
41
- /**
42
- * Set JWT token
43
- */
44
- withJWT(token: string, type: 'Bearer' | 'Basic' = 'Bearer'): AuthTester {
45
- const headers = new Headers(this.request.headers)
46
- headers.set('Authorization', `${type} ${token}`)
47
- // Create a new request object with updated headers
48
- this.request = {
49
- ...this.request,
50
- headers,
51
- }
52
- return this
53
- }
54
-
55
- /**
56
- * Set session data
57
- */
58
- withSession(sessionData: any): AuthTester {
59
- this.request.session = sessionData
60
- return this
61
- }
62
-
63
- /**
64
- * Set API key
65
- */
66
- withApiKey(apiKey: string, headerName: string = 'X-API-Key'): AuthTester {
67
- const headers = new Headers(this.request.headers)
68
- headers.set(headerName, apiKey)
69
- this.request = { ...this.request, headers }
70
- return this
71
- }
72
-
73
- /**
74
- * Set basic auth credentials
75
- */
76
- withBasicAuth(username: string, password: string): AuthTester {
77
- const credentials = btoa(`${username}:${password}`)
78
- const headers = new Headers(this.request.headers)
79
- headers.set('Authorization', `Basic ${credentials}`)
80
- this.request = { ...this.request, headers }
81
- return this
82
- }
83
-
84
- /**
85
- * Set cookies for authentication
86
- */
87
- withAuthCookies(cookies: Record<string, string>): AuthTester {
88
- const existingCookies = this.request.cookies?.getAll() || {}
89
- this.request.cookies = createCookieAccessor({ ...existingCookies, ...cookies })
90
- return this
91
- }
92
-
93
- /**
94
- * Remove authentication
95
- */
96
- unauthenticated(): AuthTester {
97
- this.request.user = undefined
98
- this.request.session = undefined
99
- if (this.request.headers) {
100
- this.request.headers.delete('Authorization')
101
- }
102
- return this
103
- }
104
-
105
- /**
106
- * Get the configured request
107
- */
108
- getRequest(): EnhancedRequest {
109
- return this.request
110
- }
111
- }
112
-
113
- /**
114
- * JWT testing utilities
115
- */
116
- export class JWTTester {
117
- private options: JWTTestOptions
118
-
119
- constructor(options: JWTTestOptions = {}) {
120
- this.options = {
121
- secret: 'test-secret',
122
- expiresIn: '1h',
123
- algorithm: 'HS256',
124
- ...options,
125
- }
126
- }
127
-
128
- /**
129
- * Generate a test JWT token
130
- */
131
- generateToken(payload: Record<string, any> = {}): string {
132
- const header = {
133
- alg: this.options.algorithm,
134
- typ: 'JWT',
135
- ...this.options.headers,
136
- }
137
-
138
- const now = Math.floor(Date.now() / 1000)
139
- const exp = now + this.parseExpiresIn(this.options.expiresIn || '1h')
140
-
141
- const jwtPayload = {
142
- iat: now,
143
- exp,
144
- ...this.options.payload,
145
- ...payload,
146
- }
147
-
148
- // Simple JWT generation for testing (not cryptographically secure)
149
- const encodedHeader = btoa(JSON.stringify(header)).replace(/=/g, '')
150
- const encodedPayload = btoa(JSON.stringify(jwtPayload)).replace(/=/g, '')
151
- const signature = btoa(`${encodedHeader}.${encodedPayload}.${this.options.secret}`).replace(/=/g, '')
152
-
153
- return `${encodedHeader}.${encodedPayload}.${signature}`
154
- }
155
-
156
- /**
157
- * Generate an expired token
158
- */
159
- generateExpiredToken(payload: Record<string, any> = {}): string {
160
- const header = {
161
- alg: this.options.algorithm,
162
- typ: 'JWT',
163
- }
164
-
165
- const now = Math.floor(Date.now() / 1000)
166
- const jwtPayload = {
167
- iat: now - 7200, // 2 hours ago
168
- exp: now - 3600, // 1 hour ago (expired)
169
- ...payload,
170
- }
171
-
172
- const encodedHeader = btoa(JSON.stringify(header)).replace(/=/g, '')
173
- const encodedPayload = btoa(JSON.stringify(jwtPayload)).replace(/=/g, '')
174
- const signature = btoa(`${encodedHeader}.${encodedPayload}.${this.options.secret}`).replace(/=/g, '')
175
-
176
- return `${encodedHeader}.${encodedPayload}.${signature}`
177
- }
178
-
179
- /**
180
- * Generate an invalid token
181
- */
182
- generateInvalidToken(): string {
183
- return 'invalid.jwt.token'
184
- }
185
-
186
- /**
187
- * Decode a JWT token (for testing purposes)
188
- */
189
- decodeToken(token: string): { header: any, payload: any, signature: string } {
190
- const [header, payload, signature] = token.split('.')
191
-
192
- return {
193
- header: JSON.parse(atob(header)),
194
- payload: JSON.parse(atob(payload)),
195
- signature,
196
- }
197
- }
198
-
199
- private parseExpiresIn(expiresIn: string): number {
200
- const match = expiresIn.match(/^(\d+)([smhd])$/)
201
- if (!match)
202
- return 3600 // Default 1 hour
203
-
204
- const value = Number.parseInt(match[1])
205
- const unit = match[2]
206
-
207
- switch (unit) {
208
- case 's': return value
209
- case 'm': return value * 60
210
- case 'h': return value * 3600
211
- case 'd': return value * 86400
212
- default: return 3600
213
- }
214
- }
215
- }
216
-
217
- /**
218
- * Session testing utilities
219
- */
220
- export class SessionTester {
221
- private options: SessionTestOptions
222
-
223
- constructor(options: SessionTestOptions = {}) {
224
- this.options = {
225
- sessionId: `test-session-${Date.now()}`,
226
- maxAge: 3600000, // 1 hour
227
- secure: false,
228
- httpOnly: true,
229
- ...options,
230
- }
231
- }
232
-
233
- /**
234
- * Create a test session
235
- */
236
- createSession(data: Record<string, any> = {}): {
237
- sessionId: string
238
- data: Record<string, any>
239
- cookie: string
240
- } {
241
- const sessionData = {
242
- ...this.options.data,
243
- ...data,
244
- }
245
-
246
- const cookie = this.generateSessionCookie()
247
-
248
- return {
249
- sessionId: this.options.sessionId!,
250
- data: sessionData,
251
- cookie,
252
- }
253
- }
254
-
255
- /**
256
- * Generate session cookie string
257
- */
258
- generateSessionCookie(name: string = 'session'): string {
259
- const options = []
260
-
261
- if (this.options.maxAge) {
262
- options.push(`Max-Age=${Math.floor(this.options.maxAge / 1000)}`)
263
- }
264
-
265
- if (this.options.secure) {
266
- options.push('Secure')
267
- }
268
-
269
- if (this.options.httpOnly) {
270
- options.push('HttpOnly')
271
- }
272
-
273
- const optionsStr = options.length > 0 ? `; ${options.join('; ')}` : ''
274
- return `${name}=${this.options.sessionId}${optionsStr}`
275
- }
276
-
277
- /**
278
- * Create an expired session
279
- */
280
- createExpiredSession(): {
281
- sessionId: string
282
- data: Record<string, any>
283
- cookie: string
284
- } {
285
- const expiredOptions = {
286
- ...this.options,
287
- maxAge: -1, // Expired
288
- }
289
-
290
- const tester = new SessionTester(expiredOptions)
291
- return tester.createSession()
292
- }
293
- }
294
-
295
- /**
296
- * Authentication mock factories
297
- */
298
- export const authMocks = {
299
- /**
300
- * Create a mock user
301
- */
302
- user: (overrides: Partial<TestUser> = {}): TestUser => ({
303
- id: 1,
304
- email: 'test@example.com',
305
- username: 'testuser',
306
- roles: ['user'],
307
- permissions: ['read'],
308
- ...overrides,
309
- }),
310
-
311
- /**
312
- * Create an admin user
313
- */
314
- adminUser: (overrides: Partial<TestUser> = {}): TestUser => ({
315
- id: 1,
316
- email: 'admin@example.com',
317
- username: 'admin',
318
- roles: ['admin'],
319
- permissions: ['read', 'write', 'delete'],
320
- ...overrides,
321
- }),
322
-
323
- /**
324
- * Create a guest user
325
- */
326
- guestUser: (): TestUser => ({
327
- id: 0,
328
- email: 'guest@example.com',
329
- username: 'guest',
330
- roles: ['guest'],
331
- permissions: [],
332
- }),
333
-
334
- /**
335
- * Mock authentication middleware
336
- */
337
- authMiddleware: (user?: TestUser): any => mock(async (req: EnhancedRequest, next: any): Promise<Response> => {
338
- if (user) {
339
- req.user = user
340
- return await next()
341
- }
342
- return new Response('Unauthorized', { status: 401 })
343
- }),
344
-
345
- /**
346
- * Mock role-based middleware
347
- */
348
- roleMiddleware: (requiredRoles: string[]): any => mock(async (req: EnhancedRequest, next: any): Promise<Response> => {
349
- if (!req.user) {
350
- return new Response('Unauthorized', { status: 401 })
351
- }
352
-
353
- const userRoles = req.user.roles || []
354
- const hasRole = requiredRoles.some(role => userRoles.includes(role))
355
-
356
- if (!hasRole) {
357
- return new Response('Forbidden', { status: 403 })
358
- }
359
-
360
- return await next()
361
- }),
362
-
363
- /**
364
- * Mock permission-based middleware
365
- */
366
- permissionMiddleware: (requiredPermissions: string[]): any => mock(async (req: EnhancedRequest, next: any): Promise<Response> => {
367
- if (!req.user) {
368
- return new Response('Unauthorized', { status: 401 })
369
- }
370
-
371
- const userPermissions = req.user.permissions || []
372
- const hasPermission = requiredPermissions.every(permission =>
373
- userPermissions.includes(permission),
374
- )
375
-
376
- if (!hasPermission) {
377
- return new Response('Forbidden', { status: 403 })
378
- }
379
-
380
- return await next()
381
- }),
382
- }
383
-
384
- /**
385
- * Helper functions
386
- */
387
- export const authHelpers = {
388
- /**
389
- * Create an authenticated request
390
- */
391
- authenticatedRequest: (user: TestUser, request?: EnhancedRequest): EnhancedRequest => {
392
- return new AuthTester(request).as(user).getRequest()
393
- },
394
-
395
- /**
396
- * Create a request with JWT
397
- */
398
- jwtRequest: (payload: Record<string, any> = {}, request?: EnhancedRequest): EnhancedRequest => {
399
- const jwt = new JWTTester()
400
- const token = jwt.generateToken(payload)
401
- return new AuthTester(request).withJWT(token).getRequest()
402
- },
403
-
404
- /**
405
- * Create a request with session
406
- */
407
- sessionRequest: (sessionData: Record<string, any> = {}, request?: EnhancedRequest): EnhancedRequest => {
408
- return new AuthTester(request).withSession(sessionData).getRequest()
409
- },
410
-
411
- /**
412
- * Verify JWT token structure
413
- */
414
- verifyJWTStructure: (token: string): boolean => {
415
- const parts = token.split('.')
416
- return parts.length === 3 && parts.every(part => part.length > 0)
417
- },
418
-
419
- /**
420
- * Extract payload from JWT (for testing)
421
- */
422
- extractJWTPayload: (token: string): any => {
423
- try {
424
- const [, payload] = token.split('.')
425
- return JSON.parse(atob(payload))
426
- }
427
- catch {
428
- return null
429
- }
430
- },
431
- }
432
-
433
- /**
434
- * Factory functions
435
- */
436
- export function createAuthTester(request?: EnhancedRequest): AuthTester {
437
- return new AuthTester(request)
438
- }
439
-
440
- export function createJWTTester(options?: JWTTestOptions): JWTTester {
441
- return new JWTTester(options)
442
- }
443
-
444
- export function createSessionTester(options?: SessionTestOptions): SessionTester {
445
- return new SessionTester(options)
446
- }