acrylblends 0.6.3 → 0.6.4

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 (269) hide show
  1. package/README.md +3 -2
  2. package/docs/framework/README.md +2 -2
  3. package/docs/framework/UPSTREAM.md +1 -1
  4. package/docs/framework/guides/jsx.md +24 -0
  5. package/docs/framework/helpers/ssg.md +3 -6
  6. package/docs/framework/middleware/builtin/jsx-renderer.md +0 -3
  7. package/docs/framework/upstream.json +2 -2
  8. package/lib/accepts.d.ts +1 -1
  9. package/lib/acryl-base.d.ts +1 -1
  10. package/lib/adapter.d.ts +1 -1
  11. package/lib/{app-wFwpg-bt.d.ts → app-D8riatvv.d.ts} +1 -1
  12. package/lib/basic-auth.d.ts +1 -1
  13. package/lib/bearer-auth.d.ts +1 -1
  14. package/lib/body-limit.d.ts +1 -1
  15. package/lib/cache.d.ts +1 -1
  16. package/lib/cache.js +4 -4
  17. package/lib/{client-BHTr318g.js → client-DDLXwhBo.js} +2 -125
  18. package/lib/client.d.ts +2 -2
  19. package/lib/client.js +2 -1
  20. package/lib/combine.d.ts +1 -1
  21. package/lib/{components-Ce5FRyHU.js → components-0o0CBYNv.js} +2 -2
  22. package/lib/{components-DYZdxJIJ.js → components-DdI7-ns7.js} +1 -1
  23. package/lib/compress.d.ts +1 -1
  24. package/lib/conninfo.d.ts +2 -2
  25. package/lib/{context-DVQBjuns.d.ts → context-DS3fYyG-.d.ts} +1 -1
  26. package/lib/context-storage.d.ts +1 -1
  27. package/lib/cookie.d.ts +1 -1
  28. package/lib/cors.d.ts +1 -1
  29. package/lib/csrf.d.ts +1 -1
  30. package/lib/dev.d.ts +2 -2
  31. package/lib/etag.d.ts +1 -1
  32. package/lib/factory.d.ts +2 -2
  33. package/lib/{hooks-Bq5q9IMl.js → hooks-BMw6BAyP.js} +5 -5
  34. package/lib/{index-CUTfU69R.d.ts → index-Bb7YJKCq.d.ts} +2 -2
  35. package/lib/{index-CsvB-F9j.d.ts → index-BvFh1Gfx.d.ts} +1 -1
  36. package/lib/{index-Cqcdluyn.d.ts → index-CTy4N7ng.d.ts} +2 -2
  37. package/lib/index.d.ts +4 -4
  38. package/lib/ip-restriction.d.ts +2 -2
  39. package/lib/jsx/dom/client.js +1 -1
  40. package/lib/jsx/dom/jsx-dev-runtime.js +1 -1
  41. package/lib/jsx/dom/jsx-runtime.js +1 -1
  42. package/lib/jsx/dom/server.js +1 -1
  43. package/lib/jsx/dom.js +3 -3
  44. package/lib/jsx/streaming.js +1 -1
  45. package/lib/{jsx-dev-runtime-kAhR_4C7.js → jsx-dev-runtime-D18Y35TI.js} +1 -1
  46. package/lib/jsx-renderer.d.ts +75 -0
  47. package/lib/jsx-renderer.js +99 -0
  48. package/lib/jsx.js +3 -3
  49. package/lib/jwk.d.ts +1 -1
  50. package/lib/jwt.d.ts +1 -1
  51. package/lib/language.d.ts +1 -1
  52. package/lib/logger.d.ts +1 -1
  53. package/lib/loopback-only.d.ts +1 -1
  54. package/lib/method-not-allowed.d.ts +2 -2
  55. package/lib/method-override.d.ts +2 -2
  56. package/lib/mount.d.ts +1 -1
  57. package/lib/node-server/conninfo.d.ts +1 -1
  58. package/lib/node-server/serve-static.d.ts +1 -1
  59. package/lib/node-server/serve-static.js +1 -1
  60. package/lib/node-server.d.ts +1 -1
  61. package/lib/node-server.js +1 -1
  62. package/lib/powered-by.d.ts +1 -1
  63. package/lib/pretty-json.d.ts +1 -1
  64. package/lib/quick.d.ts +1 -1
  65. package/lib/request-id.d.ts +1 -1
  66. package/lib/request.d.ts +1 -1
  67. package/lib/route.d.ts +1 -1
  68. package/lib/schema-validator.d.ts +1 -1
  69. package/lib/secure-headers.d.ts +1 -1
  70. package/lib/{serve-static-Cw23shXv.js → serve-static-B14MF1Va.js} +1 -0
  71. package/lib/serve-static.d.ts +1 -1
  72. package/lib/ssg-BwjcA-Ge.js +389 -0
  73. package/lib/ssg.d.ts +156 -0
  74. package/lib/ssg.js +2 -0
  75. package/lib/streaming.d.ts +1 -1
  76. package/lib/testing.d.ts +3 -3
  77. package/lib/testing.js +1 -1
  78. package/lib/timeout.d.ts +1 -1
  79. package/lib/timing.d.ts +1 -1
  80. package/lib/tiny.d.ts +1 -1
  81. package/lib/trailing-slash.d.ts +1 -1
  82. package/lib/{types-nEL8VPDC.d.ts → types-Dv_nV2cv.d.ts} +1 -1
  83. package/lib/{types-CQiGmsWW.d.ts → types-zNxyEpG2.d.ts} +2 -2
  84. package/lib/types.d.ts +1 -1
  85. package/lib/utils/body.d.ts +1 -1
  86. package/lib/utils/ipaddr.d.ts +1 -1
  87. package/lib/utils-Cx61GFMC.js +125 -0
  88. package/lib/validator.d.ts +1 -1
  89. package/lib/ws.d.ts +1 -1
  90. package/package.json +9 -1
  91. package/plugins/acryl-inspect/upstream.json +1 -1
  92. package/plugins/acryl-node-server/upstream.json +1 -1
  93. package/plugins/acryl-router/src/core/helper/ssg/index.ts +14 -0
  94. package/plugins/acryl-router/src/core/helper/ssg/middleware.ts +83 -0
  95. package/plugins/acryl-router/src/core/helper/ssg/plugins.ts +72 -0
  96. package/plugins/acryl-router/src/core/helper/ssg/ssg.ts +471 -0
  97. package/plugins/acryl-router/src/core/helper/ssg/utils.ts +118 -0
  98. package/plugins/acryl-router/src/core/jsx/dom/render.ts +6 -6
  99. package/plugins/acryl-router/src/core/middleware/cache/index.ts +4 -4
  100. package/plugins/acryl-router/src/core/middleware/jsx-renderer/index.ts +162 -0
  101. package/plugins/acryl-router/src/helpers/index.ts +1 -0
  102. package/plugins/acryl-router/src/middleware/index.ts +1 -0
  103. package/plugins/acryl-router/upstream.json +2 -2
  104. package/plugins/acryl-router-http/upstream.json +1 -1
  105. package/plugins/acryl-state/upstream.json +1 -1
  106. package/plugins/desktop/upstream.json +1 -1
  107. package/plugins/desktop-web/upstream.json +1 -1
  108. package/plugins/extensions/resolve.ts +4 -0
  109. package/shared/AGENTS.core.md +4 -0
  110. package/templates/agent/tsconfig.json +7 -1
  111. package/templates/todo/upstream.json +1 -1
  112. package/plugins/acryl-inspect/tests/report.spec.ts +0 -69
  113. package/plugins/acryl-inspect/tests/service.spec.ts +0 -121
  114. package/plugins/acryl-node-server/tests/adapter/app.ts +0 -76
  115. package/plugins/acryl-node-server/tests/adapter/assets/.static/plain.txt +0 -1
  116. package/plugins/acryl-node-server/tests/adapter/assets/favicon.ico +0 -0
  117. package/plugins/acryl-node-server/tests/adapter/assets/secret.txt +0 -1
  118. package/plugins/acryl-node-server/tests/adapter/assets/static/acryl.html +0 -1
  119. package/plugins/acryl-node-server/tests/adapter/assets/static/admin/secret.txt +0 -1
  120. package/plugins/acryl-node-server/tests/adapter/assets/static/data.json +0 -5
  121. package/plugins/acryl-node-server/tests/adapter/assets/static/extensionless +0 -1
  122. package/plugins/acryl-node-server/tests/adapter/assets/static/foo..bar.txt +0 -0
  123. package/plugins/acryl-node-server/tests/adapter/assets/static/index.html +0 -1
  124. package/plugins/acryl-node-server/tests/adapter/assets/static/plain.txt +0 -1
  125. package/plugins/acryl-node-server/tests/adapter/assets/static-with-context-path/plain.txt +0 -1
  126. package/plugins/acryl-node-server/tests/adapter/assets/static-with-precompressed/hello.bin +0 -1
  127. package/plugins/acryl-node-server/tests/adapter/assets/static-with-precompressed/hello.bin.br +0 -1
  128. package/plugins/acryl-node-server/tests/adapter/assets/static-with-precompressed/hello.txt +0 -1
  129. package/plugins/acryl-node-server/tests/adapter/assets/static-with-precompressed/hello.txt.br +0 -1
  130. package/plugins/acryl-node-server/tests/adapter/assets/static-with-precompressed/hello.txt.zst +0 -1
  131. package/plugins/acryl-node-server/tests/adapter/conninfo.test.ts +0 -34
  132. package/plugins/acryl-node-server/tests/adapter/content-length.test.ts +0 -248
  133. package/plugins/acryl-node-server/tests/adapter/early-hints.test.ts +0 -457
  134. package/plugins/acryl-node-server/tests/adapter/fixtures/keys/agent1-cert.pem +0 -23
  135. package/plugins/acryl-node-server/tests/adapter/fixtures/keys/agent1-key.pem +0 -27
  136. package/plugins/acryl-node-server/tests/adapter/headers.test.ts +0 -252
  137. package/plugins/acryl-node-server/tests/adapter/helpers/request.ts +0 -190
  138. package/plugins/acryl-node-server/tests/adapter/listener.test.ts +0 -727
  139. package/plugins/acryl-node-server/tests/adapter/request-client-disconnect.test.ts +0 -189
  140. package/plugins/acryl-node-server/tests/adapter/request.test.ts +0 -1230
  141. package/plugins/acryl-node-server/tests/adapter/response.test.ts +0 -285
  142. package/plugins/acryl-node-server/tests/adapter/serve-static.test.ts +0 -849
  143. package/plugins/acryl-node-server/tests/adapter/server-socket.test.ts +0 -790
  144. package/plugins/acryl-node-server/tests/adapter/server.test.ts +0 -1312
  145. package/plugins/acryl-node-server/tests/adapter/setup.ts +0 -16
  146. package/plugins/acryl-node-server/tests/adapter/url.test.ts +0 -76
  147. package/plugins/acryl-node-server/tests/adapter/utils/response.test.ts +0 -23
  148. package/plugins/acryl-node-server/tests/adapter/utils/stream.test.ts +0 -75
  149. package/plugins/acryl-node-server/tests/adapter/utils.test.ts +0 -235
  150. package/plugins/acryl-node-server/tests/adapter/websocket.test.ts +0 -260
  151. package/plugins/acryl-node-server/tests/server.spec.ts +0 -141
  152. package/plugins/acryl-router/src/core/app.test.ts +0 -3833
  153. package/plugins/acryl-router/src/core/client/client.test.ts +0 -2313
  154. package/plugins/acryl-router/src/core/client/types.test.ts +0 -149
  155. package/plugins/acryl-router/src/core/client/utils.test.ts +0 -405
  156. package/plugins/acryl-router/src/core/compose.test.ts +0 -751
  157. package/plugins/acryl-router/src/core/context.test.ts +0 -629
  158. package/plugins/acryl-router/src/core/helper/accepts/accepts.test.ts +0 -344
  159. package/plugins/acryl-router/src/core/helper/adapter/index.test.ts +0 -55
  160. package/plugins/acryl-router/src/core/helper/cookie/index.test.ts +0 -510
  161. package/plugins/acryl-router/src/core/helper/css/common.case.test.tsx +0 -506
  162. package/plugins/acryl-router/src/core/helper/css/index.test.tsx +0 -678
  163. package/plugins/acryl-router/src/core/helper/dev/index.test.ts +0 -181
  164. package/plugins/acryl-router/src/core/helper/factory/index.test.ts +0 -434
  165. package/plugins/acryl-router/src/core/helper/html/index.test.ts +0 -78
  166. package/plugins/acryl-router/src/core/helper/proxy/index.test.ts +0 -356
  167. package/plugins/acryl-router/src/core/helper/route/index.test.ts +0 -259
  168. package/plugins/acryl-router/src/core/helper/streaming/sse.test.tsx +0 -557
  169. package/plugins/acryl-router/src/core/helper/streaming/stream.test.ts +0 -128
  170. package/plugins/acryl-router/src/core/helper/streaming/text.test.ts +0 -34
  171. package/plugins/acryl-router/src/core/helper/testing/index.test.ts +0 -42
  172. package/plugins/acryl-router/src/core/helper/websocket/index.test.ts +0 -124
  173. package/plugins/acryl-router/src/core/http-exception.test.ts +0 -45
  174. package/plugins/acryl-router/src/core/jsx/base.test.tsx +0 -97
  175. package/plugins/acryl-router/src/core/jsx/children.test.ts +0 -52
  176. package/plugins/acryl-router/src/core/jsx/components.test.tsx +0 -936
  177. package/plugins/acryl-router/src/core/jsx/context-isolation.test.ts +0 -655
  178. package/plugins/acryl-router/src/core/jsx/dom/client.test.tsx +0 -128
  179. package/plugins/acryl-router/src/core/jsx/dom/components.test.tsx +0 -330
  180. package/plugins/acryl-router/src/core/jsx/dom/context.test.tsx +0 -184
  181. package/plugins/acryl-router/src/core/jsx/dom/css.test.tsx +0 -149
  182. package/plugins/acryl-router/src/core/jsx/dom/hooks/index.test.tsx +0 -172
  183. package/plugins/acryl-router/src/core/jsx/dom/index.test.tsx +0 -3681
  184. package/plugins/acryl-router/src/core/jsx/dom/intrinsic-element/components.test.tsx +0 -1344
  185. package/plugins/acryl-router/src/core/jsx/dom/server.test.tsx +0 -199
  186. package/plugins/acryl-router/src/core/jsx/hooks/dom.test.tsx +0 -859
  187. package/plugins/acryl-router/src/core/jsx/hooks/string.test.tsx +0 -40
  188. package/plugins/acryl-router/src/core/jsx/index.test.tsx +0 -1744
  189. package/plugins/acryl-router/src/core/jsx/intrinsic-element/components.test.tsx +0 -666
  190. package/plugins/acryl-router/src/core/jsx/jsx-runtime.test.tsx +0 -85
  191. package/plugins/acryl-router/src/core/jsx/streaming.test.tsx +0 -1281
  192. package/plugins/acryl-router/src/core/jsx/utils.test.ts +0 -366
  193. package/plugins/acryl-router/src/core/middleware/basic-auth/index.test.ts +0 -434
  194. package/plugins/acryl-router/src/core/middleware/bearer-auth/index.test.ts +0 -1018
  195. package/plugins/acryl-router/src/core/middleware/body-limit/index.test.ts +0 -273
  196. package/plugins/acryl-router/src/core/middleware/cache/index.test.ts +0 -1211
  197. package/plugins/acryl-router/src/core/middleware/combine/index.test.ts +0 -355
  198. package/plugins/acryl-router/src/core/middleware/compress/index.test.ts +0 -535
  199. package/plugins/acryl-router/src/core/middleware/context-storage/index.test.ts +0 -43
  200. package/plugins/acryl-router/src/core/middleware/cors/index.test.ts +0 -532
  201. package/plugins/acryl-router/src/core/middleware/csrf/index.test.ts +0 -534
  202. package/plugins/acryl-router/src/core/middleware/etag/digest.test.ts +0 -21
  203. package/plugins/acryl-router/src/core/middleware/etag/index.test.ts +0 -503
  204. package/plugins/acryl-router/src/core/middleware/ip-restriction/index.test.ts +0 -217
  205. package/plugins/acryl-router/src/core/middleware/jwk/index.test.ts +0 -1135
  206. package/plugins/acryl-router/src/core/middleware/jwk/keys.test.json +0 -48
  207. package/plugins/acryl-router/src/core/middleware/jwt/index.test.ts +0 -802
  208. package/plugins/acryl-router/src/core/middleware/language/index.test.ts +0 -552
  209. package/plugins/acryl-router/src/core/middleware/logger/index.test.ts +0 -204
  210. package/plugins/acryl-router/src/core/middleware/method-not-allowed/index.test.ts +0 -292
  211. package/plugins/acryl-router/src/core/middleware/method-override/index.test.ts +0 -221
  212. package/plugins/acryl-router/src/core/middleware/mount/index.test.ts +0 -334
  213. package/plugins/acryl-router/src/core/middleware/powered-by/index.test.ts +0 -37
  214. package/plugins/acryl-router/src/core/middleware/pretty-json/index.test.ts +0 -218
  215. package/plugins/acryl-router/src/core/middleware/request-id/index.test.ts +0 -168
  216. package/plugins/acryl-router/src/core/middleware/secure-headers/index.test.ts +0 -671
  217. package/plugins/acryl-router/src/core/middleware/serve-static/index.test.ts +0 -450
  218. package/plugins/acryl-router/src/core/middleware/serve-static/path.test.ts +0 -50
  219. package/plugins/acryl-router/src/core/middleware/timeout/index.test.ts +0 -70
  220. package/plugins/acryl-router/src/core/middleware/timing/index.test.ts +0 -310
  221. package/plugins/acryl-router/src/core/middleware/trailing-slash/index.test.ts +0 -381
  222. package/plugins/acryl-router/src/core/preset/quick.test.ts +0 -42
  223. package/plugins/acryl-router/src/core/preset/tiny.test.ts +0 -42
  224. package/plugins/acryl-router/src/core/request.test.ts +0 -751
  225. package/plugins/acryl-router/src/core/router/common.case.test.ts +0 -1132
  226. package/plugins/acryl-router/src/core/router/linear-router/router.test.ts +0 -80
  227. package/plugins/acryl-router/src/core/router/pattern-router/router.test.ts +0 -46
  228. package/plugins/acryl-router/src/core/router/reg-exp-router/prepared-router.test.ts +0 -154
  229. package/plugins/acryl-router/src/core/router/reg-exp-router/router.test.ts +0 -265
  230. package/plugins/acryl-router/src/core/router/smart-router/router.test.ts +0 -13
  231. package/plugins/acryl-router/src/core/router/trie-router/node.test.ts +0 -896
  232. package/plugins/acryl-router/src/core/router/trie-router/router.test.ts +0 -8
  233. package/plugins/acryl-router/src/core/types.test.ts +0 -4134
  234. package/plugins/acryl-router/src/core/utils/accept.test.ts +0 -299
  235. package/plugins/acryl-router/src/core/utils/basic-auth.test.ts +0 -56
  236. package/plugins/acryl-router/src/core/utils/body.test.ts +0 -496
  237. package/plugins/acryl-router/src/core/utils/buffer.test.ts +0 -147
  238. package/plugins/acryl-router/src/core/utils/color.test.ts +0 -23
  239. package/plugins/acryl-router/src/core/utils/concurrent.test.ts +0 -69
  240. package/plugins/acryl-router/src/core/utils/cookie.test.ts +0 -460
  241. package/plugins/acryl-router/src/core/utils/crypto.test.ts +0 -43
  242. package/plugins/acryl-router/src/core/utils/encode.test.ts +0 -61
  243. package/plugins/acryl-router/src/core/utils/filepath.test.ts +0 -78
  244. package/plugins/acryl-router/src/core/utils/html.test.ts +0 -16
  245. package/plugins/acryl-router/src/core/utils/ipaddr.test.ts +0 -149
  246. package/plugins/acryl-router/src/core/utils/jwt/jwa.test.ts +0 -86
  247. package/plugins/acryl-router/src/core/utils/jwt/jwt.test.ts +0 -1788
  248. package/plugins/acryl-router/src/core/utils/mime.test.ts +0 -64
  249. package/plugins/acryl-router/src/core/utils/stream.test.ts +0 -212
  250. package/plugins/acryl-router/src/core/utils/types.test.ts +0 -295
  251. package/plugins/acryl-router/src/core/utils/url.test.ts +0 -384
  252. package/plugins/acryl-router/src/core/validator/utils.test.ts +0 -82
  253. package/plugins/acryl-router/src/core/validator/validator.test.ts +0 -1488
  254. package/plugins/acryl-router/tests/docs-examples.spec.ts +0 -152
  255. package/plugins/acryl-router/tests/jsx.spec.tsx +0 -63
  256. package/plugins/acryl-router/tests/live-install.spec.ts +0 -64
  257. package/plugins/acryl-router/tests/loader.spec.ts +0 -72
  258. package/plugins/acryl-router/tests/loopback-only.spec.ts +0 -80
  259. package/plugins/acryl-router/tests/no-dom/consumer.ts +0 -11
  260. package/plugins/acryl-router/tests/no-dom/tsconfig.json +0 -13
  261. package/plugins/acryl-router/tests/service.spec.ts +0 -426
  262. package/plugins/acryl-router/tests/shadow-state.spec.ts +0 -79
  263. package/plugins/acryl-router-http/tests/adapter.spec.ts +0 -174
  264. package/plugins/acryl-router-http/tests/stream.spec.ts +0 -133
  265. package/plugins/acryl-router-http/tests/surfaces.spec.ts +0 -101
  266. package/plugins/acryl-state/src/react.ts +0 -11
  267. package/plugins/acryl-state/tests/cell.spec.ts +0 -71
  268. package/plugins/acryl-state/tests/react.spec.ts +0 -39
  269. package/plugins/acryl-state/tests/service.spec.ts +0 -132
@@ -1,751 +0,0 @@
1
- import { HTTPException } from './http-exception.ts'
2
- import { cloneRawRequest, AcrylRequest } from './request.ts'
3
- import type { RouterRoute } from './types.ts'
4
-
5
- type RecursiveRecord<K extends string, T> = {
6
- [key in K]: T | RecursiveRecord<K, T>
7
- }
8
-
9
- describe('Query', () => {
10
- test('req.query() and req.queries()', () => {
11
- const rawRequest = new Request('http://localhost?page=2&tag=A&tag=B')
12
- const req = new AcrylRequest(rawRequest)
13
-
14
- const page = req.query('page')
15
- expect(page).not.toBeUndefined()
16
- expect(page).toBe('2')
17
-
18
- const q = req.query('q')
19
- expect(q).toBeUndefined()
20
-
21
- const tags = req.queries('tag')
22
- expect(tags).not.toBeUndefined()
23
- expect(tags).toEqual(['A', 'B'])
24
-
25
- const q2 = req.queries('q2')
26
- expect(q2).toBeUndefined()
27
- })
28
-
29
- test('decode special chars', () => {
30
- const rawRequest = new Request('http://localhost?mail=framework%40acryl.dev&tag=%401&tag=%402')
31
- const req = new AcrylRequest(rawRequest)
32
-
33
- const mail = req.query('mail')
34
- expect(mail).toBe('framework@acryl.dev')
35
-
36
- const tags = req.queries('tag')
37
- expect(tags).toEqual(['@1', '@2'])
38
- })
39
- })
40
-
41
- describe('Param', () => {
42
- test('req.param() on an unmatched request', () => {
43
- const req = new AcrylRequest(new Request('http://localhost/'))
44
-
45
- expect(req.param('id')).toBeUndefined()
46
- expect(req.param()).toEqual({})
47
- })
48
-
49
- test('req.param() should return empty string for zero-length match', () => {
50
- // Simulate a route like '/:remaining{.*}' matching '/'
51
- const rawRequest = new Request('http://localhost/')
52
- const req = new AcrylRequest<'/:remaining{.*}'>(rawRequest, '/', [
53
- [[[undefined, {} as RouterRoute], { remaining: 0 }]],
54
- [''], // ParamStash with empty string for remaining
55
- ])
56
-
57
- // Single param access should be empty string, not undefined
58
- expect(req.param('remaining')).toBe('')
59
-
60
- // All params should include key with empty string value
61
- const all = req.param()
62
- expect(all).toEqual({ remaining: '' })
63
- })
64
- test('req.param() with ParamStash', () => {
65
- const rawRequest = new Request('http://localhost?page=2&tag=A&tag=B')
66
- const req = new AcrylRequest<'/:id/:name'>(rawRequest, '/123/key', [
67
- [
68
- [[undefined, {} as RouterRoute], { id: 0 }],
69
- [[undefined, {} as RouterRoute], { id: 0, name: 1 }],
70
- ],
71
- ['123', 'key'],
72
- ])
73
-
74
- expect(req.param('id')).toBe('123')
75
- expect(req.param('name')).toBe(undefined)
76
-
77
- req.routeIndex = 1
78
- expect(req.param('id')).toBe('123')
79
- expect(req.param('name')).toBe('key')
80
- })
81
-
82
- test('req.param() without ParamStash', () => {
83
- const rawRequest = new Request('http://localhost?page=2&tag=A&tag=B')
84
- const req = new AcrylRequest<'/:id/:name'>(rawRequest, '/123/key', [
85
- [
86
- [[undefined, {} as RouterRoute], { id: '123' }],
87
- [[undefined, {} as RouterRoute], { id: '456', name: 'key' }],
88
- ],
89
- ])
90
-
91
- expect(req.param('id')).toBe('123')
92
- expect(req.param('name')).toBe(undefined)
93
-
94
- req.routeIndex = 1
95
- expect(req.param('id')).toBe('456')
96
- expect(req.param('name')).toBe('key')
97
- })
98
-
99
- test('req.param() returns empty string for missing param', () => {
100
- const rawRequest = new Request('http://localhost')
101
- const req = new AcrylRequest<'/:remaining'>(rawRequest, '/', [
102
- [[[undefined, {} as RouterRoute], { remaining: 0 }]],
103
- [''],
104
- ])
105
- expect(req.param('remaining')).toBe('')
106
- })
107
-
108
- test('req.param() without argument returns object with empty string for missing param', () => {
109
- const rawRequest = new Request('http://localhost')
110
- const req = new AcrylRequest<'/:remaining'>(rawRequest, '/', [
111
- [[[undefined, {} as RouterRoute], { remaining: 0 }]],
112
- [''],
113
- ])
114
- expect(req.param()).toEqual({ remaining: '' })
115
- })
116
-
117
- describe('Type', () => {
118
- it('param() returns string | undefined when P is any (middleware context)', () => {
119
- // When middleware uses Context without an explicit path type, P defaults to any.
120
- // param(key) should return string | undefined, not string.
121
- const rawRequest = new Request('http://localhost/users/123')
122
- const req = new AcrylRequest<any>(rawRequest, '/users/123', [
123
- [[[undefined, {} as RouterRoute], { id: '123' }]],
124
- ])
125
- expectTypeOf(req.param('id')).toEqualTypeOf<string | undefined>()
126
- })
127
-
128
- it('param() returns string when P is a known route string', () => {
129
- // When P is a concrete route, named params should still return string (non-optional).
130
- const rawRequest = new Request('http://localhost/123')
131
- const req = new AcrylRequest<'/:id'>(rawRequest, '/123', [
132
- [[[undefined, {} as RouterRoute], { id: '123' }]],
133
- ])
134
- expectTypeOf(req.param('id')).toEqualTypeOf<string>()
135
- })
136
- })
137
- })
138
-
139
- describe('matchedRoutes', () => {
140
- test('req.routePath', () => {
141
- const handlerA = () => {}
142
- const handlerB = () => {}
143
- const rawRequest = new Request('http://localhost?page=2&tag=A&tag=B')
144
- const req = new AcrylRequest<'/:id/:name'>(rawRequest, '/123/key', [
145
- [
146
- [
147
- [handlerA, { basePath: '/', handler: handlerA, method: 'GET', path: '/:id' }],
148
- { id: '123' },
149
- ],
150
- [
151
- [handlerA, { basePath: '/', handler: handlerB, method: 'GET', path: '/:id/:name' }],
152
- { id: '456', name: 'key' },
153
- ],
154
- ],
155
- ])
156
-
157
- expect(req.matchedRoutes).toEqual([
158
- { basePath: '/', handler: handlerA, method: 'GET', path: '/:id' },
159
- { basePath: '/', handler: handlerB, method: 'GET', path: '/:id/:name' },
160
- ])
161
- })
162
- })
163
-
164
- describe('routePath', () => {
165
- test('req.routePath', () => {
166
- const handlerA = () => {}
167
- const handlerB = () => {}
168
- const rawRequest = new Request('http://localhost?page=2&tag=A&tag=B')
169
- const req = new AcrylRequest<'/:id/:name'>(rawRequest, '/123/key', [
170
- [
171
- [
172
- [handlerA, { basePath: '/', handler: handlerA, method: 'GET', path: '/:id' }],
173
- { id: '123' },
174
- ],
175
- [
176
- [handlerA, { basePath: '/', handler: handlerB, method: 'GET', path: '/:id/:name' }],
177
- { id: '456', name: 'key' },
178
- ],
179
- ],
180
- ])
181
-
182
- expect(req.routePath).toBe('/:id')
183
-
184
- req.routeIndex = 1
185
- expect(req.routePath).toBe('/:id/:name')
186
- })
187
- })
188
-
189
- describe('req.addValidatedData() and req.data()', () => {
190
- const rawRequest = new Request('http://localhost')
191
-
192
- const payload = {
193
- title: 'hello',
194
- author: {
195
- name: 'young man',
196
- age: 20,
197
- },
198
- }
199
-
200
- test('add data - json', () => {
201
- const req = new AcrylRequest<'/', { json: typeof payload }>(rawRequest)
202
- req.addValidatedData('json', payload)
203
- const data = req.valid('json')
204
- expect(data).toEqual(payload)
205
- })
206
-
207
- test('replace data - json', () => {
208
- const req = new AcrylRequest<'/', { json: typeof payload }>(rawRequest)
209
- req.addValidatedData('json', payload)
210
- req.addValidatedData('json', {
211
- tag: ['sport', 'music'],
212
- author: {
213
- tall: 170,
214
- },
215
- })
216
- const data = req.valid('json')
217
- expect(data).toEqual({
218
- author: {
219
- tall: 170,
220
- },
221
- tag: ['sport', 'music'],
222
- })
223
- })
224
- })
225
-
226
- describe('headers', () => {
227
- test('empty string is a valid header value', () => {
228
- const req = new AcrylRequest(new Request('http://localhost', { headers: { foo: '' } }))
229
- const foo = req.header('foo')
230
- expect(foo).toEqual('')
231
- })
232
-
233
- test('Keys of the arguments for req.header() are not case-sensitive', () => {
234
- const req = new AcrylRequest(
235
- new Request('http://localhost', {
236
- headers: {
237
- 'Content-Type': 'application/json',
238
- apikey: 'abc',
239
- lowercase: 'lowercase value',
240
- },
241
- })
242
- )
243
- expect(req.header('Content-Type')).toBe('application/json')
244
- expect(req.header('ApiKey')).toBe('abc')
245
- })
246
-
247
- test('req.header() is not affected by a `__proto__` header name', () => {
248
- const req = new AcrylRequest(new Request('http://localhost', { headers: { __proto__: 'evil' } }))
249
- const headers = req.header()
250
- expect(Object.getPrototypeOf(headers)).toBeNull()
251
- })
252
- })
253
-
254
- const text = '{"foo":"bar"}'
255
- const json = { foo: 'bar' }
256
- const buffer = new TextEncoder().encode('{"foo":"bar"}').buffer
257
-
258
- describe('Body methods with caching', () => {
259
- test('req.text()', async () => {
260
- const req = new AcrylRequest(
261
- new Request('http://localhost', {
262
- method: 'POST',
263
- body: text,
264
- })
265
- )
266
- expect(await req.text()).toEqual(text)
267
- expect(await req.json()).toEqual(json)
268
- expect(await req.arrayBuffer()).toEqual(buffer)
269
- expect(await req.bytes()).toEqual(new Uint8Array(buffer))
270
- expect(await req.blob()).toEqual(
271
- new Blob([text], {
272
- type: 'text/plain;charset=utf-8',
273
- })
274
- )
275
- })
276
-
277
- test('req.json()', async () => {
278
- const req = new AcrylRequest(
279
- new Request('http://localhost', {
280
- method: 'POST',
281
- body: '{"foo":"bar"}',
282
- })
283
- )
284
- expect(await req.json()).toEqual(json)
285
- expect(await req.text()).toEqual(text)
286
- expect(await req.arrayBuffer()).toEqual(buffer)
287
- expect(await req.bytes()).toEqual(new Uint8Array(buffer))
288
- expect(await req.blob()).toEqual(
289
- new Blob([text], {
290
- type: 'text/plain;charset=utf-8',
291
- })
292
- )
293
- })
294
-
295
- test('req.json() should keep the content as is', async () => {
296
- const text = '{ "foo" : "bar" }'
297
- const req = new AcrylRequest(
298
- new Request('http://localhost', {
299
- method: 'POST',
300
- body: text,
301
- })
302
- )
303
- expect(await req.json()).toEqual(JSON.parse(text))
304
- expect(await req.text()).toEqual(text)
305
- })
306
-
307
- test('req.arrayBuffer()', async () => {
308
- const buffer = new TextEncoder().encode('{"foo":"bar"}').buffer
309
- const req = new AcrylRequest(
310
- new Request('http://localhost', {
311
- method: 'POST',
312
- body: buffer,
313
- })
314
- )
315
- expect(await req.arrayBuffer()).toEqual(buffer)
316
- expect(await req.text()).toEqual(text)
317
- expect(await req.json()).toEqual(json)
318
- expect(await req.bytes()).toEqual(new Uint8Array(buffer))
319
- expect(await req.blob()).toEqual(
320
- new Blob([text], {
321
- type: '',
322
- })
323
- )
324
- })
325
-
326
- test('req.bytes()', async () => {
327
- const bytes = new TextEncoder().encode('{"foo":"bar"}')
328
- const req = new AcrylRequest(
329
- new Request('http://localhost', {
330
- method: 'POST',
331
- body: bytes,
332
- })
333
- )
334
- const result = await req.bytes()
335
- expect(result).toBeInstanceOf(Uint8Array)
336
- expect(result).toEqual(bytes)
337
- expect(await req.text()).toEqual(text)
338
- expect(await req.json()).toEqual(json)
339
- expect(await req.arrayBuffer()).toEqual(buffer)
340
- expect(await req.blob()).toEqual(
341
- new Blob([text], {
342
- type: '',
343
- })
344
- )
345
- })
346
-
347
- test('req.blob()', async () => {
348
- const blob = new Blob(['{"foo":"bar"}'], {
349
- type: 'application/json',
350
- })
351
- const req = new AcrylRequest(
352
- new Request('http://localhost', {
353
- method: 'POST',
354
- body: blob,
355
- })
356
- )
357
- expect(await req.blob()).toEqual(blob)
358
- expect(await req.text()).toEqual(text)
359
- expect(await req.json()).toEqual(json)
360
- expect(await req.arrayBuffer()).toEqual(buffer)
361
- expect(await req.bytes()).toEqual(new Uint8Array(buffer))
362
- })
363
-
364
- test('req.formData()', async () => {
365
- const data = new FormData()
366
- data.append('foo', 'bar')
367
- const req = new AcrylRequest(
368
- new Request('http://localhost', {
369
- method: 'POST',
370
- body: data,
371
- })
372
- )
373
- expect((await req.formData()).get('foo')).toBe('bar')
374
- expect(async () => await req.text()).not.toThrow()
375
- expect(async () => await req.arrayBuffer()).not.toThrow()
376
- expect(async () => await req.bytes()).not.toThrow()
377
- expect(async () => await req.blob()).not.toThrow()
378
- })
379
-
380
- describe('formData() after another representation has been cached', () => {
381
- const urlencoded = 'application/x-www-form-urlencoded'
382
- const body = 'foo=bar&baz=qux'
383
-
384
- for (const first of ['text', 'arrayBuffer', 'bytes', 'blob'] as const) {
385
- test(`req.formData() after req.${first}()`, async () => {
386
- const req = new AcrylRequest(
387
- new Request('http://localhost', {
388
- method: 'POST',
389
- headers: { 'Content-Type': urlencoded },
390
- body,
391
- })
392
- )
393
- await req[first]()
394
- const formData = await req.formData()
395
- expect(formData.get('foo')).toBe('bar')
396
- expect(formData.get('baz')).toBe('qux')
397
- })
398
- }
399
-
400
- test('req.formData() after req.text() for multipart/form-data', async () => {
401
- const boundary = '----acryl-test-boundary'
402
- const multipart =
403
- `--${boundary}\r\n` +
404
- 'Content-Disposition: form-data; name="foo"\r\n\r\n' +
405
- 'bar\r\n' +
406
- `--${boundary}--\r\n`
407
- const req = new AcrylRequest(
408
- new Request('http://localhost', {
409
- method: 'POST',
410
- headers: { 'Content-Type': `multipart/form-data; boundary=${boundary}` },
411
- body: multipart,
412
- })
413
- )
414
- await req.text()
415
- expect((await req.formData()).get('foo')).toBe('bar')
416
- })
417
-
418
- test('the cached representation is still returned unchanged', async () => {
419
- const req = new AcrylRequest(
420
- new Request('http://localhost', {
421
- method: 'POST',
422
- headers: { 'Content-Type': urlencoded },
423
- body,
424
- })
425
- )
426
- expect(await req.text()).toBe(body)
427
- expect(await req.text()).toBe(body)
428
- expect(await req.arrayBuffer()).toEqual(new TextEncoder().encode(body).buffer)
429
- })
430
- })
431
-
432
- describe('req.parseBody()', async () => {
433
- it('should parse form data', async () => {
434
- const data = new FormData()
435
- data.append('foo', 'bar')
436
- const req = new AcrylRequest(
437
- new Request('http://localhost', {
438
- method: 'POST',
439
- body: data,
440
- })
441
- )
442
- expect((await req.parseBody())['foo']).toBe('bar')
443
- expect(async () => await req.text()).not.toThrow()
444
- expect(async () => await req.arrayBuffer()).not.toThrow()
445
- expect(async () => await req.bytes()).not.toThrow()
446
- expect(async () => await req.blob()).not.toThrow()
447
- })
448
-
449
- it('should parse form data even if formData() is called before parseBody()', async () => {
450
- const data = new FormData()
451
- data.append('foo', 'bar')
452
- data.append('file', new File(['hello'], 't.txt', { type: 'text/plain' }))
453
- const req = new AcrylRequest(
454
- new Request('http://localhost', {
455
- method: 'POST',
456
- body: data,
457
- })
458
- )
459
- await req.formData()
460
- const body = await req.parseBody()
461
- expect(body['foo']).toBe('bar')
462
- expect(body['file']).toBeInstanceOf(File)
463
- })
464
-
465
- describe('should not break body methods after parseBody() with non-form content-type', () => {
466
- const createReq = () =>
467
- new AcrylRequest(
468
- new Request('http://localhost', {
469
- method: 'POST',
470
- body: JSON.stringify({ event: 'push' }),
471
- headers: { 'Content-Type': 'application/json' },
472
- })
473
- )
474
-
475
- it('text()', async () => {
476
- const req = createReq()
477
- await req.parseBody()
478
- expect(await req.text()).toBe(JSON.stringify({ event: 'push' }))
479
- })
480
-
481
- it('json()', async () => {
482
- const req = createReq()
483
- await req.parseBody()
484
- expect(await req.json()).toEqual({ event: 'push' })
485
- })
486
-
487
- it('arrayBuffer()', async () => {
488
- const req = createReq()
489
- await req.parseBody()
490
- expect(await req.arrayBuffer()).toBeInstanceOf(ArrayBuffer)
491
- })
492
-
493
- it('bytes()', async () => {
494
- const req = createReq()
495
- await req.parseBody()
496
- expect(await req.bytes()).toBeInstanceOf(Uint8Array)
497
- })
498
-
499
- it('blob()', async () => {
500
- const req = createReq()
501
- await req.parseBody()
502
- expect(await req.blob()).toBeInstanceOf(Blob)
503
- })
504
-
505
- it('formData()', async () => {
506
- const req = createReq()
507
- await req.parseBody()
508
- // application/json is not a valid formData content-type, so this should throw
509
- await expect(req.formData()).rejects.toThrow()
510
- })
511
- })
512
-
513
- describe('Return type', () => {
514
- let req: AcrylRequest
515
- beforeEach(() => {
516
- const data = new FormData()
517
- data.append('foo', 'bar')
518
- req = new AcrylRequest(
519
- new Request('http://localhost', {
520
- method: 'POST',
521
- body: data,
522
- })
523
- )
524
- })
525
-
526
- it('without options', async () => {
527
- expectTypeOf((await req.parseBody())['key']).toEqualTypeOf<string | File>()
528
- })
529
-
530
- it('{all: true}', async () => {
531
- expectTypeOf((await req.parseBody({ all: true }))['key']).toEqualTypeOf<
532
- string | File | (string | File)[]
533
- >()
534
- })
535
-
536
- it('{dot: true}', async () => {
537
- expectTypeOf((await req.parseBody({ dot: true }))['key']).toEqualTypeOf<
538
- string | File | RecursiveRecord<string, string | File>
539
- >()
540
- })
541
-
542
- it('{all: true, dot: true}', async () => {
543
- expectTypeOf((await req.parseBody({ all: true, dot: true }))['key']).toEqualTypeOf<
544
- | string
545
- | File
546
- | (string | File)[]
547
- | RecursiveRecord<string, string | File | (string | File)[]>
548
- >()
549
- })
550
-
551
- it('specify return type explicitly', async () => {
552
- expectTypeOf(
553
- await req.parseBody<{ key1: string; key2: string }>({ all: true, dot: true })
554
- ).toEqualTypeOf<{ key1: string; key2: string }>()
555
- })
556
- })
557
- })
558
- })
559
-
560
- describe('cloneRawRequest', () => {
561
- test('clones unconsumed request object', async () => {
562
- const req = new AcrylRequest(
563
- new Request('http://localhost', {
564
- method: 'POST',
565
- headers: {
566
- 'Content-Type': 'application/json',
567
- 'X-Custom-Header': 'custom-value',
568
- },
569
- body: text,
570
- cache: 'no-cache',
571
- credentials: 'include',
572
- integrity: 'sha256-test',
573
- mode: 'cors',
574
- redirect: 'follow',
575
- referrer: 'http://example.com',
576
- referrerPolicy: 'origin',
577
- })
578
- )
579
-
580
- const clonedReq = await cloneRawRequest(req)
581
-
582
- expect(clonedReq.method).toBe('POST')
583
- expect(clonedReq.url).toBe('http://localhost/')
584
- expect(await clonedReq.text()).toBe(text)
585
- expect(clonedReq.headers.get('Content-Type')).toBe('application/json')
586
- expect(clonedReq.headers.get('X-Custom-Header')).toBe('custom-value')
587
- expect(clonedReq.cache).toBe('no-cache')
588
- expect(clonedReq.credentials).toBe('include')
589
- expect(clonedReq.integrity).toBe('sha256-test')
590
- expect(clonedReq.mode).toBe('cors')
591
- expect(clonedReq.redirect).toBe('follow')
592
- expect(clonedReq.referrer).toBe('http://example.com/')
593
- expect(clonedReq.referrerPolicy).toBe('origin')
594
- expect(req.raw, 'cloned request should be a different object reference').not.toBe(clonedReq)
595
- expect(req.raw, 'cloned request should contain the same properties').toMatchObject(clonedReq)
596
- })
597
-
598
- test('clones consumed request object', async () => {
599
- const req = new AcrylRequest(
600
- new Request('http://localhost', {
601
- method: 'POST',
602
- headers: {
603
- Authorization: 'Bearer token123',
604
- },
605
- body: text,
606
- mode: 'same-origin',
607
- credentials: 'same-origin',
608
- })
609
- )
610
- await req.json()
611
-
612
- const clonedReq = await cloneRawRequest(req)
613
-
614
- expect(clonedReq.method).toBe('POST')
615
- expect(clonedReq.url).toBe('http://localhost/')
616
- expect(await clonedReq.json()).toEqual(json)
617
- expect(clonedReq.headers.get('Authorization')).toBe('Bearer token123')
618
- expect(clonedReq.mode).toBe('same-origin')
619
- expect(clonedReq.credentials).toBe('same-origin')
620
- expect(req.raw, 'cloned request should be a different object reference').not.toBe(clonedReq)
621
- expect(req.raw, 'cloned request should contain the same properties').toMatchObject(clonedReq)
622
- })
623
-
624
- test('clones consumed multipart request with a matching boundary', async () => {
625
- const data = new FormData()
626
- data.append('foo', 'bar')
627
- data.append('file', new File(['hello'], 't.txt', { type: 'text/plain' }))
628
- const req = new AcrylRequest(
629
- new Request('http://localhost', {
630
- method: 'POST',
631
- body: data,
632
- })
633
- )
634
- await req.formData()
635
-
636
- const clonedReq = await cloneRawRequest(req)
637
-
638
- const contentType = clonedReq.headers.get('Content-Type') ?? ''
639
- const boundary = contentType.split('boundary=')[1]
640
- const bodyText = await clonedReq.clone().text()
641
- expect(bodyText.startsWith(`--${boundary}`)).toBe(true)
642
-
643
- const formData = await clonedReq.formData()
644
- expect(formData.get('foo')).toBe('bar')
645
- expect(formData.get('file')).toBeInstanceOf(File)
646
- })
647
-
648
- test('drops stale content length when cloning consumed multipart request', async () => {
649
- const boundary = 'boundary'
650
- const body = [
651
- `--${boundary}`,
652
- 'Content-Disposition: form-data; name="foo"',
653
- '',
654
- 'bar',
655
- `--${boundary}--`,
656
- '',
657
- ].join('\r\n')
658
- const req = new AcrylRequest(
659
- new Request('http://localhost', {
660
- method: 'POST',
661
- headers: {
662
- 'Content-Type': `multipart/form-data; boundary=${boundary}`,
663
- 'Content-Length': new TextEncoder().encode(body).byteLength.toString(),
664
- },
665
- body,
666
- })
667
- )
668
- await req.formData()
669
-
670
- const clonedReq = await cloneRawRequest(req)
671
-
672
- expect(clonedReq.headers.has('Content-Length')).toBe(false)
673
- expect((await clonedReq.formData()).get('foo')).toBe('bar')
674
- })
675
-
676
- test('clones request when external code populated bodyCache.json', async () => {
677
- const req = new AcrylRequest(
678
- new Request('http://localhost', {
679
- method: 'POST',
680
- headers: {
681
- 'Content-Type': 'application/json',
682
- },
683
- body: JSON.stringify({ foo: 'bar' }),
684
- })
685
- )
686
- await req.raw.json()
687
- req.bodyCache.json = Promise.resolve({ foo: 'bar' })
688
-
689
- const clonedReq = await cloneRawRequest(req)
690
-
691
- expect(await clonedReq.json()).toEqual({ foo: 'bar' })
692
- })
693
-
694
- test('clones GET request without body', async () => {
695
- const req = new AcrylRequest(
696
- new Request('http://localhost', {
697
- method: 'GET',
698
- headers: {
699
- 'User-Agent': 'test-agent',
700
- },
701
- cache: 'default',
702
- redirect: 'manual',
703
- referrerPolicy: 'no-referrer',
704
- })
705
- )
706
-
707
- const clonedReq = await cloneRawRequest(req)
708
-
709
- expect(clonedReq.method).toBe('GET')
710
- expect(clonedReq.url).toBe('http://localhost/')
711
- expect(clonedReq.headers.get('User-Agent')).toBe('test-agent')
712
- expect(clonedReq.cache).toBe('default')
713
- expect(clonedReq.redirect).toBe('manual')
714
- expect(clonedReq.referrerPolicy).toBe('no-referrer')
715
- expect(req.raw, 'cloned request should be a different object reference').not.toBe(clonedReq)
716
- expect(req.raw, 'cloned request should contain the same properties').toMatchObject(clonedReq)
717
- })
718
-
719
- test('clones request when raw body was consumed directly without AcrylRequest methods', async () => {
720
- const req = new AcrylRequest(
721
- new Request('http://localhost', {
722
- method: 'POST',
723
- headers: {
724
- 'Content-Type': 'application/json',
725
- },
726
- body: text,
727
- })
728
- )
729
-
730
- // Consume the raw request body directly, bypassing AcrylRequest methods
731
- // This means bodyCache will be empty
732
- await req.raw.text()
733
-
734
- expect(req.raw.bodyUsed).toBe(true)
735
- expect(Object.keys(req.bodyCache).length).toBe(0)
736
-
737
- let error: HTTPException | undefined = undefined
738
- try {
739
- await cloneRawRequest(req)
740
- } catch (e) {
741
- expect(e).toBeInstanceOf(HTTPException)
742
- error = e as HTTPException
743
- }
744
-
745
- expect(error).not.toBeUndefined()
746
- expect((error as HTTPException).status).toBe(500)
747
- expect((error as HTTPException).message).toContain(
748
- 'Cannot clone request: body was already consumed and not cached'
749
- )
750
- })
751
- })