@forinda/kickjs 10.14.1 → 10.15.0

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 (299) hide show
  1. package/dist/{adapter-DL9JPcvC.d.mts → adapter-D_nUmKEQ.d.mts} +175 -77
  2. package/dist/adapter-D_nUmKEQ.d.mts.map +1 -0
  3. package/dist/{allowed-hosts-BpKwviq5.d.mts → allowed-hosts-BQlQFt-1.d.mts} +7 -4
  4. package/dist/allowed-hosts-BQlQFt-1.d.mts.map +1 -0
  5. package/dist/{app-module-Dk2Wenqx.d.mts → app-module-BmViGLgj.d.mts} +7 -13
  6. package/dist/app-module-BmViGLgj.d.mts.map +1 -0
  7. package/dist/application-B16ltRnC.mjs +14 -0
  8. package/dist/application-B16ltRnC.mjs.map +1 -0
  9. package/dist/{application-D921r4MW.d.mts → application-ClCq0AgY.d.mts} +200 -115
  10. package/dist/application-ClCq0AgY.d.mts.map +1 -0
  11. package/dist/{body-policy-CwgUYBw7.mjs → body-policy-D8LveWmO.mjs} +2 -2
  12. package/dist/{body-policy-CwgUYBw7.mjs.map → body-policy-D8LveWmO.mjs.map} +1 -1
  13. package/dist/{bootstrap-CY0v5VVF.mjs → bootstrap-C5NvsxHQ.mjs} +3 -3
  14. package/dist/bootstrap-C5NvsxHQ.mjs.map +1 -0
  15. package/dist/{bounded-counters-CF8EnVUm.mjs → bounded-counters-BtvB2daV.mjs} +2 -2
  16. package/dist/{bounded-counters-CF8EnVUm.mjs.map → bounded-counters-BtvB2daV.mjs.map} +1 -1
  17. package/dist/{breach-padding-FBVGmcBb.d.mts → breach-padding-BUuc21Eu.d.mts} +7 -4
  18. package/dist/breach-padding-BUuc21Eu.d.mts.map +1 -0
  19. package/dist/{cache-CdRHSXow.d.mts → cache-ByX5O2Hp.d.mts} +26 -3
  20. package/dist/cache-ByX5O2Hp.d.mts.map +1 -0
  21. package/dist/{client-ip-CpEuptqr.mjs → client-ip-CWvyHmqt.mjs} +2 -2
  22. package/dist/{client-ip-CpEuptqr.mjs.map → client-ip-CWvyHmqt.mjs.map} +1 -1
  23. package/dist/config/index.d.mts +6 -1
  24. package/dist/config/index.mjs +2 -2
  25. package/dist/{config-Djisd0f5.mjs → config-BIQoDNil.mjs} +3 -3
  26. package/dist/{config-Djisd0f5.mjs.map → config-BIQoDNil.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/container-DtdUiRwr.d.mts +3 -0
  30. package/dist/{context-Cgr5dtIZ.mjs → context-BzFNflxV.mjs} +3 -3
  31. package/dist/context-BzFNflxV.mjs.map +1 -0
  32. package/dist/{context-errors-6x0bjldv.mjs → context-errors-BmaG4vwd.mjs} +2 -2
  33. package/dist/context-errors-BmaG4vwd.mjs.map +1 -0
  34. package/dist/{contributor-runner-DQ2fXJ29.mjs → contributor-runner-BnJzu2GI.mjs} +3 -3
  35. package/dist/contributor-runner-BnJzu2GI.mjs.map +1 -0
  36. package/dist/core/adapter.d.mts +1 -1
  37. package/dist/core/adapter.mjs +1 -1
  38. package/dist/core/app-module.d.mts +1 -1
  39. package/dist/core/app-module.mjs +1 -1
  40. package/dist/core/cache.d.mts +1 -1
  41. package/dist/core/cache.mjs +1 -1
  42. package/dist/core/cache.mjs.map +1 -1
  43. package/dist/core/container.d.mts +1 -1
  44. package/dist/core/container.mjs +2 -2
  45. package/dist/core/cron.d.mts +1 -1
  46. package/dist/core/cron.mjs +2 -2
  47. package/dist/core/cron.mjs.map +1 -1
  48. package/dist/core/decorators.d.mts +1 -1
  49. package/dist/core/decorators.mjs +2 -2
  50. package/dist/core/decorators.mjs.map +1 -1
  51. package/dist/core/errors.d.mts +1 -1
  52. package/dist/core/errors.mjs +1 -1
  53. package/dist/core/errors.mjs.map +1 -1
  54. package/dist/core/interfaces.d.mts +1 -1
  55. package/dist/core/interfaces.mjs +1 -1
  56. package/dist/core/interfaces.mjs.map +1 -1
  57. package/dist/core/logger.d.mts +1 -1
  58. package/dist/core/logger.mjs +1 -1
  59. package/dist/core/logger.mjs.map +1 -1
  60. package/dist/core/path.d.mts +1 -1
  61. package/dist/core/path.mjs +1 -1
  62. package/dist/core/path.mjs.map +1 -1
  63. package/dist/core/plugin.d.mts +1 -1
  64. package/dist/core/plugin.mjs +1 -1
  65. package/dist/core/reactivity.d.mts +1 -1
  66. package/dist/core/reactivity.mjs +2 -2
  67. package/dist/core/reactivity.mjs.map +1 -1
  68. package/dist/core-Dqzah_BX.mjs +12 -0
  69. package/dist/core-Dqzah_BX.mjs.map +1 -0
  70. package/dist/{cors-BlR_b0Qb.d.mts → cors-u1OwTxQ8.d.mts} +7 -4
  71. package/dist/cors-u1OwTxQ8.d.mts.map +1 -0
  72. package/dist/{cron-BTGytNg-.d.mts → cron-Bxm2MY8u.d.mts} +10 -3
  73. package/dist/cron-Bxm2MY8u.d.mts.map +1 -0
  74. package/dist/{csrf-DOAaYozG.d.mts → csrf-8-Jknvmc.d.mts} +14 -6
  75. package/dist/csrf-8-Jknvmc.d.mts.map +1 -0
  76. package/dist/decorate-C3to8dG-.mjs +13 -0
  77. package/dist/decorate-C3to8dG-.mjs.map +1 -0
  78. package/dist/{decorators-DxNb5mWw.d.mts → decorators-Bflncyz6.d.mts} +122 -10
  79. package/dist/decorators-Bflncyz6.d.mts.map +1 -0
  80. package/dist/{define-adapter-CZCFyDp5.mjs → define-adapter-DCjNTP6m.mjs} +2 -2
  81. package/dist/define-adapter-DCjNTP6m.mjs.map +1 -0
  82. package/dist/{di-hooks-ZfnBZMDp.mjs → di-hooks-DTDy7ABs.mjs} +2 -2
  83. package/dist/di-hooks-DTDy7ABs.mjs.map +1 -0
  84. package/dist/{disposables-DFZXQuVg.mjs → disposables-BC291ukb.mjs} +1 -1
  85. package/dist/{driver-D_bUSW7N.mjs → driver-D59oWDec.mjs} +3 -3
  86. package/dist/{driver-D_bUSW7N.mjs.map → driver-D59oWDec.mjs.map} +1 -1
  87. package/dist/{error-handler-D7DLWe1Q.d.mts → error-handler-gZLQFHeE.d.mts} +2 -4
  88. package/dist/error-handler-gZLQFHeE.d.mts.map +1 -0
  89. package/dist/{errors-By6UueCm.d.mts → errors-CppqPy0A.d.mts} +2 -3
  90. package/dist/{errors-By6UueCm.d.mts.map → errors-CppqPy0A.d.mts.map} +1 -1
  91. package/dist/{express-31o4SoCz.mjs → express-JAXx9MK0.mjs} +3 -3
  92. package/dist/{express-31o4SoCz.mjs.map → express-JAXx9MK0.mjs.map} +1 -1
  93. package/dist/{express-lazy-GCgYyykt.mjs → express-lazy-jIFBeDpY.mjs} +3 -3
  94. package/dist/{express-lazy-GCgYyykt.mjs.map → express-lazy-jIFBeDpY.mjs.map} +1 -1
  95. package/dist/{handler-Bvs0gx1o.mjs → handler-C8iAD_xz.mjs} +3 -3
  96. package/dist/{handler-Bvs0gx1o.mjs.map → handler-C8iAD_xz.mjs.map} +1 -1
  97. package/dist/{helmet-BVuVBl-D.d.mts → helmet-1H0LKr6y.d.mts} +7 -4
  98. package/dist/helmet-1H0LKr6y.d.mts.map +1 -0
  99. package/dist/{host-CKz7eCtO.mjs → host-Crxmi91N.mjs} +2 -2
  100. package/dist/{host-CKz7eCtO.mjs.map → host-Crxmi91N.mjs.map} +1 -1
  101. package/dist/http/application.d.mts +1 -1
  102. package/dist/http/application.mjs +2 -2
  103. package/dist/http/bootstrap.d.mts +1 -1
  104. package/dist/http/bootstrap.mjs +2 -2
  105. package/dist/http/context.d.mts +2 -2
  106. package/dist/http/context.mjs +2 -2
  107. package/dist/http/middleware/allowed-hosts.d.mts +1 -1
  108. package/dist/http/middleware/allowed-hosts.mjs +2 -2
  109. package/dist/http/middleware/allowed-hosts.mjs.map +1 -1
  110. package/dist/http/middleware/breach-padding.d.mts +1 -1
  111. package/dist/http/middleware/breach-padding.mjs +1 -1
  112. package/dist/http/middleware/breach-padding.mjs.map +1 -1
  113. package/dist/http/middleware/cors.d.mts +1 -1
  114. package/dist/http/middleware/cors.mjs +1 -1
  115. package/dist/http/middleware/cors.mjs.map +1 -1
  116. package/dist/http/middleware/csrf.d.mts +1 -1
  117. package/dist/http/middleware/csrf.mjs +2 -2
  118. package/dist/http/middleware/csrf.mjs.map +1 -1
  119. package/dist/http/middleware/error-handler.d.mts +1 -1
  120. package/dist/http/middleware/error-handler.mjs +2 -2
  121. package/dist/http/middleware/error-handler.mjs.map +1 -1
  122. package/dist/http/middleware/helmet.d.mts +1 -1
  123. package/dist/http/middleware/helmet.mjs +1 -1
  124. package/dist/http/middleware/helmet.mjs.map +1 -1
  125. package/dist/http/middleware/rate-limit.d.mts +1 -1
  126. package/dist/http/middleware/rate-limit.mjs +2 -2
  127. package/dist/http/middleware/rate-limit.mjs.map +1 -1
  128. package/dist/http/middleware/request-id.d.mts +1 -1
  129. package/dist/http/middleware/request-id.mjs +1 -1
  130. package/dist/http/middleware/request-id.mjs.map +1 -1
  131. package/dist/http/middleware/request-logger.d.mts +1 -1
  132. package/dist/http/middleware/request-logger.mjs +2 -2
  133. package/dist/http/middleware/request-logger.mjs.map +1 -1
  134. package/dist/http/middleware/session.d.mts +1 -1
  135. package/dist/http/middleware/session.mjs +2 -2
  136. package/dist/http/middleware/session.mjs.map +1 -1
  137. package/dist/http/middleware/spa.d.mts +1 -1
  138. package/dist/http/middleware/spa.mjs +2 -2
  139. package/dist/http/middleware/spa.mjs.map +1 -1
  140. package/dist/http/middleware/upload.d.mts +2 -2
  141. package/dist/http/middleware/upload.mjs +2 -2
  142. package/dist/http/middleware/upload.mjs.map +1 -1
  143. package/dist/http/middleware/validate.d.mts +1 -1
  144. package/dist/http/middleware/validate.mjs +1 -1
  145. package/dist/http/middleware/validate.mjs.map +1 -1
  146. package/dist/http/middleware/views.d.mts +1 -1
  147. package/dist/http/middleware/views.mjs +2 -2
  148. package/dist/http/middleware/views.mjs.map +1 -1
  149. package/dist/http/query/index.d.mts +1 -1
  150. package/dist/http/query/index.mjs +2 -2
  151. package/dist/http/router-builder.d.mts +1 -1
  152. package/dist/http/router-builder.mjs +2 -2
  153. package/dist/http/runtimes/express.d.mts +4 -7
  154. package/dist/http/runtimes/express.d.mts.map +1 -1
  155. package/dist/http/runtimes/express.mjs +2 -2
  156. package/dist/http/runtimes/fastify.d.mts +3 -5
  157. package/dist/http/runtimes/fastify.d.mts.map +1 -1
  158. package/dist/http/runtimes/fastify.mjs +2 -2
  159. package/dist/http/runtimes/fastify.mjs.map +1 -1
  160. package/dist/http/runtimes/h3-web.mjs +1 -1
  161. package/dist/http/runtimes/h3.d.mts +1 -3
  162. package/dist/http/runtimes/h3.d.mts.map +1 -1
  163. package/dist/http/runtimes/h3.mjs +2 -2
  164. package/dist/http/runtimes/h3.mjs.map +1 -1
  165. package/dist/{index-Blgka75E.d.mts → index-CtjmSXFy.d.mts} +11 -5
  166. package/dist/index-CtjmSXFy.d.mts.map +1 -0
  167. package/dist/{index-DP_I4puv.d.mts → index-DoukvKwh.d.mts} +3 -7
  168. package/dist/index-DoukvKwh.d.mts.map +1 -0
  169. package/dist/index.d.mts +38 -32
  170. package/dist/index.mjs +2 -2
  171. package/dist/index.mjs.map +1 -1
  172. package/dist/{interfaces-C6LHcYsg.d.mts → interfaces-CvO9sAea.d.mts} +3 -5
  173. package/dist/interfaces-CvO9sAea.d.mts.map +1 -0
  174. package/dist/{is-production-6wpWSGvS.mjs → is-production-LziEMGrc.mjs} +2 -2
  175. package/dist/{is-production-6wpWSGvS.mjs.map → is-production-LziEMGrc.mjs.map} +1 -1
  176. package/dist/{jobs-BTnyyRY1.mjs → jobs-D7ToA0yF.mjs} +3 -3
  177. package/dist/jobs-D7ToA0yF.mjs.map +1 -0
  178. package/dist/{kv-stores-CwJdsMln.d.mts → kv-stores-DdGPLXQG.d.mts} +33 -20
  179. package/dist/kv-stores-DdGPLXQG.d.mts.map +1 -0
  180. package/dist/{kv-stores-HUdUibOx.mjs → kv-stores-DpM57Xr5.mjs} +3 -3
  181. package/dist/kv-stores-DpM57Xr5.mjs.map +1 -0
  182. package/dist/{lazy-serve-static-CZBn-40v.mjs → lazy-serve-static-DxI2K-zs.mjs} +3 -3
  183. package/dist/{lazy-serve-static-CZBn-40v.mjs.map → lazy-serve-static-DxI2K-zs.mjs.map} +1 -1
  184. package/dist/{logger-xE9qI_FS.d.mts → logger-ByJsVwqY.d.mts} +3 -5
  185. package/dist/logger-ByJsVwqY.d.mts.map +1 -0
  186. package/dist/{metadata-UjLEzS06.mjs → metadata-nTTSnVTO.mjs} +1 -1
  187. package/dist/{observers-C4bWQTop.mjs → observers-fQtCIKLq.mjs} +2 -2
  188. package/dist/observers-fQtCIKLq.mjs.map +1 -0
  189. package/dist/{path-CMwIHsdv.d.mts → path-DsenzqJ7.d.mts} +1 -3
  190. package/dist/path-DsenzqJ7.d.mts.map +1 -0
  191. package/dist/{precompressed-BNkw1Vrz.mjs → precompressed-BtwmgzyS.mjs} +2 -2
  192. package/dist/{precompressed-BNkw1Vrz.mjs.map → precompressed-BtwmgzyS.mjs.map} +1 -1
  193. package/dist/{query-DXIo1mII.mjs → query-Dr28oT30.mjs} +2 -2
  194. package/dist/query-Dr28oT30.mjs.map +1 -0
  195. package/dist/{rate-limit-DQDk6bAH.d.mts → rate-limit-BQx_P6gG.d.mts} +13 -5
  196. package/dist/rate-limit-BQx_P6gG.d.mts.map +1 -0
  197. package/dist/{reactivity-DZrc3Yhu.d.mts → reactivity-KZOrwVeK.d.mts} +32 -3
  198. package/dist/reactivity-KZOrwVeK.d.mts.map +1 -0
  199. package/dist/{reply-CpMbB8uH.mjs → reply-ChoI5SvM.mjs} +3 -3
  200. package/dist/{reply-CpMbB8uH.mjs.map → reply-ChoI5SvM.mjs.map} +1 -1
  201. package/dist/{request-id-Dn64nEHK.d.mts → request-id-B9Myiv75.d.mts} +3 -4
  202. package/dist/request-id-B9Myiv75.d.mts.map +1 -0
  203. package/dist/{request-logger-TgcKRNDD.d.mts → request-logger-CYyAuPmo.d.mts} +6 -3
  204. package/dist/request-logger-CYyAuPmo.d.mts.map +1 -0
  205. package/dist/{request-scope-DZQceiLY.mjs → request-scope-BfSNdmz9.mjs} +3 -3
  206. package/dist/{request-scope-DZQceiLY.mjs.map → request-scope-BfSNdmz9.mjs.map} +1 -1
  207. package/dist/{respond-Bc71p7sN.mjs → respond-1BjaDME9.mjs} +2 -2
  208. package/dist/{respond-Bc71p7sN.mjs.map → respond-1BjaDME9.mjs.map} +1 -1
  209. package/dist/rolldown-runtime-B5KeNctS.mjs +11 -0
  210. package/dist/{route-flag-DWNbpMIE.mjs → route-flag-B6ZmhkfI.mjs} +3 -3
  211. package/dist/{route-flag-DWNbpMIE.mjs.map → route-flag-B6ZmhkfI.mjs.map} +1 -1
  212. package/dist/{route-flag-B1lQht6v.d.mts → route-flag-CjXQl-oX.d.mts} +1 -3
  213. package/dist/route-flag-CjXQl-oX.d.mts.map +1 -0
  214. package/dist/{route-policy-DsdJx3bk.mjs → route-policy-BG--gAcF.mjs} +2 -2
  215. package/dist/route-policy-BG--gAcF.mjs.map +1 -0
  216. package/dist/{router-builder-C5EtcFSL.d.mts → router-builder-BkIW_qjz.d.mts} +4 -5
  217. package/dist/router-builder-BkIW_qjz.d.mts.map +1 -0
  218. package/dist/{router-builder-CiwYhiUM.mjs → router-builder-DHKtp4I8.mjs} +3 -3
  219. package/dist/router-builder-DHKtp4I8.mjs.map +1 -0
  220. package/dist/{runtime-Bus9RVyU.mjs → runtime-CUfFIHiC.mjs} +3 -3
  221. package/dist/runtime-CUfFIHiC.mjs.map +1 -0
  222. package/dist/{session-DQG72vCf.d.mts → session-DPTbfwKO.d.mts} +41 -4
  223. package/dist/session-DPTbfwKO.d.mts.map +1 -0
  224. package/dist/{settings-DgZLgcNU.d.mts → settings-CB6lh6_s.d.mts} +1 -3
  225. package/dist/settings-CB6lh6_s.d.mts.map +1 -0
  226. package/dist/{settings-CNZ7iRli.mjs → settings-I7GUX5ps.mjs} +4 -4
  227. package/dist/settings-I7GUX5ps.mjs.map +1 -0
  228. package/dist/{token-CroYM4Lm.mjs → token-uWfhVlfe.mjs} +1 -1
  229. package/dist/{upload-DnwvZQyi.d.mts → upload-O3VTcODy.d.mts} +4 -6
  230. package/dist/upload-O3VTcODy.d.mts.map +1 -0
  231. package/dist/{upload-config-Bq3qcDel.mjs → upload-config-BXqBuyza.mjs} +2 -2
  232. package/dist/{upload-config-Bq3qcDel.mjs.map → upload-config-BXqBuyza.mjs.map} +1 -1
  233. package/dist/url-for-CuMaQ2wS.mjs +12 -0
  234. package/dist/url-for-CuMaQ2wS.mjs.map +1 -0
  235. package/dist/{validate-D4Poe2EE.d.mts → validate-CTgfm7oE.d.mts} +3 -5
  236. package/dist/validate-CTgfm7oE.d.mts.map +1 -0
  237. package/dist/{view-renderer-Dbha_94K.mjs → view-renderer-Bf1Wy-DQ.mjs} +3 -3
  238. package/dist/view-renderer-Bf1Wy-DQ.mjs.map +1 -0
  239. package/dist/{web-crypto-CJiyfQrv.mjs → web-crypto-JzoGmiG0.mjs} +2 -2
  240. package/dist/{web-crypto-CJiyfQrv.mjs.map → web-crypto-JzoGmiG0.mjs.map} +1 -1
  241. package/dist/web.d.mts +7 -13
  242. package/dist/web.d.mts.map +1 -1
  243. package/dist/web.mjs +2 -2
  244. package/dist/web.mjs.map +1 -1
  245. package/package.json +13 -13
  246. package/dist/adapter-DL9JPcvC.d.mts.map +0 -1
  247. package/dist/allowed-hosts-BpKwviq5.d.mts.map +0 -1
  248. package/dist/app-module-Dk2Wenqx.d.mts.map +0 -1
  249. package/dist/application-BosHcuBZ.mjs +0 -14
  250. package/dist/application-BosHcuBZ.mjs.map +0 -1
  251. package/dist/application-D921r4MW.d.mts.map +0 -1
  252. package/dist/bootstrap-CY0v5VVF.mjs.map +0 -1
  253. package/dist/breach-padding-FBVGmcBb.d.mts.map +0 -1
  254. package/dist/cache-CdRHSXow.d.mts.map +0 -1
  255. package/dist/connect-BlIamapT.d.mts.map +0 -1
  256. package/dist/container-4iJdDkRH.d.mts +0 -3
  257. package/dist/context-Cgr5dtIZ.mjs.map +0 -1
  258. package/dist/context-errors-6x0bjldv.mjs.map +0 -1
  259. package/dist/contributor-runner-DQ2fXJ29.mjs.map +0 -1
  260. package/dist/core-g3y9VDwr.mjs +0 -12
  261. package/dist/core-g3y9VDwr.mjs.map +0 -1
  262. package/dist/cors-BlR_b0Qb.d.mts.map +0 -1
  263. package/dist/cron-BTGytNg-.d.mts.map +0 -1
  264. package/dist/csrf-DOAaYozG.d.mts.map +0 -1
  265. package/dist/decorate-LMK39Sn6.mjs +0 -13
  266. package/dist/decorate-LMK39Sn6.mjs.map +0 -1
  267. package/dist/decorators-DxNb5mWw.d.mts.map +0 -1
  268. package/dist/define-adapter-CZCFyDp5.mjs.map +0 -1
  269. package/dist/di-hooks-ZfnBZMDp.mjs.map +0 -1
  270. package/dist/error-handler-D7DLWe1Q.d.mts.map +0 -1
  271. package/dist/helmet-BVuVBl-D.d.mts.map +0 -1
  272. package/dist/index-Blgka75E.d.mts.map +0 -1
  273. package/dist/index-DP_I4puv.d.mts.map +0 -1
  274. package/dist/interfaces-C6LHcYsg.d.mts.map +0 -1
  275. package/dist/jobs-BTnyyRY1.mjs.map +0 -1
  276. package/dist/kv-stores-CwJdsMln.d.mts.map +0 -1
  277. package/dist/kv-stores-HUdUibOx.mjs.map +0 -1
  278. package/dist/logger-xE9qI_FS.d.mts.map +0 -1
  279. package/dist/observers-C4bWQTop.mjs.map +0 -1
  280. package/dist/path-CMwIHsdv.d.mts.map +0 -1
  281. package/dist/query-DXIo1mII.mjs.map +0 -1
  282. package/dist/rate-limit-DQDk6bAH.d.mts.map +0 -1
  283. package/dist/reactivity-DZrc3Yhu.d.mts.map +0 -1
  284. package/dist/request-id-Dn64nEHK.d.mts.map +0 -1
  285. package/dist/request-logger-TgcKRNDD.d.mts.map +0 -1
  286. package/dist/rolldown-runtime-Z3gdyCfQ.mjs +0 -11
  287. package/dist/route-flag-B1lQht6v.d.mts.map +0 -1
  288. package/dist/route-policy-DsdJx3bk.mjs.map +0 -1
  289. package/dist/router-builder-C5EtcFSL.d.mts.map +0 -1
  290. package/dist/router-builder-CiwYhiUM.mjs.map +0 -1
  291. package/dist/runtime-Bus9RVyU.mjs.map +0 -1
  292. package/dist/session-DQG72vCf.d.mts.map +0 -1
  293. package/dist/settings-CNZ7iRli.mjs.map +0 -1
  294. package/dist/settings-DgZLgcNU.d.mts.map +0 -1
  295. package/dist/upload-DnwvZQyi.d.mts.map +0 -1
  296. package/dist/url-for-BCQLTEJj.mjs +0 -12
  297. package/dist/url-for-BCQLTEJj.mjs.map +0 -1
  298. package/dist/validate-D4Poe2EE.d.mts.map +0 -1
  299. package/dist/view-renderer-Dbha_94K.mjs.map +0 -1
@@ -1,24 +1,38 @@
1
1
 
2
- import { a as SettingsDeclaration, c as VarOrigin, t as ConfigVar } from "./settings-DgZLgcNU.mjs";
3
- import "./index-DP_I4puv.mjs";
4
- import { Dt as ModuleFactory, E as RequestContext, Ft as ModuleRegistry, H as RouteName, Pt as KickPlugin, Q as AdapterFactory, W as UrlForArgs, Wt as ResponseInfo, Yt as ConditionOutcome, a as KickServer, b as RuntimeCapabilities, c as ActiveRuntime, d as HttpRuntime, h as RouteEntry, m as RouteContributor, r as AppAdapter, x as RuntimeResponse } from "./adapter-DL9JPcvC.mjs";
5
- import { a as ConnectRequest, i as ConnectNext, n as ConnectHandler, o as ConnectResponse } from "./connect-BlIamapT.mjs";
6
- import { t as Container } from "./container-4iJdDkRH.mjs";
7
- import { p as RouteFlags, s as RouteFlagDeclarations } from "./route-flag-B1lQht6v.mjs";
8
- import { C as MetaValue, c as ContextDecorator, h as DepValue, m as ContributorRegistrations, r as AppModuleEntry, u as ContextDecoratorSpec, x as ContextMetaKey } from "./app-module-Dk2Wenqx.mjs";
9
- import { l as PlatformContext, m as Reply } from "./kv-stores-CwJdsMln.mjs";
10
- import { t as ComputedRef } from "./reactivity-DZrc3Yhu.mjs";
11
- import { t as ValidationErrorFactory } from "./validate-D4Poe2EE.mjs";
12
- import { t as AllowedHostsOptions } from "./allowed-hosts-BpKwviq5.mjs";
13
- import { t as BuildRoutesOptions } from "./router-builder-C5EtcFSL.mjs";
14
- import "./error-handler-D7DLWe1Q.mjs";
15
- import "./csrf-DOAaYozG.mjs";
16
- import "./upload-DnwvZQyi.mjs";
2
+ import { a as SettingsDeclaration, c as VarOrigin, t as ConfigVar } from "./settings-CB6lh6_s.mjs";
3
+ import "./index-DoukvKwh.mjs";
4
+ import { Bt as ModuleRegistry, E as RequestContext, H as RouteName, Mt as ModuleFactory, W as UrlForArgs, Yt as ResponseInfo, a as KickServer, b as RuntimeCapabilities, c as ActiveRuntime, d as HttpRuntime, en as ConditionOutcome, h as RouteEntry, m as RouteContributor, r as AppAdapter, rt as AdapterFactory, x as RuntimeResponse, zt as KickPlugin } from "./adapter-D_nUmKEQ.mjs";
5
+ import { a as ConnectRequest, i as ConnectNext, n as ConnectHandler, o as ConnectResponse } from "./connect-DamOelO8.mjs";
6
+ import { t as Container } from "./container-DtdUiRwr.mjs";
7
+ import { p as RouteFlags, s as RouteFlagDeclarations } from "./route-flag-CjXQl-oX.mjs";
8
+ import { C as MetaValue, c as ContextDecorator, h as DepValue, m as ContributorRegistrations, r as AppModuleEntry, u as ContextDecoratorSpec, x as ContextMetaKey } from "./app-module-BmViGLgj.mjs";
9
+ import { l as PlatformContext, m as Reply } from "./kv-stores-DdGPLXQG.mjs";
10
+ import { t as ComputedRef } from "./reactivity-KZOrwVeK.mjs";
11
+ import { t as ValidationErrorFactory } from "./validate-CTgfm7oE.mjs";
12
+ import { t as AllowedHostsOptions } from "./allowed-hosts-BQlQFt-1.mjs";
13
+ import { t as BuildRoutesOptions } from "./router-builder-BkIW_qjz.mjs";
14
+ import "./error-handler-gZLQFHeE.mjs";
15
+ import "./csrf-8-Jknvmc.mjs";
16
+ import "./upload-O3VTcODy.mjs";
17
17
  import http, { IncomingMessage, ServerResponse } from "node:http";
18
18
  import https from "node:https";
19
19
  import tls from "node:tls";
20
20
  import { AsyncLocalStorage } from "node:async_hooks";
21
- //#region src/core/kick-error.d.ts
21
+ /** The fields of a {@link KickError}. */
22
+ interface KickErrorInit {
23
+ /** Short stable identifier (e.g. `KICK001`, `NO_PROVIDER`). */
24
+ code: string;
25
+ /** One-line headline. */
26
+ summary: string;
27
+ /** Multi-line explanation of why this happened. */
28
+ cause?: string;
29
+ /** Multi-line actionable fix — show exact code if possible. */
30
+ fix?: string;
31
+ /** Absolute URL to the docs page that covers this error. */
32
+ docsUrl?: string;
33
+ /** Arbitrary structured fields for log consumers / debug tooling. */
34
+ context?: Record<string, unknown>;
35
+ }
22
36
  /**
23
37
  * Structured framework error with code, cause, and actionable fix hint.
24
38
  *
@@ -35,21 +49,9 @@ import { AsyncLocalStorage } from "node:async_hooks";
35
49
  * Per-error factories live in `kick-errors.ts` — those are the public
36
50
  * entry points framework code uses. `KickError` is exported so adopters
37
51
  * can build their own structured errors using the same shape.
52
+ *
53
+ * @see https://kickjs.app/guide/error-handling
38
54
  */
39
- interface KickErrorInit {
40
- /** Short stable identifier (e.g. `KICK001`, `NO_PROVIDER`). */
41
- code: string;
42
- /** One-line headline. */
43
- summary: string;
44
- /** Multi-line explanation of why this happened. */
45
- cause?: string;
46
- /** Multi-line actionable fix — show exact code if possible. */
47
- fix?: string;
48
- /** Absolute URL to the docs page that covers this error. */
49
- docsUrl?: string;
50
- /** Arbitrary structured fields for log consumers / debug tooling. */
51
- context?: Record<string, unknown>;
52
- }
53
55
  declare class KickError extends Error {
54
56
  readonly code: string;
55
57
  readonly summary: string;
@@ -59,6 +61,7 @@ declare class KickError extends Error {
59
61
  readonly context?: Record<string, unknown>;
60
62
  constructor(init: KickErrorInit);
61
63
  }
64
+ /** Options for {@link formatKickError}. */
62
65
  interface FormatKickErrorOptions {
63
66
  /**
64
67
  * Render ANSI colour codes. Defaults to TTY detection (`NO_COLOR` /
@@ -73,26 +76,8 @@ interface FormatKickErrorOptions {
73
76
  * colour — the colour flag only toggles ANSI codes.
74
77
  */
75
78
  declare function formatKickError(err: KickErrorInit | KickError, options?: FormatKickErrorOptions): string;
76
- //#endregion
77
- //#region src/core/circuit-breaker.d.ts
78
- /**
79
- * Circuit Breaker pattern for external service calls.
80
- *
81
- * Protects your application from cascading failures when downstream
82
- * services are unhealthy by short-circuiting requests after a
83
- * configurable failure threshold.
84
- *
85
- * @example
86
- * ```ts
87
- * const breaker = new CircuitBreaker('payment-api', {
88
- * failureThreshold: 5,
89
- * resetTimeout: 30_000,
90
- * })
91
- *
92
- * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))
93
- * ```
94
- */
95
79
  type CircuitBreakerState = 'closed' | 'open' | 'half_open';
80
+ /** Options for {@link CircuitBreaker}. */
96
81
  interface CircuitBreakerOptions {
97
82
  /** Number of consecutive failures before the circuit opens. */
98
83
  failureThreshold: number;
@@ -101,6 +86,7 @@ interface CircuitBreakerOptions {
101
86
  /** Max requests allowed in HALF_OPEN state before deciding (default 1). */
102
87
  halfOpenMax?: number;
103
88
  }
89
+ /** What {@link CircuitBreaker.getStats} returns. */
104
90
  interface CircuitBreakerStats {
105
91
  failures: number;
106
92
  successes: number;
@@ -114,6 +100,25 @@ declare class CircuitOpenError extends Error {
114
100
  readonly breakerName: string;
115
101
  constructor(breakerName: string);
116
102
  }
103
+ /**
104
+ * Circuit Breaker pattern for external service calls.
105
+ *
106
+ * Protects your application from cascading failures when downstream
107
+ * services are unhealthy by short-circuiting requests after a
108
+ * configurable failure threshold.
109
+ *
110
+ * @example
111
+ * ```ts
112
+ * const breaker = new CircuitBreaker('payment-api', {
113
+ * failureThreshold: 5,
114
+ * resetTimeout: 30_000,
115
+ * })
116
+ *
117
+ * const result = await breaker.execute(() => fetch('https://payment.example.com/charge'))
118
+ * ```
119
+ *
120
+ * @see https://kickjs.app/guide/middleware
121
+ */
117
122
  declare class CircuitBreaker {
118
123
  readonly name: string;
119
124
  private state;
@@ -141,8 +146,6 @@ declare class CircuitBreaker {
141
146
  private onFailure;
142
147
  private maybeTransitionToHalfOpen;
143
148
  }
144
- //#endregion
145
- //#region src/core/context-errors.d.ts
146
149
  /**
147
150
  * Errors thrown by the Context Contributor pipeline.
148
151
  *
@@ -150,7 +153,7 @@ declare class CircuitBreaker {
150
153
  * `DuplicateContributorError` are startup-time errors raised during
151
154
  * pipeline build (topo-sort + validation), not per-request — a
152
155
  * misconfigured app fails to boot rather than fails a request. Per the
153
- * locked design in `architecture.md` §20.4, the pipeline is validated
156
+ * locked design in https://kickjs.app/guide/context-decorators, the pipeline is validated
154
157
  * once when each route is mounted and the resolved order is cached on
155
158
  * the route.
156
159
  *
@@ -196,7 +199,7 @@ declare class MissingContributorError extends Error {
196
199
  * than reaching this error at all. This error remains the backstop for
197
200
  * routes typegen couldn't prove (module/adapter/bootstrap registrations),
198
201
  * handlers typed as plain `RequestContext`, and contributors that ran but
199
- * resolved to `undefined`. See `architecture.md` §20.14.
202
+ * resolved to `undefined`. See https://kickjs.app/guide/context-decorators
200
203
  *
201
204
  * @example
202
205
  * ```text
@@ -229,7 +232,7 @@ declare class ContributorCycleError extends Error {
229
232
  /**
230
233
  * Two contributors at the same precedence level both produce the same key
231
234
  * for the same route. Precedence resolution (method > class > module >
232
- * adapter > global, per architecture.md §20.4) silently drops
235
+ * adapter > global, per https://kickjs.app/guide/context-decorators) silently drops
233
236
  * lower-precedence duplicates; this error fires only when ties occur
234
237
  * within a single level — e.g., two method-level decorators declaring
235
238
  * `key: 'tenant'`.
@@ -248,8 +251,6 @@ declare class DuplicateContributorError extends Error {
248
251
  readonly sources: readonly string[];
249
252
  constructor(key: string, sources: readonly string[]);
250
253
  }
251
- //#endregion
252
- //#region src/core/mount-sort.d.ts
253
254
  /**
254
255
  * Topological sort for plugins and adapters with `dependsOn` declarations.
255
256
  *
@@ -273,7 +274,7 @@ interface MountSortItem {
273
274
  /**
274
275
  * Other plugin/adapter names that must mount before this one. Cycles
275
276
  * and missing names fail at boot — same fail-fast contract as the
276
- * Context Contributor pipeline (architecture.md §20.4).
277
+ * Context Contributor pipeline.
277
278
  */
278
279
  dependsOn?: readonly string[];
279
280
  }
@@ -325,15 +326,16 @@ declare class MountCycleError extends Error {
325
326
  * @throws {MountCycleError} the dep graph contains a cycle
326
327
  */
327
328
  declare function mountSort<T extends MountSortItem>(items: readonly T[], kind: MountKind): T[];
328
- //#endregion
329
- //#region src/core/asset-keys.d.ts
329
+ /** How asset keys are made from file paths: `'strip'` drops the extension, `'with-extension'` keeps it, `'auto'` keeps it only when two files would share a key. */
330
330
  type AssetKeyStrategy = 'auto' | 'strip' | 'with-extension';
331
+ /** One file's source-relative path and its manifest key. */
331
332
  interface AssetKeyPair {
332
333
  /** Source-relative path the file was discovered at. */
333
334
  rel: string;
334
335
  /** Final logical key for the manifest, including the namespace prefix. */
335
336
  key: string;
336
337
  }
338
+ /** Options for `groupAssetKeys()`. */
337
339
  interface GroupAssetKeysOptions {
338
340
  /**
339
341
  * Strategy applied to this namespace. Default `'auto'`.
@@ -344,6 +346,7 @@ interface GroupAssetKeysOptions {
344
346
  */
345
347
  strategy?: AssetKeyStrategy;
346
348
  }
349
+ /** What `groupAssetKeys()` returns: the path/key pairs, and how many key collisions `'auto'` resolved by keeping extensions. */
347
350
  interface GroupAssetKeysResult {
348
351
  pairs: AssetKeyPair[];
349
352
  /**
@@ -368,8 +371,9 @@ interface GroupAssetKeysResult {
368
371
  declare function groupAssetKeys(namespace: string, paths: readonly string[], opts?: GroupAssetKeysOptions): GroupAssetKeysResult;
369
372
  /** Strip the final extension from a path. `'mails/welcome.ejs'` → `'mails/welcome'`. */
370
373
  declare function stripExt(path: string): string;
371
- //#endregion
372
- //#region src/core/route-policy.d.ts
374
+ /**
375
+ * Route flags by method and path, for middleware that runs before route matching. Each mounted route is added at boot; `lookup(method, pathname)` returns the flags of the first matching route, or an empty map. One table per Application; middleware gets it through {@link bindRoutePolicy}.
376
+ */
373
377
  declare class RoutePolicyTable {
374
378
  /** Bucketed by method: an incoming request only scans its own verb. */
375
379
  private readonly byMethod;
@@ -393,8 +397,6 @@ declare class RoutePolicyTable {
393
397
  declare function bindRoutePolicy<T extends object>(handler: T, receive: (table: RoutePolicyTable) => void): T;
394
398
  /** Hand the table to a middleware if it declared the slot. */
395
399
  declare function offerRoutePolicy(handler: unknown, table: RoutePolicyTable): void;
396
- //#endregion
397
- //#region src/http/startup-timeline.d.ts
398
400
  /**
399
401
  * Where startup time goes: each phase of `setup()` / `start()`, and each
400
402
  * adapter hook on its own, so "boot got slow" points at a name.
@@ -407,12 +409,11 @@ interface StartupStep {
407
409
  name: string;
408
410
  ms: number;
409
411
  }
412
+ /** What `app.getStartupTimeline()` returns: total boot time and each timed step, in milliseconds. */
410
413
  interface StartupTimelineSnapshot {
411
414
  totalMs: number;
412
415
  steps: readonly StartupStep[];
413
416
  }
414
- //#endregion
415
- //#region src/http/startup-checks.d.ts
416
417
  /** One finding. `error` fails startup; `warning` is logged. */
417
418
  interface CheckMessage {
418
419
  /** Stable ID, e.g. `'KICK-SEC-W001'` — what `silenceChecks` matches. */
@@ -433,6 +434,7 @@ interface CheckContext {
433
434
  }>;
434
435
  production: boolean;
435
436
  }
437
+ /** A check run at boot against the app's options and mounted routes. Create one with {@link defineCheck} and pass it in `bootstrap({ checks })`. */
436
438
  interface StartupCheck {
437
439
  /** Names the check in logs; its messages carry their own IDs. */
438
440
  name: string;
@@ -447,8 +449,11 @@ declare class StartupCheckError extends Error {
447
449
  readonly messages: CheckMessage[];
448
450
  constructor(messages: CheckMessage[]);
449
451
  }
450
- //#endregion
451
- //#region src/http/cache-response.d.ts
452
+ /**
453
+ * Options for {@link CacheResponse}.
454
+ *
455
+ * @see https://kickjs.app/guide/caching#caching-whole-responses
456
+ */
452
457
  interface CacheResponseOptions {
453
458
  /** Seconds a stored response is served as fresh. */
454
459
  maxAge: number;
@@ -479,9 +484,31 @@ interface CacheResponseOptions {
479
484
  */
480
485
  key?: string | ((ctx: RequestContext) => string | null);
481
486
  }
487
+ /**
488
+ * Caches a route's whole response for `maxAge` seconds, answers `304` on a
489
+ * matching ETag, and with `swr` serves a stale copy while one request
490
+ * rebuilds it. Only `200` responses are stored. With the default or a string
491
+ * key, requests that identify the caller skip the cache unless the header is
492
+ * listed in `varies`; a `key` function skips that check, so it must include
493
+ * the user or tenant when the response depends on them.
494
+ *
495
+ * @example
496
+ * ```ts
497
+ * `@CacheResponse({ maxAge: 60, swr: 300, varies: ['accept-language'] })`
498
+ * `@Get('/')`
499
+ * list(ctx: RequestContext) {
500
+ * // …
501
+ * }
502
+ * ```
503
+ *
504
+ * @see https://kickjs.app/guide/caching
505
+ */
482
506
  declare function CacheResponse(options: CacheResponseOptions): MethodDecorator;
483
- //#endregion
484
- //#region src/http/metrics.d.ts
507
+ /**
508
+ * Options for {@link metricsAdapter}.
509
+ *
510
+ * @see https://kickjs.app/guide/deployment#metrics
511
+ */
485
512
  interface MetricsOptions {
486
513
  /** Where to serve the metrics. Default `/metrics`. */
487
514
  path?: string;
@@ -522,8 +549,6 @@ declare class RequestHistogram {
522
549
  * ```
523
550
  */
524
551
  declare function metricsAdapter(options?: MetricsOptions): AppAdapter;
525
- //#endregion
526
- //#region src/http/body-policy.d.ts
527
552
  /**
528
553
  * Set to `true` on a request (`req[RAW_BODY] = true`) by middleware that will
529
554
  * read the body stream itself — a tus endpoint, a proxy — so the 415 below
@@ -531,8 +556,6 @@ declare function metricsAdapter(options?: MetricsOptions): AppAdapter;
531
556
  * consume it later.
532
557
  */
533
558
  declare const RAW_BODY: unique symbol;
534
- //#endregion
535
- //#region src/http/cron-adapter.d.ts
536
559
  /** Set by the cluster primary on the one worker that runs `KickCronAdapter` jobs. */
537
560
  declare const CRON_WORKER_ENV = "KICK_CRON_WORKER";
538
561
  /** A running schedule, as {@link CronScheduler} returns it. */
@@ -560,17 +583,41 @@ interface CronSchedule {
560
583
  type CronScheduler = (expression: string, options: {
561
584
  timezone?: string;
562
585
  }, tick: () => void) => CronSchedule;
586
+ /**
587
+ * Options for {@link KickCronAdapter}.
588
+ *
589
+ * @see https://kickjs.app/guide/cron
590
+ */
563
591
  interface CronAdapterOptions {
564
592
  /** Off for processes that should run no jobs (replicas, one-off scripts). Default `true`. */
565
593
  enabled?: boolean;
566
594
  /** The scheduler that drives the jobs. Default: `croner`, which must then be installed. */
567
595
  schedule?: CronScheduler;
568
596
  }
597
+ /**
598
+ * Runs every `@Cron()` method of the app's services on its schedule, after
599
+ * the server starts. Uses `croner` unless `schedule` brings another
600
+ * scheduler; `enabled: false` turns it off for a process. Under a cluster
601
+ * only one process runs the jobs.
602
+ *
603
+ * @example
604
+ * ```ts
605
+ * // pnpm add croner — or pass `schedule`
606
+ * bootstrap({ modules, adapters: [KickCronAdapter()] })
607
+ * ```
608
+ *
609
+ * @see https://kickjs.app/guide/cron
610
+ */
569
611
  declare const KickCronAdapter: AdapterFactory<CronAdapterOptions, unknown>;
570
- //#endregion
571
- //#region src/http/tracing.d.ts
612
+ /**
613
+ * `node:diagnostics_channel` tracing channel wrapping each route handler. Subscribers receive a {@link HandlerTraceContext}.
614
+ *
615
+ * @see https://kickjs.app/guide/observability#the-channels
616
+ */
572
617
  declare const HANDLER_CHANNEL = "kickjs:handler";
618
+ /** `node:diagnostics_channel` channel that publishes each reported error with its {@link ErrorInfo} fields. */
573
619
  declare const ERROR_CHANNEL = "kickjs:error";
620
+ /** `node:diagnostics_channel` channel that publishes a {@link ResponseInfo} for each finished response. */
574
621
  declare const RESPONSE_CHANNEL = "kickjs:response";
575
622
  /** What subscribers to `kickjs:handler` receive. */
576
623
  interface HandlerTraceContext {
@@ -582,8 +629,6 @@ interface HandlerTraceContext {
582
629
  requestId?: string;
583
630
  ctx: RequestContext;
584
631
  }
585
- //#endregion
586
- //#region src/http/bootstrap.d.ts
587
632
  /**
588
633
  * Bootstrap a KickJS application.
589
634
  *
@@ -605,8 +650,6 @@ interface HandlerTraceContext {
605
650
  * ```
606
651
  */
607
652
  declare function bootstrap(options: ApplicationOptions): Promise<Application>;
608
- //#endregion
609
- //#region src/http/handler.d.ts
610
653
  /** A KickJS app exposed as request handlers. See {@link createHandler}. */
611
654
  interface KickHandler {
612
655
  /**
@@ -670,8 +713,7 @@ interface KickHandler {
670
713
  * ```
671
714
  */
672
715
  declare function createHandler(options: ApplicationOptions | (() => Promise<unknown>)): KickHandler;
673
- //#endregion
674
- //#region src/http/cluster.d.ts
716
+ /** Options for {@link setupClusterPrimary}: worker count, shutdown timeout and restart limits. */
675
717
  interface ClusterOptions {
676
718
  /** Number of worker processes (default: os.cpus().length) */
677
719
  workers?: number;
@@ -686,8 +728,6 @@ interface ClusterOptions {
686
728
  }
687
729
  /** Returns true if the current process is the cluster primary */
688
730
  declare function isClusterPrimary(): boolean;
689
- //#endregion
690
- //#region src/http/define-http-context-decorator.d.ts
691
731
  /**
692
732
  * Curried form returned by {@link DefineHttpContextDecoratorFn.withParams}.
693
733
  * Spell only the per-call params shape `P`; `K` and `D` are inferred
@@ -720,9 +760,20 @@ interface DefineHttpContextDecoratorFn {
720
760
  */
721
761
  withParams<P extends Record<string, unknown>>(): DefineHttpContextDecoratorWithParams<P>;
722
762
  }
763
+ /**
764
+ * `defineContextDecorator` with the resolver's context typed as `RequestContext`, so `resolve` can read `ctx.req`, `ctx.headers` and `ctx.params` without generics. Use `.withParams<P>()()` for a parameterised decorator.
765
+ *
766
+ * @example
767
+ * ```ts
768
+ * const LoadTenant = defineHttpContextDecorator({
769
+ * key: 'tenant',
770
+ * resolve: (ctx) => ({ id: ctx.req.headers['x-tenant-id'] as string }),
771
+ * })
772
+ * ```
773
+ *
774
+ * @see https://kickjs.app/guide/context-decorators
775
+ */
723
776
  declare const defineHttpContextDecorator: DefineHttpContextDecoratorFn;
724
- //#endregion
725
- //#region src/core/password.d.ts
726
777
  /** scrypt cost. Memory per hash is `128 * N * r` bytes. */
727
778
  interface PasswordHashOptions {
728
779
  /** CPU/memory cost, a power of two. Default `2 ** 14`. */
@@ -792,8 +843,11 @@ interface VerifyPasswordOptions extends PasswordHashOptions {
792
843
  * `options.legacy` reads it.
793
844
  */
794
845
  declare function verifyPassword(password: string, stored: string | null | undefined, options?: VerifyPasswordOptions): Promise<PasswordCheck>;
795
- //#endregion
796
- //#region src/core/signing.d.ts
846
+ /**
847
+ * Options for {@link createSigner}.
848
+ *
849
+ * @see https://kickjs.app/guide/passwords-and-tokens
850
+ */
797
851
  interface SignerOptions {
798
852
  /**
799
853
  * The signing secret. Pass a list to rotate: the first signs, every one
@@ -807,6 +861,7 @@ interface SignerOptions {
807
861
  */
808
862
  salt: string;
809
863
  }
864
+ /** Options for {@link Signer.verify}. */
810
865
  interface VerifyOptions {
811
866
  /** Reject tokens older than this, in milliseconds. */
812
867
  maxAge?: number;
@@ -820,6 +875,11 @@ type SignedCheck<T> = {
820
875
  ok: false;
821
876
  reason: 'invalid' | 'expired';
822
877
  };
878
+ /**
879
+ * Signs values into tamper-proof tokens and verifies them. Create one per purpose with {@link createSigner}.
880
+ *
881
+ * @see https://kickjs.app/guide/passwords-and-tokens
882
+ */
823
883
  interface Signer {
824
884
  /** Sign a JSON-serialisable value: `payload.timestamp.signature`, URL-safe. */
825
885
  sign(value: unknown): string;
@@ -828,8 +888,6 @@ interface Signer {
828
888
  }
829
889
  /** Create a signer for one purpose. */
830
890
  declare function createSigner(options: SignerOptions): Signer;
831
- //#endregion
832
- //#region src/http/form.d.ts
833
891
  /**
834
892
  * Form state that outlives a redirect: flash messages, field errors and the
835
893
  * values a failed submit sent, kept in the session for the next page. The
@@ -839,7 +897,9 @@ declare function createSigner(options: SignerOptions): Signer;
839
897
  * @module @forinda/kickjs/http/form
840
898
  */
841
899
  declare const FLASH_KEY = "__inertia_flash";
900
+ /** Session key holding a failed form's field errors for the next page. */
842
901
  declare const FORM_ERRORS_KEY = "__inertia_errors";
902
+ /** Session key holding the values a failed form submitted, to refill the form. */
843
903
  declare const OLD_INPUT_KEY = "__kick_old";
844
904
  /** The last full page this session rendered: where a failed form goes back to. */
845
905
  declare const PREVIOUS_URL_KEY = "__inertia_previous";
@@ -868,9 +928,13 @@ declare function oldInput(body: unknown, limits?: {
868
928
  field?: number;
869
929
  total?: number;
870
930
  }): Record<string, string | string[]> | undefined;
871
- //#endregion
872
- //#region src/http/middleware/form-errors.d.ts
931
+ /** An error handler in the shape `bootstrap({ onError })` takes; what {@link formErrorHandler} returns and wraps. */
873
932
  type FormErrorHandler = (err: any, req: any, res: RuntimeResponse, next: (err?: unknown) => void) => unknown;
933
+ /**
934
+ * Options for {@link formErrorHandler}.
935
+ *
936
+ * @see https://kickjs.app/guide/views
937
+ */
874
938
  interface FormErrorHandlerOptions {
875
939
  /** Where to go back to when the `Referer` is missing or another site's. Default `'/'`. */
876
940
  fallbackUrl?: string;
@@ -881,8 +945,6 @@ interface FormErrorHandlerOptions {
881
945
  * to carry the errors; without it, a failed form post gets the fallback's 422.
882
946
  */
883
947
  declare function formErrorHandler(fallback?: FormErrorHandler, options?: FormErrorHandlerOptions): FormErrorHandler;
884
- //#endregion
885
- //#region src/http/runtimes/express-lazy.d.ts
886
948
  /** The default HTTP runtime; Express loads on the Application's first setup. */
887
949
  declare function expressRuntime(): HttpRuntime;
888
950
  /**
@@ -896,8 +958,6 @@ declare function materializeRouter(entries: RouteEntry[]): ConnectHandler;
896
958
  * router on the first request.
897
959
  */
898
960
  declare function buildRoutes(controllerClass: any, options?: BuildRoutesOptions): ConnectHandler;
899
- //#endregion
900
- //#region src/http/request-store.d.ts
901
961
  /** Per-request storage for REQUEST-scoped DI and request context propagation */
902
962
  interface RequestStore {
903
963
  /** Unique request identifier */
@@ -915,8 +975,7 @@ interface RequestStore {
915
975
  * execution context constructed for the same request, regardless of
916
976
  * which middleware/contributor wrote it.
917
977
  *
918
- * Keys are constrained to `string` per the locked decision in
919
- * `architecture.md` §20.12 (#4); the value type is `unknown` because
978
+ * Keys are `string`; the value type is `unknown` because
920
979
  * the concrete shape at each key is determined by the consumer's
921
980
  * `ContextMeta` augmentation, not by the store itself.
922
981
  *
@@ -966,8 +1025,6 @@ declare function getRequestStore(): RequestStore;
966
1025
  * ```
967
1026
  */
968
1027
  declare function getRequestValue<K extends ContextMetaKey>(key: K): MetaValue<K> | undefined;
969
- //#endregion
970
- //#region src/http/middleware/request-scope.d.ts
971
1028
  /**
972
1029
  * Wraps each request in an AsyncLocalStorage context.
973
1030
  * Enables REQUEST-scoped DI and automatic requestId propagation to logs.
@@ -977,13 +1034,16 @@ declare function getRequestValue<K extends ContextMetaKey>(key: K): MetaValue<K>
977
1034
  * or the user already includes one in their middleware list.
978
1035
  */
979
1036
  declare function requestScopeMiddleware(): (req: ConnectRequest, res: ConnectResponse, next: ConnectNext) => void;
980
- //#endregion
981
- //#region src/http/middleware/trace-context.d.ts
982
1037
  /**
983
1038
  * W3C Trace Context header name.
984
1039
  * @see https://www.w3.org/TR/trace-context/#traceparent-header
985
1040
  */
986
1041
  declare const TRACEPARENT_HEADER = "traceparent";
1042
+ /**
1043
+ * Options for {@link traceContext}.
1044
+ *
1045
+ * @see https://kickjs.app/guide/middleware
1046
+ */
987
1047
  interface TraceContextOptions {
988
1048
  /**
989
1049
  * When true, respond with a `traceresponse` header containing the trace ID.
@@ -1031,8 +1091,11 @@ declare function parseTraceparent(header: string): TraceContext | null;
1031
1091
  * ```
1032
1092
  */
1033
1093
  declare function traceContext(options?: TraceContextOptions): (req: ConnectRequest, res: ConnectResponse, next: ConnectNext) => void;
1034
- //#endregion
1035
- //#region src/http/middleware/views.d.ts
1094
+ /**
1095
+ * Options for {@link ViewAdapter}.
1096
+ *
1097
+ * @see https://kickjs.app/guide/view-engines
1098
+ */
1036
1099
  interface ViewAdapterOptions {
1037
1100
  /**
1038
1101
  * Template engine — pass the engine module or a render function.
@@ -1069,7 +1132,7 @@ interface ViewAdapterOptions {
1069
1132
  *
1070
1133
  * Migrated to the `defineAdapter()` factory in v4 — call without `new`.
1071
1134
  * The pre-v4 `new ViewAdapter({...})` form is gone; see
1072
- * `docs/guide/migration-v3-to-v4.md` for the rename.
1135
+ * https://kickjs.app/guide/migration-v3-to-v4#viewadapter-—-drop-the-new-keyword
1073
1136
  *
1074
1137
  * @example
1075
1138
  * ```ts
@@ -1099,8 +1162,11 @@ declare const ViewAdapter: AdapterFactory<ViewAdapterOptions, unknown>;
1099
1162
  * `copyDirs` copies it). Express tries them in order.
1100
1163
  */
1101
1164
  declare function viewDirs(viewsDir: string): string[];
1102
- //#endregion
1103
- //#region src/http/middleware/spa.d.ts
1165
+ /**
1166
+ * Options for {@link SpaAdapter}.
1167
+ *
1168
+ * @see https://kickjs.app/guide/spa
1169
+ */
1104
1170
  interface SpaAdapterOptions {
1105
1171
  /**
1106
1172
  * Directory containing the built SPA files (index.html, assets, etc.)
@@ -1224,10 +1290,10 @@ declare function resolveClientDir(clientDir: string, cwd?: string, entry?: strin
1224
1290
  * style.css
1225
1291
  * server/ ← KickJS server
1226
1292
  * ```
1293
+ *
1294
+ * @see https://kickjs.app/guide/spa
1227
1295
  */
1228
1296
  declare const SpaAdapter: AdapterFactory<SpaAdapterOptions, unknown>;
1229
- //#endregion
1230
- //#region src/http/health-module.d.ts
1231
1297
  /** One adapter's answer to `onHealthCheck()`. */
1232
1298
  interface HealthCheckResult {
1233
1299
  name: string;
@@ -1250,6 +1316,7 @@ interface HealthProbe {
1250
1316
  /** Aggregated `onHealthCheck()` results from every adapter that has one. */
1251
1317
  checks(): Promise<HealthCheckResult[]>;
1252
1318
  }
1319
+ /** DI token for the {@link HealthProbe} that {@link HealthController} reads. */
1253
1320
  declare const HEALTH_PROBE: import("@forinda/kickjs-di").InjectionToken<HealthProbe>;
1254
1321
  /** Config for {@link healthModule}. */
1255
1322
  interface HealthModuleConfig {
@@ -1277,6 +1344,11 @@ interface HealthModuleConfig {
1277
1344
  */
1278
1345
  checkTimeout?: number;
1279
1346
  }
1347
+ /**
1348
+ * Serves `GET /health/live` and `GET /health/ready`. Liveness stays 200 while the app drains; readiness answers 503 while starting or draining, or when any adapter's `onHealthCheck()` is not `up`.
1349
+ *
1350
+ * @see https://kickjs.app/guide/deployment#behind-a-load-balancer-or-on-kubernetes
1351
+ */
1280
1352
  declare class HealthController {
1281
1353
  private readonly probe;
1282
1354
  constructor(probe: HealthProbe);
@@ -1307,8 +1379,6 @@ declare class HealthController {
1307
1379
  * both probes — see {@link HealthModuleConfig}.
1308
1380
  */
1309
1381
  declare const healthModule: ModuleFactory<HealthModuleConfig, unknown>;
1310
- //#endregion
1311
- //#region src/http/application.d.ts
1312
1382
  /**
1313
1383
  * A middleware entry in the declarative pipeline.
1314
1384
  * Can be a bare handler or an object with path scoping.
@@ -1385,12 +1455,17 @@ interface ConfigDescription {
1385
1455
  interface ConfigOrigins {
1386
1456
  /** The app's env schema. */
1387
1457
  env: VarOrigin[];
1388
- /** The settings sections the app bound, in binding order. */
1458
+ /**
1459
+ * The settings sections the app bound, in binding order, then the ones it
1460
+ * declared optional and didn't bind (`optional: true`).
1461
+ */
1389
1462
  sections: Array<{
1390
1463
  prefix: string;
1464
+ optional?: true;
1391
1465
  vars: VarOrigin[];
1392
1466
  }>;
1393
1467
  }
1468
+ /** Options for `bootstrap()` and `new Application()`: modules, middleware, adapters, plugins, runtime and server settings. */
1394
1469
  interface ApplicationOptions {
1395
1470
  /**
1396
1471
  * Feature modules to load. Accepts both class form
@@ -1578,7 +1653,7 @@ interface ApplicationOptions {
1578
1653
  * `@forinda/kickjs/fastify`) or a custom engine driver. Defaults to
1579
1654
  * {@link expressRuntime}. The engine-native escape hatches
1580
1655
  * (`getRuntimeApp()`, `AdapterContext.app`) follow the active runtime via the
1581
- * registry (`ActiveRuntime`, spec §4.3b) — Express by default, or the augmented
1656
+ * registry (`ActiveRuntime`) — Express by default, or the augmented
1582
1657
  * engine once the `kick/runtime` typegen output is present.
1583
1658
  */
1584
1659
  /**
@@ -1844,6 +1919,15 @@ interface ManagementOptions {
1844
1919
  */
1845
1920
  tls?: tls.SecureContextOptions & tls.TlsOptions;
1846
1921
  }
1922
+ /**
1923
+ * A KickJS app: loads modules, adapters and plugins into the DI container,
1924
+ * mounts their routes on the HTTP runtime, and runs the lifecycle
1925
+ * (`setup`, `start`, `rebuild`, `shutdown`). `bootstrap()`,
1926
+ * `createHandler()` and `createTestApp()` create one; construct it directly
1927
+ * when you drive the lifecycle yourself.
1928
+ *
1929
+ * @see https://kickjs.app/guide/lifecycle
1930
+ */
1847
1931
  declare class Application {
1848
1932
  private readonly options;
1849
1933
  private app;
@@ -1879,6 +1963,8 @@ declare class Application {
1879
1963
  /** Settings prefixes bound in this setup, across its two binding phases. */
1880
1964
  private settingsPrefixes;
1881
1965
  private settingsProvided;
1966
+ /** Sections declared with `.optional()`: listed by configOrigins(), never bound. */
1967
+ private settingsOptional;
1882
1968
  private handlerFor?;
1883
1969
  private readonly adapters;
1884
1970
  /**
@@ -2116,7 +2202,7 @@ declare class Application {
2116
2202
  getAdapters(): AppAdapter[];
2117
2203
  /**
2118
2204
  * Get registered plugins — used by DevToolsAdapter for topology
2119
- * introspection (architecture.md §23). Read-only; returns the
2205
+ * introspection (https://kickjs.app/guide/devtools). Read-only; returns the
2120
2206
  * already-sorted plugin list (post-`dependsOn` topo-sort).
2121
2207
  */
2122
2208
  getPlugins(): readonly KickPlugin[];
@@ -2190,6 +2276,5 @@ declare class Application {
2190
2276
  * how many there are under their common prefix, so `/_debug`'s dozens stay one line.
2191
2277
  */
2192
2278
  declare function describeRoutes(routes: readonly MountedRouteInfo[]): string[];
2193
- //#endregion
2194
2279
  export { createSigner as $, CircuitBreaker as $t, requestScopeMiddleware as A, StartupCheckError as At, formErrorHandler as B, GroupAssetKeysResult as Bt, ViewAdapterOptions as C, RequestHistogram as Ct, TraceContextOptions as D, CheckContext as Dt, TraceContext as E, CacheResponseOptions as Et, buildRoutes as F, bindRoutePolicy as Ft, SECRET_FIELD as G, MountCycleError as Gt, FORM_ERRORS_KEY as H, stripExt as Ht, expressRuntime as I, offerRoutePolicy as It, oldInput as J, mountSort as Jt, fieldErrors as K, MountKind as Kt, materializeRouter as L, AssetKeyPair as Lt, getRequestStore as M, StartupStep as Mt, getRequestValue as N, StartupTimelineSnapshot as Nt, parseTraceparent as O, CheckMessage as Ot, requestStore as P, RoutePolicyTable as Pt, VerifyOptions as Q, MissingContributorError as Qt, FormErrorHandler as R, AssetKeyStrategy as Rt, ViewAdapter as S, MetricsOptions as St, TRACEPARENT_HEADER as T, CacheResponse as Tt, OLD_INPUT_KEY as U, DuplicateMountNameError as Ut, FLASH_KEY as V, groupAssetKeys as Vt, PREVIOUS_URL_KEY as W, MissingMountDepError as Wt, Signer as X, DuplicateContributorError as Xt, SignedCheck as Y, ContributorCycleError as Yt, SignerOptions as Z, MissingContextValueError as Zt, HealthProbe as _, CronAdapterOptions as _t, ConfigDescription as a, KickError as an, verifyPassword as at, SpaAdapterOptions as b, KickCronAdapter as bt, MiddlewareEntry as c, isClusterPrimary as ct, ShutdownOptions as d, bootstrap as dt, CircuitBreakerOptions as en, LegacyHasher as et, describeRoutes as f, ERROR_CHANNEL as ft, HealthModuleConfig as g, CRON_WORKER_ENV as gt, HealthController as h, RESPONSE_CHANNEL as ht, ApplicationOptions as i, FormatKickErrorOptions as in, hashPassword as it, RequestStore as j, defineCheck as jt, traceContext as k, StartupCheck as kt, MountedRouteInfo as l, KickHandler as lt, HealthCheckResult as m, HandlerTraceContext as mt, AppStatus as n, CircuitBreakerStats as nn, PasswordHashOptions as nt, ConfigOrigins as o, KickErrorInit as on, defineHttpContextDecorator as ot, HEALTH_PROBE as p, HANDLER_CHANNEL as pt, flash as q, MountSortItem as qt, Application as r, CircuitOpenError as rn, VerifyPasswordOptions as rt, ManagementOptions as s, formatKickError as sn, ClusterOptions as st, APPLICATION as t, CircuitBreakerState as tn, PasswordCheck as tt, ServerOptions as u, createHandler as ut, healthModule as v, CronSchedule as vt, viewDirs as w, metricsAdapter as wt, resolveClientDir as x, RAW_BODY as xt, SpaAdapter as y, CronScheduler as yt, FormErrorHandlerOptions as z, GroupAssetKeysOptions as zt };
2195
- //# sourceMappingURL=application-D921r4MW.d.mts.map
2280
+ //# sourceMappingURL=application-ClCq0AgY.d.mts.map