@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,692 @@
1
+ import type { AuditableAction, AuditStorage } from '@geekmidas/audit';
2
+ import { withRlsContext } from '@geekmidas/db/rls';
3
+ import type { EnvironmentParser } from '@geekmidas/envkit';
4
+ import { wrapError } from '@geekmidas/errors';
5
+ import type { EventPublisher } from '@geekmidas/events';
6
+ import type { Logger } from '@geekmidas/logger';
7
+ import { checkRateLimit, getRateLimitHeaders } from '@geekmidas/rate-limit';
8
+ import {
9
+ runWithRequestContext,
10
+ type Service,
11
+ ServiceDiscovery,
12
+ type ServiceRecord,
13
+ } from '@geekmidas/services';
14
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
15
+ import { type Context, Hono } from 'hono';
16
+ import { setCookie } from 'hono/cookie';
17
+ import { logger as honoLogger } from 'hono/logger';
18
+ import { timing } from 'hono/timing';
19
+ import type { ContentfulStatusCode } from 'hono/utils/http-status';
20
+ import { validator } from 'hono/validator';
21
+ import { startMonitors } from '../monitor';
22
+ import { publishConstructEvents } from '../publisher';
23
+ import type { HttpMethod, LowerHttpMethod } from '../types';
24
+ import type { MappedAudit } from './audit';
25
+ import {
26
+ Endpoint,
27
+ type EndpointContext,
28
+ type EndpointSchemas,
29
+ ResponseBuilder,
30
+ } from './Endpoint';
31
+ import { getEndpointsFromRoutes } from './helpers';
32
+ import { createHonoCookies, createHonoHeaders } from './lazyAccessors';
33
+ import { parseHonoQuery } from './parseHonoQuery';
34
+ import {
35
+ createAuditContext,
36
+ executeWithAuditTransaction,
37
+ } from './processAudits';
38
+
39
+ export interface HonoEndpointOptions {
40
+ /**
41
+ * Path where OpenAPI documentation will be served.
42
+ * Set to false to disable docs route.
43
+ * @default '/docs'
44
+ */
45
+ docsPath?: string | false;
46
+ /**
47
+ * OpenAPI schema options
48
+ */
49
+ openApiOptions?: {
50
+ title?: string;
51
+ version?: string;
52
+ description?: string;
53
+ };
54
+ }
55
+
56
+ /**
57
+ * Feature flags for an endpoint, analyzed once at route registration time.
58
+ * This avoids per-request feature detection overhead.
59
+ */
60
+ interface EndpointFeatures {
61
+ hasServices: boolean;
62
+ hasDatabase: boolean;
63
+ hasBodyValidation: boolean;
64
+ hasQueryValidation: boolean;
65
+ hasParamValidation: boolean;
66
+ hasAudits: boolean;
67
+ hasEvents: boolean;
68
+ hasRateLimit: boolean;
69
+ hasRls: boolean;
70
+ hasMonitors: boolean;
71
+ }
72
+
73
+ /**
74
+ * Case-insensitive check for a `content-type` header in a metadata headers map.
75
+ */
76
+ function hasContentTypeHeader(headers: Record<string, string>): boolean {
77
+ for (const key of Object.keys(headers)) {
78
+ if (key.toLowerCase() === 'content-type') return true;
79
+ }
80
+ return false;
81
+ }
82
+
83
+ /**
84
+ * Analyze endpoint features at registration time (not per-request)
85
+ */
86
+ function analyzeEndpointFeatures(
87
+ endpoint: Endpoint<
88
+ any,
89
+ any,
90
+ any,
91
+ any,
92
+ any,
93
+ any,
94
+ any,
95
+ any,
96
+ any,
97
+ any,
98
+ any,
99
+ any,
100
+ any,
101
+ any
102
+ >,
103
+ ): EndpointFeatures {
104
+ return {
105
+ hasServices: endpoint.services.length > 0,
106
+ hasDatabase: !!endpoint.databaseService,
107
+ hasBodyValidation: !!endpoint.input?.body,
108
+ hasQueryValidation: !!endpoint.input?.query,
109
+ hasParamValidation: !!endpoint.input?.params,
110
+ // Audit context needed if declarative audits OR auditor storage service configured (for manual audits)
111
+ hasAudits:
112
+ (endpoint.audits?.length ?? 0) > 0 || !!endpoint.auditorStorageService,
113
+ hasEvents: (endpoint.events?.length ?? 0) > 0,
114
+ hasRateLimit: !!endpoint.rateLimit,
115
+ hasRls: !!endpoint.rlsConfig && !endpoint.rlsBypass,
116
+ hasMonitors: endpoint.monitors.length > 0,
117
+ };
118
+ }
119
+
120
+ export class HonoEndpoint<
121
+ TRoute extends string,
122
+ TMethod extends HttpMethod,
123
+ TInput extends EndpointSchemas = {},
124
+ TOutSchema extends StandardSchemaV1 | undefined = undefined,
125
+ TServices extends Service[] = [],
126
+ TLogger extends Logger = Logger,
127
+ TSession = unknown,
128
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
129
+ TEventPublisherServiceName extends string = string,
130
+ TAuditStorage extends AuditStorage | undefined = undefined,
131
+ TAuditStorageServiceName extends string = string,
132
+ TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
133
+ string,
134
+ unknown
135
+ >,
136
+ TDatabase = undefined,
137
+ TDatabaseServiceName extends string = string,
138
+ > {
139
+ constructor(
140
+ private readonly endpoint: Endpoint<
141
+ TRoute,
142
+ TMethod,
143
+ TInput,
144
+ TOutSchema,
145
+ TServices,
146
+ TLogger,
147
+ TSession,
148
+ TEventPublisher,
149
+ TEventPublisherServiceName,
150
+ TAuditStorage,
151
+ TAuditStorageServiceName,
152
+ TAuditAction,
153
+ TDatabase,
154
+ TDatabaseServiceName
155
+ >,
156
+ ) {}
157
+
158
+ static isDev = process.env.NODE_ENV === 'development';
159
+
160
+ static async validate<T extends StandardSchemaV1>(
161
+ c: Context<any, string, {}>,
162
+ data: unknown,
163
+ schema?: T,
164
+ ) {
165
+ if (!schema) {
166
+ return undefined;
167
+ }
168
+
169
+ const parsed = await Endpoint.validate(schema, data);
170
+
171
+ if (parsed.issues) {
172
+ return c.json(parsed.issues, 422);
173
+ }
174
+
175
+ return parsed.value;
176
+ }
177
+ addRoute(
178
+ serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>>,
179
+ app: Hono,
180
+ ): void {
181
+ HonoEndpoint.addRoute(this.endpoint, serviceDiscovery, app);
182
+ }
183
+
184
+ /**
185
+ * @deprecated Global event middleware is no longer used.
186
+ * Events are now published per-route only for endpoints that have events configured.
187
+ * This method is kept for backward compatibility but does nothing.
188
+ */
189
+ static applyEventMiddleware(
190
+ _app: Hono,
191
+ _serviceDiscovery: ServiceDiscovery<any>,
192
+ ) {
193
+ // No-op: Event publishing is now handled per-route in addRoute
194
+ // This avoids running middleware on every request including 404s
195
+ }
196
+
197
+ static async fromRoutes<TLogger extends Logger, TServices extends Service[]>(
198
+ routes: string[],
199
+ envParser: EnvironmentParser<{}>,
200
+ app = new Hono(),
201
+ _logger: TLogger,
202
+ cwd = process.cwd(),
203
+ options?: HonoEndpointOptions,
204
+ ): Promise<Hono> {
205
+ const endpoints = await getEndpointsFromRoutes<TServices>(routes, cwd);
206
+ const serviceDiscovery =
207
+ ServiceDiscovery.getInstance<ServiceRecord<TServices>>(envParser);
208
+
209
+ HonoEndpoint.addRoutes(endpoints, serviceDiscovery, app, options);
210
+
211
+ return app;
212
+ }
213
+
214
+ static addRoutes<
215
+ TServices extends Service[] = [],
216
+ TLogger extends Logger = Logger,
217
+ >(
218
+ endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[],
219
+ serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>>,
220
+ app: Hono,
221
+ options?: HonoEndpointOptions,
222
+ ): void {
223
+ // Add timing middleware (always enabled)
224
+ app.use('*', timing());
225
+
226
+ // Add logger middleware in development mode
227
+
228
+ if (HonoEndpoint.isDev) {
229
+ app.use('*', honoLogger());
230
+ }
231
+
232
+ // Add docs route if not disabled
233
+ const docsPath =
234
+ options?.docsPath !== false ? options?.docsPath || '/docs' : null;
235
+ if (docsPath) {
236
+ HonoEndpoint.addDocsRoute(
237
+ endpoints,
238
+ app,
239
+ docsPath,
240
+ options?.openApiOptions,
241
+ );
242
+ }
243
+
244
+ // Sort endpoints to ensure static routes come before dynamic ones
245
+ const sortedEndpoints = endpoints.sort((a, b) => {
246
+ const aSegments = a.route.split('/');
247
+ const bSegments = b.route.split('/');
248
+
249
+ // Compare each segment
250
+ for (let i = 0; i < Math.max(aSegments.length, bSegments.length); i++) {
251
+ const aSegment = aSegments[i] || '';
252
+ const bSegment = bSegments[i] || '';
253
+
254
+ // If one is dynamic and the other is not, static comes first
255
+ const aIsDynamic = aSegment.startsWith(':');
256
+ const bIsDynamic = bSegment.startsWith(':');
257
+
258
+ if (!aIsDynamic && bIsDynamic) return -1;
259
+ if (aIsDynamic && !bIsDynamic) return 1;
260
+
261
+ // If both are the same type, compare alphabetically
262
+ if (aSegment !== bSegment) {
263
+ return aSegment.localeCompare(bSegment);
264
+ }
265
+ }
266
+
267
+ return 0;
268
+ });
269
+
270
+ // Note: Global event middleware removed for performance
271
+ // Events are now published per-route only for endpoints with events configured
272
+ for (const endpoint of sortedEndpoints) {
273
+ HonoEndpoint.addRoute(endpoint, serviceDiscovery, app);
274
+ }
275
+ }
276
+
277
+ static addRoute<
278
+ TRoute extends string,
279
+ TMethod extends HttpMethod,
280
+ TInput extends EndpointSchemas = {},
281
+ TOutSchema extends StandardSchemaV1 | undefined = undefined,
282
+ TServices extends Service[] = [],
283
+ TLogger extends Logger = Logger,
284
+ TSession = unknown,
285
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
286
+ TEventPublisherServiceName extends string = string,
287
+ TAuditStorage extends AuditStorage | undefined = undefined,
288
+ TAuditStorageServiceName extends string = string,
289
+ TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
290
+ string,
291
+ unknown
292
+ >,
293
+ TDatabase = undefined,
294
+ TDatabaseServiceName extends string = string,
295
+ >(
296
+ endpoint: Endpoint<
297
+ TRoute,
298
+ TMethod,
299
+ TInput,
300
+ TOutSchema,
301
+ TServices,
302
+ TLogger,
303
+ TSession,
304
+ TEventPublisher,
305
+ TEventPublisherServiceName,
306
+ TAuditStorage,
307
+ TAuditStorageServiceName,
308
+ TAuditAction,
309
+ TDatabase,
310
+ TDatabaseServiceName
311
+ >,
312
+ serviceDiscovery: ServiceDiscovery<ServiceRecord<TServices>>,
313
+ app: Hono,
314
+ ): void {
315
+ const { route } = endpoint;
316
+ const method = endpoint.method.toLowerCase() as LowerHttpMethod<TMethod>;
317
+
318
+ // Analyze endpoint features once at registration time (not per-request)
319
+ const features = analyzeEndpointFeatures(endpoint);
320
+
321
+ // Build validators array - only add validators for schemas that exist
322
+ const validators: any[] = [];
323
+
324
+ if (features.hasBodyValidation) {
325
+ validators.push(
326
+ validator('json', (value, c) =>
327
+ HonoEndpoint.validate(c, value, endpoint.input?.body),
328
+ ),
329
+ );
330
+ }
331
+
332
+ if (features.hasQueryValidation) {
333
+ validators.push(
334
+ validator('query', (_, c) => {
335
+ const parsedQuery = parseHonoQuery(c);
336
+ return HonoEndpoint.validate(c, parsedQuery, endpoint.input?.query);
337
+ }),
338
+ );
339
+ }
340
+
341
+ if (features.hasParamValidation) {
342
+ validators.push(
343
+ validator('param', (params, c) =>
344
+ HonoEndpoint.validate(c, params, endpoint.input?.params),
345
+ ),
346
+ );
347
+ }
348
+
349
+ // Main handler
350
+ const handler = async (c: Context) => {
351
+ // Request context setup
352
+ const startTime = Date.now();
353
+ const requestId = c.req.header('X-Request-ID') ?? crypto.randomUUID();
354
+
355
+ const logger = endpoint.logger.child({
356
+ requestId,
357
+ endpoint: endpoint.fullPath,
358
+ route: endpoint.route,
359
+ host: c.req.header('host'),
360
+ method: endpoint.method,
361
+ path: c.req.path,
362
+ }) as TLogger;
363
+
364
+ // Set response header
365
+ c.header('X-Request-ID', requestId);
366
+
367
+ const monitor = features.hasMonitors
368
+ ? await startMonitors(endpoint, serviceDiscovery, logger)
369
+ : undefined;
370
+ let failure: unknown;
371
+
372
+ // Wrap entire handler in request context for services to access
373
+ const response = await runWithRequestContext(
374
+ { logger, requestId, startTime },
375
+ async () => {
376
+ try {
377
+ // Lazy accessors - no upfront parsing, use native Hono methods
378
+ const header = createHonoHeaders(c);
379
+ const cookie = createHonoCookies(c);
380
+
381
+ // Only register services if endpoint has any
382
+ const services = features.hasServices
383
+ ? await serviceDiscovery.register(endpoint.services)
384
+ : ({} as ServiceRecord<TServices>);
385
+
386
+ // Resolve database service only if configured
387
+ const rawDb = features.hasDatabase
388
+ ? await serviceDiscovery
389
+ .register([endpoint.databaseService!])
390
+ .then(
391
+ (s) =>
392
+ s[
393
+ endpoint.databaseService?.serviceName as keyof typeof s
394
+ ],
395
+ )
396
+ : undefined;
397
+
398
+ // Extract session (defaults to empty object)
399
+ const session = await endpoint.getSession({
400
+ services,
401
+ logger,
402
+ header,
403
+ cookie,
404
+ ...(rawDb !== undefined && { db: rawDb }),
405
+ } as any);
406
+
407
+ // Check authorization (defaults to true)
408
+ const isAuthorized = await endpoint.authorize({
409
+ header,
410
+ cookie,
411
+ services,
412
+ logger,
413
+ session,
414
+ ...(rawDb !== undefined && { db: rawDb }),
415
+ body: features.hasBodyValidation
416
+ ? (c.req.valid as any)('json')
417
+ : undefined,
418
+ query: features.hasQueryValidation
419
+ ? (c.req.valid as any)('query')
420
+ : undefined,
421
+ params: features.hasParamValidation
422
+ ? (c.req.valid as any)('param')
423
+ : undefined,
424
+ } as any);
425
+
426
+ if (!isAuthorized) {
427
+ logger.warn('Forbidden access attempt');
428
+ return c.json({ error: 'Forbidden' }, 403);
429
+ }
430
+
431
+ // Check rate limit only if configured
432
+ if (features.hasRateLimit) {
433
+ const rateLimitInfo = await checkRateLimit(endpoint.rateLimit!, {
434
+ header,
435
+ services,
436
+ logger,
437
+ session,
438
+ path: c.req.path,
439
+ method: endpoint.method,
440
+ });
441
+
442
+ const rateLimitHeaders = getRateLimitHeaders(
443
+ rateLimitInfo,
444
+ endpoint.rateLimit!,
445
+ );
446
+ for (const [key, value] of Object.entries(rateLimitHeaders)) {
447
+ if (value) {
448
+ c.header(key, value);
449
+ }
450
+ }
451
+ }
452
+
453
+ // Create audit context only if audits are configured
454
+ const auditContext = features.hasAudits
455
+ ? await createAuditContext(
456
+ endpoint as any,
457
+ serviceDiscovery,
458
+ logger,
459
+ {
460
+ session,
461
+ header,
462
+ cookie,
463
+ services: services as Record<string, unknown>,
464
+ },
465
+ )
466
+ : undefined;
467
+
468
+ const audits = features.hasAudits
469
+ ? (endpoint.audits as MappedAudit<TAuditAction, TOutSchema>[])
470
+ : [];
471
+
472
+ // Warn if declarative audits are configured but no audit storage
473
+ if (features.hasAudits && !auditContext) {
474
+ logger.warn('No auditor storage service available');
475
+ }
476
+
477
+ // Extract RLS context only if configured and not bypassed
478
+ const rlsContext =
479
+ features.hasRls && rawDb !== undefined
480
+ ? await endpoint.rlsConfig?.extractor({
481
+ services,
482
+ session: session as TSession,
483
+ header,
484
+ cookie,
485
+ logger,
486
+ })
487
+ : undefined;
488
+
489
+ // Execute handler with automatic audit transaction support
490
+ const result = await executeWithAuditTransaction(
491
+ auditContext,
492
+ async (auditor) => {
493
+ const sameDatabase =
494
+ auditContext?.storage?.databaseServiceName &&
495
+ auditContext.storage.databaseServiceName ===
496
+ endpoint.databaseService?.serviceName;
497
+ const baseDb = sameDatabase
498
+ ? (auditor?.getTransaction?.() ?? rawDb)
499
+ : rawDb;
500
+
501
+ const executeHandler = async (db: TDatabase | undefined) => {
502
+ const responseBuilder = new ResponseBuilder();
503
+ const response = await endpoint.handler(
504
+ {
505
+ services,
506
+ logger,
507
+ body: features.hasBodyValidation
508
+ ? (c.req.valid as any)('json')
509
+ : undefined,
510
+ query: features.hasQueryValidation
511
+ ? (c.req.valid as any)('query')
512
+ : undefined,
513
+ params: features.hasParamValidation
514
+ ? (c.req.valid as any)('param')
515
+ : undefined,
516
+ session,
517
+ header,
518
+ cookie,
519
+ auditor,
520
+ db,
521
+ } as unknown as EndpointContext<
522
+ TInput,
523
+ TServices,
524
+ TLogger,
525
+ TSession,
526
+ TAuditAction,
527
+ TDatabase,
528
+ TAuditStorage
529
+ >,
530
+ responseBuilder,
531
+ );
532
+
533
+ let data = response;
534
+ let metadata = responseBuilder.getMetadata();
535
+
536
+ if (Endpoint.hasMetadata(response)) {
537
+ data = response.data;
538
+ metadata = response.metadata;
539
+ }
540
+
541
+ const output = endpoint.outputSchema
542
+ ? await endpoint.parseOutput(data)
543
+ : undefined;
544
+
545
+ return { output, metadata, responseBuilder };
546
+ };
547
+
548
+ if (features.hasRls && rlsContext && baseDb) {
549
+ return withRlsContext(
550
+ baseDb as any,
551
+ rlsContext,
552
+ async (trx) => executeHandler(trx as TDatabase),
553
+ { prefix: endpoint.rlsConfig?.prefix },
554
+ );
555
+ }
556
+
557
+ return executeHandler(baseDb as TDatabase | undefined);
558
+ },
559
+ async (result, auditor) => {
560
+ if (!audits?.length) return;
561
+
562
+ for (const audit of audits) {
563
+ if (audit.when && !audit.when(result.output as any)) {
564
+ continue;
565
+ }
566
+ const payload = audit.payload(result.output as any);
567
+ const entityId = audit.entityId?.(result.output as any);
568
+ auditor.audit(audit.type as any, payload as any, {
569
+ table: audit.table,
570
+ entityId,
571
+ });
572
+ }
573
+ },
574
+ { db: rawDb },
575
+ );
576
+
577
+ const { output, metadata } = result;
578
+
579
+ try {
580
+ let status = endpoint.status as ContentfulStatusCode;
581
+
582
+ if (metadata.status) {
583
+ status = metadata.status as ContentfulStatusCode;
584
+ }
585
+
586
+ if (metadata.headers) {
587
+ for (const [key, value] of Object.entries(metadata.headers)) {
588
+ c.header(key, value);
589
+ }
590
+ }
591
+
592
+ if (metadata.cookies) {
593
+ for (const [name, { value, options }] of metadata.cookies) {
594
+ setCookie(c, name, value, options);
595
+ }
596
+ }
597
+
598
+ // Only publish events if configured (no global middleware overhead)
599
+ if (features.hasEvents && Endpoint.isSuccessStatus(status)) {
600
+ await publishConstructEvents<any, any>(
601
+ endpoint as any,
602
+ output,
603
+ serviceDiscovery,
604
+ logger,
605
+ );
606
+ }
607
+
608
+ if (HonoEndpoint.isDev) {
609
+ logger.info({ status, body: output }, 'Outgoing response');
610
+ }
611
+
612
+ // Respect the endpoint's declared responseType. For JSON (default)
613
+ // we use c.json() which sets Content-Type and serializes. For any
614
+ // other type, emit the body as-is and set the header explicitly —
615
+ // metadata.headers (from r.header()) applied above still wins.
616
+ if (endpoint.responseType === 'application/json') {
617
+ // @ts-expect-error
618
+ return c.json(output, status);
619
+ }
620
+ if (
621
+ !(metadata.headers && hasContentTypeHeader(metadata.headers))
622
+ ) {
623
+ c.header('content-type', endpoint.responseType);
624
+ }
625
+ return c.body(output as any, status);
626
+ } catch (validationError: any) {
627
+ logger.error(validationError, 'Output validation failed');
628
+ const error = wrapError(
629
+ validationError,
630
+ 422,
631
+ 'Response validation failed',
632
+ );
633
+ if (HonoEndpoint.isDev) {
634
+ logger.info(
635
+ { status: error.statusCode, body: error },
636
+ 'Outgoing response',
637
+ );
638
+ }
639
+ return c.json(error, error.statusCode as ContentfulStatusCode);
640
+ }
641
+ } catch (e: any) {
642
+ failure = e;
643
+ logger.error(e, 'Error processing endpoint request');
644
+ const error = wrapError(e, 500, 'Internal Server Error');
645
+ if (HonoEndpoint.isDev) {
646
+ logger.info(
647
+ { status: error.statusCode, body: error },
648
+ 'Outgoing response',
649
+ );
650
+ }
651
+ return c.json(error, error.statusCode as ContentfulStatusCode);
652
+ }
653
+ },
654
+ );
655
+
656
+ // Not awaited: a server stays up after responding, so the request
657
+ // does not wait on the monitoring service. `settle` never throws.
658
+ void monitor?.settle(response.status, failure);
659
+
660
+ return response;
661
+ };
662
+
663
+ // Register route with conditional validators
664
+ app[method](route, ...validators, handler);
665
+ }
666
+
667
+ static addDocsRoute<
668
+ TServices extends Service[] = [],
669
+ TLogger extends Logger = Logger,
670
+ >(
671
+ endpoints: Endpoint<string, HttpMethod, any, any, TServices, TLogger>[],
672
+ app: Hono,
673
+ docsPath: string,
674
+ openApiOptions?: HonoEndpointOptions['openApiOptions'],
675
+ ): void {
676
+ app.get(docsPath, async (c) => {
677
+ try {
678
+ const openApiSchema = await Endpoint.buildOpenApiSchema(
679
+ endpoints,
680
+ openApiOptions,
681
+ );
682
+
683
+ return c.json(openApiSchema);
684
+ } catch {
685
+ return c.json(
686
+ { error: 'Failed to generate OpenAPI documentation' },
687
+ 500,
688
+ );
689
+ }
690
+ });
691
+ }
692
+ }