@forinda/kickjs 10.14.1 → 10.14.2

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 (278) hide show
  1. package/dist/{adapter-DL9JPcvC.d.mts → adapter-B64IOivZ.d.mts} +13 -53
  2. package/dist/adapter-B64IOivZ.d.mts.map +1 -0
  3. package/dist/{allowed-hosts-BpKwviq5.d.mts → allowed-hosts-U12_gESr.d.mts} +2 -4
  4. package/dist/allowed-hosts-U12_gESr.d.mts.map +1 -0
  5. package/dist/{app-module-Dk2Wenqx.d.mts → app-module-EmIojM4d.d.mts} +5 -11
  6. package/dist/app-module-EmIojM4d.d.mts.map +1 -0
  7. package/dist/application-BzimU62Q.mjs +14 -0
  8. package/dist/application-BzimU62Q.mjs.map +1 -0
  9. package/dist/{application-D921r4MW.d.mts → application-CGcY8SZZ.d.mts} +22 -74
  10. package/dist/application-CGcY8SZZ.d.mts.map +1 -0
  11. package/dist/{body-policy-CwgUYBw7.mjs → body-policy-Be3Y0hjq.mjs} +2 -2
  12. package/dist/{body-policy-CwgUYBw7.mjs.map → body-policy-Be3Y0hjq.mjs.map} +1 -1
  13. package/dist/{bootstrap-CY0v5VVF.mjs → bootstrap-Bvk3BWJX.mjs} +3 -3
  14. package/dist/{bootstrap-CY0v5VVF.mjs.map → bootstrap-Bvk3BWJX.mjs.map} +1 -1
  15. package/dist/{bounded-counters-CF8EnVUm.mjs → bounded-counters-Bh5jeT9I.mjs} +2 -2
  16. package/dist/{bounded-counters-CF8EnVUm.mjs.map → bounded-counters-Bh5jeT9I.mjs.map} +1 -1
  17. package/dist/{breach-padding-FBVGmcBb.d.mts → breach-padding-DfT9MXGb.d.mts} +2 -4
  18. package/dist/breach-padding-DfT9MXGb.d.mts.map +1 -0
  19. package/dist/{cache-CdRHSXow.d.mts → cache-DMIt3c6M.d.mts} +1 -3
  20. package/dist/cache-DMIt3c6M.d.mts.map +1 -0
  21. package/dist/{client-ip-CpEuptqr.mjs → client-ip-CGH_IvnC.mjs} +2 -2
  22. package/dist/{client-ip-CpEuptqr.mjs.map → client-ip-CGH_IvnC.mjs.map} +1 -1
  23. package/dist/config/index.d.mts +1 -1
  24. package/dist/config/index.mjs +2 -2
  25. package/dist/{config-Djisd0f5.mjs → config-CjFxvh0v.mjs} +3 -3
  26. package/dist/{config-Djisd0f5.mjs.map → config-CjFxvh0v.mjs.map} +1 -1
  27. package/dist/{connect-BlIamapT.d.mts → connect-DamOelO8.d.mts} +1 -3
  28. package/dist/connect-DamOelO8.d.mts.map +1 -0
  29. package/dist/{context-Cgr5dtIZ.mjs → context-BvZLaTeE.mjs} +3 -3
  30. package/dist/{context-Cgr5dtIZ.mjs.map → context-BvZLaTeE.mjs.map} +1 -1
  31. package/dist/{context-errors-6x0bjldv.mjs → context-errors-BZVS0B1O.mjs} +2 -2
  32. package/dist/{context-errors-6x0bjldv.mjs.map → context-errors-BZVS0B1O.mjs.map} +1 -1
  33. package/dist/{contributor-runner-DQ2fXJ29.mjs → contributor-runner-fdKy6Tme.mjs} +3 -3
  34. package/dist/{contributor-runner-DQ2fXJ29.mjs.map → contributor-runner-fdKy6Tme.mjs.map} +1 -1
  35. package/dist/core/adapter.d.mts +1 -1
  36. package/dist/core/adapter.mjs +1 -1
  37. package/dist/core/app-module.d.mts +1 -1
  38. package/dist/core/app-module.mjs +1 -1
  39. package/dist/core/cache.d.mts +1 -1
  40. package/dist/core/cache.mjs +1 -1
  41. package/dist/core/cache.mjs.map +1 -1
  42. package/dist/core/container.mjs +2 -2
  43. package/dist/core/cron.d.mts +1 -1
  44. package/dist/core/cron.mjs +2 -2
  45. package/dist/core/cron.mjs.map +1 -1
  46. package/dist/core/decorators.d.mts +1 -1
  47. package/dist/core/decorators.mjs +2 -2
  48. package/dist/core/decorators.mjs.map +1 -1
  49. package/dist/core/errors.d.mts +1 -1
  50. package/dist/core/errors.mjs +1 -1
  51. package/dist/core/errors.mjs.map +1 -1
  52. package/dist/core/interfaces.d.mts +1 -1
  53. package/dist/core/interfaces.mjs +1 -1
  54. package/dist/core/interfaces.mjs.map +1 -1
  55. package/dist/core/logger.d.mts +1 -1
  56. package/dist/core/logger.mjs +1 -1
  57. package/dist/core/logger.mjs.map +1 -1
  58. package/dist/core/path.d.mts +1 -1
  59. package/dist/core/path.mjs +1 -1
  60. package/dist/core/path.mjs.map +1 -1
  61. package/dist/core/plugin.d.mts +1 -1
  62. package/dist/core/plugin.mjs +1 -1
  63. package/dist/core/reactivity.d.mts +1 -1
  64. package/dist/core/reactivity.mjs +2 -2
  65. package/dist/core/reactivity.mjs.map +1 -1
  66. package/dist/{core-g3y9VDwr.mjs → core-CCIpjo6g.mjs} +3 -3
  67. package/dist/{core-g3y9VDwr.mjs.map → core-CCIpjo6g.mjs.map} +1 -1
  68. package/dist/{cors-BlR_b0Qb.d.mts → cors-J-q6PuSU.d.mts} +2 -4
  69. package/dist/cors-J-q6PuSU.d.mts.map +1 -0
  70. package/dist/{cron-BTGytNg-.d.mts → cron-DGV1AE0R.d.mts} +1 -3
  71. package/dist/cron-DGV1AE0R.d.mts.map +1 -0
  72. package/dist/{csrf-DOAaYozG.d.mts → csrf-DjtJPgA3.d.mts} +4 -6
  73. package/dist/csrf-DjtJPgA3.d.mts.map +1 -0
  74. package/dist/decorate-DRbXCNQz.mjs +13 -0
  75. package/dist/decorate-DRbXCNQz.mjs.map +1 -0
  76. package/dist/{decorators-DxNb5mWw.d.mts → decorators-BAD8qjuq.d.mts} +1 -5
  77. package/dist/decorators-BAD8qjuq.d.mts.map +1 -0
  78. package/dist/{define-adapter-CZCFyDp5.mjs → define-adapter-DMo6og81.mjs} +2 -2
  79. package/dist/{define-adapter-CZCFyDp5.mjs.map → define-adapter-DMo6og81.mjs.map} +1 -1
  80. package/dist/{di-hooks-ZfnBZMDp.mjs → di-hooks-DCqt2yJ9.mjs} +2 -2
  81. package/dist/{di-hooks-ZfnBZMDp.mjs.map → di-hooks-DCqt2yJ9.mjs.map} +1 -1
  82. package/dist/{disposables-DFZXQuVg.mjs → disposables-BsdVu69-.mjs} +1 -1
  83. package/dist/{driver-D_bUSW7N.mjs → driver-oZBQDJZz.mjs} +3 -3
  84. package/dist/{driver-D_bUSW7N.mjs.map → driver-oZBQDJZz.mjs.map} +1 -1
  85. package/dist/{error-handler-D7DLWe1Q.d.mts → error-handler-Dl_gZRNK.d.mts} +2 -4
  86. package/dist/error-handler-Dl_gZRNK.d.mts.map +1 -0
  87. package/dist/{errors-By6UueCm.d.mts → errors-DZGuPLoZ.d.mts} +1 -3
  88. package/dist/errors-DZGuPLoZ.d.mts.map +1 -0
  89. package/dist/{express-31o4SoCz.mjs → express-f9CTA8qO.mjs} +3 -3
  90. package/dist/{express-31o4SoCz.mjs.map → express-f9CTA8qO.mjs.map} +1 -1
  91. package/dist/{express-lazy-GCgYyykt.mjs → express-lazy-DMxcLBpT.mjs} +3 -3
  92. package/dist/{express-lazy-GCgYyykt.mjs.map → express-lazy-DMxcLBpT.mjs.map} +1 -1
  93. package/dist/{handler-Bvs0gx1o.mjs → handler-B66laQY0.mjs} +3 -3
  94. package/dist/{handler-Bvs0gx1o.mjs.map → handler-B66laQY0.mjs.map} +1 -1
  95. package/dist/{helmet-BVuVBl-D.d.mts → helmet-Rwkbp9IS.d.mts} +2 -4
  96. package/dist/helmet-Rwkbp9IS.d.mts.map +1 -0
  97. package/dist/{host-CKz7eCtO.mjs → host-DalMsn5Z.mjs} +2 -2
  98. package/dist/{host-CKz7eCtO.mjs.map → host-DalMsn5Z.mjs.map} +1 -1
  99. package/dist/http/application.d.mts +1 -1
  100. package/dist/http/application.mjs +2 -2
  101. package/dist/http/bootstrap.d.mts +1 -1
  102. package/dist/http/bootstrap.mjs +2 -2
  103. package/dist/http/context.d.mts +2 -2
  104. package/dist/http/context.mjs +2 -2
  105. package/dist/http/middleware/allowed-hosts.d.mts +1 -1
  106. package/dist/http/middleware/allowed-hosts.mjs +2 -2
  107. package/dist/http/middleware/allowed-hosts.mjs.map +1 -1
  108. package/dist/http/middleware/breach-padding.d.mts +1 -1
  109. package/dist/http/middleware/breach-padding.mjs +1 -1
  110. package/dist/http/middleware/breach-padding.mjs.map +1 -1
  111. package/dist/http/middleware/cors.d.mts +1 -1
  112. package/dist/http/middleware/cors.mjs +1 -1
  113. package/dist/http/middleware/cors.mjs.map +1 -1
  114. package/dist/http/middleware/csrf.d.mts +1 -1
  115. package/dist/http/middleware/csrf.mjs +2 -2
  116. package/dist/http/middleware/csrf.mjs.map +1 -1
  117. package/dist/http/middleware/error-handler.d.mts +1 -1
  118. package/dist/http/middleware/error-handler.mjs +2 -2
  119. package/dist/http/middleware/error-handler.mjs.map +1 -1
  120. package/dist/http/middleware/helmet.d.mts +1 -1
  121. package/dist/http/middleware/helmet.mjs +1 -1
  122. package/dist/http/middleware/helmet.mjs.map +1 -1
  123. package/dist/http/middleware/rate-limit.d.mts +1 -1
  124. package/dist/http/middleware/rate-limit.mjs +2 -2
  125. package/dist/http/middleware/rate-limit.mjs.map +1 -1
  126. package/dist/http/middleware/request-id.d.mts +1 -1
  127. package/dist/http/middleware/request-id.mjs +1 -1
  128. package/dist/http/middleware/request-id.mjs.map +1 -1
  129. package/dist/http/middleware/request-logger.d.mts +1 -1
  130. package/dist/http/middleware/request-logger.mjs +2 -2
  131. package/dist/http/middleware/request-logger.mjs.map +1 -1
  132. package/dist/http/middleware/session.d.mts +1 -1
  133. package/dist/http/middleware/session.mjs +2 -2
  134. package/dist/http/middleware/session.mjs.map +1 -1
  135. package/dist/http/middleware/spa.d.mts +1 -1
  136. package/dist/http/middleware/spa.mjs +2 -2
  137. package/dist/http/middleware/spa.mjs.map +1 -1
  138. package/dist/http/middleware/upload.d.mts +2 -2
  139. package/dist/http/middleware/upload.mjs +2 -2
  140. package/dist/http/middleware/upload.mjs.map +1 -1
  141. package/dist/http/middleware/validate.d.mts +1 -1
  142. package/dist/http/middleware/validate.mjs +1 -1
  143. package/dist/http/middleware/validate.mjs.map +1 -1
  144. package/dist/http/middleware/views.d.mts +1 -1
  145. package/dist/http/middleware/views.mjs +2 -2
  146. package/dist/http/middleware/views.mjs.map +1 -1
  147. package/dist/http/query/index.d.mts +1 -1
  148. package/dist/http/query/index.mjs +2 -2
  149. package/dist/http/router-builder.d.mts +1 -1
  150. package/dist/http/router-builder.mjs +2 -2
  151. package/dist/http/runtimes/express.d.mts +3 -7
  152. package/dist/http/runtimes/express.d.mts.map +1 -1
  153. package/dist/http/runtimes/express.mjs +2 -2
  154. package/dist/http/runtimes/fastify.d.mts +1 -3
  155. package/dist/http/runtimes/fastify.d.mts.map +1 -1
  156. package/dist/http/runtimes/fastify.mjs +2 -2
  157. package/dist/http/runtimes/fastify.mjs.map +1 -1
  158. package/dist/http/runtimes/h3-web.mjs +1 -1
  159. package/dist/http/runtimes/h3.d.mts +1 -3
  160. package/dist/http/runtimes/h3.d.mts.map +1 -1
  161. package/dist/http/runtimes/h3.mjs +2 -2
  162. package/dist/http/runtimes/h3.mjs.map +1 -1
  163. package/dist/{index-DP_I4puv.d.mts → index-CFTwnev9.d.mts} +3 -7
  164. package/dist/index-CFTwnev9.d.mts.map +1 -0
  165. package/dist/{index-Blgka75E.d.mts → index-ZbCnCyQx.d.mts} +1 -5
  166. package/dist/index-ZbCnCyQx.d.mts.map +1 -0
  167. package/dist/index.d.mts +30 -30
  168. package/dist/index.mjs +2 -2
  169. package/dist/index.mjs.map +1 -1
  170. package/dist/{interfaces-C6LHcYsg.d.mts → interfaces-BQhYh3lL.d.mts} +1 -3
  171. package/dist/interfaces-BQhYh3lL.d.mts.map +1 -0
  172. package/dist/{is-production-6wpWSGvS.mjs → is-production-9QzMIRuO.mjs} +2 -2
  173. package/dist/{is-production-6wpWSGvS.mjs.map → is-production-9QzMIRuO.mjs.map} +1 -1
  174. package/dist/{jobs-BTnyyRY1.mjs → jobs-CuZqVDDG.mjs} +3 -3
  175. package/dist/{jobs-BTnyyRY1.mjs.map → jobs-CuZqVDDG.mjs.map} +1 -1
  176. package/dist/{kv-stores-HUdUibOx.mjs → kv-stores-C9CJ3xCB.mjs} +3 -3
  177. package/dist/{kv-stores-HUdUibOx.mjs.map → kv-stores-C9CJ3xCB.mjs.map} +1 -1
  178. package/dist/{kv-stores-CwJdsMln.d.mts → kv-stores-wTD3VDPB.d.mts} +6 -18
  179. package/dist/kv-stores-wTD3VDPB.d.mts.map +1 -0
  180. package/dist/{lazy-serve-static-CZBn-40v.mjs → lazy-serve-static-DVWmKM7Z.mjs} +3 -3
  181. package/dist/{lazy-serve-static-CZBn-40v.mjs.map → lazy-serve-static-DVWmKM7Z.mjs.map} +1 -1
  182. package/dist/{logger-xE9qI_FS.d.mts → logger-BL8MiSrm.d.mts} +1 -3
  183. package/dist/logger-BL8MiSrm.d.mts.map +1 -0
  184. package/dist/{metadata-UjLEzS06.mjs → metadata-BZRtQog3.mjs} +1 -1
  185. package/dist/{observers-C4bWQTop.mjs → observers-B4VnKAHK.mjs} +2 -2
  186. package/dist/{observers-C4bWQTop.mjs.map → observers-B4VnKAHK.mjs.map} +1 -1
  187. package/dist/{path-CMwIHsdv.d.mts → path-DsenzqJ7.d.mts} +1 -3
  188. package/dist/path-DsenzqJ7.d.mts.map +1 -0
  189. package/dist/{precompressed-BNkw1Vrz.mjs → precompressed-AxF66Ls0.mjs} +2 -2
  190. package/dist/{precompressed-BNkw1Vrz.mjs.map → precompressed-AxF66Ls0.mjs.map} +1 -1
  191. package/dist/{query-DXIo1mII.mjs → query-BwUR-ssX.mjs} +2 -2
  192. package/dist/{query-DXIo1mII.mjs.map → query-BwUR-ssX.mjs.map} +1 -1
  193. package/dist/{rate-limit-DQDk6bAH.d.mts → rate-limit-DMiV6bAq.d.mts} +3 -5
  194. package/dist/rate-limit-DMiV6bAq.d.mts.map +1 -0
  195. package/dist/{reactivity-DZrc3Yhu.d.mts → reactivity-Dski64km.d.mts} +1 -3
  196. package/dist/reactivity-Dski64km.d.mts.map +1 -0
  197. package/dist/{reply-CpMbB8uH.mjs → reply-B5kZ6VGv.mjs} +3 -3
  198. package/dist/{reply-CpMbB8uH.mjs.map → reply-B5kZ6VGv.mjs.map} +1 -1
  199. package/dist/{request-id-Dn64nEHK.d.mts → request-id-B_n-3A16.d.mts} +2 -4
  200. package/dist/request-id-B_n-3A16.d.mts.map +1 -0
  201. package/dist/{request-logger-TgcKRNDD.d.mts → request-logger-BV1C5r5q.d.mts} +1 -3
  202. package/dist/request-logger-BV1C5r5q.d.mts.map +1 -0
  203. package/dist/{request-scope-DZQceiLY.mjs → request-scope-D2WQwatk.mjs} +3 -3
  204. package/dist/{request-scope-DZQceiLY.mjs.map → request-scope-D2WQwatk.mjs.map} +1 -1
  205. package/dist/{respond-Bc71p7sN.mjs → respond-C6ohI69y.mjs} +2 -2
  206. package/dist/{respond-Bc71p7sN.mjs.map → respond-C6ohI69y.mjs.map} +1 -1
  207. package/dist/{rolldown-runtime-Z3gdyCfQ.mjs → rolldown-runtime-DuhQYUab.mjs} +1 -1
  208. package/dist/{route-flag-DWNbpMIE.mjs → route-flag-CHiMvgar.mjs} +3 -3
  209. package/dist/{route-flag-DWNbpMIE.mjs.map → route-flag-CHiMvgar.mjs.map} +1 -1
  210. package/dist/{route-flag-B1lQht6v.d.mts → route-flag-CjXQl-oX.d.mts} +1 -3
  211. package/dist/route-flag-CjXQl-oX.d.mts.map +1 -0
  212. package/dist/{route-policy-DsdJx3bk.mjs → route-policy-ckK7N1eN.mjs} +2 -2
  213. package/dist/{route-policy-DsdJx3bk.mjs.map → route-policy-ckK7N1eN.mjs.map} +1 -1
  214. package/dist/{router-builder-CiwYhiUM.mjs → router-builder-D2cly8Wt.mjs} +3 -3
  215. package/dist/{router-builder-CiwYhiUM.mjs.map → router-builder-D2cly8Wt.mjs.map} +1 -1
  216. package/dist/{router-builder-C5EtcFSL.d.mts → router-builder-Dtyya4qP.d.mts} +3 -5
  217. package/dist/router-builder-Dtyya4qP.d.mts.map +1 -0
  218. package/dist/{runtime-Bus9RVyU.mjs → runtime-D9TN6CpL.mjs} +3 -3
  219. package/dist/{runtime-Bus9RVyU.mjs.map → runtime-D9TN6CpL.mjs.map} +1 -1
  220. package/dist/{session-DQG72vCf.d.mts → session-CXWu2rXW.d.mts} +2 -4
  221. package/dist/session-CXWu2rXW.d.mts.map +1 -0
  222. package/dist/{settings-DgZLgcNU.d.mts → settings-CB6lh6_s.d.mts} +1 -3
  223. package/dist/settings-CB6lh6_s.d.mts.map +1 -0
  224. package/dist/{settings-CNZ7iRli.mjs → settings-v2N3V8Bl.mjs} +4 -4
  225. package/dist/settings-v2N3V8Bl.mjs.map +1 -0
  226. package/dist/{token-CroYM4Lm.mjs → token-DtW16tw3.mjs} +1 -1
  227. package/dist/{upload-config-Bq3qcDel.mjs → upload-config-BXjBiNjC.mjs} +2 -2
  228. package/dist/{upload-config-Bq3qcDel.mjs.map → upload-config-BXjBiNjC.mjs.map} +1 -1
  229. package/dist/{upload-DnwvZQyi.d.mts → upload-eNNueUxR.d.mts} +4 -6
  230. package/dist/upload-eNNueUxR.d.mts.map +1 -0
  231. package/dist/{url-for-BCQLTEJj.mjs → url-for-C4Eomib7.mjs} +3 -3
  232. package/dist/{url-for-BCQLTEJj.mjs.map → url-for-C4Eomib7.mjs.map} +1 -1
  233. package/dist/{validate-D4Poe2EE.d.mts → validate-BbthfLBb.d.mts} +3 -5
  234. package/dist/validate-BbthfLBb.d.mts.map +1 -0
  235. package/dist/{view-renderer-Dbha_94K.mjs → view-renderer-C4sMEruA.mjs} +3 -3
  236. package/dist/{view-renderer-Dbha_94K.mjs.map → view-renderer-C4sMEruA.mjs.map} +1 -1
  237. package/dist/{web-crypto-CJiyfQrv.mjs → web-crypto-SXVOPDxW.mjs} +2 -2
  238. package/dist/{web-crypto-CJiyfQrv.mjs.map → web-crypto-SXVOPDxW.mjs.map} +1 -1
  239. package/dist/web.d.mts +7 -13
  240. package/dist/web.d.mts.map +1 -1
  241. package/dist/web.mjs +2 -2
  242. package/dist/web.mjs.map +1 -1
  243. package/package.json +4 -4
  244. package/dist/adapter-DL9JPcvC.d.mts.map +0 -1
  245. package/dist/allowed-hosts-BpKwviq5.d.mts.map +0 -1
  246. package/dist/app-module-Dk2Wenqx.d.mts.map +0 -1
  247. package/dist/application-BosHcuBZ.mjs +0 -14
  248. package/dist/application-BosHcuBZ.mjs.map +0 -1
  249. package/dist/application-D921r4MW.d.mts.map +0 -1
  250. package/dist/breach-padding-FBVGmcBb.d.mts.map +0 -1
  251. package/dist/cache-CdRHSXow.d.mts.map +0 -1
  252. package/dist/connect-BlIamapT.d.mts.map +0 -1
  253. package/dist/cors-BlR_b0Qb.d.mts.map +0 -1
  254. package/dist/cron-BTGytNg-.d.mts.map +0 -1
  255. package/dist/csrf-DOAaYozG.d.mts.map +0 -1
  256. package/dist/decorate-LMK39Sn6.mjs +0 -13
  257. package/dist/decorate-LMK39Sn6.mjs.map +0 -1
  258. package/dist/decorators-DxNb5mWw.d.mts.map +0 -1
  259. package/dist/error-handler-D7DLWe1Q.d.mts.map +0 -1
  260. package/dist/errors-By6UueCm.d.mts.map +0 -1
  261. package/dist/helmet-BVuVBl-D.d.mts.map +0 -1
  262. package/dist/index-Blgka75E.d.mts.map +0 -1
  263. package/dist/index-DP_I4puv.d.mts.map +0 -1
  264. package/dist/interfaces-C6LHcYsg.d.mts.map +0 -1
  265. package/dist/kv-stores-CwJdsMln.d.mts.map +0 -1
  266. package/dist/logger-xE9qI_FS.d.mts.map +0 -1
  267. package/dist/path-CMwIHsdv.d.mts.map +0 -1
  268. package/dist/rate-limit-DQDk6bAH.d.mts.map +0 -1
  269. package/dist/reactivity-DZrc3Yhu.d.mts.map +0 -1
  270. package/dist/request-id-Dn64nEHK.d.mts.map +0 -1
  271. package/dist/request-logger-TgcKRNDD.d.mts.map +0 -1
  272. package/dist/route-flag-B1lQht6v.d.mts.map +0 -1
  273. package/dist/router-builder-C5EtcFSL.d.mts.map +0 -1
  274. package/dist/session-DQG72vCf.d.mts.map +0 -1
  275. package/dist/settings-CNZ7iRli.mjs.map +0 -1
  276. package/dist/settings-DgZLgcNU.d.mts.map +0 -1
  277. package/dist/upload-DnwvZQyi.d.mts.map +0 -1
  278. package/dist/validate-D4Poe2EE.d.mts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"spa.mjs","names":["\"accept\""],"sources":["../../../src/http/middleware/spa.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { resolve, join, dirname, isAbsolute } from 'node:path'\nimport { Logger, defineAdapter } from '../../core'\nimport type { ConnectMiddleware } from '../runtime'\n\nconst log = Logger.for('SpaAdapter')\n\nexport interface SpaAdapterOptions {\n /**\n * Directory containing the built SPA files (index.html, assets, etc.)\n * Default: 'dist/client'\n *\n * @example\n * ```ts\n * // Vue: 'dist'\n * // React (Vite): 'dist'\n * // React (CRA): 'build'\n * // Svelte: 'build'\n * // Angular: 'dist/my-app/browser'\n * ```\n */\n clientDir?: string\n\n /**\n * URL prefix for API routes. SPA fallback only applies to\n * non-API routes (routes NOT starting with this prefix).\n * Default: '/api'\n *\n * Matching is segment-aware: `/api` excludes `/api` and `/api/users`, but\n * NOT `/apidocs` — a plain `startsWith` swallowed any path that merely\n * began with the same letters.\n *\n * Set to an array for multiple prefixes:\n * ```ts\n * apiPrefix: ['/api', '/graphql', '/_debug']\n * ```\n */\n apiPrefix?: string | string[]\n\n /**\n * Additional paths to exclude from SPA fallback.\n * These paths will NOT serve index.html. Segment-aware, like `apiPrefix`.\n *\n * @example\n * ```ts\n * exclude: ['/health', '/metrics', '/ws']\n * ```\n */\n exclude?: string[]\n\n /**\n * Cache-Control header for static assets (default: 'public, max-age=31536000, immutable')\n * Set to false to disable caching headers.\n */\n cacheControl?: string | false\n\n /**\n * Cache-Control for index.html (default: 'no-cache')\n * index.html should not be cached to ensure clients get fresh builds.\n */\n indexCacheControl?: string\n\n /**\n * Serve index.html even when the client did not ask for HTML.\n * Default: false.\n *\n * By default the fallback only fires for requests whose `Accept` header\n * includes `text/html` — the rule `connect-history-api-fallback` uses. That\n * keeps a missing `/assets/app.js` a 404 instead of handing back an HTML\n * document that the browser then fails to parse as JavaScript, which is a\n * confusing way to discover a broken build.\n *\n * Turn this on if you have non-browser clients that deep-link into SPA\n * routes without an `Accept` header.\n */\n alwaysFallback?: boolean\n}\n\n/**\n * Nearest directory at or above `from` that holds a `package.json`.\n * `null` when the walk reaches the filesystem root without finding one.\n */\nfunction nearestPackageRoot(from: string): string | null {\n let dir = from\n for (;;) {\n if (existsSync(join(dir, 'package.json'))) return dir\n const parent = dirname(dir)\n if (parent === dir) return null\n dir = parent\n }\n}\n\n/**\n * Where to look for the built SPA.\n *\n * `process.cwd()` is the framework's convention (assets and env files resolve\n * the same way) and stays the primary base. But a relative `clientDir` then\n * only works when the process happens to be started from the app directory —\n * `node server/dist/index.js` run from a monorepo root resolved `../web/dist`\n * against the root and found nothing, serving no SPA with only a warning.\n *\n * So: try cwd first, and only if that misses, retry against the package root\n * of the entry script. Both are checked for existence before being chosen, so\n * this can never silently pick a directory that is not there — a genuinely\n * missing build still lands on the cwd path, which is what the warning names.\n *\n * Deliberately not entry-relative FIRST: under `kick dev` the entry is the CLI\n * binary, whose package root is the CLI itself.\n *\n * Exported for tests only — not re-exported from the package index.\n */\nexport function resolveClientDir(\n clientDir: string,\n // Injected rather than read from the process so tests can exercise the\n // monorepo-root case without `process.chdir` / `process.argv` mutation —\n // neither is supported under vitest's `threads` pool, and the root config\n // uses exactly that.\n cwd: string = process.cwd(),\n entry: string | undefined = process.argv[1],\n): string {\n // `resolve` even for an already-absolute path: `resolvesToFile` compares its\n // (always normalized) target against this string, so a trailing slash or a\n // `.`/`..` segment here would make the containment check never match and\n // silently drop the Cache-Control header on every request. Fails closed, so\n // it never weakened the traversal guard — it just stopped doing its job.\n if (isAbsolute(clientDir)) return resolve(clientDir)\n const fromCwd = resolve(cwd, clientDir)\n if (existsSync(fromCwd)) return fromCwd\n\n if (entry) {\n const root = nearestPackageRoot(dirname(resolve(entry)))\n if (root) {\n const fromEntry = resolve(root, clientDir)\n if (existsSync(fromEntry)) return fromEntry\n }\n }\n return fromCwd\n}\n\n/**\n * The slice of the request/response this adapter touches, spelled from the\n * node `http` shapes rather than Express's. `ConnectMiddleware` is typed as\n * Express's `RequestHandler`, but under Fastify and h3 these handlers receive\n * the raw node objects (or a driver), so relying on `req.path` / `res.send`\n * is what made the previous version Express-only.\n */\ninterface SpaRequest {\n url?: string\n method?: string\n headers?: Record<string, string | string[] | undefined>\n}\n\ninterface SpaResponse {\n setHeader(name: string, value: string): void\n statusCode: number\n end(chunk?: string): void\n}\n\ntype SpaHandler = (req: SpaRequest, res: SpaResponse, next: () => void) => void\n\n/** Pathname only — `req.url` carries the query string, and `req.path` is Express-only. */\nfunction pathnameOf(url: string | undefined): string {\n if (!url) return '/'\n const q = url.indexOf('?')\n const h = url.indexOf('#')\n const end = Math.min(q === -1 ? url.length : q, h === -1 ? url.length : h)\n return url.slice(0, end) || '/'\n}\n\n/**\n * Segment-aware prefix test: `/api` covers `/api` and `/api/users`, not\n * `/apidocs`. `startsWith` alone made any same-prefixed route disappear from\n * the SPA fallback and 404 instead.\n */\nfunction isUnder(pathname: string, prefix: string): boolean {\n if (!prefix || prefix === '/') return true\n const p = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix\n return pathname === p || pathname.startsWith(`${p}/`)\n}\n\n/** Media ranges that count as \"the client wants a document\". */\nconst HTML_TYPES = ['text/html', 'application/xhtml+xml']\n\n/** `q` for a media range, defaulting to 1 when absent or unparseable. */\nfunction qualityOf(params: string[]): number {\n const q = params.find((param) => param.startsWith('q='))\n if (!q) return 1\n const value = Number.parseFloat(q.slice(2))\n return Number.isNaN(value) ? 1 : value\n}\n\n/**\n * Does the client want an HTML document back?\n *\n * Parses media ranges with q-values rather than substring-matching:\n * `Accept: text/html;q=0` explicitly says HTML is NOT acceptable (RFC 9110\n * §12.5.1 — \"a value of 0 means not acceptable\"), and a substring check read\n * that as a yes and returned the document anyway.\n *\n * Wildcards are matched by specificity, as RFC 9110 §12.5.1 requires: an exact\n * `text/html` beats `text/*`, so `Accept: text/*, text/html;q=0` correctly\n * rejects HTML even though the wildcard would have accepted it.\n *\n * A bare `*` / `*` deliberately does NOT count, at any q. Assets are fetched\n * with `Accept: * / *`, and treating that as a document request is what makes\n * a missing script come back as HTML — the very thing the fallback rules\n * exist to prevent.\n */\nfunction acceptsHtml(accept: string | string[] | undefined): boolean {\n const raw = Array.isArray(accept) ? accept.join(',') : (accept ?? '')\n if (!raw) return false\n\n const ranges = raw\n .split(',')\n .map((part) => part.split(';').map((t) => t.trim().toLowerCase()))\n .filter(([type]) => Boolean(type))\n\n return HTML_TYPES.some((htmlType) => {\n const [group] = htmlType.split('/')\n // Most specific match wins: exact type, else `type/*`. `*/*` is skipped.\n const exact = ranges.find(([type]) => type === htmlType)\n const wildcard = ranges.find(([type]) => type === `${group}/*`)\n const match = exact ?? wildcard\n return match ? qualityOf(match.slice(1)) > 0 : false\n })\n}\n\n/**\n * SPA adapter — serve a Vue, React, Svelte, or Angular build alongside\n * your KickJS API. API routes are handled by controllers; everything else\n * falls back to index.html for client-side routing.\n *\n * Written against the engine-agnostic `http` surface (`serveStatic` / `use`),\n * so it runs under Express, Fastify, and h3 alike. The previous version\n * reached for `express.static`, `req.path`, and `res.send`, all of which are\n * Express-only — it silently served nothing on the other runtimes.\n *\n * Migrated to the `defineAdapter()` factory — call without `new`, as\n * `ViewAdapter` has since v4.\n *\n * @example\n * ```ts\n * import { SpaAdapter } from '@forinda/kickjs/spa'\n *\n * bootstrap({\n * modules,\n * adapters: [\n * SpaAdapter({\n * clientDir: 'dist/client', // or 'build', 'dist', etc.\n * apiPrefix: '/api',\n * }),\n * ],\n * })\n * ```\n *\n * File structure:\n * ```\n * dist/\n * client/ ← SPA build output\n * index.html\n * assets/\n * app.js\n * style.css\n * server/ ← KickJS server\n * ```\n */\nexport const SpaAdapter = defineAdapter<SpaAdapterOptions>({\n name: 'SpaAdapter',\n defaults: {\n clientDir: 'dist/client',\n apiPrefix: '/api',\n exclude: [],\n cacheControl: 'public, max-age=31536000, immutable',\n indexCacheControl: 'no-cache',\n alwaysFallback: false,\n },\n build: (config) => {\n const clientDir = resolveClientDir(config.clientDir ?? 'dist/client')\n const rawPrefix = config.apiPrefix ?? '/api'\n const apiPrefixes = Array.isArray(rawPrefix) ? rawPrefix : [rawPrefix]\n const excludePaths = config.exclude ?? []\n const cacheControl = config.cacheControl ?? 'public, max-age=31536000, immutable'\n const indexCacheControl = config.indexCacheControl ?? 'no-cache'\n const alwaysFallback = config.alwaysFallback ?? false\n\n let indexHtml: string | null = null\n\n /**\n * Every file in the build, as request paths (`/assets/app.js`), captured\n * once at mount.\n *\n * This used to be a `statSync` per request. That is a synchronous\n * filesystem call on the hot path of every non-reserved request, and a\n * slow or contended disk blocks the event loop for unrelated requests.\n * The directory is a static build — its contents are already snapshotted\n * at boot, since `index.html` is read into memory there — so the lookup\n * belongs in memory too. No filesystem access remains in the request path.\n *\n * A build added to after boot is not picked up, which is the same\n * contract `index.html` already had.\n */\n let assetPaths: ReadonlySet<string> = new Set()\n\n function snapshotClientDir(): ReadonlySet<string> {\n const paths = new Set<string>()\n // A hand-rolled walk rather than `readdirSync(dir, { recursive: true })`\n // with `Dirent.parentPath`. Both are newer than the package's declared\n // `node >=20.0`: the `recursive` option landed in 20.1, `parentPath` in\n // 20.12, and the older `Dirent.path` alias it replaced is already gone\n // on Node 24 — so no single spelling covers the supported range. The\n // failure would have been silent, too: the surrounding `catch` turns a\n // `TypeError` from `join(undefined, name)` into an empty snapshot, which\n // reads as \"no files\" and drops every Cache-Control header.\n //\n // `readdirSync(dir, { withFileTypes: true })` is ancient and stable, and\n // tracking the parent ourselves needs no new API.\n const walk = (absDir: string, prefix: string): void => {\n for (const entry of readdirSync(absDir, { withFileTypes: true })) {\n const child = `${prefix}/${entry.name}`\n // Symlinks report as neither file nor directory here (readdir does\n // not follow them), so a symlinked tree is skipped rather than\n // risking a cycle. A symlinked asset simply goes unlabelled — the\n // static layer still serves it, it just misses the cache header.\n if (entry.isDirectory()) walk(join(absDir, entry.name), child)\n else if (entry.isFile()) paths.add(child)\n }\n }\n try {\n walk(clientDir, '')\n } catch {\n // Unreadable build directory — fall back to labelling nothing rather\n // than failing the boot. Serving still works; caching just opts out.\n return new Set()\n }\n return paths\n }\n\n /**\n * How the static layer will answer this path: as the index document, as a\n * long-lived asset, or not at all.\n *\n * Membership of the snapshot IS the containment guard — a traversal like\n * `/../../etc/passwd` simply is not a key — so no prefix comparison is\n * needed and the whole check is one `Set.has`.\n */\n const classifyPath = (pathname: string): 'file' | 'index' | null => {\n let decoded: string\n try {\n decoded = decodeURIComponent(pathname)\n } catch {\n return null\n }\n if (decoded.includes('\\0')) return null\n\n // A directory is served from its `index.html`, so `/` — the single most\n // common request — is an index request, not an asset. Reporting it as\n // neither left the root document without the configured policy.\n const asIndex = decoded.endsWith('/') ? `${decoded}index.html` : null\n if (asIndex && assetPaths.has(asIndex)) return 'index'\n if (!assetPaths.has(decoded)) return null\n return decoded.endsWith('.html') ? 'index' : 'file'\n }\n\n /** Skipped by the fallback: API routes, opted-out paths. */\n const isReserved = (pathname: string): boolean =>\n apiPrefixes.some((p) => isUnder(pathname, p)) ||\n excludePaths.some((p) => isUnder(pathname, p))\n\n return {\n beforeMount({ http }) {\n if (!existsSync(clientDir)) {\n log.warn(`SPA client directory not found: ${clientDir}`)\n log.warn(\n `Build your frontend first, or set clientDir to the correct path ` +\n `(relative paths resolve from ${process.cwd()}).`,\n )\n return\n }\n\n const indexPath = join(clientDir, 'index.html')\n if (!existsSync(indexPath)) {\n log.warn(`index.html not found in ${clientDir}`)\n return\n }\n indexHtml = readFileSync(indexPath, 'utf-8')\n assetPaths = snapshotClientDir()\n\n // Cache-Control runs as its own middleware ahead of the static\n // handler: the engine-agnostic `serveStatic` takes no header hook,\n // and headers set before the static layer writes still land on the\n // response. Keyed off the request path rather than the resolved file,\n // which is the same decision `express.static`'s `setHeaders` made.\n if (cacheControl !== false) {\n http.use(((req, res, next) => {\n const pathname = pathnameOf(req.url)\n // Only label a response the static layer will actually serve.\n // `express.static`'s `setHeaders` fired on hits only; running as\n // a separate middleware loses that, and an unconditional header\n // put `immutable, max-age=31536000` on the 404 for a missing\n // asset — telling every cache to keep that miss for a year.\n const kind = isReserved(pathname) ? null : classifyPath(pathname)\n if (kind) {\n res.setHeader('Cache-Control', kind === 'index' ? indexCacheControl : cacheControl)\n }\n next()\n }) satisfies SpaHandler as unknown as ConnectMiddleware)\n }\n\n http.serveStatic('/', clientDir)\n log.debug(`Serving SPA from ${clientDir}`)\n },\n\n beforeStart({ http }) {\n if (!indexHtml) return\n\n http.use(((req, res, next) => {\n // GET and HEAD both navigate. HEAD used to fall through to a 404,\n // which broke proxies and link checkers probing SPA routes.\n const method = (req.method ?? 'GET').toUpperCase()\n if (method !== 'GET' && method !== 'HEAD') return next()\n\n const pathname = pathnameOf(req.url)\n if (isReserved(pathname)) return next()\n\n // Content negotiation instead of a \"does the path contain a dot\"\n // guess. The old heuristic 404'd every legitimate route carrying a\n // dot (`/users/john.doe`, `/v1.2/spec`) while still handing HTML to\n // genuinely missing assets whose path had no extension.\n const accept = req.headers?.['accept'] as string | string[] | undefined\n if (!alwaysFallback && !acceptsHtml(accept)) return next()\n\n const body = indexHtml as string\n res.setHeader('Content-Type', 'text/html; charset=utf-8')\n res.setHeader('Cache-Control', indexCacheControl)\n res.setHeader('Content-Length', String(Buffer.byteLength(body)))\n res.statusCode = 200\n // HEAD must carry identical headers and no body.\n res.end(method === 'HEAD' ? undefined : body)\n }) satisfies SpaHandler as unknown as ConnectMiddleware)\n },\n }\n },\n})\n"],"mappings":"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"}
1
+ {"version":3,"file":"spa.mjs","names":["\"accept\""],"sources":["../../../src/http/middleware/spa.ts"],"sourcesContent":["import { existsSync, readdirSync, readFileSync } from 'node:fs'\nimport { resolve, join, dirname, isAbsolute } from 'node:path'\nimport { Logger, defineAdapter } from '../../core'\nimport type { ConnectMiddleware } from '../runtime'\n\nconst log = Logger.for('SpaAdapter')\n\nexport interface SpaAdapterOptions {\n /**\n * Directory containing the built SPA files (index.html, assets, etc.)\n * Default: 'dist/client'\n *\n * @example\n * ```ts\n * // Vue: 'dist'\n * // React (Vite): 'dist'\n * // React (CRA): 'build'\n * // Svelte: 'build'\n * // Angular: 'dist/my-app/browser'\n * ```\n */\n clientDir?: string\n\n /**\n * URL prefix for API routes. SPA fallback only applies to\n * non-API routes (routes NOT starting with this prefix).\n * Default: '/api'\n *\n * Matching is segment-aware: `/api` excludes `/api` and `/api/users`, but\n * NOT `/apidocs` — a plain `startsWith` swallowed any path that merely\n * began with the same letters.\n *\n * Set to an array for multiple prefixes:\n * ```ts\n * apiPrefix: ['/api', '/graphql', '/_debug']\n * ```\n */\n apiPrefix?: string | string[]\n\n /**\n * Additional paths to exclude from SPA fallback.\n * These paths will NOT serve index.html. Segment-aware, like `apiPrefix`.\n *\n * @example\n * ```ts\n * exclude: ['/health', '/metrics', '/ws']\n * ```\n */\n exclude?: string[]\n\n /**\n * Cache-Control header for static assets (default: 'public, max-age=31536000, immutable')\n * Set to false to disable caching headers.\n */\n cacheControl?: string | false\n\n /**\n * Cache-Control for index.html (default: 'no-cache')\n * index.html should not be cached to ensure clients get fresh builds.\n */\n indexCacheControl?: string\n\n /**\n * Serve index.html even when the client did not ask for HTML.\n * Default: false.\n *\n * By default the fallback only fires for requests whose `Accept` header\n * includes `text/html` — the rule `connect-history-api-fallback` uses. That\n * keeps a missing `/assets/app.js` a 404 instead of handing back an HTML\n * document that the browser then fails to parse as JavaScript, which is a\n * confusing way to discover a broken build.\n *\n * Turn this on if you have non-browser clients that deep-link into SPA\n * routes without an `Accept` header.\n */\n alwaysFallback?: boolean\n}\n\n/**\n * Nearest directory at or above `from` that holds a `package.json`.\n * `null` when the walk reaches the filesystem root without finding one.\n */\nfunction nearestPackageRoot(from: string): string | null {\n let dir = from\n for (;;) {\n if (existsSync(join(dir, 'package.json'))) return dir\n const parent = dirname(dir)\n if (parent === dir) return null\n dir = parent\n }\n}\n\n/**\n * Where to look for the built SPA.\n *\n * `process.cwd()` is the framework's convention (assets and env files resolve\n * the same way) and stays the primary base. But a relative `clientDir` then\n * only works when the process happens to be started from the app directory —\n * `node server/dist/index.js` run from a monorepo root resolved `../web/dist`\n * against the root and found nothing, serving no SPA with only a warning.\n *\n * So: try cwd first, and only if that misses, retry against the package root\n * of the entry script. Both are checked for existence before being chosen, so\n * this can never silently pick a directory that is not there — a genuinely\n * missing build still lands on the cwd path, which is what the warning names.\n *\n * Deliberately not entry-relative FIRST: under `kick dev` the entry is the CLI\n * binary, whose package root is the CLI itself.\n *\n * Exported for tests only — not re-exported from the package index.\n */\nexport function resolveClientDir(\n clientDir: string,\n // Injected rather than read from the process so tests can exercise the\n // monorepo-root case without `process.chdir` / `process.argv` mutation —\n // neither is supported under vitest's `threads` pool, and the root config\n // uses exactly that.\n cwd: string = process.cwd(),\n entry: string | undefined = process.argv[1],\n): string {\n // `resolve` even for an already-absolute path: `resolvesToFile` compares its\n // (always normalized) target against this string, so a trailing slash or a\n // `.`/`..` segment here would make the containment check never match and\n // silently drop the Cache-Control header on every request. Fails closed, so\n // it never weakened the traversal guard — it just stopped doing its job.\n if (isAbsolute(clientDir)) return resolve(clientDir)\n const fromCwd = resolve(cwd, clientDir)\n if (existsSync(fromCwd)) return fromCwd\n\n if (entry) {\n const root = nearestPackageRoot(dirname(resolve(entry)))\n if (root) {\n const fromEntry = resolve(root, clientDir)\n if (existsSync(fromEntry)) return fromEntry\n }\n }\n return fromCwd\n}\n\n/**\n * The slice of the request/response this adapter touches, spelled from the\n * node `http` shapes rather than Express's. `ConnectMiddleware` is typed as\n * Express's `RequestHandler`, but under Fastify and h3 these handlers receive\n * the raw node objects (or a driver), so relying on `req.path` / `res.send`\n * is what made the previous version Express-only.\n */\ninterface SpaRequest {\n url?: string\n method?: string\n headers?: Record<string, string | string[] | undefined>\n}\n\ninterface SpaResponse {\n setHeader(name: string, value: string): void\n statusCode: number\n end(chunk?: string): void\n}\n\ntype SpaHandler = (req: SpaRequest, res: SpaResponse, next: () => void) => void\n\n/** Pathname only — `req.url` carries the query string, and `req.path` is Express-only. */\nfunction pathnameOf(url: string | undefined): string {\n if (!url) return '/'\n const q = url.indexOf('?')\n const h = url.indexOf('#')\n const end = Math.min(q === -1 ? url.length : q, h === -1 ? url.length : h)\n return url.slice(0, end) || '/'\n}\n\n/**\n * Segment-aware prefix test: `/api` covers `/api` and `/api/users`, not\n * `/apidocs`. `startsWith` alone made any same-prefixed route disappear from\n * the SPA fallback and 404 instead.\n */\nfunction isUnder(pathname: string, prefix: string): boolean {\n if (!prefix || prefix === '/') return true\n const p = prefix.endsWith('/') ? prefix.slice(0, -1) : prefix\n return pathname === p || pathname.startsWith(`${p}/`)\n}\n\n/** Media ranges that count as \"the client wants a document\". */\nconst HTML_TYPES = ['text/html', 'application/xhtml+xml']\n\n/** `q` for a media range, defaulting to 1 when absent or unparseable. */\nfunction qualityOf(params: string[]): number {\n const q = params.find((param) => param.startsWith('q='))\n if (!q) return 1\n const value = Number.parseFloat(q.slice(2))\n return Number.isNaN(value) ? 1 : value\n}\n\n/**\n * Does the client want an HTML document back?\n *\n * Parses media ranges with q-values rather than substring-matching:\n * `Accept: text/html;q=0` explicitly says HTML is NOT acceptable (RFC 9110\n * §12.5.1 — \"a value of 0 means not acceptable\"), and a substring check read\n * that as a yes and returned the document anyway.\n *\n * Wildcards are matched by specificity, as RFC 9110 §12.5.1 requires: an exact\n * `text/html` beats `text/*`, so `Accept: text/*, text/html;q=0` correctly\n * rejects HTML even though the wildcard would have accepted it.\n *\n * A bare `*` / `*` deliberately does NOT count, at any q. Assets are fetched\n * with `Accept: * / *`, and treating that as a document request is what makes\n * a missing script come back as HTML — the very thing the fallback rules\n * exist to prevent.\n */\nfunction acceptsHtml(accept: string | string[] | undefined): boolean {\n const raw = Array.isArray(accept) ? accept.join(',') : (accept ?? '')\n if (!raw) return false\n\n const ranges = raw\n .split(',')\n .map((part) => part.split(';').map((t) => t.trim().toLowerCase()))\n .filter(([type]) => Boolean(type))\n\n return HTML_TYPES.some((htmlType) => {\n const [group] = htmlType.split('/')\n // Most specific match wins: exact type, else `type/*`. `*/*` is skipped.\n const exact = ranges.find(([type]) => type === htmlType)\n const wildcard = ranges.find(([type]) => type === `${group}/*`)\n const match = exact ?? wildcard\n return match ? qualityOf(match.slice(1)) > 0 : false\n })\n}\n\n/**\n * SPA adapter — serve a Vue, React, Svelte, or Angular build alongside\n * your KickJS API. API routes are handled by controllers; everything else\n * falls back to index.html for client-side routing.\n *\n * Written against the engine-agnostic `http` surface (`serveStatic` / `use`),\n * so it runs under Express, Fastify, and h3 alike. The previous version\n * reached for `express.static`, `req.path`, and `res.send`, all of which are\n * Express-only — it silently served nothing on the other runtimes.\n *\n * Migrated to the `defineAdapter()` factory — call without `new`, as\n * `ViewAdapter` has since v4.\n *\n * @example\n * ```ts\n * import { SpaAdapter } from '@forinda/kickjs/spa'\n *\n * bootstrap({\n * modules,\n * adapters: [\n * SpaAdapter({\n * clientDir: 'dist/client', // or 'build', 'dist', etc.\n * apiPrefix: '/api',\n * }),\n * ],\n * })\n * ```\n *\n * File structure:\n * ```\n * dist/\n * client/ ← SPA build output\n * index.html\n * assets/\n * app.js\n * style.css\n * server/ ← KickJS server\n * ```\n */\nexport const SpaAdapter = defineAdapter<SpaAdapterOptions>({\n name: 'SpaAdapter',\n defaults: {\n clientDir: 'dist/client',\n apiPrefix: '/api',\n exclude: [],\n cacheControl: 'public, max-age=31536000, immutable',\n indexCacheControl: 'no-cache',\n alwaysFallback: false,\n },\n build: (config) => {\n const clientDir = resolveClientDir(config.clientDir ?? 'dist/client')\n const rawPrefix = config.apiPrefix ?? '/api'\n const apiPrefixes = Array.isArray(rawPrefix) ? rawPrefix : [rawPrefix]\n const excludePaths = config.exclude ?? []\n const cacheControl = config.cacheControl ?? 'public, max-age=31536000, immutable'\n const indexCacheControl = config.indexCacheControl ?? 'no-cache'\n const alwaysFallback = config.alwaysFallback ?? false\n\n let indexHtml: string | null = null\n\n /**\n * Every file in the build, as request paths (`/assets/app.js`), captured\n * once at mount.\n *\n * This used to be a `statSync` per request. That is a synchronous\n * filesystem call on the hot path of every non-reserved request, and a\n * slow or contended disk blocks the event loop for unrelated requests.\n * The directory is a static build — its contents are already snapshotted\n * at boot, since `index.html` is read into memory there — so the lookup\n * belongs in memory too. No filesystem access remains in the request path.\n *\n * A build added to after boot is not picked up, which is the same\n * contract `index.html` already had.\n */\n let assetPaths: ReadonlySet<string> = new Set()\n\n function snapshotClientDir(): ReadonlySet<string> {\n const paths = new Set<string>()\n // A hand-rolled walk rather than `readdirSync(dir, { recursive: true })`\n // with `Dirent.parentPath`. Both are newer than the package's declared\n // `node >=20.0`: the `recursive` option landed in 20.1, `parentPath` in\n // 20.12, and the older `Dirent.path` alias it replaced is already gone\n // on Node 24 — so no single spelling covers the supported range. The\n // failure would have been silent, too: the surrounding `catch` turns a\n // `TypeError` from `join(undefined, name)` into an empty snapshot, which\n // reads as \"no files\" and drops every Cache-Control header.\n //\n // `readdirSync(dir, { withFileTypes: true })` is ancient and stable, and\n // tracking the parent ourselves needs no new API.\n const walk = (absDir: string, prefix: string): void => {\n for (const entry of readdirSync(absDir, { withFileTypes: true })) {\n const child = `${prefix}/${entry.name}`\n // Symlinks report as neither file nor directory here (readdir does\n // not follow them), so a symlinked tree is skipped rather than\n // risking a cycle. A symlinked asset simply goes unlabelled — the\n // static layer still serves it, it just misses the cache header.\n if (entry.isDirectory()) walk(join(absDir, entry.name), child)\n else if (entry.isFile()) paths.add(child)\n }\n }\n try {\n walk(clientDir, '')\n } catch {\n // Unreadable build directory — fall back to labelling nothing rather\n // than failing the boot. Serving still works; caching just opts out.\n return new Set()\n }\n return paths\n }\n\n /**\n * How the static layer will answer this path: as the index document, as a\n * long-lived asset, or not at all.\n *\n * Membership of the snapshot IS the containment guard — a traversal like\n * `/../../etc/passwd` simply is not a key — so no prefix comparison is\n * needed and the whole check is one `Set.has`.\n */\n const classifyPath = (pathname: string): 'file' | 'index' | null => {\n let decoded: string\n try {\n decoded = decodeURIComponent(pathname)\n } catch {\n return null\n }\n if (decoded.includes('\\0')) return null\n\n // A directory is served from its `index.html`, so `/` — the single most\n // common request — is an index request, not an asset. Reporting it as\n // neither left the root document without the configured policy.\n const asIndex = decoded.endsWith('/') ? `${decoded}index.html` : null\n if (asIndex && assetPaths.has(asIndex)) return 'index'\n if (!assetPaths.has(decoded)) return null\n return decoded.endsWith('.html') ? 'index' : 'file'\n }\n\n /** Skipped by the fallback: API routes, opted-out paths. */\n const isReserved = (pathname: string): boolean =>\n apiPrefixes.some((p) => isUnder(pathname, p)) ||\n excludePaths.some((p) => isUnder(pathname, p))\n\n return {\n beforeMount({ http }) {\n if (!existsSync(clientDir)) {\n log.warn(`SPA client directory not found: ${clientDir}`)\n log.warn(\n `Build your frontend first, or set clientDir to the correct path ` +\n `(relative paths resolve from ${process.cwd()}).`,\n )\n return\n }\n\n const indexPath = join(clientDir, 'index.html')\n if (!existsSync(indexPath)) {\n log.warn(`index.html not found in ${clientDir}`)\n return\n }\n indexHtml = readFileSync(indexPath, 'utf-8')\n assetPaths = snapshotClientDir()\n\n // Cache-Control runs as its own middleware ahead of the static\n // handler: the engine-agnostic `serveStatic` takes no header hook,\n // and headers set before the static layer writes still land on the\n // response. Keyed off the request path rather than the resolved file,\n // which is the same decision `express.static`'s `setHeaders` made.\n if (cacheControl !== false) {\n http.use(((req, res, next) => {\n const pathname = pathnameOf(req.url)\n // Only label a response the static layer will actually serve.\n // `express.static`'s `setHeaders` fired on hits only; running as\n // a separate middleware loses that, and an unconditional header\n // put `immutable, max-age=31536000` on the 404 for a missing\n // asset — telling every cache to keep that miss for a year.\n const kind = isReserved(pathname) ? null : classifyPath(pathname)\n if (kind) {\n res.setHeader('Cache-Control', kind === 'index' ? indexCacheControl : cacheControl)\n }\n next()\n }) satisfies SpaHandler as unknown as ConnectMiddleware)\n }\n\n http.serveStatic('/', clientDir)\n log.debug(`Serving SPA from ${clientDir}`)\n },\n\n beforeStart({ http }) {\n if (!indexHtml) return\n\n http.use(((req, res, next) => {\n // GET and HEAD both navigate. HEAD used to fall through to a 404,\n // which broke proxies and link checkers probing SPA routes.\n const method = (req.method ?? 'GET').toUpperCase()\n if (method !== 'GET' && method !== 'HEAD') return next()\n\n const pathname = pathnameOf(req.url)\n if (isReserved(pathname)) return next()\n\n // Content negotiation instead of a \"does the path contain a dot\"\n // guess. The old heuristic 404'd every legitimate route carrying a\n // dot (`/users/john.doe`, `/v1.2/spec`) while still handing HTML to\n // genuinely missing assets whose path had no extension.\n const accept = req.headers?.['accept'] as string | string[] | undefined\n if (!alwaysFallback && !acceptsHtml(accept)) return next()\n\n const body = indexHtml as string\n res.setHeader('Content-Type', 'text/html; charset=utf-8')\n res.setHeader('Cache-Control', indexCacheControl)\n res.setHeader('Content-Length', String(Buffer.byteLength(body)))\n res.statusCode = 200\n // HEAD must carry identical headers and no body.\n res.end(method === 'HEAD' ? undefined : body)\n }) satisfies SpaHandler as unknown as ConnectMiddleware)\n },\n }\n },\n})\n"],"mappings":"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"}
@@ -1,4 +1,4 @@
1
1
 
2
- import { A as RawUploadPart, F as buildFileTypeFilter, I as resolveMimeTypes, M as UploadedFile, N as UploadedFileLike, P as applyUploadConfig, j as UploadStorageEngine } from "../../adapter-DL9JPcvC.mjs";
3
- import { i as upload, n as buildUploadMiddleware, r as cleanupFiles, t as UploadOptions } from "../../upload-DnwvZQyi.mjs";
2
+ import { A as RawUploadPart, F as buildFileTypeFilter, I as resolveMimeTypes, M as UploadedFile, N as UploadedFileLike, P as applyUploadConfig, j as UploadStorageEngine } from "../../adapter-B64IOivZ.mjs";
3
+ import { i as upload, n as buildUploadMiddleware, r as cleanupFiles, t as UploadOptions } from "../../upload-eNNueUxR.mjs";
4
4
  export { type RawUploadPart, UploadOptions, type UploadStorageEngine, type UploadedFile, type UploadedFileLike, applyUploadConfig, buildFileTypeFilter, buildUploadMiddleware, cleanupFiles, resolveMimeTypes, upload };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.14.1
2
+ * @forinda/kickjs v10.14.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{HttpException,HttpStatus}from"../../core/errors.mjs";import{f as tooLarge}from"../../body-policy-CwgUYBw7.mjs";import{a as normalizeOriginalName,c as tooManyFiles,i as buildFileTypeFilter,l as uploadLimits,n as UPLOAD_FIELDS_ALLOWANCE,o as resolveMimeTypes,r as applyUploadConfig,s as serverFileName,t as MAX_UPLOAD_FIELDS}from"../../upload-config-Bq3qcDel.mjs";import{unlink}from"node:fs/promises";import{Transform}from"node:stream";let _multer;function loadMulter(){return _multer??=import(`multer`).then(mod=>mod.default??mod,()=>{throw Error(`@forinda/kickjs: file uploads require the 'multer' package, which is not installed. Add it to your dependencies.`)})}function translateMulterErrors(mw,options,files){let maxSize=options.maxSize??5242880;return(req,res,next)=>{mw(req,res,err=>{if(files&&err?.code===`LIMIT_UNEXPECTED_FILE`&&err.field===files.field)return next(tooManyFiles(files.max));if(err&&err.code===`LIMIT_FILE_SIZE`){let name=err.field??`file`;return next(new HttpException(HttpStatus.PAYLOAD_TOO_LARGE,`File ${name} exceeds the ${maxSize}-byte limit`))}if(!err)try{nameUploads(req,options)}catch(error){return next(error)}next(err)})}}function nameUploads(req,options){let files=[req.file,...Array.isArray(req.files)?req.files:[]];for(let file of files)file&&(file.originalname=normalizeOriginalName(file.originalname),file.filename??=serverFileName(file,options))}function createMulter(options){let limits={fileSize:options.maxSize??5242880,fields:MAX_UPLOAD_FIELDS,fieldSize:UPLOAD_FIELDS_ALLOWANCE},fileFilter;if(options.allowedTypes){let typeAllowed=buildFileTypeFilter(options.allowedTypes,options.customMimeMap);fileFilter=(_req,file,cb)=>{typeAllowed(file.mimetype,file.originalname)?cb(null,!0):cb(new HttpException(HttpStatus.UNSUPPORTED_MEDIA_TYPE,`File type ${file.mimetype} is not allowed`))}}let multerOptions={limits,defParamCharset:`utf8`,...fileFilter?{fileFilter}:{},...options.storage?{storage:options.storage}:{},...options.dest?{dest:options.dest}:{}},built,lazy=pick=>{let handler;return(req,res,next)=>{handler??=(built??=loadMulter().then(multer=>multer(multerOptions))).then(pick),handler.then(run=>run(req,res,next),err=>{handler=built=_multer=void 0,next(err)})}};return{single:field=>lazy(m=>m.single(field)),array:(field,maxCount)=>lazy(m=>m.array(field,maxCount)),none:()=>lazy(m=>m.none())}}function bothConventions(handler){return((first,second,third)=>third===void 0&&typeof second==`function`&&typeof first==`object`&&first&&`req`in first&&`res`in first?new Promise((resolve,reject)=>{handler(first.req,first.res,err=>{if(err)return reject(err);resolve(),second()})}):handler(first,second,third))}function capBody(mw,limit){return(req,res,next)=>{if(Number(req.headers[`content-length`])>limit)return next(tooLarge(limit));if(typeof req.pipe!=`function`)return mw(req,res,next);let pipe=req.pipe.bind(req);req.pipe=(destination=>{let received=0,counter=new Transform({transform(chunk,_encoding,done){if(received+=chunk.length,received<=limit)return done(null,chunk);received-chunk.length<=limit&&destination.destroy(tooLarge(limit)),done()}});return pipe(counter),counter.pipe(destination)}),mw(req,res,next)}}function single(fieldName,options={}){let m=createMulter(options),{total}=uploadLimits({mode:`single`,maxSize:options.maxSize});return bothConventions(capBody(translateMulterErrors(m.single(fieldName),options,{field:fieldName,max:1}),total))}function array(fieldName,maxCount=10,options={}){let m=createMulter(options),{total}=uploadLimits({mode:`array`,maxSize:options.maxSize,maxCount});return bothConventions(capBody(translateMulterErrors(m.array(fieldName,maxCount),options,{field:fieldName,max:maxCount}),total))}function none(options={}){let m=createMulter(options),{total}=uploadLimits({mode:`none`});return bothConventions(capBody(translateMulterErrors(m.none(),options),total))}function cleanupFiles(){return(req,res,next)=>{res.on(`finish`,async()=>{let files=[];if(req.file?.path&&files.push(req.file),Array.isArray(req.files))for(let f of req.files)f?.path&&files.push(f);for(let file of files)try{await unlink(file.path)}catch{}}),next()}}function buildUploadMiddleware(config){let options={};config.maxSize&&(options.maxSize=config.maxSize),config.allowedTypes&&(options.allowedTypes=config.allowedTypes),config.customMimeMap&&(options.customMimeMap=config.customMimeMap),config.rename&&(options.rename=config.rename);let fieldName=config.fieldName??`file`;switch(config.mode){case`single`:return single(fieldName,options);case`array`:return array(fieldName,config.maxCount??10,options);case`none`:return none(options)}}const upload={single,array,none};export{applyUploadConfig,buildFileTypeFilter,buildUploadMiddleware,cleanupFiles,resolveMimeTypes,upload};
11
+ import{HttpException,HttpStatus}from"../../core/errors.mjs";import{a as normalizeOriginalName,c as tooManyFiles,i as buildFileTypeFilter,l as uploadLimits,n as UPLOAD_FIELDS_ALLOWANCE,o as resolveMimeTypes,r as applyUploadConfig,s as serverFileName,t as MAX_UPLOAD_FIELDS}from"../../upload-config-BXjBiNjC.mjs";import{f as tooLarge}from"../../body-policy-Be3Y0hjq.mjs";import{unlink}from"node:fs/promises";import{Transform}from"node:stream";let _multer;function loadMulter(){return _multer??=import(`multer`).then(mod=>mod.default??mod,()=>{throw Error(`@forinda/kickjs: file uploads require the 'multer' package, which is not installed. Add it to your dependencies.`)})}function translateMulterErrors(mw,options,files){let maxSize=options.maxSize??5242880;return(req,res,next)=>{mw(req,res,err=>{if(files&&err?.code===`LIMIT_UNEXPECTED_FILE`&&err.field===files.field)return next(tooManyFiles(files.max));if(err&&err.code===`LIMIT_FILE_SIZE`){let name=err.field??`file`;return next(new HttpException(HttpStatus.PAYLOAD_TOO_LARGE,`File ${name} exceeds the ${maxSize}-byte limit`))}if(!err)try{nameUploads(req,options)}catch(error){return next(error)}next(err)})}}function nameUploads(req,options){let files=[req.file,...Array.isArray(req.files)?req.files:[]];for(let file of files)file&&(file.originalname=normalizeOriginalName(file.originalname),file.filename??=serverFileName(file,options))}function createMulter(options){let limits={fileSize:options.maxSize??5242880,fields:MAX_UPLOAD_FIELDS,fieldSize:UPLOAD_FIELDS_ALLOWANCE},fileFilter;if(options.allowedTypes){let typeAllowed=buildFileTypeFilter(options.allowedTypes,options.customMimeMap);fileFilter=(_req,file,cb)=>{typeAllowed(file.mimetype,file.originalname)?cb(null,!0):cb(new HttpException(HttpStatus.UNSUPPORTED_MEDIA_TYPE,`File type ${file.mimetype} is not allowed`))}}let multerOptions={limits,defParamCharset:`utf8`,...fileFilter?{fileFilter}:{},...options.storage?{storage:options.storage}:{},...options.dest?{dest:options.dest}:{}},built,lazy=pick=>{let handler;return(req,res,next)=>{handler??=(built??=loadMulter().then(multer=>multer(multerOptions))).then(pick),handler.then(run=>run(req,res,next),err=>{handler=built=_multer=void 0,next(err)})}};return{single:field=>lazy(m=>m.single(field)),array:(field,maxCount)=>lazy(m=>m.array(field,maxCount)),none:()=>lazy(m=>m.none())}}function bothConventions(handler){return((first,second,third)=>third===void 0&&typeof second==`function`&&typeof first==`object`&&first&&`req`in first&&`res`in first?new Promise((resolve,reject)=>{handler(first.req,first.res,err=>{if(err)return reject(err);resolve(),second()})}):handler(first,second,third))}function capBody(mw,limit){return(req,res,next)=>{if(Number(req.headers[`content-length`])>limit)return next(tooLarge(limit));if(typeof req.pipe!=`function`)return mw(req,res,next);let pipe=req.pipe.bind(req);req.pipe=(destination=>{let received=0,counter=new Transform({transform(chunk,_encoding,done){if(received+=chunk.length,received<=limit)return done(null,chunk);received-chunk.length<=limit&&destination.destroy(tooLarge(limit)),done()}});return pipe(counter),counter.pipe(destination)}),mw(req,res,next)}}function single(fieldName,options={}){let m=createMulter(options),{total}=uploadLimits({mode:`single`,maxSize:options.maxSize});return bothConventions(capBody(translateMulterErrors(m.single(fieldName),options,{field:fieldName,max:1}),total))}function array(fieldName,maxCount=10,options={}){let m=createMulter(options),{total}=uploadLimits({mode:`array`,maxSize:options.maxSize,maxCount});return bothConventions(capBody(translateMulterErrors(m.array(fieldName,maxCount),options,{field:fieldName,max:maxCount}),total))}function none(options={}){let m=createMulter(options),{total}=uploadLimits({mode:`none`});return bothConventions(capBody(translateMulterErrors(m.none(),options),total))}function cleanupFiles(){return(req,res,next)=>{res.on(`finish`,async()=>{let files=[];if(req.file?.path&&files.push(req.file),Array.isArray(req.files))for(let f of req.files)f?.path&&files.push(f);for(let file of files)try{await unlink(file.path)}catch{}}),next()}}function buildUploadMiddleware(config){let options={};config.maxSize&&(options.maxSize=config.maxSize),config.allowedTypes&&(options.allowedTypes=config.allowedTypes),config.customMimeMap&&(options.customMimeMap=config.customMimeMap),config.rename&&(options.rename=config.rename);let fieldName=config.fieldName??`file`;switch(config.mode){case`single`:return single(fieldName,options);case`array`:return array(fieldName,config.maxCount??10,options);case`none`:return none(options)}}const upload={single,array,none};export{applyUploadConfig,buildFileTypeFilter,buildUploadMiddleware,cleanupFiles,resolveMimeTypes,upload};
12
12
  //# sourceMappingURL=upload.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"upload.mjs","names":[],"sources":["../../../src/http/middleware/upload.ts"],"sourcesContent":["import { HttpException, HttpStatus } from '../../core/errors'\nimport { unlink } from 'node:fs/promises'\nimport type {\n ConnectRequest as Request,\n ConnectResponse as Response,\n ConnectNext as NextFunction,\n ConnectHandler as RequestHandler,\n} from '../connect'\nimport type { Options as MulterOptions } from 'multer'\nimport type { BaseUploadOptions, FileUploadConfig } from '../../core'\n\n// `multer` is an optional peer dependency, imported when the first upload\n// arrives — adopters who never take uploads don't need it installed. An\n// `import()`, not `createRequire`: a bundler follows it, so a Netlify or\n// Vercel function built by `kick build:*` carries multer with it.\ntype MulterFactory = typeof import('multer')\ntype Multer = ReturnType<MulterFactory>\nlet _multer: Promise<MulterFactory> | undefined\n\nfunction loadMulter(): Promise<MulterFactory> {\n return (_multer ??= import('multer').then(\n // multer is CJS `export = multer`: the factory is the module's default.\n (mod) => ((mod as { default?: unknown }).default ?? mod) as MulterFactory,\n () => {\n throw new Error(\n \"@forinda/kickjs: file uploads require the 'multer' package, which is not installed. \" +\n 'Add it to your dependencies.',\n )\n },\n ))\n}\n\n// Pure upload core (MIME map, type filter, applyUploadConfig) moved to\n// `./upload-config` so the edge-safe web entry can use it without this\n// module's node-only surface. Re-exported here for compatibility.\nexport {\n buildFileTypeFilter,\n resolveMimeTypes,\n applyUploadConfig,\n type UploadedFileLike,\n type UploadedFile,\n type UploadStorageEngine,\n type RawUploadPart,\n} from './upload-config'\nimport { Transform, type Writable } from 'node:stream'\nimport { tooLarge } from '../body-policy'\nimport {\n MAX_UPLOAD_FIELDS,\n UPLOAD_FIELDS_ALLOWANCE,\n buildFileTypeFilter,\n normalizeOriginalName,\n serverFileName,\n tooManyFiles,\n uploadLimits,\n type UploadedFile,\n type UploadStorageEngine,\n} from './upload-config'\n\n/**\n * Upload options for the middleware.\n * Extends BaseUploadOptions from core (shared with @FileUpload decorator)\n * and adds Multer-specific storage options.\n */\nexport interface UploadOptions extends BaseUploadOptions {\n /** Multer storage engine (default: memory storage) */\n storage?: UploadStorageEngine\n /** Multer dest for disk storage shorthand */\n dest?: string\n}\n\n/**\n * Turn multer's own errors into the exceptions the other runtimes raise.\n *\n * multer reports a file over the limit as `MulterError: File too large`, a\n * plain error the handler maps to 500 — so an oversized upload was reported as\n * a server fault on Express while Fastify and h3 answered 413. The message is\n * matched to `applyUploadConfig` so the response does not depend on the engine.\n */\nfunction translateMulterErrors(\n mw: RequestHandler,\n options: UploadOptions,\n files?: { field: string; max: number },\n): RequestHandler {\n const maxSize = options.maxSize ?? 5 * 1024 * 1024\n return (req, res, next) => {\n mw(req, res, (err?: unknown) => {\n // multer reports one file more than the field takes as an unexpected one.\n if (\n files &&\n (err as { code?: string } | undefined)?.code === 'LIMIT_UNEXPECTED_FILE' &&\n (err as { field?: string }).field === files.field\n ) {\n return next(tooManyFiles(files.max))\n }\n if (err && (err as { code?: string }).code === 'LIMIT_FILE_SIZE') {\n const name = (err as { field?: string }).field ?? 'file'\n return next(\n new HttpException(\n HttpStatus.PAYLOAD_TOO_LARGE,\n `File ${name} exceeds the ${maxSize}-byte limit`,\n ),\n )\n }\n if (!err) {\n try {\n nameUploads(req as { file?: unknown; files?: unknown }, options)\n } catch (error) {\n return next(error as never)\n }\n }\n next(err as never)\n })\n }\n}\n\n/**\n * The names every engine gives an upload: the client's name normalized, and a\n * server-side `filename` — kept when disk storage already wrote the file under one.\n */\nfunction nameUploads(req: { file?: unknown; files?: unknown }, options: UploadOptions) {\n const files = [req.file, ...(Array.isArray(req.files) ? req.files : [])]\n for (const file of files as Array<UploadedFile | undefined>) {\n if (!file) continue\n file.originalname = normalizeOriginalName(file.originalname)\n file.filename ??= serverFileName(file, options)\n }\n}\n\nfunction createMulter(options: UploadOptions) {\n const limits: MulterOptions['limits'] = {\n fileSize: options.maxSize ?? 5 * 1024 * 1024,\n fields: MAX_UPLOAD_FIELDS,\n fieldSize: UPLOAD_FIELDS_ALLOWANCE,\n }\n\n let fileFilter: MulterOptions['fileFilter'] | undefined\n if (options.allowedTypes) {\n const typeAllowed = buildFileTypeFilter(options.allowedTypes, options.customMimeMap)\n fileFilter = (_req, file, cb) => {\n if (typeAllowed(file.mimetype, file.originalname)) {\n cb(null, true)\n } else {\n // Same exception the Fastify and h3 path raises from\n // `applyUploadConfig`. A plain Error here reached the handler as a 500,\n // so Express blamed itself for the client's file — and leaked a multer\n // stack doing it.\n cb(\n new HttpException(\n HttpStatus.UNSUPPORTED_MEDIA_TYPE,\n `File type ${file.mimetype} is not allowed`,\n ),\n )\n }\n }\n }\n\n const multerOptions: MulterOptions = {\n limits,\n // busboy reads a part's filename as latin1 unless told otherwise, so a\n // UTF-8 name — 中文, an emoji — arrived as mojibake (\"中æ\").\n defParamCharset: 'utf8',\n ...(fileFilter ? { fileFilter } : {}),\n ...(options.storage ? { storage: options.storage } : {}),\n ...(options.dest ? { dest: options.dest } : {}),\n }\n\n // Built on the first request that needs it, then reused.\n let built: Promise<Multer> | undefined\n const lazy = (pick: (multer: Multer) => RequestHandler): RequestHandler => {\n let handler: Promise<RequestHandler> | undefined\n return (req, res, next) => {\n handler ??= (built ??= loadMulter().then((multer) => multer(multerOptions))).then(pick)\n handler.then(\n (run) => run(req, res, next),\n (err) => {\n // Not cached: multer installed while `kick dev` runs works on the next upload.\n handler = built = _multer = undefined\n next(err)\n },\n )\n }\n }\n return {\n single: (field: string) => lazy((m) => m.single(field) as RequestHandler),\n array: (field: string, maxCount: number) =>\n lazy((m) => m.array(field, maxCount) as RequestHandler),\n none: () => lazy((m) => m.none() as RequestHandler),\n }\n}\n\n/**\n * Single file upload middleware. Attaches the file to `req.file`.\n *\n * @example\n * ```ts\n * @Post('/avatar')\n * @Middleware(upload.single('avatar', { maxSize: 2 * 1024 * 1024, allowedTypes: ['jpg', 'png'] }))\n * async uploadAvatar(ctx: RequestContext) {\n * ctx.json({ filename: ctx.file.originalname })\n * }\n * ```\n */\n/**\n * The handler, callable both ways it gets used: as Express middleware\n * `(req, res, next)` — `middlewares: [upload.single(...)]`, and what\n * `@FileUpload` builds — and as a route middleware `(ctx, next)`, which is\n * how `@Middleware(upload.single(...))` calls it. Called the second way,\n * Multer got the context as its request and failed on every upload.\n */\nfunction bothConventions(handler: RequestHandler): RequestHandler {\n return ((first: any, second: any, third?: any) => {\n const isRouteMiddleware =\n third === undefined &&\n typeof second === 'function' &&\n first !== null &&\n typeof first === 'object' &&\n 'req' in first &&\n 'res' in first\n if (!isRouteMiddleware) return handler(first, second, third)\n return new Promise<void>((resolve, reject) => {\n handler(first.req, first.res, (err?: unknown) => {\n if (err) return reject(err)\n resolve()\n second()\n })\n })\n }) as RequestHandler\n}\n\n/**\n * Hold a multipart body to `limit` bytes while multer reads it: by\n * Content-Length up front, and counted as it streams for a body that doesn't\n * declare one. multer has a per-file and per-field size but no total, so\n * without this a request could carry any number of fields.\n */\nfunction capBody(mw: RequestHandler, limit: number): RequestHandler {\n return (req, res, next) => {\n if (Number(req.headers['content-length']) > limit) return next(tooLarge(limit))\n if (typeof req.pipe !== 'function') return mw(req, res, next)\n const pipe = req.pipe.bind(req)\n // multer reads the request with `req.pipe(busboy)`; count what passes.\n req.pipe = (<T extends NodeJS.WritableStream>(destination: T): T => {\n let received = 0\n const counter = new Transform({\n transform(chunk: Buffer, _encoding, done) {\n received += chunk.length\n if (received <= limit) return done(null, chunk)\n // busboy's error reaches multer, which hands it to `next`.\n if (received - chunk.length <= limit) {\n ;(destination as unknown as Writable).destroy(tooLarge(limit))\n }\n done()\n },\n })\n pipe(counter)\n return counter.pipe(destination)\n }) as typeof req.pipe\n mw(req, res, next)\n }\n}\n\nfunction single(fieldName: string, options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n const { total } = uploadLimits({ mode: 'single', maxSize: options.maxSize })\n return bothConventions(\n capBody(\n translateMulterErrors(m.single(fieldName), options, { field: fieldName, max: 1 }),\n total,\n ),\n )\n}\n\n/**\n * Multiple file upload middleware. Attaches files to `req.files`.\n */\nfunction array(fieldName: string, maxCount = 10, options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n const { total } = uploadLimits({ mode: 'array', maxSize: options.maxSize, maxCount })\n return bothConventions(\n capBody(\n translateMulterErrors(m.array(fieldName, maxCount), options, {\n field: fieldName,\n max: maxCount,\n }),\n total,\n ),\n )\n}\n\n/**\n * No file upload — just parse multipart form data without file fields.\n */\nfunction none(options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n const { total } = uploadLimits({ mode: 'none' })\n return bothConventions(capBody(translateMulterErrors(m.none(), options), total))\n}\n\n/**\n * Removes temporary files from disk after the response is sent.\n * Attach this as Express middleware after the upload middleware.\n * Works with both `req.file` (single) and `req.files` (array).\n *\n * @example\n * ```ts\n * @Post('/process')\n * @Middleware(upload.single('document', { dest: '/tmp/uploads' }), cleanupFiles())\n * async processDocument(ctx: RequestContext) {\n * ctx.json({ ok: true })\n * }\n * ```\n */\nexport function cleanupFiles() {\n return (req: Request, res: Response, next: NextFunction) => {\n res.on('finish', async () => {\n const files: any[] = []\n\n if ((req as any).file?.path) {\n files.push((req as any).file)\n }\n if (Array.isArray((req as any).files)) {\n for (const f of (req as any).files) {\n if (f?.path) files.push(f)\n }\n }\n\n for (const file of files) {\n try {\n await unlink(file.path)\n } catch {\n // File may already be moved/deleted by the handler — ignore\n }\n }\n })\n\n next()\n }\n}\n\n/**\n * Build upload middleware from a @FileUpload decorator config.\n * Used internally by the router builder when it detects FILE_UPLOAD metadata.\n * Accepts the same FileUploadConfig interface used by the @FileUpload decorator.\n */\nexport function buildUploadMiddleware(config: FileUploadConfig): RequestHandler {\n const options: UploadOptions = {}\n if (config.maxSize) options.maxSize = config.maxSize\n if (config.allowedTypes) options.allowedTypes = config.allowedTypes\n if (config.customMimeMap) options.customMimeMap = config.customMimeMap\n if (config.rename) options.rename = config.rename\n\n const fieldName = config.fieldName ?? 'file'\n\n switch (config.mode) {\n case 'single':\n return single(fieldName, options)\n case 'array':\n return array(fieldName, config.maxCount ?? 10, options)\n case 'none':\n return none(options)\n }\n}\n\n/** Upload middleware factory with `.single()`, `.array()`, `.none()` methods */\nexport const upload = { single, array, none }\n"],"mappings":"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"}
1
+ {"version":3,"file":"upload.mjs","names":[],"sources":["../../../src/http/middleware/upload.ts"],"sourcesContent":["import { HttpException, HttpStatus } from '../../core/errors'\nimport { unlink } from 'node:fs/promises'\nimport type {\n ConnectRequest as Request,\n ConnectResponse as Response,\n ConnectNext as NextFunction,\n ConnectHandler as RequestHandler,\n} from '../connect'\nimport type { Options as MulterOptions } from 'multer'\nimport type { BaseUploadOptions, FileUploadConfig } from '../../core'\n\n// `multer` is an optional peer dependency, imported when the first upload\n// arrives — adopters who never take uploads don't need it installed. An\n// `import()`, not `createRequire`: a bundler follows it, so a Netlify or\n// Vercel function built by `kick build:*` carries multer with it.\ntype MulterFactory = typeof import('multer')\ntype Multer = ReturnType<MulterFactory>\nlet _multer: Promise<MulterFactory> | undefined\n\nfunction loadMulter(): Promise<MulterFactory> {\n return (_multer ??= import('multer').then(\n // multer is CJS `export = multer`: the factory is the module's default.\n (mod) => ((mod as { default?: unknown }).default ?? mod) as MulterFactory,\n () => {\n throw new Error(\n \"@forinda/kickjs: file uploads require the 'multer' package, which is not installed. \" +\n 'Add it to your dependencies.',\n )\n },\n ))\n}\n\n// Pure upload core (MIME map, type filter, applyUploadConfig) moved to\n// `./upload-config` so the edge-safe web entry can use it without this\n// module's node-only surface. Re-exported here for compatibility.\nexport {\n buildFileTypeFilter,\n resolveMimeTypes,\n applyUploadConfig,\n type UploadedFileLike,\n type UploadedFile,\n type UploadStorageEngine,\n type RawUploadPart,\n} from './upload-config'\nimport { Transform, type Writable } from 'node:stream'\nimport { tooLarge } from '../body-policy'\nimport {\n MAX_UPLOAD_FIELDS,\n UPLOAD_FIELDS_ALLOWANCE,\n buildFileTypeFilter,\n normalizeOriginalName,\n serverFileName,\n tooManyFiles,\n uploadLimits,\n type UploadedFile,\n type UploadStorageEngine,\n} from './upload-config'\n\n/**\n * Upload options for the middleware.\n * Extends BaseUploadOptions from core (shared with @FileUpload decorator)\n * and adds Multer-specific storage options.\n */\nexport interface UploadOptions extends BaseUploadOptions {\n /** Multer storage engine (default: memory storage) */\n storage?: UploadStorageEngine\n /** Multer dest for disk storage shorthand */\n dest?: string\n}\n\n/**\n * Turn multer's own errors into the exceptions the other runtimes raise.\n *\n * multer reports a file over the limit as `MulterError: File too large`, a\n * plain error the handler maps to 500 — so an oversized upload was reported as\n * a server fault on Express while Fastify and h3 answered 413. The message is\n * matched to `applyUploadConfig` so the response does not depend on the engine.\n */\nfunction translateMulterErrors(\n mw: RequestHandler,\n options: UploadOptions,\n files?: { field: string; max: number },\n): RequestHandler {\n const maxSize = options.maxSize ?? 5 * 1024 * 1024\n return (req, res, next) => {\n mw(req, res, (err?: unknown) => {\n // multer reports one file more than the field takes as an unexpected one.\n if (\n files &&\n (err as { code?: string } | undefined)?.code === 'LIMIT_UNEXPECTED_FILE' &&\n (err as { field?: string }).field === files.field\n ) {\n return next(tooManyFiles(files.max))\n }\n if (err && (err as { code?: string }).code === 'LIMIT_FILE_SIZE') {\n const name = (err as { field?: string }).field ?? 'file'\n return next(\n new HttpException(\n HttpStatus.PAYLOAD_TOO_LARGE,\n `File ${name} exceeds the ${maxSize}-byte limit`,\n ),\n )\n }\n if (!err) {\n try {\n nameUploads(req as { file?: unknown; files?: unknown }, options)\n } catch (error) {\n return next(error as never)\n }\n }\n next(err as never)\n })\n }\n}\n\n/**\n * The names every engine gives an upload: the client's name normalized, and a\n * server-side `filename` — kept when disk storage already wrote the file under one.\n */\nfunction nameUploads(req: { file?: unknown; files?: unknown }, options: UploadOptions) {\n const files = [req.file, ...(Array.isArray(req.files) ? req.files : [])]\n for (const file of files as Array<UploadedFile | undefined>) {\n if (!file) continue\n file.originalname = normalizeOriginalName(file.originalname)\n file.filename ??= serverFileName(file, options)\n }\n}\n\nfunction createMulter(options: UploadOptions) {\n const limits: MulterOptions['limits'] = {\n fileSize: options.maxSize ?? 5 * 1024 * 1024,\n fields: MAX_UPLOAD_FIELDS,\n fieldSize: UPLOAD_FIELDS_ALLOWANCE,\n }\n\n let fileFilter: MulterOptions['fileFilter'] | undefined\n if (options.allowedTypes) {\n const typeAllowed = buildFileTypeFilter(options.allowedTypes, options.customMimeMap)\n fileFilter = (_req, file, cb) => {\n if (typeAllowed(file.mimetype, file.originalname)) {\n cb(null, true)\n } else {\n // Same exception the Fastify and h3 path raises from\n // `applyUploadConfig`. A plain Error here reached the handler as a 500,\n // so Express blamed itself for the client's file — and leaked a multer\n // stack doing it.\n cb(\n new HttpException(\n HttpStatus.UNSUPPORTED_MEDIA_TYPE,\n `File type ${file.mimetype} is not allowed`,\n ),\n )\n }\n }\n }\n\n const multerOptions: MulterOptions = {\n limits,\n // busboy reads a part's filename as latin1 unless told otherwise, so a\n // UTF-8 name — 中文, an emoji — arrived as mojibake (\"中æ\").\n defParamCharset: 'utf8',\n ...(fileFilter ? { fileFilter } : {}),\n ...(options.storage ? { storage: options.storage } : {}),\n ...(options.dest ? { dest: options.dest } : {}),\n }\n\n // Built on the first request that needs it, then reused.\n let built: Promise<Multer> | undefined\n const lazy = (pick: (multer: Multer) => RequestHandler): RequestHandler => {\n let handler: Promise<RequestHandler> | undefined\n return (req, res, next) => {\n handler ??= (built ??= loadMulter().then((multer) => multer(multerOptions))).then(pick)\n handler.then(\n (run) => run(req, res, next),\n (err) => {\n // Not cached: multer installed while `kick dev` runs works on the next upload.\n handler = built = _multer = undefined\n next(err)\n },\n )\n }\n }\n return {\n single: (field: string) => lazy((m) => m.single(field) as RequestHandler),\n array: (field: string, maxCount: number) =>\n lazy((m) => m.array(field, maxCount) as RequestHandler),\n none: () => lazy((m) => m.none() as RequestHandler),\n }\n}\n\n/**\n * Single file upload middleware. Attaches the file to `req.file`.\n *\n * @example\n * ```ts\n * @Post('/avatar')\n * @Middleware(upload.single('avatar', { maxSize: 2 * 1024 * 1024, allowedTypes: ['jpg', 'png'] }))\n * async uploadAvatar(ctx: RequestContext) {\n * ctx.json({ filename: ctx.file.originalname })\n * }\n * ```\n */\n/**\n * The handler, callable both ways it gets used: as Express middleware\n * `(req, res, next)` — `middlewares: [upload.single(...)]`, and what\n * `@FileUpload` builds — and as a route middleware `(ctx, next)`, which is\n * how `@Middleware(upload.single(...))` calls it. Called the second way,\n * Multer got the context as its request and failed on every upload.\n */\nfunction bothConventions(handler: RequestHandler): RequestHandler {\n return ((first: any, second: any, third?: any) => {\n const isRouteMiddleware =\n third === undefined &&\n typeof second === 'function' &&\n first !== null &&\n typeof first === 'object' &&\n 'req' in first &&\n 'res' in first\n if (!isRouteMiddleware) return handler(first, second, third)\n return new Promise<void>((resolve, reject) => {\n handler(first.req, first.res, (err?: unknown) => {\n if (err) return reject(err)\n resolve()\n second()\n })\n })\n }) as RequestHandler\n}\n\n/**\n * Hold a multipart body to `limit` bytes while multer reads it: by\n * Content-Length up front, and counted as it streams for a body that doesn't\n * declare one. multer has a per-file and per-field size but no total, so\n * without this a request could carry any number of fields.\n */\nfunction capBody(mw: RequestHandler, limit: number): RequestHandler {\n return (req, res, next) => {\n if (Number(req.headers['content-length']) > limit) return next(tooLarge(limit))\n if (typeof req.pipe !== 'function') return mw(req, res, next)\n const pipe = req.pipe.bind(req)\n // multer reads the request with `req.pipe(busboy)`; count what passes.\n req.pipe = (<T extends NodeJS.WritableStream>(destination: T): T => {\n let received = 0\n const counter = new Transform({\n transform(chunk: Buffer, _encoding, done) {\n received += chunk.length\n if (received <= limit) return done(null, chunk)\n // busboy's error reaches multer, which hands it to `next`.\n if (received - chunk.length <= limit) {\n ;(destination as unknown as Writable).destroy(tooLarge(limit))\n }\n done()\n },\n })\n pipe(counter)\n return counter.pipe(destination)\n }) as typeof req.pipe\n mw(req, res, next)\n }\n}\n\nfunction single(fieldName: string, options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n const { total } = uploadLimits({ mode: 'single', maxSize: options.maxSize })\n return bothConventions(\n capBody(\n translateMulterErrors(m.single(fieldName), options, { field: fieldName, max: 1 }),\n total,\n ),\n )\n}\n\n/**\n * Multiple file upload middleware. Attaches files to `req.files`.\n */\nfunction array(fieldName: string, maxCount = 10, options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n const { total } = uploadLimits({ mode: 'array', maxSize: options.maxSize, maxCount })\n return bothConventions(\n capBody(\n translateMulterErrors(m.array(fieldName, maxCount), options, {\n field: fieldName,\n max: maxCount,\n }),\n total,\n ),\n )\n}\n\n/**\n * No file upload — just parse multipart form data without file fields.\n */\nfunction none(options: UploadOptions = {}): RequestHandler {\n const m = createMulter(options)\n const { total } = uploadLimits({ mode: 'none' })\n return bothConventions(capBody(translateMulterErrors(m.none(), options), total))\n}\n\n/**\n * Removes temporary files from disk after the response is sent.\n * Attach this as Express middleware after the upload middleware.\n * Works with both `req.file` (single) and `req.files` (array).\n *\n * @example\n * ```ts\n * @Post('/process')\n * @Middleware(upload.single('document', { dest: '/tmp/uploads' }), cleanupFiles())\n * async processDocument(ctx: RequestContext) {\n * ctx.json({ ok: true })\n * }\n * ```\n */\nexport function cleanupFiles() {\n return (req: Request, res: Response, next: NextFunction) => {\n res.on('finish', async () => {\n const files: any[] = []\n\n if ((req as any).file?.path) {\n files.push((req as any).file)\n }\n if (Array.isArray((req as any).files)) {\n for (const f of (req as any).files) {\n if (f?.path) files.push(f)\n }\n }\n\n for (const file of files) {\n try {\n await unlink(file.path)\n } catch {\n // File may already be moved/deleted by the handler — ignore\n }\n }\n })\n\n next()\n }\n}\n\n/**\n * Build upload middleware from a @FileUpload decorator config.\n * Used internally by the router builder when it detects FILE_UPLOAD metadata.\n * Accepts the same FileUploadConfig interface used by the @FileUpload decorator.\n */\nexport function buildUploadMiddleware(config: FileUploadConfig): RequestHandler {\n const options: UploadOptions = {}\n if (config.maxSize) options.maxSize = config.maxSize\n if (config.allowedTypes) options.allowedTypes = config.allowedTypes\n if (config.customMimeMap) options.customMimeMap = config.customMimeMap\n if (config.rename) options.rename = config.rename\n\n const fieldName = config.fieldName ?? 'file'\n\n switch (config.mode) {\n case 'single':\n return single(fieldName, options)\n case 'array':\n return array(fieldName, config.maxCount ?? 10, options)\n case 'none':\n return none(options)\n }\n}\n\n/** Upload middleware factory with `.single()`, `.array()`, `.none()` methods */\nexport const upload = { single, array, none }\n"],"mappings":"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"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { a as validate, i as defaultValidationError, n as ValidationFailure, r as ValidationSchema, t as ValidationErrorFactory } from "../../validate-D4Poe2EE.mjs";
2
+ import { a as validate, i as defaultValidationError, n as ValidationFailure, r as ValidationSchema, t as ValidationErrorFactory } from "../../validate-BbthfLBb.mjs";
3
3
  export { ValidationErrorFactory, ValidationFailure, ValidationSchema, defaultValidationError, validate };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.14.1
2
+ * @forinda/kickjs v10.14.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1 +1 @@
1
- {"version":3,"file":"validate.mjs","names":[],"sources":["../../../src/http/middleware/validate.ts"],"sourcesContent":["import type {\n ConnectRequest as Request,\n ConnectResponse as Response,\n ConnectNext as NextFunction,\n} from '../connect'\n// core/errors directly (not the barrel) — keeps the edge-safe web entry\n// graph free of the barrel's eager node:fs asset-manager import.\nimport { HttpException, HttpStatus } from '../../core/errors'\nimport { detectSchema, type KickSchema, type SchemaIssue } from '@forinda/kickjs-schema'\n\nexport interface ValidationSchema {\n body?: any\n query?: any\n params?: any\n}\n\n/** A request that failed route validation — what a `validationError` hook receives. */\nexport interface ValidationFailure {\n /** The part of the request that failed. */\n source: 'body' | 'query' | 'params'\n /** Every issue the schema reported, adapter-neutral (Zod, Valibot, Yup, …). */\n issues: SchemaIssue[]\n /** The request, as the runtime hands it to middleware. */\n req: unknown\n}\n\n/**\n * Turns a validation failure into the error the request fails with. Return\n * (or throw) any error — an `HttpException` or `ProblemException` keeps the\n * error handler's problem-details response — or return `undefined` to use\n * {@link defaultValidationError} for this one.\n */\nexport type ValidationErrorFactory = (failure: ValidationFailure) => unknown\n\n/**\n * The built-in failure: 422 with `details` as `[{ field, message }]`. A body\n * failure leads with its first issue's message. `@forinda/kickjs-inertia`\n * reads these `details` for the page's `errors`, so a custom factory serving\n * Inertia pages should keep the shape — or call this and adjust the result.\n */\nexport function defaultValidationError({ source, issues }: ValidationFailure): HttpException {\n const details = issues.map((i) => ({\n field: i.path.join('.') || '',\n message: i.message,\n }))\n const message =\n source === 'body'\n ? (issues[0]?.message ?? 'Validation failed')\n : source === 'query'\n ? 'Invalid query parameters'\n : 'Invalid path parameters'\n return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY, message, details)\n}\n\nfunction validationError(\n factory: ValidationErrorFactory | undefined,\n failure: ValidationFailure,\n): unknown {\n if (!factory) return defaultValidationError(failure)\n try {\n return factory(failure) ?? defaultValidationError(failure)\n } catch (thrown) {\n return thrown\n }\n}\n\n/**\n * Express 5 installs `req.query` as a getter-only property (so pluggable\n * `query parser` functions can run lazily). Direct assignment throws in\n * strict mode: `Cannot set property query of #<IncomingMessage> which\n * has only a getter`. `Object.defineProperty` replaces the getter with\n * a plain value slot and sidesteps the throw. Used for `query` and\n * defensively for `params` too — Express 5 currently leaves `params`\n * writable, but swapping the descriptor costs the same and future-proofs\n * against upstream changes.\n */\nfunction assignReqProperty(req: Request, key: 'query' | 'params', value: unknown): void {\n Object.defineProperty(req, key, {\n value,\n writable: true,\n configurable: true,\n enumerable: true,\n })\n}\n\n/**\n * Express middleware that validates request body/query/params against schemas.\n *\n * Accepts any schema supported by `@forinda/kickjs-schema`:\n * - Zod schemas (auto-detected)\n * - Standard Schema v1 objects\n * - KickSchema instances (from adapters like fromZod, fromValibot, etc.)\n * - Plain validator functions\n *\n * Validation failures are forwarded via `next(err)` as an `HttpException`, so\n * they flow through the application's global error handler (`onError`) and\n * produce a uniform response envelope.\n */\nexport function validate(\n schema: ValidationSchema,\n options: {\n /** What a failure throws — see `bootstrap({ validationError })`. Default: a 422. */\n validationError?: ValidationErrorFactory\n } = {},\n) {\n const factory = options.validationError\n // Detected on the first request, not per request: detection walks every\n // registered adapter and allocates a wrapper. Not at construction either —\n // a custom adapter registered during boot must still be seen.\n let wrapped: { body?: KickSchema; query?: KickSchema; params?: KickSchema } | undefined\n const schemas = () =>\n (wrapped ??= {\n body: schema.body ? detectSchema(schema.body) : undefined,\n query: schema.query ? detectSchema(schema.query) : undefined,\n params: schema.params ? detectSchema(schema.params) : undefined,\n })\n\n return (req: Request, _res: Response, next: NextFunction) => {\n try {\n const { body, query, params } = schemas()\n if (body) {\n const result = body.safeParse(req.body)\n if (!result.success) {\n return next(validationError(factory, { source: 'body', issues: result.issues, req }))\n }\n req.body = result.data\n }\n\n if (query) {\n const result = query.safeParse(req.query)\n if (!result.success) {\n return next(validationError(factory, { source: 'query', issues: result.issues, req }))\n }\n assignReqProperty(req, 'query', result.data)\n }\n\n if (params) {\n const result = params.safeParse(req.params)\n if (!result.success) {\n return next(validationError(factory, { source: 'params', issues: result.issues, req }))\n }\n assignReqProperty(req, 'params', result.data)\n }\n\n next()\n } catch (err) {\n next(err)\n }\n }\n}\n"],"mappings":";;;;;;;;;;6GAwCA,SAAgB,uBAAuB,CAAE,OAAQ,QAA4C,CAC3F,IAAM,QAAU,OAAO,IAAK,IAAO,CACjC,MAAO,EAAE,KAAK,KAAK,GAAG,GAAK,GAC3B,QAAS,EAAE,OACb,EAAE,EACI,QACJ,SAAW,OACN,OAAO,EAAE,EAAE,SAAW,oBACvB,SAAW,QACT,2BACA,0BACR,OAAO,IAAI,cAAc,WAAW,qBAAsB,QAAS,OAAO,CAC5E,CAEA,SAAS,gBACP,QACA,QACS,CACT,GAAI,CAAC,QAAS,OAAO,uBAAuB,OAAO,EACnD,GAAI,CACF,OAAO,QAAQ,OAAO,GAAK,uBAAuB,OAAO,CAC3D,OAAS,OAAQ,CACf,OAAO,MACT,CACF,CAYA,SAAS,kBAAkB,IAAc,IAAyB,MAAsB,CACtF,OAAO,eAAe,IAAK,IAAK,CAC9B,MACA,SAAU,GACV,aAAc,GACd,WAAY,EACd,CAAC,CACH,CAeA,SAAgB,SACd,OACA,QAGI,CAAC,EACL,CACA,IAAM,QAAU,QAAQ,gBAIpB,QACE,YACH,UAAY,CACX,KAAM,OAAO,KAAO,aAAa,OAAO,IAAI,EAAI,IAAA,GAChD,MAAO,OAAO,MAAQ,aAAa,OAAO,KAAK,EAAI,IAAA,GACnD,OAAQ,OAAO,OAAS,aAAa,OAAO,MAAM,EAAI,IAAA,EACxD,EAEF,OAAQ,IAAc,KAAgB,OAAuB,CAC3D,GAAI,CACF,GAAM,CAAE,KAAM,MAAO,QAAW,QAAQ,EACxC,GAAI,KAAM,CACR,IAAM,OAAS,KAAK,UAAU,IAAI,IAAI,EACtC,GAAI,CAAC,OAAO,QACV,OAAO,KAAK,gBAAgB,QAAS,CAAE,OAAQ,OAAQ,OAAQ,OAAO,OAAQ,GAAI,CAAC,CAAC,EAEtF,IAAI,KAAO,OAAO,IACpB,CAEA,GAAI,MAAO,CACT,IAAM,OAAS,MAAM,UAAU,IAAI,KAAK,EACxC,GAAI,CAAC,OAAO,QACV,OAAO,KAAK,gBAAgB,QAAS,CAAE,OAAQ,QAAS,OAAQ,OAAO,OAAQ,GAAI,CAAC,CAAC,EAEvF,kBAAkB,IAAK,QAAS,OAAO,IAAI,CAC7C,CAEA,GAAI,OAAQ,CACV,IAAM,OAAS,OAAO,UAAU,IAAI,MAAM,EAC1C,GAAI,CAAC,OAAO,QACV,OAAO,KAAK,gBAAgB,QAAS,CAAE,OAAQ,SAAU,OAAQ,OAAO,OAAQ,GAAI,CAAC,CAAC,EAExF,kBAAkB,IAAK,SAAU,OAAO,IAAI,CAC9C,CAEA,KAAK,CACP,OAAS,IAAK,CACZ,KAAK,GAAG,CACV,CACF,CACF"}
1
+ {"version":3,"file":"validate.mjs","names":[],"sources":["../../../src/http/middleware/validate.ts"],"sourcesContent":["import type {\n ConnectRequest as Request,\n ConnectResponse as Response,\n ConnectNext as NextFunction,\n} from '../connect'\n// core/errors directly (not the barrel) — keeps the edge-safe web entry\n// graph free of the barrel's eager node:fs asset-manager import.\nimport { HttpException, HttpStatus } from '../../core/errors'\nimport { detectSchema, type KickSchema, type SchemaIssue } from '@forinda/kickjs-schema'\n\nexport interface ValidationSchema {\n body?: any\n query?: any\n params?: any\n}\n\n/** A request that failed route validation — what a `validationError` hook receives. */\nexport interface ValidationFailure {\n /** The part of the request that failed. */\n source: 'body' | 'query' | 'params'\n /** Every issue the schema reported, adapter-neutral (Zod, Valibot, Yup, …). */\n issues: SchemaIssue[]\n /** The request, as the runtime hands it to middleware. */\n req: unknown\n}\n\n/**\n * Turns a validation failure into the error the request fails with. Return\n * (or throw) any error — an `HttpException` or `ProblemException` keeps the\n * error handler's problem-details response — or return `undefined` to use\n * {@link defaultValidationError} for this one.\n */\nexport type ValidationErrorFactory = (failure: ValidationFailure) => unknown\n\n/**\n * The built-in failure: 422 with `details` as `[{ field, message }]`. A body\n * failure leads with its first issue's message. `@forinda/kickjs-inertia`\n * reads these `details` for the page's `errors`, so a custom factory serving\n * Inertia pages should keep the shape — or call this and adjust the result.\n */\nexport function defaultValidationError({ source, issues }: ValidationFailure): HttpException {\n const details = issues.map((i) => ({\n field: i.path.join('.') || '',\n message: i.message,\n }))\n const message =\n source === 'body'\n ? (issues[0]?.message ?? 'Validation failed')\n : source === 'query'\n ? 'Invalid query parameters'\n : 'Invalid path parameters'\n return new HttpException(HttpStatus.UNPROCESSABLE_ENTITY, message, details)\n}\n\nfunction validationError(\n factory: ValidationErrorFactory | undefined,\n failure: ValidationFailure,\n): unknown {\n if (!factory) return defaultValidationError(failure)\n try {\n return factory(failure) ?? defaultValidationError(failure)\n } catch (thrown) {\n return thrown\n }\n}\n\n/**\n * Express 5 installs `req.query` as a getter-only property (so pluggable\n * `query parser` functions can run lazily). Direct assignment throws in\n * strict mode: `Cannot set property query of #<IncomingMessage> which\n * has only a getter`. `Object.defineProperty` replaces the getter with\n * a plain value slot and sidesteps the throw. Used for `query` and\n * defensively for `params` too — Express 5 currently leaves `params`\n * writable, but swapping the descriptor costs the same and future-proofs\n * against upstream changes.\n */\nfunction assignReqProperty(req: Request, key: 'query' | 'params', value: unknown): void {\n Object.defineProperty(req, key, {\n value,\n writable: true,\n configurable: true,\n enumerable: true,\n })\n}\n\n/**\n * Express middleware that validates request body/query/params against schemas.\n *\n * Accepts any schema supported by `@forinda/kickjs-schema`:\n * - Zod schemas (auto-detected)\n * - Standard Schema v1 objects\n * - KickSchema instances (from adapters like fromZod, fromValibot, etc.)\n * - Plain validator functions\n *\n * Validation failures are forwarded via `next(err)` as an `HttpException`, so\n * they flow through the application's global error handler (`onError`) and\n * produce a uniform response envelope.\n */\nexport function validate(\n schema: ValidationSchema,\n options: {\n /** What a failure throws — see `bootstrap({ validationError })`. Default: a 422. */\n validationError?: ValidationErrorFactory\n } = {},\n) {\n const factory = options.validationError\n // Detected on the first request, not per request: detection walks every\n // registered adapter and allocates a wrapper. Not at construction either —\n // a custom adapter registered during boot must still be seen.\n let wrapped: { body?: KickSchema; query?: KickSchema; params?: KickSchema } | undefined\n const schemas = () =>\n (wrapped ??= {\n body: schema.body ? detectSchema(schema.body) : undefined,\n query: schema.query ? detectSchema(schema.query) : undefined,\n params: schema.params ? detectSchema(schema.params) : undefined,\n })\n\n return (req: Request, _res: Response, next: NextFunction) => {\n try {\n const { body, query, params } = schemas()\n if (body) {\n const result = body.safeParse(req.body)\n if (!result.success) {\n return next(validationError(factory, { source: 'body', issues: result.issues, req }))\n }\n req.body = result.data\n }\n\n if (query) {\n const result = query.safeParse(req.query)\n if (!result.success) {\n return next(validationError(factory, { source: 'query', issues: result.issues, req }))\n }\n assignReqProperty(req, 'query', result.data)\n }\n\n if (params) {\n const result = params.safeParse(req.params)\n if (!result.success) {\n return next(validationError(factory, { source: 'params', issues: result.issues, req }))\n }\n assignReqProperty(req, 'params', result.data)\n }\n\n next()\n } catch (err) {\n next(err)\n }\n }\n}\n"],"mappings":";;;;;;;;;;A,6GAwCA,SAAgB,uBAAuB,CAAE,OAAQ,QAA4C,CAC3F,IAAM,QAAU,OAAO,IAAK,IAAO,CACjC,MAAO,EAAE,KAAK,KAAK,GAAG,GAAK,GAC3B,QAAS,EAAE,OACb,EAAE,EACI,QACJ,SAAW,OACN,OAAO,EAAE,EAAE,SAAW,oBACvB,SAAW,QACT,2BACA,0BACR,OAAO,IAAI,cAAc,WAAW,qBAAsB,QAAS,OAAO,CAC5E,CAEA,SAAS,gBACP,QACA,QACS,CACT,GAAI,CAAC,QAAS,OAAO,uBAAuB,OAAO,EACnD,GAAI,CACF,OAAO,QAAQ,OAAO,GAAK,uBAAuB,OAAO,CAC3D,OAAS,OAAQ,CACf,OAAO,MACT,CACF,CAYA,SAAS,kBAAkB,IAAc,IAAyB,MAAsB,CACtF,OAAO,eAAe,IAAK,IAAK,CAC9B,MACA,SAAU,GACV,aAAc,GACd,WAAY,EACd,CAAC,CACH,CAeA,SAAgB,SACd,OACA,QAGI,CAAC,EACL,CACA,IAAM,QAAU,QAAQ,gBAIpB,QACE,YACH,UAAY,CACX,KAAM,OAAO,KAAO,aAAa,OAAO,IAAI,EAAI,IAAA,GAChD,MAAO,OAAO,MAAQ,aAAa,OAAO,KAAK,EAAI,IAAA,GACnD,OAAQ,OAAO,OAAS,aAAa,OAAO,MAAM,EAAI,IAAA,EACxD,EAEF,OAAQ,IAAc,KAAgB,OAAuB,CAC3D,GAAI,CACF,GAAM,CAAE,KAAM,MAAO,QAAW,QAAQ,EACxC,GAAI,KAAM,CACR,IAAM,OAAS,KAAK,UAAU,IAAI,IAAI,EACtC,GAAI,CAAC,OAAO,QACV,OAAO,KAAK,gBAAgB,QAAS,CAAE,OAAQ,OAAQ,OAAQ,OAAO,OAAQ,GAAI,CAAC,CAAC,EAEtF,IAAI,KAAO,OAAO,IACpB,CAEA,GAAI,MAAO,CACT,IAAM,OAAS,MAAM,UAAU,IAAI,KAAK,EACxC,GAAI,CAAC,OAAO,QACV,OAAO,KAAK,gBAAgB,QAAS,CAAE,OAAQ,QAAS,OAAQ,OAAO,OAAQ,GAAI,CAAC,CAAC,EAEvF,kBAAkB,IAAK,QAAS,OAAO,IAAI,CAC7C,CAEA,GAAI,OAAQ,CACV,IAAM,OAAS,OAAO,UAAU,IAAI,MAAM,EAC1C,GAAI,CAAC,OAAO,QACV,OAAO,KAAK,gBAAgB,QAAS,CAAE,OAAQ,SAAU,OAAQ,OAAO,OAAQ,GAAI,CAAC,CAAC,EAExF,kBAAkB,IAAK,SAAU,OAAO,IAAI,CAC9C,CAEA,KAAK,CACP,OAAS,IAAK,CACZ,KAAK,GAAG,CACV,CACF,CACF,C"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { C as ViewAdapterOptions, S as ViewAdapter, w as viewDirs } from "../../application-D921r4MW.mjs";
2
+ import { C as ViewAdapterOptions, S as ViewAdapter, w as viewDirs } from "../../application-CGcY8SZZ.mjs";
3
3
  export { ViewAdapter, ViewAdapterOptions, viewDirs };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.14.1
2
+ * @forinda/kickjs v10.14.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{Logger}from"../../core/logger.mjs";import"../../core-g3y9VDwr.mjs";import{t as defineAdapter}from"../../define-adapter-CZCFyDp5.mjs";import{dirname,resolve}from"node:path";const log=Logger.for(`ViewEngine`),ViewAdapter=defineAdapter({name:`ViewAdapter`,build:options=>({beforeMount({app:engineApp}){let app=engineApp,{engine,ext,viewsDir=`src/views`}=options;engine.__express?app.engine(ext,engine.__express):typeof engine.renderFile==`function`?app.engine(ext,(path,opts,callback)=>{engine.renderFile(path,opts,callback)}):(typeof engine==`function`||log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`),app.engine(ext,engine)),app.set(`view engine`,ext),app.set(`views`,viewDirs(viewsDir)),log.debug(`View engine: ${ext} (${viewDirs(viewsDir).join(`, `)})`)}})});function viewDirs(viewsDir){let root=resolve(process.env.KICK_APP_ROOT??process.cwd(),viewsDir),entry=process.argv[1]?resolve(dirname(resolve(process.argv[1])),viewsDir):root;return[.../* @__PURE__ */ new Set([root,entry])]}export{ViewAdapter,viewDirs};
11
+ import{Logger}from"../../core/logger.mjs";import"../../core-CCIpjo6g.mjs";import{t as defineAdapter}from"../../define-adapter-DMo6og81.mjs";import{dirname,resolve}from"node:path";const log=Logger.for(`ViewEngine`),ViewAdapter=defineAdapter({name:`ViewAdapter`,build:options=>({beforeMount({app:engineApp}){let app=engineApp,{engine,ext,viewsDir=`src/views`}=options;engine.__express?app.engine(ext,engine.__express):typeof engine.renderFile==`function`?app.engine(ext,(path,opts,callback)=>{engine.renderFile(path,opts,callback)}):(typeof engine==`function`||log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`),app.engine(ext,engine)),app.set(`view engine`,ext),app.set(`views`,viewDirs(viewsDir)),log.debug(`View engine: ${ext} (${viewDirs(viewsDir).join(`, `)})`)}})});function viewDirs(viewsDir){let root=resolve(process.env.KICK_APP_ROOT??process.cwd(),viewsDir),entry=process.argv[1]?resolve(dirname(resolve(process.argv[1])),viewsDir):root;return[.../* @__PURE__ */ new Set([root,entry])]}export{ViewAdapter,viewDirs};
12
12
  //# sourceMappingURL=views.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"views.mjs","names":[],"sources":["../../../src/http/middleware/views.ts"],"sourcesContent":["import { dirname, resolve } from 'node:path'\nimport { Logger, defineAdapter } from '../../core'\n\nconst log = Logger.for('ViewEngine')\n\nexport interface ViewAdapterOptions {\n /**\n * Template engine — pass the engine module or a render function.\n * Supported engines: ejs, pug, handlebars, nunjucks, or any\n * Express-compatible engine with a __express property.\n *\n * @example\n * ```ts\n * import ejs from 'ejs'\n * ViewAdapter({ engine: ejs, ext: 'ejs' })\n *\n * import pug from 'pug'\n * ViewAdapter({ engine: pug, ext: 'pug' })\n * ```\n */\n engine: any\n\n /** File extension for templates (e.g., 'ejs', 'pug', 'hbs') */\n ext: string\n\n /**\n * Directory containing template files (default: 'src/views'), relative to\n * the project. Also looked up beside the running entry file, where\n * `copyDirs: ['src/views']` puts it in a build (`dist/src/views`), so a\n * deployment holding only `dist/` still finds it.\n */\n viewsDir?: string\n\n /** Default layout template (optional — depends on engine) */\n layout?: string\n}\n\n/**\n * View/template adapter — pluggable template engine support for KickJS.\n *\n * Registers an Express view engine and sets the views directory.\n * Use `ctx.render()` in controllers to render templates.\n *\n * Migrated to the `defineAdapter()` factory in v4 — call without `new`.\n * The pre-v4 `new ViewAdapter({...})` form is gone; see\n * `docs/guide/migration-v3-to-v4.md` for the rename.\n *\n * @example\n * ```ts\n * import ejs from 'ejs'\n * import { ViewAdapter } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * adapters: [\n * ViewAdapter({ engine: ejs, ext: 'ejs', viewsDir: 'src/views' }),\n * ],\n * })\n *\n * // In a controller:\n * @Get('/dashboard')\n * async dashboard(ctx: RequestContext) {\n * ctx.render('dashboard', { user: currentUser, title: 'Dashboard' })\n * }\n * ```\n */\nexport const ViewAdapter = defineAdapter<ViewAdapterOptions>({\n name: 'ViewAdapter',\n build: (options) => ({\n beforeMount({ app: engineApp }) {\n // Express-only: template engines register on Express's app settings.\n const app = engineApp as {\n engine(ext: string, fn: unknown): unknown\n set(setting: string, value: unknown): unknown\n }\n const { engine, ext, viewsDir = 'src/views' } = options\n\n // Register the engine. Three resolution paths cover every\n // mainstream template engine + a fall-through for custom ones.\n if (engine.__express) {\n // EJS, Pug — have __express method\n app.engine(ext, engine.__express)\n } else if (typeof engine.renderFile === 'function') {\n // Engines with renderFile (nunjucks-style)\n app.engine(\n ext,\n (path: string, opts: any, callback: (err: Error | null, html?: string) => void) => {\n engine.renderFile(path, opts, callback)\n },\n )\n } else if (typeof engine === 'function') {\n // Custom render function: (path, options, callback) => void\n app.engine(ext, engine)\n } else {\n log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`)\n app.engine(ext, engine)\n }\n\n app.set('view engine', ext)\n app.set('views', viewDirs(viewsDir))\n\n log.debug(`View engine: ${ext} (${viewDirs(viewsDir).join(', ')})`)\n },\n }),\n})\n\n/**\n * Where to look for `viewsDir`: the project — `KICK_APP_ROOT` when set (the\n * Netlify and Vercel functions `kick build:*` writes set it to where\n * `deploy.include` files land), else the working directory — then beside the\n * running entry file (`node dist/index.js` → `dist/<viewsDir>`, where\n * `copyDirs` copies it). Express tries them in order.\n */\nexport function viewDirs(viewsDir: string): string[] {\n const root = resolve(process.env.KICK_APP_ROOT ?? process.cwd(), viewsDir)\n const entry = process.argv[1] ? resolve(dirname(resolve(process.argv[1])), viewsDir) : root\n return [...new Set([root, entry])]\n}\n"],"mappings":";;;;;;;;;;mLAGA,MAAM,IAAM,OAAO,IAAI,YAAY,EA+DtB,YAAc,cAAkC,CAC3D,KAAM,cACN,MAAQ,UAAa,CACnB,YAAY,CAAE,IAAK,WAAa,CAE9B,IAAM,IAAM,UAIN,CAAE,OAAQ,IAAK,SAAW,aAAgB,QAI5C,OAAO,UAET,IAAI,OAAO,IAAK,OAAO,SAAS,EACvB,OAAO,OAAO,YAAe,WAEtC,IAAI,OACF,KACC,KAAc,KAAW,WAAyD,CACjF,OAAO,WAAW,KAAM,KAAM,QAAQ,CACxC,CACF,GACS,OAAO,QAAW,YAI3B,IAAI,KAAK,eAAe,IAAI,sDAAsD,EAClF,IAAI,OAAO,IAAK,MAAM,GAGxB,IAAI,IAAI,cAAe,GAAG,EAC1B,IAAI,IAAI,QAAS,SAAS,QAAQ,CAAC,EAEnC,IAAI,MAAM,gBAAgB,IAAI,IAAI,SAAS,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,CACpE,CACF,EACF,CAAC,EASD,SAAgB,SAAS,SAA4B,CACnD,IAAM,KAAO,QAAQ,QAAQ,IAAI,eAAiB,QAAQ,IAAI,EAAG,QAAQ,EACnE,MAAQ,QAAQ,KAAK,GAAK,QAAQ,QAAQ,QAAQ,QAAQ,KAAK,EAAE,CAAC,EAAG,QAAQ,EAAI,KACvF,MAAO,CAAC,mBAAG,IAAI,IAAI,CAAC,KAAM,KAAK,CAAC,CAAC,CACnC"}
1
+ {"version":3,"file":"views.mjs","names":[],"sources":["../../../src/http/middleware/views.ts"],"sourcesContent":["import { dirname, resolve } from 'node:path'\nimport { Logger, defineAdapter } from '../../core'\n\nconst log = Logger.for('ViewEngine')\n\nexport interface ViewAdapterOptions {\n /**\n * Template engine — pass the engine module or a render function.\n * Supported engines: ejs, pug, handlebars, nunjucks, or any\n * Express-compatible engine with a __express property.\n *\n * @example\n * ```ts\n * import ejs from 'ejs'\n * ViewAdapter({ engine: ejs, ext: 'ejs' })\n *\n * import pug from 'pug'\n * ViewAdapter({ engine: pug, ext: 'pug' })\n * ```\n */\n engine: any\n\n /** File extension for templates (e.g., 'ejs', 'pug', 'hbs') */\n ext: string\n\n /**\n * Directory containing template files (default: 'src/views'), relative to\n * the project. Also looked up beside the running entry file, where\n * `copyDirs: ['src/views']` puts it in a build (`dist/src/views`), so a\n * deployment holding only `dist/` still finds it.\n */\n viewsDir?: string\n\n /** Default layout template (optional — depends on engine) */\n layout?: string\n}\n\n/**\n * View/template adapter — pluggable template engine support for KickJS.\n *\n * Registers an Express view engine and sets the views directory.\n * Use `ctx.render()` in controllers to render templates.\n *\n * Migrated to the `defineAdapter()` factory in v4 — call without `new`.\n * The pre-v4 `new ViewAdapter({...})` form is gone; see\n * `docs/guide/migration-v3-to-v4.md` for the rename.\n *\n * @example\n * ```ts\n * import ejs from 'ejs'\n * import { ViewAdapter } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * adapters: [\n * ViewAdapter({ engine: ejs, ext: 'ejs', viewsDir: 'src/views' }),\n * ],\n * })\n *\n * // In a controller:\n * @Get('/dashboard')\n * async dashboard(ctx: RequestContext) {\n * ctx.render('dashboard', { user: currentUser, title: 'Dashboard' })\n * }\n * ```\n */\nexport const ViewAdapter = defineAdapter<ViewAdapterOptions>({\n name: 'ViewAdapter',\n build: (options) => ({\n beforeMount({ app: engineApp }) {\n // Express-only: template engines register on Express's app settings.\n const app = engineApp as {\n engine(ext: string, fn: unknown): unknown\n set(setting: string, value: unknown): unknown\n }\n const { engine, ext, viewsDir = 'src/views' } = options\n\n // Register the engine. Three resolution paths cover every\n // mainstream template engine + a fall-through for custom ones.\n if (engine.__express) {\n // EJS, Pug — have __express method\n app.engine(ext, engine.__express)\n } else if (typeof engine.renderFile === 'function') {\n // Engines with renderFile (nunjucks-style)\n app.engine(\n ext,\n (path: string, opts: any, callback: (err: Error | null, html?: string) => void) => {\n engine.renderFile(path, opts, callback)\n },\n )\n } else if (typeof engine === 'function') {\n // Custom render function: (path, options, callback) => void\n app.engine(ext, engine)\n } else {\n log.warn(`Engine for .${ext} does not have __express or renderFile. Trying as-is.`)\n app.engine(ext, engine)\n }\n\n app.set('view engine', ext)\n app.set('views', viewDirs(viewsDir))\n\n log.debug(`View engine: ${ext} (${viewDirs(viewsDir).join(', ')})`)\n },\n }),\n})\n\n/**\n * Where to look for `viewsDir`: the project — `KICK_APP_ROOT` when set (the\n * Netlify and Vercel functions `kick build:*` writes set it to where\n * `deploy.include` files land), else the working directory — then beside the\n * running entry file (`node dist/index.js` → `dist/<viewsDir>`, where\n * `copyDirs` copies it). Express tries them in order.\n */\nexport function viewDirs(viewsDir: string): string[] {\n const root = resolve(process.env.KICK_APP_ROOT ?? process.cwd(), viewsDir)\n const entry = process.argv[1] ? resolve(dirname(resolve(process.argv[1])), viewsDir) : root\n return [...new Set([root, entry])]\n}\n"],"mappings":";;;;;;;;;;A,mLAGA,MAAM,IAAM,OAAO,IAAI,YAAY,EA+DtB,YAAc,cAAkC,CAC3D,KAAM,cACN,MAAQ,UAAa,CACnB,YAAY,CAAE,IAAK,WAAa,CAE9B,IAAM,IAAM,UAIN,CAAE,OAAQ,IAAK,SAAW,aAAgB,QAI5C,OAAO,UAET,IAAI,OAAO,IAAK,OAAO,SAAS,EACvB,OAAO,OAAO,YAAe,WAEtC,IAAI,OACF,KACC,KAAc,KAAW,WAAyD,CACjF,OAAO,WAAW,KAAM,KAAM,QAAQ,CACxC,CACF,GACS,OAAO,QAAW,YAI3B,IAAI,KAAK,eAAe,IAAI,sDAAsD,EAClF,IAAI,OAAO,IAAK,MAAM,GAGxB,IAAI,IAAI,cAAe,GAAG,EAC1B,IAAI,IAAI,QAAS,SAAS,QAAQ,CAAC,EAEnC,IAAI,MAAM,gBAAgB,IAAI,IAAI,SAAS,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,EAAE,CACpE,CACF,EACF,CAAC,EASD,SAAgB,SAAS,SAA4B,CACnD,IAAM,KAAO,QAAQ,QAAQ,IAAI,eAAiB,QAAQ,IAAI,EAAG,QAAQ,EACnE,MAAQ,QAAQ,KAAK,GAAK,QAAQ,QAAQ,QAAQ,QAAQ,KAAK,EAAE,CAAC,EAAG,QAAQ,EAAI,KACvF,MAAO,CAAC,mBAAG,IAAI,IAAI,CAAC,KAAM,KAAK,CAAC,CAAC,CACnC,C"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { A as TypedParsedQuery, C as PaginatedResponse, D as QueryFieldConfig, E as QueryBuilderAdapter, O as SortItem, S as FilterOperator, T as ParsedQuery, _ as CursorQuery, a as getQueryParsingDefaults, b as FieldsOf, c as parseQuery, d as resetQueryParsingDefaults, f as setQueryParsingDefaults, g as CursorPosition, h as CursorPaginatedResponse, i as buildQueryParams, k as StringQueryFieldConfig, l as parseSearchQuery, m as CursorPaginateOptions, n as QueryRejectReason, o as parseFilters, p as ColumnQueryFieldConfig, r as QueryRejection, s as parsePagination, t as ParseQueryOptions, u as parseSort, v as CursorValue, w as PaginationParams, x as FilterItem, y as FILTER_OPERATORS } from "../../index-Blgka75E.mjs";
2
+ import { A as TypedParsedQuery, C as PaginatedResponse, D as QueryFieldConfig, E as QueryBuilderAdapter, O as SortItem, S as FilterOperator, T as ParsedQuery, _ as CursorQuery, a as getQueryParsingDefaults, b as FieldsOf, c as parseQuery, d as resetQueryParsingDefaults, f as setQueryParsingDefaults, g as CursorPosition, h as CursorPaginatedResponse, i as buildQueryParams, k as StringQueryFieldConfig, l as parseSearchQuery, m as CursorPaginateOptions, n as QueryRejectReason, o as parseFilters, p as ColumnQueryFieldConfig, r as QueryRejection, s as parsePagination, t as ParseQueryOptions, u as parseSort, v as CursorValue, w as PaginationParams, x as FilterItem, y as FILTER_OPERATORS } from "../../index-ZbCnCyQx.mjs";
3
3
  export { type ColumnQueryFieldConfig, type CursorPaginateOptions, type CursorPaginatedResponse, type CursorPosition, type CursorQuery, type CursorValue, FILTER_OPERATORS, type FieldsOf, type FilterItem, type FilterOperator, type PaginatedResponse, type PaginationParams, type ParseQueryOptions, type ParsedQuery, type QueryBuilderAdapter, type QueryFieldConfig, type QueryRejectReason, type QueryRejection, type SortItem, type StringQueryFieldConfig, type TypedParsedQuery, buildQueryParams, getQueryParsingDefaults, parseFilters, parsePagination, parseQuery, parseSearchQuery, parseSort, resetQueryParsingDefaults, setQueryParsingDefaults };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.14.1
2
+ * @forinda/kickjs v10.14.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,4 +8,4 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- export{u as FILTER_OPERATORS,t as buildQueryParams,n as getQueryParsingDefaults,r as parseFilters,i as parsePagination,a as parseQuery,o as parseSearchQuery,s as parseSort,c as resetQueryParsingDefaults,l as setQueryParsingDefaults}from"../../query-DXIo1mII.mjs";
11
+ export{u as FILTER_OPERATORS,t as buildQueryParams,n as getQueryParsingDefaults,r as parseFilters,i as parsePagination,a as parseQuery,o as parseSearchQuery,s as parseSort,c as resetQueryParsingDefaults,l as setQueryParsingDefaults}from"../../query-BwUR-ssX.mjs";
@@ -1,3 +1,3 @@
1
1
 
2
- import { i as buildRouteTable, n as _setExternalContributorSources, r as assertRouteUnique, t as BuildRoutesOptions } from "../router-builder-C5EtcFSL.mjs";
2
+ import { i as buildRouteTable, n as _setExternalContributorSources, r as assertRouteUnique, t as BuildRoutesOptions } from "../router-builder-Dtyya4qP.mjs";
3
3
  export { BuildRoutesOptions, _setExternalContributorSources, assertRouteUnique, buildRouteTable };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.14.1
2
+ * @forinda/kickjs v10.14.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,4 +8,4 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- export{t as _setExternalContributorSources,n as assertRouteUnique,r as buildRouteTable}from"../router-builder-CiwYhiUM.mjs";
11
+ export{t as _setExternalContributorSources,n as assertRouteUnique,r as buildRouteTable}from"../router-builder-D2cly8Wt.mjs";
@@ -1,9 +1,8 @@
1
1
 
2
- import { d as HttpRuntime, h as RouteEntry } from "../../adapter-DL9JPcvC.mjs";
3
- import { n as ConnectHandler } from "../../connect-BlIamapT.mjs";
4
- import { t as BuildRoutesOptions } from "../../router-builder-C5EtcFSL.mjs";
2
+ import { t as BuildRoutesOptions } from "../../router-builder-Dtyya4qP.mjs";
3
+ import { n as ConnectHandler } from "../../connect-DamOelO8.mjs";
4
+ import { d as HttpRuntime, h as RouteEntry } from "../../adapter-B64IOivZ.mjs";
5
5
  import { Express, Request, Response } from "express";
6
- //#region src/http/runtimes/express.d.ts
7
6
  /**
8
7
  * Materialize a controller's {@link RouteEntry}[] onto a fresh `express.Router`.
9
8
  * Reproduces the legacy handler ordering precisely: validation → upload →
@@ -28,8 +27,6 @@ export declare function buildRoutes(controllerClass: any, options?: BuildRoutesO
28
27
  * apps that pass no `runtime` get this and behave exactly as before.
29
28
  */
30
29
  export declare function expressRuntime(): HttpRuntime;
31
- //#endregion
32
- //#region src/http/runtimes/express-types.d.ts
33
30
  /**
34
31
  * The Express runtime's native types — what `AdapterContext.app` and
35
32
  * `getRuntimeApp()` are typed as once `kick typegen` writes the
@@ -42,6 +39,5 @@ interface ExpressRuntimeTypes {
42
39
  response: Response;
43
40
  app: Express;
44
41
  }
45
- //#endregion
46
42
  export type { ExpressRuntimeTypes };
47
43
  //# sourceMappingURL=express.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"express.d.mts","names":[],"sources":["../../../src/http/runtimes/express.ts","../../../src/http/runtimes/express-types.ts"],"mappings":";;;;;;;;;;;;;;;wBAkDgB,kBAAkB,SAAS,eAAe;;;;;;;;;wBA4F1C,YACd,sBACA,UAAS,qBACR;;;;;wBAQa,kBAAkB;;;;;;;;;;UC9IjB;EACf,SAAS;EACT,UAAU;EACV,KAAK"}
1
+ {"version":3,"file":"express.d.mts","names":[],"sources":["../../../src/http/runtimes/express.ts","../../../src/http/runtimes/express-types.ts"],"mappings":";;;;;;;;;;;;;;wBAkDgB,kBAAkB,SAAS,eAAe;;;;;;;;;wBA4F1C,YACd,sBACA,UAAS,qBACR;;;;;wBAQa,kBAAkB;;;;;;;;UC9IjB;EACf,SAAS;EACT,UAAU;EACV,KAAK"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.14.1
2
+ * @forinda/kickjs v10.14.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,4 +8,4 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- export{t as buildRoutes,n as expressRuntime,i as materializeRouter}from"../../express-31o4SoCz.mjs";
11
+ export{t as buildRoutes,n as expressRuntime,i as materializeRouter}from"../../express-f9CTA8qO.mjs";
@@ -1,7 +1,6 @@
1
1
 
2
- import { d as HttpRuntime } from "../../adapter-DL9JPcvC.mjs";
2
+ import { d as HttpRuntime } from "../../adapter-B64IOivZ.mjs";
3
3
  import { IncomingMessage, ServerResponse } from "node:http";
4
- //#region src/http/runtimes/fastify.d.ts
5
4
  interface FastifyReplyLike {
6
5
  code(statusCode: number): FastifyReplyLike;
7
6
  send(payload?: unknown): FastifyReplyLike;
@@ -80,6 +79,5 @@ export interface FastifyRuntimeTypes {
80
79
  response: import('fastify').FastifyReply;
81
80
  app: import('fastify').FastifyInstance;
82
81
  }
83
- //#endregion
84
82
  export {};
85
83
  //# sourceMappingURL=fastify.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"fastify.d.mts","names":[],"sources":["../../../src/http/runtimes/fastify.ts"],"mappings":";;;;UAkEU;EACR,KAAK,qBAAqB;EAC1B,KAAK,oBAAoB;EACzB,OAAO,cAAc,iBAAiB;EACtC,aAAa,eAAe;EAC5B,KAAK,sBAAsB;EAC3B,WAAW,KAAK,8BAA8B;EAC9C,UAAU;EACV;;EAEA;WACS;WACA,KAAK;;UAEN;EACR,KAAK;EACL;EACA;EACA;;EAEA,UAAU;;EAEV,SAAS;IAAY,SAAS;QAA6B,sBAAsB;EACjF;;KAEG,kBAAkB,SAAS,oBAAoB,OAAO,4BAA4B;UAC7E;EACR,SAAS;EACT,SAAS,iBAAiB,iBAAiB,gBAAgB;EAC3D,IAAI,eAAe;EACnB,MAAM;IAAQ;IAAgB;IAAa,SAAS;;EACpD,mBAAmB,SAAS;EAC5B,gBACE,UAAU,cAAc,KAAK,oBAAoB,OAAO;EAE1D,SAAS;EACT,QAAQ,KAAK,iBAAiB,KAAK;;;;;;EAMnC,sBACE,kBAAkB,mBAClB;IAAQ;KACR,QAAQ;;;KAQP,qBACH,KAAK,oBACL,eAAe,QACf,OAAO,KAAK,cAAc;UAuElB;EACR;EACA;EACA;EACA;EACA;EACA,iBAAiB,QAAQ;;;;;;;wBAyPX,kBAAkB,YAAY;;;;;;;;iBAqP7B;EACf,2BAA2B;EAC3B,4BAA4B;EAC5B,uBAAuB"}
1
+ {"version":3,"file":"fastify.d.mts","names":[],"sources":["../../../src/http/runtimes/fastify.ts"],"mappings":";;;UAkEU;EACR,KAAK,qBAAqB;EAC1B,KAAK,oBAAoB;EACzB,OAAO,cAAc,iBAAiB;EACtC,aAAa,eAAe;EAC5B,KAAK,sBAAsB;EAC3B,WAAW,KAAK,8BAA8B;EAC9C,UAAU;EACV;;EAEA;WACS;WACA,KAAK;;UAEN;EACR,KAAK;EACL;EACA;EACA;;EAEA,UAAU;;EAEV,SAAS;IAAY,SAAS;QAA6B,sBAAsB;EACjF;;KAEG,kBAAkB,SAAS,oBAAoB,OAAO,4BAA4B;UAC7E;EACR,SAAS;EACT,SAAS,iBAAiB,iBAAiB,gBAAgB;EAC3D,IAAI,eAAe;EACnB,MAAM;IAAQ;IAAgB;IAAa,SAAS;;EACpD,mBAAmB,SAAS;EAC5B,gBACE,UAAU,cAAc,KAAK,oBAAoB,OAAO;EAE1D,SAAS;EACT,QAAQ,KAAK,iBAAiB,KAAK;;;;;;EAMnC,sBACE,kBAAkB,mBAClB;IAAQ;KACR,QAAQ;;;KAQP,qBACH,KAAK,oBACL,eAAe,QACf,OAAO,KAAK,cAAc;UAuElB;EACR;EACA;EACA;EACA;EACA;EACA,iBAAiB,QAAQ;;;;;;;wBAyPX,kBAAkB,YAAY;;;;;;;;iBAqP7B;EACf,2BAA2B;EAC3B,4BAA4B;EAC5B,uBAAuB"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.14.1
2
+ * @forinda/kickjs v10.14.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,6 +8,6 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{createLogger}from"../../core/logger.mjs";import{HttpException}from"../../core/errors.mjs";import{a as hasPrototypeKey,c as prototypeKeyError,f as tooLarge,i as formFields,p as unsupportedMediaTypeError,s as parseForm}from"../../body-policy-CwgUYBw7.mjs";import{f as requestStore}from"../../view-renderer-Dbha_94K.mjs";import{n as disposeRequestStore,t as createRequestStore}from"../../request-scope-DZQceiLY.mjs";import{n as applyHandlerResult}from"../../reply-CpMbB8uH.mjs";import{t as RequestContext}from"../../context-Cgr5dtIZ.mjs";import{n as publishMatchedRoute,r as stringifyJson}from"../../runtime-Bus9RVyU.mjs";import{validate}from"../middleware/validate.mjs";import{c as tooManyFiles,l as uploadLimits,n as UPLOAD_FIELDS_ALLOWANCE,r as applyUploadConfig,t as MAX_UPLOAD_FIELDS}from"../../upload-config-Bq3qcDel.mjs";import"../middleware/upload.mjs";import{t as lazyServeStatic}from"../../lazy-serve-static-CZBn-40v.mjs";import Fastify from"fastify";const pluginOf=mod=>mod.default??mod,createFastify=Fastify,log=createLogger(`FastifyRuntime`),QUEUE=Symbol(`kickjs.fastify.connectQueue`),READY=Symbol(`kickjs.fastify.ready`),NEXT=Symbol(`kickjs.fastify.next`),STORE=Symbol(`kickjs.fastify.store`),NEEDS_MULTIPART=Symbol(`kickjs.fastify.needsMultipart`),NOOP_NEXT=()=>{};function settleOrFail(reply,returned){typeof returned?.then==`function`&&Promise.resolve(returned).then(void 0,()=>{!reply.sent&&!reply.raw.headersSent&&reply.code(500).send({message:`Internal Server Error`})})}function inRouteStore(raw,res,fn){let own=raw[STORE];if(own)return void requestStore.run(own,fn);if(requestStore.getStore())return fn();let header=raw.headers[`x-request-id`],store=createRequestStore(raw.requestId||(Array.isArray(header)?header[0]:header));res.once(`close`,()=>disposeRequestStore(store)),requestStore.run(store,fn)}const NO_FALLTHROUGH=Symbol(`kickjs.fastify.noFallthrough`);function multipartError(err,limits,file){switch(err?.code){case`FST_REQ_FILE_TOO_LARGE`:return new HttpException(413,`File ${file} exceeds the ${limits.fileSize}-byte limit`);case`FST_FILES_LIMIT`:return tooManyFiles(limits.files);case`FST_FIELDS_LIMIT`:case`FST_PARTS_LIMIT`:return new HttpException(413,`Too many form fields`);case`FST_PROTO_VIOLATION`:return prototypeKeyError();default:return err}}var FastifyReplyDriver=class{reply;constructor(reply){this.reply=reply}status(code){return this.reply.code(code),this}json(data){return this.reply.getHeader(`content-type`)||this.reply.type(`application/json; charset=utf-8`),this.reply.serializer(stringifyJson).send(data),this}send(data){return this.reply.send(data),this}type(contentType){return this.reply.type(contentType),this}getHeader(name){return this.reply.getHeader(name)}setHeader(name,value){return this.reply.removeHeader(name),this.reply.header(name,value),this}render(){throw Error(`ctx.render() is not supported on the Fastify runtime (no view engine).`)}writeHead(statusCode,headers){return this.reply.hijack(),this.reply.raw.writeHead(statusCode,headers),this}flushHeaders(){return this.reply.raw.flushHeaders?.(),this}write(chunk){return this.reply.raw.write(chunk)}end(data){return this.reply.raw.headersSent?this.reply.raw.end(data):this.reply.send(data??``),this}once(event,listener){return this.reply.raw.once(event,listener),this}get headersSent(){return this.reply.sent||this.reply.raw.headersSent}};function replyDriver(reply){return new FastifyReplyDriver(reply)}function routeHandler(entry){let validator=entry.meta.validation?validate(entry.meta.validation,{validationError:entry.validationError}):void 0;return async(request,reply)=>{let raw=request.raw;if(raw.body=request.body,raw.params=request.params,raw.query=request.query,entry.meta.upload&&entry.meta.upload.mode!==`none`){if(typeof request.parts!=`function`)throw Error(`@forinda/kickjs: @FileUpload on the Fastify runtime requires '@fastify/multipart'.
11
+ import{HttpException}from"../../core/errors.mjs";import{a as hasPrototypeKey,c as prototypeKeyError,f as tooLarge,i as formFields,p as unsupportedMediaTypeError,s as parseForm}from"../../body-policy-Be3Y0hjq.mjs";import{t as RequestContext}from"../../context-BvZLaTeE.mjs";import{n as publishMatchedRoute,r as stringifyJson}from"../../runtime-D9TN6CpL.mjs";import{n as applyHandlerResult}from"../../reply-B5kZ6VGv.mjs";import{f as requestStore}from"../../view-renderer-C4sMEruA.mjs";import{n as disposeRequestStore,t as createRequestStore}from"../../request-scope-D2WQwatk.mjs";import{validate}from"../middleware/validate.mjs";import"../middleware/upload.mjs";import{c as tooManyFiles,l as uploadLimits,n as UPLOAD_FIELDS_ALLOWANCE,r as applyUploadConfig,t as MAX_UPLOAD_FIELDS}from"../../upload-config-BXjBiNjC.mjs";import{t as lazyServeStatic}from"../../lazy-serve-static-DVWmKM7Z.mjs";import{createLogger}from"../../core/logger.mjs";import Fastify from"fastify";const pluginOf=mod=>mod.default??mod,createFastify=Fastify,log=createLogger(`FastifyRuntime`),QUEUE=Symbol(`kickjs.fastify.connectQueue`),READY=Symbol(`kickjs.fastify.ready`),NEXT=Symbol(`kickjs.fastify.next`),STORE=Symbol(`kickjs.fastify.store`),NEEDS_MULTIPART=Symbol(`kickjs.fastify.needsMultipart`),NOOP_NEXT=()=>{};function settleOrFail(reply,returned){typeof returned?.then==`function`&&Promise.resolve(returned).then(void 0,()=>{!reply.sent&&!reply.raw.headersSent&&reply.code(500).send({message:`Internal Server Error`})})}function inRouteStore(raw,res,fn){let own=raw[STORE];if(own)return void requestStore.run(own,fn);if(requestStore.getStore())return fn();let header=raw.headers[`x-request-id`],store=createRequestStore(raw.requestId||(Array.isArray(header)?header[0]:header));res.once(`close`,()=>disposeRequestStore(store)),requestStore.run(store,fn)}const NO_FALLTHROUGH=Symbol(`kickjs.fastify.noFallthrough`);function multipartError(err,limits,file){switch(err?.code){case`FST_REQ_FILE_TOO_LARGE`:return new HttpException(413,`File ${file} exceeds the ${limits.fileSize}-byte limit`);case`FST_FILES_LIMIT`:return tooManyFiles(limits.files);case`FST_FIELDS_LIMIT`:case`FST_PARTS_LIMIT`:return new HttpException(413,`Too many form fields`);case`FST_PROTO_VIOLATION`:return prototypeKeyError();default:return err}}var FastifyReplyDriver=class{reply;constructor(reply){this.reply=reply}status(code){return this.reply.code(code),this}json(data){return this.reply.getHeader(`content-type`)||this.reply.type(`application/json; charset=utf-8`),this.reply.serializer(stringifyJson).send(data),this}send(data){return this.reply.send(data),this}type(contentType){return this.reply.type(contentType),this}getHeader(name){return this.reply.getHeader(name)}setHeader(name,value){return this.reply.removeHeader(name),this.reply.header(name,value),this}render(){throw Error(`ctx.render() is not supported on the Fastify runtime (no view engine).`)}writeHead(statusCode,headers){return this.reply.hijack(),this.reply.raw.writeHead(statusCode,headers),this}flushHeaders(){return this.reply.raw.flushHeaders?.(),this}write(chunk){return this.reply.raw.write(chunk)}end(data){return this.reply.raw.headersSent?this.reply.raw.end(data):this.reply.send(data??``),this}once(event,listener){return this.reply.raw.once(event,listener),this}get headersSent(){return this.reply.sent||this.reply.raw.headersSent}};function replyDriver(reply){return new FastifyReplyDriver(reply)}function routeHandler(entry){let validator=entry.meta.validation?validate(entry.meta.validation,{validationError:entry.validationError}):void 0;return async(request,reply)=>{let raw=request.raw;if(raw.body=request.body,raw.params=request.params,raw.query=request.query,entry.meta.upload&&entry.meta.upload.mode!==`none`){if(typeof request.parts!=`function`)throw Error(`@forinda/kickjs: @FileUpload on the Fastify runtime requires '@fastify/multipart'.
12
12
  Install it as a peer dependency: pnpm add @fastify/multipart.`);let limits=uploadLimits(entry.meta.upload),rawParts=[],fields=[],current=`file`,received=0,count=bytes=>{if(received+=bytes,received>limits.total)throw tooLarge(limits.total)};try{for await(let part of request.parts({limits:{fileSize:limits.fileSize,files:limits.files,fields:MAX_UPLOAD_FIELDS,fieldSize:UPLOAD_FIELDS_ALLOWANCE}}))if(part.type===`file`&&part.toBuffer){current=part.filename??part.fieldname;let buffer=await part.toBuffer();count(buffer.length),rawParts.push({fieldname:part.fieldname,filename:part.filename??``,mimetype:part.mimetype??`application/octet-stream`,buffer})}else{let value=String(part.value);count(Buffer.byteLength(part.fieldname)+Buffer.byteLength(value)),fields.push([part.fieldname,value])}}catch(err){throw multipartError(err,limits,current)}let{file,files}=applyUploadConfig(rawParts,entry.meta.upload);raw.file=file,raw.files=files,raw.body={...raw.body,...formFields(fields)}}if(hasPrototypeKey(raw.body))throw prototypeKeyError();let headerId=raw.headers[`x-request-id`],requestId=raw.requestId||(Array.isArray(headerId)?headerId[0]:headerId),store=createRequestStore(requestId);raw.requestId=store.requestId,raw[STORE]=store,reply.getHeader(`x-request-id`)||reply.header(`x-request-id`,store.requestId),reply.raw.once(`close`,()=>disposeRequestStore(store)),await requestStore.run(store,async()=>{publishMatchedRoute(raw,entry);let ctx=new RequestContext(raw,reply,NOOP_NEXT,replyDriver(reply));if(entry.earlyContributorRunner&&(await entry.earlyContributorRunner(ctx),reply.sent))return;validator&&await new Promise((resolve,reject)=>{validator(raw,void 0,err=>err?reject(err):resolve())});for(let mw of entry.middlewares){let advanced=!1;if(await new Promise((resolve,reject)=>{Promise.resolve(mw(ctx,err=>{advanced=!0,err?reject(err):resolve()})).catch(reject)}),!advanced||reply.sent)return}if(entry.contributorRunner&&await entry.contributorRunner(ctx),reply.sent)return;let result=await entry.handler(ctx);!reply.sent&&!await applyHandlerResult(ctx,result)&&reply.callNotFound()})}}function hopTrust(hops){return(_ip,hopIndex)=>hopIndex<hops}function fastifyRuntime(){return{name:`fastify`,createApp(options={}){let app=createFastify({logger:!1,routerOptions:{ignoreTrailingSlash:!0},...options.bodyLimit===void 0?{}:{bodyLimit:options.bodyLimit},trustProxy:typeof options.trustProxy==`number`?hopTrust(options.trustProxy):options.trustProxy});app[QUEUE]=[];let addParser=app.addContentTypeParser?.bind(app);return addParser&&(addParser(/^application\/[\w.+-]+\+json$/,{parseAs:`string`},(_req,body,done)=>{if(body===``)return done(null,void 0);try{done(null,JSON.parse(body))}catch(err){done(HttpException.badRequest(err instanceof Error?err.message:`Request body could not be parsed`),void 0)}}),addParser(`application/x-www-form-urlencoded`,{parseAs:`string`},(_req,body,done)=>{done(null,parseForm(body))}),addParser(/^text\//,{parseAs:`string`},(_req,body,done)=>{done(null,body)}),addParser(`*`,{parseAs:`string`},(req,body,done)=>{if(!body)return done(null,void 0);done(unsupportedMediaTypeError(req.headers?.[`content-type`]),void 0)})),options.notFoundFallthrough===!1&&(app[NO_FALLTHROUGH]=!0),app},nodeHandler(app){let state=app;state[READY]||(state[READY]=(async()=>{if(state[NEEDS_MULTIPART]){let multipart=pluginOf(await import(`@fastify/multipart`));await app.register(multipart,{limits:{fileSize:2**53-1}})}let middie=pluginOf(await import(`@fastify/middie`));await app.register(middie);for(let{mw,opts}of state[QUEUE]??[])opts?.path===void 0?app.use(mw):app.use(opts.path,mw);await app.ready()})());let readyP=state[READY],ready=!1;return readyP.then(()=>ready=!0,()=>{}),(req,res,next)=>{next&&(req[NEXT]=next),ready?app.routing(req,res):readyP.then(()=>app.routing(req,res)).catch(err=>{if(next)return next(err);log.error(err,`Fastify failed to start`),res.statusCode=500,res.end(`Internal Server Error`)})}},mountRoutes(app,table){for(let{mountPath,routes}of table)for(let entry of routes){entry.meta.upload&&(app[NEEDS_MULTIPART]=!0);let url=joinPath(mountPath,entry.path);app.route({method:entry.method,url,handler:routeHandler(entry)})}},useConnect(app,mw,opts){app[QUEUE]?.push({mw,opts})},serveStatic(app,prefix,dir){this.useConnect(app,lazyServeStatic(dir),{path:prefix})},setNotFound(app,mw){app.setNotFoundHandler((request,reply)=>{let next=request.raw[NEXT];next&&!app[NO_FALLTHROUGH]?(reply.hijack(),next()):inRouteStore(request.raw,reply.raw,()=>settleOrFail(reply,mw(request.raw,replyDriver(reply),NOOP_NEXT)))})},setErrorHandler(app,mw){app.setErrorHandler((err,request,reply)=>{inRouteStore(request.raw,reply.raw,()=>settleOrFail(reply,mw(err,request.raw,replyDriver(reply),NOOP_NEXT)))})},close(app){return app.close()},capabilities:{render:!1,uploads:!0,connectMiddleware:!0,nativeBodyParsing:!0,http2:!0}}}function joinPath(mountPath,path){let a=mountPath.endsWith(`/`)?mountPath.slice(0,-1):mountPath;return path===`/`||path===``?a===``?`/`:a:`${a}${path.startsWith(`/`)?path:`/${path}`}`}export{fastifyRuntime};
13
13
  //# sourceMappingURL=fastify.mjs.map