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