@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,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
- }