@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,332 +0,0 @@
1
- import type { TestResponse } from './types'
2
-
3
- /**
4
- * Test response wrapper with assertion helpers
5
- */
6
- export class TestResponseWrapper implements TestResponse {
7
- public status: number
8
- public statusText: string
9
- public headers: Record<string, string>
10
- public body: any
11
- public text: string
12
- public json: any
13
- public cookies: Record<string, string>
14
- public redirected: boolean
15
- public url: string
16
- public ok: boolean
17
- public type: string
18
-
19
- private originalResponse: Response
20
-
21
- constructor(response: Response, body?: any) {
22
- this.originalResponse = response
23
- this.status = response.status
24
- this.statusText = response.statusText
25
- this.headers = this.parseHeaders(response.headers)
26
- this.cookies = this.parseCookies(response.headers.get('set-cookie'))
27
- this.redirected = response.redirected
28
- this.url = response.url
29
- this.ok = response.ok
30
- this.type = response.type
31
- this.body = body
32
- this.text = typeof body === 'string' ? body : JSON.stringify(body)
33
-
34
- try {
35
- this.json = typeof body === 'string' ? JSON.parse(body) : body
36
- }
37
- catch {
38
- this.json = null
39
- }
40
- }
41
-
42
- private parseHeaders(headers: Headers): Record<string, string> {
43
- const result: Record<string, string> = {}
44
- headers.forEach((value, key) => {
45
- result[key.toLowerCase()] = value
46
- })
47
- return result
48
- }
49
-
50
- private parseCookies(cookieHeader: string | null): Record<string, string> {
51
- if (!cookieHeader)
52
- return {}
53
-
54
- const cookies: Record<string, string> = {}
55
- cookieHeader.split(',').forEach((cookie) => {
56
- const [nameValue] = cookie.trim().split(';')
57
- const [name, value] = nameValue.split('=')
58
- if (name && value) {
59
- cookies[name.trim()] = value.trim()
60
- }
61
- })
62
- return cookies
63
- }
64
-
65
- /**
66
- * Assert response status
67
- */
68
- expectStatus(status: number): TestResponseWrapper {
69
- if (this.status !== status) {
70
- throw new Error(`Expected status ${status}, got ${this.status}`)
71
- }
72
- return this
73
- }
74
-
75
- /**
76
- * Assert response is successful (2xx)
77
- */
78
- expectSuccess(): TestResponseWrapper {
79
- if (!this.ok) {
80
- throw new Error(`Expected successful response, got ${this.status}`)
81
- }
82
- return this
83
- }
84
-
85
- /**
86
- * Assert response has specific header
87
- */
88
- expectHeader(name: string, value?: string): TestResponseWrapper {
89
- const headerValue = this.headers[name.toLowerCase()]
90
- if (headerValue === undefined) {
91
- throw new Error(`Expected header '${name}' to be present`)
92
- }
93
- if (value !== undefined && headerValue !== value) {
94
- throw new Error(`Expected header '${name}' to be '${value}', got '${headerValue}'`)
95
- }
96
- return this
97
- }
98
-
99
- /**
100
- * Assert response body matches
101
- */
102
- expectBody(expectedBody: any): TestResponseWrapper {
103
- if (typeof expectedBody === 'string') {
104
- if (this.text !== expectedBody) {
105
- throw new Error(`Expected body '${expectedBody}', got '${this.text}'`)
106
- }
107
- }
108
- else {
109
- if (JSON.stringify(this.json) !== JSON.stringify(expectedBody)) {
110
- throw new Error(`Expected body ${JSON.stringify(expectedBody)}, got ${JSON.stringify(this.json)}`)
111
- }
112
- }
113
- return this
114
- }
115
-
116
- /**
117
- * Assert response JSON matches
118
- */
119
- expectJson(expectedJson: any): TestResponseWrapper {
120
- if (JSON.stringify(this.json) !== JSON.stringify(expectedJson)) {
121
- throw new Error(`Expected JSON ${JSON.stringify(expectedJson)}, got ${JSON.stringify(this.json)}`)
122
- }
123
- return this
124
- }
125
-
126
- /**
127
- * Assert response JSON contains specific properties
128
- */
129
- expectJsonContains(properties: Record<string, any>): TestResponseWrapper {
130
- if (typeof this.json !== 'object' || this.json === null) {
131
- throw new Error('Response is not a JSON object')
132
- }
133
-
134
- Object.entries(properties).forEach(([key, expectedValue]) => {
135
- const actualValue = this.json[key]
136
-
137
- // Deep comparison for objects
138
- if (typeof expectedValue === 'object' && expectedValue !== null
139
- && typeof actualValue === 'object' && actualValue !== null) {
140
- const expectedStr = JSON.stringify(expectedValue)
141
- const actualStr = JSON.stringify(actualValue)
142
- if (expectedStr !== actualStr) {
143
- throw new Error(`Expected JSON property '${key}' to be ${expectedStr}, got ${actualStr}`)
144
- }
145
- }
146
- else if (actualValue !== expectedValue) {
147
- throw new Error(`Expected JSON property '${key}' to be '${expectedValue}', got '${actualValue}'`)
148
- }
149
- })
150
-
151
- return this
152
- }
153
-
154
- /**
155
- * Assert response has specific cookie
156
- */
157
- expectCookie(name: string, value?: string): TestResponseWrapper {
158
- const cookieValue = this.cookies[name]
159
- if (cookieValue === undefined) {
160
- throw new Error(`Expected cookie '${name}' to be present`)
161
- }
162
- if (value !== undefined && cookieValue !== value) {
163
- throw new Error(`Expected cookie '${name}' to be '${value}', got '${cookieValue}'`)
164
- }
165
- return this
166
- }
167
-
168
- /**
169
- * Assert response is a redirect
170
- */
171
- expectRedirect(url?: string): TestResponseWrapper {
172
- if (this.status < 300 || this.status >= 400) {
173
- throw new Error(`Expected redirect status (3xx), got ${this.status}`)
174
- }
175
- if (url) {
176
- const location = this.headers.location
177
- if (location !== url) {
178
- throw new Error(`Expected redirect to '${url}', got '${location}'`)
179
- }
180
- }
181
- return this
182
- }
183
-
184
- /**
185
- * Assert response contains validation errors
186
- */
187
- expectValidationError(field?: string, message?: string): TestResponseWrapper {
188
- if (this.status !== 422) {
189
- throw new Error(`Expected validation error status (422), got ${this.status}`)
190
- }
191
-
192
- if (field) {
193
- const errors = this.json?.errors || this.json?.message
194
- if (!errors || !errors[field]) {
195
- throw new Error(`Expected validation error for field '${field}'`)
196
- }
197
-
198
- if (message) {
199
- const fieldErrors = Array.isArray(errors[field]) ? errors[field] : [errors[field]]
200
- if (!fieldErrors.includes(message)) {
201
- throw new Error(`Expected validation error message '${message}' for field '${field}'`)
202
- }
203
- }
204
- }
205
- return this
206
- }
207
-
208
- /**
209
- * Assert response content type
210
- */
211
- expectContentType(contentType: string): TestResponseWrapper {
212
- const actualContentType = this.headers['content-type']
213
- if (!actualContentType || !actualContentType.includes(contentType)) {
214
- throw new Error(`Expected content type '${contentType}', got '${actualContentType}'`)
215
- }
216
- return this
217
- }
218
-
219
- /**
220
- * Assert response body contains text
221
- */
222
- expectBodyContains(text: string): TestResponseWrapper {
223
- if (!this.text.includes(text)) {
224
- throw new Error(`Expected body to contain '${text}'`)
225
- }
226
- return this
227
- }
228
-
229
- /**
230
- * Assert response body matches regex
231
- */
232
- expectBodyMatches(pattern: RegExp): TestResponseWrapper {
233
- if (!pattern.test(this.text)) {
234
- throw new Error(`Expected body to match pattern ${pattern}`)
235
- }
236
- return this
237
- }
238
-
239
- /**
240
- * Assert response JSON has specific structure
241
- */
242
- expectJsonStructure(structure: any): TestResponseWrapper {
243
- this.validateStructure(this.json, structure, 'root')
244
- return this
245
- }
246
-
247
- private validateStructure(data: any, structure: any, path: string): void {
248
- // Handle expect.any() matchers - they have a $$typeof property
249
- if (structure && typeof structure === 'object' && structure.$$typeof) {
250
- // This is an expect.any() matcher, skip validation
251
- return
252
- }
253
-
254
- if (Array.isArray(structure)) {
255
- if (!Array.isArray(data)) {
256
- throw new TypeError(`Expected ${path} to be an array`)
257
- }
258
- if (structure.length > 0 && data.length > 0) {
259
- this.validateStructure(data[0], structure[0], `${path}[0]`)
260
- }
261
- }
262
- else if (typeof structure === 'object' && structure !== null) {
263
- if (typeof data !== 'object' || data === null) {
264
- throw new Error(`Expected ${path} to be an object`)
265
- }
266
- Object.keys(structure).forEach((key) => {
267
- if (!(key in data)) {
268
- throw new Error(`Expected ${path} to have property '${key}'`)
269
- }
270
- this.validateStructure(data[key], structure[key], `${path}.${key}`)
271
- })
272
- }
273
- }
274
-
275
- /**
276
- * Get the original Response object
277
- */
278
- getOriginalResponse(): Response {
279
- return this.originalResponse
280
- }
281
-
282
- /**
283
- * Convert to JSON for easy inspection
284
- */
285
- toJSON(): any {
286
- return {
287
- status: this.status,
288
- statusText: this.statusText,
289
- headers: this.headers,
290
- body: this.body,
291
- json: this.json,
292
- cookies: this.cookies,
293
- redirected: this.redirected,
294
- url: this.url,
295
- ok: this.ok,
296
- type: this.type,
297
- }
298
- }
299
- }
300
-
301
- /**
302
- * Create a test response from a Response object
303
- */
304
- export async function createTestResponse(response: Response): Promise<TestResponseWrapper> {
305
- const body = await response.text()
306
- return new TestResponseWrapper(response, body)
307
- }
308
-
309
- /**
310
- * Create a mock response for testing
311
- */
312
- export function createMockResponse(
313
- status: number = 200,
314
- body?: any,
315
- headers?: Record<string, string>,
316
- ): TestResponseWrapper {
317
- const responseHeaders = new Headers(headers)
318
-
319
- if (body && typeof body === 'object' && !responseHeaders.has('content-type')) {
320
- responseHeaders.set('content-type', 'application/json')
321
- }
322
-
323
- const response = new Response(
324
- body ? (typeof body === 'string' ? body : JSON.stringify(body)) : null,
325
- {
326
- status,
327
- headers: responseHeaders,
328
- },
329
- )
330
-
331
- return new TestResponseWrapper(response, body)
332
- }
@@ -1,224 +0,0 @@
1
- import type { EnhancedRequest, MiddlewareHandler } from '../types'
2
-
3
- /**
4
- * Test client configuration options
5
- */
6
- export interface TestClientConfig {
7
- baseUrl?: string
8
- defaultHeaders?: Record<string, string>
9
- timeout?: number
10
- followRedirects?: boolean
11
- validateStatus?: (status: number) => boolean
12
- }
13
-
14
- /**
15
- * Test request options
16
- */
17
- export interface TestRequestOptions {
18
- headers?: Record<string, string>
19
- query?: Record<string, string | string[]>
20
- body?: any
21
- files?: TestFile[]
22
- cookies?: Record<string, string>
23
- session?: any
24
- user?: any
25
- context?: Record<string, any>
26
- timeout?: number
27
- followRedirects?: boolean
28
- }
29
-
30
- /**
31
- * Test file for upload testing
32
- */
33
- export interface TestFile {
34
- fieldName: string
35
- filename: string
36
- content: string | ArrayBuffer | Uint8Array
37
- mimetype?: string
38
- }
39
-
40
- /**
41
- * Test response interface
42
- */
43
- export interface TestResponse {
44
- status: number
45
- statusText: string
46
- headers: Record<string, string>
47
- body: any
48
- text: string
49
- json: any
50
- cookies: Record<string, string>
51
- redirected: boolean
52
- url: string
53
- ok: boolean
54
- type: string
55
- }
56
-
57
- /**
58
- * Middleware test context
59
- */
60
- export interface MiddlewareTestContext {
61
- request: EnhancedRequest
62
- response?: Response
63
- next: ReturnType<typeof import('bun:test').mock<() => Promise<Response | null>>>
64
- error?: Error
65
- }
66
-
67
- /**
68
- * Authentication test user
69
- */
70
- export interface TestUser {
71
- id: string | number
72
- email?: string
73
- username?: string
74
- roles?: string[]
75
- permissions?: string[]
76
- [key: string]: any
77
- }
78
-
79
- /**
80
- * JWT test options
81
- */
82
- export interface JWTTestOptions {
83
- secret?: string
84
- expiresIn?: string
85
- algorithm?: 'HS256' | 'HS384' | 'HS512' | 'RS256'
86
- payload?: Record<string, any>
87
- headers?: Record<string, any>
88
- }
89
-
90
- /**
91
- * Session test options
92
- */
93
- export interface SessionTestOptions {
94
- sessionId?: string
95
- data?: Record<string, any>
96
- maxAge?: number
97
- secure?: boolean
98
- httpOnly?: boolean
99
- }
100
-
101
- /**
102
- * Model binding test options
103
- */
104
- export interface ModelBindingTestOptions {
105
- modelClass?: any
106
- routeKey?: string
107
- constraints?: Record<string, any>
108
- customResolver?: (value: string) => Promise<any>
109
- }
110
-
111
- /**
112
- * Performance test metrics
113
- */
114
- export interface PerformanceMetrics {
115
- responseTime: number
116
- memoryUsage: {
117
- heapUsed: number
118
- heapTotal: number
119
- external: number
120
- rss: number
121
- }
122
- cpuUsage: {
123
- user: number
124
- system: number
125
- }
126
- requestsPerSecond?: number
127
- concurrentRequests?: number
128
- }
129
-
130
- /**
131
- * Load test configuration
132
- */
133
- export interface LoadTestConfig {
134
- duration: number
135
- concurrency: number
136
- rampUp?: number
137
- rampDown?: number
138
- requestsPerSecond?: number
139
- maxRequests?: number
140
- }
141
-
142
- /**
143
- * WebSocket test message
144
- */
145
- export interface WSTestMessage {
146
- type: 'text' | 'binary'
147
- data: string | ArrayBuffer | Uint8Array
148
- timestamp?: number
149
- }
150
-
151
- /**
152
- * WebSocket test client
153
- */
154
- export interface WSTestClient {
155
- send: (message: string | ArrayBuffer | Uint8Array) => void
156
- close: (code?: number, reason?: string) => void
157
- ping: (data?: Uint8Array) => void
158
- pong: (data?: Uint8Array) => void
159
- messages: WSTestMessage[]
160
- isConnected: boolean
161
- readyState: number
162
- }
163
-
164
- /**
165
- * Test assertion helpers
166
- */
167
- export interface TestAssertions {
168
- toHaveStatus: (status: number) => void
169
- toHaveHeader: (name: string, value?: string) => void
170
- toHaveBody: (body: any) => void
171
- toHaveJson: (json: any) => void
172
- toHaveCookie: (name: string, value?: string) => void
173
- toBeRedirected: (url?: string) => void
174
- toHaveValidationError: (field?: string, message?: string) => void
175
- toBeAuthenticated: (user?: any) => void
176
- toBeUnauthenticated: () => void
177
- toHaveMiddleware: (middleware: string | MiddlewareHandler) => void
178
- toHaveModel: (model: any) => void
179
- toHaveUploadedFile: (fieldName: string, filename?: string) => void
180
- toRespondWithin: (milliseconds: number) => void
181
- }
182
-
183
- /**
184
- * Mock factory options
185
- */
186
- export interface MockFactoryOptions {
187
- count?: number
188
- overrides?: Record<string, any>
189
- relations?: Record<string, any>
190
- }
191
-
192
- /**
193
- * Database test helpers
194
- */
195
- export interface DatabaseTestHelpers {
196
- seed: (data: any[]) => Promise<void>
197
- truncate: (tables?: string[]) => Promise<void>
198
- factory: <T>(model: string, options?: MockFactoryOptions) => T[]
199
- create: <T>(model: string, data?: Partial<T>) => Promise<T>
200
- transaction: <T>(callback: () => Promise<T>) => Promise<T>
201
- }
202
-
203
- /**
204
- * Test environment configuration
205
- */
206
- export interface TestEnvironment {
207
- database?: DatabaseTestHelpers
208
- cache?: {
209
- clear: () => Promise<void>
210
- get: (key: string) => Promise<any>
211
- set: (key: string, value: any, ttl?: number) => Promise<void>
212
- }
213
- storage?: {
214
- clear: () => Promise<void>
215
- put: (path: string, content: string | ArrayBuffer) => Promise<void>
216
- get: (path: string) => Promise<string | ArrayBuffer | null>
217
- delete: (path: string) => Promise<void>
218
- }
219
- queue?: {
220
- clear: () => Promise<void>
221
- push: (job: any) => Promise<void>
222
- process: () => Promise<void>
223
- }
224
- }