@forinda/kickjs 10.1.0 → 10.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (214) hide show
  1. package/dist/adapter-BYdxuKiM.d.mts +4916 -0
  2. package/dist/adapter-BYdxuKiM.d.mts.map +1 -0
  3. package/dist/allowed-hosts-D6qcuK5I.d.mts +46 -0
  4. package/dist/allowed-hosts-D6qcuK5I.d.mts.map +1 -0
  5. package/dist/{app-module-DCA65GZZ.d.mts → app-module-Ftz6m7SO.d.mts} +8 -2
  6. package/dist/app-module-Ftz6m7SO.d.mts.map +1 -0
  7. package/dist/application-B2e5XYHm.mjs +14 -0
  8. package/dist/application-B2e5XYHm.mjs.map +1 -0
  9. package/dist/bootstrap-BmALF-1Y.mjs +12 -0
  10. package/dist/{bootstrap-BdyBlBMe.mjs.map → bootstrap-BmALF-1Y.mjs.map} +1 -1
  11. package/dist/bounded-counters-aA3iI_Ei.mjs +12 -0
  12. package/dist/bounded-counters-aA3iI_Ei.mjs.map +1 -0
  13. package/dist/breach-padding-C-Dnq8CS.d.mts +39 -0
  14. package/dist/breach-padding-C-Dnq8CS.d.mts.map +1 -0
  15. package/dist/{client-ip-BbLDp03S.mjs → client-ip-D2dsx8RG.mjs} +2 -2
  16. package/dist/{client-ip-BbLDp03S.mjs.map → client-ip-D2dsx8RG.mjs.map} +1 -1
  17. package/dist/config/index.d.mts +1 -1
  18. package/dist/config/index.mjs +2 -2
  19. package/dist/config-B77LTW_E.mjs +12 -0
  20. package/dist/{config-CJiGeOca.mjs.map → config-B77LTW_E.mjs.map} +1 -1
  21. package/dist/{container-CS9v9UFU.mjs → container-mvaAYThX.mjs} +3 -3
  22. package/dist/{container-CS9v9UFU.mjs.map → container-mvaAYThX.mjs.map} +1 -1
  23. package/dist/context-GbQnJB-L.mjs +12 -0
  24. package/dist/context-GbQnJB-L.mjs.map +1 -0
  25. package/dist/{context-errors-7C5TBYn7.mjs → context-errors-CPqYYhl0.mjs} +2 -2
  26. package/dist/{context-errors-7C5TBYn7.mjs.map → context-errors-CPqYYhl0.mjs.map} +1 -1
  27. package/dist/{contributor-runner-DBpRR5dl.mjs → contributor-runner-Cl5yZZy1.mjs} +3 -3
  28. package/dist/{contributor-runner-DBpRR5dl.mjs.map → contributor-runner-Cl5yZZy1.mjs.map} +1 -1
  29. package/dist/core/adapter.d.mts +1 -1
  30. package/dist/core/adapter.mjs +1 -1
  31. package/dist/core/app-module.d.mts +1 -1
  32. package/dist/core/app-module.mjs +1 -1
  33. package/dist/core/cache.mjs +1 -1
  34. package/dist/core/container.mjs +2 -2
  35. package/dist/core/cron.mjs +2 -2
  36. package/dist/core/decorators.d.mts +1 -1
  37. package/dist/core/decorators.mjs +2 -2
  38. package/dist/core/errors.mjs +2 -2
  39. package/dist/core/errors.mjs.map +1 -1
  40. package/dist/core/interfaces.mjs +1 -1
  41. package/dist/core/logger.mjs +1 -1
  42. package/dist/core/path.mjs +1 -1
  43. package/dist/core/plugin.d.mts +1 -1
  44. package/dist/core/plugin.mjs +1 -1
  45. package/dist/core/reactivity.mjs +1 -1
  46. package/dist/core-D1AV-Tvd.mjs +12 -0
  47. package/dist/{core-B0JmdBvX.mjs.map → core-D1AV-Tvd.mjs.map} +1 -1
  48. package/dist/{cors-CsibNTQ6.d.mts → cors-2Bwhyhpt.d.mts} +4 -1
  49. package/dist/{cors-CsibNTQ6.d.mts.map → cors-2Bwhyhpt.d.mts.map} +1 -1
  50. package/dist/{csrf-C73UkRgc.d.mts → csrf-Cy1meSpf.d.mts} +27 -3
  51. package/dist/csrf-Cy1meSpf.d.mts.map +1 -0
  52. package/dist/csrf-D3prC4FK.mjs +12 -0
  53. package/dist/csrf-D3prC4FK.mjs.map +1 -0
  54. package/dist/decorate-BiXL-9e9.mjs +13 -0
  55. package/dist/decorate-BiXL-9e9.mjs.map +1 -0
  56. package/dist/{decorators-BxNSz9Qt.d.mts → decorators-DaQUNXOn.d.mts} +2 -2
  57. package/dist/{decorators-BxNSz9Qt.d.mts.map → decorators-DaQUNXOn.d.mts.map} +1 -1
  58. package/dist/{define-adapter-BLKlUbSL.mjs → define-adapter-D22SDe0U.mjs} +2 -2
  59. package/dist/{define-adapter-BLKlUbSL.mjs.map → define-adapter-D22SDe0U.mjs.map} +1 -1
  60. package/dist/{disposables-CuY2S3bw.mjs → disposables-CJD_gWlA.mjs} +2 -2
  61. package/dist/{disposables-CuY2S3bw.mjs.map → disposables-CJD_gWlA.mjs.map} +1 -1
  62. package/dist/errors-By6UueCm.d.mts.map +1 -1
  63. package/dist/handler-gW_h2miq.mjs +12 -0
  64. package/dist/handler-gW_h2miq.mjs.map +1 -0
  65. package/dist/{helmet-C2QEU6S-.d.mts → helmet-CEOmo516.d.mts} +4 -1
  66. package/dist/helmet-CEOmo516.d.mts.map +1 -0
  67. package/dist/host-D__uZPyz.mjs +12 -0
  68. package/dist/host-D__uZPyz.mjs.map +1 -0
  69. package/dist/http/application.d.mts +2 -2
  70. package/dist/http/application.mjs +2 -2
  71. package/dist/http/bootstrap.d.mts +1 -1
  72. package/dist/http/bootstrap.mjs +2 -2
  73. package/dist/http/context.d.mts +2 -2
  74. package/dist/http/context.mjs +2 -2
  75. package/dist/http/middleware/allowed-hosts.d.mts +3 -0
  76. package/dist/http/middleware/allowed-hosts.mjs +12 -0
  77. package/dist/http/middleware/allowed-hosts.mjs.map +1 -0
  78. package/dist/http/middleware/breach-padding.d.mts +3 -0
  79. package/dist/http/middleware/breach-padding.mjs +12 -0
  80. package/dist/http/middleware/breach-padding.mjs.map +1 -0
  81. package/dist/http/middleware/cors.d.mts +1 -1
  82. package/dist/http/middleware/cors.mjs +2 -2
  83. package/dist/http/middleware/cors.mjs.map +1 -1
  84. package/dist/http/middleware/csrf.d.mts +2 -2
  85. package/dist/http/middleware/csrf.mjs +2 -2
  86. package/dist/http/middleware/error-handler.d.mts +1 -1
  87. package/dist/http/middleware/error-handler.mjs +2 -2
  88. package/dist/http/middleware/error-handler.mjs.map +1 -1
  89. package/dist/http/middleware/helmet.d.mts +1 -1
  90. package/dist/http/middleware/helmet.mjs +2 -2
  91. package/dist/http/middleware/helmet.mjs.map +1 -1
  92. package/dist/http/middleware/rate-limit.d.mts +2 -2
  93. package/dist/http/middleware/rate-limit.mjs +2 -2
  94. package/dist/http/middleware/rate-limit.mjs.map +1 -1
  95. package/dist/http/middleware/request-id.mjs +2 -2
  96. package/dist/http/middleware/request-id.mjs.map +1 -1
  97. package/dist/http/middleware/request-logger.mjs +2 -2
  98. package/dist/http/middleware/session.d.mts +2 -2
  99. package/dist/http/middleware/session.mjs +2 -2
  100. package/dist/http/middleware/session.mjs.map +1 -1
  101. package/dist/http/middleware/spa.d.mts +1 -1
  102. package/dist/http/middleware/spa.mjs +2 -2
  103. package/dist/http/middleware/upload.d.mts +1 -1
  104. package/dist/http/middleware/upload.mjs +2 -3
  105. package/dist/http/middleware/upload.mjs.map +1 -1
  106. package/dist/http/middleware/validate.d.mts +2 -2
  107. package/dist/http/middleware/validate.mjs +2 -2
  108. package/dist/http/middleware/validate.mjs.map +1 -1
  109. package/dist/http/middleware/views.d.mts +2 -2
  110. package/dist/http/middleware/views.mjs +2 -2
  111. package/dist/http/middleware/views.mjs.map +1 -1
  112. package/dist/http/query/index.mjs +2 -2
  113. package/dist/http/router-builder.d.mts +1 -1
  114. package/dist/http/router-builder.mjs +2 -2
  115. package/dist/http/runtimes/fastify.d.mts +5 -1
  116. package/dist/http/runtimes/fastify.d.mts.map +1 -1
  117. package/dist/http/runtimes/fastify.mjs +3 -3
  118. package/dist/http/runtimes/fastify.mjs.map +1 -1
  119. package/dist/http/runtimes/h3-web.mjs +1 -1
  120. package/dist/http/runtimes/h3.d.mts +5 -4
  121. package/dist/http/runtimes/h3.d.mts.map +1 -1
  122. package/dist/http/runtimes/h3.mjs +2 -2
  123. package/dist/http/runtimes/h3.mjs.map +1 -1
  124. package/dist/{index-CNHSbZTE.d.mts → index-CuiWSnZL.d.mts} +3 -2
  125. package/dist/index-CuiWSnZL.d.mts.map +1 -0
  126. package/dist/index.d.mts +16 -18
  127. package/dist/index.mjs +6 -2
  128. package/dist/index.mjs.map +1 -1
  129. package/dist/is-production-Dbm13WNL.mjs +12 -0
  130. package/dist/is-production-Dbm13WNL.mjs.map +1 -0
  131. package/dist/{jobs-BQ4t3TAb.mjs → jobs-s4__kZLr.mjs} +3 -3
  132. package/dist/{jobs-BQ4t3TAb.mjs.map → jobs-s4__kZLr.mjs.map} +1 -1
  133. package/dist/kv-stores-Cjel_Dkc.mjs +12 -0
  134. package/dist/kv-stores-Cjel_Dkc.mjs.map +1 -0
  135. package/dist/lazy-serve-static-w94Xs3wQ.mjs +12 -0
  136. package/dist/lazy-serve-static-w94Xs3wQ.mjs.map +1 -0
  137. package/dist/{metadata-zvd6AWkE.mjs → metadata-C2GK_17k.mjs} +2 -2
  138. package/dist/{metadata-zvd6AWkE.mjs.map → metadata-C2GK_17k.mjs.map} +1 -1
  139. package/dist/{observers-DZgs48UM.mjs → observers-boPE9XGi.mjs} +2 -2
  140. package/dist/{observers-DZgs48UM.mjs.map → observers-boPE9XGi.mjs.map} +1 -1
  141. package/dist/{query-B_k9qn0R.mjs → query-DjTeF1d4.mjs} +2 -2
  142. package/dist/{query-B_k9qn0R.mjs.map → query-DjTeF1d4.mjs.map} +1 -1
  143. package/dist/{rate-limit-Bwed3jOV.d.mts → rate-limit-BgoeahE5.d.mts} +17 -2
  144. package/dist/rate-limit-BgoeahE5.d.mts.map +1 -0
  145. package/dist/reply-CYY_CzRf.mjs +12 -0
  146. package/dist/reply-CYY_CzRf.mjs.map +1 -0
  147. package/dist/respond-Dc18G0X7.mjs +12 -0
  148. package/dist/respond-Dc18G0X7.mjs.map +1 -0
  149. package/dist/{route-flag-BWuvJsGZ.mjs → route-flag-BOQZs2Wn.mjs} +3 -3
  150. package/dist/{route-flag-BWuvJsGZ.mjs.map → route-flag-BOQZs2Wn.mjs.map} +1 -1
  151. package/dist/{route-policy-B3vM6bSf.mjs → route-policy-B8c6QfiU.mjs} +2 -2
  152. package/dist/{route-policy-B3vM6bSf.mjs.map → route-policy-B8c6QfiU.mjs.map} +1 -1
  153. package/dist/{router-builder-JvMTp50k.mjs → router-builder-DoWOIGmG.mjs} +3 -3
  154. package/dist/router-builder-DoWOIGmG.mjs.map +1 -0
  155. package/dist/{session-B4hOZj90.d.mts → session-ChXx7jG5.d.mts} +31 -4
  156. package/dist/session-ChXx7jG5.d.mts.map +1 -0
  157. package/dist/settings-C8VKewNS.d.mts +119 -0
  158. package/dist/settings-C8VKewNS.d.mts.map +1 -0
  159. package/dist/settings-DcytOCC6.mjs +14 -0
  160. package/dist/settings-DcytOCC6.mjs.map +1 -0
  161. package/dist/{upload-config-Dz2INCaa.mjs → upload-config-CzxbJALL.mjs} +2 -2
  162. package/dist/{upload-config-Dz2INCaa.mjs.map → upload-config-CzxbJALL.mjs.map} +1 -1
  163. package/dist/url-for-DGSrVfdD.mjs +12 -0
  164. package/dist/url-for-DGSrVfdD.mjs.map +1 -0
  165. package/dist/validate-CzjCbRUn.d.mts +53 -0
  166. package/dist/validate-CzjCbRUn.d.mts.map +1 -0
  167. package/dist/web.d.mts +19 -19
  168. package/dist/web.d.mts.map +1 -1
  169. package/dist/web.mjs +2 -2
  170. package/dist/web.mjs.map +1 -1
  171. package/package.json +18 -1
  172. package/dist/adapter-ClEh-Oos.d.mts +0 -2134
  173. package/dist/adapter-ClEh-Oos.d.mts.map +0 -1
  174. package/dist/app-module-DCA65GZZ.d.mts.map +0 -1
  175. package/dist/application-Dv514EeR.mjs +0 -12
  176. package/dist/application-Dv514EeR.mjs.map +0 -1
  177. package/dist/application-oIPzgjfk.d.mts +0 -1589
  178. package/dist/application-oIPzgjfk.d.mts.map +0 -1
  179. package/dist/bootstrap-BdyBlBMe.mjs +0 -12
  180. package/dist/config-CJiGeOca.mjs +0 -12
  181. package/dist/context-CtL9RxXp.mjs +0 -12
  182. package/dist/context-CtL9RxXp.mjs.map +0 -1
  183. package/dist/core-B0JmdBvX.mjs +0 -12
  184. package/dist/csrf--1t4qDov.mjs +0 -12
  185. package/dist/csrf--1t4qDov.mjs.map +0 -1
  186. package/dist/csrf-C73UkRgc.d.mts.map +0 -1
  187. package/dist/decorate-BHkdkV4l.mjs +0 -11
  188. package/dist/env-BwzF9MkZ.mjs +0 -13
  189. package/dist/env-BwzF9MkZ.mjs.map +0 -1
  190. package/dist/error-handler-BB9wAElm.d.mts +0 -63
  191. package/dist/error-handler-BB9wAElm.d.mts.map +0 -1
  192. package/dist/handler-zKfIgNo4.mjs +0 -13
  193. package/dist/handler-zKfIgNo4.mjs.map +0 -1
  194. package/dist/helmet-C2QEU6S-.d.mts.map +0 -1
  195. package/dist/index-CNHSbZTE.d.mts.map +0 -1
  196. package/dist/kv-stores-Co5k2PYA.d.mts +0 -367
  197. package/dist/kv-stores-Co5k2PYA.d.mts.map +0 -1
  198. package/dist/kv-stores-DsfVy2fk.mjs +0 -12
  199. package/dist/kv-stores-DsfVy2fk.mjs.map +0 -1
  200. package/dist/module-registry-Daf_P2oD.mjs +0 -12
  201. package/dist/module-registry-Daf_P2oD.mjs.map +0 -1
  202. package/dist/rate-limit-Bwed3jOV.d.mts.map +0 -1
  203. package/dist/reply-BDK9xt7Z.mjs +0 -12
  204. package/dist/reply-BDK9xt7Z.mjs.map +0 -1
  205. package/dist/respond-DFRj2-7q.mjs +0 -12
  206. package/dist/respond-DFRj2-7q.mjs.map +0 -1
  207. package/dist/router-builder-JvMTp50k.mjs.map +0 -1
  208. package/dist/router-builder-zWuVIOmd.d.mts +0 -56
  209. package/dist/router-builder-zWuVIOmd.d.mts.map +0 -1
  210. package/dist/session-B4hOZj90.d.mts.map +0 -1
  211. package/dist/upload-CiMtdXWD.d.mts +0 -104
  212. package/dist/upload-CiMtdXWD.d.mts.map +0 -1
  213. package/dist/validate-DMYpUnrf.d.mts +0 -25
  214. package/dist/validate-DMYpUnrf.d.mts.map +0 -1
@@ -0,0 +1,12 @@
1
+ /**
2
+ * @forinda/kickjs v10.3.0
3
+ *
4
+ * Copyright (c) Felix Orinda
5
+ *
6
+ * This source code is licensed under the MIT license found in the
7
+ * LICENSE file in the root directory of this source tree.
8
+ *
9
+ * @license MIT
10
+ */
11
+ function randomBelow(max){if(max<=1)return 0;let[value]=crypto.getRandomValues(/* @__PURE__ */ new Uint32Array(1));return value%max}function padGzipHeader(chunk,maxBytes){if(chunk.length<10||chunk[0]!==31||chunk[1]!==139||chunk[2]!==8||chunk[3]!==0)return chunk;let length=randomBelow(maxBytes),padded=new Uint8Array(chunk.length+length+1);return padded.set(chunk.subarray(0,10)),padded[3]=8,padded.fill(97,10,10+length),padded[10+length]=0,padded.set(chunk.subarray(10),10+length+1),padded}function breachPadding(options={}){let maxBytes=options.maxBytes??100;return(req,res,next)=>{let accept=req.headers[`accept-encoding`];typeof accept==`string`&&(req.headers[`accept-encoding`]=accept.split(`,`).filter(part=>!/^\s*(br|zstd)\s*(;|$)/i.test(part)).join(`,`));let write=res.write.bind(res),end=res.end.bind(res),pending=/* @__PURE__ */ new Uint8Array,isGzip=()=>/\bgzip\b/i.test(String(res.getHeader(`content-encoding`)??``)),take=chunk=>{if(pending===null)return null;if(!isGzip()||!(chunk instanceof Uint8Array))return pending=null,null;let joined=new Uint8Array(pending.length+chunk.length);return joined.set(pending),joined.set(chunk,pending.length),joined.length<10?(pending=joined,/* @__PURE__ */ new Uint8Array):(pending=null,padGzipHeader(joined,maxBytes))},held=()=>pending&&pending.length>0?pending:null;res.write=(chunk,...rest)=>{let before=held(),out=take(chunk);return out===null?(before&&write(Buffer.from(before)),write(chunk,...rest)):out.length>0?write(Buffer.from(out),...rest):!0},res.end=(chunk,...rest)=>{let before=held();if(chunk===void 0||typeof chunk==`function`)return pending=null,before&&write(Buffer.from(before)),end(chunk,...rest);let out=take(chunk);return pending=null,out===null?(before&&write(Buffer.from(before)),end(chunk,...rest)):end(Buffer.from(out),...rest)},next()}}export{breachPadding,padGzipHeader};
12
+ //# sourceMappingURL=breach-padding.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"breach-padding.mjs","names":[],"sources":["../../../src/http/middleware/breach-padding.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport interface BreachPaddingOptions {\n /**\n * Padding added to each compressed response is 0 to `maxBytes - 1` bytes,\n * drawn fresh every time. Default 100, as Django's `GZipMiddleware`.\n */\n maxBytes?: number\n}\n\nconst GZIP_HEADER = 10\nconst FNAME = 0x08\n\n/** A random `0 … max-1`, from Web Crypto. */\nfunction randomBelow(max: number): number {\n if (max <= 1) return 0\n const [value] = crypto.getRandomValues(new Uint32Array(1))\n return value % max\n}\n\n/**\n * Pad a complete gzip member's header with a random-length file name (the\n * gzip `FNAME` field, which decompressors ignore). Returns `chunk` unchanged\n * unless it starts with a plain gzip header — magic, deflate, no flags set —\n * so anything else (plaintext, another encoding, a header already carrying\n * fields) passes through untouched.\n */\nexport function padGzipHeader(chunk: Uint8Array, maxBytes: number): Uint8Array {\n if (\n chunk.length < GZIP_HEADER ||\n chunk[0] !== 0x1f ||\n chunk[1] !== 0x8b ||\n chunk[2] !== 0x08 ||\n chunk[3] !== 0\n ) {\n return chunk\n }\n const length = randomBelow(maxBytes)\n const padded = new Uint8Array(chunk.length + length + 1)\n padded.set(chunk.subarray(0, GZIP_HEADER))\n padded[3] = FNAME\n padded.fill(0x61, GZIP_HEADER, GZIP_HEADER + length) // 'a' × length\n padded[GZIP_HEADER + length] = 0 // name terminator\n padded.set(chunk.subarray(GZIP_HEADER), GZIP_HEADER + length + 1)\n return padded\n}\n\ntype Writer = (chunk?: unknown, ...rest: unknown[]) => unknown\n\n/**\n * BREACH mitigation for `compression()`: makes the size of every gzip response\n * vary by a random amount, so an attacker watching encrypted traffic cannot\n * learn a secret in the page from how well their guesses compress (Django's\n * \"Heal The Breach\"). Opt-in — it costs some compression ratio.\n *\n * Mount it **before** `compression()`, so it sees the compressed bytes:\n *\n * ```ts\n * bootstrap({ middlewares: [breachPadding(), compression(), …] })\n * ```\n *\n * Padding lives in the gzip header, which Brotli does not have, so this also\n * removes `br` and `zstd` from the request's `Accept-Encoding` — browsers then\n * get gzip, and the padding applies. Not for the web entry: Netlify, Vercel\n * and Cloudflare compress at the edge.\n */\nexport function breachPadding(options: BreachPaddingOptions = {}) {\n const maxBytes = options.maxBytes ?? 100\n\n return (req: Request, res: Response, next: NextFunction) => {\n const accept = req.headers['accept-encoding']\n if (typeof accept === 'string') {\n req.headers['accept-encoding'] = accept\n .split(',')\n .filter((part) => !/^\\s*(br|zstd)\\s*(;|$)/i.test(part))\n .join(',')\n }\n\n // compression() captures res.write / res.end when it runs, after this, so\n // its compressed output comes through these. The gzip header is in the\n // first bytes; collect until there are enough of them, pad, then pass the\n // rest through as it comes.\n const write = res.write.bind(res) as Writer\n const end = res.end.bind(res) as Writer\n let pending: Uint8Array | null = new Uint8Array(0)\n\n const isGzip = () => /\\bgzip\\b/i.test(String(res.getHeader('content-encoding') ?? ''))\n const take = (chunk: unknown): Uint8Array | null => {\n if (pending === null) return null\n if (!isGzip() || !(chunk instanceof Uint8Array)) {\n pending = null\n return null\n }\n const joined = new Uint8Array(pending.length + chunk.length)\n joined.set(pending)\n joined.set(chunk, pending.length)\n if (joined.length < GZIP_HEADER) {\n pending = joined\n return new Uint8Array(0)\n }\n pending = null\n return padGzipHeader(joined, maxBytes)\n }\n\n // Bytes held back while waiting for a full header. Whenever padding is\n // abandoned — the next chunk is a string, the encoding changed, the\n // response ends early — they go out first, so nothing is lost.\n const held = () => (pending && pending.length > 0 ? pending : null)\n\n ;(res as unknown as { write: Writer }).write = (chunk, ...rest) => {\n const before = held()\n const out = take(chunk)\n if (out === null) {\n if (before) write(Buffer.from(before))\n return write(chunk, ...rest)\n }\n return out.length > 0 ? write(Buffer.from(out), ...rest) : true\n }\n ;(res as unknown as { end: Writer }).end = (chunk, ...rest) => {\n const before = held()\n // end() / end(callback): no more data — send what was held, unpadded.\n if (chunk === undefined || typeof chunk === 'function') {\n pending = null\n if (before) write(Buffer.from(before))\n return end(chunk, ...rest)\n }\n const out = take(chunk)\n pending = null\n if (out === null) {\n if (before) write(Buffer.from(before))\n return end(chunk, ...rest)\n }\n return end(Buffer.from(out), ...rest)\n }\n next()\n }\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAS,YAAY,IAAqB,CACxC,GAAI,KAAO,EAAG,MAAO,GACrB,GAAM,CAAC,OAAS,OAAO,gCAAgB,IAAI,YAAY,CAAC,CAAC,EACzD,OAAO,MAAQ,GACjB,CASA,SAAgB,cAAc,MAAmB,SAA8B,CAC7E,GACE,MAAM,OAAS,IACf,MAAM,KAAO,IACb,MAAM,KAAO,KACb,MAAM,KAAO,GACb,MAAM,KAAO,EAEb,OAAO,MAET,IAAM,OAAS,YAAY,QAAQ,EAC7B,OAAS,IAAI,WAAW,MAAM,OAAS,OAAS,CAAC,EAMvD,OALA,OAAO,IAAI,MAAM,SAAS,EAAG,EAAW,CAAC,EACzC,OAAO,GAAK,EACZ,OAAO,KAAK,GAAM,GAAa,GAAc,MAAM,EACnD,OAAO,GAAc,QAAU,EAC/B,OAAO,IAAI,MAAM,SAAS,EAAW,EAAG,GAAc,OAAS,CAAC,EACzD,MACT,CAqBA,SAAgB,cAAc,QAAgC,CAAC,EAAG,CAChE,IAAM,SAAW,QAAQ,UAAY,IAErC,OAAQ,IAAc,IAAe,OAAuB,CAC1D,IAAM,OAAS,IAAI,QAAQ,mBACvB,OAAO,QAAW,WACpB,IAAI,QAAQ,mBAAqB,OAC9B,MAAM,GAAG,CAAC,CACV,OAAQ,MAAS,CAAC,yBAAyB,KAAK,IAAI,CAAC,CAAC,CACtD,KAAK,GAAG,GAOb,IAAM,MAAQ,IAAI,MAAM,KAAK,GAAG,EAC1B,IAAM,IAAI,IAAI,KAAK,GAAG,EACxB,wBAA6B,IAAI,WAE/B,WAAe,YAAY,KAAK,OAAO,IAAI,UAAU,kBAAkB,GAAK,EAAE,CAAC,EAC/E,KAAQ,OAAsC,CAClD,GAAI,UAAY,KAAM,OAAO,KAC7B,GAAI,CAAC,OAAO,GAAK,EAAE,iBAAiB,YAElC,MADA,SAAU,KACH,KAET,IAAM,OAAS,IAAI,WAAW,QAAQ,OAAS,MAAM,MAAM,EAQ3D,OAPA,OAAO,IAAI,OAAO,EAClB,OAAO,IAAI,MAAO,QAAQ,MAAM,EAC5B,OAAO,OAAS,IAClB,QAAU,uBACH,IAAI,aAEb,QAAU,KACH,cAAc,OAAQ,QAAQ,EACvC,EAKM,SAAc,SAAW,QAAQ,OAAS,EAAI,QAAU,KAE7D,IAAsC,OAAS,MAAO,GAAG,OAAS,CACjE,IAAM,OAAS,KAAK,EACd,IAAM,KAAK,KAAK,EAKtB,OAJI,MAAQ,MACN,QAAQ,MAAM,OAAO,KAAK,MAAM,CAAC,EAC9B,MAAM,MAAO,GAAG,IAAI,GAEtB,IAAI,OAAS,EAAI,MAAM,OAAO,KAAK,GAAG,EAAG,GAAG,IAAI,EAAI,EAC7D,EACC,IAAoC,KAAO,MAAO,GAAG,OAAS,CAC7D,IAAM,OAAS,KAAK,EAEpB,GAAI,QAAU,IAAA,IAAa,OAAO,OAAU,WAG1C,MAFA,SAAU,KACN,QAAQ,MAAM,OAAO,KAAK,MAAM,CAAC,EAC9B,IAAI,MAAO,GAAG,IAAI,EAE3B,IAAM,IAAM,KAAK,KAAK,EAMtB,MALA,SAAU,KACN,MAAQ,MACN,QAAQ,MAAM,OAAO,KAAK,MAAM,CAAC,EAC9B,IAAI,MAAO,GAAG,IAAI,GAEpB,IAAI,OAAO,KAAK,GAAG,EAAG,GAAG,IAAI,CACtC,EACA,KAAK,CACP,CACF"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { n as cors, t as CorsOptions } from "../../cors-CsibNTQ6.mjs";
2
+ import { n as cors, t as CorsOptions } from "../../cors-2Bwhyhpt.mjs";
3
3
  export { CorsOptions, cors };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- const DEFAULT_METHODS=[`GET`,`HEAD`,`PUT`,`PATCH`,`POST`,`DELETE`];function isOriginAllowed(requestOrigin,allowed){return allowed===!0||allowed===`*`?!0:typeof allowed==`string`?requestOrigin===allowed:allowed instanceof RegExp?allowed.test(requestOrigin):Array.isArray(allowed)?allowed.some(pattern=>typeof pattern==`string`?requestOrigin===pattern:pattern.test(requestOrigin)):!1}function cors(options={}){let{origin=!1,methods=DEFAULT_METHODS,allowedHeaders,exposedHeaders,credentials=!1,maxAge=86400,preflight=!0}=options;return(req,res,next)=>{let requestOrigin=req.headers.origin;if(origin===`*`&&!credentials?res.setHeader(`Access-Control-Allow-Origin`,`*`):requestOrigin&&isOriginAllowed(requestOrigin,origin)&&(res.setHeader(`Access-Control-Allow-Origin`,requestOrigin),res.setHeader(`Vary`,`Origin`)),credentials&&res.setHeader(`Access-Control-Allow-Credentials`,`true`),exposedHeaders?.length&&res.setHeader(`Access-Control-Expose-Headers`,exposedHeaders.join(`, `)),preflight&&req.method===`OPTIONS`){res.setHeader(`Access-Control-Allow-Methods`,methods.join(`, `));let reqHeaders=allowedHeaders??req.headers[`access-control-request-headers`];if(reqHeaders){let value=Array.isArray(reqHeaders)?reqHeaders.join(`, `):reqHeaders;res.setHeader(`Access-Control-Allow-Headers`,value)}maxAge&&res.setHeader(`Access-Control-Max-Age`,String(maxAge)),res.statusCode=204,res.setHeader(`Content-Length`,`0`),res.end()}else next()}}export{cors};
11
+ const DEFAULT_METHODS=[`GET`,`HEAD`,`PUT`,`PATCH`,`POST`,`DELETE`];function isOriginAllowed(requestOrigin,allowed){return allowed===!0||allowed===`*`?!0:typeof allowed==`string`?requestOrigin===allowed:allowed instanceof RegExp?allowed.test(requestOrigin):Array.isArray(allowed)?allowed.some(pattern=>typeof pattern==`string`?requestOrigin===pattern:pattern.test(requestOrigin)):!1}function cors(options={}){let{origin=!1,methods=DEFAULT_METHODS,allowedHeaders,exposedHeaders,credentials=!1,maxAge=86400,preflight=!0}=options,exposeValue=exposedHeaders?.length?exposedHeaders.join(`, `):void 0,methodsValue=methods.join(`, `),allowedValue=allowedHeaders?.join(`, `),maxAgeValue=maxAge?String(maxAge):void 0;return(req,res,next)=>{let requestOrigin=req.headers.origin;if(origin===`*`&&!credentials?res.setHeader(`Access-Control-Allow-Origin`,`*`):requestOrigin&&isOriginAllowed(requestOrigin,origin)&&(res.setHeader(`Access-Control-Allow-Origin`,requestOrigin),res.setHeader(`Vary`,`Origin`)),credentials&&res.setHeader(`Access-Control-Allow-Credentials`,`true`),exposeValue&&res.setHeader(`Access-Control-Expose-Headers`,exposeValue),preflight&&req.method===`OPTIONS`){res.setHeader(`Access-Control-Allow-Methods`,methodsValue);let reqHeaders=allowedValue??req.headers[`access-control-request-headers`];if(reqHeaders){let value=Array.isArray(reqHeaders)?reqHeaders.join(`, `):reqHeaders;res.setHeader(`Access-Control-Allow-Headers`,value)}maxAgeValue&&res.setHeader(`Access-Control-Max-Age`,maxAgeValue),res.statusCode=204,res.setHeader(`Content-Length`,`0`),res.end()}else next()}}export{cors};
12
12
  //# sourceMappingURL=cors.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"cors.mjs","names":[],"sources":["../../../src/http/middleware/cors.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport interface CorsOptions {\n /** Allowed origin(s). `true` reflects request origin, `'*'` allows all, `false` rejects all. Default: `false` (restrictive) */\n origin?: boolean | string | RegExp | (string | RegExp)[]\n /** Allowed HTTP methods. Default: `['GET','HEAD','PUT','PATCH','POST','DELETE']` */\n methods?: string[]\n /** Allowed request headers. Default: reflects `Access-Control-Request-Headers` */\n allowedHeaders?: string[]\n /** Headers exposed to the browser. Default: none */\n exposedHeaders?: string[]\n /** Allow credentials (cookies, authorization). Default: false */\n credentials?: boolean\n /** Preflight cache duration in seconds. Default: 86400 (24h) */\n maxAge?: number\n /** Handle preflight OPTIONS requests. Default: true */\n preflight?: boolean\n}\n\nconst DEFAULT_METHODS = ['GET', 'HEAD', 'PUT', 'PATCH', 'POST', 'DELETE']\n\nfunction isOriginAllowed(requestOrigin: string, allowed: CorsOptions['origin']): boolean {\n if (allowed === true || allowed === '*') return true\n if (typeof allowed === 'string') return requestOrigin === allowed\n if (allowed instanceof RegExp) return allowed.test(requestOrigin)\n if (Array.isArray(allowed)) {\n return allowed.some((pattern) =>\n typeof pattern === 'string' ? requestOrigin === pattern : pattern.test(requestOrigin),\n )\n }\n return false\n}\n\n/**\n * CORS middleware with correct spec behavior.\n *\n * - Reflects origin from allowlist (sets `Vary: Origin`)\n * - Handles preflight `OPTIONS` with `204 No Content`\n * - Supports string, regex, and array origin matching\n *\n * @example\n * ```ts\n * // Allow all origins\n * bootstrap({ middlewares: [cors(), express.json()] })\n *\n * // Allowlist specific origins\n * bootstrap({\n * middlewares: [\n * cors({\n * origin: ['https://app.example.com', /\\.example\\.com$/],\n * credentials: true,\n * }),\n * express.json(),\n * ],\n * })\n * ```\n */\nexport function cors(options: CorsOptions = {}) {\n const {\n origin = false,\n methods = DEFAULT_METHODS,\n allowedHeaders,\n exposedHeaders,\n credentials = false,\n maxAge = 86400,\n preflight = true,\n } = options\n\n return (req: Request, res: Response, next: NextFunction) => {\n const requestOrigin = req.headers.origin\n\n // Determine the Access-Control-Allow-Origin value\n if (origin === '*' && !credentials) {\n res.setHeader('Access-Control-Allow-Origin', '*')\n } else if (requestOrigin) {\n if (isOriginAllowed(requestOrigin, origin)) {\n res.setHeader('Access-Control-Allow-Origin', requestOrigin)\n // Must vary by Origin when reflecting — CDN/proxy correctness\n res.setHeader('Vary', 'Origin')\n }\n }\n\n if (credentials) {\n res.setHeader('Access-Control-Allow-Credentials', 'true')\n }\n\n if (exposedHeaders?.length) {\n res.setHeader('Access-Control-Expose-Headers', exposedHeaders.join(', '))\n }\n\n // Preflight handling\n if (preflight && req.method === 'OPTIONS') {\n res.setHeader('Access-Control-Allow-Methods', methods.join(', '))\n\n const reqHeaders = allowedHeaders ?? req.headers['access-control-request-headers']\n if (reqHeaders) {\n const value = Array.isArray(reqHeaders) ? reqHeaders.join(', ') : reqHeaders\n res.setHeader('Access-Control-Allow-Headers', value)\n }\n\n if (maxAge) {\n res.setHeader('Access-Control-Max-Age', String(maxAge))\n }\n\n res.statusCode = 204\n res.setHeader('Content-Length', '0')\n res.end()\n return\n }\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;AAmBA,MAAM,gBAAkB,CAAC,MAAO,OAAQ,MAAO,QAAS,OAAQ,QAAQ,EAExE,SAAS,gBAAgB,cAAuB,QAAyC,CASvF,OARI,UAAY,IAAQ,UAAY,IAAY,GAC5C,OAAO,SAAY,SAAiB,gBAAkB,QACtD,mBAAmB,OAAe,QAAQ,KAAK,aAAa,EAC5D,MAAM,QAAQ,OAAO,EAChB,QAAQ,KAAM,SACnB,OAAO,SAAY,SAAW,gBAAkB,QAAU,QAAQ,KAAK,aAAa,CACtF,EAEK,EACT,CA0BA,SAAgB,KAAK,QAAuB,CAAC,EAAG,CAC9C,GAAM,CACJ,OAAS,GACT,QAAU,gBACV,eACA,eACA,YAAc,GACd,OAAS,MACT,UAAY,IACV,QAEJ,OAAQ,IAAc,IAAe,OAAuB,CAC1D,IAAM,cAAgB,IAAI,QAAQ,OAsBlC,GAnBI,SAAW,KAAO,CAAC,YACrB,IAAI,UAAU,8BAA+B,GAAG,EACvC,eACL,gBAAgB,cAAe,MAAM,IACvC,IAAI,UAAU,8BAA+B,aAAa,EAE1D,IAAI,UAAU,OAAQ,QAAQ,GAI9B,aACF,IAAI,UAAU,mCAAoC,MAAM,EAGtD,gBAAgB,QAClB,IAAI,UAAU,gCAAiC,eAAe,KAAK,IAAI,CAAC,EAItE,WAAa,IAAI,SAAW,UAAW,CACzC,IAAI,UAAU,+BAAgC,QAAQ,KAAK,IAAI,CAAC,EAEhE,IAAM,WAAa,gBAAkB,IAAI,QAAQ,kCACjD,GAAI,WAAY,CACd,IAAM,MAAQ,MAAM,QAAQ,UAAU,EAAI,WAAW,KAAK,IAAI,EAAI,WAClE,IAAI,UAAU,+BAAgC,KAAK,CACrD,CAEI,QACF,IAAI,UAAU,yBAA0B,OAAO,MAAM,CAAC,EAGxD,IAAI,WAAa,IACjB,IAAI,UAAU,iBAAkB,GAAG,EACnC,IAAI,IAAI,CAEV,MAEA,KAAK,CACP,CACF"}
1
+ {"version":3,"file":"cors.mjs","names":[],"sources":["../../../src/http/middleware/cors.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport interface CorsOptions {\n /** Allowed origin(s). `true` reflects request origin, `'*'` allows all, `false` rejects all. Default: `false` (restrictive) */\n origin?: boolean | string | RegExp | (string | RegExp)[]\n /** Allowed HTTP methods. Default: `['GET','HEAD','PUT','PATCH','POST','DELETE']` */\n methods?: string[]\n /** Allowed request headers. Default: reflects `Access-Control-Request-Headers` */\n allowedHeaders?: string[]\n /** Headers exposed to the browser. Default: none */\n exposedHeaders?: string[]\n /** Allow credentials (cookies, authorization). Default: false */\n credentials?: boolean\n /** Preflight cache duration in seconds. Default: 86400 (24h) */\n maxAge?: number\n /** Handle preflight OPTIONS requests. Default: true */\n preflight?: boolean\n}\n\nconst DEFAULT_METHODS = ['GET', 'HEAD', 'PUT', 'PATCH', 'POST', 'DELETE']\n\nfunction isOriginAllowed(requestOrigin: string, allowed: CorsOptions['origin']): boolean {\n if (allowed === true || allowed === '*') return true\n if (typeof allowed === 'string') return requestOrigin === allowed\n if (allowed instanceof RegExp) return allowed.test(requestOrigin)\n if (Array.isArray(allowed)) {\n return allowed.some((pattern) =>\n typeof pattern === 'string' ? requestOrigin === pattern : pattern.test(requestOrigin),\n )\n }\n return false\n}\n\n/**\n * CORS middleware with correct spec behavior.\n *\n * - Reflects origin from allowlist (sets `Vary: Origin`)\n * - Handles preflight `OPTIONS` with `204 No Content`\n * - Supports string, regex, and array origin matching\n *\n * @example\n * ```ts\n * // Allow all origins\n * bootstrap({ middlewares: [cors(), express.json()] })\n *\n * // Allowlist specific origins\n * bootstrap({\n * middlewares: [\n * cors({\n * origin: ['https://app.example.com', /\\.example\\.com$/],\n * credentials: true,\n * }),\n * express.json(),\n * ],\n * })\n * ```\n *\n * Options are read once, when the middleware is created: changing the options\n * object afterwards does not change the headers. Create a new middleware instead.\n */\nexport function cors(options: CorsOptions = {}) {\n const {\n origin = false,\n methods = DEFAULT_METHODS,\n allowedHeaders,\n exposedHeaders,\n credentials = false,\n maxAge = 86400,\n preflight = true,\n } = options\n\n // Header values depend only on the options — joined once, not per request.\n const exposeValue = exposedHeaders?.length ? exposedHeaders.join(', ') : undefined\n const methodsValue = methods.join(', ')\n const allowedValue = allowedHeaders?.join(', ')\n const maxAgeValue = maxAge ? String(maxAge) : undefined\n\n return (req: Request, res: Response, next: NextFunction) => {\n const requestOrigin = req.headers.origin\n\n // Determine the Access-Control-Allow-Origin value\n if (origin === '*' && !credentials) {\n res.setHeader('Access-Control-Allow-Origin', '*')\n } else if (requestOrigin) {\n if (isOriginAllowed(requestOrigin, origin)) {\n res.setHeader('Access-Control-Allow-Origin', requestOrigin)\n // Must vary by Origin when reflecting — CDN/proxy correctness\n res.setHeader('Vary', 'Origin')\n }\n }\n\n if (credentials) {\n res.setHeader('Access-Control-Allow-Credentials', 'true')\n }\n\n if (exposeValue) res.setHeader('Access-Control-Expose-Headers', exposeValue)\n\n // Preflight handling\n if (preflight && req.method === 'OPTIONS') {\n res.setHeader('Access-Control-Allow-Methods', methodsValue)\n\n const reqHeaders = allowedValue ?? req.headers['access-control-request-headers']\n if (reqHeaders) {\n const value = Array.isArray(reqHeaders) ? reqHeaders.join(', ') : reqHeaders\n res.setHeader('Access-Control-Allow-Headers', value)\n }\n\n if (maxAgeValue) res.setHeader('Access-Control-Max-Age', maxAgeValue)\n\n res.statusCode = 204\n res.setHeader('Content-Length', '0')\n res.end()\n return\n }\n\n next()\n }\n}\n"],"mappings":";;;;;;;;;;AAmBA,MAAM,gBAAkB,CAAC,MAAO,OAAQ,MAAO,QAAS,OAAQ,QAAQ,EAExE,SAAS,gBAAgB,cAAuB,QAAyC,CASvF,OARI,UAAY,IAAQ,UAAY,IAAY,GAC5C,OAAO,SAAY,SAAiB,gBAAkB,QACtD,mBAAmB,OAAe,QAAQ,KAAK,aAAa,EAC5D,MAAM,QAAQ,OAAO,EAChB,QAAQ,KAAM,SACnB,OAAO,SAAY,SAAW,gBAAkB,QAAU,QAAQ,KAAK,aAAa,CACtF,EAEK,EACT,CA6BA,SAAgB,KAAK,QAAuB,CAAC,EAAG,CAC9C,GAAM,CACJ,OAAS,GACT,QAAU,gBACV,eACA,eACA,YAAc,GACd,OAAS,MACT,UAAY,IACV,QAGE,YAAc,gBAAgB,OAAS,eAAe,KAAK,IAAI,EAAI,IAAA,GACnE,aAAe,QAAQ,KAAK,IAAI,EAChC,aAAe,gBAAgB,KAAK,IAAI,EACxC,YAAc,OAAS,OAAO,MAAM,EAAI,IAAA,GAE9C,OAAQ,IAAc,IAAe,OAAuB,CAC1D,IAAM,cAAgB,IAAI,QAAQ,OAoBlC,GAjBI,SAAW,KAAO,CAAC,YACrB,IAAI,UAAU,8BAA+B,GAAG,EACvC,eACL,gBAAgB,cAAe,MAAM,IACvC,IAAI,UAAU,8BAA+B,aAAa,EAE1D,IAAI,UAAU,OAAQ,QAAQ,GAI9B,aACF,IAAI,UAAU,mCAAoC,MAAM,EAGtD,aAAa,IAAI,UAAU,gCAAiC,WAAW,EAGvE,WAAa,IAAI,SAAW,UAAW,CACzC,IAAI,UAAU,+BAAgC,YAAY,EAE1D,IAAM,WAAa,cAAgB,IAAI,QAAQ,kCAC/C,GAAI,WAAY,CACd,IAAM,MAAQ,MAAM,QAAQ,UAAU,EAAI,WAAW,KAAK,IAAI,EAAI,WAClE,IAAI,UAAU,+BAAgC,KAAK,CACrD,CAEI,aAAa,IAAI,UAAU,yBAA0B,WAAW,EAEpE,IAAI,WAAa,IACjB,IAAI,UAAU,iBAAkB,GAAG,EACnC,IAAI,IAAI,CAEV,MAEA,KAAK,CACP,CACF"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { i as csrfGuard, n as CsrfOptions, r as csrf, t as CsrfGuardOptions } from "../../csrf-C73UkRgc.mjs";
3
- export { CsrfGuardOptions, CsrfOptions, csrf, csrfGuard };
2
+ import { a as isAllowedOrigin, i as csrfGuard, n as CsrfOptions, r as csrf, t as CsrfGuardOptions } from "../../csrf-Cy1meSpf.mjs";
3
+ export { CsrfGuardOptions, CsrfOptions, csrf, csrfGuard, isAllowedOrigin };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
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 csrf,n as csrfGuard}from"../../csrf--1t4qDov.mjs";
11
+ export{t as csrf,n as csrfGuard,r as isAllowedOrigin}from"../../csrf-D3prC4FK.mjs";
@@ -1,3 +1,3 @@
1
1
 
2
- import { n as errorHandler, r as notFoundHandler, t as MountedRoute } from "../../error-handler-BB9wAElm.mjs";
2
+ import { dt as errorHandler, ft as notFoundHandler, ut as MountedRoute } from "../../adapter-BYdxuKiM.mjs";
3
3
  export { MountedRoute, errorHandler, notFoundHandler };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
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"../../core-B0JmdBvX.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 errorHandler(){let isProduction=process.env.NODE_ENV===`production`;return(err,req,res,_next)=>{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?{}:{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 exposeDetails=!isProduction&&err.details!==void 0;return res.setHeader(`Content-Type`,`application/problem+json`),res.status(err.status).json(normalizeProblem({status:err.status,detail:err.message,...exposeDetails?{errors:err.details}:{}}))}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?{}:{error:describeError(err),...typeof err?.stack==`string`?{stack:err.stack.split(`
11
+ import{createLogger,describeError}from"../../core/logger.mjs";import{HttpException,ProblemException,normalizeProblem}from"../../core/errors.mjs";import{t as isProduction}from"../../is-production-Dbm13WNL.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 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 exposeDetails=!isProduction$1&&err.details!==void 0;return res.setHeader(`Content-Type`,`application/problem+json`),res.status(err.status).json(normalizeProblem({status:err.status,detail:err.message,...exposeDetails?{errors:err.details}:{}}))}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 +1 @@
1
- {"version":3,"file":"error-handler.mjs","names":[],"sources":["../../../src/http/middleware/error-handler.ts"],"sourcesContent":["import type { RuntimeResponse } from '../runtime'\n\n/**\n * The slice of the request this handler reads, spelled from node's\n * `IncomingMessage` rather than Express's `Request`.\n *\n * Fastify and h3 hand the error handler `request.raw` — a plain\n * `IncomingMessage` — so anything Express-only is `undefined` there. This is\n * the default handler for EVERY runtime, so it must not assume Express.\n */\ninterface ErrorRequest {\n method?: string\n url?: string\n /** Express-only; absent on the raw node request the other runtimes pass. */\n originalUrl?: string\n headers: Record<string, string | string[] | undefined>\n}\nimport {\n HttpException,\n ProblemException,\n normalizeProblem,\n createLogger,\n describeError,\n} from '../../core'\n\nconst log = createLogger('ErrorHandler')\n\n/** A mounted route, as the catch-all needs to see it. */\nexport interface MountedRoute {\n method: string\n /** Full path as mounted, `:param` segments included. */\n path: string\n}\n\n/** `/things/:id` → `^/things/[^/]+$`, so a concrete path can be matched. */\nfunction patternToRegExp(pattern: string): RegExp {\n const source = pattern\n .replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&')\n .replace(/\\/:[^/]+/g, '/[^/]+')\n .replace(/\\*/g, '.*')\n return new RegExp(`^${source}/?$`)\n}\n\n/** Path without query string or hash. */\nfunction pathOf(req: ErrorRequest): string {\n const url = req.originalUrl ?? req.url ?? '/'\n const cut = url.search(/[?#]/)\n return cut === -1 ? url : url.slice(0, cut)\n}\n\n/**\n * Catch-all for unmatched routes.\n *\n * Answers RFC 9457 problem details, like every other error the framework\n * produces — the catch-all was the one path still emitting a bare\n * `{ message }`, so a client parsing `application/problem+json` had to special\n * case it.\n *\n * Distinguishes a path that does not exist from a path that does not accept\n * this method. `DELETE /things/1` where only `GET` is mounted is a **405** with\n * an `Allow` header, not a 404: the resource is there, the verb is not, and\n * 404 tells a client to stop looking for something that exists. Requires the\n * mounted route table, so an app that does not pass one keeps answering 404.\n */\nexport function notFoundHandler(routes: readonly MountedRoute[] = []) {\n const matchers = routes.map((route) => ({\n method: route.method.toUpperCase(),\n matches: patternToRegExp(route.path),\n }))\n\n return (req: ErrorRequest, res: RuntimeResponse, _next: () => void) => {\n const path = pathOf(req)\n const method = (req.method ?? 'GET').toUpperCase()\n const allowed = [...new Set(matchers.filter((m) => m.matches.test(path)).map((m) => m.method))]\n\n if (allowed.length > 0 && !allowed.includes(method)) {\n // Sorted once: the header and the detail must list the same verbs in the\n // same order, and `sort()` would mutate `allowed` under the second read.\n const verbs = allowed.toSorted().join(', ')\n // RFC 9110 §15.5.6 requires Allow on a 405.\n res.setHeader('Allow', verbs)\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(405).json(\n normalizeProblem({\n status: 405,\n detail: `${method} is not supported for this resource. Allowed: ${verbs}.`,\n }),\n )\n }\n\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(404).json(normalizeProblem({ status: 404 }))\n }\n}\n\n/**\n * Global error handler.\n *\n * Default behavior strips error `details` from the response in production\n * (NODE_ENV === 'production') so internal context (DB errors, validation\n * issues, custom payloads) does not leak to clients. Apps that want to\n * expose details in production — for client-facing field-level validation,\n * for example — should pass their own `onError` to `bootstrap()` and decide\n * the policy explicitly.\n *\n * Unexpected 500s carry `requestId` in every environment (the correlation\n * handle back to the log line) and, outside production, the error summary\n * plus stack. Production bodies stay opaque.\n *\n * {@link ProblemException} and plain {@link HttpException} both emit\n * `application/problem+json` per RFC 9457. `ProblemException` carries a\n * caller-supplied `type` / `title` / extensions; an `HttpException`'s message\n * becomes `detail`, with `title` and `type` defaulted from the status. One\n * shape, so a client never has to branch on which one the app threw.\n */\nexport function errorHandler() {\n const isProduction = process.env.NODE_ENV === 'production'\n return (err: any, req: ErrorRequest, res: RuntimeResponse, _next: () => void) => {\n // Don't write after headers are already sent\n if (res.headersSent) {\n log.warn(`Error after headers sent: ${err?.message || 'Unknown'}`)\n return\n }\n\n // RFC 9457 Problem Details — checked before HttpException because\n // ProblemException extends HttpException; instanceof on the base\n // would otherwise swallow it.\n if (err instanceof ProblemException) {\n if (err.problem.status >= 500) {\n log.error(err, err.message)\n }\n if (err.headers) {\n for (const [k, v] of Object.entries(err.headers)) {\n res.setHeader(k, v)\n }\n }\n const body = normalizeProblem(err.problem)\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(body.status).json(body)\n }\n\n // Zod validation errors\n if (err?.name === 'ZodError') {\n const firstIssue = err.issues?.[0]\n return res.status(422).json({\n message: firstIssue?.message || 'Validation failed',\n ...(isProduction ? {} : { errors: err.issues }),\n })\n }\n\n // HttpException (expected application errors) — RFC 9457, same as\n // ProblemException. It used to answer a bare `{ message }`, which made it\n // THE path a client parsing `application/problem+json` had to special-case\n // (#611) — the exact situation #587 removed from the catch-all. The\n // message becomes `detail`; `title` and `type` default from the status.\n if (err instanceof HttpException) {\n if (err.status >= 500) {\n log.error(err, err.message)\n }\n if (err.headers) {\n for (const [k, v] of Object.entries(err.headers)) {\n res.setHeader(k, v)\n }\n }\n const exposeDetails = !isProduction && err.details !== undefined\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(err.status).json(\n normalizeProblem({\n status: err.status,\n detail: err.message,\n // Extension member, permitted by RFC 9457 §3.2. Held back in\n // production for the same reason as before: `details` can carry the\n // shape of the request that failed.\n ...(exposeDetails ? { errors: err.details } : {}),\n }),\n )\n }\n\n const requestId = (req as any).requestId ?? req.headers['x-request-id']\n const declared = Number(err.status ?? err.statusCode)\n\n // Any error that says it's a client error — a database UniqueViolationError\n // (409), a BYO auth check's 401 — is answered like an HttpException: RFC\n // 9457, its message as `detail`, and a warning rather than an error log.\n // It used to fall through to the catch-all: logged at ERROR with a stack,\n // answered with a bare `{ message }` no problem+json client could parse.\n if (Number.isInteger(declared) && declared >= 400 && declared < 500) {\n log.warn(`${req.method} ${req.originalUrl ?? req.url} — ${declared} ${describeError(err)}`)\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(declared).json(\n normalizeProblem({\n status: declared,\n detail: err.message || undefined,\n ...(requestId ? { requestId } : {}),\n }),\n )\n }\n\n // Unexpected errors — always log. A declared 5xx keeps its status but\n // gets the same guarded body as a 500.\n const status = Number.isInteger(declared) && declared >= 500 && declared < 600 ? declared : 500\n log.error(\n err,\n // `originalUrl` is Express-only. Fastify and h3 pass `request.raw`, so\n // this logged `GET undefined — <error>` on every error under those\n // runtimes — the path silently dropped from the one line meant to\n // identify the failing request.\n `${req.method} ${req.originalUrl ?? req.url} — ${describeError(err)}${\n requestId ? ` [${requestId}]` : ''\n }`,\n )\n\n // A 500 body must never carry the raw error in production — it can\n // contain table names, SQL, connection strings, or user data. But\n // returning a bare `{ message: 'Internal Server Error' }` in\n // development means the one place a developer is looking tells them\n // nothing, and the failure has to be re-diagnosed from the database.\n //\n // Development gets the full picture. Production gets the requestId,\n // which is the correlation handle back to the (now stack-carrying)\n // log line — without it an opaque 500 can't even be tied to its own\n // log entry.\n res.status(status).json({\n message: 'Internal Server Error',\n ...(requestId ? { requestId } : {}),\n ...(isProduction\n ? {}\n : {\n error: describeError(err),\n ...(typeof err?.stack === 'string' ? { stack: err.stack.split('\\n') } : {}),\n }),\n })\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"error-handler.mjs","names":["isProduction","isProductionEnv"],"sources":["../../../src/http/middleware/error-handler.ts"],"sourcesContent":["import type { RuntimeResponse } from '../runtime'\n\n/**\n * The slice of the request this handler reads, spelled from node's\n * `IncomingMessage` rather than Express's `Request`.\n *\n * Fastify and h3 hand the error handler `request.raw` — a plain\n * `IncomingMessage` — so anything Express-only is `undefined` there. This is\n * the default handler for EVERY runtime, so it must not assume Express.\n */\ninterface ErrorRequest {\n method?: string\n url?: string\n /** Express-only; absent on the raw node request the other runtimes pass. */\n originalUrl?: string\n headers: Record<string, string | string[] | undefined>\n}\n// Module paths, not the core barrel: the web entry (edge runtimes) uses these\n// handlers too, and the barrel reaches node-only modules.\nimport { HttpException, ProblemException, normalizeProblem } from '../../core/errors'\nimport { createLogger, describeError } from '../../core/logger'\nimport { isProduction as isProductionEnv } from '../../core/is-production'\n\nconst log = createLogger('ErrorHandler')\n\n/** A mounted route, as the catch-all needs to see it. */\nexport interface MountedRoute {\n method: string\n /** Full path as mounted, `:param` segments included. */\n path: string\n}\n\n/** `/things/:id` → `^/things/[^/]+$`, so a concrete path can be matched. */\nfunction patternToRegExp(pattern: string): RegExp {\n const source = pattern\n .replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&')\n .replace(/\\/:[^/]+/g, '/[^/]+')\n .replace(/\\*/g, '.*')\n return new RegExp(`^${source}/?$`)\n}\n\n/** Path without query string or hash. */\nfunction pathOf(req: ErrorRequest): string {\n const url = req.originalUrl ?? req.url ?? '/'\n const cut = url.search(/[?#]/)\n return cut === -1 ? url : url.slice(0, cut)\n}\n\n/**\n * Catch-all for unmatched routes.\n *\n * Answers RFC 9457 problem details, like every other error the framework\n * produces — the catch-all was the one path still emitting a bare\n * `{ message }`, so a client parsing `application/problem+json` had to special\n * case it.\n *\n * Distinguishes a path that does not exist from a path that does not accept\n * this method. `DELETE /things/1` where only `GET` is mounted is a **405** with\n * an `Allow` header, not a 404: the resource is there, the verb is not, and\n * 404 tells a client to stop looking for something that exists. Requires the\n * mounted route table, so an app that does not pass one keeps answering 404.\n */\nexport function notFoundHandler(routes: readonly MountedRoute[] = []) {\n const matchers = routes.map((route) => ({\n method: route.method.toUpperCase(),\n matches: patternToRegExp(route.path),\n }))\n\n return (req: ErrorRequest, res: RuntimeResponse, _next: () => void) => {\n const path = pathOf(req)\n const method = (req.method ?? 'GET').toUpperCase()\n const allowed = [...new Set(matchers.filter((m) => m.matches.test(path)).map((m) => m.method))]\n\n if (allowed.length > 0 && !allowed.includes(method)) {\n // Sorted once: the header and the detail must list the same verbs in the\n // same order, and `sort()` would mutate `allowed` under the second read.\n const verbs = allowed.toSorted().join(', ')\n // RFC 9110 §15.5.6 requires Allow on a 405.\n res.setHeader('Allow', verbs)\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(405).json(\n normalizeProblem({\n status: 405,\n detail: `${method} is not supported for this resource. Allowed: ${verbs}.`,\n }),\n )\n }\n\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(404).json(normalizeProblem({ status: 404 }))\n }\n}\n\n/**\n * Global error handler.\n *\n * Default behavior strips error `details` from the response in production\n * (NODE_ENV === 'production') so internal context (DB errors, validation\n * issues, custom payloads) does not leak to clients. Apps that want to\n * expose details in production — for client-facing field-level validation,\n * for example — should pass their own `onError` to `bootstrap()` and decide\n * the policy explicitly.\n *\n * Unexpected 500s carry `requestId` in every environment (the correlation\n * handle back to the log line) and, outside production, the error summary\n * plus stack. Production bodies stay opaque.\n *\n * {@link ProblemException} and plain {@link HttpException} both emit\n * `application/problem+json` per RFC 9457. `ProblemException` carries a\n * caller-supplied `type` / `title` / extensions; an `HttpException`'s message\n * becomes `detail`, with `title` and `type` defaulted from the status. One\n * shape, so a client never has to branch on which one the app threw.\n */\nexport function errorHandler() {\n return (err: any, req: ErrorRequest, res: RuntimeResponse, _next: () => void) => {\n const isProduction = isProductionEnv()\n // Don't write after headers are already sent\n if (res.headersSent) {\n log.warn(`Error after headers sent: ${err?.message || 'Unknown'}`)\n return\n }\n\n // RFC 9457 Problem Details — checked before HttpException because\n // ProblemException extends HttpException; instanceof on the base\n // would otherwise swallow it.\n if (err instanceof ProblemException) {\n if (err.problem.status >= 500) {\n log.error(err, err.message)\n }\n if (err.headers) {\n for (const [k, v] of Object.entries(err.headers)) {\n res.setHeader(k, v)\n }\n }\n const body = normalizeProblem(err.problem)\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(body.status).json(body)\n }\n\n // Zod validation errors\n if (err?.name === 'ZodError') {\n const firstIssue = err.issues?.[0]\n return res.status(422).json({\n message: firstIssue?.message || 'Validation failed',\n ...(isProduction ? {} : { errors: err.issues }),\n })\n }\n\n // HttpException (expected application errors) — RFC 9457, same as\n // ProblemException. It used to answer a bare `{ message }`, which made it\n // THE path a client parsing `application/problem+json` had to special-case\n // (#611) — the exact situation #587 removed from the catch-all. The\n // message becomes `detail`; `title` and `type` default from the status.\n if (err instanceof HttpException) {\n if (err.status >= 500) {\n log.error(err, err.message)\n }\n if (err.headers) {\n for (const [k, v] of Object.entries(err.headers)) {\n res.setHeader(k, v)\n }\n }\n const exposeDetails = !isProduction && err.details !== undefined\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(err.status).json(\n normalizeProblem({\n status: err.status,\n detail: err.message,\n // Extension member, permitted by RFC 9457 §3.2. Held back in\n // production for the same reason as before: `details` can carry the\n // shape of the request that failed.\n ...(exposeDetails ? { errors: err.details } : {}),\n }),\n )\n }\n\n const requestId = (req as any).requestId ?? req.headers['x-request-id']\n const declared = Number(err.status ?? err.statusCode)\n\n // Any error that says it's a client error — a database UniqueViolationError\n // (409), a BYO auth check's 401 — is answered like an HttpException: RFC\n // 9457, its message as `detail`, and a warning rather than an error log.\n // It used to fall through to the catch-all: logged at ERROR with a stack,\n // answered with a bare `{ message }` no problem+json client could parse.\n if (Number.isInteger(declared) && declared >= 400 && declared < 500) {\n log.warn(`${req.method} ${req.originalUrl ?? req.url} — ${declared} ${describeError(err)}`)\n res.setHeader('Content-Type', 'application/problem+json')\n return res.status(declared).json(\n normalizeProblem({\n status: declared,\n detail: err.message || undefined,\n ...(requestId ? { requestId } : {}),\n }),\n )\n }\n\n // Unexpected errors — always log. A declared 5xx keeps its status but\n // gets the same guarded body as a 500.\n const status = Number.isInteger(declared) && declared >= 500 && declared < 600 ? declared : 500\n log.error(\n err,\n // `originalUrl` is Express-only. Fastify and h3 pass `request.raw`, so\n // this logged `GET undefined — <error>` on every error under those\n // runtimes — the path silently dropped from the one line meant to\n // identify the failing request.\n `${req.method} ${req.originalUrl ?? req.url} — ${describeError(err)}${\n requestId ? ` [${requestId}]` : ''\n }`,\n )\n\n // A 500 body must never carry the raw error in production — it can\n // contain table names, SQL, connection strings, or user data. But\n // returning a bare `{ message: 'Internal Server Error' }` in\n // development means the one place a developer is looking tells them\n // nothing, and the failure has to be re-diagnosed from the database.\n //\n // Development gets the full picture. Production gets the requestId,\n // which is the correlation handle back to the (now stack-carrying)\n // log line — without it an opaque 500 can't even be tied to its own\n // log entry.\n res.status(status).json({\n message: 'Internal Server Error',\n ...(requestId ? { requestId } : {}),\n ...(isProduction\n ? {}\n : {\n error: describeError(err),\n ...(typeof err?.stack === 'string' ? { stack: err.stack.split('\\n') } : {}),\n }),\n })\n }\n}\n"],"mappings":"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"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { n as HelmetOptions, r as helmet, t as HELMET_MIDDLEWARE } from "../../helmet-C2QEU6S-.mjs";
2
+ import { n as HelmetOptions, r as helmet, t as HELMET_MIDDLEWARE } from "../../helmet-CEOmo516.mjs";
3
3
  export { HELMET_MIDDLEWARE, HelmetOptions, helmet };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- const HELMET_MIDDLEWARE=Symbol.for(`kick/http/helmet`);function helmet(options={}){let{noSniff=!0,frameguard=`DENY`,hsts={maxAge:31536e3,includeSubDomains:!0},dnsPrefetch=!1,hidePoweredBy=!0,referrerPolicy=`no-referrer`,xssFilter=!0,contentSecurityPolicy=!1}=options;return Object.defineProperty((req,res,next)=>{if(hidePoweredBy&&res.removeHeader(`X-Powered-By`),noSniff&&res.setHeader(`X-Content-Type-Options`,`nosniff`),frameguard&&res.setHeader(`X-Frame-Options`,frameguard),xssFilter&&res.setHeader(`X-XSS-Protection`,`0`),referrerPolicy&&res.setHeader(`Referrer-Policy`,referrerPolicy),dnsPrefetch||res.setHeader(`X-DNS-Prefetch-Control`,`off`),hsts){let value=`max-age=${hsts.maxAge??31536e3}`;hsts.includeSubDomains&&(value+=`; includeSubDomains`),hsts.preload&&(value+=`; preload`),res.setHeader(`Strict-Transport-Security`,value)}if(contentSecurityPolicy){let policy=typeof contentSecurityPolicy==`object`?Object.entries(contentSecurityPolicy).map(([key,values])=>`${key} ${values.join(` `)}`).join(`; `):`default-src 'self'`;res.setHeader(`Content-Security-Policy`,policy)}next()},HELMET_MIDDLEWARE,{value:!0})}export{HELMET_MIDDLEWARE,helmet};
11
+ const HELMET_MIDDLEWARE=Symbol.for(`kick/http/helmet`);function helmet(options={}){let{noSniff=!0,frameguard=`DENY`,hsts={maxAge:31536e3,includeSubDomains:!0},dnsPrefetch=!1,hidePoweredBy=!0,referrerPolicy=`no-referrer`,xssFilter=!0,contentSecurityPolicy=!1}=options,hstsValue=hsts?`max-age=${hsts.maxAge??31536e3}${hsts.includeSubDomains?`; includeSubDomains`:``}${hsts.preload?`; preload`:``}`:void 0,cspValue=contentSecurityPolicy?typeof contentSecurityPolicy==`object`?Object.entries(contentSecurityPolicy).map(([key,values])=>`${key} ${values.join(` `)}`).join(`; `):`default-src 'self'`:void 0;return Object.defineProperty((req,res,next)=>{hidePoweredBy&&res.removeHeader(`X-Powered-By`),noSniff&&res.setHeader(`X-Content-Type-Options`,`nosniff`),frameguard&&res.setHeader(`X-Frame-Options`,frameguard),xssFilter&&res.setHeader(`X-XSS-Protection`,`0`),referrerPolicy&&res.setHeader(`Referrer-Policy`,referrerPolicy),dnsPrefetch||res.setHeader(`X-DNS-Prefetch-Control`,`off`),hstsValue&&res.setHeader(`Strict-Transport-Security`,hstsValue),cspValue&&res.setHeader(`Content-Security-Policy`,cspValue),next()},HELMET_MIDDLEWARE,{value:!0})}export{HELMET_MIDDLEWARE,helmet};
12
12
  //# sourceMappingURL=helmet.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"helmet.mjs","names":[],"sources":["../../../src/http/middleware/helmet.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\n/** Brand identifying a `helmet()` handler, so auto-injection can stand down. */\nexport const HELMET_MIDDLEWARE = Symbol.for('kick/http/helmet')\n\nexport interface HelmetOptions {\n /** Set Content-Security-Policy header (default: self-only policy) */\n contentSecurityPolicy?: boolean | Record<string, string[]>\n /** Set X-Content-Type-Options: nosniff (default: true) */\n noSniff?: boolean\n /** Set X-Frame-Options (default: 'DENY') */\n frameguard?: false | 'DENY' | 'SAMEORIGIN'\n /** Set Strict-Transport-Security (default: max-age=31536000; includeSubDomains) */\n hsts?: false | { maxAge?: number; includeSubDomains?: boolean; preload?: boolean }\n /** Set X-DNS-Prefetch-Control (default: off) */\n dnsPrefetch?: boolean\n /** Remove X-Powered-By header (default: true) */\n hidePoweredBy?: boolean\n /** Set Referrer-Policy (default: 'no-referrer') */\n referrerPolicy?: false | string\n /** Set X-XSS-Protection: 0 (default: true — disables legacy XSS auditor) */\n xssFilter?: boolean\n}\n\n/**\n * Security headers middleware. Lightweight alternative to the `helmet` npm package\n * with sensible defaults for API servers.\n *\n * @example\n * ```ts\n * bootstrap({\n * middlewares: [helmet(), requestId(), express.json()],\n * })\n * ```\n */\nexport function helmet(options: HelmetOptions = {}) {\n const {\n noSniff = true,\n frameguard = 'DENY',\n hsts = { maxAge: 31536000, includeSubDomains: true },\n dnsPrefetch = false,\n hidePoweredBy = true,\n referrerPolicy = 'no-referrer',\n xssFilter = true,\n contentSecurityPolicy = false,\n } = options\n\n const handler = (req: Request, res: Response, next: NextFunction) => {\n if (hidePoweredBy) res.removeHeader('X-Powered-By')\n if (noSniff) res.setHeader('X-Content-Type-Options', 'nosniff')\n if (frameguard) res.setHeader('X-Frame-Options', frameguard)\n if (xssFilter) res.setHeader('X-XSS-Protection', '0')\n if (referrerPolicy) res.setHeader('Referrer-Policy', referrerPolicy)\n if (!dnsPrefetch) res.setHeader('X-DNS-Prefetch-Control', 'off')\n\n if (hsts) {\n const maxAge = hsts.maxAge ?? 31536000\n let value = `max-age=${maxAge}`\n if (hsts.includeSubDomains) value += '; includeSubDomains'\n if (hsts.preload) value += '; preload'\n res.setHeader('Strict-Transport-Security', value)\n }\n\n if (contentSecurityPolicy) {\n const policy =\n typeof contentSecurityPolicy === 'object'\n ? Object.entries(contentSecurityPolicy)\n .map(([key, values]) => `${key} ${values.join(' ')}`)\n .join('; ')\n : \"default-src 'self'\"\n res.setHeader('Content-Security-Policy', policy)\n }\n\n next()\n }\n\n // Brand the handler so the Application skips its own auto-injection. Without\n // that, auto-helmet runs first with defaults and a user helmet can only ADD\n // headers — an explicit `frameguard: false` would leave the auto-injected\n // `X-Frame-Options: DENY` standing.\n return Object.defineProperty(handler, HELMET_MIDDLEWARE, { value: true })\n}\n"],"mappings":";;;;;;;;;;AAGA,MAAa,kBAAoB,OAAO,IAAI,kBAAkB,EAgC9D,SAAgB,OAAO,QAAyB,CAAC,EAAG,CAClD,GAAM,CACJ,QAAU,GACV,WAAa,OACb,KAAO,CAAE,OAAQ,QAAU,kBAAmB,EAAK,EACnD,YAAc,GACd,cAAgB,GAChB,eAAiB,cACjB,UAAY,GACZ,sBAAwB,IACtB,QAmCJ,OAAO,OAAO,gBAjCG,IAAc,IAAe,OAAuB,CAQnE,GAPI,eAAe,IAAI,aAAa,cAAc,EAC9C,SAAS,IAAI,UAAU,yBAA0B,SAAS,EAC1D,YAAY,IAAI,UAAU,kBAAmB,UAAU,EACvD,WAAW,IAAI,UAAU,mBAAoB,GAAG,EAChD,gBAAgB,IAAI,UAAU,kBAAmB,cAAc,EAC9D,aAAa,IAAI,UAAU,yBAA0B,KAAK,EAE3D,KAAM,CAER,IAAI,MAAQ,WADG,KAAK,QAAU,UAE1B,KAAK,oBAAmB,OAAS,uBACjC,KAAK,UAAS,OAAS,aAC3B,IAAI,UAAU,4BAA6B,KAAK,CAClD,CAEA,GAAI,sBAAuB,CACzB,IAAM,OACJ,OAAO,uBAA0B,SAC7B,OAAO,QAAQ,qBAAqB,CAAC,CAClC,KAAK,CAAC,IAAK,UAAY,GAAG,IAAI,GAAG,OAAO,KAAK,GAAG,GAAG,CAAC,CACpD,KAAK,IAAI,EACZ,qBACN,IAAI,UAAU,0BAA2B,MAAM,CACjD,CAEA,KAAK,CACP,EAMsC,kBAAmB,CAAE,MAAO,EAAK,CAAC,CAC1E"}
1
+ {"version":3,"file":"helmet.mjs","names":[],"sources":["../../../src/http/middleware/helmet.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\n/** Brand identifying a `helmet()` handler, so auto-injection can stand down. */\nexport const HELMET_MIDDLEWARE = Symbol.for('kick/http/helmet')\n\nexport interface HelmetOptions {\n /** Set Content-Security-Policy header (default: self-only policy) */\n contentSecurityPolicy?: boolean | Record<string, string[]>\n /** Set X-Content-Type-Options: nosniff (default: true) */\n noSniff?: boolean\n /** Set X-Frame-Options (default: 'DENY') */\n frameguard?: false | 'DENY' | 'SAMEORIGIN'\n /** Set Strict-Transport-Security (default: max-age=31536000; includeSubDomains) */\n hsts?: false | { maxAge?: number; includeSubDomains?: boolean; preload?: boolean }\n /** Set X-DNS-Prefetch-Control (default: off) */\n dnsPrefetch?: boolean\n /** Remove X-Powered-By header (default: true) */\n hidePoweredBy?: boolean\n /** Set Referrer-Policy (default: 'no-referrer') */\n referrerPolicy?: false | string\n /** Set X-XSS-Protection: 0 (default: true — disables legacy XSS auditor) */\n xssFilter?: boolean\n}\n\n/**\n * Security headers middleware. Lightweight alternative to the `helmet` npm package\n * with sensible defaults for API servers.\n *\n * @example\n * ```ts\n * bootstrap({\n * middlewares: [helmet(), requestId(), express.json()],\n * })\n * ```\n *\n * Options are read once, when the middleware is created: changing the options\n * object afterwards does not change the headers. Create a new middleware instead.\n */\nexport function helmet(options: HelmetOptions = {}) {\n const {\n noSniff = true,\n frameguard = 'DENY',\n hsts = { maxAge: 31536000, includeSubDomains: true },\n dnsPrefetch = false,\n hidePoweredBy = true,\n referrerPolicy = 'no-referrer',\n xssFilter = true,\n contentSecurityPolicy = false,\n } = options\n\n // Header values depend only on the options — built once, not per request.\n const hstsValue = hsts\n ? `max-age=${hsts.maxAge ?? 31536000}${hsts.includeSubDomains ? '; includeSubDomains' : ''}${\n hsts.preload ? '; preload' : ''\n }`\n : undefined\n const cspValue = !contentSecurityPolicy\n ? undefined\n : typeof contentSecurityPolicy === 'object'\n ? Object.entries(contentSecurityPolicy)\n .map(([key, values]) => `${key} ${values.join(' ')}`)\n .join('; ')\n : \"default-src 'self'\"\n\n const handler = (req: Request, res: Response, next: NextFunction) => {\n if (hidePoweredBy) res.removeHeader('X-Powered-By')\n if (noSniff) res.setHeader('X-Content-Type-Options', 'nosniff')\n if (frameguard) res.setHeader('X-Frame-Options', frameguard)\n if (xssFilter) res.setHeader('X-XSS-Protection', '0')\n if (referrerPolicy) res.setHeader('Referrer-Policy', referrerPolicy)\n if (!dnsPrefetch) res.setHeader('X-DNS-Prefetch-Control', 'off')\n\n if (hstsValue) res.setHeader('Strict-Transport-Security', hstsValue)\n if (cspValue) res.setHeader('Content-Security-Policy', cspValue)\n\n next()\n }\n\n // Brand the handler so the Application skips its own auto-injection. Without\n // that, auto-helmet runs first with defaults and a user helmet can only ADD\n // headers — an explicit `frameguard: false` would leave the auto-injected\n // `X-Frame-Options: DENY` standing.\n return Object.defineProperty(handler, HELMET_MIDDLEWARE, { value: true })\n}\n"],"mappings":";;;;;;;;;;AAGA,MAAa,kBAAoB,OAAO,IAAI,kBAAkB,EAmC9D,SAAgB,OAAO,QAAyB,CAAC,EAAG,CAClD,GAAM,CACJ,QAAU,GACV,WAAa,OACb,KAAO,CAAE,OAAQ,QAAU,kBAAmB,EAAK,EACnD,YAAc,GACd,cAAgB,GAChB,eAAiB,cACjB,UAAY,GACZ,sBAAwB,IACtB,QAGE,UAAY,KACd,WAAW,KAAK,QAAU,UAAW,KAAK,kBAAoB,sBAAwB,KACpF,KAAK,QAAU,YAAc,KAE/B,IAAA,GACE,SAAY,sBAEd,OAAO,uBAA0B,SAC/B,OAAO,QAAQ,qBAAqB,CAAC,CAClC,KAAK,CAAC,IAAK,UAAY,GAAG,IAAI,GAAG,OAAO,KAAK,GAAG,GAAG,CAAC,CACpD,KAAK,IAAI,EACZ,qBALF,IAAA,GAyBJ,OAAO,OAAO,gBAlBG,IAAc,IAAe,OAAuB,CAC/D,eAAe,IAAI,aAAa,cAAc,EAC9C,SAAS,IAAI,UAAU,yBAA0B,SAAS,EAC1D,YAAY,IAAI,UAAU,kBAAmB,UAAU,EACvD,WAAW,IAAI,UAAU,mBAAoB,GAAG,EAChD,gBAAgB,IAAI,UAAU,kBAAmB,cAAc,EAC9D,aAAa,IAAI,UAAU,yBAA0B,KAAK,EAE3D,WAAW,IAAI,UAAU,4BAA6B,SAAS,EAC/D,UAAU,IAAI,UAAU,0BAA2B,QAAQ,EAE/D,KAAK,CACP,EAMsC,kBAAmB,CAAE,MAAO,EAAK,CAAC,CAC1E"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { n as RateLimitStore, r as rateLimit, t as RateLimitOptions } from "../../rate-limit-Bwed3jOV.mjs";
3
- export { RateLimitOptions, RateLimitStore, rateLimit };
2
+ import { i as rateLimit, n as RateLimitOptions, r as RateLimitStore, t as MemoryStore } from "../../rate-limit-BgoeahE5.mjs";
3
+ export { MemoryStore, RateLimitOptions, RateLimitStore, rateLimit };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{r as registerDisposable}from"../../disposables-CuY2S3bw.mjs";import{n as assertFlagTest,s as matchesFlagTest}from"../../route-flag-BWuvJsGZ.mjs";import{n as bindRoutePolicy}from"../../route-policy-B3vM6bSf.mjs";import{n as resolvePathname,t as resolveClientIp}from"../../client-ip-BbLDp03S.mjs";import{i as sendJson}from"../../respond-DFRj2-7q.mjs";var MemoryStore=class{windowMs;hits=/* @__PURE__ */ new Map;cleanupTimer;constructor(windowMs){this.windowMs=windowMs,this.cleanupTimer=setInterval(()=>this.cleanup(),windowMs),this.cleanupTimer.unref&&this.cleanupTimer.unref(),registerDisposable(()=>this.dispose())}dispose(){clearInterval(this.cleanupTimer),this.hits.clear()}async increment(key){let now=Date.now(),entry=this.hits.get(key);if(entry&&entry.resetTime.getTime()>now)return entry.totalHits++,{totalHits:entry.totalHits,resetTime:entry.resetTime};let resetTime=new Date(now+this.windowMs),newEntry={totalHits:1,resetTime};return this.hits.set(key,newEntry),{totalHits:1,resetTime}}async decrement(key){let entry=this.hits.get(key);entry&&entry.totalHits>0&&entry.totalHits--}async reset(key){this.hits.delete(key)}cleanup(){let now=Date.now();for(let[key,entry]of this.hits)entry.resetTime.getTime()<=now&&this.hits.delete(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),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{rateLimit};
11
+ import{r as registerDisposable}from"../../disposables-CJD_gWlA.mjs";import{n as assertFlagTest,s as matchesFlagTest}from"../../route-flag-BOQZs2Wn.mjs";import{n as bindRoutePolicy}from"../../route-policy-B8c6QfiU.mjs";import{n as resolvePathname,t as resolveClientIp}from"../../client-ip-D2dsx8RG.mjs";import{i as sendJson}from"../../respond-Dc18G0X7.mjs";import{t as BoundedCounters}from"../../bounded-counters-aA3iI_Ei.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 +1 @@
1
- {"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../../src/http/middleware/rate-limit.ts"],"sourcesContent":["import { assertFlagTest, matchesFlagTest, type RouteFlagTest } from '../../core/route-flag'\nimport { bindRoutePolicy, type RoutePolicyTable } from '../../core/route-policy'\nimport { sendJson } from './respond'\nimport type { Request, Response, NextFunction } from 'express'\nimport { resolveClientIp, resolvePathname, type ClientRequestLike } from '../client-ip'\n\nimport { registerDisposable } from '../../core/disposables'\n\nexport interface RateLimitStore {\n increment(key: string): Promise<{ totalHits: number; resetTime: Date }>\n decrement(key: string): Promise<void>\n reset(key: string): Promise<void>\n}\n\nexport interface RateLimitOptions {\n /** Maximum number of requests per window (default: 100) */\n max?: number\n /** Time window in milliseconds (default: 60_000) */\n windowMs?: number\n /** Response message when rate limit is exceeded (default: 'Too Many Requests') */\n message?: string\n /** HTTP status code when rate limit is exceeded (default: 429) */\n statusCode?: number\n /** Function to generate the key for rate limiting (default: req.ip) */\n keyGenerator?: (req: Request) => string\n /** Whether to send rate limit headers (default: true) */\n headers?: boolean\n /** Custom store implementation (default: in-memory Map) */\n store?: RateLimitStore\n /** Function to skip rate limiting for certain requests */\n skip?: (req: Request) => boolean\n /** Paths to exclude from rate limiting */\n skipPaths?: string[]\n /**\n * Skip limiting on routes carrying a route flag — a name, a list of names\n * (any-of), or a predicate.\n *\n * This middleware runs before route matching, so it has no `ctx.route` to\n * read. Instead the Application hands it a table of every mounted route's\n * flags at boot, and the incoming method + pathname is looked up against it.\n * Requests matching no route match no flags — which is the point of limiting\n * here rather than in a route-scoped guard.\n *\n * ```ts\n * const Public = defineRouteFlag('auth.public')\n * bootstrap({ middlewares: [rateLimit({ max: 60, exemptWhen: 'auth.public' })] })\n * ```\n *\n * Prefer `skipPaths` only for paths that are not routes at all (a static\n * mount, a proxied prefix); a flag cannot describe those.\n */\n exemptWhen?: RouteFlagTest\n}\n\ninterface MemoryStoreEntry {\n totalHits: number\n resetTime: Date\n}\n\nclass MemoryStore implements RateLimitStore {\n private hits = new Map<string, MemoryStoreEntry>()\n private cleanupTimer: ReturnType<typeof setInterval>\n\n constructor(private windowMs: number) {\n this.cleanupTimer = setInterval(() => this.cleanup(), windowMs)\n // Allow the process to exit without waiting for the timer\n if (this.cleanupTimer.unref) {\n this.cleanupTimer.unref()\n }\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 hits Map.\n registerDisposable(() => this.dispose())\n }\n\n /** Clear the cleanup interval and drop all hit counters. */\n dispose(): void {\n clearInterval(this.cleanupTimer)\n this.hits.clear()\n }\n\n async increment(key: string): Promise<{ totalHits: number; resetTime: Date }> {\n const now = Date.now()\n const entry = this.hits.get(key)\n\n if (entry && entry.resetTime.getTime() > now) {\n entry.totalHits++\n return { totalHits: entry.totalHits, resetTime: entry.resetTime }\n }\n\n const resetTime = new Date(now + this.windowMs)\n const newEntry: MemoryStoreEntry = { totalHits: 1, resetTime }\n this.hits.set(key, newEntry)\n return { totalHits: 1, resetTime }\n }\n\n async decrement(key: string): Promise<void> {\n const entry = this.hits.get(key)\n if (entry && entry.totalHits > 0) {\n entry.totalHits--\n }\n }\n\n async reset(key: string): Promise<void> {\n this.hits.delete(key)\n }\n\n private cleanup(): void {\n const now = Date.now()\n for (const [key, entry] of this.hits) {\n if (entry.resetTime.getTime() <= now) {\n this.hits.delete(key)\n }\n }\n }\n}\n\n/**\n * Rate limiting middleware.\n *\n * Limits the number of requests a client can make within a time window.\n * Uses an in-memory store by default, but accepts a custom store for\n * distributed deployments (e.g. Redis).\n *\n * @example\n * ```ts\n * import { rateLimit } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * middlewares: [\n * rateLimit({ max: 100, windowMs: 60_000 }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nexport function rateLimit(options: RateLimitOptions = {}) {\n const max = options.max ?? 100\n const windowMs = options.windowMs ?? 60_000\n const message = options.message ?? 'Too Many Requests'\n const statusCode = options.statusCode ?? 429\n // `req.ip` is Express-only. Under Fastify and h3 it is undefined, so EVERY\n // caller fell back to the same `'127.0.0.1'` literal — one shared bucket,\n // letting a single client exhaust the limit for everyone.\n const keyGenerator =\n options.keyGenerator ??\n ((req: Request) => resolveClientIp(req as ClientRequestLike) ?? 'global')\n const sendHeaders = options.headers ?? true\n const store = options.store ?? new MemoryStore(windowMs)\n const skip = options.skip\n const skipPaths = new Set(options.skipPaths ?? [])\n const exemptWhen = options.exemptWhen\n if (exemptWhen !== undefined) assertFlagTest(exemptWhen, 'rateLimit({ exemptWhen })')\n\n // Filled in by the Application once routes are mounted, via the slot\n // declared below. Absent when this middleware runs outside an Application\n // (a bare connect stack, a unit test) — `exemptWhen` then matches nothing,\n // which fails closed: everything stays limited.\n let policy: RoutePolicyTable | undefined\n\n const handler = async (req: Request, res: Response, next: NextFunction) => {\n // Skip if path is in the skip list\n // `req.path` is Express-only; `has(undefined)` never matched, so\n // configured skips were silently dead on the other runtimes.\n const pathname = resolvePathname(req as ClientRequestLike)\n if (skipPaths.has(pathname)) {\n return next()\n }\n\n // Flag exemption: ask the table what flags the matched route WOULD carry.\n // A request matching no route matches no flags and stays limited.\n // Routes are registered by their full path; mounted at a path, `req.url`\n // is relative to the mount, so look the route up by `originalUrl`.\n if (exemptWhen !== undefined && policy) {\n const { originalUrl } = req as ClientRequestLike\n const routePath = originalUrl ? resolvePathname({ url: originalUrl }) : pathname\n const flags = policy.lookup(String(req.method ?? 'GET'), routePath)\n if (matchesFlagTest(exemptWhen, flags)) {\n return next()\n }\n }\n\n // Skip if the skip function returns true\n if (skip && skip(req)) {\n return next()\n }\n\n const key = keyGenerator(req)\n const { totalHits, resetTime } = await store.increment(key)\n const remaining = Math.max(0, max - totalHits)\n\n if (sendHeaders) {\n res.setHeader('RateLimit-Limit', max)\n res.setHeader('RateLimit-Remaining', remaining)\n res.setHeader('RateLimit-Reset', Math.ceil(resetTime.getTime() / 1000))\n }\n\n if (totalHits > max) {\n return sendJson(res, statusCode, { message })\n }\n\n next()\n }\n\n return bindRoutePolicy(handler, (table) => {\n policy = table\n })\n}\n"],"mappings":";;;;;;;;;;oWA2DA,IAAM,YAAN,KAA4C,CAItB,SAHpB,qBAAe,IAAI,IACnB,aAEA,YAAY,SAA0B,CAAlB,KAAA,SAAA,SAClB,KAAK,aAAe,gBAAkB,KAAK,QAAQ,EAAG,QAAQ,EAE1D,KAAK,aAAa,OACpB,KAAK,aAAa,MAAM,EAK1B,uBAAyB,KAAK,QAAQ,CAAC,CACzC,CAGA,SAAgB,CACd,cAAc,KAAK,YAAY,EAC/B,KAAK,KAAK,MAAM,CAClB,CAEA,MAAM,UAAU,IAA8D,CAC5E,IAAM,IAAM,KAAK,IAAI,EACf,MAAQ,KAAK,KAAK,IAAI,GAAG,EAE/B,GAAI,OAAS,MAAM,UAAU,QAAQ,EAAI,IAEvC,MADA,OAAM,YACC,CAAE,UAAW,MAAM,UAAW,UAAW,MAAM,SAAU,EAGlE,IAAM,UAAY,IAAI,KAAK,IAAM,KAAK,QAAQ,EACxC,SAA6B,CAAE,UAAW,EAAG,SAAU,EAE7D,OADA,KAAK,KAAK,IAAI,IAAK,QAAQ,EACpB,CAAE,UAAW,EAAG,SAAU,CACnC,CAEA,MAAM,UAAU,IAA4B,CAC1C,IAAM,MAAQ,KAAK,KAAK,IAAI,GAAG,EAC3B,OAAS,MAAM,UAAY,GAC7B,MAAM,WAEV,CAEA,MAAM,MAAM,IAA4B,CACtC,KAAK,KAAK,OAAO,GAAG,CACtB,CAEA,SAAwB,CACtB,IAAM,IAAM,KAAK,IAAI,EACrB,IAAK,GAAM,CAAC,IAAK,SAAU,KAAK,KAC1B,MAAM,UAAU,QAAQ,GAAK,KAC/B,KAAK,KAAK,OAAO,GAAG,CAG1B,CACF,EAsBA,SAAgB,UAAU,QAA4B,CAAC,EAAG,CACxD,IAAM,IAAM,QAAQ,KAAO,IACrB,SAAW,QAAQ,UAAY,IAC/B,QAAU,QAAQ,SAAW,oBAC7B,WAAa,QAAQ,YAAc,IAInC,aACJ,QAAQ,eACN,KAAiB,gBAAgB,GAAwB,GAAK,UAC5D,YAAc,QAAQ,SAAW,GACjC,MAAQ,QAAQ,OAAS,IAAI,YAAY,QAAQ,EACjD,KAAO,QAAQ,KACf,UAAY,IAAI,IAAI,QAAQ,WAAa,CAAC,CAAC,EAC3C,WAAa,QAAQ,WACvB,aAAe,IAAA,IAAW,eAAe,WAAY,2BAA2B,EAMpF,IAAI,OA8CJ,OAAO,gBAAgB,MA5CA,IAAc,IAAe,OAAuB,CAIzE,IAAM,SAAW,gBAAgB,GAAwB,EACzD,GAAI,UAAU,IAAI,QAAQ,EACxB,OAAO,KAAK,EAOd,GAAI,aAAe,IAAA,IAAa,OAAQ,CACtC,GAAM,CAAE,aAAgB,IAClB,UAAY,YAAc,gBAAgB,CAAE,IAAK,WAAY,CAAC,EAAI,SAClE,MAAQ,OAAO,OAAO,OAAO,IAAI,QAAU,KAAK,EAAG,SAAS,EAClE,GAAI,gBAAgB,WAAY,KAAK,EACnC,OAAO,KAAK,CAEhB,CAGA,GAAI,MAAQ,KAAK,GAAG,EAClB,OAAO,KAAK,EAGd,IAAM,IAAM,aAAa,GAAG,EACtB,CAAE,UAAW,WAAc,MAAM,MAAM,UAAU,GAAG,EACpD,UAAY,KAAK,IAAI,EAAG,IAAM,SAAS,EAQ7C,GANI,cACF,IAAI,UAAU,kBAAmB,GAAG,EACpC,IAAI,UAAU,sBAAuB,SAAS,EAC9C,IAAI,UAAU,kBAAmB,KAAK,KAAK,UAAU,QAAQ,EAAI,GAAI,CAAC,GAGpE,UAAY,IACd,OAAO,SAAS,IAAK,WAAY,CAAE,OAAQ,CAAC,EAG9C,KAAK,CACP,EAEiC,OAAU,CACzC,OAAS,KACX,CAAC,CACH"}
1
+ {"version":3,"file":"rate-limit.mjs","names":[],"sources":["../../../src/http/middleware/rate-limit.ts"],"sourcesContent":["import { assertFlagTest, matchesFlagTest, type RouteFlagTest } from '../../core/route-flag'\nimport { bindRoutePolicy, type RoutePolicyTable } from '../../core/route-policy'\nimport { sendJson } from './respond'\nimport type { Request, Response, NextFunction } from 'express'\nimport { resolveClientIp, resolvePathname, type ClientRequestLike } from '../client-ip'\n\nimport { registerDisposable } from '../../core/disposables'\nimport { BoundedCounters } from './bounded-counters'\n\nexport interface RateLimitStore {\n increment(key: string): Promise<{ totalHits: number; resetTime: Date }>\n decrement(key: string): Promise<void>\n reset(key: string): Promise<void>\n}\n\nexport interface RateLimitOptions {\n /** Maximum number of requests per window (default: 100) */\n max?: number\n /** Time window in milliseconds (default: 60_000) */\n windowMs?: number\n /** Response message when rate limit is exceeded (default: 'Too Many Requests') */\n message?: string\n /** HTTP status code when rate limit is exceeded (default: 429) */\n statusCode?: number\n /** Function to generate the key for rate limiting (default: req.ip) */\n keyGenerator?: (req: Request) => string\n /** Whether to send rate limit headers (default: true) */\n headers?: boolean\n /** Custom store implementation (default: in-memory Map) */\n store?: RateLimitStore\n /** Function to skip rate limiting for certain requests */\n skip?: (req: Request) => boolean\n /** Paths to exclude from rate limiting */\n skipPaths?: string[]\n /**\n * Skip limiting on routes carrying a route flag — a name, a list of names\n * (any-of), or a predicate.\n *\n * This middleware runs before route matching, so it has no `ctx.route` to\n * read. Instead the Application hands it a table of every mounted route's\n * flags at boot, and the incoming method + pathname is looked up against it.\n * Requests matching no route match no flags — which is the point of limiting\n * here rather than in a route-scoped guard.\n *\n * ```ts\n * const Public = defineRouteFlag('auth.public')\n * bootstrap({ middlewares: [rateLimit({ max: 60, exemptWhen: 'auth.public' })] })\n * ```\n *\n * Prefer `skipPaths` only for paths that are not routes at all (a static\n * mount, a proxied prefix); a flag cannot describe those.\n */\n exemptWhen?: RouteFlagTest\n}\n\n/** @internal Exported for tests. Bounded: see {@link BoundedCounters}. */\nexport class MemoryStore implements RateLimitStore {\n private readonly counters: BoundedCounters\n private cleanupTimer: ReturnType<typeof setInterval>\n\n /** @param limit The `max` it enforces, so it never evicts a counter at the limit. */\n constructor(windowMs: number, limit?: number) {\n this.counters = new BoundedCounters(windowMs, limit)\n this.cleanupTimer = setInterval(() => this.counters.sweep(), windowMs)\n // Allow the process to exit without waiting for the timer\n if (this.cleanupTimer.unref) {\n this.cleanupTimer.unref()\n }\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 hits Map.\n registerDisposable(() => this.dispose())\n }\n\n /** Clear the cleanup interval and drop all hit counters. */\n dispose(): void {\n clearInterval(this.cleanupTimer)\n this.counters.clear()\n }\n\n async increment(key: string): Promise<{ totalHits: number; resetTime: Date }> {\n return this.counters.increment(key)\n }\n\n async decrement(key: string): Promise<void> {\n this.counters.decrement(key)\n }\n\n async reset(key: string): Promise<void> {\n this.counters.reset(key)\n }\n}\n\n/**\n * Rate limiting middleware.\n *\n * Limits the number of requests a client can make within a time window.\n * Uses an in-memory store by default, but accepts a custom store for\n * distributed deployments (e.g. Redis).\n *\n * @example\n * ```ts\n * import { rateLimit } from '@forinda/kickjs'\n *\n * bootstrap({\n * modules,\n * middlewares: [\n * rateLimit({ max: 100, windowMs: 60_000 }),\n * // ... other middleware\n * ],\n * })\n * ```\n */\nexport function rateLimit(options: RateLimitOptions = {}) {\n const max = options.max ?? 100\n const windowMs = options.windowMs ?? 60_000\n const message = options.message ?? 'Too Many Requests'\n const statusCode = options.statusCode ?? 429\n // `req.ip` is Express-only. Under Fastify and h3 it is undefined, so EVERY\n // caller fell back to the same `'127.0.0.1'` literal — one shared bucket,\n // letting a single client exhaust the limit for everyone.\n const keyGenerator =\n options.keyGenerator ??\n ((req: Request) => resolveClientIp(req as ClientRequestLike) ?? 'global')\n const sendHeaders = options.headers ?? true\n const store = options.store ?? new MemoryStore(windowMs, max)\n const skip = options.skip\n const skipPaths = new Set(options.skipPaths ?? [])\n const exemptWhen = options.exemptWhen\n if (exemptWhen !== undefined) assertFlagTest(exemptWhen, 'rateLimit({ exemptWhen })')\n\n // Filled in by the Application once routes are mounted, via the slot\n // declared below. Absent when this middleware runs outside an Application\n // (a bare connect stack, a unit test) — `exemptWhen` then matches nothing,\n // which fails closed: everything stays limited.\n let policy: RoutePolicyTable | undefined\n\n const handler = async (req: Request, res: Response, next: NextFunction) => {\n // Skip if path is in the skip list\n // `req.path` is Express-only; `has(undefined)` never matched, so\n // configured skips were silently dead on the other runtimes.\n const pathname = resolvePathname(req as ClientRequestLike)\n if (skipPaths.has(pathname)) {\n return next()\n }\n\n // Flag exemption: ask the table what flags the matched route WOULD carry.\n // A request matching no route matches no flags and stays limited.\n // Routes are registered by their full path; mounted at a path, `req.url`\n // is relative to the mount, so look the route up by `originalUrl`.\n if (exemptWhen !== undefined && policy) {\n const { originalUrl } = req as ClientRequestLike\n const routePath = originalUrl ? resolvePathname({ url: originalUrl }) : pathname\n const flags = policy.lookup(String(req.method ?? 'GET'), routePath)\n if (matchesFlagTest(exemptWhen, flags)) {\n return next()\n }\n }\n\n // Skip if the skip function returns true\n if (skip && skip(req)) {\n return next()\n }\n\n const key = keyGenerator(req)\n const { totalHits, resetTime } = await store.increment(key)\n const remaining = Math.max(0, max - totalHits)\n\n if (sendHeaders) {\n res.setHeader('RateLimit-Limit', max)\n res.setHeader('RateLimit-Remaining', remaining)\n res.setHeader('RateLimit-Reset', Math.ceil(resetTime.getTime() / 1000))\n }\n\n if (totalHits > max) {\n return sendJson(res, statusCode, { message })\n }\n\n next()\n }\n\n return bindRoutePolicy(handler, (table) => {\n policy = table\n })\n}\n"],"mappings":";;;;;;;;;;0aAwDA,IAAa,YAAb,KAAmD,CACjD,SACA,aAGA,YAAY,SAAkB,MAAgB,CAC5C,KAAK,SAAW,IAAI,gBAAgB,SAAU,KAAK,EACnD,KAAK,aAAe,gBAAkB,KAAK,SAAS,MAAM,EAAG,QAAQ,EAEjE,KAAK,aAAa,OACpB,KAAK,aAAa,MAAM,EAK1B,uBAAyB,KAAK,QAAQ,CAAC,CACzC,CAGA,SAAgB,CACd,cAAc,KAAK,YAAY,EAC/B,KAAK,SAAS,MAAM,CACtB,CAEA,MAAM,UAAU,IAA8D,CAC5E,OAAO,KAAK,SAAS,UAAU,GAAG,CACpC,CAEA,MAAM,UAAU,IAA4B,CAC1C,KAAK,SAAS,UAAU,GAAG,CAC7B,CAEA,MAAM,MAAM,IAA4B,CACtC,KAAK,SAAS,MAAM,GAAG,CACzB,CACF,EAsBA,SAAgB,UAAU,QAA4B,CAAC,EAAG,CACxD,IAAM,IAAM,QAAQ,KAAO,IACrB,SAAW,QAAQ,UAAY,IAC/B,QAAU,QAAQ,SAAW,oBAC7B,WAAa,QAAQ,YAAc,IAInC,aACJ,QAAQ,eACN,KAAiB,gBAAgB,GAAwB,GAAK,UAC5D,YAAc,QAAQ,SAAW,GACjC,MAAQ,QAAQ,OAAS,IAAI,YAAY,SAAU,GAAG,EACtD,KAAO,QAAQ,KACf,UAAY,IAAI,IAAI,QAAQ,WAAa,CAAC,CAAC,EAC3C,WAAa,QAAQ,WACvB,aAAe,IAAA,IAAW,eAAe,WAAY,2BAA2B,EAMpF,IAAI,OA8CJ,OAAO,gBAAgB,MA5CA,IAAc,IAAe,OAAuB,CAIzE,IAAM,SAAW,gBAAgB,GAAwB,EACzD,GAAI,UAAU,IAAI,QAAQ,EACxB,OAAO,KAAK,EAOd,GAAI,aAAe,IAAA,IAAa,OAAQ,CACtC,GAAM,CAAE,aAAgB,IAClB,UAAY,YAAc,gBAAgB,CAAE,IAAK,WAAY,CAAC,EAAI,SAClE,MAAQ,OAAO,OAAO,OAAO,IAAI,QAAU,KAAK,EAAG,SAAS,EAClE,GAAI,gBAAgB,WAAY,KAAK,EACnC,OAAO,KAAK,CAEhB,CAGA,GAAI,MAAQ,KAAK,GAAG,EAClB,OAAO,KAAK,EAGd,IAAM,IAAM,aAAa,GAAG,EACtB,CAAE,UAAW,WAAc,MAAM,MAAM,UAAU,GAAG,EACpD,UAAY,KAAK,IAAI,EAAG,IAAM,SAAS,EAQ7C,GANI,cACF,IAAI,UAAU,kBAAmB,GAAG,EACpC,IAAI,UAAU,sBAAuB,SAAS,EAC9C,IAAI,UAAU,kBAAmB,KAAK,KAAK,UAAU,QAAQ,EAAI,GAAI,CAAC,GAGpE,UAAY,IACd,OAAO,SAAS,IAAK,WAAY,CAAE,OAAQ,CAAC,EAG9C,KAAK,CACP,EAEiC,OAAU,CACzC,OAAS,KACX,CAAC,CACH"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- const REQUEST_ID_HEADER=`x-request-id`;function requestId(){return(req,res,next)=>{let id=req.requestId||req.headers[`x-request-id`]||crypto.randomUUID();req.requestId=id,res.setHeader(REQUEST_ID_HEADER,id),next()}}export{REQUEST_ID_HEADER,requestId};
11
+ const REQUEST_ID_HEADER=`x-request-id`;function requestId(){return(req,res,next)=>{let existing=req.requestId,header=req.headers[REQUEST_ID_HEADER],id=existing||(Array.isArray(header)?header[0]:header)||crypto.randomUUID();req.requestId=id,res.setHeader(REQUEST_ID_HEADER,id),next()}}export{REQUEST_ID_HEADER,requestId};
12
12
  //# sourceMappingURL=request-id.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"request-id.mjs","names":[],"sources":["../../../src/http/middleware/request-id.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport const REQUEST_ID_HEADER = 'x-request-id'\n\n/**\n * Middleware that generates or propagates a unique request ID.\n *\n * Idempotent: if `req.requestId` is already set (e.g. by\n * `requestScopeMiddleware` earlier in the pipeline), this middleware reuses\n * it instead of generating a divergent second value. Keeps the\n * X-Request-Id response header, the ALS store's `requestId`, and\n * `RequestContext.requestId` in agreement for every request, regardless of\n * mounting order.\n */\nexport function requestId() {\n return (req: Request, res: Response, next: NextFunction) => {\n const existing = (req as Request & { requestId?: string }).requestId\n // globalThis.crypto (Web Crypto) — portable across node/bun/deno/workers,\n // unlike node:crypto. Node ≥ 19 exposes it globally; engines pin ≥ 20.\n const id = existing || (req.headers[REQUEST_ID_HEADER] as string) || crypto.randomUUID()\n ;(req as any).requestId = id\n res.setHeader(REQUEST_ID_HEADER, id)\n next()\n }\n}\n"],"mappings":";;;;;;;;;;AAEA,MAAa,kBAAoB,eAYjC,SAAgB,WAAY,CAC1B,OAAQ,IAAc,IAAe,OAAuB,CAI1D,IAAM,GAHY,IAAyC,WAGnC,IAAI,QAAA,iBAAyC,OAAO,WAAW,EACtF,IAAa,UAAY,GAC1B,IAAI,UAAU,kBAAmB,EAAE,EACnC,KAAK,CACP,CACF"}
1
+ {"version":3,"file":"request-id.mjs","names":[],"sources":["../../../src/http/middleware/request-id.ts"],"sourcesContent":["import type { Request, Response, NextFunction } from 'express'\n\nexport const REQUEST_ID_HEADER = 'x-request-id'\n\n/**\n * Middleware that generates or propagates a unique request ID.\n *\n * Idempotent: if `req.requestId` is already set (e.g. by\n * `requestScopeMiddleware` earlier in the pipeline), this middleware reuses\n * it instead of generating a divergent second value. Keeps the\n * X-Request-Id response header, the ALS store's `requestId`, and\n * `RequestContext.requestId` in agreement for every request, regardless of\n * mounting order.\n */\nexport function requestId() {\n return (req: Request, res: Response, next: NextFunction) => {\n const existing = (req as Request & { requestId?: string }).requestId\n // globalThis.crypto (Web Crypto) — portable across node/bun/deno/workers,\n // unlike node:crypto. Node ≥ 19 exposes it globally; engines pin ≥ 20.\n const header = req.headers[REQUEST_ID_HEADER]\n const id = existing || (Array.isArray(header) ? header[0] : header) || crypto.randomUUID()\n ;(req as any).requestId = id\n res.setHeader(REQUEST_ID_HEADER, id)\n next()\n }\n}\n"],"mappings":";;;;;;;;;;AAEA,MAAa,kBAAoB,eAYjC,SAAgB,WAAY,CAC1B,OAAQ,IAAc,IAAe,OAAuB,CAC1D,IAAM,SAAY,IAAyC,UAGrD,OAAS,IAAI,QAAQ,mBACrB,GAAK,WAAa,MAAM,QAAQ,MAAM,EAAI,OAAO,GAAK,SAAW,OAAO,WAAW,EACxF,IAAa,UAAY,GAC1B,IAAI,UAAU,kBAAmB,EAAE,EACnC,KAAK,CACP,CACF"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{createLogger}from"../../core/logger.mjs";import"../../core-B0JmdBvX.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};
11
+ import{createLogger}from"../../core/logger.mjs";import"../../core-D1AV-Tvd.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,3 +1,3 @@
1
1
 
2
- import { a as session, i as SessionStore, n as SessionData, r as SessionOptions, t as Session } from "../../session-B4hOZj90.mjs";
3
- export { Session, SessionData, SessionOptions, SessionStore, session };
2
+ import { a as SessionStore, i as SessionOptions, n as Session, o as session, r as SessionData, t as MemoryStore } from "../../session-ChXx7jG5.mjs";
3
+ export { MemoryStore, Session, SessionData, SessionOptions, SessionStore, session };
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs v10.1.0
2
+ * @forinda/kickjs v10.3.0
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{createLogger}from"../../core/logger.mjs";import{r as registerDisposable}from"../../disposables-CuY2S3bw.mjs";import{a as setCookie,r as replaceCookie,t as parseCookieHeader}from"../../respond-DFRj2-7q.mjs";import{createCipheriv,createDecipheriv,createHmac,hkdfSync,randomBytes,randomUUID,timingSafeEqual}from"node:crypto";var MemoryStore=class{sessions=/* @__PURE__ */ new Map;cleanupInterval;constructor(){this.cleanupInterval=setInterval(()=>this.purge(),6e4),this.cleanupInterval.unref(),registerDisposable(()=>this.dispose())}dispose(){clearInterval(this.cleanupInterval),this.sessions.clear()}async get(sid){let entry=this.sessions.get(sid);return entry?Date.now()>entry.expires?(this.sessions.delete(sid),null):entry.data:null}async set(sid,data,maxAge){this.sessions.set(sid,{data,expires:Date.now()+maxAge})}async destroy(sid){this.sessions.delete(sid)}async touch(sid,maxAge){let entry=this.sessions.get(sid);entry&&(entry.expires=Date.now()+maxAge)}purge(){let now=Date.now();for(let[sid,entry]of this.sessions)now>entry.expires&&this.sessions.delete(sid)}};function sign(value,secret){return`s:${value}.${createHmac(`sha256`,secret).update(value).digest(`base64url`)}`}function unsign(signed,secret){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),providedSig=raw.slice(dotIndex+1),expectedSig=createHmac(`sha256`,secret).update(value).digest(`base64url`),a=Buffer.from(providedSig),b=Buffer.from(expectedSig);return a.length!==b.length||!timingSafeEqual(a,b)?!1:value}function session(options){if(options.store===`cookie`)return cookieSession(options);let{secret,cookieName=`kick.sid`,maxAge=864e5,rolling=!1,saveUninitialized=!0,cookie:cookieOpts={}}=options,store=options.store??new MemoryStore,cookieDefaults={httpOnly:cookieOpts.httpOnly??!0,secure:cookieOpts.secure??process.env.NODE_ENV===`production`,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;signedCookie&&(sid=unsign(signedCookie,secret),sid&&(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),res.on(`finish`,async()=>{destroyed||(!isNew||saveUninitialized||Object.keys(currentData).length!==0)&&(await store.set(currentSid,currentData,maxAge),rolling&&!isNew&&store.touch&&await store.touch(currentSid,maxAge))}),rolling&&!isNew&&setCookie(res,cookieName,sign(currentSid,secret),cookieDefaults),next()}}const cookieLog=createLogger(`Session`);function sealer(secret,cookieName){let key=Buffer.from(hkdfSync(`sha256`,secret,`kick.session`,`cookie-store-v1`,32)),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;try{let raw=Buffer.from(value.slice(3),`base64url`);if(raw.length<29)return null;let decipher=createDecipheriv(`aes-256-gcm`,key,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:null}catch{return null}}}}function cookieSession(options){let{secret,cookieName=`kick.sid`,maxAge=864e5,rolling=!1,saveUninitialized=!0,cookie:cookieOpts={}}=options,{seal,open}=sealer(secret,cookieName),cookieDefaults={httpOnly:cookieOpts.httpOnly??!0,secure:cookieOpts.secure??process.env.NODE_ENV===`production`,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 existing=cookies[cookieName]?open(cookies[cookieName]):null,isNew=!existing,id=existing?.i??randomUUID(),destroyed=!1,written=existing?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{session};
11
+ import{createLogger}from"../../core/logger.mjs";import{r as registerDisposable}from"../../disposables-CJD_gWlA.mjs";import{t as isProduction}from"../../is-production-Dbm13WNL.mjs";import{a as setCookie,r as replaceCookie,t as parseCookieHeader}from"../../respond-Dc18G0X7.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}function session(options){if(options.store===`cookie`)return cookieSession(options);let{cookieName=`kick.sid`,maxAge=864e5,rolling=!1,saveUninitialized=!0,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),res.on(`finish`,async()=>{destroyed||(!isNew||saveUninitialized||Object.keys(currentData).length!==0)&&(await store.set(currentSid,currentData,maxAge),rolling&&!isNew&&store.touch&&await store.touch(currentSid,maxAge))}),!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 type { Request, Response, NextFunction } from 'express'\n\nimport { registerDisposable } from '../../core/disposables'\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 /** Secret used to sign the session cookie (required) */\n secret: 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 /** 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\nclass MemoryStore implements SessionStore {\n private readonly sessions = new Map<string, { data: SessionData; expires: number }>()\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 }\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 return null\n }\n return entry.data\n }\n\n async set(sid: string, data: SessionData, maxAge: number): Promise<void> {\n this.sessions.set(sid, { data, expires: Date.now() + maxAge })\n }\n\n async destroy(sid: string): Promise<void> {\n this.sessions.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 }\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 }\n }\n }\n}\n\n// ── Cookie Signing ────────────────────────────────────────────────────\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\nfunction unsign(signed: string, secret: string): string | 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 providedSig = raw.slice(dotIndex + 1)\n const expectedSig = createHmac('sha256', secret).update(value).digest('base64url')\n\n const a = Buffer.from(providedSig)\n const b = Buffer.from(expectedSig)\n\n if (a.length !== b.length || !timingSafeEqual(a, b)) {\n return false\n }\n\n return value\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 */\nexport function session(options: SessionOptions) {\n if (options.store === 'cookie') return cookieSession(options)\n const {\n secret,\n cookieName = 'kick.sid',\n maxAge = 86_400_000,\n rolling = false,\n saveUninitialized = true,\n cookie: cookieOpts = {},\n } = options\n const store = (options.store as SessionStore | undefined) ?? new MemoryStore()\n\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? process.env.NODE_ENV === 'production',\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\n // Attempt to recover existing session\n if (signedCookie) {\n sid = unsign(signedCookie, secret)\n if (sid) {\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 // Auto-save on response finish\n res.on('finish', async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n\n await store.set(currentSid, currentData, maxAge)\n\n if (rolling && !isNew) {\n if (store.touch) {\n await store.touch(currentSid, maxAge)\n }\n }\n })\n\n // Rolling: refresh cookie on every response\n if (rolling && !isNew) {\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/** AES-256-GCM, with the cookie name as associated data: `v1.<iv|tag|ciphertext>`. */\nfunction sealer(secret: string, cookieName: string) {\n const key = Buffer.from(hkdfSync('sha256', secret, 'kick.session', 'cookie-store-v1', 32))\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 /** The payload, or null for anything forged, altered, expired or malformed. */\n open(value: string): CookiePayload | null {\n if (!value.startsWith('v1.')) return null\n try {\n const raw = Buffer.from(value.slice(3), 'base64url')\n if (raw.length < 29) return null\n const decipher = createDecipheriv('aes-256-gcm', key, 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 : null\n } catch {\n return null\n }\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 secret,\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(secret, cookieName)\n const cookieDefaults = {\n httpOnly: cookieOpts.httpOnly ?? true,\n secure: cookieOpts.secure ?? process.env.NODE_ENV === 'production',\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 existing = cookies[cookieName] ? open(cookies[cookieName]) : 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 let written = existing ? 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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"}
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 type { Request, Response, NextFunction } from 'express'\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 /** 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 */\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 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 // Auto-save on response finish\n res.on('finish', async () => {\n if (destroyed) return\n if (isNew && !saveUninitialized && Object.keys(currentData).length === 0) return\n\n await store.set(currentSid, currentData, maxAge)\n\n if (rolling && !isNew) {\n if (store.touch) {\n await store.touch(currentSid, maxAge)\n }\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":"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"}
@@ -1,3 +1,3 @@
1
1
 
2
- import { f as SpaAdapter, m as resolveClientDir, p as SpaAdapterOptions } from "../../application-oIPzgjfk.mjs";
2
+ import { L as SpaAdapter, R as SpaAdapterOptions, z as resolveClientDir } from "../../adapter-BYdxuKiM.mjs";
3
3
  export { SpaAdapter, SpaAdapterOptions, resolveClientDir };