@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.
- package/dist/{adapter-DL9JPcvC.d.mts → adapter-D_nUmKEQ.d.mts} +175 -77
- package/dist/adapter-D_nUmKEQ.d.mts.map +1 -0
- package/dist/{allowed-hosts-BpKwviq5.d.mts → allowed-hosts-BQlQFt-1.d.mts} +7 -4
- package/dist/allowed-hosts-BQlQFt-1.d.mts.map +1 -0
- package/dist/{app-module-Dk2Wenqx.d.mts → app-module-BmViGLgj.d.mts} +7 -13
- package/dist/app-module-BmViGLgj.d.mts.map +1 -0
- package/dist/application-B16ltRnC.mjs +14 -0
- package/dist/application-B16ltRnC.mjs.map +1 -0
- package/dist/{application-D921r4MW.d.mts → application-ClCq0AgY.d.mts} +200 -115
- package/dist/application-ClCq0AgY.d.mts.map +1 -0
- package/dist/{body-policy-CwgUYBw7.mjs → body-policy-D8LveWmO.mjs} +2 -2
- package/dist/{body-policy-CwgUYBw7.mjs.map → body-policy-D8LveWmO.mjs.map} +1 -1
- package/dist/{bootstrap-CY0v5VVF.mjs → bootstrap-C5NvsxHQ.mjs} +3 -3
- package/dist/bootstrap-C5NvsxHQ.mjs.map +1 -0
- package/dist/{bounded-counters-CF8EnVUm.mjs → bounded-counters-BtvB2daV.mjs} +2 -2
- package/dist/{bounded-counters-CF8EnVUm.mjs.map → bounded-counters-BtvB2daV.mjs.map} +1 -1
- package/dist/{breach-padding-FBVGmcBb.d.mts → breach-padding-BUuc21Eu.d.mts} +7 -4
- package/dist/breach-padding-BUuc21Eu.d.mts.map +1 -0
- package/dist/{cache-CdRHSXow.d.mts → cache-ByX5O2Hp.d.mts} +26 -3
- package/dist/cache-ByX5O2Hp.d.mts.map +1 -0
- package/dist/{client-ip-CpEuptqr.mjs → client-ip-CWvyHmqt.mjs} +2 -2
- package/dist/{client-ip-CpEuptqr.mjs.map → client-ip-CWvyHmqt.mjs.map} +1 -1
- package/dist/config/index.d.mts +6 -1
- package/dist/config/index.mjs +2 -2
- package/dist/{config-Djisd0f5.mjs → config-BIQoDNil.mjs} +3 -3
- package/dist/{config-Djisd0f5.mjs.map → config-BIQoDNil.mjs.map} +1 -1
- package/dist/{connect-BlIamapT.d.mts → connect-DamOelO8.d.mts} +1 -3
- package/dist/connect-DamOelO8.d.mts.map +1 -0
- package/dist/container-DtdUiRwr.d.mts +3 -0
- package/dist/{context-Cgr5dtIZ.mjs → context-BzFNflxV.mjs} +3 -3
- package/dist/context-BzFNflxV.mjs.map +1 -0
- package/dist/{context-errors-6x0bjldv.mjs → context-errors-BmaG4vwd.mjs} +2 -2
- package/dist/context-errors-BmaG4vwd.mjs.map +1 -0
- package/dist/{contributor-runner-DQ2fXJ29.mjs → contributor-runner-BnJzu2GI.mjs} +3 -3
- package/dist/contributor-runner-BnJzu2GI.mjs.map +1 -0
- package/dist/core/adapter.d.mts +1 -1
- package/dist/core/adapter.mjs +1 -1
- package/dist/core/app-module.d.mts +1 -1
- package/dist/core/app-module.mjs +1 -1
- package/dist/core/cache.d.mts +1 -1
- package/dist/core/cache.mjs +1 -1
- package/dist/core/cache.mjs.map +1 -1
- package/dist/core/container.d.mts +1 -1
- package/dist/core/container.mjs +2 -2
- package/dist/core/cron.d.mts +1 -1
- package/dist/core/cron.mjs +2 -2
- package/dist/core/cron.mjs.map +1 -1
- package/dist/core/decorators.d.mts +1 -1
- package/dist/core/decorators.mjs +2 -2
- package/dist/core/decorators.mjs.map +1 -1
- package/dist/core/errors.d.mts +1 -1
- package/dist/core/errors.mjs +1 -1
- package/dist/core/errors.mjs.map +1 -1
- package/dist/core/interfaces.d.mts +1 -1
- package/dist/core/interfaces.mjs +1 -1
- package/dist/core/interfaces.mjs.map +1 -1
- package/dist/core/logger.d.mts +1 -1
- package/dist/core/logger.mjs +1 -1
- package/dist/core/logger.mjs.map +1 -1
- package/dist/core/path.d.mts +1 -1
- package/dist/core/path.mjs +1 -1
- package/dist/core/path.mjs.map +1 -1
- package/dist/core/plugin.d.mts +1 -1
- package/dist/core/plugin.mjs +1 -1
- package/dist/core/reactivity.d.mts +1 -1
- package/dist/core/reactivity.mjs +2 -2
- package/dist/core/reactivity.mjs.map +1 -1
- package/dist/core-Dqzah_BX.mjs +12 -0
- package/dist/core-Dqzah_BX.mjs.map +1 -0
- package/dist/{cors-BlR_b0Qb.d.mts → cors-u1OwTxQ8.d.mts} +7 -4
- package/dist/cors-u1OwTxQ8.d.mts.map +1 -0
- package/dist/{cron-BTGytNg-.d.mts → cron-Bxm2MY8u.d.mts} +10 -3
- package/dist/cron-Bxm2MY8u.d.mts.map +1 -0
- package/dist/{csrf-DOAaYozG.d.mts → csrf-8-Jknvmc.d.mts} +14 -6
- package/dist/csrf-8-Jknvmc.d.mts.map +1 -0
- package/dist/decorate-C3to8dG-.mjs +13 -0
- package/dist/decorate-C3to8dG-.mjs.map +1 -0
- package/dist/{decorators-DxNb5mWw.d.mts → decorators-Bflncyz6.d.mts} +122 -10
- package/dist/decorators-Bflncyz6.d.mts.map +1 -0
- package/dist/{define-adapter-CZCFyDp5.mjs → define-adapter-DCjNTP6m.mjs} +2 -2
- package/dist/define-adapter-DCjNTP6m.mjs.map +1 -0
- package/dist/{di-hooks-ZfnBZMDp.mjs → di-hooks-DTDy7ABs.mjs} +2 -2
- package/dist/di-hooks-DTDy7ABs.mjs.map +1 -0
- package/dist/{disposables-DFZXQuVg.mjs → disposables-BC291ukb.mjs} +1 -1
- package/dist/{driver-D_bUSW7N.mjs → driver-D59oWDec.mjs} +3 -3
- package/dist/{driver-D_bUSW7N.mjs.map → driver-D59oWDec.mjs.map} +1 -1
- package/dist/{error-handler-D7DLWe1Q.d.mts → error-handler-gZLQFHeE.d.mts} +2 -4
- package/dist/error-handler-gZLQFHeE.d.mts.map +1 -0
- package/dist/{errors-By6UueCm.d.mts → errors-CppqPy0A.d.mts} +2 -3
- package/dist/{errors-By6UueCm.d.mts.map → errors-CppqPy0A.d.mts.map} +1 -1
- package/dist/{express-31o4SoCz.mjs → express-JAXx9MK0.mjs} +3 -3
- package/dist/{express-31o4SoCz.mjs.map → express-JAXx9MK0.mjs.map} +1 -1
- package/dist/{express-lazy-GCgYyykt.mjs → express-lazy-jIFBeDpY.mjs} +3 -3
- package/dist/{express-lazy-GCgYyykt.mjs.map → express-lazy-jIFBeDpY.mjs.map} +1 -1
- package/dist/{handler-Bvs0gx1o.mjs → handler-C8iAD_xz.mjs} +3 -3
- package/dist/{handler-Bvs0gx1o.mjs.map → handler-C8iAD_xz.mjs.map} +1 -1
- package/dist/{helmet-BVuVBl-D.d.mts → helmet-1H0LKr6y.d.mts} +7 -4
- package/dist/helmet-1H0LKr6y.d.mts.map +1 -0
- package/dist/{host-CKz7eCtO.mjs → host-Crxmi91N.mjs} +2 -2
- package/dist/{host-CKz7eCtO.mjs.map → host-Crxmi91N.mjs.map} +1 -1
- package/dist/http/application.d.mts +1 -1
- package/dist/http/application.mjs +2 -2
- package/dist/http/bootstrap.d.mts +1 -1
- package/dist/http/bootstrap.mjs +2 -2
- package/dist/http/context.d.mts +2 -2
- package/dist/http/context.mjs +2 -2
- package/dist/http/middleware/allowed-hosts.d.mts +1 -1
- package/dist/http/middleware/allowed-hosts.mjs +2 -2
- package/dist/http/middleware/allowed-hosts.mjs.map +1 -1
- package/dist/http/middleware/breach-padding.d.mts +1 -1
- package/dist/http/middleware/breach-padding.mjs +1 -1
- package/dist/http/middleware/breach-padding.mjs.map +1 -1
- package/dist/http/middleware/cors.d.mts +1 -1
- package/dist/http/middleware/cors.mjs +1 -1
- package/dist/http/middleware/cors.mjs.map +1 -1
- package/dist/http/middleware/csrf.d.mts +1 -1
- package/dist/http/middleware/csrf.mjs +2 -2
- package/dist/http/middleware/csrf.mjs.map +1 -1
- package/dist/http/middleware/error-handler.d.mts +1 -1
- package/dist/http/middleware/error-handler.mjs +2 -2
- package/dist/http/middleware/error-handler.mjs.map +1 -1
- package/dist/http/middleware/helmet.d.mts +1 -1
- package/dist/http/middleware/helmet.mjs +1 -1
- package/dist/http/middleware/helmet.mjs.map +1 -1
- package/dist/http/middleware/rate-limit.d.mts +1 -1
- package/dist/http/middleware/rate-limit.mjs +2 -2
- package/dist/http/middleware/rate-limit.mjs.map +1 -1
- package/dist/http/middleware/request-id.d.mts +1 -1
- package/dist/http/middleware/request-id.mjs +1 -1
- package/dist/http/middleware/request-id.mjs.map +1 -1
- package/dist/http/middleware/request-logger.d.mts +1 -1
- package/dist/http/middleware/request-logger.mjs +2 -2
- package/dist/http/middleware/request-logger.mjs.map +1 -1
- package/dist/http/middleware/session.d.mts +1 -1
- package/dist/http/middleware/session.mjs +2 -2
- package/dist/http/middleware/session.mjs.map +1 -1
- package/dist/http/middleware/spa.d.mts +1 -1
- package/dist/http/middleware/spa.mjs +2 -2
- package/dist/http/middleware/spa.mjs.map +1 -1
- package/dist/http/middleware/upload.d.mts +2 -2
- package/dist/http/middleware/upload.mjs +2 -2
- package/dist/http/middleware/upload.mjs.map +1 -1
- package/dist/http/middleware/validate.d.mts +1 -1
- package/dist/http/middleware/validate.mjs +1 -1
- package/dist/http/middleware/validate.mjs.map +1 -1
- package/dist/http/middleware/views.d.mts +1 -1
- package/dist/http/middleware/views.mjs +2 -2
- package/dist/http/middleware/views.mjs.map +1 -1
- package/dist/http/query/index.d.mts +1 -1
- package/dist/http/query/index.mjs +2 -2
- package/dist/http/router-builder.d.mts +1 -1
- package/dist/http/router-builder.mjs +2 -2
- package/dist/http/runtimes/express.d.mts +4 -7
- package/dist/http/runtimes/express.d.mts.map +1 -1
- package/dist/http/runtimes/express.mjs +2 -2
- package/dist/http/runtimes/fastify.d.mts +3 -5
- package/dist/http/runtimes/fastify.d.mts.map +1 -1
- package/dist/http/runtimes/fastify.mjs +2 -2
- package/dist/http/runtimes/fastify.mjs.map +1 -1
- package/dist/http/runtimes/h3-web.mjs +1 -1
- package/dist/http/runtimes/h3.d.mts +1 -3
- package/dist/http/runtimes/h3.d.mts.map +1 -1
- package/dist/http/runtimes/h3.mjs +2 -2
- package/dist/http/runtimes/h3.mjs.map +1 -1
- package/dist/{index-Blgka75E.d.mts → index-CtjmSXFy.d.mts} +11 -5
- package/dist/index-CtjmSXFy.d.mts.map +1 -0
- package/dist/{index-DP_I4puv.d.mts → index-DoukvKwh.d.mts} +3 -7
- package/dist/index-DoukvKwh.d.mts.map +1 -0
- package/dist/index.d.mts +38 -32
- package/dist/index.mjs +2 -2
- package/dist/index.mjs.map +1 -1
- package/dist/{interfaces-C6LHcYsg.d.mts → interfaces-CvO9sAea.d.mts} +3 -5
- package/dist/interfaces-CvO9sAea.d.mts.map +1 -0
- package/dist/{is-production-6wpWSGvS.mjs → is-production-LziEMGrc.mjs} +2 -2
- package/dist/{is-production-6wpWSGvS.mjs.map → is-production-LziEMGrc.mjs.map} +1 -1
- package/dist/{jobs-BTnyyRY1.mjs → jobs-D7ToA0yF.mjs} +3 -3
- package/dist/jobs-D7ToA0yF.mjs.map +1 -0
- package/dist/{kv-stores-CwJdsMln.d.mts → kv-stores-DdGPLXQG.d.mts} +33 -20
- package/dist/kv-stores-DdGPLXQG.d.mts.map +1 -0
- package/dist/{kv-stores-HUdUibOx.mjs → kv-stores-DpM57Xr5.mjs} +3 -3
- package/dist/kv-stores-DpM57Xr5.mjs.map +1 -0
- package/dist/{lazy-serve-static-CZBn-40v.mjs → lazy-serve-static-DxI2K-zs.mjs} +3 -3
- package/dist/{lazy-serve-static-CZBn-40v.mjs.map → lazy-serve-static-DxI2K-zs.mjs.map} +1 -1
- package/dist/{logger-xE9qI_FS.d.mts → logger-ByJsVwqY.d.mts} +3 -5
- package/dist/logger-ByJsVwqY.d.mts.map +1 -0
- package/dist/{metadata-UjLEzS06.mjs → metadata-nTTSnVTO.mjs} +1 -1
- package/dist/{observers-C4bWQTop.mjs → observers-fQtCIKLq.mjs} +2 -2
- package/dist/observers-fQtCIKLq.mjs.map +1 -0
- package/dist/{path-CMwIHsdv.d.mts → path-DsenzqJ7.d.mts} +1 -3
- package/dist/path-DsenzqJ7.d.mts.map +1 -0
- package/dist/{precompressed-BNkw1Vrz.mjs → precompressed-BtwmgzyS.mjs} +2 -2
- package/dist/{precompressed-BNkw1Vrz.mjs.map → precompressed-BtwmgzyS.mjs.map} +1 -1
- package/dist/{query-DXIo1mII.mjs → query-Dr28oT30.mjs} +2 -2
- package/dist/query-Dr28oT30.mjs.map +1 -0
- package/dist/{rate-limit-DQDk6bAH.d.mts → rate-limit-BQx_P6gG.d.mts} +13 -5
- package/dist/rate-limit-BQx_P6gG.d.mts.map +1 -0
- package/dist/{reactivity-DZrc3Yhu.d.mts → reactivity-KZOrwVeK.d.mts} +32 -3
- package/dist/reactivity-KZOrwVeK.d.mts.map +1 -0
- package/dist/{reply-CpMbB8uH.mjs → reply-ChoI5SvM.mjs} +3 -3
- package/dist/{reply-CpMbB8uH.mjs.map → reply-ChoI5SvM.mjs.map} +1 -1
- package/dist/{request-id-Dn64nEHK.d.mts → request-id-B9Myiv75.d.mts} +3 -4
- package/dist/request-id-B9Myiv75.d.mts.map +1 -0
- package/dist/{request-logger-TgcKRNDD.d.mts → request-logger-CYyAuPmo.d.mts} +6 -3
- package/dist/request-logger-CYyAuPmo.d.mts.map +1 -0
- package/dist/{request-scope-DZQceiLY.mjs → request-scope-BfSNdmz9.mjs} +3 -3
- package/dist/{request-scope-DZQceiLY.mjs.map → request-scope-BfSNdmz9.mjs.map} +1 -1
- package/dist/{respond-Bc71p7sN.mjs → respond-1BjaDME9.mjs} +2 -2
- package/dist/{respond-Bc71p7sN.mjs.map → respond-1BjaDME9.mjs.map} +1 -1
- package/dist/rolldown-runtime-B5KeNctS.mjs +11 -0
- package/dist/{route-flag-DWNbpMIE.mjs → route-flag-B6ZmhkfI.mjs} +3 -3
- package/dist/{route-flag-DWNbpMIE.mjs.map → route-flag-B6ZmhkfI.mjs.map} +1 -1
- package/dist/{route-flag-B1lQht6v.d.mts → route-flag-CjXQl-oX.d.mts} +1 -3
- package/dist/route-flag-CjXQl-oX.d.mts.map +1 -0
- package/dist/{route-policy-DsdJx3bk.mjs → route-policy-BG--gAcF.mjs} +2 -2
- package/dist/route-policy-BG--gAcF.mjs.map +1 -0
- package/dist/{router-builder-C5EtcFSL.d.mts → router-builder-BkIW_qjz.d.mts} +4 -5
- package/dist/router-builder-BkIW_qjz.d.mts.map +1 -0
- package/dist/{router-builder-CiwYhiUM.mjs → router-builder-DHKtp4I8.mjs} +3 -3
- package/dist/router-builder-DHKtp4I8.mjs.map +1 -0
- package/dist/{runtime-Bus9RVyU.mjs → runtime-CUfFIHiC.mjs} +3 -3
- package/dist/runtime-CUfFIHiC.mjs.map +1 -0
- package/dist/{session-DQG72vCf.d.mts → session-DPTbfwKO.d.mts} +41 -4
- package/dist/session-DPTbfwKO.d.mts.map +1 -0
- package/dist/{settings-DgZLgcNU.d.mts → settings-CB6lh6_s.d.mts} +1 -3
- package/dist/settings-CB6lh6_s.d.mts.map +1 -0
- package/dist/{settings-CNZ7iRli.mjs → settings-I7GUX5ps.mjs} +4 -4
- package/dist/settings-I7GUX5ps.mjs.map +1 -0
- package/dist/{token-CroYM4Lm.mjs → token-uWfhVlfe.mjs} +1 -1
- package/dist/{upload-DnwvZQyi.d.mts → upload-O3VTcODy.d.mts} +4 -6
- package/dist/upload-O3VTcODy.d.mts.map +1 -0
- package/dist/{upload-config-Bq3qcDel.mjs → upload-config-BXqBuyza.mjs} +2 -2
- package/dist/{upload-config-Bq3qcDel.mjs.map → upload-config-BXqBuyza.mjs.map} +1 -1
- package/dist/url-for-CuMaQ2wS.mjs +12 -0
- package/dist/url-for-CuMaQ2wS.mjs.map +1 -0
- package/dist/{validate-D4Poe2EE.d.mts → validate-CTgfm7oE.d.mts} +3 -5
- package/dist/validate-CTgfm7oE.d.mts.map +1 -0
- package/dist/{view-renderer-Dbha_94K.mjs → view-renderer-Bf1Wy-DQ.mjs} +3 -3
- package/dist/view-renderer-Bf1Wy-DQ.mjs.map +1 -0
- package/dist/{web-crypto-CJiyfQrv.mjs → web-crypto-JzoGmiG0.mjs} +2 -2
- package/dist/{web-crypto-CJiyfQrv.mjs.map → web-crypto-JzoGmiG0.mjs.map} +1 -1
- package/dist/web.d.mts +7 -13
- package/dist/web.d.mts.map +1 -1
- package/dist/web.mjs +2 -2
- package/dist/web.mjs.map +1 -1
- package/package.json +13 -13
- package/dist/adapter-DL9JPcvC.d.mts.map +0 -1
- package/dist/allowed-hosts-BpKwviq5.d.mts.map +0 -1
- package/dist/app-module-Dk2Wenqx.d.mts.map +0 -1
- package/dist/application-BosHcuBZ.mjs +0 -14
- package/dist/application-BosHcuBZ.mjs.map +0 -1
- package/dist/application-D921r4MW.d.mts.map +0 -1
- package/dist/bootstrap-CY0v5VVF.mjs.map +0 -1
- package/dist/breach-padding-FBVGmcBb.d.mts.map +0 -1
- package/dist/cache-CdRHSXow.d.mts.map +0 -1
- package/dist/connect-BlIamapT.d.mts.map +0 -1
- package/dist/container-4iJdDkRH.d.mts +0 -3
- package/dist/context-Cgr5dtIZ.mjs.map +0 -1
- package/dist/context-errors-6x0bjldv.mjs.map +0 -1
- package/dist/contributor-runner-DQ2fXJ29.mjs.map +0 -1
- package/dist/core-g3y9VDwr.mjs +0 -12
- package/dist/core-g3y9VDwr.mjs.map +0 -1
- package/dist/cors-BlR_b0Qb.d.mts.map +0 -1
- package/dist/cron-BTGytNg-.d.mts.map +0 -1
- package/dist/csrf-DOAaYozG.d.mts.map +0 -1
- package/dist/decorate-LMK39Sn6.mjs +0 -13
- package/dist/decorate-LMK39Sn6.mjs.map +0 -1
- package/dist/decorators-DxNb5mWw.d.mts.map +0 -1
- package/dist/define-adapter-CZCFyDp5.mjs.map +0 -1
- package/dist/di-hooks-ZfnBZMDp.mjs.map +0 -1
- package/dist/error-handler-D7DLWe1Q.d.mts.map +0 -1
- package/dist/helmet-BVuVBl-D.d.mts.map +0 -1
- package/dist/index-Blgka75E.d.mts.map +0 -1
- package/dist/index-DP_I4puv.d.mts.map +0 -1
- package/dist/interfaces-C6LHcYsg.d.mts.map +0 -1
- package/dist/jobs-BTnyyRY1.mjs.map +0 -1
- package/dist/kv-stores-CwJdsMln.d.mts.map +0 -1
- package/dist/kv-stores-HUdUibOx.mjs.map +0 -1
- package/dist/logger-xE9qI_FS.d.mts.map +0 -1
- package/dist/observers-C4bWQTop.mjs.map +0 -1
- package/dist/path-CMwIHsdv.d.mts.map +0 -1
- package/dist/query-DXIo1mII.mjs.map +0 -1
- package/dist/rate-limit-DQDk6bAH.d.mts.map +0 -1
- package/dist/reactivity-DZrc3Yhu.d.mts.map +0 -1
- package/dist/request-id-Dn64nEHK.d.mts.map +0 -1
- package/dist/request-logger-TgcKRNDD.d.mts.map +0 -1
- package/dist/rolldown-runtime-Z3gdyCfQ.mjs +0 -11
- package/dist/route-flag-B1lQht6v.d.mts.map +0 -1
- package/dist/route-policy-DsdJx3bk.mjs.map +0 -1
- package/dist/router-builder-C5EtcFSL.d.mts.map +0 -1
- package/dist/router-builder-CiwYhiUM.mjs.map +0 -1
- package/dist/runtime-Bus9RVyU.mjs.map +0 -1
- package/dist/session-DQG72vCf.d.mts.map +0 -1
- package/dist/settings-CNZ7iRli.mjs.map +0 -1
- package/dist/settings-DgZLgcNU.d.mts.map +0 -1
- package/dist/upload-DnwvZQyi.d.mts.map +0 -1
- package/dist/url-for-BCQLTEJj.mjs +0 -12
- package/dist/url-for-BCQLTEJj.mjs.map +0 -1
- package/dist/validate-D4Poe2EE.d.mts.map +0 -1
- package/dist/view-renderer-Dbha_94K.mjs.map +0 -1
|
@@ -1,10 +1,9 @@
|
|
|
1
1
|
|
|
2
|
-
import { x as MiddlewareHandler } from "./decorators-
|
|
3
|
-
import { E as RequestContext, x as RuntimeResponse } from "./adapter-
|
|
4
|
-
import { d as RouteFlagTest } from "./route-flag-
|
|
5
|
-
import { a as SessionStore, r as SessionData } from "./session-
|
|
6
|
-
import { r as RateLimitStore } from "./rate-limit-
|
|
7
|
-
//#region src/core/jobs.d.ts
|
|
2
|
+
import { x as MiddlewareHandler } from "./decorators-Bflncyz6.mjs";
|
|
3
|
+
import { E as RequestContext, x as RuntimeResponse } from "./adapter-D_nUmKEQ.mjs";
|
|
4
|
+
import { d as RouteFlagTest } from "./route-flag-CjXQl-oX.mjs";
|
|
5
|
+
import { a as SessionStore, r as SessionData } from "./session-DPTbfwKO.mjs";
|
|
6
|
+
import { r as RateLimitStore } from "./rate-limit-BQx_P6gG.mjs";
|
|
8
7
|
/** Metadata keys — the same ones `@forinda/kickjs-queue` used, so existing readers keep working. */
|
|
9
8
|
declare const JOB_META: {
|
|
10
9
|
readonly JOB: 'kick/queue/job';
|
|
@@ -27,9 +26,17 @@ interface JobLike<Data = unknown> {
|
|
|
27
26
|
data: Data;
|
|
28
27
|
id?: string;
|
|
29
28
|
}
|
|
30
|
-
/**
|
|
29
|
+
/**
|
|
30
|
+
* Mark a class as handling jobs on `queue`. The class is a DI singleton.
|
|
31
|
+
*
|
|
32
|
+
* @see https://kickjs.app/guide/jobs
|
|
33
|
+
*/
|
|
31
34
|
declare function Job(queue: string): ClassDecorator;
|
|
32
|
-
/**
|
|
35
|
+
/**
|
|
36
|
+
* Mark a method as handling `jobName` — or, without a name, every job its queue gets.
|
|
37
|
+
*
|
|
38
|
+
* @see https://kickjs.app/guide/jobs
|
|
39
|
+
*/
|
|
33
40
|
declare function Process(jobName?: string): MethodDecorator;
|
|
34
41
|
/** One handler: its queue, job name (absent for a catch-all), class and method. */
|
|
35
42
|
interface JobHandler extends ProcessDefinition {
|
|
@@ -102,8 +109,6 @@ interface JobDispatcher {
|
|
|
102
109
|
* `@Inject(JOB_DISPATCHER) private jobs!: JobDispatcher`.
|
|
103
110
|
*/
|
|
104
111
|
declare const JOB_DISPATCHER: import("@forinda/kickjs-di").InjectionToken<JobDispatcher>;
|
|
105
|
-
//#endregion
|
|
106
|
-
//#region src/http/reply.d.ts
|
|
107
112
|
declare const REPLY_BRAND: unique symbol;
|
|
108
113
|
/**
|
|
109
114
|
* A status-carrying response payload for return-value handlers. Create via
|
|
@@ -162,6 +167,7 @@ declare namespace reply {
|
|
|
162
167
|
*/
|
|
163
168
|
type InferHandlerResponse<H> = H extends ((...args: never[]) => infer R) ? [Exclude<Awaited<R>, void | undefined>] extends [never] ? unknown : UnwrapReply<Exclude<Awaited<R>, void | undefined>> : unknown;
|
|
164
169
|
type UnwrapReply<A> = A extends Reply<number, infer B> ? B : A extends RuntimeResponse ? unknown : A;
|
|
170
|
+
/** True when `value` was made by `reply()`. */
|
|
165
171
|
declare function isReply(value: unknown): value is Reply;
|
|
166
172
|
/**
|
|
167
173
|
* Key of the method a self-sending result carries. A returned value with
|
|
@@ -175,6 +181,7 @@ declare const RESPOND: unique symbol;
|
|
|
175
181
|
interface Respondable {
|
|
176
182
|
[RESPOND](ctx: RequestContext): void | PromiseLike<void>;
|
|
177
183
|
}
|
|
184
|
+
/** True when `value` has a `[RESPOND](ctx)` method, so it writes its own response when returned from a handler. */
|
|
178
185
|
declare function isRespondable(value: unknown): value is Respondable;
|
|
179
186
|
/**
|
|
180
187
|
* Send a handler's RETURN value when the pipeline finished without anything
|
|
@@ -190,8 +197,6 @@ declare function isRespondable(value: unknown): value is Respondable;
|
|
|
190
197
|
* `Respondable`, which callers await so its errors reach the error handler.
|
|
191
198
|
*/
|
|
192
199
|
declare function applyHandlerResult(ctx: RequestContext, result: unknown): boolean | Promise<boolean>;
|
|
193
|
-
//#endregion
|
|
194
|
-
//#region src/http/background.d.ts
|
|
195
200
|
/**
|
|
196
201
|
* Keep `promise` alive past the response. A rejection is logged (with the
|
|
197
202
|
* request id when called during a request), never left unhandled.
|
|
@@ -220,8 +225,6 @@ declare function settleBackgroundWork(): Promise<void>;
|
|
|
220
225
|
interface PlatformContext {
|
|
221
226
|
waitUntil?(promise: Promise<unknown>): void;
|
|
222
227
|
}
|
|
223
|
-
//#endregion
|
|
224
|
-
//#region src/core/web-crypto.d.ts
|
|
225
228
|
/**
|
|
226
229
|
* Constant-time check of an `Authorization: Bearer <secret>` header against a
|
|
227
230
|
* shared secret — a cron trigger, a metrics scrape, a webhook. `false` for a
|
|
@@ -230,8 +233,11 @@ interface PlatformContext {
|
|
|
230
233
|
* `ctx.headers.authorization` as is.
|
|
231
234
|
*/
|
|
232
235
|
declare function matchesBearer(header: unknown, secret: string): boolean;
|
|
233
|
-
|
|
234
|
-
|
|
236
|
+
/**
|
|
237
|
+
* Options for {@link rateLimitGuard}.
|
|
238
|
+
*
|
|
239
|
+
* @see https://kickjs.app/guide/rate-limiting
|
|
240
|
+
*/
|
|
235
241
|
interface RateLimitGuardOptions {
|
|
236
242
|
/** Maximum number of requests per window (default: 100). */
|
|
237
243
|
max?: number;
|
|
@@ -307,8 +313,6 @@ interface RateLimitGuardOptions {
|
|
|
307
313
|
* ```
|
|
308
314
|
*/
|
|
309
315
|
declare function rateLimitGuard(options?: RateLimitGuardOptions): MiddlewareHandler;
|
|
310
|
-
//#endregion
|
|
311
|
-
//#region src/http/middleware/kv-stores.d.ts
|
|
312
316
|
/**
|
|
313
317
|
* The minimal async KV surface both stores need. Structurally compatible
|
|
314
318
|
* with a Cloudflare Workers `KVNamespace` binding — pass it straight in:
|
|
@@ -332,6 +336,11 @@ interface KvLike {
|
|
|
332
336
|
}): Promise<void>;
|
|
333
337
|
delete(key: string): Promise<void>;
|
|
334
338
|
}
|
|
339
|
+
/**
|
|
340
|
+
* Options for {@link KvRateLimitStore}.
|
|
341
|
+
*
|
|
342
|
+
* @see https://kickjs.app/guide/edge-deployment
|
|
343
|
+
*/
|
|
335
344
|
interface KvRateLimitStoreOptions {
|
|
336
345
|
/** Window length in ms — must match the `windowMs` given to the limiter. */
|
|
337
346
|
windowMs: number;
|
|
@@ -362,6 +371,11 @@ declare class KvRateLimitStore implements RateLimitStore {
|
|
|
362
371
|
private read;
|
|
363
372
|
private write;
|
|
364
373
|
}
|
|
374
|
+
/**
|
|
375
|
+
* Options for {@link KvSessionStore}.
|
|
376
|
+
*
|
|
377
|
+
* @see https://kickjs.app/guide/edge-deployment
|
|
378
|
+
*/
|
|
365
379
|
interface KvSessionStoreOptions {
|
|
366
380
|
/** Key prefix in the KV namespace (default `'sess:'`). */
|
|
367
381
|
prefix?: string;
|
|
@@ -385,6 +399,5 @@ declare class KvSessionStore implements SessionStore {
|
|
|
385
399
|
destroy(sid: string): Promise<void>;
|
|
386
400
|
touch(sid: string, maxAge: number): Promise<void>;
|
|
387
401
|
}
|
|
388
|
-
//#endregion
|
|
389
402
|
export { NoJobHandlerError as A, JOB_DISPATCHER as C, JobDispatcher as D, JobContextCarrier as E, registerJobContext as F, runJob as I, stampJobContext as L, ProcessDefinition as M, listJobHandlers as N, JobHandler as O, listJobQueues as P, JOB_CONTEXT_FIELD as S, Job as T, Respondable as _, KvSessionStoreOptions as a, isRespondable as b, matchesBearer as c, waitUntil as d, InferHandlerResponse as f, ReplyOptions as g, ReplyHeaders as h, KvSessionStore as i, Process as j, JobLike as k, PlatformContext as l, Reply as m, KvRateLimitStore as n, RateLimitGuardOptions as o, RESPOND as p, KvRateLimitStoreOptions as r, rateLimitGuard as s, KvLike as t, settleBackgroundWork as u, applyHandlerResult as v, JOB_META as w, reply as x, isReply as y };
|
|
390
|
-
//# sourceMappingURL=kv-stores-
|
|
403
|
+
//# sourceMappingURL=kv-stores-DdGPLXQG.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kv-stores-DdGPLXQG.d.mts","names":[],"sources":["../src/core/jobs.ts","../src/http/reply.ts","../src/http/background.ts","../src/core/web-crypto.ts","../src/http/middleware/rate-limit-guard.ts","../src/http/middleware/kv-stores.ts"],"mappings":";;;;;;;cA6Ba;WACX;WACA;;;UAIe;;EAEf;;EAEA;;;;;;;UAQe,QAAQ;EACvB;EACA,MAAM;EACN;;;;;;;iBAcc,IAAI,gBAAgB;;;;;;iBAapB,QAAQ,mBAAmB;;UAU1B,mBAAmB;EAClC;EACA,QAAQ;;;;;;;iBAQM,gBAAgB;EAAa,IAAI;IAA6B;;iBAgB9D,cAAc;EAAa,IAAI;;;cAKlC,0BAA0B;WAE1B;WACA;EAFX,YACW,eACA;;;;;;;;;;iBAeS,OACpB;EAAa,IAAI;EAA0B,QAAQ;GACnD,eACA,KAAK;;AAEL,SAAQ,0BACP;;;;;;UAoBc,kBAAkB;;EAEjC;;EAEA,WAAW;;EAEX,QAAQ,GAAG,OAAO,GAAG,WAAW,IAAI;;;cAIzB;;iBAKG,mBAAmB,GAAG,SAAS,kBAAkB;;;;;;;;iBAcjD,gBAAgB,MAAM,MAAM,OAAO;;UAiClC;EACf,SAAS,gBACP,eACA,cACA,MAAM,MACN,UAAU,0BACT;;;;;;cAOQ,6CAAc,eAAA;cC5NrB;;;;;;UAOW,MAAM,2BAA2B;YACtC;WACD,QAAQ;WACR,MAAM;;WAEN,UAAU;;;KAIT,eAAe,SAAS;;UAGnB;;EAEf,UAAU;;;;;;;;;;;;;;;iBAgBI,MAAM,kBAAkB,GACtC,QAAQ,GACR,MAAM,GACN,UAAU,eACT,MAAM,GAAG;kBAJI;MAWJ,KAAA,GAAC,MAAQ,MAAI,WAAW;MAUnB,UAAA,GAAC,MAAQ,GAAC,UAAY;IAAiB;QAAsB,WAAW;MASvE,WAAA,GAAC,MAAQ,MAAI,WAAW;MAEpB,iBAAA;;;;;;;;;;;;;;;;KAgBV,qBAAqB,KAAK,eAAc,wBAAwB,MACvE,QAAQ,QAAQ,mDAEf,YAAY,QAAQ,QAAQ;KAG7B,YAAY,KACf,UAAU,oBAAoB,KAC1B,IACA,UAAU,4BAWR;;iBAGQ,QAAQ,iBAAiB,SAAS;;;;;;;;cAerC;;UAGI;GACd,SAAS,KAAK,wBAAwB;;;iBAIzB,cAAc,iBAAiB,SAAS;;;;;;;;;;;;;;iBAqBxC,mBACd,KAAK,gBACL,4BACW;;;;;;;;;;;;;;;iBCrIG,UAAU,SAAS;;;;;iBAiBb,wBAAwB;;;;;;UAc7B;EACf,WAAW,SAAS;;;;;;;;;iBCrCN,cAAc,iBAAiB;;;;;;UClB9B;;EAEf;;EAEA;;EAEA;;EAEA;;;;;;;;;;;;;;;;;;;;;;;EAuBA,gBAAgB,KAAK;;EAErB;;;;;;EAMA,QAAQ;;EAER,QAAQ,KAAK;;;;;;;;;;;;;;;;EAgBb,aAAa;;;;;;;;;;;;;;;;;iBAoDC,eAAe,UAAS,wBAA6B;;;;;;;;;;;;;;;;;UCxGpD;EACf,IAAI,cAAc;EAClB,IAAI,aAAa,eAAe;IAAY;MAA2B;EACvE,OAAO,cAAc;;;;;;;UAaN;;EAEf;;EAEA;;;;;;;;;;;;cAaW,4BAA4B;mBAKpB;mBAJF;mBACA;EAEjB,YACmB,IAAI,QACrB,SAAS;EAML,UAAU,cAAc;IAAU;IAAmB,WAAW;;EAahE,UAAU,cAAc;EAQxB,MAAM,cAAc;UAIZ;UAUA;;;;;;;UAYC;;EAEf;;;;;;;;;;;;cAaW,0BAA0B;mBAIlB;mBAHF;EAEjB,YACmB,IAAI,QACrB,UAAS;EAKL,IAAI,cAAc,QAAQ;EAU1B,IAAI,aAAa,MAAM,aAAa,iBAAiB;EAMrD,QAAQ,cAAc;EAItB,MAAM,aAAa,iBAAiB"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.
|
|
2
|
+
* @forinda/kickjs v10.15.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{n as assertFlagTest,s as matchesFlagTest}from"./route-flag-
|
|
12
|
-
//# sourceMappingURL=kv-stores-
|
|
11
|
+
import{n as assertFlagTest,s as matchesFlagTest}from"./route-flag-B6ZmhkfI.mjs";import{t as BoundedCounters}from"./bounded-counters-BtvB2daV.mjs";var LazyMemoryStore=class{counters;constructor(windowMs,limit){this.counters=new BoundedCounters(windowMs,limit)}async increment(key){return this.counters.increment(key)}async decrement(key){this.counters.decrement(key)}async reset(key){this.counters.reset(key)}};function defaultKey(ctx){return ctx.ip??`global`}function rateLimitGuard(options={}){let max=options.max??100,windowMs=options.windowMs??6e4,message=options.message??`Too Many Requests`,statusCode=options.statusCode??429,keyGenerator=options.keyGenerator??defaultKey,sendHeaders=options.headers??!0,store=options.store??new LazyMemoryStore(windowMs,max),exemptWhen=options.exemptWhen;return exemptWhen!==void 0&&assertFlagTest(exemptWhen,`rateLimitGuard({ exemptWhen })`),async(ctx,next)=>{if(options.skip?.(ctx)||exemptWhen!==void 0&&matchesFlagTest(exemptWhen,ctx.route?.flags,ctx.route))return next();let{totalHits,resetTime}=await store.increment(keyGenerator(ctx)),remaining=Math.max(0,max-totalHits);if(sendHeaders&&(ctx.setHeader(`X-RateLimit-Limit`,String(max)),ctx.setHeader(`X-RateLimit-Remaining`,String(remaining)),ctx.setHeader(`X-RateLimit-Reset`,String(Math.ceil(resetTime.getTime()/1e3)))),totalHits>max){let retryAfter=Math.max(1,Math.ceil((resetTime.getTime()-Date.now())/1e3));sendHeaders&&ctx.setHeader(`Retry-After`,String(retryAfter)),ctx.json({message},statusCode)}else next()}}function kvTtlSeconds(ms){return Math.max(60,Math.ceil(ms/1e3))}var KvRateLimitStore=class{kv;prefix;windowMs;constructor(kv,options){this.kv=kv,this.windowMs=options.windowMs,this.prefix=options.prefix??`rl:`}async increment(key){let now=Date.now(),entry=await this.read(key);if(entry&&entry.reset>now)return entry.hits++,await this.write(key,entry),{totalHits:entry.hits,resetTime:new Date(entry.reset)};let fresh={hits:1,reset:now+this.windowMs};return await this.write(key,fresh),{totalHits:1,resetTime:new Date(fresh.reset)}}async decrement(key){let entry=await this.read(key);entry&&entry.hits>0&&(entry.hits--,await this.write(key,entry))}async reset(key){await this.kv.delete(this.prefix+key)}async read(key){let raw=await this.kv.get(this.prefix+key);if(raw===null)return null;try{return JSON.parse(raw)}catch{return null}}async write(key,entry){await this.kv.put(this.prefix+key,JSON.stringify(entry),{expirationTtl:kvTtlSeconds(Math.max(entry.reset-Date.now(),1e3))})}},KvSessionStore=class{kv;prefix;constructor(kv,options={}){this.kv=kv,this.prefix=options.prefix??`sess:`}async get(sid){let raw=await this.kv.get(this.prefix+sid);if(raw===null)return null;try{return JSON.parse(raw)}catch{return null}}async set(sid,data,maxAge){await this.kv.put(this.prefix+sid,JSON.stringify(data),{expirationTtl:kvTtlSeconds(maxAge)})}async destroy(sid){await this.kv.delete(this.prefix+sid)}async touch(sid,maxAge){let data=await this.get(sid);data!==null&&await this.set(sid,data,maxAge)}};export{KvSessionStore as n,rateLimitGuard as r,KvRateLimitStore as t};
|
|
12
|
+
//# sourceMappingURL=kv-stores-DpM57Xr5.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"kv-stores-DpM57Xr5.mjs","names":[],"sources":["../src/http/middleware/rate-limit-guard.ts","../src/http/middleware/kv-stores.ts"],"sourcesContent":["// Ctx-style rate limiter — runs on BOTH pipelines: the node runtimes (via\n// `@Middleware()` / class middleware) and the `@forinda/kickjs/web` fetch\n// entry (via `@Middleware()` or `createWebApp({ middleware })`), unlike the\n// connect-style `rateLimit()` which is node-only. Zero runtime imports —\n// part of the edge purity graph.\nimport { assertFlagTest, matchesFlagTest, type RouteFlagTest } from '../../core/route-flag'\nimport type { MiddlewareHandler } from '../../core/decorators'\nimport type { RequestContext } from '../context'\nimport type { RateLimitStore } from './rate-limit'\nimport { BoundedCounters } from './bounded-counters'\n\n/**\n * Options for {@link rateLimitGuard}.\n *\n * @see https://kickjs.app/guide/rate-limiting\n */\nexport interface RateLimitGuardOptions {\n /** Maximum number of requests per window (default: 100). */\n max?: number\n /** Time window in milliseconds (default: 60_000). */\n windowMs?: number\n /** Response message when the limit is exceeded (default: 'Too Many Requests'). */\n message?: string\n /** HTTP status code when the limit is exceeded (default: 429). */\n statusCode?: number\n /**\n * Rate-limit key per request. Defaults to `ctx.ip`, falling back to\n * `'global'`. Return a user/tenant id here for authenticated quotas.\n *\n * ::: warning Behind a proxy, configure `trustProxy` or every client shares\n * one bucket\n * On a node runtime `ctx.ip` is the runtime's vetted client address —\n * Express derives it from `trust proxy`, Fastify from `trustProxy`. Without\n * that setting it is the SOCKET address, which behind a load balancer or\n * Cloudflare is the proxy's, so every caller lands in the same bucket and one\n * noisy client exhausts the allowance for everyone.\n *\n * `bootstrap({ trustProxy: true })` is the fix. Forwarded headers are\n * deliberately not consulted here: `x-forwarded-for` is client-controllable\n * unless a proxy overwrites it, so trusting it unconditionally would let a\n * direct caller mint a fresh allowance per request by varying the header —\n * evading the limit rather than enforcing it. The header chain\n * (`cf-connecting-ip` → `x-forwarded-for` → `x-real-ip`) applies only on the\n * `@forinda/kickjs/web` edge entry, where there is no socket and the platform\n * has already terminated the connection.\n * :::\n */\n keyGenerator?: (ctx: RequestContext) => string\n /** Send `X-RateLimit-*` / `Retry-After` headers (default: true). */\n headers?: boolean\n /**\n * Counter backend. Defaults to a per-isolate in-memory map — fine for a\n * single node process, useless on edge where isolates recycle: pass a\n * `KvRateLimitStore` (or Redis-backed store) there.\n */\n store?: RateLimitStore\n /** Skip limiting for a request (health checks, allowlists). */\n skip?: (ctx: RequestContext) => boolean\n /**\n * Skip limiting on routes carrying a route flag — a name, a list of names\n * (any-of), or a predicate. Declared on the route rather than restated as a\n * path here, so it cannot drift when `apiPrefix` or a module's `version`\n * changes:\n *\n * ```ts\n * const Public = defineRouteFlag('auth.public')\n * rateLimitGuard({ max: 60, exemptWhen: 'auth.public' })\n * ```\n *\n * Only meaningful where a route has been matched — as `@Middleware()` on a\n * class or method, or in `createWebApp({ middleware })`. Mounted app-wide\n * ahead of routing there is no route to read, and nothing is exempted.\n */\n exemptWhen?: RouteFlagTest\n}\n\n/**\n * Timer-free in-memory store: expired windows are swept on insert, from the\n * front. Bounded: see {@link BoundedCounters}.\n *\n * @internal Exported for tests.\n */\nexport class LazyMemoryStore implements RateLimitStore {\n private readonly counters: BoundedCounters\n\n /** @param limit The `max` it enforces, so it never evicts a counter at the limit. */\n constructor(windowMs: number, limit?: number) {\n this.counters = new BoundedCounters(windowMs, limit)\n }\n\n async increment(key: string): Promise<{ totalHits: number; resetTime: Date }> {\n return this.counters.increment(key)\n }\n\n async decrement(key: string): Promise<void> {\n this.counters.decrement(key)\n }\n\n async reset(key: string): Promise<void> {\n this.counters.reset(key)\n }\n}\n\nfunction defaultKey(ctx: RequestContext): string {\n // `ctx.ip` carries the resolution that used to live here: prefer the\n // runtime-computed address (Express derives it from `trust proxy`), fall\n // back to forwarded headers only for runtimes that compute none.\n return ctx.ip ?? 'global'\n}\n\n/**\n * Rate limiting as a `(ctx, next)` middleware.\n *\n * ```ts\n * // Edge (Cloudflare Workers) — app-wide:\n * const app = createWebApp({\n * h3, modules,\n * middlewares: [rateLimitGuard({ max: 60, windowMs: 60_000, store: new KvRateLimitStore(env.KV, { windowMs: 60_000 }) })],\n * })\n *\n * // Any runtime — per controller/route:\n * @Middleware(rateLimitGuard({ max: 10 }))\n * @Post('/login')\n * ```\n */\nexport function rateLimitGuard(options: RateLimitGuardOptions = {}): MiddlewareHandler {\n const max = options.max ?? 100\n const windowMs = options.windowMs ?? 60_000\n const message = options.message ?? 'Too Many Requests'\n const statusCode = options.statusCode ?? 429\n const keyGenerator = options.keyGenerator ?? defaultKey\n const sendHeaders = options.headers ?? true\n const store = options.store ?? new LazyMemoryStore(windowMs, max)\n\n const exemptWhen = options.exemptWhen\n if (exemptWhen !== undefined) assertFlagTest(exemptWhen, 'rateLimitGuard({ exemptWhen })')\n\n return async (ctx: RequestContext, next: () => void): Promise<void> => {\n if (options.skip?.(ctx)) return next()\n if (exemptWhen !== undefined && matchesFlagTest(exemptWhen, ctx.route?.flags, ctx.route)) {\n return next()\n }\n\n const { totalHits, resetTime } = await store.increment(keyGenerator(ctx))\n const remaining = Math.max(0, max - totalHits)\n\n if (sendHeaders) {\n ctx.setHeader('X-RateLimit-Limit', String(max))\n ctx.setHeader('X-RateLimit-Remaining', String(remaining))\n ctx.setHeader('X-RateLimit-Reset', String(Math.ceil(resetTime.getTime() / 1000)))\n }\n\n if (totalHits > max) {\n const retryAfter = Math.max(1, Math.ceil((resetTime.getTime() - Date.now()) / 1000))\n if (sendHeaders) ctx.setHeader('Retry-After', String(retryAfter))\n ctx.json({ message }, statusCode)\n return\n }\n\n next()\n }\n}\n","// Edge-safe store adapters over a minimal KV surface. Zero runtime imports —\n// this file must stay importable from the `@forinda/kickjs/web` purity graph.\nimport type { RateLimitStore } from './rate-limit'\nimport type { SessionData, SessionStore } from './session'\n\n/**\n * The minimal async KV surface both stores need. Structurally compatible\n * with a Cloudflare Workers `KVNamespace` binding — pass it straight in:\n *\n * ```ts\n * export default {\n * fetch(req: Request, env: Env) {\n * const store = new KvRateLimitStore(env.MY_KV, { windowMs: 60_000 })\n * // ...\n * },\n * }\n * ```\n *\n * Anything with the same shape works too (Deno KV wrapper, Upstash Redis\n * REST client adapter, a Map-backed fake in tests).\n */\nexport interface KvLike {\n get(key: string): Promise<string | null>\n put(key: string, value: string, options?: { expirationTtl?: number }): Promise<void>\n delete(key: string): Promise<void>\n}\n\n/** Cloudflare KV rejects TTLs under 60 seconds — clamp up, never down. */\nfunction kvTtlSeconds(ms: number): number {\n return Math.max(60, Math.ceil(ms / 1000))\n}\n\n/**\n * Options for {@link KvRateLimitStore}.\n *\n * @see https://kickjs.app/guide/edge-deployment\n */\nexport interface KvRateLimitStoreOptions {\n /** Window length in ms — must match the `windowMs` given to the limiter. */\n windowMs: number\n /** Key prefix in the KV namespace (default `'rl:'`). */\n prefix?: string\n}\n\n/**\n * {@link RateLimitStore} over a {@link KvLike} namespace, for edge deployments\n * where in-memory counters reset on every isolate.\n *\n * KV is eventually consistent and this is a read-modify-write counter, so\n * limiting is **approximate** under concurrency — bursts racing across\n * isolates can each read the same count. That is the accepted trade-off for\n * abuse throttling; use a Durable Object / Redis store when you need an\n * exact ceiling (billing quotas, strict per-key locks).\n */\nexport class KvRateLimitStore implements RateLimitStore {\n private readonly prefix: string\n private readonly windowMs: number\n\n constructor(\n private readonly kv: KvLike,\n options: KvRateLimitStoreOptions,\n ) {\n this.windowMs = options.windowMs\n this.prefix = options.prefix ?? 'rl:'\n }\n\n async increment(key: string): Promise<{ totalHits: number; resetTime: Date }> {\n const now = Date.now()\n const entry = await this.read(key)\n if (entry && entry.reset > now) {\n entry.hits++\n await this.write(key, entry)\n return { totalHits: entry.hits, resetTime: new Date(entry.reset) }\n }\n const fresh = { hits: 1, reset: now + this.windowMs }\n await this.write(key, fresh)\n return { totalHits: 1, resetTime: new Date(fresh.reset) }\n }\n\n async decrement(key: string): Promise<void> {\n const entry = await this.read(key)\n if (entry && entry.hits > 0) {\n entry.hits--\n await this.write(key, entry)\n }\n }\n\n async reset(key: string): Promise<void> {\n await this.kv.delete(this.prefix + key)\n }\n\n private async read(key: string): Promise<{ hits: number; reset: number } | null> {\n const raw = await this.kv.get(this.prefix + key)\n if (raw === null) return null\n try {\n return JSON.parse(raw) as { hits: number; reset: number }\n } catch {\n return null\n }\n }\n\n private async write(key: string, entry: { hits: number; reset: number }): Promise<void> {\n await this.kv.put(this.prefix + key, JSON.stringify(entry), {\n expirationTtl: kvTtlSeconds(Math.max(entry.reset - Date.now(), 1000)),\n })\n }\n}\n\n/**\n * Options for {@link KvSessionStore}.\n *\n * @see https://kickjs.app/guide/edge-deployment\n */\nexport interface KvSessionStoreOptions {\n /** Key prefix in the KV namespace (default `'sess:'`). */\n prefix?: string\n}\n\n/**\n * {@link SessionStore} over a {@link KvLike} namespace. Plug into the node\n * `session()` middleware today (e.g. backed by Upstash/Cloudflare KV via\n * REST) so sessions survive restarts and horizontal scaling; TTL expiry is\n * delegated to the KV layer via `expirationTtl`.\n *\n * Cost note: `touch()` is a get + put round-trip (KvLike has no TTL-only\n * refresh), so `session({ rolling: true })` doubles KV operations per\n * request — per-operation-billed platforms may prefer `rolling: false`.\n */\nexport class KvSessionStore implements SessionStore {\n private readonly prefix: string\n\n constructor(\n private readonly kv: KvLike,\n options: KvSessionStoreOptions = {},\n ) {\n this.prefix = options.prefix ?? 'sess:'\n }\n\n async get(sid: string): Promise<SessionData | null> {\n const raw = await this.kv.get(this.prefix + sid)\n if (raw === null) return null\n try {\n return JSON.parse(raw) as SessionData\n } catch {\n return null\n }\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n await this.kv.put(this.prefix + sid, JSON.stringify(data), {\n expirationTtl: kvTtlSeconds(maxAge),\n })\n }\n\n async destroy(sid: string): Promise<void> {\n await this.kv.delete(this.prefix + sid)\n }\n\n async touch(sid: string, maxAge: number): Promise<void> {\n const data = await this.get(sid)\n if (data !== null) await this.set(sid, data, maxAge)\n }\n}\n"],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.
|
|
2
|
+
* @forinda/kickjs v10.15.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{t as withPrecompressed}from"./precompressed-
|
|
12
|
-
//# sourceMappingURL=lazy-serve-static-
|
|
11
|
+
import{t as withPrecompressed}from"./precompressed-BtwmgzyS.mjs";function lazyServeStatic(dir){let serve;return withPrecompressed(dir,(req,res,next)=>{serve??=import(`serve-static`).then(mod=>(mod.default??mod)(dir)),serve.then(handler=>handler(req,res,next),next)})}export{lazyServeStatic as t};
|
|
12
|
+
//# sourceMappingURL=lazy-serve-static-DxI2K-zs.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"lazy-serve-static-
|
|
1
|
+
{"version":3,"file":"lazy-serve-static-DxI2K-zs.mjs","names":[],"sources":["../src/http/runtimes/lazy-serve-static.ts"],"sourcesContent":["import type { ConnectHandler as RequestHandler } from '../connect'\nimport { withPrecompressed } from './precompressed'\n\n/**\n * `serve-static` as connect middleware, imported on the first request. Only\n * some apps serve files (SpaAdapter), and an `import()`, unlike\n * `createRequire`, is one a bundler follows — so a Netlify or Vercel\n * function carries the package instead of failing to find it.\n */\nexport function lazyServeStatic(dir: string): RequestHandler {\n let serve: Promise<RequestHandler> | undefined\n return withPrecompressed(dir, (req, res, next) => {\n serve ??= import('serve-static').then((mod) => {\n const factory = ((mod as { default?: unknown }).default ?? mod) as (\n root: string,\n ) => RequestHandler\n return factory(dir)\n })\n serve.then((handler) => handler(req, res, next), next)\n })\n}\n"],"mappings":";;;;;;;;;;A,iEASA,SAAgB,gBAAgB,IAA6B,CAC3D,IAAI,MACJ,OAAO,kBAAkB,KAAM,IAAK,IAAK,OAAS,CAChD,QAAU,OAAO,eAAe,CAAC,KAAM,MACnB,IAA8B,SAAW,IAAA,CAG5C,GAAG,CACnB,EACD,MAAM,KAAM,SAAY,QAAQ,IAAK,IAAK,IAAI,EAAG,IAAI,CACvD,CAAC,CACH,C"}
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
|
|
2
|
-
//#region src/core/logger.d.ts
|
|
3
2
|
/**
|
|
4
3
|
* Pluggable logger backend.
|
|
5
4
|
*
|
|
@@ -27,7 +26,7 @@
|
|
|
27
26
|
* Logger.setProvider(new PinoProvider())
|
|
28
27
|
* ```
|
|
29
28
|
*
|
|
30
|
-
* See
|
|
29
|
+
* See https://kickjs.app/guide/logging for Pino, Winston, and silent-logger recipes.
|
|
31
30
|
*/
|
|
32
31
|
interface LoggerProvider {
|
|
33
32
|
info(msg: string, ...args: any[]): void;
|
|
@@ -115,7 +114,7 @@ declare class ConsoleLoggerProvider implements LoggerProvider {
|
|
|
115
114
|
* // Shorthand function
|
|
116
115
|
* const log = createLogger('OrderService')
|
|
117
116
|
*
|
|
118
|
-
* // Pluggable backend — see
|
|
117
|
+
* // Pluggable backend — see https://kickjs.app/guide/logging
|
|
119
118
|
* Logger.setProvider(new MyCustomProvider())
|
|
120
119
|
*
|
|
121
120
|
* // Injectable — auto-named from class
|
|
@@ -190,6 +189,5 @@ declare class Logger {
|
|
|
190
189
|
declare function describeError(err: unknown, maxDepth?: number): string;
|
|
191
190
|
/** Shorthand for Logger.for(name) */
|
|
192
191
|
declare function createLogger(name: string): Logger;
|
|
193
|
-
//#endregion
|
|
194
192
|
export { describeError as a, createLogger as i, Logger as n, jsonLine as o, LoggerProvider as r, serializeError as s, ConsoleLoggerProvider as t };
|
|
195
|
-
//# sourceMappingURL=logger-
|
|
193
|
+
//# sourceMappingURL=logger-ByJsVwqY.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger-ByJsVwqY.d.mts","names":[],"sources":["../src/core/logger.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA+BiB;EACf,KAAK,gBAAgB;EACrB,KAAK,gBAAgB;EACrB,MAAM,gBAAgB;EACtB,MAAM,gBAAgB;EACtB,OAAO,gBAAgB;EACvB,OAAO,gBAAgB;;;;;;EAMvB,MAAM;IAAY;KAAoB;MAA4B;;;cAM9D,YAAY;;;;;;iBA8CF,eAAe,cAAc,gBAAW,OAAI;;;;;;;iBAwC5C,SACd,oBAAoB,YACpB,mBACA,UAAU,yBACV,aACA;;;;;;;;;;;;;;;;;;;;cA+EW,iCAAiC;UACpC;UACA;;UAEA;EAER,YAAY,iBAAiB,WAAU;;UAQ/B;UAMA;;UASA;EAIR,KAAK,gBAAgB;EAIrB,KAAK,gBAAgB;EAIrB,MAAM,gBAAgB;EAItB,MAAM,gBAAgB;EAItB,MAAM,gBAAgB;EAItB,MAAM,gBAAgB;EAItB,MAAM;IAAY;KAAoB;MAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;cAqCvD;UACH;UACA;UACA;UACA;;iBAGO;EAEf,YAAY,eAAe,SAAS;;UAQ5B;;cAMI;;;;;;;;;;;SAkBL,YAAY,UAAU;;SAOtB,eAAe;;;;;SAQf;;SAOA,IAAI,eAAe;;EAU1B,MAAM,eAAe;;;;;;EAMrB,MAAM,QAAQ,0BAA0B;EAMxC,KAAK,gBAAgB;EAIrB,KAAK,gBAAgB;;EAKrB,MAAM,cAAc,gBAAgB;;EAEpC,MAAM,gBAAgB;;EAEtB,MAAM;EA8BN,MAAM,gBAAgB;EAItB,MAAM,gBAAgB;EAKtB,MAAM,gBAAgB;;;;;;;;;;;iBAeR,cAAc,cAAc;;iBA+B5B,aAAa,eAAe"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.
|
|
2
|
+
* @forinda/kickjs v10.15.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,4 +9,4 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import{createLogger}from"./core/logger.mjs";const log=createLogger(`Observers`);let observers=[],publisher,publisherWantsResponses=()=>!1;function setObservers(list){return observers=list.filter(o=>o.onError||o.onResponse),observers}function releaseObservers(installed){observers===installed&&(observers=[])}function setObserverPublisher(next,wantsResponses=()=>!1){publisher=next,publisherWantsResponses=wantsResponses}function hasResponseObservers(){return observers.some(o=>o.onResponse)||publisherWantsResponses()}function notify(pick,what){for(let observer of publisher?[...observers,publisher]:observers)try{let result=pick(observer);result&&typeof result.catch==`function`&&result.catch(err=>failed(observer,what,err))}catch(err){failed(observer,what,err)}}function failed(observer,what,err){try{log.error({err},`${observer.name??`observer`}.${what} threw — skipped`)}catch{}}function reportError(error,info){notify(o=>o.onError?.(error,info),`onError`)}function reportResponse(info){notify(o=>o.onResponse?.(info),`onResponse`)}export{setObserverPublisher as a,reportResponse as i,releaseObservers as n,setObservers as o,reportError as r,hasResponseObservers as t};
|
|
12
|
-
//# sourceMappingURL=observers-
|
|
12
|
+
//# sourceMappingURL=observers-fQtCIKLq.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observers-fQtCIKLq.mjs","names":[],"sources":["../src/core/observers.ts"],"sourcesContent":["/**\n * One place every error and every response is reported to — so an error\n * tracker, a metrics exporter, or an APM integration hooks in once instead of\n * replacing the error handler and patching each source.\n *\n * Observers are adapters and plugins with `onError` / `onResponse`, plus\n * whatever the Node server's tracing channels publish (see `http/tracing.ts`).\n * Observe-only: they cannot change the response, and one that throws is\n * logged and skipped — it never breaks a request or another observer.\n *\n * Free of `node:` imports: `waitUntil` (shared with the web entry) reports\n * through here.\n *\n * @module @forinda/kickjs/core/observers\n */\nimport { createLogger } from './logger'\n\nconst log = createLogger('Observers')\n\n/** Where an error came from. Integrations may report their own sources. */\nexport type ErrorSource =\n | 'request'\n | 'uncaught'\n | 'unhandled-rejection'\n | 'background'\n | 'job'\n | (string & {})\n\n/**\n * Where an error came from, passed to every observer's `onError`.\n *\n * @see https://kickjs.app/guide/observability\n */\nexport interface ErrorInfo {\n source: ErrorSource\n requestId?: string\n method?: string\n /** The request URL path, as received. */\n path?: string\n /** The matched route pattern, e.g. `/api/v1/users/:id`, when one matched. */\n route?: string\n /** The status the error was answered with, for request errors. */\n status?: number\n /** Anything else the reporter knows — a queue and job name, a cron schedule. */\n context?: Record<string, unknown>\n}\n\n/**\n * One finished response, passed to every observer's `onResponse`.\n *\n * @see https://kickjs.app/guide/observability\n */\nexport interface ResponseInfo {\n method: string\n path: string\n /** The matched route pattern, or undefined when no route matched (404s). */\n route?: string\n status: number\n durationMs: number\n requestId?: string\n}\n\nexport interface Observer {\n name?: string\n onError?(error: unknown, info: ErrorInfo): void | Promise<void>\n onResponse?(info: ResponseInfo): void | Promise<void>\n}\n\nlet observers: readonly Observer[] = []\nlet publisher: Observer | undefined\nlet publisherWantsResponses: () => boolean = () => false\n\n/**\n * Replace the observer set — called by the Application from its adapters and\n * plugins. Returns the installed set, so its owner can later release exactly\n * that set (see {@link releaseObservers}).\n */\nexport function setObservers(list: readonly Observer[]): readonly Observer[] {\n observers = list.filter((o) => o.onError || o.onResponse)\n return observers\n}\n\n/**\n * Clear the observer set — but only if it is still the one `installed`. The\n * set is process-wide: a newer Application may have replaced it, and an older\n * one shutting down must not clear the newer one's observers.\n */\nexport function releaseObservers(installed: readonly Observer[]): void {\n if (observers === installed) observers = []\n}\n\n/**\n * The Node server's tracing channels, fed from the same reports. `wantsResponses`\n * is checked per request: a channel can gain a subscriber at any time.\n */\nexport function setObserverPublisher(\n next: Observer | undefined,\n wantsResponses: () => boolean = () => false,\n): void {\n publisher = next\n publisherWantsResponses = wantsResponses\n}\n\n/** Whether anything is listening for responses — lets the server skip timing work. */\nexport function hasResponseObservers(): boolean {\n return observers.some((o) => o.onResponse) || publisherWantsResponses()\n}\n\nfunction notify(pick: (o: Observer) => void | Promise<void> | undefined, what: string): void {\n for (const observer of publisher ? [...observers, publisher] : observers) {\n try {\n const result = pick(observer)\n if (result && typeof (result as Promise<void>).catch === 'function') {\n ;(result as Promise<void>).catch((err: unknown) => failed(observer, what, err))\n }\n } catch (err) {\n failed(observer, what, err)\n }\n }\n}\n\nfunction failed(observer: Observer, what: string, err: unknown): void {\n // Logged directly, never re-reported: an observer failing inside onError\n // must not loop back into onError. Guarded too: a custom LoggerProvider that\n // throws would otherwise escape reportError() — or, from an async\n // observer, become an unhandled rejection that bootstrap reports right back\n // here.\n try {\n log.error({ err }, `${observer.name ?? 'observer'}.${what} threw — skipped`)\n } catch {\n // Nothing left to tell; reportError's \"never throws\" contract wins.\n }\n}\n\n/**\n * Report an error to every observer. The framework calls this for request\n * errors, uncaught exceptions, unhandled rejections, `waitUntil` failures and\n * queue job failures; call it from your own integrations too (a cron runner,\n * a message consumer). Never throws.\n */\nexport function reportError(error: unknown, info: ErrorInfo): void {\n notify((o) => o.onError?.(error, info), 'onError')\n}\n\n/** Report a finished response to every observer. Never throws. */\nexport function reportResponse(info: ResponseInfo): void {\n notify((o) => o.onResponse?.(info), 'onResponse')\n}\n"],"mappings":";;;;;;;;;;A,4CAiBA,MAAM,IAAM,aAAa,WAAW,EAmDpC,IAAI,UAAiC,CAAC,EAClC,UACA,4BAA+C,GAOnD,SAAgB,aAAa,KAAgD,CAE3E,MADA,WAAY,KAAK,OAAQ,GAAM,EAAE,SAAW,EAAE,UAAU,EACjD,SACT,CAOA,SAAgB,iBAAiB,UAAsC,CACjE,YAAc,YAAW,UAAY,CAAC,EAC5C,CAMA,SAAgB,qBACd,KACA,mBAAsC,GAChC,CACN,UAAY,KACZ,wBAA0B,cAC5B,CAGA,SAAgB,sBAAgC,CAC9C,OAAO,UAAU,KAAM,GAAM,EAAE,UAAU,GAAK,wBAAwB,CACxE,CAEA,SAAS,OAAO,KAAyD,KAAoB,CAC3F,IAAK,IAAM,YAAY,UAAY,CAAC,GAAG,UAAW,SAAS,EAAI,UAC7D,GAAI,CACF,IAAM,OAAS,KAAK,QAAQ,EACxB,QAAU,OAAQ,OAAyB,OAAU,YACrD,OAAyB,MAAO,KAAiB,OAAO,SAAU,KAAM,GAAG,CAAC,CAElF,OAAS,IAAK,CACZ,OAAO,SAAU,KAAM,GAAG,CAC5B,CAEJ,CAEA,SAAS,OAAO,SAAoB,KAAc,IAAoB,CAMpE,GAAI,CACF,IAAI,MAAM,CAAE,GAAI,EAAG,GAAG,SAAS,MAAQ,WAAW,GAAG,KAAK,iBAAiB,CAC7E,MAAQ,CAER,CACF,CAQA,SAAgB,YAAY,MAAgB,KAAuB,CACjE,OAAQ,GAAM,EAAE,UAAU,MAAO,IAAI,EAAG,SAAS,CACnD,CAGA,SAAgB,eAAe,KAA0B,CACvD,OAAQ,GAAM,EAAE,aAAa,IAAI,EAAG,YAAY,CAClD,C"}
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
|
|
2
|
-
//#region src/core/path.d.ts
|
|
3
2
|
/**
|
|
4
3
|
* Normalize a URL path segment:
|
|
5
4
|
* - '/' or '' or undefined → ''
|
|
@@ -29,6 +28,5 @@ declare function joinPaths(...segments: (string | undefined)[]): string;
|
|
|
29
28
|
* cannot drift.
|
|
30
29
|
*/
|
|
31
30
|
declare function buildMountPath(apiPrefix: string, version: number | false, path?: string): string;
|
|
32
|
-
//#endregion
|
|
33
31
|
export { joinPaths as n, normalizePath as r, buildMountPath as t };
|
|
34
|
-
//# sourceMappingURL=path-
|
|
32
|
+
//# sourceMappingURL=path-DsenzqJ7.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"path-DsenzqJ7.d.mts","names":[],"sources":["../src/core/path.ts"],"mappings":";;;;;;;;iBAOgB,cAAc;;;;;;;;;;;;iBAsBd,aAAa;;;;;;;;;iBAmBb,eAAe,mBAAmB,yBAAyB"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.
|
|
2
|
+
* @forinda/kickjs v10.15.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,4 +9,4 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
import{extname,join,normalize,resolve,sep}from"node:path";import{stat}from"node:fs/promises";const COMPRESSIBLE_TYPES={html:`text/html; charset=utf-8`,css:`text/css; charset=utf-8`,js:`text/javascript; charset=utf-8`,mjs:`text/javascript; charset=utf-8`,json:`application/json; charset=utf-8`,map:`application/json; charset=utf-8`,webmanifest:`application/manifest+json; charset=utf-8`,svg:`image/svg+xml`,txt:`text/plain; charset=utf-8`,xml:`application/xml; charset=utf-8`,wasm:`application/wasm`},ENCODINGS=[[`br`,`.br`],[`gzip`,`.gz`]];function acceptsEncoding(header,encoding){let star=!1;for(let part of header.toLowerCase().split(`,`)){let[name,...params]=part.trim().split(`;`),q=params.map(p=>p.trim()).find(p=>p.startsWith(`q=`)),allowed=!q||Number(q.slice(2))>0;if(name===encoding)return allowed;name===`*`&&(star=allowed)}return star}function withPrecompressed(root,serve){let base=resolve(root);return(req,res,next)=>{if(req.method!==`GET`&&req.method!==`HEAD`||req.headers.range)return serve(req,res,next);let url=req.url,q=url.indexOf(`?`),pathname=(q===-1?url:url.slice(0,q)).replace(/\/$/,`/index.html`),rel;try{rel=decodeURIComponent(pathname)}catch{return serve(req,res,next)}let type=COMPRESSIBLE_TYPES[extname(rel).slice(1).toLowerCase()];if(!type)return serve(req,res,next);let file=join(base,normalize(rel));if(!file.startsWith(base+sep))return serve(req,res,next);let vary=String(res.getHeader(`Vary`)??``);/\baccept-encoding\b/i.test(vary)||res.setHeader(`Vary`,vary?`${vary}, Accept-Encoding`:`Accept-Encoding`);let accept=String(req.headers[`accept-encoding`]??``);(async()=>{if(!(await stat(file).catch(()=>void 0))?.isFile())return serve(req,res,next);for(let[encoding,ext]of ENCODINGS)if(acceptsEncoding(accept,encoding)&&(await stat(file+ext).catch(()=>void 0))?.isFile())return res.setHeader(`Content-Encoding`,encoding),res.setHeader(`Content-Type`,type),req.url=pathname+ext+(q===-1?``:url.slice(q)),serve(req,res,err=>{res.removeHeader(`Content-Encoding`),res.removeHeader(`Content-Type`),req.url=url,next(err)});serve(req,res,next)})().catch(next)}}export{withPrecompressed as t};
|
|
12
|
-
//# sourceMappingURL=precompressed-
|
|
12
|
+
//# sourceMappingURL=precompressed-BtwmgzyS.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"precompressed-
|
|
1
|
+
{"version":3,"file":"precompressed-BtwmgzyS.mjs","names":[],"sources":["../src/http/runtimes/precompressed.ts"],"sourcesContent":["/**\n * Serve a file's precompressed sibling — `app.js.br`, `app.js.gz` — when the\n * client accepts it. In front of `serve-static` on every runtime, so one\n * `.br` written at build time saves compressing the file on each request.\n */\nimport { stat } from 'node:fs/promises'\nimport { extname, join, normalize, resolve, sep } from 'node:path'\nimport type { ConnectHandler, ConnectNext } from '../connect'\n\n/**\n * The text types worth compressing, by extension — the files a sibling is\n * looked for, and the ones `kick build` precompresses. Their `Content-Type`\n * is the original file's, not the sibling's.\n */\nexport const COMPRESSIBLE_TYPES: Readonly<Record<string, string>> = {\n html: 'text/html; charset=utf-8',\n css: 'text/css; charset=utf-8',\n js: 'text/javascript; charset=utf-8',\n mjs: 'text/javascript; charset=utf-8',\n json: 'application/json; charset=utf-8',\n map: 'application/json; charset=utf-8',\n webmanifest: 'application/manifest+json; charset=utf-8',\n svg: 'image/svg+xml',\n txt: 'text/plain; charset=utf-8',\n xml: 'application/xml; charset=utf-8',\n wasm: 'application/wasm',\n}\n\n/** Preferred first. */\nconst ENCODINGS = [\n ['br', '.br'],\n ['gzip', '.gz'],\n] as const\n\n/** Whether `Accept-Encoding` allows `encoding` — named, or via `*`, and not `q=0`. */\nexport function acceptsEncoding(header: string, encoding: string): boolean {\n let star = false\n for (const part of header.toLowerCase().split(',')) {\n const [name, ...params] = part.trim().split(';')\n const q = params.map((p) => p.trim()).find((p) => p.startsWith('q='))\n const allowed = !q || Number(q.slice(2)) > 0\n if (name === encoding) return allowed\n if (name === '*') star = allowed\n }\n return star\n}\n\n/** Wrap a `serve-static` handler for `root` so it serves precompressed siblings. */\nexport function withPrecompressed(root: string, serve: ConnectHandler): ConnectHandler {\n const base = resolve(root)\n return (req, res, next) => {\n // A byte range is a range of the file as stored; serve the original.\n if ((req.method !== 'GET' && req.method !== 'HEAD') || req.headers.range) {\n return serve(req, res, next)\n }\n const url = req.url\n const q = url.indexOf('?')\n // serve-static answers a directory with its index.html; so does this.\n const pathname = (q === -1 ? url : url.slice(0, q)).replace(/\\/$/, '/index.html')\n let rel: string\n try {\n rel = decodeURIComponent(pathname)\n } catch {\n return serve(req, res, next)\n }\n const type = COMPRESSIBLE_TYPES[extname(rel).slice(1).toLowerCase()]\n if (!type) return serve(req, res, next)\n const file = join(base, normalize(rel))\n if (!file.startsWith(base + sep)) return serve(req, res, next)\n\n // Whether the response is compressed depends on the request's encoding.\n const vary = String(res.getHeader('Vary') ?? '')\n if (!/\\baccept-encoding\\b/i.test(vary)) {\n res.setHeader('Vary', vary ? `${vary}, Accept-Encoding` : 'Accept-Encoding')\n }\n const accept = String(req.headers['accept-encoding'] ?? '')\n ;(async () => {\n // A sibling stands in for its file — never for one that's gone.\n if (!(await stat(file).catch(() => undefined))?.isFile()) return serve(req, res, next)\n for (const [encoding, ext] of ENCODINGS) {\n if (!acceptsEncoding(accept, encoding)) continue\n const sibling = await stat(file + ext).catch(() => undefined)\n if (!sibling?.isFile()) continue\n res.setHeader('Content-Encoding', encoding)\n // serve-static types the response by the path it serves only when\n // nothing has set a type — so the sibling is served as the original.\n res.setHeader('Content-Type', type)\n req.url = pathname + ext + (q === -1 ? '' : url.slice(q))\n // The sibling went away before serve-static read it: undo, carry on.\n const restore: ConnectNext = (err) => {\n res.removeHeader('Content-Encoding')\n res.removeHeader('Content-Type')\n req.url = url\n next(err)\n }\n return serve(req, res, restore)\n }\n serve(req, res, next)\n })().catch(next)\n }\n}\n"],"mappings":";;;;;;;;;;A,6FAcA,MAAa,mBAAuD,CAClE,KAAM,2BACN,IAAK,0BACL,GAAI,iCACJ,IAAK,iCACL,KAAM,kCACN,IAAK,kCACL,YAAa,2CACb,IAAK,gBACL,IAAK,4BACL,IAAK,iCACL,KAAM,kBACR,EAGM,UAAY,CAChB,CAAC,KAAM,KAAK,EACZ,CAAC,OAAQ,KAAK,CAChB,EAGA,SAAgB,gBAAgB,OAAgB,SAA2B,CACzE,IAAI,KAAO,GACX,IAAK,IAAM,QAAQ,OAAO,YAAY,CAAC,CAAC,MAAM,GAAG,EAAG,CAClD,GAAM,CAAC,KAAM,GAAG,QAAU,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,EACzC,EAAI,OAAO,IAAK,GAAM,EAAE,KAAK,CAAC,CAAC,CAAC,KAAM,GAAM,EAAE,WAAW,IAAI,CAAC,EAC9D,QAAU,CAAC,GAAK,OAAO,EAAE,MAAM,CAAC,CAAC,EAAI,EAC3C,GAAI,OAAS,SAAU,OAAO,QAC1B,OAAS,MAAK,KAAO,QAC3B,CACA,OAAO,IACT,CAGA,SAAgB,kBAAkB,KAAc,MAAuC,CACrF,IAAM,KAAO,QAAQ,IAAI,EACzB,OAAQ,IAAK,IAAK,OAAS,CAEzB,GAAK,IAAI,SAAW,OAAS,IAAI,SAAW,QAAW,IAAI,QAAQ,MACjE,OAAO,MAAM,IAAK,IAAK,IAAI,EAE7B,IAAM,IAAM,IAAI,IACV,EAAI,IAAI,QAAQ,GAAG,EAEnB,UAAY,IAAM,GAAK,IAAM,IAAI,MAAM,EAAG,CAAC,EAAA,CAAG,QAAQ,MAAO,aAAa,EAC5E,IACJ,GAAI,CACF,IAAM,mBAAmB,QAAQ,CACnC,MAAQ,CACN,OAAO,MAAM,IAAK,IAAK,IAAI,CAC7B,CACA,IAAM,KAAO,mBAAmB,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,GAClE,GAAI,CAAC,KAAM,OAAO,MAAM,IAAK,IAAK,IAAI,EACtC,IAAM,KAAO,KAAK,KAAM,UAAU,GAAG,CAAC,EACtC,GAAI,CAAC,KAAK,WAAW,KAAO,GAAG,EAAG,OAAO,MAAM,IAAK,IAAK,IAAI,EAG7D,IAAM,KAAO,OAAO,IAAI,UAAU,MAAM,GAAK,EAAE,EAC1C,uBAAuB,KAAK,IAAI,GACnC,IAAI,UAAU,OAAQ,KAAO,GAAG,KAAK,mBAAqB,iBAAiB,EAE7E,IAAM,OAAS,OAAO,IAAI,QAAQ,oBAAsB,EAAE,GACxD,SAAY,CAEZ,GAAI,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,UAAY,IAAA,EAAS,EAAA,EAAI,OAAO,EAAG,OAAO,MAAM,IAAK,IAAK,IAAI,EACrF,IAAK,GAAM,CAAC,SAAU,OAAQ,UAG5B,GAFK,gBAAgB,OAAQ,QAAQ,IAEhC,MADiB,KAAK,KAAO,GAAG,CAAC,CAAC,UAAY,IAAA,EAAS,EAAA,EAC9C,OAAO,EAarB,OAZA,IAAI,UAAU,mBAAoB,QAAQ,EAG1C,IAAI,UAAU,eAAgB,IAAI,EAClC,IAAI,IAAM,SAAW,KAAO,IAAM,GAAK,GAAK,IAAI,MAAM,CAAC,GAQhD,MAAM,IAAK,IANY,KAAQ,CACpC,IAAI,aAAa,kBAAkB,EACnC,IAAI,aAAa,cAAc,EAC/B,IAAI,IAAM,IACV,KAAK,GAAG,CACV,CAC8B,EAEhC,MAAM,IAAK,IAAK,IAAI,CACtB,EAAA,CAAG,CAAC,CAAC,MAAM,IAAI,CACjB,CACF,C"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.
|
|
2
|
+
* @forinda/kickjs v10.15.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,4 +9,4 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
const FILTER_OPERATORS=/* @__PURE__ */ new Set([`eq`,`neq`,`gt`,`gte`,`lt`,`lte`,`between`,`in`,`contains`,`starts`,`ends`]),BUILTIN_DEFAULTS={maxLimit:100,defaultLimit:20,maxSearchLength:200,defaultPage:1},defaults={...BUILTIN_DEFAULTS};function setQueryParsingDefaults(partial){partial.maxLimit!==void 0&&(defaults.maxLimit=partial.maxLimit),partial.defaultLimit!==void 0&&(defaults.defaultLimit=partial.defaultLimit),partial.maxSearchLength!==void 0&&(defaults.maxSearchLength=partial.maxSearchLength)}function getQueryParsingDefaults(){return{...defaults}}function resetQueryParsingDefaults(){Object.assign(defaults,BUILTIN_DEFAULTS)}function parseFilters(filterParam,allowedFields,options){if(!filterParam)return[];let items=Array.isArray(filterParam)?filterParam:[filterParam],results=[],allowed=allowedFields?new Set(allowedFields):null,onReject=options?.onReject;for(let item of items){let firstColon=item.indexOf(`:`);if(firstColon===-1)continue;let secondColon=item.indexOf(`:`,firstColon+1);if(secondColon===-1)continue;let field=item.slice(0,firstColon),operator=item.slice(firstColon+1,secondColon),value=item.slice(secondColon+1);field&&value&&(FILTER_OPERATORS.has(operator)?allowed&&!allowed.has(field)?onReject?.({kind:`filter`,field,reason:`field-not-allowed`}):results.push({field,operator,value}):onReject?.({kind:`filter`,field,reason:`unknown-operator`}))}return results}function parseSort(sortParam,allowedFields,options){if(!sortParam)return[];let items=(Array.isArray(sortParam)?sortParam:[sortParam]).flatMap(s=>s.split(`,`)),results=[],allowed=allowedFields?new Set(allowedFields):null,onReject=options?.onReject;for(let raw of items){let item=raw.trim();if(!item)continue;let field,dir,lastColon=item.lastIndexOf(`:`);lastColon===-1?item.startsWith(`-`)?(field=item.slice(1),dir=`desc`):(field=item.startsWith(`+`)?item.slice(1):item,dir=`asc`):(field=item.slice(0,lastColon),dir=item.slice(lastColon+1).toLowerCase()),field&&(dir===`asc`||dir===`desc`)&&(allowed&&!allowed.has(field)?onReject?.({kind:`sort`,field,reason:`field-not-allowed`}):results.push({field,direction:dir}))}return results}function parsePagination(params,options){let defaultLimit=options?.defaultLimit??defaults.defaultLimit,maxLimit=options?.maxLimit??defaults.maxLimit,page=typeof params.page==`string`?Number.parseInt(params.page,10):params.page??defaults.defaultPage,limit=typeof params.limit==`string`?Number.parseInt(params.limit,10):params.limit??defaultLimit;return(Number.isNaN(page)||page<1)&&(page=defaults.defaultPage),(Number.isNaN(limit)||limit<1)&&(limit=defaultLimit),limit>maxLimit&&(limit=maxLimit),{page,limit,offset:(page-1)*limit}}function parseSearchQuery(q,options){if(!q)return``;let maxLen=options?.maxSearchLength??defaults.maxSearchLength,trimmed=q.trim();return trimmed.length>maxLen?(options?.onReject?.({kind:`search`,field:`q`,reason:`truncated`}),trimmed.slice(0,maxLen)):trimmed}function normalizeFieldConfig(config){if(config)return`columns`in config&&config.columns&&typeof config.columns==`object`?{filterable:Object.keys(config.columns),sortable:config.sortable?Object.keys(config.sortable):void 0,searchable:void 0}:config}function parseQuery(query,fieldConfig,options){let normalized=normalizeFieldConfig(fieldConfig),rejectOpts=options?.onReject?{onReject:options.onReject}:void 0;return{filters:parseFilters(query.filter,normalized?.filterable,rejectOpts),sort:parseSort(query.sort,normalized?.sortable,rejectOpts),pagination:parsePagination({page:query.page,limit:query.limit},options),search:parseSearchQuery(query.q,options)}}function buildQueryParams(parsed){let params={};return parsed.filters?.length&&(params.filter=parsed.filters.map(f=>`${f.field}:${f.operator}:${f.value}`)),parsed.sort?.length&&(params.sort=parsed.sort.map(s=>`${s.field}:${s.direction}`)),parsed.pagination&&(params.page=parsed.pagination.page,params.limit=parsed.pagination.limit),parsed.search&&(params.q=parsed.search),params}export{parseQuery as a,resetQueryParsingDefaults as c,parsePagination as i,setQueryParsingDefaults as l,getQueryParsingDefaults as n,parseSearchQuery as o,parseFilters as r,parseSort as s,buildQueryParams as t,FILTER_OPERATORS as u};
|
|
12
|
-
//# sourceMappingURL=query-
|
|
12
|
+
//# sourceMappingURL=query-Dr28oT30.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"query-Dr28oT30.mjs","names":[],"sources":["../src/http/query/types.ts","../src/http/query/parse-query.ts"],"sourcesContent":["/** Supported filter operators for query string parsing */\nexport type FilterOperator =\n | 'eq'\n | 'neq'\n | 'gt'\n | 'gte'\n | 'lt'\n | 'lte'\n | 'between'\n | 'in'\n | 'contains'\n | 'starts'\n | 'ends'\n\n/** Every operator `?filter=field:op:value` accepts; a filter with any other operator is dropped. */\nexport const FILTER_OPERATORS = new Set<string>([\n 'eq',\n 'neq',\n 'gt',\n 'gte',\n 'lt',\n 'lte',\n 'between',\n 'in',\n 'contains',\n 'starts',\n 'ends',\n])\n\n/** One parsed `?filter=field:operator:value`. */\nexport interface FilterItem {\n field: string\n operator: FilterOperator\n value: string\n}\n\n/** One parsed `?sort=field:direction`. */\nexport interface SortItem {\n field: string\n direction: 'asc' | 'desc'\n}\n\n/** Parsed pagination: `page`, `limit`, and the `offset` they give. */\nexport interface PaginationParams {\n page: number\n limit: number\n offset: number\n}\n\n/**\n * The result of parsing a query string. ORM-agnostic — pass this to\n * a query builder adapter (Drizzle, Prisma, Sequelize, etc.) to produce\n * database-specific query objects.\n */\nexport interface ParsedQuery {\n filters: FilterItem[]\n sort: SortItem[]\n pagination: PaginationParams\n search: string\n}\n\n/**\n * Helper that extracts the literal field union from a `QueryFieldConfig`\n * key. When the user passes `{ filterable: ['status', 'category'] } as const`,\n * `FieldsOf<typeof config, 'filterable'>` resolves to `'status' | 'category'`.\n *\n * Without `as const`, the arrays widen to `string[]` and the union falls\n * back to `string`. This is the documented escape hatch.\n */\nexport type FieldsOf<\n TConfig extends QueryFieldConfig | undefined,\n K extends 'filterable' | 'sortable' | 'searchable',\n> = TConfig extends { readonly [P in K]: readonly (infer F)[] }\n ? F extends string\n ? F\n : string\n : TConfig extends { columns: infer C }\n ? K extends 'filterable'\n ? keyof C & string\n : string\n : string\n\n/**\n * Narrowed `ParsedQuery` whose `filters[].field` and `sort[].field`\n * unions are constrained to the literal whitelist passed to\n * `ctx.qs()` / `parseQuery()`. Extends `ParsedQuery`, so any function\n * accepting `ParsedQuery` accepts a `TypedParsedQuery<X>` automatically\n * (subtype assignment, no codegen, backward compatible).\n *\n * @example\n * ```ts\n * const parsed = ctx.qs({\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt'],\n * } as const)\n * parsed.filters[0]?.field // 'status' | 'priority'\n * parsed.sort[0]?.field // 'createdAt'\n * ```\n */\nexport interface TypedParsedQuery<\n TConfig extends QueryFieldConfig | undefined,\n> extends ParsedQuery {\n filters: Array<FilterItem & { field: FieldsOf<TConfig, 'filterable'> }>\n sort: Array<SortItem & { field: FieldsOf<TConfig, 'sortable'> }>\n}\n\n/**\n * Restrict which fields can be filtered, sorted, or searched.\n * Fields not in the allow-list are silently ignored.\n *\n * Accepts two forms:\n * 1. **String arrays** (standard): `{ filterable: ['name', 'status'], sortable: ['createdAt'] }`\n * 2. **Column-object maps** (Drizzle-style): `{ columns: { name: col, status: col }, sortable: { createdAt: col } }`\n *\n * When column-object maps are provided, `Object.keys()` is used to derive the field names.\n */\nexport type QueryFieldConfig = StringQueryFieldConfig | ColumnQueryFieldConfig\n\nexport interface StringQueryFieldConfig {\n filterable?: string[]\n sortable?: string[]\n searchable?: string[]\n}\n\n/**\n * Column-object-based field config (e.g., from DrizzleQueryParamsConfig).\n * Keys are the field names used in query strings; values are ORM column references.\n */\nexport interface ColumnQueryFieldConfig {\n columns: Record<string, any>\n sortable?: Record<string, any>\n searchColumns?: any[]\n [key: string]: any\n}\n\n/** Standardized paginated response shape */\nexport interface PaginatedResponse<T = any> {\n data: T[]\n meta: {\n page: number\n limit: number\n total: number\n totalPages: number\n hasNext: boolean\n hasPrev: boolean\n }\n /**\n * Relative links (path + query, never a host) to this page and its\n * neighbours. `next` / `prev` are `null` at the ends.\n */\n links: { self: string; next: string | null; prev: string | null }\n}\n\n/** A JSON primitive stored in a cursor. Dates arrive as ISO strings. */\nexport type CursorValue = string | number | boolean | null\n\n/**\n * Where the previous page ended: the last row's values for the active sort\n * fields plus the id tie-breaker, keyed by field name — e.g.\n * `{ createdAt: '2026-01-01T00:00:00.000Z', id: 'u7' }`.\n *\n * Decoded from a client-supplied cursor and NOT signed: treat it as untrusted\n * input. Bind the values as query parameters and keep filters / authorization\n * scoping in the fetcher, so a forged cursor can only move the position,\n * never widen what the caller may see.\n */\nexport type CursorPosition = Readonly<Record<string, CursorValue>>\n\n/** What `ctx.paginateCursor()` hands its fetcher. */\nexport interface CursorQuery<TConfig extends QueryFieldConfig | undefined = undefined> extends Omit<\n TypedParsedQuery<TConfig>,\n 'pagination'\n> {\n /** `null` on the first page. */\n cursor: CursorPosition | null\n /** Page size. Fetch `limit + 1` rows — the extra one tells whether a next page exists. */\n limit: number\n}\n\n/** Options for `ctx.paginateCursor()`. */\nexport interface CursorPaginateOptions<T = any> {\n /** Unique, stable tie-breaker field read off each row. Default `'id'`. */\n idField?: string\n /**\n * Build the cursor values from a row yourself, instead of reading the sort\n * fields + `idField` off it (e.g. when the row shape differs from the\n * sortable field names). Values must be JSON primitives.\n */\n cursorKey?: (row: T) => Record<string, CursorValue>\n}\n\n/** Standardized cursor (keyset) paginated response shape */\nexport interface CursorPaginatedResponse<T = any> {\n data: T[]\n meta: {\n limit: number\n hasNext: boolean\n /** Opaque; pass back as `?cursor=` for the next page. `null` on the last page. */\n nextCursor: string | null\n }\n /** Relative links (path + query, never a host); `next` is `null` on the last page. */\n links: { self: string; next: string | null }\n}\n\n/**\n * Interface for ORM-specific query builder adapters.\n * Implement this to translate a `ParsedQuery` into your ORM's query format.\n *\n * @example\n * ```ts\n * // Drizzle adapter\n * class DrizzleQueryAdapter implements QueryBuilderAdapter<DrizzleQueryResult> {\n * build(parsed: ParsedQuery, config: DrizzleConfig): DrizzleQueryResult {\n * // Convert filters → Drizzle SQL conditions\n * // Convert sort → Drizzle orderBy\n * return { where, orderBy, limit, offset }\n * }\n * }\n *\n * // Prisma adapter\n * class PrismaQueryAdapter implements QueryBuilderAdapter<PrismaQueryResult> {\n * build(parsed: ParsedQuery, config: PrismaConfig): PrismaQueryResult {\n * return { where, orderBy, skip, take }\n * }\n * }\n * ```\n */\nexport interface QueryBuilderAdapter<TResult = any, TConfig = any> {\n /** Human-readable name for debugging */\n readonly name: string\n\n /**\n * Convert a ParsedQuery into an ORM-specific query object.\n * @param parsed - The ORM-agnostic parsed query\n * @param config - ORM-specific configuration (column maps, search columns, etc.)\n */\n build(parsed: ParsedQuery, config: TConfig): TResult\n}\n","import {\n FILTER_OPERATORS,\n type FilterItem,\n type FilterOperator,\n type SortItem,\n type PaginationParams,\n type ParsedQuery,\n type QueryFieldConfig,\n type StringQueryFieldConfig,\n type TypedParsedQuery,\n} from './types'\n\n// ── Configurable defaults ───────────────────────────────────────────────\n\n/**\n * Why a rejected field/value was dropped. Surfaced through\n * {@link ParseQueryOptions.onReject} so a caller can warn, count, or\n * return a 400 instead of the historical silent drop.\n */\nexport type QueryRejectReason = 'field-not-allowed' | 'unknown-operator' | 'truncated'\n\n/** A filter, sort or search the parser dropped or truncated, passed to `onReject`. */\nexport interface QueryRejection {\n kind: 'filter' | 'sort' | 'search'\n field: string\n reason: QueryRejectReason\n}\n\n/**\n * Per-call limits for {@link parseQuery}, overriding the global defaults, plus an `onReject` hook.\n *\n * @see https://kickjs.app/guide/query-parsing\n */\nexport interface ParseQueryOptions {\n /** Hard cap on `limit`. Default: global (100, override via {@link setQueryParsingDefaults}). */\n maxLimit?: number\n /** `limit` when the query omits one. Default: global (20). */\n defaultLimit?: number\n /** Max `q` length before truncation. Default: global (200). */\n maxSearchLength?: number\n /**\n * Called once per dropped filter/sort field or truncated search.\n * The historical behaviour is a silent drop; wire this to a logger or\n * a 400 to make over-broad / typo'd queries visible.\n */\n onReject?: (rejection: QueryRejection) => void\n}\n\ninterface QueryParsingDefaults {\n maxLimit: number\n defaultLimit: number\n maxSearchLength: number\n defaultPage: number\n}\n\nconst BUILTIN_DEFAULTS: QueryParsingDefaults = {\n maxLimit: 100,\n defaultLimit: 20,\n maxSearchLength: 200,\n defaultPage: 1,\n}\n\nconst defaults: QueryParsingDefaults = { ...BUILTIN_DEFAULTS }\n\n/**\n * Globally override the query-parsing limits — call once at bootstrap.\n * Per-call {@link ParseQueryOptions} still take precedence over these.\n */\nexport function setQueryParsingDefaults(\n partial: Partial<Omit<QueryParsingDefaults, 'defaultPage'>>,\n): void {\n if (partial.maxLimit !== undefined) defaults.maxLimit = partial.maxLimit\n if (partial.defaultLimit !== undefined) defaults.defaultLimit = partial.defaultLimit\n if (partial.maxSearchLength !== undefined) defaults.maxSearchLength = partial.maxSearchLength\n}\n\n/** Read the current global query-parsing defaults (a copy). */\nexport function getQueryParsingDefaults(): Readonly<QueryParsingDefaults> {\n return { ...defaults }\n}\n\n/**\n * Restore the built-in query-parsing defaults (maxLimit 100, defaultLimit\n * 20, maxSearchLength 200). Useful in test teardown after a\n * {@link setQueryParsingDefaults} override so global state can't leak\n * between tests.\n */\nexport function resetQueryParsingDefaults(): void {\n Object.assign(defaults, BUILTIN_DEFAULTS)\n}\n\n// ── Individual parsers ──────────────────────────────────────────────────\n\n/** Parse filter strings like \"status:eq:active\" into structured objects */\nexport function parseFilters(\n filterParam: string | string[] | undefined,\n allowedFields?: string[],\n options?: Pick<ParseQueryOptions, 'onReject'>,\n): FilterItem[] {\n if (!filterParam) return []\n\n const items = Array.isArray(filterParam) ? filterParam : [filterParam]\n const results: FilterItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n const onReject = options?.onReject\n\n for (const item of items) {\n // Split on first two colons only — value may contain colons (e.g. timestamps)\n const firstColon = item.indexOf(':')\n if (firstColon === -1) continue\n\n const secondColon = item.indexOf(':', firstColon + 1)\n if (secondColon === -1) continue\n\n const field = item.slice(0, firstColon)\n const operator = item.slice(firstColon + 1, secondColon)\n const value = item.slice(secondColon + 1)\n\n if (!field || !value) continue\n if (!FILTER_OPERATORS.has(operator)) {\n onReject?.({ kind: 'filter', field, reason: 'unknown-operator' })\n continue\n }\n if (allowed && !allowed.has(field)) {\n onReject?.({ kind: 'filter', field, reason: 'field-not-allowed' })\n continue\n }\n\n results.push({ field, operator: operator as FilterOperator, value })\n }\n\n return results\n}\n\n/**\n * Parse sort into structured items. Accepts `field:asc|desc`, `-field`\n * (descending), and `field` / `+field` (ascending), repeated or\n * comma-separated: `?sort=-featured,price` = `?sort=featured:desc&sort=price:asc`.\n */\nexport function parseSort(\n sortParam: string | string[] | undefined,\n allowedFields?: string[],\n options?: Pick<ParseQueryOptions, 'onReject'>,\n): SortItem[] {\n if (!sortParam) return []\n\n const items = (Array.isArray(sortParam) ? sortParam : [sortParam]).flatMap((s) => s.split(','))\n const results: SortItem[] = []\n const allowed = allowedFields ? new Set(allowedFields) : null\n const onReject = options?.onReject\n\n for (const raw of items) {\n // `+` in a query string arrives as a space; trim covers `+field` too.\n const item = raw.trim()\n if (!item) continue\n let field: string\n let dir: string\n const lastColon = item.lastIndexOf(':')\n if (lastColon !== -1) {\n // Split on the last colon so field names with colons work.\n field = item.slice(0, lastColon)\n dir = item.slice(lastColon + 1).toLowerCase()\n } else if (item.startsWith('-')) {\n field = item.slice(1)\n dir = 'desc'\n } else {\n field = item.startsWith('+') ? item.slice(1) : item\n dir = 'asc'\n }\n\n if (!field) continue\n if (dir !== 'asc' && dir !== 'desc') continue\n if (allowed && !allowed.has(field)) {\n onReject?.({ kind: 'sort', field, reason: 'field-not-allowed' })\n continue\n }\n\n results.push({ field, direction: dir })\n }\n\n return results\n}\n\n/** Parse page/limit into pagination with computed offset */\nexport function parsePagination(\n params: {\n page?: string | number\n limit?: string | number\n },\n options?: Pick<ParseQueryOptions, 'maxLimit' | 'defaultLimit'>,\n): PaginationParams {\n const defaultLimit = options?.defaultLimit ?? defaults.defaultLimit\n const maxLimit = options?.maxLimit ?? defaults.maxLimit\n\n let page =\n typeof params.page === 'string'\n ? Number.parseInt(params.page, 10)\n : (params.page ?? defaults.defaultPage)\n let limit =\n typeof params.limit === 'string'\n ? Number.parseInt(params.limit, 10)\n : (params.limit ?? defaultLimit)\n\n if (Number.isNaN(page) || page < 1) page = defaults.defaultPage\n if (Number.isNaN(limit) || limit < 1) limit = defaultLimit\n if (limit > maxLimit) limit = maxLimit\n\n return { page, limit, offset: (page - 1) * limit }\n}\n\n/** Sanitize and truncate search query */\nexport function parseSearchQuery(\n q: string | undefined,\n options?: Pick<ParseQueryOptions, 'maxSearchLength' | 'onReject'>,\n): string {\n if (!q) return ''\n const maxLen = options?.maxSearchLength ?? defaults.maxSearchLength\n const trimmed = q.trim()\n if (trimmed.length > maxLen) {\n options?.onReject?.({ kind: 'search', field: 'q', reason: 'truncated' })\n return trimmed.slice(0, maxLen)\n }\n return trimmed\n}\n\n// ── Config normalizer ───────────────────────────────────────────────────\n\n/**\n * Normalize a QueryFieldConfig into the string-based form.\n * Detects column-object-based configs (DrizzleQueryParamsConfig) by checking\n * for a `columns` property and extracts `Object.keys()`.\n */\nfunction normalizeFieldConfig(config?: QueryFieldConfig): StringQueryFieldConfig | undefined {\n if (!config) return undefined\n\n // Column-object-based config (e.g., DrizzleQueryParamsConfig)\n if ('columns' in config && config.columns && typeof config.columns === 'object') {\n return {\n filterable: Object.keys(config.columns),\n sortable: config.sortable ? Object.keys(config.sortable) : undefined,\n searchable: undefined, // searchColumns are Column objects, not used for string filtering\n }\n }\n\n // Already string-based\n return config as StringQueryFieldConfig\n}\n\n// ── Combined parser ─────────────────────────────────────────────────────\n\n/**\n * Parse a raw Express query object into a structured, ORM-agnostic ParsedQuery.\n *\n * @param query - Raw query string object from `req.query` or Zod-validated object\n * @param fieldConfig - Optional field restrictions (whitelist filterable/sortable/searchable).\n * Accepts both string-based configs (`{ filterable, sortable, searchable }`) and\n * column-object configs (`{ columns, sortable, searchColumns }`).\n * @param options - Limits + an `onReject` hook for dropped/truncated input.\n *\n * @example\n * ```ts\n * // String-based config\n * const parsed = parseQuery(ctx.query, {\n * filterable: ['status', 'priority'],\n * sortable: ['createdAt', 'title'],\n * })\n *\n * // Column-object config (DrizzleQueryParamsConfig)\n * const parsed = parseQuery(ctx.query, TASK_QUERY_CONFIG)\n * ```\n *\n * Query string format:\n * - Filters: `?filter=field:operator:value` (repeatable)\n * - Sort: `?sort=field:asc|desc`, `-field` / `field`, repeatable or comma-separated\n * - Pagination: `?page=1&limit=20`\n * - Search: `?q=search+term`\n *\n * Filter operators: eq, neq, gt, gte, lt, lte, between, in, contains, starts, ends\n */\nexport function parseQuery<TConfig extends QueryFieldConfig | undefined = undefined>(\n query: Record<string, any>,\n fieldConfig?: TConfig,\n options?: ParseQueryOptions,\n): TypedParsedQuery<TConfig> {\n const normalized = normalizeFieldConfig(fieldConfig)\n const rejectOpts = options?.onReject ? { onReject: options.onReject } : undefined\n return {\n filters: parseFilters(query.filter, normalized?.filterable, rejectOpts),\n sort: parseSort(query.sort, normalized?.sortable, rejectOpts),\n pagination: parsePagination({ page: query.page, limit: query.limit }, options),\n search: parseSearchQuery(query.q, options),\n } as TypedParsedQuery<TConfig>\n}\n\n// ── Query URL builder (for client-side or testing) ──────────────────────\n\n/** Convert ParsedQuery back into query string parameters */\nexport function buildQueryParams(\n parsed: Partial<ParsedQuery>,\n): Record<string, string | string[] | number> {\n const params: Record<string, string | string[] | number> = {}\n\n if (parsed.filters?.length) {\n params.filter = parsed.filters.map((f) => `${f.field}:${f.operator}:${f.value}`)\n }\n\n if (parsed.sort?.length) {\n params.sort = parsed.sort.map((s) => `${s.field}:${s.direction}`)\n }\n\n if (parsed.pagination) {\n params.page = parsed.pagination.page\n params.limit = parsed.pagination.limit\n }\n\n if (parsed.search) {\n params.q = parsed.search\n }\n\n return params\n}\n"],"mappings":"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"}
|
|
@@ -1,7 +1,11 @@
|
|
|
1
1
|
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
|
|
2
|
+
import { d as RouteFlagTest } from "./route-flag-CjXQl-oX.mjs";
|
|
3
|
+
import { a as ConnectRequest, i as ConnectNext, o as ConnectResponse } from "./connect-DamOelO8.mjs";
|
|
4
|
+
/**
|
|
5
|
+
* Where rate-limit counters live. Implement it to share counts across instances (Redis, KV).
|
|
6
|
+
*
|
|
7
|
+
* @see https://kickjs.app/guide/rate-limiting
|
|
8
|
+
*/
|
|
5
9
|
interface RateLimitStore {
|
|
6
10
|
increment(key: string): Promise<{
|
|
7
11
|
totalHits: number;
|
|
@@ -10,6 +14,11 @@ interface RateLimitStore {
|
|
|
10
14
|
decrement(key: string): Promise<void>;
|
|
11
15
|
reset(key: string): Promise<void>;
|
|
12
16
|
}
|
|
17
|
+
/**
|
|
18
|
+
* Options for {@link rateLimit}.
|
|
19
|
+
*
|
|
20
|
+
* @see https://kickjs.app/guide/rate-limiting
|
|
21
|
+
*/
|
|
13
22
|
interface RateLimitOptions {
|
|
14
23
|
/** Maximum number of requests per window (default: 100) */
|
|
15
24
|
max?: number;
|
|
@@ -85,6 +94,5 @@ declare class MemoryStore implements RateLimitStore {
|
|
|
85
94
|
* ```
|
|
86
95
|
*/
|
|
87
96
|
declare function rateLimit(options?: RateLimitOptions): (req: ConnectRequest, res: ConnectResponse, next: ConnectNext) => Promise<void>;
|
|
88
|
-
//#endregion
|
|
89
97
|
export { rateLimit as i, RateLimitOptions as n, RateLimitStore as r, MemoryStore as t };
|
|
90
|
-
//# sourceMappingURL=rate-limit-
|
|
98
|
+
//# sourceMappingURL=rate-limit-BQx_P6gG.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rate-limit-BQx_P6gG.d.mts","names":["Request","Response","NextFunction"],"sources":["../src/http/middleware/rate-limit.ts"],"mappings":";;;;;;;;UAkBiB;EACf,UAAU,cAAc;IAAU;IAAmB,WAAW;;EAChE,UAAU,cAAc;EACxB,MAAM,cAAc;;;;;;;UAQL;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,gBAAgB,KAAKA;;EAErB;;EAEA,QAAQ;;EAER,QAAQ,KAAKA;;EAEb;;;;;;;;;;;;;;;;;;;EAmBA,aAAa;;;cAIF,uBAAuB;mBACjB;UACT;;EAGR,YAAY,kBAAkB;;EAc9B;EAKM,UAAU,cAAc;IAAU;IAAmB,WAAW;;EAIhE,UAAU,cAAc;EAIxB,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;iBAyBZ,UAAU,UAAS,oBAAqB,KAwB1BA,gBAAO,KAAOC,iBAAQ,MAAQC,gBAAY"}
|
|
@@ -1,5 +1,4 @@
|
|
|
1
1
|
|
|
2
|
-
//#region src/core/reactivity.d.ts
|
|
3
2
|
/**
|
|
4
3
|
* Apply several writes as one update: watchers and ref subscribers run once,
|
|
5
4
|
* after `fn` returns, with the final values — never with a half-applied state.
|
|
@@ -17,6 +16,11 @@
|
|
|
17
16
|
* ```
|
|
18
17
|
*/
|
|
19
18
|
declare function batch<T>(fn: () => T): T;
|
|
19
|
+
/**
|
|
20
|
+
* A reactive value made by `ref()`. Reading `.value` tracks it; writing it notifies watchers and computed values.
|
|
21
|
+
*
|
|
22
|
+
* @see https://kickjs.app/guide/reactivity
|
|
23
|
+
*/
|
|
20
24
|
interface Ref<T = any> {
|
|
21
25
|
value: T;
|
|
22
26
|
/**
|
|
@@ -32,6 +36,7 @@ interface Ref<T = any> {
|
|
|
32
36
|
*/
|
|
33
37
|
toJSON(): T;
|
|
34
38
|
}
|
|
39
|
+
/** Options for `ref()`. */
|
|
35
40
|
interface RefOptions {
|
|
36
41
|
/**
|
|
37
42
|
* Make an object value deeply reactive: `r.value.count++` and
|
|
@@ -54,6 +59,11 @@ interface RefOptions {
|
|
|
54
59
|
* ```
|
|
55
60
|
*/
|
|
56
61
|
declare function ref<T>(initialValue: T, options?: RefOptions): Ref<T>;
|
|
62
|
+
/**
|
|
63
|
+
* A read-only value made by `computed()`, recomputed when its sources change.
|
|
64
|
+
*
|
|
65
|
+
* @see https://kickjs.app/guide/reactivity
|
|
66
|
+
*/
|
|
57
67
|
interface ComputedRef<T = any> {
|
|
58
68
|
readonly value: T;
|
|
59
69
|
/**
|
|
@@ -84,6 +94,7 @@ interface ComputedRef<T = any> {
|
|
|
84
94
|
* ```
|
|
85
95
|
*/
|
|
86
96
|
declare function computed<T>(getter: () => T): ComputedRef<T>;
|
|
97
|
+
/** Options for `watch()`. */
|
|
87
98
|
interface WatchOptions {
|
|
88
99
|
/** Run the callback immediately with the current value (default: false) */
|
|
89
100
|
immediate?: boolean;
|
|
@@ -109,6 +120,25 @@ type WatchSource<T> = Ref<T> | ComputedRef<T> | (() => T);
|
|
|
109
120
|
* ```
|
|
110
121
|
*/
|
|
111
122
|
declare function watch<T>(source: WatchSource<T>, callback: (newValue: T, oldValue: T) => void, options?: WatchOptions): () => void;
|
|
123
|
+
/**
|
|
124
|
+
* Create a deeply reactive proxy around an object or array. Property reads
|
|
125
|
+
* are tracked, writes and deletes trigger watchers and computed
|
|
126
|
+
* recalculations, and so do key additions and removals for code that
|
|
127
|
+
* iterates the keys (`Object.keys`, `for…in`, `in`). Nested objects and
|
|
128
|
+
* arrays are reactive too.
|
|
129
|
+
* @example
|
|
130
|
+
* ```ts
|
|
131
|
+
* const state = reactive({ users: 0, errors: 0 })
|
|
132
|
+
* const errorRate = computed(() =>
|
|
133
|
+
* state.users > 0 ? state.errors / state.users : 0
|
|
134
|
+
* )
|
|
135
|
+
* state.users = 100
|
|
136
|
+
* state.errors = 5
|
|
137
|
+
* console.log(errorRate.value) // 0.05
|
|
138
|
+
* ```
|
|
139
|
+
*
|
|
140
|
+
* @see https://kickjs.app/guide/reactivity
|
|
141
|
+
*/
|
|
112
142
|
declare function reactive<T extends object>(target: T): T;
|
|
113
143
|
/** Check if a value is a ref — from {@link ref}, {@link computed} or {@link toRef}. */
|
|
114
144
|
declare function isRef<T = any>(value: unknown): value is Ref<T> | ComputedRef<T>;
|
|
@@ -121,6 +151,5 @@ declare function unref<T>(value: Ref<T> | ComputedRef<T> | T): T;
|
|
|
121
151
|
declare function toRef<T extends object, K extends keyof T>(obj: T, key: K): Ref<T[K]>;
|
|
122
152
|
/** {@link toRef} for every property: live views onto the object, not copies. */
|
|
123
153
|
declare function toRefs<T extends object>(obj: T): { [K in keyof T]: Ref<T[K]>; };
|
|
124
|
-
//#endregion
|
|
125
154
|
export { batch as a, reactive as c, toRefs as d, unref as f, WatchOptions as i, ref as l, Ref as n, computed as o, watch as p, RefOptions as r, isRef as s, ComputedRef as t, toRef as u };
|
|
126
|
-
//# sourceMappingURL=reactivity-
|
|
155
|
+
//# sourceMappingURL=reactivity-KZOrwVeK.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reactivity-KZOrwVeK.d.mts","names":[],"sources":["../src/core/reactivity.ts"],"mappings":";;;;;;;;;;;;;;;;;iBAyKgB,MAAM,GAAG,UAAU,IAAI;;;;;;UAyBtB,IAAI;EACnB,OAAO;;;;;EAKP,UAAU,KAAK,UAAU,GAAG,UAAU;;;;;;;EAOtC,UAAU;;;UAIK;;;;;;EAMf;;;;;;;;;;;;;;;iBAgBc,IAAI,GAAG,cAAc,GAAG,UAAS,aAAkB,IAAI;;;;;;UA+DtD,YAAY;WAClB,OAAO;;;;;;EAMhB,UAAU;;;;;;;;;EASV;;;;;;;;;;;;;iBAcc,SAAS,GAAG,cAAc,IAAI,YAAY;;UAsDzC;;EAEf;;KAGG,YAAY,KAAK,IAAI,KAAK,YAAY,YAAY;;;;;;;;;;;;;;;;;;;;iBAqBvC,MAAM,GACpB,QAAQ,YAAY,IACpB,WAAW,UAAU,GAAG,UAAU,YAClC,UAAU;;;;;;;;;;;;;;;;;;;;iBAoFI,SAAS,kBAAkB,QAAQ,IAAI;;iBAoEvC,MAAM,SAAS,iBAAiB,SAAS,IAAI,KAAK,YAAY;;iBAK9D,MAAM,GAAG,OAAO,IAAI,KAAK,YAAY,KAAK,IAAI;;;;;iBAQ9C,MAAM,kBAAkB,gBAAgB,GAAG,KAAK,GAAG,KAAK,IAAI,IAAI,EAAE;;iBAmBlE,OAAO,kBAAkB,KAAK,OAAO,WAAW,IAAI,IAAI,EAAE"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.
|
|
2
|
+
* @forinda/kickjs v10.15.0
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{r as pendingResponse}from"./view-renderer-
|
|
12
|
-
//# sourceMappingURL=reply-
|
|
11
|
+
import{r as pendingResponse}from"./view-renderer-Bf1Wy-DQ.mjs";const REPLY_BRAND=Symbol.for(`kickjs.reply`);function reply(status,body,options){return options?.headers?{[REPLY_BRAND]:!0,status,body,headers:options.headers}:{[REPLY_BRAND]:!0,status,body}}reply.ok=body=>reply(200,body),reply.created=(body,options)=>reply(201,body,options?.location===void 0?options:{headers:{...options.headers,Location:options.location}}),reply.accepted=body=>reply(202,body),reply.noContent=()=>reply(204,void 0);function isReply(value){return typeof value==`object`&&!!value&&value[REPLY_BRAND]===!0}const RESPOND=Symbol.for(`kickjs.respond`);function isRespondable(value){return typeof value==`object`&&!!value&&typeof value[RESPOND]==`function`}function applyHandlerResult(ctx,result){let pending=pendingResponse(ctx);if(pending)return pending.then(()=>!0);if(result===void 0)return!1;if(isRespondable(result)){let sent=result[RESPOND](ctx);return typeof sent?.then!=`function`||Promise.resolve(sent).then(()=>!0)}if(isReply(result)){if(result.headers)for(let[name,value]of Object.entries(result.headers))ctx.setHeader(name,value);return result.status===204?(ctx.noContent(),!0):(ctx.json(result.body,result.status),!0)}return ctx.json(result),!0}export{reply as a,isRespondable as i,applyHandlerResult as n,isReply as r,RESPOND as t};
|
|
12
|
+
//# sourceMappingURL=reply-ChoI5SvM.mjs.map
|