@forinda/kickjs 10.13.0 → 10.13.1
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/{application-dhmb3PMx.mjs → application-QBVum-rq.mjs} +3 -3
- package/dist/{application-dhmb3PMx.mjs.map → application-QBVum-rq.mjs.map} +1 -1
- package/dist/{body-policy-BK8PLFhR.mjs → body-policy-DpzQ1sXo.mjs} +2 -2
- package/dist/{body-policy-BK8PLFhR.mjs.map → body-policy-DpzQ1sXo.mjs.map} +1 -1
- package/dist/{bootstrap-Cm4Tv-uh.mjs → bootstrap-D8U1b1lN.mjs} +3 -3
- package/dist/{bootstrap-Cm4Tv-uh.mjs.map → bootstrap-D8U1b1lN.mjs.map} +1 -1
- package/dist/{bounded-counters-DhDwQV9i.mjs → bounded-counters-W_iZ-6a-.mjs} +2 -2
- package/dist/{bounded-counters-DhDwQV9i.mjs.map → bounded-counters-W_iZ-6a-.mjs.map} +1 -1
- package/dist/{client-ip-gBC8rx8G.mjs → client-ip-B90_tMPE.mjs} +2 -2
- package/dist/{client-ip-gBC8rx8G.mjs.map → client-ip-B90_tMPE.mjs.map} +1 -1
- package/dist/config/index.mjs +2 -2
- package/dist/{config-CufiDd1o.mjs → config-CcwnmXAp.mjs} +3 -3
- package/dist/{config-CufiDd1o.mjs.map → config-CcwnmXAp.mjs.map} +1 -1
- package/dist/{context-Vy_DYHAM.mjs → context-DJh3UImF.mjs} +3 -3
- package/dist/{context-Vy_DYHAM.mjs.map → context-DJh3UImF.mjs.map} +1 -1
- package/dist/{context-errors-BNm2NUfA.mjs → context-errors-Bjmg2Idn.mjs} +2 -2
- package/dist/{context-errors-BNm2NUfA.mjs.map → context-errors-Bjmg2Idn.mjs.map} +1 -1
- package/dist/{contributor-runner-BwBRcB65.mjs → contributor-runner-BDrfpkvN.mjs} +3 -3
- package/dist/{contributor-runner-BwBRcB65.mjs.map → contributor-runner-BDrfpkvN.mjs.map} +1 -1
- package/dist/core/adapter.mjs +1 -1
- package/dist/core/app-module.mjs +1 -1
- package/dist/core/cache.mjs +1 -1
- package/dist/core/container.mjs +2 -2
- package/dist/core/cron.mjs +2 -2
- package/dist/core/decorators.mjs +2 -2
- package/dist/core/errors.mjs +1 -1
- package/dist/core/interfaces.mjs +1 -1
- package/dist/core/logger.mjs +1 -1
- package/dist/core/path.mjs +1 -1
- package/dist/core/plugin.mjs +1 -1
- package/dist/core/reactivity.mjs +2 -2
- package/dist/{core-uD7kn0hF.mjs → core-fD81or3K.mjs} +3 -3
- package/dist/{core-uD7kn0hF.mjs.map → core-fD81or3K.mjs.map} +1 -1
- package/dist/{decorate-7rlBW7PY.mjs → decorate-xqpvUQBu.mjs} +3 -3
- package/dist/{decorate-7rlBW7PY.mjs.map → decorate-xqpvUQBu.mjs.map} +1 -1
- package/dist/{define-adapter-rcNang-q.mjs → define-adapter-DV0gX0Zc.mjs} +2 -2
- package/dist/{define-adapter-rcNang-q.mjs.map → define-adapter-DV0gX0Zc.mjs.map} +1 -1
- package/dist/{di-hooks-CdmCtJWu.mjs → di-hooks-BCQxqvPP.mjs} +2 -2
- package/dist/{di-hooks-CdmCtJWu.mjs.map → di-hooks-BCQxqvPP.mjs.map} +1 -1
- package/dist/{disposables-tpEyEZ9s.mjs → disposables-CLELPWB2.mjs} +1 -1
- package/dist/{driver-C8ZOdZck.mjs → driver-60Ojtg4A.mjs} +3 -3
- package/dist/{driver-C8ZOdZck.mjs.map → driver-60Ojtg4A.mjs.map} +1 -1
- package/dist/{express-DjX6B-HB.mjs → express-cGEtQgNP.mjs} +3 -3
- package/dist/{express-DjX6B-HB.mjs.map → express-cGEtQgNP.mjs.map} +1 -1
- package/dist/{express-lazy-DBLuSOgw.mjs → express-lazy-A39r8_jk.mjs} +3 -3
- package/dist/{express-lazy-DBLuSOgw.mjs.map → express-lazy-A39r8_jk.mjs.map} +1 -1
- package/dist/{handler-CHJs4HZ3.mjs → handler-BDivc8AT.mjs} +3 -3
- package/dist/{handler-CHJs4HZ3.mjs.map → handler-BDivc8AT.mjs.map} +1 -1
- package/dist/{host-BxUGat0u.mjs → host-DTmYT9lX.mjs} +2 -2
- package/dist/{host-BxUGat0u.mjs.map → host-DTmYT9lX.mjs.map} +1 -1
- package/dist/http/application.mjs +2 -2
- package/dist/http/bootstrap.mjs +2 -2
- package/dist/http/context.mjs +2 -2
- package/dist/http/middleware/allowed-hosts.mjs +2 -2
- package/dist/http/middleware/breach-padding.mjs +1 -1
- package/dist/http/middleware/cors.mjs +1 -1
- package/dist/http/middleware/csrf.mjs +2 -2
- package/dist/http/middleware/error-handler.mjs +2 -2
- package/dist/http/middleware/helmet.mjs +1 -1
- package/dist/http/middleware/rate-limit.mjs +2 -2
- package/dist/http/middleware/request-id.mjs +1 -1
- package/dist/http/middleware/request-logger.mjs +2 -2
- package/dist/http/middleware/session.mjs +2 -2
- package/dist/http/middleware/session.mjs.map +1 -1
- package/dist/http/middleware/spa.mjs +2 -2
- package/dist/http/middleware/upload.mjs +2 -2
- package/dist/http/middleware/validate.mjs +1 -1
- package/dist/http/middleware/views.mjs +2 -2
- package/dist/http/query/index.mjs +2 -2
- package/dist/http/router-builder.mjs +2 -2
- package/dist/http/runtimes/express.mjs +2 -2
- package/dist/http/runtimes/fastify.mjs +2 -2
- package/dist/http/runtimes/h3-web.mjs +1 -1
- 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.mjs +2 -2
- package/dist/{is-production-WunZdVDZ.mjs → is-production-CC5VwQUr.mjs} +2 -2
- package/dist/{is-production-WunZdVDZ.mjs.map → is-production-CC5VwQUr.mjs.map} +1 -1
- package/dist/{jobs-DxkFQkZG.mjs → jobs-Cv_MxBmp.mjs} +3 -3
- package/dist/{jobs-DxkFQkZG.mjs.map → jobs-Cv_MxBmp.mjs.map} +1 -1
- package/dist/{kv-stores-C4YUttef.mjs → kv-stores-IqwuxoUl.mjs} +3 -3
- package/dist/{kv-stores-C4YUttef.mjs.map → kv-stores-IqwuxoUl.mjs.map} +1 -1
- package/dist/{lazy-serve-static-BBO3lkBi.mjs → lazy-serve-static-DA6yo1u9.mjs} +3 -3
- package/dist/{lazy-serve-static-BBO3lkBi.mjs.map → lazy-serve-static-DA6yo1u9.mjs.map} +1 -1
- package/dist/{metadata-s6adg8tp.mjs → metadata-BhcNTK8K.mjs} +1 -1
- package/dist/{observers-Dn36QtbG.mjs → observers-ZGFBMx7P.mjs} +2 -2
- package/dist/{observers-Dn36QtbG.mjs.map → observers-ZGFBMx7P.mjs.map} +1 -1
- package/dist/{precompressed-Dn3S9e-q.mjs → precompressed-D03hwjjz.mjs} +2 -2
- package/dist/{precompressed-Dn3S9e-q.mjs.map → precompressed-D03hwjjz.mjs.map} +1 -1
- package/dist/{query-BukuyQDW.mjs → query-Bs-87jM-.mjs} +2 -2
- package/dist/{query-BukuyQDW.mjs.map → query-Bs-87jM-.mjs.map} +1 -1
- package/dist/{reply-DDoHPeGF.mjs → reply-GgkLk_oe.mjs} +3 -3
- package/dist/{reply-DDoHPeGF.mjs.map → reply-GgkLk_oe.mjs.map} +1 -1
- package/dist/{request-scope-BmUpBk1z.mjs → request-scope-mn1b63mA.mjs} +3 -3
- package/dist/{request-scope-BmUpBk1z.mjs.map → request-scope-mn1b63mA.mjs.map} +1 -1
- package/dist/{respond-Bo3vSCwu.mjs → respond-BBYJsJ-G.mjs} +2 -2
- package/dist/{respond-Bo3vSCwu.mjs.map → respond-BBYJsJ-G.mjs.map} +1 -1
- package/dist/{rolldown-runtime-DHJmXo5e.mjs → rolldown-runtime-C4ng-APQ.mjs} +1 -1
- package/dist/{route-flag-Cwckim1c.mjs → route-flag-DjDiOO3H.mjs} +3 -3
- package/dist/{route-flag-Cwckim1c.mjs.map → route-flag-DjDiOO3H.mjs.map} +1 -1
- package/dist/{route-policy-CycYu5mR.mjs → route-policy-BSaFqylB.mjs} +2 -2
- package/dist/{route-policy-CycYu5mR.mjs.map → route-policy-BSaFqylB.mjs.map} +1 -1
- package/dist/{router-builder--PLE0eDf.mjs → router-builder-BRmu4LTG.mjs} +3 -3
- package/dist/{router-builder--PLE0eDf.mjs.map → router-builder-BRmu4LTG.mjs.map} +1 -1
- package/dist/{runtime-OgMPp4md.mjs → runtime-CeZOPbkB.mjs} +3 -3
- package/dist/{runtime-OgMPp4md.mjs.map → runtime-CeZOPbkB.mjs.map} +1 -1
- package/dist/session-DQG72vCf.d.mts.map +1 -1
- package/dist/{settings-Dn9iQ-BU.mjs → settings-DdExbzhu.mjs} +3 -3
- package/dist/{settings-Dn9iQ-BU.mjs.map → settings-DdExbzhu.mjs.map} +1 -1
- package/dist/{token-B3xWBu0S.mjs → token-SjtN7iMS.mjs} +1 -1
- package/dist/{upload-config-BrbOOmcm.mjs → upload-config-D8OMmdY7.mjs} +2 -2
- package/dist/{upload-config-BrbOOmcm.mjs.map → upload-config-D8OMmdY7.mjs.map} +1 -1
- package/dist/{url-for-1SdTJZzK.mjs → url-for-YPjjzRlH.mjs} +3 -3
- package/dist/{url-for-1SdTJZzK.mjs.map → url-for-YPjjzRlH.mjs.map} +1 -1
- package/dist/{view-renderer-Caqy9XY5.mjs → view-renderer-CA8eJU23.mjs} +3 -3
- package/dist/{view-renderer-Caqy9XY5.mjs.map → view-renderer-CA8eJU23.mjs.map} +1 -1
- package/dist/{web-crypto-DnhQ8LCv.mjs → web-crypto-iLWDbH8H.mjs} +2 -2
- package/dist/{web-crypto-DnhQ8LCv.mjs.map → web-crypto-iLWDbH8H.mjs.map} +1 -1
- package/dist/web.mjs +2 -2
- package/package.json +1 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"express-lazy-
|
|
1
|
+
{"version":3,"file":"express-lazy-A39r8_jk.mjs","names":[],"sources":["../src/http/runtimes/express-lazy.ts"],"sourcesContent":["/**\n * The Express runtime as the root entry exports it: `expressRuntime()`,\n * `buildRoutes()` and `materializeRouter()` without importing `express` when\n * `@forinda/kickjs` loads, so an app on Fastify or h3 runs without it installed.\n * The engine loads in `HttpRuntime.load()`, which the Application awaits before\n * creating its app — through a literal dynamic `import()`, which bundlers\n * follow, so `kick build:netlify|vercel` still inlines Express.\n *\n * `@forinda/kickjs/express` exports the same three, loaded eagerly.\n */\nimport type { ConnectHandler } from '../connect'\nimport type { HttpRuntime, RouteEntry, RuntimeCapabilities } from '../runtime'\nimport { buildRouteTable, type BuildRoutesOptions } from '../router-builder'\n\ntype ExpressModule = typeof import('./express')\n\n/** What the Express runtime supports — read before the engine loads (`start()` checks `http2`). */\nexport const EXPRESS_CAPABILITIES: RuntimeCapabilities = {\n render: true,\n uploads: true,\n connectMiddleware: true,\n nativeBodyParsing: false,\n http2: false,\n}\n\nlet loaded: ExpressModule | undefined\nlet loading: Promise<ExpressModule> | undefined\n/** Why the load failed — thrown where Express is used, not at every app's setup. */\nlet loadError: Error | undefined\n\n/** Start loading Express once; every caller shares the one load. */\nfunction loadExpress(): Promise<ExpressModule> {\n loading ??= import('./express').then(\n (mod) => (loaded = mod),\n (err: unknown) => {\n throw (loadError = new Error(\n \"kickjs: the Express runtime needs the 'express' package — install it, or pass another \" +\n \"runtime to bootstrap(): `runtime: fastifyRuntime()` from '@forinda/kickjs/fastify', \" +\n \"or `h3Runtime()` from '@forinda/kickjs/h3'.\",\n { cause: err },\n ))\n },\n )\n return loading\n}\n\n/**\n * Wait for an Express load something already started — `expressRuntime()`\n * starts one when called, so a custom runtime wrapping it (and calling its\n * methods without forwarding `load()`) still finds Express there by setup.\n * Never throws: an app on another runtime mustn't fail because something else\n * asked for Express; a failed load surfaces where Express is used.\n */\nexport async function settleExpressLoad(): Promise<void> {\n await loading?.catch(() => {})\n}\n\n/**\n * Express's body parsers, for a runtime that neither parses bodies itself nor\n * supplies `bodyParsers()` — what the Application mounted before runtimes\n * could supply their own.\n */\nexport async function expressBodyParsers(limit: string | number) {\n const mod = await loadExpress()\n return mod.expressRuntime().bodyParsers?.({ limit }) ?? []\n}\n\nfunction notLoaded(what: string): Error {\n return new Error(\n `kickjs: ${what} is Express-only and runs once the Express runtime has loaded — ` +\n \"in an app running it. Outside one, import it from '@forinda/kickjs/express'.\",\n )\n}\n\n/** The default HTTP runtime; Express loads on the Application's first setup. */\nexport function expressRuntime(): HttpRuntime {\n // Started now and awaited at setup; a failure surfaces there, not as an\n // unhandled rejection here.\n loadExpress().catch(() => {})\n let real: HttpRuntime | undefined\n const engine = (): HttpRuntime => real ?? (real = loaded?.expressRuntime()) ?? fail()\n const fail = (): never => {\n throw loadError ?? notLoaded('expressRuntime() used before load()')\n }\n return {\n name: 'express',\n capabilities: EXPRESS_CAPABILITIES,\n async load() {\n await loadExpress()\n engine()\n },\n createApp: (options) => engine().createApp(options),\n nodeHandler: (app) => engine().nodeHandler(app),\n mountRoutes: (app, table) => engine().mountRoutes(app, table),\n useConnect: (app, mw, opts) => engine().useConnect(app, mw, opts),\n serveStatic: (app, prefix, dir) => engine().serveStatic(app, prefix, dir),\n setNotFound: (app, mw) => engine().setNotFound(app, mw),\n setErrorHandler: (app, mw) => engine().setErrorHandler(app, mw),\n close: (app) => engine().close?.(app),\n bodyParsers: (options) => engine().bodyParsers?.(options) ?? [],\n }\n}\n\n/**\n * Materialize route entries onto an Express `Router`, built on the first\n * request (Express has loaded by then in an app running it).\n */\nexport function materializeRouter(entries: RouteEntry[]): ConnectHandler {\n let router: ConnectHandler | undefined\n return (req, res, next) => {\n if (!loaded) throw notLoaded('materializeRouter()')\n router ??= loaded.materializeRouter(entries)\n return router(req, res, next)\n }\n}\n\n/**\n * A controller's routes as an Express `Router`. The route table is built now,\n * so a contributor cycle or a missing dependency still fails at boot; the\n * router on the first request.\n */\nexport function buildRoutes(\n controllerClass: any,\n options: BuildRoutesOptions = {},\n): ConnectHandler {\n return materializeRouter(buildRouteTable(controllerClass, options))\n}\n"],"mappings":";;;;;;;;;;gEAiBA,MAAa,qBAA4C,CACvD,OAAQ,GACR,QAAS,GACT,kBAAmB,GACnB,kBAAmB,GACnB,MAAO,EACT,EAEA,IAAI,OACA,QAEA,UAGJ,SAAS,aAAsC,CAY7C,MAXA,WAAY,OAAO,yBAAY,CAAA,KAAA,GAAA,EAAA,CAAA,CAAA,CAAC,KAC7B,KAAS,OAAS,IAClB,KAAiB,CAChB,KAAO,WAAgB,MACrB,wNAGA,CAAE,MAAO,GAAI,CACf,CACF,CACF,EACO,OACT,CASA,eAAsB,mBAAmC,CACvD,MAAM,SAAS,UAAY,CAAC,CAAC,CAC/B,CAOA,eAAsB,mBAAmB,MAAwB,CAE/D,OAAO,MADW,YAAY,EAAA,CACnB,eAAe,CAAC,CAAC,cAAc,CAAE,KAAM,CAAC,GAAK,CAAC,CAC3D,CAEA,SAAS,UAAU,KAAqB,CACtC,MAAO,gBAAI,MACT,WAAW,KAAK,6IAElB,CACF,CAGA,SAAgB,gBAA8B,CAG5C,YAAY,CAAC,CAAC,UAAY,CAAC,CAAC,EAC5B,IAAI,KACE,YAA4B,AAAS,OAAO,QAAQ,eAAe,IAAM,KAAK,EAC9E,SAAoB,CACxB,MAAM,WAAa,UAAU,qCAAqC,CACpE,EACA,MAAO,CACL,KAAM,UACN,aAAc,qBACd,MAAM,MAAO,CACX,MAAM,YAAY,EAClB,OAAO,CACT,EACA,UAAY,SAAY,OAAO,CAAC,CAAC,UAAU,OAAO,EAClD,YAAc,KAAQ,OAAO,CAAC,CAAC,YAAY,GAAG,EAC9C,aAAc,IAAK,QAAU,OAAO,CAAC,CAAC,YAAY,IAAK,KAAK,EAC5D,YAAa,IAAK,GAAI,OAAS,OAAO,CAAC,CAAC,WAAW,IAAK,GAAI,IAAI,EAChE,aAAc,IAAK,OAAQ,MAAQ,OAAO,CAAC,CAAC,YAAY,IAAK,OAAQ,GAAG,EACxE,aAAc,IAAK,KAAO,OAAO,CAAC,CAAC,YAAY,IAAK,EAAE,EACtD,iBAAkB,IAAK,KAAO,OAAO,CAAC,CAAC,gBAAgB,IAAK,EAAE,EAC9D,MAAQ,KAAQ,OAAO,CAAC,CAAC,QAAQ,GAAG,EACpC,YAAc,SAAY,OAAO,CAAC,CAAC,cAAc,OAAO,GAAK,CAAC,CAChE,CACF,CAMA,SAAgB,kBAAkB,QAAuC,CACvE,IAAI,OACJ,OAAQ,IAAK,IAAK,OAAS,CACzB,GAAI,CAAC,OAAQ,MAAM,UAAU,qBAAqB,EAElD,MADA,UAAW,OAAO,kBAAkB,OAAO,EACpC,OAAO,IAAK,IAAK,IAAI,CAC9B,CACF,CAOA,SAAgB,YACd,gBACA,QAA8B,CAAC,EACf,CAChB,OAAO,kBAAkB,gBAAgB,gBAAiB,OAAO,CAAC,CACpE"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{HttpException}from"./core/errors.mjs";import{a as hasPrototypeKey,c as prototypeKeyError,i as formFields,l as readBodyBytes,o as parseByteSize,p as unsupportedMediaTypeError,r as classifyMediaType,s as parseForm,u as readBodyText}from"./body-policy-
|
|
12
|
-
//# sourceMappingURL=handler-
|
|
11
|
+
import{HttpException}from"./core/errors.mjs";import{a as hasPrototypeKey,c as prototypeKeyError,i as formFields,l as readBodyBytes,o as parseByteSize,p as unsupportedMediaTypeError,r as classifyMediaType,s as parseForm,u as readBodyText}from"./body-policy-DpzQ1sXo.mjs";import{f as requestStore}from"./view-renderer-CA8eJU23.mjs";import{errorHandler,notFoundHandler}from"./http/middleware/error-handler.mjs";import{n as disposeRequestStore,t as createRequestStore}from"./request-scope-mn1b63mA.mjs";import{n as applyHandlerResult}from"./reply-GgkLk_oe.mjs";import{t as RequestContext}from"./context-DJh3UImF.mjs";import{n as publishMatchedRoute}from"./runtime-CeZOPbkB.mjs";import{validate}from"./http/middleware/validate.mjs";import{n as WebResponseDriver,t as WebRequestShim}from"./driver-60Ojtg4A.mjs";import{c as tooManyFiles,l as uploadLimits,r as applyUploadConfig}from"./upload-config-D8OMmdY7.mjs";const NOOP_NEXT=()=>{},BODY_METHODS=/* @__PURE__ */ new Set([`POST`,`PUT`,`PATCH`,`DELETE`]),builtInError=errorHandler(),builtInNotFound=notFoundHandler();function decodeParams(params){let decoded={};for(let key in params){let value=params[key];decoded[key]=value.includes(`%`)?decodeURIComponent(value):value}return decoded}function readThrough(shim,carry){return new Proxy(shim,{get(target,prop,receiver){let own=Reflect.get(target,prop,receiver);return own===void 0?Reflect.get(carry,prop,carry):own},has(target,prop){return Reflect.has(target,prop)||Reflect.has(carry,prop)}})}function compileWebRoute(entry,hooks,options={}){let bodyLimit=options.bodyLimit??parseByteSize(`1mb`),validator=entry.meta.validation?validate(entry.meta.validation,{validationError:entry.validationError}):void 0,upload=entry.meta.upload&&entry.meta.upload.mode!==`none`?entry.meta.upload:null;return async({request,url,params,carry})=>{let shim=new WebRequestShim(request,url),req=carry?readThrough(shim,carry):shim,bodyError;try{req.params=decodeParams(params)}catch{req.params=params,bodyError=HttpException.badRequest(`Malformed URL parameter`)}if(upload){let limits=uploadLimits(upload),form;try{let bytes=await readBodyBytes(request,limits.total),type=request.headers.get(`content-type`)??``;form=await new Response(bytes,{headers:{"content-type":type}}).formData().catch(()=>void 0)}catch(err){err instanceof HttpException&&(bodyError=err)}if(form){let rawParts=[],fields=[];for(let[name,value]of form.entries())typeof value==`string`?fields.push([name,value]):rawParts.push({fieldname:name,filename:value.name??``,mimetype:value.type||`application/octet-stream`,buffer:typeof Buffer==`function`?Buffer.from(await value.arrayBuffer()):new Uint8Array(await value.arrayBuffer())});if(req.body=formFields(fields),rawParts.length>limits.files)bodyError=tooManyFiles(limits.files);else try{let{file,files}=applyUploadConfig(rawParts,entry.meta.upload);req.file=file,req.files=files}catch(err){bodyError=err}}}else if(BODY_METHODS.has(request.method)){let raw=``;try{raw=await readBodyText(request,bodyLimit)}catch(err){err instanceof HttpException&&(bodyError=err)}let kind=classifyMediaType(req.headers[`content-type`]);if(raw!==``&&kind===`unsupported`)bodyError=unsupportedMediaTypeError(req.headers[`content-type`]);else if(raw!==``&&kind!==`multipart`){if(kind===`json`)try{req.body=JSON.parse(raw)}catch(err){bodyError=HttpException.badRequest(err instanceof Error?err.message:`Request body could not be parsed`)}else req.body=kind===`urlencoded`?parseForm(raw):raw}}!bodyError&&hasPrototypeKey(req.body)&&(bodyError=prototypeKeyError());let store=createRequestStore(req.requestId||req.headers[`x-request-id`]);req.requestId=store.requestId;let driver=new WebResponseDriver(request.signal);driver.setHeader(`x-request-id`,store.requestId),publishMatchedRoute(req,entry),carry&&publishMatchedRoute(carry,entry);let pipeline=requestStore.run(store,async()=>{if(bodyError)throw bodyError;let ctx=new RequestContext(req,driver,NOOP_NEXT,driver);if(entry.earlyContributorRunner&&(await entry.earlyContributorRunner(ctx),driver.settled))return;validator&&await new Promise((resolve,reject)=>{validator(req,void 0,err=>err?reject(err):resolve())});for(let mw of entry.middlewares){let advanced=!1;if(await new Promise((resolve,reject)=>{Promise.resolve(mw(ctx,err=>{advanced=!0,err?reject(err):resolve()})).catch(reject)}),!advanced||driver.settled)return}if(entry.contributorRunner&&await entry.contributorRunner(ctx),driver.settled)return;let result=await entry.handler(ctx);driver.settled||await applyHandlerResult(ctx,result)});try{try{await Promise.race([pipeline,driver.ready])}catch(err){driver.settled||await requestStore.run(store,async()=>{hooks?.onError&&await hooks.onError(err,req,driver),driver.settled||await builtInError(err,req,driver,NOOP_NEXT)})}return driver.settled||builtInNotFound(req,driver,NOOP_NEXT),await driver.ready}finally{Promise.resolve(pipeline).catch(()=>{}).then(()=>disposeRequestStore(store))}}}async function headFromGet(response){let res=await response;return res.body?.cancel().catch(()=>{}),new Response(null,{status:res.status,statusText:res.statusText,headers:res.headers})}export{headFromGet as n,readThrough as r,compileWebRoute as t};
|
|
12
|
+
//# sourceMappingURL=handler-BDivc8AT.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"handler-CHJs4HZ3.mjs","names":[],"sources":["../src/http/web/handler.ts"],"sourcesContent":["// Engine-neutral web pipeline: run one KickJS RouteEntry against a WHATWG\n// Request and produce a WHATWG Response. Shared by the h3 v2 runtime\n// (node bootstrap) and the `@forinda/kickjs/web` fetch entry (edge/Bun/Deno).\n// Edge-safe: no node imports beyond the sanctioned ALS request store.\n\nimport { HttpException } from '../../core/errors'\nimport {\n DEFAULT_BODY_LIMIT,\n classifyMediaType,\n parseByteSize,\n formFields,\n hasPrototypeKey,\n parseForm,\n prototypeKeyError,\n readBodyBytes,\n readBodyText,\n unsupportedMediaTypeError,\n} from '../body-policy'\nimport { RequestContext } from '../context'\nimport { publishMatchedRoute } from '../runtime'\nimport { applyHandlerResult } from '../reply'\nimport { requestStore } from '../request-store'\nimport { createRequestStore, disposeRequestStore } from '../middleware/request-scope'\nimport { validate } from '../middleware/validate'\nimport {\n applyUploadConfig,\n tooManyFiles,\n uploadLimits,\n type RawUploadPart,\n} from '../middleware/upload-config'\nimport type { RouteEntry, RuntimeResponse } from '../runtime'\nimport { WebRequestShim, WebResponseDriver } from './driver'\nimport { errorHandler, notFoundHandler } from '../middleware/error-handler'\n\nconst NOOP_NEXT = (): void => {}\nconst BODY_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE'])\n\nexport interface WebRouteInvocation {\n request: Request\n url: URL\n params: Record<string, string>\n /**\n * The request object the app's connect middleware wrote to — the node\n * `req` behind a node server, the per-event shim on the fetch path.\n * Whatever it set (`session`, `user`, `requestId`, an adapter's symbol)\n * reads through on the route's request.\n */\n carry?: object\n}\n\nexport interface WebRouteHooks {\n /**\n * Error bridge — receives pipeline rejections (validation failures,\n * handler throws) with the shim + driver so an engine can dispatch the\n * framework's connect-style error handler. When absent (or when it\n * doesn't settle the driver), a minimal JSON error is produced from\n * `err.status`/`err.statusCode` (500 default).\n */\n onError?: (err: unknown, req: WebRequestShim, res: WebResponseDriver) => void | Promise<void>\n}\n\n// The same handlers Express and Fastify answer with, so an error or a request\n// nothing answered has one shape on every engine: RFC 9457 problem details,\n// the error's own headers, `requestId` on a 500.\nconst builtInError = errorHandler()\nconst builtInNotFound = notFoundHandler()\n\nfunction decodeParams(params: Record<string, string>): Record<string, string> {\n const decoded: Record<string, string> = {}\n for (const key in params) {\n const value = params[key]\n decoded[key] = value.includes('%') ? decodeURIComponent(value) : value\n }\n return decoded\n}\n\n/**\n * Compile a RouteEntry into a `(invocation) => Promise<Response>` function.\n * Everything derivable at route-build time (validator, upload config) is\n * hoisted here — per-request work is shim + store + pipeline only.\n */\n/**\n * The route's request, with anything it does not set itself read from\n * `carry` — the object connect middleware wrote to. Writes stay on the route's\n * own request. A declared-but-unset field (`requestId`) counts as not set.\n */\nexport function readThrough(shim: WebRequestShim, carry: object): WebRequestShim {\n return new Proxy(shim, {\n get(target, prop, receiver) {\n const own = Reflect.get(target, prop, receiver)\n return own !== undefined ? own : Reflect.get(carry, prop, carry)\n },\n has(target, prop) {\n return Reflect.has(target, prop) || Reflect.has(carry, prop)\n },\n })\n}\n\nexport function compileWebRoute(\n entry: RouteEntry,\n hooks?: WebRouteHooks,\n options: { bodyLimit?: number } = {},\n): (invocation: WebRouteInvocation) => Promise<Response> {\n const bodyLimit = options.bodyLimit ?? parseByteSize(DEFAULT_BODY_LIMIT)\n const validator = entry.meta.validation\n ? validate(entry.meta.validation, { validationError: entry.validationError })\n : undefined\n const upload = entry.meta.upload && entry.meta.upload.mode !== 'none' ? entry.meta.upload : null\n\n return async ({ request, url, params, carry }) => {\n const shim = new WebRequestShim(request, url)\n const req = carry ? readThrough(shim, carry) : shim\n let bodyError: unknown\n // h3 hands params over still percent-encoded; Express and Fastify decode\n // them, so `/users/a%20b` must reach the handler as `'a b'` here too.\n try {\n req.params = decodeParams(params)\n } catch {\n req.params = params\n bodyError = HttpException.badRequest('Malformed URL parameter')\n }\n\n // Body: uploads consume the stream as FormData; everything else parses\n // by content-type.\n if (upload) {\n // Bounded before anything is parsed: the route's file budget plus room\n // for fields. Past it is a 413, held like a parse failure below.\n const limits = uploadLimits(upload)\n let form: FormData | undefined\n try {\n const bytes = await readBodyBytes(request, limits.total)\n const type = request.headers.get('content-type') ?? ''\n form = await new Response(bytes as unknown as ConstructorParameters<typeof Response>[0], {\n headers: { 'content-type': type },\n })\n .formData()\n .catch(() => undefined)\n } catch (err) {\n if (err instanceof HttpException) bodyError = err\n }\n if (form) {\n const rawParts: RawUploadPart[] = []\n const fields: Array<[string, string]> = []\n for (const [name, value] of form.entries()) {\n if (typeof value === 'string') {\n fields.push([name, value])\n } else {\n rawParts.push({\n fieldname: name,\n filename: value.name ?? '',\n mimetype: value.type || 'application/octet-stream',\n // A real Buffer where the runtime has one (Node, Bun, Deno), so\n // `file.buffer.toString()` is the content as on every other\n // engine — a bare Uint8Array stringifies as \"80,78,71,…\".\n buffer: (typeof Buffer === 'function'\n ? Buffer.from(await value.arrayBuffer())\n : new Uint8Array(await value.arrayBuffer())) as unknown as Buffer,\n })\n }\n }\n req.body = formFields(fields)\n // A refused type (415), an oversized file or too many (413) is held like\n // a parse failure — thrown before the driver exists, it would escape the\n // route and reach the client as the host's bare error, not kick's.\n if (rawParts.length > limits.files) {\n bodyError = tooManyFiles(limits.files)\n } else {\n try {\n const { file, files } = applyUploadConfig(rawParts, entry.meta.upload!)\n req.file = file\n req.files = files\n } catch (err) {\n bodyError = err\n }\n }\n }\n } else if (BODY_METHODS.has(request.method)) {\n // Read once — a Request body is a stream and cannot be consumed twice.\n // A read that fails (client aborted mid-flight) is treated as an absent\n // body: there is nobody left to answer, and it is not a malformed one.\n // Past the limit is a 413, held like a parse failure below.\n let raw = ''\n try {\n raw = await readBodyText(request, bodyLimit)\n } catch (err) {\n if (err instanceof HttpException) bodyError = err\n }\n\n // An empty body is ABSENT, not unparseable — the same call the node h3\n // runtime makes on `content-length: 0`. Distinguishing the two is the\n // whole point: `.catch(() => undefined)` around the parse could not,\n // so a malformed payload answered 200 with the handler running against\n // `undefined` (#605), the defect #586 removed from the node runtime.\n const kind = classifyMediaType(req.headers['content-type'])\n if (raw !== '' && kind === 'unsupported') {\n // Held for the same reason as a parse failure: no driver yet.\n bodyError = unsupportedMediaTypeError(req.headers['content-type'])\n } else if (raw !== '' && kind !== 'multipart') {\n if (kind === 'json') {\n try {\n req.body = JSON.parse(raw)\n } catch (err) {\n // Held, not thrown: the driver that turns an error into a response\n // does not exist yet, so throwing here escapes the route entirely\n // and surfaces as a 500. Rethrown as the pipeline's first act.\n bodyError = HttpException.badRequest(\n err instanceof Error ? err.message : 'Request body could not be parsed',\n )\n }\n } else if (kind === 'urlencoded') {\n req.body = parseForm(raw)\n } else {\n req.body = raw\n }\n }\n }\n\n // A key that could rewrite a prototype — refused before any of the app's code sees it.\n if (!bodyError && hasPrototypeKey(req.body)) bodyError = prototypeKeyError()\n\n // Reuse the id `requestId()` middleware already gave the request, so the\n // response header, the route's ctx and observers agree on one id.\n const store = createRequestStore(req.requestId || req.headers['x-request-id'])\n req.requestId = store.requestId\n\n const driver = new WebResponseDriver(request.signal)\n driver.setHeader('x-request-id', store.requestId)\n\n publishMatchedRoute(req, entry)\n // Middleware that reports after the response (observers, request logger)\n // reads the route off the request it was handed — the carried one.\n if (carry) publishMatchedRoute(carry, entry)\n\n const pipeline = requestStore.run(store, async () => {\n if (bodyError) throw bodyError\n\n const ctx = new RequestContext(\n req as never,\n driver as never,\n NOOP_NEXT,\n driver as RuntimeResponse,\n )\n\n // `beforeValidation` contributors (#677) — ahead of validation and middleware.\n if (entry.earlyContributorRunner) {\n await entry.earlyContributorRunner(ctx)\n if (driver.settled) return\n }\n\n if (validator) {\n await new Promise<void>((resolve, reject) => {\n validator(req as never, undefined as never, (err?: unknown) =>\n err ? reject(err) : resolve(),\n )\n })\n }\n\n for (const mw of entry.middlewares) {\n let advanced = false\n await new Promise<void>((resolve, reject) => {\n const next = (err?: unknown): void => {\n advanced = true\n if (err) reject(err)\n else resolve()\n }\n Promise.resolve(mw(ctx, next)).catch(reject)\n })\n if (!advanced || driver.settled) return\n }\n\n if (entry.contributorRunner) await entry.contributorRunner(ctx)\n if (driver.settled) return\n const result = await entry.handler(ctx)\n // Return-value handlers (reply.ts): auto-send when nothing was written.\n // `undefined` falls through to the canonical 404 below.\n if (!driver.settled) await applyHandlerResult(ctx, result)\n })\n\n try {\n // Streaming responses resolve `ready` mid-pipeline (SSE); buffered ones\n // resolve at the terminal ctx call. Race so both shapes return promptly.\n try {\n await Promise.race([pipeline, driver.ready])\n } catch (err) {\n // Inside the request's store: an error page renders with the same\n // context and REQUEST-scoped services the route had.\n if (!driver.settled) {\n await requestStore.run(store, async () => {\n if (hooks?.onError) await hooks.onError(err, req, driver)\n if (!driver.settled) await builtInError(err, req, driver, NOOP_NEXT)\n })\n }\n }\n if (!driver.settled) {\n // Pipeline finished without responding — the catch-all's 404.\n builtInNotFound(req, driver, NOOP_NEXT)\n }\n return await driver.ready\n } finally {\n // @PreDestroy teardown. For buffered responses this runs post-response;\n // for streams it runs when the pipeline (not the stream) completes —\n // stream lifetime is governed by the client abort signal.\n void Promise.resolve(pipeline)\n .catch(() => {})\n .then(() => disposeRequestStore(store))\n }\n }\n}\n\n/**\n * HEAD for a GET route: run the route and answer with its status and\n * headers, without the body — what Express and Fastify do for every GET.\n */\nexport async function headFromGet(response: Promise<Response> | Response): Promise<Response> {\n const res = await response\n // A streamed GET (SSE) would otherwise keep producing for nobody.\n res.body?.cancel().catch(() => {})\n return new Response(null, {\n status: res.status,\n statusText: res.statusText,\n headers: res.headers,\n })\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"handler-BDivc8AT.mjs","names":[],"sources":["../src/http/web/handler.ts"],"sourcesContent":["// Engine-neutral web pipeline: run one KickJS RouteEntry against a WHATWG\n// Request and produce a WHATWG Response. Shared by the h3 v2 runtime\n// (node bootstrap) and the `@forinda/kickjs/web` fetch entry (edge/Bun/Deno).\n// Edge-safe: no node imports beyond the sanctioned ALS request store.\n\nimport { HttpException } from '../../core/errors'\nimport {\n DEFAULT_BODY_LIMIT,\n classifyMediaType,\n parseByteSize,\n formFields,\n hasPrototypeKey,\n parseForm,\n prototypeKeyError,\n readBodyBytes,\n readBodyText,\n unsupportedMediaTypeError,\n} from '../body-policy'\nimport { RequestContext } from '../context'\nimport { publishMatchedRoute } from '../runtime'\nimport { applyHandlerResult } from '../reply'\nimport { requestStore } from '../request-store'\nimport { createRequestStore, disposeRequestStore } from '../middleware/request-scope'\nimport { validate } from '../middleware/validate'\nimport {\n applyUploadConfig,\n tooManyFiles,\n uploadLimits,\n type RawUploadPart,\n} from '../middleware/upload-config'\nimport type { RouteEntry, RuntimeResponse } from '../runtime'\nimport { WebRequestShim, WebResponseDriver } from './driver'\nimport { errorHandler, notFoundHandler } from '../middleware/error-handler'\n\nconst NOOP_NEXT = (): void => {}\nconst BODY_METHODS = new Set(['POST', 'PUT', 'PATCH', 'DELETE'])\n\nexport interface WebRouteInvocation {\n request: Request\n url: URL\n params: Record<string, string>\n /**\n * The request object the app's connect middleware wrote to — the node\n * `req` behind a node server, the per-event shim on the fetch path.\n * Whatever it set (`session`, `user`, `requestId`, an adapter's symbol)\n * reads through on the route's request.\n */\n carry?: object\n}\n\nexport interface WebRouteHooks {\n /**\n * Error bridge — receives pipeline rejections (validation failures,\n * handler throws) with the shim + driver so an engine can dispatch the\n * framework's connect-style error handler. When absent (or when it\n * doesn't settle the driver), a minimal JSON error is produced from\n * `err.status`/`err.statusCode` (500 default).\n */\n onError?: (err: unknown, req: WebRequestShim, res: WebResponseDriver) => void | Promise<void>\n}\n\n// The same handlers Express and Fastify answer with, so an error or a request\n// nothing answered has one shape on every engine: RFC 9457 problem details,\n// the error's own headers, `requestId` on a 500.\nconst builtInError = errorHandler()\nconst builtInNotFound = notFoundHandler()\n\nfunction decodeParams(params: Record<string, string>): Record<string, string> {\n const decoded: Record<string, string> = {}\n for (const key in params) {\n const value = params[key]\n decoded[key] = value.includes('%') ? decodeURIComponent(value) : value\n }\n return decoded\n}\n\n/**\n * Compile a RouteEntry into a `(invocation) => Promise<Response>` function.\n * Everything derivable at route-build time (validator, upload config) is\n * hoisted here — per-request work is shim + store + pipeline only.\n */\n/**\n * The route's request, with anything it does not set itself read from\n * `carry` — the object connect middleware wrote to. Writes stay on the route's\n * own request. A declared-but-unset field (`requestId`) counts as not set.\n */\nexport function readThrough(shim: WebRequestShim, carry: object): WebRequestShim {\n return new Proxy(shim, {\n get(target, prop, receiver) {\n const own = Reflect.get(target, prop, receiver)\n return own !== undefined ? own : Reflect.get(carry, prop, carry)\n },\n has(target, prop) {\n return Reflect.has(target, prop) || Reflect.has(carry, prop)\n },\n })\n}\n\nexport function compileWebRoute(\n entry: RouteEntry,\n hooks?: WebRouteHooks,\n options: { bodyLimit?: number } = {},\n): (invocation: WebRouteInvocation) => Promise<Response> {\n const bodyLimit = options.bodyLimit ?? parseByteSize(DEFAULT_BODY_LIMIT)\n const validator = entry.meta.validation\n ? validate(entry.meta.validation, { validationError: entry.validationError })\n : undefined\n const upload = entry.meta.upload && entry.meta.upload.mode !== 'none' ? entry.meta.upload : null\n\n return async ({ request, url, params, carry }) => {\n const shim = new WebRequestShim(request, url)\n const req = carry ? readThrough(shim, carry) : shim\n let bodyError: unknown\n // h3 hands params over still percent-encoded; Express and Fastify decode\n // them, so `/users/a%20b` must reach the handler as `'a b'` here too.\n try {\n req.params = decodeParams(params)\n } catch {\n req.params = params\n bodyError = HttpException.badRequest('Malformed URL parameter')\n }\n\n // Body: uploads consume the stream as FormData; everything else parses\n // by content-type.\n if (upload) {\n // Bounded before anything is parsed: the route's file budget plus room\n // for fields. Past it is a 413, held like a parse failure below.\n const limits = uploadLimits(upload)\n let form: FormData | undefined\n try {\n const bytes = await readBodyBytes(request, limits.total)\n const type = request.headers.get('content-type') ?? ''\n form = await new Response(bytes as unknown as ConstructorParameters<typeof Response>[0], {\n headers: { 'content-type': type },\n })\n .formData()\n .catch(() => undefined)\n } catch (err) {\n if (err instanceof HttpException) bodyError = err\n }\n if (form) {\n const rawParts: RawUploadPart[] = []\n const fields: Array<[string, string]> = []\n for (const [name, value] of form.entries()) {\n if (typeof value === 'string') {\n fields.push([name, value])\n } else {\n rawParts.push({\n fieldname: name,\n filename: value.name ?? '',\n mimetype: value.type || 'application/octet-stream',\n // A real Buffer where the runtime has one (Node, Bun, Deno), so\n // `file.buffer.toString()` is the content as on every other\n // engine — a bare Uint8Array stringifies as \"80,78,71,…\".\n buffer: (typeof Buffer === 'function'\n ? Buffer.from(await value.arrayBuffer())\n : new Uint8Array(await value.arrayBuffer())) as unknown as Buffer,\n })\n }\n }\n req.body = formFields(fields)\n // A refused type (415), an oversized file or too many (413) is held like\n // a parse failure — thrown before the driver exists, it would escape the\n // route and reach the client as the host's bare error, not kick's.\n if (rawParts.length > limits.files) {\n bodyError = tooManyFiles(limits.files)\n } else {\n try {\n const { file, files } = applyUploadConfig(rawParts, entry.meta.upload!)\n req.file = file\n req.files = files\n } catch (err) {\n bodyError = err\n }\n }\n }\n } else if (BODY_METHODS.has(request.method)) {\n // Read once — a Request body is a stream and cannot be consumed twice.\n // A read that fails (client aborted mid-flight) is treated as an absent\n // body: there is nobody left to answer, and it is not a malformed one.\n // Past the limit is a 413, held like a parse failure below.\n let raw = ''\n try {\n raw = await readBodyText(request, bodyLimit)\n } catch (err) {\n if (err instanceof HttpException) bodyError = err\n }\n\n // An empty body is ABSENT, not unparseable — the same call the node h3\n // runtime makes on `content-length: 0`. Distinguishing the two is the\n // whole point: `.catch(() => undefined)` around the parse could not,\n // so a malformed payload answered 200 with the handler running against\n // `undefined` (#605), the defect #586 removed from the node runtime.\n const kind = classifyMediaType(req.headers['content-type'])\n if (raw !== '' && kind === 'unsupported') {\n // Held for the same reason as a parse failure: no driver yet.\n bodyError = unsupportedMediaTypeError(req.headers['content-type'])\n } else if (raw !== '' && kind !== 'multipart') {\n if (kind === 'json') {\n try {\n req.body = JSON.parse(raw)\n } catch (err) {\n // Held, not thrown: the driver that turns an error into a response\n // does not exist yet, so throwing here escapes the route entirely\n // and surfaces as a 500. Rethrown as the pipeline's first act.\n bodyError = HttpException.badRequest(\n err instanceof Error ? err.message : 'Request body could not be parsed',\n )\n }\n } else if (kind === 'urlencoded') {\n req.body = parseForm(raw)\n } else {\n req.body = raw\n }\n }\n }\n\n // A key that could rewrite a prototype — refused before any of the app's code sees it.\n if (!bodyError && hasPrototypeKey(req.body)) bodyError = prototypeKeyError()\n\n // Reuse the id `requestId()` middleware already gave the request, so the\n // response header, the route's ctx and observers agree on one id.\n const store = createRequestStore(req.requestId || req.headers['x-request-id'])\n req.requestId = store.requestId\n\n const driver = new WebResponseDriver(request.signal)\n driver.setHeader('x-request-id', store.requestId)\n\n publishMatchedRoute(req, entry)\n // Middleware that reports after the response (observers, request logger)\n // reads the route off the request it was handed — the carried one.\n if (carry) publishMatchedRoute(carry, entry)\n\n const pipeline = requestStore.run(store, async () => {\n if (bodyError) throw bodyError\n\n const ctx = new RequestContext(\n req as never,\n driver as never,\n NOOP_NEXT,\n driver as RuntimeResponse,\n )\n\n // `beforeValidation` contributors (#677) — ahead of validation and middleware.\n if (entry.earlyContributorRunner) {\n await entry.earlyContributorRunner(ctx)\n if (driver.settled) return\n }\n\n if (validator) {\n await new Promise<void>((resolve, reject) => {\n validator(req as never, undefined as never, (err?: unknown) =>\n err ? reject(err) : resolve(),\n )\n })\n }\n\n for (const mw of entry.middlewares) {\n let advanced = false\n await new Promise<void>((resolve, reject) => {\n const next = (err?: unknown): void => {\n advanced = true\n if (err) reject(err)\n else resolve()\n }\n Promise.resolve(mw(ctx, next)).catch(reject)\n })\n if (!advanced || driver.settled) return\n }\n\n if (entry.contributorRunner) await entry.contributorRunner(ctx)\n if (driver.settled) return\n const result = await entry.handler(ctx)\n // Return-value handlers (reply.ts): auto-send when nothing was written.\n // `undefined` falls through to the canonical 404 below.\n if (!driver.settled) await applyHandlerResult(ctx, result)\n })\n\n try {\n // Streaming responses resolve `ready` mid-pipeline (SSE); buffered ones\n // resolve at the terminal ctx call. Race so both shapes return promptly.\n try {\n await Promise.race([pipeline, driver.ready])\n } catch (err) {\n // Inside the request's store: an error page renders with the same\n // context and REQUEST-scoped services the route had.\n if (!driver.settled) {\n await requestStore.run(store, async () => {\n if (hooks?.onError) await hooks.onError(err, req, driver)\n if (!driver.settled) await builtInError(err, req, driver, NOOP_NEXT)\n })\n }\n }\n if (!driver.settled) {\n // Pipeline finished without responding — the catch-all's 404.\n builtInNotFound(req, driver, NOOP_NEXT)\n }\n return await driver.ready\n } finally {\n // @PreDestroy teardown. For buffered responses this runs post-response;\n // for streams it runs when the pipeline (not the stream) completes —\n // stream lifetime is governed by the client abort signal.\n void Promise.resolve(pipeline)\n .catch(() => {})\n .then(() => disposeRequestStore(store))\n }\n }\n}\n\n/**\n * HEAD for a GET route: run the route and answer with its status and\n * headers, without the body — what Express and Fastify do for every GET.\n */\nexport async function headFromGet(response: Promise<Response> | Response): Promise<Response> {\n const res = await response\n // A streamed GET (SSE) would otherwise keep producing for nobody.\n res.body?.cancel().catch(() => {})\n return new Response(null, {\n status: res.status,\n statusText: res.statusText,\n headers: res.headers,\n })\n}\n"],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -9,4 +9,4 @@
|
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
11
|
function parseHttpUrl(value){try{let url=new URL(value);return url.protocol===`http:`||url.protocol===`https:`?url:void 0}catch{return}}const HOST_GRAMMAR=/^(?:[A-Za-z0-9.-]+|\[[0-9A-Fa-f:.]+\])(?::\d{1,5})?$/;function canonicalHost(host,protocol){if(host&&HOST_GRAMMAR.test(host))return parseHttpUrl(`${protocol}//${host}`)?.host}export{canonicalHost as n,parseHttpUrl as r,HOST_GRAMMAR as t};
|
|
12
|
-
//# sourceMappingURL=host-
|
|
12
|
+
//# sourceMappingURL=host-DTmYT9lX.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"host-
|
|
1
|
+
{"version":3,"file":"host-DTmYT9lX.mjs","names":[],"sources":["../src/http/host.ts"],"sourcesContent":["/**\n * Host header parsing shared by the middleware that trusts it (CSRF origin\n * check, allowed hosts). One grammar and one canonical form, so two checks\n * never disagree about what host a request named.\n *\n * @module @forinda/kickjs/http/host\n */\n\n/** An http(s) URL, or undefined for anything else (`null`, `file:`, garbage). */\nexport function parseHttpUrl(value: string): URL | undefined {\n try {\n const url = new URL(value)\n return url.protocol === 'http:' || url.protocol === 'https:' ? url : undefined\n } catch {\n return undefined\n }\n}\n\n/**\n * RFC 9110 `Host`: a hostname or bracketed IPv6 literal, optional port. Checked\n * before parsing, so the URL parser never sees userinfo, a path or whitespace —\n * `x@a.test` would otherwise parse to the host `a.test`.\n */\nexport const HOST_GRAMMAR = /^(?:[A-Za-z0-9.-]+|\\[[0-9A-Fa-f:.]+\\])(?::\\d{1,5})?$/\n\n/**\n * The request's host, canonicalized the way `URL` canonicalizes the origin it\n * is compared with (case, IDN, default port for that scheme) — comparing two\n * strings parsed by different rules is how checks like this get bypassed.\n */\nexport function canonicalHost(host: string | undefined, protocol: string): string | undefined {\n if (!host || !HOST_GRAMMAR.test(host)) return undefined\n return parseHttpUrl(`${protocol}//${host}`)?.host\n}\n"],"mappings":";;;;;;;;;;AASA,SAAgB,aAAa,MAAgC,CAC3D,GAAI,CACF,IAAM,IAAM,IAAI,IAAI,KAAK,EACzB,OAAO,IAAI,WAAa,SAAW,IAAI,WAAa,SAAW,IAAM,IAAA,EACvE,MAAQ,CACN,MACF,CACF,CAOA,MAAa,aAAe,uDAO5B,SAAgB,cAAc,KAA0B,SAAsC,CAC5F,GAAK,MAAS,aAAa,KAAK,IAAI,EACpC,OAAO,aAAa,GAAG,SAAS,IAAI,MAAM,CAAC,EAAE,IAC/C"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,4 +8,4 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
export{t as APPLICATION,n as Application,r as describeRoutes}from"../application-
|
|
11
|
+
export{t as APPLICATION,n as Application,r as describeRoutes}from"../application-QBVum-rq.mjs";
|
package/dist/http/bootstrap.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,4 +8,4 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
export{t as bootstrap}from"../bootstrap-
|
|
11
|
+
export{t as bootstrap}from"../bootstrap-D8U1b1lN.mjs";
|
package/dist/http/context.mjs
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,4 +8,4 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
export{t as RequestContext,n as contentDisposition}from"../context-
|
|
11
|
+
export{t as RequestContext,n as contentDisposition}from"../context-DJh3UImF.mjs";
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
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 parseHttpUrl,t as HOST_GRAMMAR}from"../../host-
|
|
11
|
+
import{r as parseHttpUrl,t as HOST_GRAMMAR}from"../../host-DTmYT9lX.mjs";import{n as resolvePathname}from"../../client-ip-B90_tMPE.mjs";import{i as sendJson}from"../../respond-BBYJsJ-G.mjs";function headerOf(headers,name){let value=headers[name];return Array.isArray(value)?value[0]:value}function hostnameOf(host){if(host&&HOST_GRAMMAR.test(host))return parseHttpUrl(`http://${host}`)?.hostname}function compile(patterns){if(patterns.length===0)throw Error(`allowedHosts(): list at least one host`);if(patterns.includes(`*`))return()=>!0;let exact=/* @__PURE__ */ new Set,suffixes=[];for(let pattern of patterns){let wildcard=pattern.startsWith(`.`),hostname=hostnameOf(wildcard?pattern.slice(1):pattern);if(!hostname)throw Error(`allowedHosts(): '${pattern}' is not a host name`);wildcard?suffixes.push(hostname):exact.add(hostname)}return hostname=>exact.has(hostname)||suffixes.some(s=>hostname===s||hostname.endsWith(`.${s}`))}const REJECTED={type:`about:blank`,title:`Bad Request`,status:400,detail:`This host is not served here.`};function allowedHosts(options){let{hosts,trustForwardedHost=!1,ignorePaths=[]}=Array.isArray(options)?{hosts:options}:options,allowed=compile(hosts),ignored=new Set(ignorePaths);return(req,res,next)=>{let headers=req.headers,forwardedHeader=headerOf(headers,`x-forwarded-host`),candidates;if(trustForwardedHost&&forwardedHeader!==void 0?candidates=forwardedHeader.split(`,`).map(h=>h.trim()):(forwardedHeader!==void 0&&delete headers[`x-forwarded-host`],candidates=[headerOf(headers,`host`)??headerOf(headers,`:authority`)]),candidates.every(host=>{let hostname=hostnameOf(host);return hostname!==void 0&&allowed(hostname)}))return next();let method=req.method?.toUpperCase();if(ignored.size>0&&(method===`GET`||method===`HEAD`)&&ignored.has(resolvePathname(req)))return next();res.setHeader(`content-type`,`application/problem+json`),sendJson(res,400,REJECTED)}}export{allowedHosts};
|
|
12
12
|
//# sourceMappingURL=allowed-hosts.mjs.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
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-
|
|
11
|
+
import{n as assertFlagTest,s as matchesFlagTest}from"../../route-flag-DjDiOO3H.mjs";import{t as isProduction}from"../../is-production-CC5VwQUr.mjs";import{n as randomHex,r as safeEqual}from"../../web-crypto-iLWDbH8H.mjs";import{n as canonicalHost,r as parseHttpUrl}from"../../host-DTmYT9lX.mjs";import{n as resolvePathname}from"../../client-ip-B90_tMPE.mjs";import{a as setCookie,i as sendJson,n as readCookies}from"../../respond-BBYJsJ-G.mjs";function headerOf(headers,name){let value=headers[name];return Array.isArray(value)?value[0]:value}function originOfUrl(url){if(url)try{return new URL(url).origin}catch{return}}function isAllowedOrigin(headers,trusted){let site=headerOf(headers,`sec-fetch-site`);if(site===`same-origin`)return!0;let declared=headerOf(headers,`origin`)??originOfUrl(headerOf(headers,`referer`));if(declared===void 0)return site===void 0||site===`none`;let origin=parseHttpUrl(declared);if(!origin)return!1;if(trusted.has(origin.origin))return!0;let host=canonicalHost(headerOf(headers,`host`)??headerOf(headers,`:authority`),origin.protocol);return host!==void 0&&host===origin.host}function trustedSet(origins){return new Set((origins??[]).map(o=>{let url=parseHttpUrl(o);if(!url||url.pathname!==`/`||url.search||url.hash||url.username||url.password)throw Error(`csrf: trustedOrigins entry '${o}' is not an http(s) origin`);return url.origin}))}const ORIGIN_REJECTED={message:`CSRF origin not allowed`},TOKEN=Symbol.for(`kickjs.csrfToken`);function csrfToken(ctx){return ctx?.req?.[TOKEN]}function isOwnToken(value,bytes){return value!==void 0&&value.length===bytes*2&&/^[0-9a-f]+$/.test(value)}function sentToken(headers,body,header,field){if(headers[header]!==void 0)return headerOf(headers,header);let fromBody=body&&typeof body==`object`?body[field]:void 0;return typeof fromBody==`string`?fromBody:void 0}function csrf(options={}){let cookieName=options.cookie??`_csrf`,headerName=options.header??`x-csrf-token`,fieldName=options.field??`_csrf`,protectedMethods=new Set((options.methods??[`POST`,`PUT`,`PATCH`,`DELETE`]).map(m=>m.toUpperCase())),ignorePaths=new Set(options.ignorePaths??[]),tokenLength=options.tokenLength??32,checkOrigin=options.checkOrigin??!0,trusted=trustedSet(options.trustedOrigins),cookieOpts={httpOnly:!1,sameSite:`strict`,secure:isProduction(),path:`/`,...options.cookieOptions};return(req,res,next)=>{let token=readCookies(req)[cookieName];if(isOwnToken(token,tokenLength)||(token=randomHex(tokenLength),setCookie(res,cookieName,token,cookieOpts)),req[TOKEN]=token,!protectedMethods.has(req.method.toUpperCase())||ignorePaths.has(resolvePathname(req)))return next();if(checkOrigin&&!isAllowedOrigin(req.headers,trusted))return sendJson(res,403,ORIGIN_REJECTED);let sent=sentToken(req.headers,req.body,headerName,fieldName);if(sent===void 0||!safeEqual(sent,token))return sendJson(res,403,{message:`CSRF token mismatch`});next()}}function csrfGuard(options={}){let cookieName=options.cookie??`_csrf`,headerName=options.header??`x-csrf-token`,fieldName=options.field??`_csrf`,protectedMethods=new Set((options.methods??[`POST`,`PUT`,`PATCH`,`DELETE`]).map(m=>m.toUpperCase())),ignorePaths=new Set(options.ignorePaths??[]),tokenLength=options.tokenLength??32,exemptWhen=options.exemptWhen;exemptWhen!==void 0&&assertFlagTest(exemptWhen,`csrfGuard({ exemptWhen })`);let checkOrigin=options.checkOrigin??!0,trusted=trustedSet(options.trustedOrigins),cookieOpts={httpOnly:!1,sameSite:`strict`,secure:isProduction(),path:`/`,...options.cookieOptions};return(ctx,next)=>{let token=readCookies(ctx.req)[cookieName];isOwnToken(token,tokenLength)||(token=randomHex(tokenLength),setCookie(ctx.res,cookieName,token,cookieOpts)),ctx.req[TOKEN]=token;let method=ctx.route?.method??ctx.req.method??`GET`;if(!protectedMethods.has(method.toUpperCase())||exemptWhen!==void 0&&matchesFlagTest(exemptWhen,ctx.route?.flags,ctx.route)||ignorePaths.has(resolvePathname(ctx.req)))return next();if(checkOrigin&&!isAllowedOrigin(ctx.headers,trusted)){ctx.json(ORIGIN_REJECTED,403);return}let sent=sentToken(ctx.headers,ctx.req.body,headerName,fieldName);sent===void 0||!safeEqual(sent,token)?ctx.json({message:`CSRF token mismatch`},403):next()}}export{csrf,csrfGuard,csrfToken,isAllowedOrigin};
|
|
12
12
|
//# sourceMappingURL=csrf.mjs.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,6 +8,6 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{createLogger,describeError}from"../../core/logger.mjs";import{HttpException,ProblemException,normalizeProblem}from"../../core/errors.mjs";import{t as isProduction}from"../../is-production-
|
|
11
|
+
import{createLogger,describeError}from"../../core/logger.mjs";import{HttpException,ProblemException,normalizeProblem}from"../../core/errors.mjs";import{t as isProduction}from"../../is-production-CC5VwQUr.mjs";const log=createLogger(`ErrorHandler`);function patternToRegExp(pattern){let source=pattern.replace(/[.+?^${}()|[\]\\]/g,`\\$&`).replace(/\/:[^/]+/g,`/[^/]+`).replace(/\*/g,`.*`);return RegExp(`^${source}/?$`)}function pathOf(req){let url=req.originalUrl??req.url??`/`,cut=url.search(/[?#]/);return cut===-1?url:url.slice(0,cut)}function notFoundHandler(routes=[]){let matchers=routes.map(route=>({method:route.method.toUpperCase(),matches:patternToRegExp(route.path)}));return(req,res,_next)=>{let path=pathOf(req),method=(req.method??`GET`).toUpperCase(),allowed=[...new Set(matchers.filter(m=>m.matches.test(path)).map(m=>m.method))];if(allowed.length>0&&!allowed.includes(method)){let verbs=allowed.toSorted().join(`, `);return res.setHeader(`Allow`,verbs),res.setHeader(`Content-Type`,`application/problem+json`),res.status(405).json(normalizeProblem({status:405,detail:`${method} is not supported for this resource. Allowed: ${verbs}.`}))}return res.setHeader(`Content-Type`,`application/problem+json`),res.status(404).json(normalizeProblem({status:404}))}}function fieldErrors(details){if(Array.isArray(details)&&details.length!==0)return details.every(d=>typeof d?.field==`string`&&typeof d?.message==`string`)?details.map(d=>({field:d.field,message:d.message})):void 0}function errorHandler(){return(err,req,res,_next)=>{let isProduction$1=isProduction();if(res.headersSent){log.warn(`Error after headers sent: ${err?.message||`Unknown`}`);return}if(err instanceof ProblemException){if(err.problem.status>=500&&log.error(err,err.message),err.headers)for(let[k,v]of Object.entries(err.headers))res.setHeader(k,v);let body=normalizeProblem(err.problem);return res.setHeader(`Content-Type`,`application/problem+json`),res.status(body.status).json(body)}if(err?.name===`ZodError`){let firstIssue=err.issues?.[0];return res.status(422).json({message:firstIssue?.message||`Validation failed`,...isProduction$1?{}:{errors:err.issues}})}if(err instanceof HttpException){if(err.status>=500&&log.error(err,err.message),err.headers)for(let[k,v]of Object.entries(err.headers))res.setHeader(k,v);let errors=isProduction$1?err.status===422?fieldErrors(err.details):void 0:err.details;return res.setHeader(`Content-Type`,`application/problem+json`),res.status(err.status).json(normalizeProblem({status:err.status,detail:err.message,...errors===void 0?{}:{errors}}))}let requestId=req.requestId??req.headers[`x-request-id`],declared=Number(err.status??err.statusCode);if(Number.isInteger(declared)&&declared>=400&&declared<500)return log.warn(`${req.method} ${req.originalUrl??req.url} — ${declared} ${describeError(err)}`),res.setHeader(`Content-Type`,`application/problem+json`),res.status(declared).json(normalizeProblem({status:declared,detail:err.message||void 0,...requestId?{requestId}:{}}));let status=Number.isInteger(declared)&&declared>=500&&declared<600?declared:500;log.error(err,`${req.method} ${req.originalUrl??req.url} — ${describeError(err)}${requestId?` [${requestId}]`:``}`),res.status(status).json({message:`Internal Server Error`,...requestId?{requestId}:{},...isProduction$1?{}:{error:describeError(err),...typeof err?.stack==`string`?{stack:err.stack.split(`
|
|
12
12
|
`)}:{}}})}}export{errorHandler,notFoundHandler};
|
|
13
13
|
//# sourceMappingURL=error-handler.mjs.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
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 registerDisposable}from"../../disposables-
|
|
11
|
+
import{r as registerDisposable}from"../../disposables-CLELPWB2.mjs";import{n as assertFlagTest,s as matchesFlagTest}from"../../route-flag-DjDiOO3H.mjs";import{n as bindRoutePolicy}from"../../route-policy-BSaFqylB.mjs";import{n as resolvePathname,t as resolveClientIp}from"../../client-ip-B90_tMPE.mjs";import{i as sendJson}from"../../respond-BBYJsJ-G.mjs";import{t as BoundedCounters}from"../../bounded-counters-W_iZ-6a-.mjs";var MemoryStore=class{counters;cleanupTimer;constructor(windowMs,limit){this.counters=new BoundedCounters(windowMs,limit),this.cleanupTimer=setInterval(()=>this.counters.sweep(),windowMs),this.cleanupTimer.unref&&this.cleanupTimer.unref(),registerDisposable(()=>this.dispose())}dispose(){clearInterval(this.cleanupTimer),this.counters.clear()}async increment(key){return this.counters.increment(key)}async decrement(key){this.counters.decrement(key)}async reset(key){this.counters.reset(key)}};function rateLimit(options={}){let max=options.max??100,windowMs=options.windowMs??6e4,message=options.message??`Too Many Requests`,statusCode=options.statusCode??429,keyGenerator=options.keyGenerator??(req=>resolveClientIp(req)??`global`),sendHeaders=options.headers??!0,store=options.store??new MemoryStore(windowMs,max),skip=options.skip,skipPaths=new Set(options.skipPaths??[]),exemptWhen=options.exemptWhen;exemptWhen!==void 0&&assertFlagTest(exemptWhen,`rateLimit({ exemptWhen })`);let policy;return bindRoutePolicy(async(req,res,next)=>{let pathname=resolvePathname(req);if(skipPaths.has(pathname))return next();if(exemptWhen!==void 0&&policy){let{originalUrl}=req,routePath=originalUrl?resolvePathname({url:originalUrl}):pathname,flags=policy.lookup(String(req.method??`GET`),routePath);if(matchesFlagTest(exemptWhen,flags))return next()}if(skip&&skip(req))return next();let key=keyGenerator(req),{totalHits,resetTime}=await store.increment(key),remaining=Math.max(0,max-totalHits);if(sendHeaders&&(res.setHeader(`RateLimit-Limit`,max),res.setHeader(`RateLimit-Remaining`,remaining),res.setHeader(`RateLimit-Reset`,Math.ceil(resetTime.getTime()/1e3))),totalHits>max)return sendJson(res,statusCode,{message});next()},table=>{policy=table})}export{MemoryStore,rateLimit};
|
|
12
12
|
//# sourceMappingURL=rate-limit.mjs.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{createLogger}from"../../core/logger.mjs";import"../../core-
|
|
11
|
+
import{createLogger}from"../../core/logger.mjs";import"../../core-fD81or3K.mjs";function pathnameOf(url){if(!url)return`/`;let q=url.indexOf(`?`);return(q===-1?url:url.slice(0,q))||`/`}function requestLogger(options={}){let log=createLogger(options.name??`HTTP`),level=options.level??`info`,skip=options.skip??[];return(req,res,next)=>{let pathname=req.path??pathnameOf(req.url);if(skip.some(prefix=>pathname.startsWith(prefix)))return next();let start=Date.now();res.on(`finish`,()=>{let duration=Date.now()-start,requestId=req.requestId||req.headers[`x-request-id`]||`-`,status=res.statusCode,path=req.originalUrl??req.url??`/`;log.child({method:req.method,path,status,ms:duration,requestId})[level](`${req.method} ${path} ${status} ${duration}ms ${requestId}`)}),next()}}export{requestLogger};
|
|
12
12
|
//# sourceMappingURL=request-logger.mjs.map
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* @forinda/kickjs v10.13.
|
|
2
|
+
* @forinda/kickjs v10.13.1
|
|
3
3
|
*
|
|
4
4
|
* Copyright (c) Felix Orinda
|
|
5
5
|
*
|
|
@@ -8,5 +8,5 @@
|
|
|
8
8
|
*
|
|
9
9
|
* @license MIT
|
|
10
10
|
*/
|
|
11
|
-
import{createLogger}from"../../core/logger.mjs";import{r as registerDisposable}from"../../disposables-
|
|
11
|
+
import{createLogger}from"../../core/logger.mjs";import{r as registerDisposable}from"../../disposables-CLELPWB2.mjs";import{t as isProduction}from"../../is-production-CC5VwQUr.mjs";import{a as setCookie,r as replaceCookie,t as parseCookieHeader}from"../../respond-BBYJsJ-G.mjs";import{n as WebResponseDriver}from"../../driver-60Ojtg4A.mjs";import{createCipheriv,createDecipheriv,createHmac,hkdfSync,randomBytes,randomUUID,timingSafeEqual}from"node:crypto";var MemoryStore=class{sessions=/* @__PURE__ */ new Map;empty=/* @__PURE__ */ new Set;cleanupInterval;constructor(){this.cleanupInterval=setInterval(()=>this.purge(),6e4),this.cleanupInterval.unref(),registerDisposable(()=>this.dispose())}dispose(){clearInterval(this.cleanupInterval),this.sessions.clear(),this.empty.clear()}async get(sid){let entry=this.sessions.get(sid);return entry?Date.now()>entry.expires?(this.sessions.delete(sid),this.empty.delete(sid),null):entry.data:null}async set(sid,data,maxAge){for(this.sessions.delete(sid),this.sessions.set(sid,{data,expires:Date.now()+maxAge}),this.empty.delete(sid),Object.keys(data).length===0&&this.empty.add(sid);this.sessions.size>1e4;){let victim=this.empty.values().next().value??this.sessions.keys().next().value;this.sessions.delete(victim),this.empty.delete(victim)}}async destroy(sid){this.sessions.delete(sid),this.empty.delete(sid)}async touch(sid,maxAge){let entry=this.sessions.get(sid);entry&&(entry.expires=Date.now()+maxAge,this.sessions.delete(sid),this.sessions.set(sid,entry))}purge(){let now=Date.now();for(let[sid,entry]of this.sessions)now>entry.expires&&(this.sessions.delete(sid),this.empty.delete(sid))}};function secretList(secret){let list=Array.isArray(secret)?secret:[secret];if(list.length===0||list.some(s=>typeof s!=`string`||s.length===0))throw Error("session(): `secret` must be a non-empty string or list of strings");return list}function sign(value,secret){return`s:${value}.${createHmac(`sha256`,secret).update(value).digest(`base64url`)}`}function unsign(signed,secrets){if(!signed.startsWith(`s:`))return!1;let raw=signed.slice(2),dotIndex=raw.lastIndexOf(`.`);if(dotIndex===-1)return!1;let value=raw.slice(0,dotIndex),provided=Buffer.from(raw.slice(dotIndex+1));for(let[index,secret]of secrets.entries()){let expected=Buffer.from(createHmac(`sha256`,secret).update(value).digest(`base64url`));if(provided.length===expected.length&&timingSafeEqual(provided,expected))return{value,stale:index>0}}return!1}const storeLog=createLogger(`Session`);function session(options){if(options.store===`cookie`)return cookieSession(options);let{cookieName=`kick.sid`,maxAge=864e5,rolling=!1,saveUninitialized=!0,saveTimeout=5e3,cookie:cookieOpts={}}=options,secrets=secretList(options.secret),secret=secrets[0],store=options.store??new MemoryStore,cookieDefaults={httpOnly:cookieOpts.httpOnly??!0,secure:cookieOpts.secure??isProduction(),sameSite:cookieOpts.sameSite??`lax`,path:cookieOpts.path??`/`,...cookieOpts.domain?{domain:cookieOpts.domain}:{},maxAge};return async(req,res,next)=>{let cookies=req.cookies;if(!cookies){let header=req.headers.cookie;cookies=header?parseCookieHeader(header):{}}let signedCookie=cookies[cookieName],sid=!1,sessionData=null,isNew=!1,staleSignature=!1;if(signedCookie){let unsigned=unsign(signedCookie,secrets);unsigned&&(sid=unsigned.value,staleSignature=unsigned.stale,sessionData=await store.get(sid))}(!sid||!sessionData)&&(sid=randomUUID(),sessionData={},isNew=!0);let currentSid=sid,currentData={...sessionData},destroyed=!1,sessionObj={get id(){return currentSid},data:currentData,async regenerate(){await store.destroy(currentSid),currentSid=randomUUID(),currentData={},sessionObj.data=currentData,await store.set(currentSid,currentData,maxAge),setCookie(res,cookieName,sign(currentSid,secret),cookieDefaults)},async destroy(){await store.destroy(currentSid),destroyed=!0,currentData={},sessionObj.data=currentData,setCookie(res,cookieName,``,{...cookieDefaults,maxAge:0,expires:/* @__PURE__ */ new Date(0)})},async save(){destroyed||await store.set(currentSid,currentData,maxAge)}};req.session=sessionObj,isNew&&setCookie(res,cookieName,sign(currentSid,secret),cookieDefaults);let persisted,persist=()=>persisted??=(async()=>{destroyed||(!isNew||saveUninitialized||Object.keys(currentData).length!==0)&&(await store.set(currentSid,currentData,maxAge),rolling&&!isNew&&store.touch&&await store.touch(currentSid,maxAge))})(),saved=()=>new Promise(done=>{let timer=setTimeout(()=>{storeLog.error(`Session save took over ${saveTimeout}ms; sending the response anyway`),done()},saveTimeout);persist().then(()=>{clearTimeout(timer),done()},err=>{clearTimeout(timer),storeLog.error(err,`Session save failed; sending the response anyway`),done()})});if(res instanceof WebResponseDriver)res.on(`finish`,()=>saved());else{let end=res.end;res.end=function(...args){return saved().then(()=>end.apply(this,args)),this}}!isNew&&(rolling||staleSignature)&&setCookie(res,cookieName,sign(currentSid,secret),cookieDefaults),next()}}const cookieLog=createLogger(`Session`);function sealer(secrets,cookieName){let keys=secrets.map(secret=>Buffer.from(hkdfSync(`sha256`,secret,`kick.session`,`cookie-store-v1`,32))),key=keys[0],aad=Buffer.from(cookieName);return{seal(payload){let iv=randomBytes(12),cipher=createCipheriv(`aes-256-gcm`,key,iv).setAAD(aad),body=Buffer.concat([cipher.update(JSON.stringify(payload),`utf8`),cipher.final()]);return`v1.${Buffer.concat([iv,cipher.getAuthTag(),body]).toString(`base64url`)}`},open(value){if(!value.startsWith(`v1.`))return null;let raw;try{raw=Buffer.from(value.slice(3),`base64url`)}catch{return null}if(raw.length<29)return null;for(let[index,k]of keys.entries())try{let decipher=createDecipheriv(`aes-256-gcm`,k,raw.subarray(0,12)).setAAD(aad).setAuthTag(raw.subarray(12,28)),json=Buffer.concat([decipher.update(raw.subarray(28)),decipher.final()]),payload=JSON.parse(json.toString(`utf8`));return typeof payload?.i!=`string`||typeof payload.e!=`number`||!payload.d||typeof payload.d!=`object`?null:payload.e>Date.now()?{payload,stale:index>0}:null}catch{}return null}}}function cookieSession(options){let{cookieName=`kick.sid`,maxAge=864e5,rolling=!1,saveUninitialized=!0,cookie:cookieOpts={}}=options,{seal,open}=sealer(secretList(options.secret),cookieName),cookieDefaults={httpOnly:cookieOpts.httpOnly??!0,secure:cookieOpts.secure??isProduction(),sameSite:cookieOpts.sameSite??`lax`,path:cookieOpts.path??`/`,...cookieOpts.domain?{domain:cookieOpts.domain}:{}},warnedSize=!1;return(req,res,next)=>{let cookies=req.cookies;if(!cookies){let header=req.headers.cookie;cookies=header?parseCookieHeader(header):{}}let opened=cookies[cookieName]?open(cookies[cookieName]):null,existing=opened?.payload??null,isNew=!existing,id=existing?.i??randomUUID(),destroyed=!1,written=existing&&!opened?.stale?JSON.stringify(existing.d):void 0,write=(force=!1)=>{if(res.headersSent)return;if(destroyed){replaceCookie(res,cookieName,``,{...cookieDefaults,maxAge:0,expires:/* @__PURE__ */ new Date(0)});return}let json=JSON.stringify(sessionObj.data);if(json===written&&!force&&(!rolling||isNew)||written===void 0&&json===`{}`&&!saveUninitialized&&!force)return;let value=seal({i:id,d:sessionObj.data,e:Date.now()+maxAge});value.length+cookieName.length>4e3&&!warnedSize&&(warnedSize=!0,cookieLog.warn(`session cookie is ${value.length} bytes; browsers drop cookies over 4 KB, so this session will not be kept. Store less in it, or use a shared store.`)),replaceCookie(res,cookieName,value,{...cookieDefaults,maxAge}),written=json};for(let method of[`writeHead`,`flushHeaders`,`write`,`end`]){let original=res[method];typeof original==`function`&&(res[method]=function(...args){return write(),original.apply(this,args)})}res.on?.(`finish`,()=>write());let sessionObj={get id(){return id},data:existing?{...existing.d}:{},async regenerate(){id=randomUUID(),sessionObj.data={},written=void 0,write(!0)},async destroy(){destroyed=!0,sessionObj.data={},write()},async save(){write()}};req.session=sessionObj,next()}}export{MemoryStore,session};
|
|
12
12
|
//# sourceMappingURL=session.mjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"session.mjs","names":[],"sources":["../../../src/http/middleware/session.ts"],"sourcesContent":["import { parseCookieHeader, replaceCookie, setCookie } from './respond'\nimport {\n createCipheriv,\n createDecipheriv,\n createHmac,\n hkdfSync,\n randomBytes,\n randomUUID,\n timingSafeEqual,\n} from 'node:crypto'\nimport { createLogger } from '../../core/logger'\nimport { WebResponseDriver } from '../web/driver'\nimport type {\n ConnectRequest as Request,\n ConnectResponse as Response,\n ConnectNext as NextFunction,\n} from '../connect'\n\nimport { registerDisposable } from '../../core/disposables'\nimport { isProduction } from '../../core/is-production'\n\n/**\n * What a session holds. Augment it to type your keys — undeclared keys stay\n * readable as `unknown`:\n *\n * ```ts\n * declare module '@forinda/kickjs' {\n * interface SessionData { userId?: string; cart?: string[] }\n * }\n * ```\n */\nexport interface SessionData {\n [key: string]: unknown\n}\n\nexport interface SessionStore {\n get(sid: string): Promise<SessionData | null>\n set(sid: string, data: SessionData, maxAge: number): Promise<void>\n destroy(sid: string): Promise<void>\n touch?(sid: string, maxAge: number): Promise<void>\n}\n\nexport interface Session {\n id: string\n data: SessionData\n regenerate(): Promise<void>\n destroy(): Promise<void>\n save(): Promise<void>\n}\n\nexport interface SessionOptions {\n /**\n * Secret that signs the session cookie — or, with `store: 'cookie'`,\n * encrypts it (required).\n *\n * Pass a list to rotate without logging everyone out: the first secret signs\n * new cookies, every secret is accepted, and a cookie made with an older one\n * is re-issued with the first. Drop the old secret once sessions have moved\n * over (after `maxAge`).\n *\n * ```ts\n * session({ secret: [process.env.SESSION_SECRET!, process.env.SESSION_SECRET_OLD!] })\n * ```\n */\n secret: string | string[]\n /** Cookie name (default: 'kick.sid') */\n cookieName?: string\n /** Session max age in milliseconds (default: 86400000 = 24h) */\n maxAge?: number\n /** Reset maxAge on every response (default: false) */\n rolling?: boolean\n /** Save new sessions that have not been modified (default: true) */\n saveUninitialized?: boolean\n /**\n * How long a response waits for the store to save the session before it\n * goes out anyway, in ms (default 5000). A stalled store would otherwise\n * hold every response; past this, the request after it may not see the save.\n */\n saveTimeout?: number\n /** Cookie options */\n cookie?: {\n httpOnly?: boolean\n secure?: boolean\n sameSite?: 'strict' | 'lax' | 'none'\n path?: string\n domain?: string\n }\n /**\n * Where session data lives. Default: in memory, in this process.\n *\n * `'cookie'` keeps it in the session cookie itself, encrypted with\n * AES-256-GCM under a key derived from `secret`: every instance reads the\n * same session with nothing shared between them — serverless functions,\n * several containers. The data has to fit a cookie (about 4 KB).\n *\n * Or pass a store shared between instances (`KvSessionStore`, Redis).\n */\n store?: SessionStore | 'cookie'\n}\n\n// ── In-Memory Store ───────────────────────────────────────────────────\n\n// ponytail: fixed cap for the single-instance default; a shared store\n// (KvSessionStore, Redis) is the answer for more.\nconst MAX_SESSIONS = 10_000\n\n/** @internal Exported for tests. */\nexport class MemoryStore implements SessionStore {\n private readonly sessions = new Map<string, { data: SessionData; expires: number }>()\n /** Sessions with no data, oldest first: evicted before any that hold some. */\n private readonly empty = new Set<string>()\n private readonly cleanupInterval: ReturnType<typeof setInterval>\n\n constructor() {\n // Purge expired sessions every 60 seconds\n this.cleanupInterval = setInterval(() => this.purge(), 60_000)\n this.cleanupInterval.unref()\n // Symmetric teardown: Application.shutdown() drains the disposables\n // registry — without this, every in-process app re-create (tests, HMR)\n // leaked one live interval + its session Map.\n registerDisposable(() => this.dispose())\n }\n\n /** Clear the cleanup interval and drop all sessions. */\n dispose(): void {\n clearInterval(this.cleanupInterval)\n this.sessions.clear()\n this.empty.clear()\n }\n\n async get(sid: string): Promise<SessionData | null> {\n const entry = this.sessions.get(sid)\n if (!entry) return null\n if (Date.now() > entry.expires) {\n this.sessions.delete(sid)\n this.empty.delete(sid)\n return null\n }\n return entry.data\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n // Deleted first so the map stays in last-written order, oldest at the front.\n this.sessions.delete(sid)\n this.sessions.set(sid, { data, expires: Date.now() + maxAge })\n this.empty.delete(sid)\n if (Object.keys(data).length === 0) this.empty.add(sid)\n // A session is created for every visitor without a cookie, so a client\n // can make as many as it sends requests. Past the cap, an empty session\n // goes first — a flood of cookieless requests makes only empty ones, so\n // it can't push out sessions that hold a login; only when none is empty\n // does the least recently written go.\n while (this.sessions.size > MAX_SESSIONS) {\n const victim = this.empty.values().next().value ?? this.sessions.keys().next().value!\n this.sessions.delete(victim)\n this.empty.delete(victim)\n }\n }\n\n async destroy(sid: string): Promise<void> {\n this.sessions.delete(sid)\n this.empty.delete(sid)\n }\n\n async touch(sid: string, maxAge: number): Promise<void> {\n const entry = this.sessions.get(sid)\n if (entry) {\n entry.expires = Date.now() + maxAge\n this.sessions.delete(sid)\n this.sessions.set(sid, entry)\n }\n }\n\n private purge() {\n const now = Date.now()\n for (const [sid, entry] of this.sessions) {\n if (now > entry.expires) {\n this.sessions.delete(sid)\n this.empty.delete(sid)\n }\n }\n }\n}\n\n// ── Cookie Signing ────────────────────────────────────────────────────\n\n/** `secret` as a non-empty list, newest first. */\nfunction secretList(secret: string | string[]): string[] {\n const list = Array.isArray(secret) ? secret : [secret]\n if (list.length === 0 || list.some((s) => typeof s !== 'string' || s.length === 0)) {\n throw new Error('session(): `secret` must be a non-empty string or list of strings')\n }\n return list\n}\n\nfunction sign(value: string, secret: string): string {\n const signature = createHmac('sha256', secret).update(value).digest('base64url')\n return `s:${value}.${signature}`\n}\n\n/**\n * The signed value, and whether it was signed with an older secret than the\n * first (so the caller re-issues it); false when no secret verifies it.\n */\nfunction unsign(signed: string, secrets: string[]): { value: string; stale: boolean } | false {\n if (!signed.startsWith('s:')) return false\n const raw = signed.slice(2)\n const dotIndex = raw.lastIndexOf('.')\n if (dotIndex === -1) return false\n\n const value = raw.slice(0, dotIndex)\n const provided = Buffer.from(raw.slice(dotIndex + 1))\n\n for (const [index, secret] of secrets.entries()) {\n const expected = Buffer.from(createHmac('sha256', secret).update(value).digest('base64url'))\n if (provided.length === expected.length && timingSafeEqual(provided, expected)) {\n return { value, stale: index > 0 }\n }\n }\n return false\n}\n\n// ── Middleware Factory ────────────────────────────────────────────────\n\n/**\n * Session management middleware.\n *\n * Attaches a `req.session` object with `id`, `data`, `regenerate()`,\n * `destroy()`, and `save()` methods. Session IDs are signed with\n * HMAC-SHA256 to prevent cookie tampering.\n *\n * Reads the session cookie from `req.cookies` when an upstream cookie\n * parser is present; otherwise parses `req.headers.cookie` directly, so\n * no cookie parser is required upstream.\n *\n * @example\n * ```ts\n * import { session } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * middlewares: [\n * session({ secret: process.env.SESSION_SECRET! }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nconst storeLog = createLogger('Session')\n\nexport function session(options: SessionOptions) {\n if (options.store === 'cookie') return cookieSession(options)\n const {\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n saveTimeout = 5000,\n cookie: cookieOpts = {},\n } = options\n const secrets = secretList(options.secret)\n const secret = secrets[0]\n const store = (options.store as SessionStore | undefined) ?? new MemoryStore()\n\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? isProduction(),\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n maxAge,\n }\n\n return async (req: Request, res: Response, next: NextFunction) => {\n let cookies = (req as any).cookies as Record<string, string> | undefined\n if (!cookies) {\n const header = req.headers.cookie\n cookies = header ? parseCookieHeader(header) : {}\n }\n const signedCookie = cookies[cookieName]\n let sid: string | false = false\n let sessionData: SessionData | null = null\n let isNew = false\n let staleSignature = false\n\n // Attempt to recover existing session\n if (signedCookie) {\n const unsigned = unsign(signedCookie, secrets)\n if (unsigned) {\n sid = unsigned.value\n staleSignature = unsigned.stale\n sessionData = await store.get(sid)\n }\n }\n\n // Create new session if none found\n if (!sid || !sessionData) {\n sid = randomUUID()\n sessionData = {}\n isNew = true\n }\n\n let currentSid = sid\n let currentData = { ...sessionData }\n let destroyed = false\n\n const sessionObj: Session = {\n get id() {\n return currentSid\n },\n data: currentData,\n\n async regenerate() {\n await store.destroy(currentSid)\n currentSid = randomUUID()\n currentData = {}\n sessionObj.data = currentData\n await store.set(currentSid, currentData, maxAge)\n setCookie(res, cookieName, sign(currentSid, secret), cookieDefaults)\n },\n\n async destroy() {\n await store.destroy(currentSid)\n destroyed = true\n currentData = {}\n sessionObj.data = currentData\n // Expire the cookie the same way it was set — `res.clearCookie` is\n // Express-only and threw under Fastify and h3.\n setCookie(res, cookieName, '', { ...cookieDefaults, maxAge: 0, expires: new Date(0) })\n },\n\n async save() {\n if (!destroyed) {\n await store.set(currentSid, currentData, maxAge)\n }\n },\n }\n\n ;(req as any).session = sessionObj\n\n // Set cookie for new sessions\n if (isNew) {\n setCookie(res, cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n // Saved once, at the end of the request.\n let persisted: Promise<void> | undefined\n const persist = () =>\n (persisted ??= (async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n await store.set(currentSid, currentData, maxAge)\n if (rolling && !isNew && store.touch) await store.touch(currentSid, maxAge)\n })())\n\n // Before the response goes out, not after: the redirect after a form post\n // comes straight back and must see what this request wrote. The response\n // ends once the store has it (a Redis write, say), as express-session does.\n // The fetch drivers build their Response in end(), so they keep the\n // `finish` save below.\n if (!(res instanceof WebResponseDriver)) {\n const end = res.end as (...args: unknown[]) => unknown\n ;(res as unknown as { end: (...args: unknown[]) => unknown }).end = function (\n this: unknown,\n ...args: unknown[]\n ) {\n let sent = false\n const send = () => {\n if (sent) return\n sent = true\n clearTimeout(timer)\n end.apply(this, args)\n }\n const timer = setTimeout(() => {\n storeLog.error(`Session save took over ${saveTimeout}ms; sending the response anyway`)\n send()\n }, saveTimeout)\n persist().then(send, (err: unknown) => {\n storeLog.error(err, 'Session save failed; sending the response anyway')\n send()\n })\n return this\n }\n }\n res.on('finish', () => {\n // Already logged by end() on a Node response; the fetch drivers only save here.\n persist().catch((err: unknown) => {\n if (res instanceof WebResponseDriver)\n storeLog.error(err, 'Session save failed after the response was sent')\n })\n })\n\n // Rolling refreshes the cookie on every response; a cookie signed with an\n // older secret is re-signed with the current one.\n if (!isNew && (rolling || staleSignature)) {\n setCookie(res, cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n next()\n }\n}\n\n// ── Cookie store ──────────────────────────────────────────────────────\n\nconst cookieLog = createLogger('Session')\n\n/** Browsers drop a cookie larger than 4096 bytes, name and attributes included. */\nconst COOKIE_LIMIT = 4000\n\ninterface CookiePayload {\n /** Session id. */\n i: string\n d: SessionData\n /** Expiry, ms since epoch. */\n e: number\n}\n\n/**\n * AES-256-GCM, with the cookie name as associated data: `v1.<iv|tag|ciphertext>`.\n * Seals with the first secret's key; opens with any of them.\n */\nfunction sealer(secrets: string[], cookieName: string) {\n const keys = secrets.map((secret) =>\n Buffer.from(hkdfSync('sha256', secret, 'kick.session', 'cookie-store-v1', 32)),\n )\n const key = keys[0]\n const aad = Buffer.from(cookieName)\n return {\n seal(payload: CookiePayload): string {\n const iv = randomBytes(12)\n const cipher = createCipheriv('aes-256-gcm', key, iv).setAAD(aad)\n const body = Buffer.concat([cipher.update(JSON.stringify(payload), 'utf8'), cipher.final()])\n return `v1.${Buffer.concat([iv, cipher.getAuthTag(), body]).toString('base64url')}`\n },\n /**\n * The payload and whether an older secret's key opened it, or null for\n * anything forged, altered, expired or malformed.\n */\n open(value: string): { payload: CookiePayload; stale: boolean } | null {\n if (!value.startsWith('v1.')) return null\n let raw: Buffer\n try {\n raw = Buffer.from(value.slice(3), 'base64url')\n } catch {\n return null\n }\n if (raw.length < 29) return null\n for (const [index, k] of keys.entries()) {\n try {\n const decipher = createDecipheriv('aes-256-gcm', k, raw.subarray(0, 12))\n .setAAD(aad)\n .setAuthTag(raw.subarray(12, 28))\n const json = Buffer.concat([decipher.update(raw.subarray(28)), decipher.final()])\n const payload = JSON.parse(json.toString('utf8')) as CookiePayload\n if (typeof payload?.i !== 'string' || typeof payload.e !== 'number') return null\n if (!payload.d || typeof payload.d !== 'object') return null\n return payload.e > Date.now() ? { payload, stale: index > 0 } : null\n } catch {\n // Not this key (the auth tag fails) — try the next.\n }\n }\n return null\n },\n }\n}\n\ntype HeaderWriter = (...args: unknown[]) => unknown\n\n/**\n * `session({ store: 'cookie' })`. The cookie is written as late as possible —\n * just before the response's headers go out — so every change made while\n * handling the request is in it, nested ones included. `save()` writes it\n * straight away, for code that redirects right after.\n */\nfunction cookieSession(options: SessionOptions) {\n const {\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n cookie: cookieOpts = {},\n } = options\n const { seal, open } = sealer(secretList(options.secret), cookieName)\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? isProduction(),\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n }\n let warnedSize = false\n\n return (req: Request, res: Response, next: NextFunction) => {\n let cookies = (req as any).cookies as Record<string, string> | undefined\n if (!cookies) {\n const header = req.headers.cookie\n cookies = header ? parseCookieHeader(header) : {}\n }\n const opened = cookies[cookieName] ? open(cookies[cookieName]) : null\n const existing = opened?.payload ?? null\n const isNew = !existing\n\n let id = existing?.i ?? randomUUID()\n let destroyed = false\n // What the browser already holds, to skip rewriting an unchanged cookie.\n // A cookie sealed with an older secret counts as nothing held, so it is\n // rewritten with the current one.\n let written = existing && !opened?.stale ? JSON.stringify(existing.d) : undefined\n\n const write = (force = false) => {\n if (res.headersSent) return\n if (destroyed) {\n replaceCookie(res, cookieName, '', { ...cookieDefaults, maxAge: 0, expires: new Date(0) })\n return\n }\n const json = JSON.stringify(sessionObj.data)\n // Unchanged: leave the browser's copy, unless `rolling` renews it.\n if (json === written && !force && !(rolling && !isNew)) return\n // A new, empty session gets a cookie only with saveUninitialized.\n if (written === undefined && json === '{}' && !saveUninitialized && !force) return\n const value = seal({ i: id, d: sessionObj.data, e: Date.now() + maxAge })\n if (value.length + cookieName.length > COOKIE_LIMIT && !warnedSize) {\n warnedSize = true\n cookieLog.warn(\n `session cookie is ${value.length} bytes; browsers drop cookies over 4 KB, ` +\n 'so this session will not be kept. Store less in it, or use a shared store.',\n )\n }\n replaceCookie(res, cookieName, value, { ...cookieDefaults, maxAge })\n written = json\n }\n\n // Just before the headers go out, on whichever call sends them first —\n // Node responses go through writeHead; the web driver's buffered end()\n // does not.\n for (const method of ['writeHead', 'flushHeaders', 'write', 'end'] as const) {\n const original = (res as unknown as Record<string, HeaderWriter | undefined>)[method]\n if (typeof original !== 'function') continue\n ;(res as unknown as Record<string, HeaderWriter>)[method] = function (\n this: unknown,\n ...args: unknown[]\n ) {\n write()\n return original.apply(this, args)\n }\n }\n\n // h3 called through fetch hands middleware a stand-in response whose\n // headers join the route's response after `finish` — the last chance there.\n // On a Node response `finish` comes after the headers, so this is a no-op.\n ;(res as unknown as { on?: (event: string, fn: () => void) => unknown }).on?.('finish', () =>\n write(),\n )\n\n const sessionObj: Session = {\n get id() {\n return id\n },\n data: existing ? { ...existing.d } : {},\n async regenerate() {\n id = randomUUID()\n sessionObj.data = {}\n written = undefined\n write(true)\n },\n async destroy() {\n destroyed = true\n sessionObj.data = {}\n write()\n },\n async save() {\n write()\n },\n }\n ;(req as any).session = sessionObj\n next()\n }\n}\n"],"mappings":";;;;;;;;;;ucA2GA,IAAa,YAAb,KAAiD,CAC/C,yBAA4B,IAAI,IAEhC,sBAAyB,IAAI,IAC7B,gBAEA,aAAc,CAEZ,KAAK,gBAAkB,gBAAkB,KAAK,MAAM,EAAG,GAAM,EAC7D,KAAK,gBAAgB,MAAM,EAI3B,uBAAyB,KAAK,QAAQ,CAAC,CACzC,CAGA,SAAgB,CACd,cAAc,KAAK,eAAe,EAClC,KAAK,SAAS,MAAM,EACpB,KAAK,MAAM,MAAM,CACnB,CAEA,MAAM,IAAI,IAA0C,CAClD,IAAM,MAAQ,KAAK,SAAS,IAAI,GAAG,EAOnC,OANK,MACD,KAAK,IAAI,EAAI,MAAM,SACrB,KAAK,SAAS,OAAO,GAAG,EACxB,KAAK,MAAM,OAAO,GAAG,EACd,MAEF,MAAM,KANM,IAOrB,CAEA,MAAM,IAAI,IAAa,KAAmB,OAA+B,CAWvE,IATA,KAAK,SAAS,OAAO,GAAG,EACxB,KAAK,SAAS,IAAI,IAAK,CAAE,KAAM,QAAS,KAAK,IAAI,EAAI,MAAO,CAAC,EAC7D,KAAK,MAAM,OAAO,GAAG,EACjB,OAAO,KAAK,IAAI,CAAC,CAAC,SAAW,GAAG,KAAK,MAAM,IAAI,GAAG,EAM/C,KAAK,SAAS,KAAO,KAAc,CACxC,IAAM,OAAS,KAAK,MAAM,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,OAAS,KAAK,SAAS,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,MAC/E,KAAK,SAAS,OAAO,MAAM,EAC3B,KAAK,MAAM,OAAO,MAAM,CAC1B,CACF,CAEA,MAAM,QAAQ,IAA4B,CACxC,KAAK,SAAS,OAAO,GAAG,EACxB,KAAK,MAAM,OAAO,GAAG,CACvB,CAEA,MAAM,MAAM,IAAa,OAA+B,CACtD,IAAM,MAAQ,KAAK,SAAS,IAAI,GAAG,EAC/B,QACF,MAAM,QAAU,KAAK,IAAI,EAAI,OAC7B,KAAK,SAAS,OAAO,GAAG,EACxB,KAAK,SAAS,IAAI,IAAK,KAAK,EAEhC,CAEA,OAAgB,CACd,IAAM,IAAM,KAAK,IAAI,EACrB,IAAK,GAAM,CAAC,IAAK,SAAU,KAAK,SAC1B,IAAM,MAAM,UACd,KAAK,SAAS,OAAO,GAAG,EACxB,KAAK,MAAM,OAAO,GAAG,EAG3B,CACF,EAKA,SAAS,WAAW,OAAqC,CACvD,IAAM,KAAO,MAAM,QAAQ,MAAM,EAAI,OAAS,CAAC,MAAM,EACrD,GAAI,KAAK,SAAW,GAAK,KAAK,KAAM,GAAM,OAAO,GAAM,UAAY,EAAE,SAAW,CAAC,EAC/E,MAAU,MAAM,mEAAmE,EAErF,OAAO,IACT,CAEA,SAAS,KAAK,MAAe,OAAwB,CAEnD,MAAO,KAAK,MAAM,GADA,WAAW,SAAU,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,WACvC,GAC/B,CAMA,SAAS,OAAO,OAAgB,QAA8D,CAC5F,GAAI,CAAC,OAAO,WAAW,IAAI,EAAG,MAAO,GACrC,IAAM,IAAM,OAAO,MAAM,CAAC,EACpB,SAAW,IAAI,YAAY,GAAG,EACpC,GAAI,WAAa,GAAI,MAAO,GAE5B,IAAM,MAAQ,IAAI,MAAM,EAAG,QAAQ,EAC7B,SAAW,OAAO,KAAK,IAAI,MAAM,SAAW,CAAC,CAAC,EAEpD,IAAK,GAAM,CAAC,MAAO,UAAW,QAAQ,QAAQ,EAAG,CAC/C,IAAM,SAAW,OAAO,KAAK,WAAW,SAAU,MAAM,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,OAAO,WAAW,CAAC,EAC3F,GAAI,SAAS,SAAW,SAAS,QAAU,gBAAgB,SAAU,QAAQ,EAC3E,MAAO,CAAE,MAAO,MAAO,MAAQ,CAAE,CAErC,CACA,MAAO,EACT,CA4BA,MAAM,SAAW,aAAa,SAAS,EAEvC,SAAgB,QAAQ,QAAyB,CAC/C,GAAI,QAAQ,QAAU,SAAU,OAAO,cAAc,OAAO,EAC5D,GAAM,CACJ,WAAa,WACb,OAAS,MACT,QAAU,GACV,kBAAoB,GACpB,YAAc,IACd,OAAQ,WAAa,CAAC,GACpB,QACE,QAAU,WAAW,QAAQ,MAAM,EACnC,OAAS,QAAQ,GACjB,MAAS,QAAQ,OAAsC,IAAI,YAE3D,eAAiB,CACrB,SAAU,WAAW,UAAY,GACjC,OAAQ,WAAW,QAAU,aAAa,EAC1C,SAAU,WAAW,UAAa,MAClC,KAAM,WAAW,MAAQ,IACzB,GAAI,WAAW,OAAS,CAAE,OAAQ,WAAW,MAAO,EAAI,CAAC,EACzD,MACF,EAEA,OAAO,MAAO,IAAc,IAAe,OAAuB,CAChE,IAAI,QAAW,IAAY,QAC3B,GAAI,CAAC,QAAS,CACZ,IAAM,OAAS,IAAI,QAAQ,OAC3B,QAAU,OAAS,kBAAkB,MAAM,EAAI,CAAC,CAClD,CACA,IAAM,aAAe,QAAQ,YACzB,IAAsB,GACtB,YAAkC,KAClC,MAAQ,GACR,eAAiB,GAGrB,GAAI,aAAc,CAChB,IAAM,SAAW,OAAO,aAAc,OAAO,EACzC,WACF,IAAM,SAAS,MACf,eAAiB,SAAS,MAC1B,YAAc,MAAM,MAAM,IAAI,GAAG,EAErC,EAGI,CAAC,KAAO,CAAC,eACX,IAAM,WAAW,EACjB,YAAc,CAAC,EACf,MAAQ,IAGV,IAAI,WAAa,IACb,YAAc,CAAE,GAAG,WAAY,EAC/B,UAAY,GAEV,WAAsB,CAC1B,IAAI,IAAK,CACP,OAAO,UACT,EACA,KAAM,YAEN,MAAM,YAAa,CACjB,MAAM,MAAM,QAAQ,UAAU,EAC9B,WAAa,WAAW,EACxB,YAAc,CAAC,EACf,WAAW,KAAO,YAClB,MAAM,MAAM,IAAI,WAAY,YAAa,MAAM,EAC/C,UAAU,IAAK,WAAY,KAAK,WAAY,MAAM,EAAG,cAAc,CACrE,EAEA,MAAM,SAAU,CACd,MAAM,MAAM,QAAQ,UAAU,EAC9B,UAAY,GACZ,YAAc,CAAC,EACf,WAAW,KAAO,YAGlB,UAAU,IAAK,WAAY,GAAI,CAAE,GAAG,eAAgB,OAAQ,EAAG,wBAAS,IAAI,KAAK,CAAC,CAAE,CAAC,CACvF,EAEA,MAAM,MAAO,CACN,WACH,MAAM,MAAM,IAAI,WAAY,YAAa,MAAM,CAEnD,CACF,EAEC,IAAa,QAAU,WAGpB,OACF,UAAU,IAAK,WAAY,KAAK,WAAY,MAAM,EAAG,cAAc,EAIrE,IAAI,UACE,YACH,aAAe,SAAY,CACtB,YACA,QAAU,mBAAqB,OAAO,KAAK,WAAW,CAAC,CAAC,SAAW,KACvE,MAAM,MAAM,IAAI,WAAY,YAAa,MAAM,EAC3C,SAAW,CAAC,OAAS,MAAM,OAAO,MAAM,MAAM,MAAM,WAAY,MAAM,EAC5E,EAAA,CAAG,EAOL,GAAI,EAAE,eAAe,mBAAoB,CACvC,IAAM,IAAM,IAAI,IACf,IAA6D,IAAM,SAElE,GAAG,KACH,CACA,IAAI,KAAO,GACL,SAAa,CACb,OACJ,KAAO,GACP,aAAa,KAAK,EAClB,IAAI,MAAM,KAAM,IAAI,EACtB,EACM,MAAQ,eAAiB,CAC7B,SAAS,MAAM,0BAA0B,YAAY,gCAAgC,EACrF,KAAK,CACP,EAAG,WAAW,EAKd,OAJA,QAAQ,CAAC,CAAC,KAAK,KAAO,KAAiB,CACrC,SAAS,MAAM,IAAK,kDAAkD,EACtE,KAAK,CACP,CAAC,EACM,IACT,CACF,CACA,IAAI,GAAG,aAAgB,CAErB,QAAQ,CAAC,CAAC,MAAO,KAAiB,CAC5B,eAAe,mBACjB,SAAS,MAAM,IAAK,iDAAiD,CACzE,CAAC,CACH,CAAC,EAIG,CAAC,QAAU,SAAW,iBACxB,UAAU,IAAK,WAAY,KAAK,WAAY,MAAM,EAAG,cAAc,EAGrE,KAAK,CACP,CACF,CAIA,MAAM,UAAY,aAAa,SAAS,EAiBxC,SAAS,OAAO,QAAmB,WAAoB,CACrD,IAAM,KAAO,QAAQ,IAAK,QACxB,OAAO,KAAK,SAAS,SAAU,OAAQ,eAAgB,kBAAmB,EAAE,CAAC,CAC/E,EACM,IAAM,KAAK,GACX,IAAM,OAAO,KAAK,UAAU,EAClC,MAAO,CACL,KAAK,QAAgC,CACnC,IAAM,GAAK,YAAY,EAAE,EACnB,OAAS,eAAe,cAAe,IAAK,EAAE,CAAC,CAAC,OAAO,GAAG,EAC1D,KAAO,OAAO,OAAO,CAAC,OAAO,OAAO,KAAK,UAAU,OAAO,EAAG,MAAM,EAAG,OAAO,MAAM,CAAC,CAAC,EAC3F,MAAO,MAAM,OAAO,OAAO,CAAC,GAAI,OAAO,WAAW,EAAG,IAAI,CAAC,CAAC,CAAC,SAAS,WAAW,GAClF,EAKA,KAAK,MAAkE,CACrE,GAAI,CAAC,MAAM,WAAW,KAAK,EAAG,OAAO,KACrC,IAAI,IACJ,GAAI,CACF,IAAM,OAAO,KAAK,MAAM,MAAM,CAAC,EAAG,WAAW,CAC/C,MAAQ,CACN,OAAO,IACT,CACA,GAAI,IAAI,OAAS,GAAI,OAAO,KAC5B,IAAK,GAAM,CAAC,MAAO,KAAM,KAAK,QAAQ,EACpC,GAAI,CACF,IAAM,SAAW,iBAAiB,cAAe,EAAG,IAAI,SAAS,EAAG,EAAE,CAAC,CAAC,CACrE,OAAO,GAAG,CAAC,CACX,WAAW,IAAI,SAAS,GAAI,EAAE,CAAC,EAC5B,KAAO,OAAO,OAAO,CAAC,SAAS,OAAO,IAAI,SAAS,EAAE,CAAC,EAAG,SAAS,MAAM,CAAC,CAAC,EAC1E,QAAU,KAAK,MAAM,KAAK,SAAS,MAAM,CAAC,EAGhD,OAFI,OAAO,SAAS,GAAM,UAAY,OAAO,QAAQ,GAAM,UACvD,CAAC,QAAQ,GAAK,OAAO,QAAQ,GAAM,SAAiB,KACjD,QAAQ,EAAI,KAAK,IAAI,EAAI,CAAE,QAAS,MAAO,MAAQ,CAAE,EAAI,IAClE,MAAQ,CAER,CAEF,OAAO,IACT,CACF,CACF,CAUA,SAAS,cAAc,QAAyB,CAC9C,GAAM,CACJ,WAAa,WACb,OAAS,MACT,QAAU,GACV,kBAAoB,GACpB,OAAQ,WAAa,CAAC,GACpB,QACE,CAAE,KAAM,MAAS,OAAO,WAAW,QAAQ,MAAM,EAAG,UAAU,EAC9D,eAAiB,CACrB,SAAU,WAAW,UAAY,GACjC,OAAQ,WAAW,QAAU,aAAa,EAC1C,SAAU,WAAW,UAAa,MAClC,KAAM,WAAW,MAAQ,IACzB,GAAI,WAAW,OAAS,CAAE,OAAQ,WAAW,MAAO,EAAI,CAAC,CAC3D,EACI,WAAa,GAEjB,OAAQ,IAAc,IAAe,OAAuB,CAC1D,IAAI,QAAW,IAAY,QAC3B,GAAI,CAAC,QAAS,CACZ,IAAM,OAAS,IAAI,QAAQ,OAC3B,QAAU,OAAS,kBAAkB,MAAM,EAAI,CAAC,CAClD,CACA,IAAM,OAAS,QAAQ,YAAc,KAAK,QAAQ,WAAW,EAAI,KAC3D,SAAW,QAAQ,SAAW,KAC9B,MAAQ,CAAC,SAEX,GAAK,UAAU,GAAK,WAAW,EAC/B,UAAY,GAIZ,QAAU,UAAY,CAAC,QAAQ,MAAQ,KAAK,UAAU,SAAS,CAAC,EAAI,IAAA,GAElE,OAAS,MAAQ,KAAU,CAC/B,GAAI,IAAI,YAAa,OACrB,GAAI,UAAW,CACb,cAAc,IAAK,WAAY,GAAI,CAAE,GAAG,eAAgB,OAAQ,EAAG,wBAAS,IAAI,KAAK,CAAC,CAAE,CAAC,EACzF,MACF,CACA,IAAM,KAAO,KAAK,UAAU,WAAW,IAAI,EAI3C,GAFI,OAAS,SAAW,CAAC,QAAW,UAAY,QAE5C,UAAY,IAAA,IAAa,OAAS,MAAQ,CAAC,mBAAqB,CAAC,MAAO,OAC5E,IAAM,MAAQ,KAAK,CAAE,EAAG,GAAI,EAAG,WAAW,KAAM,EAAG,KAAK,IAAI,EAAI,MAAO,CAAC,EACpE,MAAM,OAAS,WAAW,OAAS,KAAgB,CAAC,aACtD,WAAa,GACb,UAAU,KACR,qBAAqB,MAAM,OAAO,oHAEpC,GAEF,cAAc,IAAK,WAAY,MAAO,CAAE,GAAG,eAAgB,MAAO,CAAC,EACnE,QAAU,IACZ,EAKA,IAAK,IAAM,SAAU,CAAC,YAAa,eAAgB,QAAS,KAAK,EAAY,CAC3E,IAAM,SAAY,IAA4D,QAC1E,OAAO,UAAa,aACvB,IAAiD,QAAU,SAE1D,GAAG,KACH,CAEA,OADA,MAAM,EACC,SAAS,MAAM,KAAM,IAAI,CAClC,EACF,CAKC,IAAwE,KAAK,aAC5E,MAAM,CACR,EAEA,IAAM,WAAsB,CAC1B,IAAI,IAAK,CACP,OAAO,EACT,EACA,KAAM,SAAW,CAAE,GAAG,SAAS,CAAE,EAAI,CAAC,EACtC,MAAM,YAAa,CACjB,GAAK,WAAW,EAChB,WAAW,KAAO,CAAC,EACnB,QAAU,IAAA,GACV,MAAM,EAAI,CACZ,EACA,MAAM,SAAU,CACd,UAAY,GACZ,WAAW,KAAO,CAAC,EACnB,MAAM,CACR,EACA,MAAM,MAAO,CACX,MAAM,CACR,CACF,EACC,IAAa,QAAU,WACxB,KAAK,CACP,CACF"}
|
|
1
|
+
{"version":3,"file":"session.mjs","names":[],"sources":["../../../src/http/middleware/session.ts"],"sourcesContent":["import { parseCookieHeader, replaceCookie, setCookie } from './respond'\nimport {\n createCipheriv,\n createDecipheriv,\n createHmac,\n hkdfSync,\n randomBytes,\n randomUUID,\n timingSafeEqual,\n} from 'node:crypto'\nimport { createLogger } from '../../core/logger'\nimport { WebResponseDriver } from '../web/driver'\nimport type {\n ConnectRequest as Request,\n ConnectResponse as Response,\n ConnectNext as NextFunction,\n} from '../connect'\n\nimport { registerDisposable } from '../../core/disposables'\nimport { isProduction } from '../../core/is-production'\n\n/**\n * What a session holds. Augment it to type your keys — undeclared keys stay\n * readable as `unknown`:\n *\n * ```ts\n * declare module '@forinda/kickjs' {\n * interface SessionData { userId?: string; cart?: string[] }\n * }\n * ```\n */\nexport interface SessionData {\n [key: string]: unknown\n}\n\nexport interface SessionStore {\n get(sid: string): Promise<SessionData | null>\n set(sid: string, data: SessionData, maxAge: number): Promise<void>\n destroy(sid: string): Promise<void>\n touch?(sid: string, maxAge: number): Promise<void>\n}\n\nexport interface Session {\n id: string\n data: SessionData\n regenerate(): Promise<void>\n destroy(): Promise<void>\n save(): Promise<void>\n}\n\nexport interface SessionOptions {\n /**\n * Secret that signs the session cookie — or, with `store: 'cookie'`,\n * encrypts it (required).\n *\n * Pass a list to rotate without logging everyone out: the first secret signs\n * new cookies, every secret is accepted, and a cookie made with an older one\n * is re-issued with the first. Drop the old secret once sessions have moved\n * over (after `maxAge`).\n *\n * ```ts\n * session({ secret: [process.env.SESSION_SECRET!, process.env.SESSION_SECRET_OLD!] })\n * ```\n */\n secret: string | string[]\n /** Cookie name (default: 'kick.sid') */\n cookieName?: string\n /** Session max age in milliseconds (default: 86400000 = 24h) */\n maxAge?: number\n /** Reset maxAge on every response (default: false) */\n rolling?: boolean\n /** Save new sessions that have not been modified (default: true) */\n saveUninitialized?: boolean\n /**\n * How long a response waits for the store to save the session before it\n * goes out anyway, in ms (default 5000). A stalled store would otherwise\n * hold every response; past this, the request after it may not see the save.\n */\n saveTimeout?: number\n /** Cookie options */\n cookie?: {\n httpOnly?: boolean\n secure?: boolean\n sameSite?: 'strict' | 'lax' | 'none'\n path?: string\n domain?: string\n }\n /**\n * Where session data lives. Default: in memory, in this process.\n *\n * `'cookie'` keeps it in the session cookie itself, encrypted with\n * AES-256-GCM under a key derived from `secret`: every instance reads the\n * same session with nothing shared between them — serverless functions,\n * several containers. The data has to fit a cookie (about 4 KB).\n *\n * Or pass a store shared between instances (`KvSessionStore`, Redis).\n */\n store?: SessionStore | 'cookie'\n}\n\n// ── In-Memory Store ───────────────────────────────────────────────────\n\n// ponytail: fixed cap for the single-instance default; a shared store\n// (KvSessionStore, Redis) is the answer for more.\nconst MAX_SESSIONS = 10_000\n\n/** @internal Exported for tests. */\nexport class MemoryStore implements SessionStore {\n private readonly sessions = new Map<string, { data: SessionData; expires: number }>()\n /** Sessions with no data, oldest first: evicted before any that hold some. */\n private readonly empty = new Set<string>()\n private readonly cleanupInterval: ReturnType<typeof setInterval>\n\n constructor() {\n // Purge expired sessions every 60 seconds\n this.cleanupInterval = setInterval(() => this.purge(), 60_000)\n this.cleanupInterval.unref()\n // Symmetric teardown: Application.shutdown() drains the disposables\n // registry — without this, every in-process app re-create (tests, HMR)\n // leaked one live interval + its session Map.\n registerDisposable(() => this.dispose())\n }\n\n /** Clear the cleanup interval and drop all sessions. */\n dispose(): void {\n clearInterval(this.cleanupInterval)\n this.sessions.clear()\n this.empty.clear()\n }\n\n async get(sid: string): Promise<SessionData | null> {\n const entry = this.sessions.get(sid)\n if (!entry) return null\n if (Date.now() > entry.expires) {\n this.sessions.delete(sid)\n this.empty.delete(sid)\n return null\n }\n return entry.data\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n // Deleted first so the map stays in last-written order, oldest at the front.\n this.sessions.delete(sid)\n this.sessions.set(sid, { data, expires: Date.now() + maxAge })\n this.empty.delete(sid)\n if (Object.keys(data).length === 0) this.empty.add(sid)\n // A session is created for every visitor without a cookie, so a client\n // can make as many as it sends requests. Past the cap, an empty session\n // goes first — a flood of cookieless requests makes only empty ones, so\n // it can't push out sessions that hold a login; only when none is empty\n // does the least recently written go.\n while (this.sessions.size > MAX_SESSIONS) {\n const victim = this.empty.values().next().value ?? this.sessions.keys().next().value!\n this.sessions.delete(victim)\n this.empty.delete(victim)\n }\n }\n\n async destroy(sid: string): Promise<void> {\n this.sessions.delete(sid)\n this.empty.delete(sid)\n }\n\n async touch(sid: string, maxAge: number): Promise<void> {\n const entry = this.sessions.get(sid)\n if (entry) {\n entry.expires = Date.now() + maxAge\n this.sessions.delete(sid)\n this.sessions.set(sid, entry)\n }\n }\n\n private purge() {\n const now = Date.now()\n for (const [sid, entry] of this.sessions) {\n if (now > entry.expires) {\n this.sessions.delete(sid)\n this.empty.delete(sid)\n }\n }\n }\n}\n\n// ── Cookie Signing ────────────────────────────────────────────────────\n\n/** `secret` as a non-empty list, newest first. */\nfunction secretList(secret: string | string[]): string[] {\n const list = Array.isArray(secret) ? secret : [secret]\n if (list.length === 0 || list.some((s) => typeof s !== 'string' || s.length === 0)) {\n throw new Error('session(): `secret` must be a non-empty string or list of strings')\n }\n return list\n}\n\nfunction sign(value: string, secret: string): string {\n const signature = createHmac('sha256', secret).update(value).digest('base64url')\n return `s:${value}.${signature}`\n}\n\n/**\n * The signed value, and whether it was signed with an older secret than the\n * first (so the caller re-issues it); false when no secret verifies it.\n */\nfunction unsign(signed: string, secrets: string[]): { value: string; stale: boolean } | false {\n if (!signed.startsWith('s:')) return false\n const raw = signed.slice(2)\n const dotIndex = raw.lastIndexOf('.')\n if (dotIndex === -1) return false\n\n const value = raw.slice(0, dotIndex)\n const provided = Buffer.from(raw.slice(dotIndex + 1))\n\n for (const [index, secret] of secrets.entries()) {\n const expected = Buffer.from(createHmac('sha256', secret).update(value).digest('base64url'))\n if (provided.length === expected.length && timingSafeEqual(provided, expected)) {\n return { value, stale: index > 0 }\n }\n }\n return false\n}\n\n// ── Middleware Factory ────────────────────────────────────────────────\n\n/**\n * Session management middleware.\n *\n * Attaches a `req.session` object with `id`, `data`, `regenerate()`,\n * `destroy()`, and `save()` methods. Session IDs are signed with\n * HMAC-SHA256 to prevent cookie tampering.\n *\n * Reads the session cookie from `req.cookies` when an upstream cookie\n * parser is present; otherwise parses `req.headers.cookie` directly, so\n * no cookie parser is required upstream.\n *\n * @example\n * ```ts\n * import { session } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * middlewares: [\n * session({ secret: process.env.SESSION_SECRET! }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nconst storeLog = createLogger('Session')\n\nexport function session(options: SessionOptions) {\n if (options.store === 'cookie') return cookieSession(options)\n const {\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n saveTimeout = 5000,\n cookie: cookieOpts = {},\n } = options\n const secrets = secretList(options.secret)\n const secret = secrets[0]\n const store = (options.store as SessionStore | undefined) ?? new MemoryStore()\n\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? isProduction(),\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n maxAge,\n }\n\n return async (req: Request, res: Response, next: NextFunction) => {\n let cookies = (req as any).cookies as Record<string, string> | undefined\n if (!cookies) {\n const header = req.headers.cookie\n cookies = header ? parseCookieHeader(header) : {}\n }\n const signedCookie = cookies[cookieName]\n let sid: string | false = false\n let sessionData: SessionData | null = null\n let isNew = false\n let staleSignature = false\n\n // Attempt to recover existing session\n if (signedCookie) {\n const unsigned = unsign(signedCookie, secrets)\n if (unsigned) {\n sid = unsigned.value\n staleSignature = unsigned.stale\n sessionData = await store.get(sid)\n }\n }\n\n // Create new session if none found\n if (!sid || !sessionData) {\n sid = randomUUID()\n sessionData = {}\n isNew = true\n }\n\n let currentSid = sid\n let currentData = { ...sessionData }\n let destroyed = false\n\n const sessionObj: Session = {\n get id() {\n return currentSid\n },\n data: currentData,\n\n async regenerate() {\n await store.destroy(currentSid)\n currentSid = randomUUID()\n currentData = {}\n sessionObj.data = currentData\n await store.set(currentSid, currentData, maxAge)\n setCookie(res, cookieName, sign(currentSid, secret), cookieDefaults)\n },\n\n async destroy() {\n await store.destroy(currentSid)\n destroyed = true\n currentData = {}\n sessionObj.data = currentData\n // Expire the cookie the same way it was set — `res.clearCookie` is\n // Express-only and threw under Fastify and h3.\n setCookie(res, cookieName, '', { ...cookieDefaults, maxAge: 0, expires: new Date(0) })\n },\n\n async save() {\n if (!destroyed) {\n await store.set(currentSid, currentData, maxAge)\n }\n },\n }\n\n ;(req as any).session = sessionObj\n\n // Set cookie for new sessions\n if (isNew) {\n setCookie(res, cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n // Saved once, at the end of the request.\n let persisted: Promise<void> | undefined\n const persist = () =>\n (persisted ??= (async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n await store.set(currentSid, currentData, maxAge)\n if (rolling && !isNew && store.touch) await store.touch(currentSid, maxAge)\n })())\n\n /**\n * The save, waited for at most `saveTimeout` ms: a stalled store mustn't hold\n * the response forever. Never rejects — a failure is logged.\n */\n const saved = (): Promise<void> =>\n new Promise((done) => {\n const timer = setTimeout(() => {\n storeLog.error(`Session save took over ${saveTimeout}ms; sending the response anyway`)\n done()\n }, saveTimeout)\n persist().then(\n () => {\n clearTimeout(timer)\n done()\n },\n (err: unknown) => {\n clearTimeout(timer)\n storeLog.error(err, 'Session save failed; sending the response anyway')\n done()\n },\n )\n })\n\n // Before the response goes out, not after: the redirect after a form post\n // comes straight back and must see what this request wrote. The response\n // ends once the store has it (a Redis write, say), as express-session does.\n // The fetch drivers build their Response in end(); h3 through fetch waits\n // for the promise the `finish` listener below returns instead.\n if (!(res instanceof WebResponseDriver)) {\n const end = res.end as (...args: unknown[]) => unknown\n ;(res as unknown as { end: (...args: unknown[]) => unknown }).end = function (\n this: unknown,\n ...args: unknown[]\n ) {\n void saved().then(() => end.apply(this, args))\n return this\n }\n }\n // The fetch drivers: h3 through fetch waits for this promise before handing\n // back the response. (A Node response saved in end(), above.)\n else res.on('finish', () => saved())\n\n // Rolling refreshes the cookie on every response; a cookie signed with an\n // older secret is re-signed with the current one.\n if (!isNew && (rolling || staleSignature)) {\n setCookie(res, cookieName, sign(currentSid, secret), cookieDefaults)\n }\n\n next()\n }\n}\n\n// ── Cookie store ──────────────────────────────────────────────────────\n\nconst cookieLog = createLogger('Session')\n\n/** Browsers drop a cookie larger than 4096 bytes, name and attributes included. */\nconst COOKIE_LIMIT = 4000\n\ninterface CookiePayload {\n /** Session id. */\n i: string\n d: SessionData\n /** Expiry, ms since epoch. */\n e: number\n}\n\n/**\n * AES-256-GCM, with the cookie name as associated data: `v1.<iv|tag|ciphertext>`.\n * Seals with the first secret's key; opens with any of them.\n */\nfunction sealer(secrets: string[], cookieName: string) {\n const keys = secrets.map((secret) =>\n Buffer.from(hkdfSync('sha256', secret, 'kick.session', 'cookie-store-v1', 32)),\n )\n const key = keys[0]\n const aad = Buffer.from(cookieName)\n return {\n seal(payload: CookiePayload): string {\n const iv = randomBytes(12)\n const cipher = createCipheriv('aes-256-gcm', key, iv).setAAD(aad)\n const body = Buffer.concat([cipher.update(JSON.stringify(payload), 'utf8'), cipher.final()])\n return `v1.${Buffer.concat([iv, cipher.getAuthTag(), body]).toString('base64url')}`\n },\n /**\n * The payload and whether an older secret's key opened it, or null for\n * anything forged, altered, expired or malformed.\n */\n open(value: string): { payload: CookiePayload; stale: boolean } | null {\n if (!value.startsWith('v1.')) return null\n let raw: Buffer\n try {\n raw = Buffer.from(value.slice(3), 'base64url')\n } catch {\n return null\n }\n if (raw.length < 29) return null\n for (const [index, k] of keys.entries()) {\n try {\n const decipher = createDecipheriv('aes-256-gcm', k, raw.subarray(0, 12))\n .setAAD(aad)\n .setAuthTag(raw.subarray(12, 28))\n const json = Buffer.concat([decipher.update(raw.subarray(28)), decipher.final()])\n const payload = JSON.parse(json.toString('utf8')) as CookiePayload\n if (typeof payload?.i !== 'string' || typeof payload.e !== 'number') return null\n if (!payload.d || typeof payload.d !== 'object') return null\n return payload.e > Date.now() ? { payload, stale: index > 0 } : null\n } catch {\n // Not this key (the auth tag fails) — try the next.\n }\n }\n return null\n },\n }\n}\n\ntype HeaderWriter = (...args: unknown[]) => unknown\n\n/**\n * `session({ store: 'cookie' })`. The cookie is written as late as possible —\n * just before the response's headers go out — so every change made while\n * handling the request is in it, nested ones included. `save()` writes it\n * straight away, for code that redirects right after.\n */\nfunction cookieSession(options: SessionOptions) {\n const {\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n cookie: cookieOpts = {},\n } = options\n const { seal, open } = sealer(secretList(options.secret), cookieName)\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? isProduction(),\n sameSite: cookieOpts.sameSite ?? ('lax' as const),\n path: cookieOpts.path ?? '/',\n ...(cookieOpts.domain ? { domain: cookieOpts.domain } : {}),\n }\n let warnedSize = false\n\n return (req: Request, res: Response, next: NextFunction) => {\n let cookies = (req as any).cookies as Record<string, string> | undefined\n if (!cookies) {\n const header = req.headers.cookie\n cookies = header ? parseCookieHeader(header) : {}\n }\n const opened = cookies[cookieName] ? open(cookies[cookieName]) : null\n const existing = opened?.payload ?? null\n const isNew = !existing\n\n let id = existing?.i ?? randomUUID()\n let destroyed = false\n // What the browser already holds, to skip rewriting an unchanged cookie.\n // A cookie sealed with an older secret counts as nothing held, so it is\n // rewritten with the current one.\n let written = existing && !opened?.stale ? JSON.stringify(existing.d) : undefined\n\n const write = (force = false) => {\n if (res.headersSent) return\n if (destroyed) {\n replaceCookie(res, cookieName, '', { ...cookieDefaults, maxAge: 0, expires: new Date(0) })\n return\n }\n const json = JSON.stringify(sessionObj.data)\n // Unchanged: leave the browser's copy, unless `rolling` renews it.\n if (json === written && !force && !(rolling && !isNew)) return\n // A new, empty session gets a cookie only with saveUninitialized.\n if (written === undefined && json === '{}' && !saveUninitialized && !force) return\n const value = seal({ i: id, d: sessionObj.data, e: Date.now() + maxAge })\n if (value.length + cookieName.length > COOKIE_LIMIT && !warnedSize) {\n warnedSize = true\n cookieLog.warn(\n `session cookie is ${value.length} bytes; browsers drop cookies over 4 KB, ` +\n 'so this session will not be kept. Store less in it, or use a shared store.',\n )\n }\n replaceCookie(res, cookieName, value, { ...cookieDefaults, maxAge })\n written = json\n }\n\n // Just before the headers go out, on whichever call sends them first —\n // Node responses go through writeHead; the web driver's buffered end()\n // does not.\n for (const method of ['writeHead', 'flushHeaders', 'write', 'end'] as const) {\n const original = (res as unknown as Record<string, HeaderWriter | undefined>)[method]\n if (typeof original !== 'function') continue\n ;(res as unknown as Record<string, HeaderWriter>)[method] = function (\n this: unknown,\n ...args: unknown[]\n ) {\n write()\n return original.apply(this, args)\n }\n }\n\n // h3 called through fetch hands middleware a stand-in response whose\n // headers join the route's response after `finish` — the last chance there.\n // On a Node response `finish` comes after the headers, so this is a no-op.\n ;(res as unknown as { on?: (event: string, fn: () => void) => unknown }).on?.('finish', () =>\n write(),\n )\n\n const sessionObj: Session = {\n get id() {\n return id\n },\n data: existing ? { ...existing.d } : {},\n async regenerate() {\n id = randomUUID()\n sessionObj.data = {}\n written = undefined\n write(true)\n },\n async destroy() {\n destroyed = true\n sessionObj.data = {}\n write()\n },\n async save() {\n write()\n },\n }\n ;(req as any).session = sessionObj\n next()\n }\n}\n"],"mappings":"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"}
|