@geekmidas/constructs 10.0.0-alpha.99 → 10.0.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 (533) hide show
  1. package/CHANGELOG.md +437 -0
  2. package/README.md +193 -285
  3. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
  4. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
  5. package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
  6. package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
  7. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
  8. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
  9. package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
  10. package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
  11. package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
  12. package/dist/Construct-BWF5HxaM.mjs.map +1 -0
  13. package/dist/Construct-JlyQkBkv.d.cts +117 -0
  14. package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
  15. package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
  16. package/dist/Construct-TGIM_E4o.cjs.map +1 -0
  17. package/dist/Construct-pxwC6fDD.d.mts +117 -0
  18. package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
  19. package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
  20. package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
  21. package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
  22. package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
  23. package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
  24. package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
  25. package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
  26. package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
  27. package/dist/Queue-BL68oDJ-.d.mts +66 -0
  28. package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
  29. package/dist/Queue-DxJ6btRE.d.cts +66 -0
  30. package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
  31. package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
  32. package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
  33. package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
  34. package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
  35. package/dist/Topic-DJXoDeMP.d.cts +60 -0
  36. package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
  37. package/dist/Topic-DxWQBgMN.d.mts +60 -0
  38. package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
  39. package/dist/adaptors/aws.cjs +205 -355
  40. package/dist/adaptors/aws.cjs.map +1 -1
  41. package/dist/adaptors/aws.d.cts +48 -126
  42. package/dist/adaptors/aws.d.cts.map +1 -1
  43. package/dist/adaptors/aws.d.mts +49 -127
  44. package/dist/adaptors/aws.d.mts.map +1 -1
  45. package/dist/adaptors/aws.mjs +178 -325
  46. package/dist/adaptors/aws.mjs.map +1 -1
  47. package/dist/adaptors/hono.cjs +9 -3
  48. package/dist/adaptors/hono.d.cts +15 -7
  49. package/dist/adaptors/hono.d.cts.map +1 -1
  50. package/dist/adaptors/hono.d.mts +17 -9
  51. package/dist/adaptors/hono.d.mts.map +1 -1
  52. package/dist/adaptors/hono.mjs +9 -2
  53. package/dist/adaptors/testing.cjs +209 -831
  54. package/dist/adaptors/testing.cjs.map +1 -1
  55. package/dist/adaptors/testing.d.cts +55 -351
  56. package/dist/adaptors/testing.d.cts.map +1 -1
  57. package/dist/adaptors/testing.d.mts +53 -349
  58. package/dist/adaptors/testing.d.mts.map +1 -1
  59. package/dist/adaptors/testing.mjs +195 -798
  60. package/dist/adaptors/testing.mjs.map +1 -1
  61. package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
  62. package/dist/clone-I_WIpiFf.cjs.map +1 -0
  63. package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
  64. package/dist/clone-pdXxc0t3.mjs.map +1 -0
  65. package/dist/crons/index.cjs +66 -190
  66. package/dist/crons/index.cjs.map +1 -1
  67. package/dist/crons/index.d.cts +35 -70
  68. package/dist/crons/index.d.cts.map +1 -1
  69. package/dist/crons/index.d.mts +32 -70
  70. package/dist/crons/index.d.mts.map +1 -1
  71. package/dist/crons/index.mjs +63 -184
  72. package/dist/crons/index.mjs.map +1 -1
  73. package/dist/endpoints/index.cjs +761 -19
  74. package/dist/endpoints/index.cjs.map +1 -0
  75. package/dist/endpoints/index.d.cts +322 -22
  76. package/dist/endpoints/index.d.cts.map +1 -1
  77. package/dist/endpoints/index.d.mts +321 -22
  78. package/dist/endpoints/index.d.mts.map +1 -1
  79. package/dist/endpoints/index.mjs +751 -6
  80. package/dist/endpoints/index.mjs.map +1 -0
  81. package/dist/functions/index.cjs +5 -2
  82. package/dist/functions/index.d.cts +3 -3
  83. package/dist/functions/index.d.mts +3 -3
  84. package/dist/functions/index.mjs +5 -2
  85. package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
  86. package/dist/functions-EqTloHjo.mjs.map +1 -0
  87. package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
  88. package/dist/functions-SqtCDc9c.cjs.map +1 -0
  89. package/dist/index-C7iynzLI.d.mts +139 -0
  90. package/dist/index-C7iynzLI.d.mts.map +1 -0
  91. package/dist/index-D4dM_WDY.d.cts +142 -0
  92. package/dist/index-D4dM_WDY.d.cts.map +1 -0
  93. package/dist/index.cjs +3 -6
  94. package/dist/index.d.cts +4 -27
  95. package/dist/index.d.mts +4 -27
  96. package/dist/index.mjs +3 -3
  97. package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
  98. package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
  99. package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
  100. package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
  101. package/dist/monitors/index.cjs +49 -0
  102. package/dist/monitors/index.cjs.map +1 -0
  103. package/dist/monitors/index.d.cts +45 -0
  104. package/dist/monitors/index.d.cts.map +1 -0
  105. package/dist/monitors/index.d.mts +45 -0
  106. package/dist/monitors/index.d.mts.map +1 -0
  107. package/dist/monitors/index.mjs +48 -0
  108. package/dist/monitors/index.mjs.map +1 -0
  109. package/dist/processAudits-BJZT5gmy.cjs +92 -0
  110. package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
  111. package/dist/processAudits-CwyaaSQc.mjs +80 -0
  112. package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
  113. package/dist/publisher-BZgcrVPy.cjs +53 -0
  114. package/dist/publisher-BZgcrVPy.cjs.map +1 -0
  115. package/dist/publisher-CnpeMv-r.mjs +41 -0
  116. package/dist/publisher-CnpeMv-r.mjs.map +1 -0
  117. package/dist/queue/index.cjs +114 -6
  118. package/dist/queue/index.cjs.map +1 -0
  119. package/dist/queue/index.d.cts +45 -3
  120. package/dist/queue/index.d.cts.map +1 -0
  121. package/dist/queue/index.d.mts +44 -3
  122. package/dist/queue/index.d.mts.map +1 -0
  123. package/dist/queue/index.mjs +112 -3
  124. package/dist/queue/index.mjs.map +1 -0
  125. package/dist/subscribers/index.cjs +80 -111
  126. package/dist/subscribers/index.cjs.map +1 -1
  127. package/dist/subscribers/index.d.cts +43 -46
  128. package/dist/subscribers/index.d.cts.map +1 -1
  129. package/dist/subscribers/index.d.mts +42 -46
  130. package/dist/subscribers/index.d.mts.map +1 -1
  131. package/dist/subscribers/index.mjs +78 -108
  132. package/dist/subscribers/index.mjs.map +1 -1
  133. package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
  134. package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
  135. package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
  136. package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
  137. package/dist/topic/index.cjs +91 -3
  138. package/dist/topic/index.cjs.map +1 -0
  139. package/dist/topic/index.d.cts +32 -2
  140. package/dist/topic/index.d.cts.map +1 -0
  141. package/dist/topic/index.d.mts +32 -2
  142. package/dist/topic/index.d.mts.map +1 -0
  143. package/dist/topic/index.mjs +89 -2
  144. package/dist/topic/index.mjs.map +1 -0
  145. package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
  146. package/dist/types-BdAaYDvd.d.cts.map +1 -0
  147. package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
  148. package/dist/types-DNngH0fX.d.mts.map +1 -0
  149. package/dist/types.d.cts +1 -1
  150. package/dist/types.d.mts +1 -1
  151. package/dist/types.mjs +0 -1
  152. package/package.json +55 -223
  153. package/src/Construct.ts +209 -0
  154. package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
  155. package/src/__benchmarks__/endpoint.bench.ts +494 -0
  156. package/src/__benchmarks__/fixtures.ts +241 -0
  157. package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
  158. package/src/__benchmarks__/hono-server.bench.ts +249 -0
  159. package/src/__benchmarks__/response-builder.bench.ts +428 -0
  160. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
  161. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
  162. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
  163. package/src/__tests__/Construct.environment.spec.ts +704 -0
  164. package/src/__tests__/builder-reuse.spec.ts +587 -0
  165. package/src/__tests__/monitor.spec.ts +636 -0
  166. package/src/__tests__/publisher.setting.spec.ts +508 -0
  167. package/src/__tests__/publisher.spec.ts +452 -0
  168. package/src/adaptors/aws.ts +6 -0
  169. package/src/adaptors/hono.ts +1 -0
  170. package/src/adaptors/testing.ts +11 -0
  171. package/src/clone.ts +38 -0
  172. package/src/crons/AWSScheduledFunction.ts +73 -0
  173. package/src/crons/Cron.ts +149 -0
  174. package/src/crons/CronBuilder.ts +261 -0
  175. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
  176. package/src/crons/__tests__/Cron.spec.ts +472 -0
  177. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
  178. package/src/crons/index.ts +12 -0
  179. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
  180. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
  181. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
  182. package/src/endpoints/Authorizer.ts +152 -0
  183. package/src/endpoints/Endpoint.ts +1287 -0
  184. package/src/endpoints/EndpointBuilder.ts +749 -0
  185. package/src/endpoints/EndpointFactory.ts +1179 -0
  186. package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
  187. package/src/endpoints/MswEndpointAdaptor.ts +226 -0
  188. package/src/endpoints/TestEndpointAdaptor.ts +466 -0
  189. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
  190. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
  191. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
  192. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
  193. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
  194. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
  195. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
  196. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
  197. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
  198. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
  199. package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
  200. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
  201. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
  202. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
  203. package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
  204. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
  205. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
  206. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
  207. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
  208. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
  209. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
  210. package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
  211. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
  212. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
  213. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
  214. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
  215. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
  216. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
  217. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
  218. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
  219. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
  220. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
  221. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
  222. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
  223. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
  224. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
  225. package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
  226. package/src/endpoints/__tests__/helpers.spec.ts +37 -0
  227. package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
  228. package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
  229. package/src/endpoints/audit.ts +87 -0
  230. package/src/endpoints/helpers.ts +98 -0
  231. package/src/endpoints/index.ts +42 -0
  232. package/src/endpoints/lazyAccessors.ts +241 -0
  233. package/src/endpoints/parseHonoQuery.ts +16 -0
  234. package/src/endpoints/parseQueryParams.ts +32 -0
  235. package/src/endpoints/processAudits.ts +371 -0
  236. package/src/endpoints/rls.ts +67 -0
  237. package/src/functions/AWSLambdaFunction.ts +374 -0
  238. package/src/functions/BaseFunctionBuilder.ts +212 -0
  239. package/src/functions/Function.ts +238 -0
  240. package/src/functions/FunctionBuilder.ts +381 -0
  241. package/src/functions/FunctionExecutionWrapper.ts +216 -0
  242. package/src/functions/TestFunctionAdaptor.ts +252 -0
  243. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
  244. package/src/functions/__tests__/Function.audits.spec.ts +393 -0
  245. package/src/functions/__tests__/Function.spec.ts +477 -0
  246. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
  247. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
  248. package/src/functions/index.ts +12 -0
  249. package/src/index.ts +29 -0
  250. package/src/monitor.ts +145 -0
  251. package/src/monitors/heartbeat.ts +86 -0
  252. package/src/monitors/index.ts +6 -0
  253. package/src/publisher.ts +93 -0
  254. package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
  255. package/src/queue/Queue.ts +128 -0
  256. package/src/queue/QueueBuilder.ts +115 -0
  257. package/src/queue/TestQueueAdaptor.ts +63 -0
  258. package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
  259. package/src/queue/index.ts +12 -0
  260. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
  261. package/src/subscribers/Subscriber.ts +117 -0
  262. package/src/subscribers/SubscriberBuilder.ts +183 -0
  263. package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
  264. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
  265. package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
  266. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
  267. package/src/subscribers/index.ts +6 -0
  268. package/src/telemetry.ts +103 -0
  269. package/src/topic/Topic.ts +103 -0
  270. package/src/topic/TopicBuilder.ts +53 -0
  271. package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
  272. package/src/topic/index.ts +11 -0
  273. package/src/types.ts +13 -0
  274. package/test.ts +91 -0
  275. package/tsconfig.json +9 -0
  276. package/tsdown.config.ts +35 -0
  277. package/dist/Construct-B1vGBPme.mjs.map +0 -1
  278. package/dist/Construct-BQALFCh2.d.cts +0 -230
  279. package/dist/Construct-BQALFCh2.d.cts.map +0 -1
  280. package/dist/Construct-DUSXuTHP.cjs.map +0 -1
  281. package/dist/Construct-QXnl3VqT.d.mts +0 -230
  282. package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
  283. package/dist/Cron-DI3nKoic.d.cts +0 -45
  284. package/dist/Cron-DI3nKoic.d.cts.map +0 -1
  285. package/dist/Cron-uYAHPnp7.d.mts +0 -45
  286. package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
  287. package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
  288. package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
  289. package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
  290. package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
  291. package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
  292. package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
  293. package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
  294. package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
  295. package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
  296. package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
  297. package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
  298. package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
  299. package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
  300. package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
  301. package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
  302. package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
  303. package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
  304. package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
  305. package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
  306. package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
  307. package/dist/Function-DuqGcbOI.d.mts +0 -76
  308. package/dist/Function-DuqGcbOI.d.mts.map +0 -1
  309. package/dist/Function-Pu-1kKZz.d.cts +0 -76
  310. package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
  311. package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
  312. package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
  313. package/dist/Queue-A3wfD0it.cjs +0 -109
  314. package/dist/Queue-A3wfD0it.cjs.map +0 -1
  315. package/dist/Queue-D6USGS4q.mjs +0 -104
  316. package/dist/Queue-D6USGS4q.mjs.map +0 -1
  317. package/dist/Queue-DlsHRzUp.d.mts +0 -105
  318. package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
  319. package/dist/Queue-HPyi0e1i.d.cts +0 -105
  320. package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
  321. package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
  322. package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
  323. package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
  324. package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
  325. package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
  326. package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
  327. package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
  328. package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
  329. package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
  330. package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
  331. package/dist/Subscriber-CtN9R48-.d.mts +0 -61
  332. package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
  333. package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
  334. package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
  335. package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
  336. package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
  337. package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
  338. package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
  339. package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
  340. package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
  341. package/dist/Topic-D74b5cgs.mjs +0 -99
  342. package/dist/Topic-D74b5cgs.mjs.map +0 -1
  343. package/dist/Topic-GHxcU8AG.cjs +0 -104
  344. package/dist/Topic-GHxcU8AG.cjs.map +0 -1
  345. package/dist/auth-BMCJN30Y.d.cts +0 -268
  346. package/dist/auth-BMCJN30Y.d.cts.map +0 -1
  347. package/dist/auth-CcuceLYo.d.mts +0 -268
  348. package/dist/auth-CcuceLYo.d.mts.map +0 -1
  349. package/dist/auth.cjs +0 -433
  350. package/dist/auth.cjs.map +0 -1
  351. package/dist/auth.d.cts +0 -2
  352. package/dist/auth.d.mts +0 -2
  353. package/dist/auth.mjs +0 -426
  354. package/dist/auth.mjs.map +0 -1
  355. package/dist/cache-CXh6GIgb.d.mts +0 -44
  356. package/dist/cache-CXh6GIgb.d.mts.map +0 -1
  357. package/dist/cache-DnGDGly3.d.cts +0 -44
  358. package/dist/cache-DnGDGly3.d.cts.map +0 -1
  359. package/dist/cache.cjs +0 -69
  360. package/dist/cache.cjs.map +0 -1
  361. package/dist/cache.d.cts +0 -2
  362. package/dist/cache.d.mts +0 -2
  363. package/dist/cache.mjs +0 -68
  364. package/dist/cache.mjs.map +0 -1
  365. package/dist/cipher-C1lEFX63.mjs +0 -225
  366. package/dist/cipher-C1lEFX63.mjs.map +0 -1
  367. package/dist/cipher-CVxfwLjk.cjs +0 -332
  368. package/dist/cipher-CVxfwLjk.cjs.map +0 -1
  369. package/dist/clone-EKNovYHu.mjs.map +0 -1
  370. package/dist/clone-UGJpvQnL.cjs.map +0 -1
  371. package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
  372. package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
  373. package/dist/construct-interface-DluK3_da.d.mts +0 -162
  374. package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
  375. package/dist/construct-interface.cjs +0 -114
  376. package/dist/construct-interface.cjs.map +0 -1
  377. package/dist/construct-interface.d.cts +0 -2
  378. package/dist/construct-interface.d.mts +0 -2
  379. package/dist/construct-interface.mjs +0 -107
  380. package/dist/construct-interface.mjs.map +0 -1
  381. package/dist/credential.cjs +0 -156
  382. package/dist/credential.cjs.map +0 -1
  383. package/dist/credential.d.cts +0 -86
  384. package/dist/credential.d.cts.map +0 -1
  385. package/dist/credential.d.mts +0 -86
  386. package/dist/credential.d.mts.map +0 -1
  387. package/dist/credential.mjs +0 -152
  388. package/dist/credential.mjs.map +0 -1
  389. package/dist/database/kysely.cjs +0 -4
  390. package/dist/database/kysely.d.cts +0 -2
  391. package/dist/database/kysely.d.mts +0 -2
  392. package/dist/database/kysely.mjs +0 -2
  393. package/dist/email.cjs +0 -72
  394. package/dist/email.cjs.map +0 -1
  395. package/dist/email.d.cts +0 -46
  396. package/dist/email.d.cts.map +0 -1
  397. package/dist/email.d.mts +0 -46
  398. package/dist/email.d.mts.map +0 -1
  399. package/dist/email.mjs +0 -71
  400. package/dist/email.mjs.map +0 -1
  401. package/dist/encryption.cjs +0 -96
  402. package/dist/encryption.cjs.map +0 -1
  403. package/dist/encryption.d.cts +0 -117
  404. package/dist/encryption.d.cts.map +0 -1
  405. package/dist/encryption.d.mts +0 -117
  406. package/dist/encryption.d.mts.map +0 -1
  407. package/dist/encryption.mjs +0 -83
  408. package/dist/encryption.mjs.map +0 -1
  409. package/dist/external-api-MJ8id87V.d.mts +0 -105
  410. package/dist/external-api-MJ8id87V.d.mts.map +0 -1
  411. package/dist/external-api-O107yzZJ.d.cts +0 -105
  412. package/dist/external-api-O107yzZJ.d.cts.map +0 -1
  413. package/dist/external-api.cjs +0 -142
  414. package/dist/external-api.cjs.map +0 -1
  415. package/dist/external-api.d.cts +0 -2
  416. package/dist/external-api.d.mts +0 -2
  417. package/dist/external-api.mjs +0 -139
  418. package/dist/external-api.mjs.map +0 -1
  419. package/dist/file-server.cjs +0 -186
  420. package/dist/file-server.cjs.map +0 -1
  421. package/dist/file-server.d.cts +0 -152
  422. package/dist/file-server.d.cts.map +0 -1
  423. package/dist/file-server.d.mts +0 -152
  424. package/dist/file-server.d.mts.map +0 -1
  425. package/dist/file-server.mjs +0 -184
  426. package/dist/file-server.mjs.map +0 -1
  427. package/dist/functions-BFizikJU.mjs.map +0 -1
  428. package/dist/functions-CfzJG9hK.cjs.map +0 -1
  429. package/dist/index-BuzRvKOQ.d.cts +0 -115
  430. package/dist/index-BuzRvKOQ.d.cts.map +0 -1
  431. package/dist/index-CTkKOer4.d.mts +0 -115
  432. package/dist/index-CTkKOer4.d.mts.map +0 -1
  433. package/dist/index-CeEtxDmK.d.cts +0 -79
  434. package/dist/index-CeEtxDmK.d.cts.map +0 -1
  435. package/dist/index-CeEtxDmK.d.mts +0 -79
  436. package/dist/index-CeEtxDmK.d.mts.map +0 -1
  437. package/dist/index.d.cts.map +0 -1
  438. package/dist/index.d.mts.map +0 -1
  439. package/dist/kms-B-Hm3d5r.cjs +0 -85
  440. package/dist/kms-B-Hm3d5r.cjs.map +0 -1
  441. package/dist/kms-BdUlMJEZ.mjs +0 -85
  442. package/dist/kms-BdUlMJEZ.mjs.map +0 -1
  443. package/dist/kysely-Bii4l6eP.mjs +0 -370
  444. package/dist/kysely-Bii4l6eP.mjs.map +0 -1
  445. package/dist/kysely-CO_Dk43W.cjs +0 -383
  446. package/dist/kysely-CO_Dk43W.cjs.map +0 -1
  447. package/dist/kysely-D0bpzgPs.d.cts +0 -175
  448. package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
  449. package/dist/kysely-DUqC3Ie0.d.mts +0 -175
  450. package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
  451. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
  452. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
  453. package/dist/lazyAccessors-CFanua0O.mjs +0 -174
  454. package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
  455. package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
  456. package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
  457. package/dist/mobile-app.cjs +0 -73
  458. package/dist/mobile-app.cjs.map +0 -1
  459. package/dist/mobile-app.d.cts +0 -61
  460. package/dist/mobile-app.d.cts.map +0 -1
  461. package/dist/mobile-app.d.mts +0 -61
  462. package/dist/mobile-app.d.mts.map +0 -1
  463. package/dist/mobile-app.mjs +0 -72
  464. package/dist/mobile-app.mjs.map +0 -1
  465. package/dist/object-storage.cjs +0 -56
  466. package/dist/object-storage.cjs.map +0 -1
  467. package/dist/object-storage.d.cts +0 -32
  468. package/dist/object-storage.d.cts.map +0 -1
  469. package/dist/object-storage.d.mts +0 -32
  470. package/dist/object-storage.d.mts.map +0 -1
  471. package/dist/object-storage.mjs +0 -55
  472. package/dist/object-storage.mjs.map +0 -1
  473. package/dist/processAudits-BRRVVHUB.mjs +0 -131
  474. package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
  475. package/dist/processAudits-DasOZjPl.cjs +0 -154
  476. package/dist/processAudits-DasOZjPl.cjs.map +0 -1
  477. package/dist/rest-api.cjs +0 -216
  478. package/dist/rest-api.cjs.map +0 -1
  479. package/dist/rest-api.d.cts +0 -241
  480. package/dist/rest-api.d.cts.map +0 -1
  481. package/dist/rest-api.d.mts +0 -241
  482. package/dist/rest-api.d.mts.map +0 -1
  483. package/dist/rest-api.mjs +0 -215
  484. package/dist/rest-api.mjs.map +0 -1
  485. package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
  486. package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
  487. package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
  488. package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
  489. package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
  490. package/dist/shutdown-BMJmAhSt.cjs +0 -38
  491. package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
  492. package/dist/shutdown-C7xa8x9S.mjs +0 -27
  493. package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
  494. package/dist/site.cjs +0 -74
  495. package/dist/site.cjs.map +0 -1
  496. package/dist/site.d.cts +0 -104
  497. package/dist/site.d.cts.map +0 -1
  498. package/dist/site.d.mts +0 -104
  499. package/dist/site.d.mts.map +0 -1
  500. package/dist/site.mjs +0 -73
  501. package/dist/site.mjs.map +0 -1
  502. package/dist/stages-BSCF19o2.d.cts +0 -56
  503. package/dist/stages-BSCF19o2.d.cts.map +0 -1
  504. package/dist/stages-BSCF19o2.d.mts +0 -56
  505. package/dist/stages-BSCF19o2.d.mts.map +0 -1
  506. package/dist/surfaceEnv-CNimK76p.cjs +0 -56
  507. package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
  508. package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
  509. package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
  510. package/dist/telemetry-B48RLjyk.d.cts +0 -40
  511. package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
  512. package/dist/telemetry-DRtT1_0A.d.mts +0 -40
  513. package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
  514. package/dist/telemetry.cjs +0 -56
  515. package/dist/telemetry.cjs.map +0 -1
  516. package/dist/telemetry.d.cts +0 -2
  517. package/dist/telemetry.d.mts +0 -2
  518. package/dist/telemetry.mjs +0 -55
  519. package/dist/telemetry.mjs.map +0 -1
  520. package/dist/tracing-CxaZ98IB.mjs +0 -110
  521. package/dist/tracing-CxaZ98IB.mjs.map +0 -1
  522. package/dist/tracing-DPMidF_r.cjs +0 -127
  523. package/dist/tracing-DPMidF_r.cjs.map +0 -1
  524. package/dist/types-DMuSQeLL.d.cts.map +0 -1
  525. package/dist/types-DMuSQeLL.d.mts.map +0 -1
  526. package/dist/worker.cjs +0 -191
  527. package/dist/worker.cjs.map +0 -1
  528. package/dist/worker.d.cts +0 -171
  529. package/dist/worker.d.cts.map +0 -1
  530. package/dist/worker.d.mts +0 -171
  531. package/dist/worker.d.mts.map +0 -1
  532. package/dist/worker.mjs +0 -190
  533. package/dist/worker.mjs.map +0 -1
@@ -0,0 +1,249 @@
1
+ import { LogLevel } from '@geekmidas/logger';
2
+ import { ConsoleLogger } from '@geekmidas/logger/console';
3
+ import { Hono } from 'hono';
4
+ import { bench, describe } from 'vitest';
5
+ import { z } from 'zod';
6
+ import { e } from '../endpoints';
7
+ import type { Endpoint } from '../endpoints/Endpoint';
8
+ import { HonoEndpoint } from '../endpoints/HonoEndpointAdaptor';
9
+
10
+ /**
11
+ * E2E benchmarks with Hono app.request() - tests the full request/response cycle
12
+ * through the Hono framework without network overhead.
13
+ */
14
+
15
+ // Silent logger for benchmarks - no console output
16
+ const silentLogger = new ConsoleLogger({}, LogLevel.Silent);
17
+ const api = e.logger(silentLogger);
18
+
19
+ // Helper to create a Hono app from endpoints
20
+ function createApp(
21
+ endpoints: Endpoint<any, any, any, any, any, any, any, any, any, any, any>[],
22
+ ): Hono {
23
+ const app = new Hono();
24
+
25
+ // Silent error handler for benchmarks
26
+ app.onError((err, c) => {
27
+ return c.json({ error: err.message }, 500);
28
+ });
29
+
30
+ // Add routes using a mock service discovery
31
+ const mockServiceDiscovery = {
32
+ register: async () => ({}),
33
+ } as any;
34
+
35
+ HonoEndpoint.addRoutes(endpoints, mockServiceDiscovery, app, {
36
+ docsPath: false,
37
+ });
38
+
39
+ return app;
40
+ }
41
+
42
+ describe('Hono E2E - Simple Endpoints', () => {
43
+ const healthEndpoint = api
44
+ .get('/health')
45
+ .handle(async () => ({ status: 'ok' }));
46
+
47
+ const app = createApp([healthEndpoint]);
48
+
49
+ bench('GET /health - minimal response', async () => {
50
+ await app.request('/health');
51
+ });
52
+ });
53
+
54
+ describe('Hono E2E - CRUD Operations', () => {
55
+ const endpoints = [
56
+ api
57
+ .get('/users')
58
+ .output(z.array(z.object({ id: z.string(), name: z.string() })))
59
+ .handle(async () => [
60
+ { id: '1', name: 'Alice' },
61
+ { id: '2', name: 'Bob' },
62
+ ]),
63
+
64
+ api
65
+ .get('/users/:id')
66
+ .params(z.object({ id: z.string() }))
67
+ .output(z.object({ id: z.string(), name: z.string() }))
68
+ .handle(async ({ params }) => ({ id: params.id, name: 'User' })),
69
+
70
+ api
71
+ .post('/users')
72
+ .body(z.object({ name: z.string(), email: z.string().email() }))
73
+ .output(z.object({ id: z.string() }))
74
+ .handle(async () => ({ id: crypto.randomUUID() })),
75
+
76
+ api
77
+ .put('/users/:id')
78
+ .params(z.object({ id: z.string() }))
79
+ .body(z.object({ name: z.string() }))
80
+ .output(z.object({ success: z.boolean() }))
81
+ .handle(async () => ({ success: true })),
82
+
83
+ api
84
+ .delete('/users/:id')
85
+ .params(z.object({ id: z.string() }))
86
+ .output(z.object({ deleted: z.boolean() }))
87
+ .handle(async () => ({ deleted: true })),
88
+ ];
89
+
90
+ const app = createApp(endpoints);
91
+
92
+ bench('GET /users - list response', async () => {
93
+ await app.request('/users');
94
+ });
95
+
96
+ bench('GET /users/:id - path params', async () => {
97
+ await app.request('/users/123');
98
+ });
99
+
100
+ bench('POST /users - body validation', async () => {
101
+ await app.request('/users', {
102
+ method: 'POST',
103
+ headers: { 'Content-Type': 'application/json' },
104
+ body: JSON.stringify({ name: 'Test', email: 'test@example.com' }),
105
+ });
106
+ });
107
+
108
+ bench('PUT /users/:id - params + body', async () => {
109
+ await app.request('/users/123', {
110
+ method: 'PUT',
111
+ headers: { 'Content-Type': 'application/json' },
112
+ body: JSON.stringify({ name: 'Updated' }),
113
+ });
114
+ });
115
+
116
+ bench('DELETE /users/:id - params only', async () => {
117
+ await app.request('/users/123', { method: 'DELETE' });
118
+ });
119
+ });
120
+
121
+ describe('Hono E2E - Complex Validation', () => {
122
+ const complexEndpoint = api
123
+ .post('/orders')
124
+ .body(
125
+ z.object({
126
+ customer: z.object({
127
+ name: z.string(),
128
+ email: z.string().email(),
129
+ address: z.object({
130
+ street: z.string(),
131
+ city: z.string(),
132
+ zip: z.string(),
133
+ }),
134
+ }),
135
+ items: z.array(
136
+ z.object({
137
+ productId: z.string(),
138
+ quantity: z.number().int().positive(),
139
+ price: z.number().positive(),
140
+ }),
141
+ ),
142
+ payment: z.object({
143
+ method: z.enum(['credit_card', 'paypal', 'bank_transfer']),
144
+ details: z.record(z.string(), z.string()),
145
+ }),
146
+ }),
147
+ )
148
+ .output(z.object({ orderId: z.string(), total: z.number() }))
149
+ .handle(async () => ({ orderId: 'order-123', total: 99.99 }));
150
+
151
+ const app = createApp([complexEndpoint]);
152
+
153
+ bench('POST /orders - complex nested body', async () => {
154
+ await app.request('/orders', {
155
+ method: 'POST',
156
+ headers: { 'Content-Type': 'application/json' },
157
+ body: JSON.stringify({
158
+ customer: {
159
+ name: 'John Doe',
160
+ email: 'john@example.com',
161
+ address: {
162
+ street: '123 Main St',
163
+ city: 'Boston',
164
+ zip: '02101',
165
+ },
166
+ },
167
+ items: [
168
+ { productId: 'prod-1', quantity: 2, price: 29.99 },
169
+ { productId: 'prod-2', quantity: 1, price: 39.99 },
170
+ ],
171
+ payment: {
172
+ method: 'credit_card',
173
+ details: { last4: '4242' },
174
+ },
175
+ }),
176
+ });
177
+ });
178
+ });
179
+
180
+ describe('Hono E2E - Query Parameters', () => {
181
+ const searchEndpoint = api
182
+ .get('/search')
183
+ .query(
184
+ z.object({
185
+ q: z.string(),
186
+ page: z.coerce.number().default(1),
187
+ limit: z.coerce.number().default(10),
188
+ sort: z.enum(['asc', 'desc']).optional(),
189
+ filters: z.string().optional(),
190
+ }),
191
+ )
192
+ .output(
193
+ z.object({
194
+ results: z.array(z.unknown()),
195
+ total: z.number(),
196
+ page: z.number(),
197
+ }),
198
+ )
199
+ .handle(async ({ query }) => ({
200
+ results: [],
201
+ total: 0,
202
+ page: query.page,
203
+ }));
204
+
205
+ const app = createApp([searchEndpoint]);
206
+
207
+ bench('GET /search - with query params', async () => {
208
+ await app.request('/search?q=test&page=2&limit=20&sort=desc');
209
+ });
210
+ });
211
+
212
+ describe('Hono E2E - Concurrent Requests', () => {
213
+ const endpoints = [
214
+ api.get('/health').handle(async () => ({ status: 'ok' })),
215
+ api.get('/users').handle(async () => [{ id: '1' }]),
216
+ api
217
+ .get('/users/:id')
218
+ .params(z.object({ id: z.string() }))
219
+ .handle(async () => ({ id: '1' })),
220
+ ];
221
+
222
+ const app = createApp(endpoints);
223
+
224
+ bench('10 concurrent requests', async () => {
225
+ await Promise.all([
226
+ app.request('/health'),
227
+ app.request('/users'),
228
+ app.request('/users/1'),
229
+ app.request('/users/2'),
230
+ app.request('/users/3'),
231
+ app.request('/health'),
232
+ app.request('/users'),
233
+ app.request('/users/4'),
234
+ app.request('/users/5'),
235
+ app.request('/health'),
236
+ ]);
237
+ });
238
+
239
+ bench('50 concurrent requests', async () => {
240
+ const requests = Array.from({ length: 50 }, (_, i) =>
241
+ i % 3 === 0
242
+ ? app.request('/health')
243
+ : i % 3 === 1
244
+ ? app.request('/users')
245
+ : app.request(`/users/${i}`),
246
+ );
247
+ await Promise.all(requests);
248
+ });
249
+ });
@@ -0,0 +1,428 @@
1
+ /**
2
+ * Benchmarks for ResponseBuilder and context creation overhead
3
+ *
4
+ * Run with: pnpm bench packages/constructs/src/__benchmarks__/response-builder.bench.ts
5
+ */
6
+ import { bench, describe } from 'vitest';
7
+ import { z } from 'zod';
8
+ import { Endpoint, ResponseBuilder } from '../endpoints/Endpoint';
9
+ import {
10
+ createHonoCookies,
11
+ createHonoHeaders,
12
+ } from '../endpoints/lazyAccessors';
13
+
14
+ // =============================================================================
15
+ // ResponseBuilder Overhead
16
+ // =============================================================================
17
+
18
+ describe('ResponseBuilder Creation', () => {
19
+ bench('new ResponseBuilder()', () => {
20
+ const rb = new ResponseBuilder();
21
+ rb.getMetadata();
22
+ });
23
+
24
+ bench('stub object (current minimal approach)', () => {
25
+ const stub = { getMetadata: () => ({}) };
26
+ stub.getMetadata();
27
+ });
28
+
29
+ // Shared constant stub - zero allocation
30
+ const SHARED_STUB = { getMetadata: () => ({}) };
31
+ bench('shared constant stub', () => {
32
+ SHARED_STUB.getMetadata();
33
+ });
34
+ });
35
+
36
+ describe('ResponseBuilder Usage', () => {
37
+ bench('unused - just create and get metadata', () => {
38
+ const rb = new ResponseBuilder();
39
+ rb.getMetadata();
40
+ });
41
+
42
+ bench('set 1 header', () => {
43
+ const rb = new ResponseBuilder();
44
+ rb.header('X-Request-Id', '123');
45
+ rb.getMetadata();
46
+ });
47
+
48
+ bench('set 3 headers', () => {
49
+ const rb = new ResponseBuilder();
50
+ rb.header('X-Request-Id', '123')
51
+ .header('X-Correlation-Id', 'abc')
52
+ .header('Cache-Control', 'no-cache');
53
+ rb.getMetadata();
54
+ });
55
+
56
+ bench('set 1 cookie', () => {
57
+ const rb = new ResponseBuilder();
58
+ rb.cookie('session', 'abc123', { httpOnly: true, secure: true });
59
+ rb.getMetadata();
60
+ });
61
+
62
+ bench('full usage (status + 2 headers + 2 cookies)', () => {
63
+ const rb = new ResponseBuilder();
64
+ rb.status(201)
65
+ .header('Location', '/users/123')
66
+ .header('X-Request-Id', 'req-123')
67
+ .cookie('session', 'abc', { httpOnly: true })
68
+ .cookie('csrf', 'xyz');
69
+ rb.getMetadata();
70
+ });
71
+
72
+ bench('send() with data', () => {
73
+ const rb = new ResponseBuilder();
74
+ rb.send({ id: '123', name: 'Test' });
75
+ });
76
+ });
77
+
78
+ // =============================================================================
79
+ // Header/Cookie Parsing Overhead
80
+ // =============================================================================
81
+
82
+ const SAMPLE_HEADERS: Record<string, string> = {
83
+ 'content-type': 'application/json',
84
+ authorization: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.test',
85
+ 'user-agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)',
86
+ accept: 'application/json, text/plain, */*',
87
+ 'accept-language': 'en-US,en;q=0.9',
88
+ 'accept-encoding': 'gzip, deflate, br',
89
+ 'cache-control': 'no-cache',
90
+ 'x-request-id': 'req-123-abc-456',
91
+ 'x-forwarded-for': '192.168.1.1',
92
+ 'x-forwarded-proto': 'https',
93
+ };
94
+
95
+ const SAMPLE_COOKIE =
96
+ 'session=abc123; csrf=xyz789; theme=dark; lang=en; _ga=GA1.2.123456789; _gid=GA1.2.987654321';
97
+
98
+ describe('Header Parsing (Endpoint.createHeaders)', () => {
99
+ bench('parse 10 headers (typical request)', () => {
100
+ const headerFn = Endpoint.createHeaders(SAMPLE_HEADERS);
101
+ headerFn('authorization');
102
+ });
103
+
104
+ bench('parse 10 headers + access 3 headers', () => {
105
+ const headerFn = Endpoint.createHeaders(SAMPLE_HEADERS);
106
+ headerFn('authorization');
107
+ headerFn('content-type');
108
+ headerFn('x-request-id');
109
+ });
110
+
111
+ bench('parse empty headers', () => {
112
+ const headerFn = Endpoint.createHeaders({});
113
+ headerFn('authorization');
114
+ });
115
+
116
+ // Lazy parsing alternative
117
+ bench('lazy header access (no upfront parsing)', () => {
118
+ const headers = SAMPLE_HEADERS;
119
+ const lazyHeaderFn = (key?: string) => {
120
+ if (!key) return headers;
121
+ return headers[key.toLowerCase()];
122
+ };
123
+ lazyHeaderFn('authorization');
124
+ });
125
+ });
126
+
127
+ describe('Cookie Parsing (Endpoint.createCookies)', () => {
128
+ bench('parse 6 cookies (typical request)', () => {
129
+ const cookieFn = Endpoint.createCookies(SAMPLE_COOKIE);
130
+ cookieFn('session');
131
+ });
132
+
133
+ bench('parse 6 cookies + access 2 cookies', () => {
134
+ const cookieFn = Endpoint.createCookies(SAMPLE_COOKIE);
135
+ cookieFn('session');
136
+ cookieFn('csrf');
137
+ });
138
+
139
+ bench('parse empty/undefined cookies', () => {
140
+ const cookieFn = Endpoint.createCookies(undefined);
141
+ cookieFn('session');
142
+ });
143
+
144
+ // Lazy parsing alternative
145
+ bench('lazy cookie access (parse on demand)', () => {
146
+ let parsed: Map<string, string> | null = null;
147
+ const lazyCookieFn = (name?: string) => {
148
+ if (!parsed) {
149
+ parsed = new Map();
150
+ for (const part of SAMPLE_COOKIE.split(';')) {
151
+ const [k, v] = part.trim().split('=');
152
+ if (k && v) parsed.set(k, v);
153
+ }
154
+ }
155
+ if (!name) {
156
+ const obj: Record<string, string> = {};
157
+ for (const [k, v] of parsed) obj[k] = v;
158
+ return obj;
159
+ }
160
+ return parsed.get(name);
161
+ };
162
+ lazyCookieFn('session');
163
+ });
164
+ });
165
+
166
+ // =============================================================================
167
+ // Zod Validation Overhead
168
+ // =============================================================================
169
+
170
+ const simpleSchema = z.object({ message: z.literal('pong') });
171
+ const mediumSchema = z.object({
172
+ id: z.string(),
173
+ name: z.string(),
174
+ email: z.string().email(),
175
+ createdAt: z.string(),
176
+ });
177
+ const complexSchema = z.object({
178
+ user: z.object({
179
+ id: z.string(),
180
+ name: z.string(),
181
+ email: z.string().email(),
182
+ profile: z.object({
183
+ bio: z.string().optional(),
184
+ avatar: z.string().url().optional(),
185
+ }),
186
+ }),
187
+ items: z.array(
188
+ z.object({
189
+ id: z.string(),
190
+ name: z.string(),
191
+ quantity: z.number().int().positive(),
192
+ }),
193
+ ),
194
+ metadata: z.record(z.string(), z.string()),
195
+ });
196
+
197
+ const simpleData = { message: 'pong' as const };
198
+ const mediumData = {
199
+ id: '123',
200
+ name: 'Test User',
201
+ email: 'test@example.com',
202
+ createdAt: '2024-01-01T00:00:00Z',
203
+ };
204
+ const complexData = {
205
+ user: {
206
+ id: '123',
207
+ name: 'Test',
208
+ email: 'test@example.com',
209
+ profile: { bio: 'Hello', avatar: 'https://example.com/avatar.jpg' },
210
+ },
211
+ items: [
212
+ { id: '1', name: 'Item 1', quantity: 2 },
213
+ { id: '2', name: 'Item 2', quantity: 5 },
214
+ ],
215
+ metadata: { source: 'api', version: '1.0' },
216
+ };
217
+
218
+ describe('Zod Output Validation', () => {
219
+ bench('simple schema (literal)', () => {
220
+ simpleSchema.parse(simpleData);
221
+ });
222
+
223
+ bench('medium schema (4 fields)', () => {
224
+ mediumSchema.parse(mediumData);
225
+ });
226
+
227
+ bench('complex schema (nested + array)', () => {
228
+ complexSchema.parse(complexData);
229
+ });
230
+
231
+ bench('no validation (return as-is)', () => {
232
+ const _result = simpleData;
233
+ });
234
+ });
235
+
236
+ // =============================================================================
237
+ // Full Context Creation
238
+ // =============================================================================
239
+
240
+ describe('Full Minimal Handler Context', () => {
241
+ const logger = {
242
+ info: () => {},
243
+ error: () => {},
244
+ debug: () => {},
245
+ warn: () => {},
246
+ };
247
+
248
+ bench('current approach (eager parsing)', () => {
249
+ const context = {
250
+ services: {},
251
+ logger,
252
+ body: undefined,
253
+ query: undefined,
254
+ params: undefined,
255
+ session: undefined,
256
+ header: Endpoint.createHeaders(SAMPLE_HEADERS),
257
+ cookie: Endpoint.createCookies(SAMPLE_COOKIE),
258
+ auditor: undefined,
259
+ db: undefined,
260
+ };
261
+ const rb = new ResponseBuilder();
262
+ // Simulate handler access
263
+ context.header('authorization');
264
+ rb.getMetadata();
265
+ });
266
+
267
+ bench('optimized (lazy parsing, shared stub)', () => {
268
+ const headers = SAMPLE_HEADERS;
269
+ const cookieHeader = SAMPLE_COOKIE;
270
+ let parsedCookies: Map<string, string> | null = null;
271
+
272
+ const context = {
273
+ services: {},
274
+ logger,
275
+ body: undefined,
276
+ query: undefined,
277
+ params: undefined,
278
+ session: undefined,
279
+ header: (key?: string) => {
280
+ if (!key) return headers;
281
+ return headers[key.toLowerCase()];
282
+ },
283
+ cookie: (name?: string) => {
284
+ if (!parsedCookies && cookieHeader) {
285
+ parsedCookies = new Map();
286
+ for (const part of cookieHeader.split(';')) {
287
+ const [k, v] = part.trim().split('=');
288
+ if (k && v) parsedCookies.set(k, v);
289
+ }
290
+ }
291
+ if (!name) {
292
+ const obj: Record<string, string> = {};
293
+ if (parsedCookies) for (const [k, v] of parsedCookies) obj[k] = v;
294
+ return obj;
295
+ }
296
+ return parsedCookies?.get(name);
297
+ },
298
+ auditor: undefined,
299
+ db: undefined,
300
+ };
301
+ // Simulate handler access
302
+ context.header('authorization');
303
+ });
304
+
305
+ bench('minimal (no header/cookie parsing at all)', () => {
306
+ const _context = {
307
+ services: {},
308
+ logger,
309
+ body: undefined,
310
+ query: undefined,
311
+ params: undefined,
312
+ session: undefined,
313
+ header: () => undefined,
314
+ cookie: () => undefined,
315
+ auditor: undefined,
316
+ db: undefined,
317
+ };
318
+ // Handler doesn't use headers
319
+ });
320
+ });
321
+
322
+ // =============================================================================
323
+ // Comparison: Raw Hono vs Framework Overhead
324
+ // =============================================================================
325
+
326
+ describe('Handler Execution Comparison', () => {
327
+ // Simulates what a raw Hono handler would do
328
+ bench('raw handler (no framework)', async () => {
329
+ const handler = async () => ({ message: 'pong' as const });
330
+ const result = await handler();
331
+ JSON.stringify(result);
332
+ });
333
+
334
+ // Current minimal approach
335
+ bench('minimal handler (current)', async () => {
336
+ const handler = async () => ({ message: 'pong' as const });
337
+ const _rb = { getMetadata: () => ({}) };
338
+ const result = await handler();
339
+ simpleSchema.parse(result); // output validation
340
+ JSON.stringify(result);
341
+ });
342
+
343
+ // With header parsing
344
+ bench('minimal handler + header parsing', async () => {
345
+ const handler = async () => ({ message: 'pong' as const });
346
+ Endpoint.createHeaders(SAMPLE_HEADERS);
347
+ Endpoint.createCookies(SAMPLE_COOKIE);
348
+ const result = await handler();
349
+ simpleSchema.parse(result);
350
+ JSON.stringify(result);
351
+ });
352
+ });
353
+
354
+ // =============================================================================
355
+ // Hono Lazy Accessors vs Eager Parsing
356
+ // =============================================================================
357
+
358
+ describe('Hono Lazy Accessors', () => {
359
+ // We'll create a real request context for accurate benchmarking
360
+ const createMockContext = () => {
361
+ const req = new Request('http://localhost/test', {
362
+ headers: {
363
+ ...SAMPLE_HEADERS,
364
+ cookie: SAMPLE_COOKIE,
365
+ },
366
+ });
367
+ // Create a minimal context-like object
368
+ return {
369
+ req: {
370
+ header: (name?: string) => {
371
+ if (name) return req.headers.get(name) ?? undefined;
372
+ const all: Record<string, string> = {};
373
+ req.headers.forEach((v, k) => {
374
+ all[k] = v;
375
+ });
376
+ return all;
377
+ },
378
+ },
379
+ };
380
+ };
381
+
382
+ bench('OLD: Endpoint.createHeaders + createCookies (eager)', () => {
383
+ const c = createMockContext();
384
+ const headerValues = c.req.header() as Record<string, string>;
385
+ const header = Endpoint.createHeaders(headerValues);
386
+ const cookie = Endpoint.createCookies(headerValues.cookie);
387
+ // Simulate typical access pattern
388
+ header('authorization');
389
+ cookie('session');
390
+ });
391
+
392
+ bench('NEW: createHonoHeaders + createHonoCookies (lazy)', () => {
393
+ const c = createMockContext();
394
+ const header = createHonoHeaders(c as any);
395
+ const cookie = createHonoCookies(c as any);
396
+ // Simulate typical access pattern - uses native methods
397
+ header('authorization');
398
+ cookie('session');
399
+ });
400
+
401
+ bench('OLD: eager - access all headers', () => {
402
+ const c = createMockContext();
403
+ const headerValues = c.req.header() as Record<string, string>;
404
+ const header = Endpoint.createHeaders(headerValues);
405
+ header(); // get all
406
+ });
407
+
408
+ bench('NEW: lazy - access all headers', () => {
409
+ const c = createMockContext();
410
+ const header = createHonoHeaders(c as any);
411
+ header(); // get all - triggers parsing
412
+ });
413
+
414
+ bench('OLD: eager - no access (still parses)', () => {
415
+ const c = createMockContext();
416
+ const headerValues = c.req.header() as Record<string, string>;
417
+ Endpoint.createHeaders(headerValues);
418
+ Endpoint.createCookies(headerValues.cookie);
419
+ // Don't access anything - but parsing already happened
420
+ });
421
+
422
+ bench('NEW: lazy - no access (no parsing)', () => {
423
+ const c = createMockContext();
424
+ createHonoHeaders(c as any);
425
+ createHonoCookies(c as any);
426
+ // Don't access anything - no parsing happens
427
+ });
428
+ });