@geekmidas/constructs 10.0.0-alpha.98 → 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,698 @@
1
+ import type { AuditableAction, AuditStorage } from '@geekmidas/audit';
2
+ import { withRlsContext } from '@geekmidas/db/rls';
3
+ import type { EnvironmentParser } from '@geekmidas/envkit';
4
+ import type { Logger } from '@geekmidas/logger';
5
+ import middy, { type MiddlewareObj } from '@middy/core';
6
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
7
+ import type {
8
+ APIGatewayProxyEvent,
9
+ APIGatewayProxyEventV2,
10
+ Context,
11
+ } from 'aws-lambda';
12
+ import set from 'lodash.set';
13
+ import type { Telemetry } from '../telemetry';
14
+ import type { HttpMethod } from '../types';
15
+ import { Endpoint, type EndpointSchemas, ResponseBuilder } from './Endpoint';
16
+
17
+ /**
18
+ * Telescope integration for request recording.
19
+ * Uses Middy middleware pattern for compatibility with existing telescope package.
20
+ */
21
+ export interface TelescopeIntegration {
22
+ middleware: MiddlewareObj<any, any, Error, Context>;
23
+ }
24
+
25
+ import {
26
+ ForbiddenError,
27
+ UnprocessableEntityError,
28
+ wrapError,
29
+ } from '@geekmidas/errors';
30
+ import type { EventPublisher } from '@geekmidas/events';
31
+ import type {
32
+ InferComposableStandardSchema,
33
+ InferStandardSchema,
34
+ } from '@geekmidas/schema';
35
+ import {
36
+ runWithRequestContext,
37
+ type Service,
38
+ ServiceDiscovery,
39
+ type ServiceRecord,
40
+ } from '@geekmidas/services';
41
+ import { startMonitors } from '../monitor';
42
+ import { publishConstructEvents } from '../publisher';
43
+ import type { MappedAudit } from './audit';
44
+ import type { CookieFn, HeaderFn } from './Endpoint';
45
+ import {
46
+ createAuditContext,
47
+ executeWithAuditTransaction,
48
+ } from './processAudits';
49
+
50
+ // Helper function to publish events
51
+
52
+ /**
53
+ * Options for Amazon API Gateway endpoint adaptors
54
+ */
55
+ export interface AmazonApiGatewayEndpointOptions {
56
+ /**
57
+ * Telescope integration for request recording and monitoring.
58
+ *
59
+ * @example
60
+ * ```typescript
61
+ * import { telescopeMiddleware } from '@geekmidas/telescope/lambda';
62
+ *
63
+ * const adaptor = new AmazonApiGatewayV2Endpoint(envParser, endpoint, {
64
+ * telescope: { middleware: telescopeMiddleware(telescope) },
65
+ * });
66
+ * ```
67
+ */
68
+ telescope?: TelescopeIntegration;
69
+
70
+ /**
71
+ * Telemetry integration for distributed tracing.
72
+ * Works with any OpenTelemetry-compatible backend.
73
+ *
74
+ * @example
75
+ * ```typescript
76
+ * import { OTelTelemetry } from '@geekmidas/telescope/instrumentation';
77
+ *
78
+ * const adaptor = new AmazonApiGatewayV2Endpoint(envParser, endpoint, {
79
+ * telemetry: new OTelTelemetry(),
80
+ * });
81
+ * ```
82
+ */
83
+ telemetry?: Telemetry;
84
+ }
85
+
86
+ export abstract class AmazonApiGatewayEndpoint<
87
+ THandler extends
88
+ | AmazonApiGatewayV1EndpointHandler
89
+ | AmazonApiGatewayV2EndpointHandler,
90
+ TEvent extends HandlerEvent<THandler>,
91
+ TRoute extends string,
92
+ TMethod extends HttpMethod,
93
+ TInput extends EndpointSchemas = {},
94
+ TOutSchema extends StandardSchemaV1 | undefined = undefined,
95
+ TServices extends Service[] = [],
96
+ TLogger extends Logger = Logger,
97
+ TSession = unknown,
98
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
99
+ TEventPublisherServiceName extends string = string,
100
+ TAuditStorage extends AuditStorage | undefined = undefined,
101
+ TAuditStorageServiceName extends string = string,
102
+ TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
103
+ string,
104
+ unknown
105
+ >,
106
+ > {
107
+ protected options: AmazonApiGatewayEndpointOptions;
108
+
109
+ constructor(
110
+ protected envParser: EnvironmentParser<{}>,
111
+ protected readonly endpoint: Endpoint<
112
+ TRoute,
113
+ TMethod,
114
+ TInput,
115
+ TOutSchema,
116
+ TServices,
117
+ TLogger,
118
+ TSession,
119
+ TEventPublisher,
120
+ TEventPublisherServiceName,
121
+ TAuditStorage,
122
+ TAuditStorageServiceName,
123
+ TAuditAction
124
+ >,
125
+ options: AmazonApiGatewayEndpointOptions = {},
126
+ ) {
127
+ this.options = options;
128
+ }
129
+
130
+ private error(): Middleware<TEvent, TInput, TServices, TLogger> {
131
+ return {
132
+ onError: (req) => {
133
+ (req.event.logger || this.endpoint.logger).error(
134
+ req.error || {},
135
+ 'Error processing request',
136
+ );
137
+ const wrappedError = wrapError(req.error);
138
+ // Kept for the monitors, which only see the response otherwise.
139
+ (req.event as any).__error = req.error;
140
+
141
+ // Set the response with the proper status code from the HttpError
142
+ req.response = {
143
+ statusCode: wrappedError.statusCode,
144
+ body: wrappedError.body,
145
+ };
146
+ },
147
+ };
148
+ }
149
+ abstract getInput(e: TEvent): GetInputResponse;
150
+
151
+ /**
152
+ * Decodes the raw body from an API Gateway event.
153
+ * Uses Content-Type to decide parsing strategy (like Express/Fastify/Hono):
154
+ * - `application/json` (or missing) → JSON.parse the decoded string
155
+ * - Anything else → return decoded string as-is, let the schema handle it
156
+ *
157
+ * Defaults to JSON when no Content-Type is provided for backwards compatibility.
158
+ */
159
+ static decodeBody(
160
+ body: string | undefined | null,
161
+ isBase64Encoded: boolean | undefined,
162
+ contentType: string | undefined,
163
+ ): any {
164
+ if (!body) return undefined;
165
+
166
+ const raw = isBase64Encoded
167
+ ? Buffer.from(body, 'base64').toString('utf-8')
168
+ : body;
169
+
170
+ const isJson =
171
+ !contentType || contentType.toLowerCase().includes('application/json');
172
+ if (isJson) {
173
+ return JSON.parse(raw);
174
+ }
175
+
176
+ return raw;
177
+ }
178
+
179
+ protected getCookies(e: TEvent): CookieFn {
180
+ const headers = e.headers as Record<string, string>;
181
+ return Endpoint.createCookies(headers?.cookie);
182
+ }
183
+
184
+ private input(): Middleware<TEvent, TInput, TServices, TLogger> {
185
+ return {
186
+ before: async (req) => {
187
+ try {
188
+ const { body, query, params } = this.getInput(req.event);
189
+ const headers = req.event.headers as Record<string, string>;
190
+ const header = Endpoint.createHeaders(headers);
191
+ const cookie = this.getCookies(req.event);
192
+
193
+ set(req.event, 'body', await this.endpoint.parseInput(body, 'body'));
194
+
195
+ set(
196
+ req.event,
197
+ 'query',
198
+ await this.endpoint.parseInput(query, 'query'),
199
+ );
200
+ set(
201
+ req.event,
202
+ 'params',
203
+ await this.endpoint.parseInput(params, 'params'),
204
+ );
205
+ set(req.event, 'header', header);
206
+ set(req.event, 'cookie', cookie);
207
+ } catch (error) {
208
+ // Convert validation errors to 422 Unprocessable Entity
209
+ if (error && typeof error === 'object' && Array.isArray(error)) {
210
+ throw new UnprocessableEntityError('Validation failed', error);
211
+ }
212
+ throw error;
213
+ }
214
+ },
215
+ };
216
+ }
217
+
218
+ abstract getLoggerContext(data: TEvent, context: Context): LoggerContext;
219
+
220
+ private logger(): Middleware<TEvent, TInput, TServices, TLogger> {
221
+ return {
222
+ before: (req) => {
223
+ req.event.logger = this.endpoint.logger.child({
224
+ route: this.endpoint.route,
225
+ host: req.event.headers?.host,
226
+ method: this.endpoint.method,
227
+ ...this.getLoggerContext(req.event, req.context),
228
+ }) as TLogger;
229
+ },
230
+ };
231
+ }
232
+ private services(): Middleware<TEvent, TInput, TServices, TLogger> {
233
+ return {
234
+ before: async (req) => {
235
+ const _logger = req.event.logger as TLogger;
236
+ const serviceDiscovery = ServiceDiscovery.getInstance<
237
+ ServiceRecord<TServices>
238
+ >(this.envParser);
239
+
240
+ const services = await serviceDiscovery.register(
241
+ this.endpoint.services,
242
+ );
243
+
244
+ req.event.services = services;
245
+ },
246
+ };
247
+ }
248
+
249
+ private authorize(): Middleware<TEvent, TInput, TServices, TLogger> {
250
+ return {
251
+ before: async (req) => {
252
+ const logger = req.event.logger as TLogger;
253
+ const services = req.event.services;
254
+ const header = req.event.header;
255
+ const cookie = req.event.cookie;
256
+ const session = req.event.session as TSession;
257
+
258
+ const isAuthorized = await this.endpoint.authorize({
259
+ header,
260
+ cookie,
261
+ services,
262
+ logger,
263
+ session,
264
+ ...((req.event as any).db !== undefined && {
265
+ db: (req.event as any).db,
266
+ }),
267
+ body: (req.event as any).body,
268
+ query: (req.event as any).query,
269
+ params: (req.event as any).params,
270
+ } as any);
271
+
272
+ if (!isAuthorized) {
273
+ logger.warn('Forbidden access attempt');
274
+ throw new ForbiddenError(
275
+ 'Forbidden access to the endpoint',
276
+ 'You do not have permission to access this resource.',
277
+ );
278
+ }
279
+ },
280
+ };
281
+ }
282
+
283
+ private database(): Middleware<TEvent, TInput, TServices, TLogger> {
284
+ return {
285
+ before: async (req) => {
286
+ if (!this.endpoint.databaseService) {
287
+ return;
288
+ }
289
+
290
+ const _logger = req.event.logger as TLogger;
291
+ const serviceDiscovery = ServiceDiscovery.getInstance<
292
+ ServiceRecord<TServices>
293
+ >(this.envParser);
294
+
295
+ const db = await serviceDiscovery
296
+ .register([this.endpoint.databaseService])
297
+ .then(
298
+ (s) =>
299
+ s[this.endpoint.databaseService?.serviceName as keyof typeof s],
300
+ );
301
+
302
+ (req.event as any).db = db;
303
+ },
304
+ };
305
+ }
306
+
307
+ private session(): Middleware<TEvent, TInput, TServices, TLogger> {
308
+ return {
309
+ before: async (req) => {
310
+ const logger = req.event.logger as TLogger;
311
+ const services = req.event.services;
312
+ const db = (req.event as any).db;
313
+ req.event.session = (await this.endpoint.getSession({
314
+ logger,
315
+ services,
316
+ header: req.event.header,
317
+ cookie: req.event.cookie,
318
+ ...(db !== undefined && { db }),
319
+ } as any)) as TSession;
320
+ },
321
+ };
322
+ }
323
+
324
+ private events(): Middleware<TEvent, TInput, TServices, TLogger> {
325
+ return {
326
+ after: async (req) => {
327
+ const event = req.event;
328
+ const response = (event as any)
329
+ .__response as InferStandardSchema<TOutSchema>;
330
+ const statusCode = req.response?.statusCode ?? this.endpoint.status;
331
+
332
+ // Only publish events on successful responses (2xx status codes)
333
+ // Note: Audits are processed inside the handler's transaction
334
+ if (Endpoint.isSuccessStatus(statusCode)) {
335
+ const logger = event.logger as TLogger;
336
+ const serviceDiscovery = ServiceDiscovery.getInstance<
337
+ ServiceRecord<TServices>
338
+ >(this.envParser);
339
+
340
+ // Publish events
341
+ await publishConstructEvents(
342
+ this.endpoint,
343
+ response,
344
+ serviceDiscovery,
345
+ logger,
346
+ );
347
+ }
348
+ },
349
+ };
350
+ }
351
+
352
+ private async _handler(
353
+ event: Event<TEvent, TInput, TServices, TLogger, TSession>,
354
+ ) {
355
+ const input = this.endpoint.refineInput(event);
356
+ const logger = event.logger as TLogger;
357
+ const serviceDiscovery = ServiceDiscovery.getInstance<
358
+ ServiceRecord<TServices>
359
+ >(this.envParser);
360
+
361
+ // Create audit context if audit storage is configured
362
+ const auditContext = await createAuditContext(
363
+ this.endpoint,
364
+ serviceDiscovery,
365
+ logger,
366
+ {
367
+ session: event.session,
368
+ header: event.header,
369
+ cookie: event.cookie,
370
+ services: event.services as Record<string, unknown>,
371
+ },
372
+ );
373
+
374
+ // Warn if declarative audits are configured but no audit storage
375
+ const audits = this.endpoint.audits as MappedAudit<
376
+ TAuditAction,
377
+ TOutSchema
378
+ >[];
379
+ if (!auditContext && audits?.length) {
380
+ logger.warn('No auditor storage service available');
381
+ }
382
+
383
+ // Get pre-resolved database from middleware
384
+ const rawDb = (event as any).db;
385
+
386
+ // Extract RLS context if configured and not bypassed
387
+ const rlsActive =
388
+ this.endpoint.rlsConfig &&
389
+ !this.endpoint.rlsBypass &&
390
+ rawDb !== undefined;
391
+ const rlsContext = rlsActive
392
+ ? await this.endpoint.rlsConfig?.extractor({
393
+ services: event.services as ServiceRecord<TServices>,
394
+ session: event.session,
395
+ header: event.header,
396
+ cookie: event.cookie,
397
+ logger,
398
+ })
399
+ : undefined;
400
+
401
+ // Execute handler with automatic audit transaction support
402
+ const result = await executeWithAuditTransaction(
403
+ auditContext,
404
+ async (auditor) => {
405
+ // Use audit transaction as db only if the storage uses the same database service
406
+ const sameDatabase =
407
+ auditContext?.storage?.databaseServiceName &&
408
+ auditContext.storage.databaseServiceName ===
409
+ this.endpoint.databaseService?.serviceName;
410
+ const baseDb = sameDatabase
411
+ ? (auditor?.getTransaction?.() ?? rawDb)
412
+ : rawDb;
413
+
414
+ // Helper to execute handler with given db
415
+ const executeHandler = async (db: any) => {
416
+ const responseBuilder = new ResponseBuilder();
417
+ const response = await this.endpoint.handler(
418
+ {
419
+ header: event.header,
420
+ cookie: event.cookie,
421
+ logger: event.logger,
422
+ services: event.services,
423
+ session: event.session,
424
+ auditor,
425
+ db,
426
+ ...input,
427
+ } as any,
428
+ responseBuilder,
429
+ );
430
+
431
+ // Check if response has metadata
432
+ let data = response;
433
+ let metadata = responseBuilder.getMetadata();
434
+
435
+ if (Endpoint.hasMetadata(response)) {
436
+ data = response.data;
437
+ metadata = response.metadata;
438
+ }
439
+
440
+ const output = this.endpoint.outputSchema
441
+ ? await this.endpoint.parseOutput(data)
442
+ : undefined;
443
+
444
+ return { output, metadata, responseBuilder };
445
+ };
446
+
447
+ // If RLS is active, wrap handler with RLS context
448
+ if (rlsActive && rlsContext && baseDb) {
449
+ return withRlsContext(
450
+ baseDb,
451
+ rlsContext,
452
+ async (trx: any) => executeHandler(trx),
453
+ { prefix: this.endpoint.rlsConfig?.prefix },
454
+ );
455
+ }
456
+
457
+ return executeHandler(baseDb);
458
+ },
459
+ // Process declarative audits after handler (inside transaction)
460
+ async (result, auditor) => {
461
+ if (!audits?.length) return;
462
+
463
+ for (const audit of audits) {
464
+ if (audit.when && !audit.when(result.output as any)) {
465
+ continue;
466
+ }
467
+ const payload = audit.payload(result.output as any);
468
+ const entityId = audit.entityId?.(result.output as any);
469
+ auditor.audit(audit.type as any, payload as any, {
470
+ table: audit.table,
471
+ entityId,
472
+ });
473
+ }
474
+ },
475
+ // Pass rawDb so storage can reuse existing transactions
476
+ { db: rawDb },
477
+ );
478
+
479
+ const { output, metadata } = result;
480
+ const isJsonResponse = this.endpoint.responseType === 'application/json';
481
+ const body =
482
+ output === undefined
483
+ ? undefined
484
+ : isJsonResponse
485
+ ? JSON.stringify(output)
486
+ : typeof output === 'string'
487
+ ? output
488
+ : String(output);
489
+
490
+ // Store response for middleware access
491
+ (event as any).__response = output;
492
+
493
+ // Build response with metadata
494
+ const lambdaResponse: AmazonApiGatewayEndpointHandlerResponse = {
495
+ statusCode: metadata.status ?? this.endpoint.status,
496
+ body,
497
+ };
498
+
499
+ // Compose headers. For non-JSON responseType, emit a default
500
+ // Content-Type header which metadata.headers (r.header()) can override.
501
+ const baseHeaders: Record<string, string> | undefined = isJsonResponse
502
+ ? undefined
503
+ : { 'content-type': this.endpoint.responseType };
504
+
505
+ if (
506
+ baseHeaders ||
507
+ (metadata.headers && Object.keys(metadata.headers).length > 0)
508
+ ) {
509
+ lambdaResponse.headers = {
510
+ ...(baseHeaders ?? {}),
511
+ ...(metadata.headers ?? {}),
512
+ };
513
+ }
514
+
515
+ // Format cookies as Set-Cookie headers
516
+ if (metadata.cookies && metadata.cookies.size > 0) {
517
+ const setCookieHeaders: string[] = [];
518
+ for (const [name, { value, options }] of metadata.cookies) {
519
+ setCookieHeaders.push(
520
+ Endpoint.formatCookieHeader(name, value, options),
521
+ );
522
+ }
523
+
524
+ if (setCookieHeaders.length > 0) {
525
+ lambdaResponse.multiValueHeaders = {
526
+ ...lambdaResponse.multiValueHeaders,
527
+ 'Set-Cookie': setCookieHeaders,
528
+ };
529
+ }
530
+ }
531
+
532
+ return lambdaResponse;
533
+ }
534
+
535
+ /**
536
+ * Convert Telemetry interface to Middy middleware
537
+ */
538
+ private telemetry(): Middleware<TEvent, TInput, TServices, TLogger> | null {
539
+ if (!this.options.telemetry) {
540
+ return null;
541
+ }
542
+
543
+ const telemetry = this.options.telemetry;
544
+ let ctx: any;
545
+
546
+ return {
547
+ before: (request) => {
548
+ ctx = telemetry.onRequestStart({
549
+ event: request.event,
550
+ context: request.context,
551
+ });
552
+ },
553
+ after: (request) => {
554
+ if (ctx) {
555
+ telemetry.onRequestEnd(ctx, {
556
+ statusCode: request.response?.statusCode ?? 200,
557
+ body: request.response?.body,
558
+ headers: request.response?.headers,
559
+ });
560
+ }
561
+ },
562
+ onError: (request) => {
563
+ if (ctx && request.error) {
564
+ telemetry.onRequestError(
565
+ ctx,
566
+ request.error instanceof Error
567
+ ? request.error
568
+ : new Error(String(request.error)),
569
+ );
570
+ }
571
+ },
572
+ };
573
+ }
574
+
575
+ get handler() {
576
+ const handler = this._handler.bind(this);
577
+ let chain = middy(handler)
578
+ .use(this.logger())
579
+ .use(this.error())
580
+ .use(this.services())
581
+ .use(this.input())
582
+ .use(this.database())
583
+ .use(this.session())
584
+ .use(this.authorize())
585
+ .use(this.events());
586
+
587
+ // Add telemetry middleware if configured (runs early for span creation)
588
+ const telemetryMiddleware = this.telemetry();
589
+ if (telemetryMiddleware) {
590
+ chain = chain.use(telemetryMiddleware);
591
+ }
592
+
593
+ // Add Telescope middleware if configured (runs first/last in chain)
594
+ if (this.options.telescope?.middleware) {
595
+ chain = chain.use(this.options.telescope.middleware);
596
+ }
597
+
598
+ // Wrap entire Middy chain in request context for service access
599
+ const wrappedHandler = async (event: TEvent, context: Context) => {
600
+ const startTime = Date.now();
601
+ const requestId = context.awsRequestId;
602
+ const logger = this.endpoint.logger.child({ requestId }) as TLogger;
603
+
604
+ // Cast event to any since Middy middlewares enrich the event with
605
+ // services, logger, session, etc. during the middleware chain execution
606
+ return runWithRequestContext(
607
+ { logger, requestId, startTime },
608
+ async () => {
609
+ const monitor = await startMonitors(
610
+ this.endpoint,
611
+ ServiceDiscovery.getInstance(this.envParser),
612
+ logger,
613
+ );
614
+ const response = await chain(
615
+ event as unknown as Parameters<typeof chain>[0],
616
+ context,
617
+ );
618
+ // Awaited: Lambda freezes the process once the response is
619
+ // returned, so an unawaited ping may never be sent.
620
+ await monitor.settle(
621
+ (response as any)?.statusCode ?? 200,
622
+ (event as any).__error,
623
+ );
624
+ return response;
625
+ },
626
+ );
627
+ };
628
+
629
+ return wrappedHandler as unknown as THandler;
630
+ }
631
+ }
632
+
633
+ export type Event<
634
+ TEvent extends APIGatewayProxyEvent | APIGatewayProxyEventV2,
635
+ TInput extends EndpointSchemas = {},
636
+ TServices extends Service[] = [],
637
+ TLogger extends Logger = Logger,
638
+ TSession = unknown,
639
+ > = {
640
+ services: ServiceRecord<TServices>;
641
+ logger: TLogger;
642
+ header: HeaderFn;
643
+ cookie: CookieFn;
644
+ session: TSession;
645
+ } & TEvent &
646
+ InferComposableStandardSchema<TInput>;
647
+
648
+ type Middleware<
649
+ TEvent extends APIGatewayProxyEvent | APIGatewayProxyEventV2,
650
+ TInput extends EndpointSchemas = {},
651
+ TServices extends Service[] = [],
652
+ TLogger extends Logger = Logger,
653
+ TSession = unknown,
654
+ > = MiddlewareObj<Event<TEvent, TInput, TServices, TLogger, TSession>>;
655
+
656
+ export type AmazonApiGatewayEndpointHandlerResponse = {
657
+ statusCode: number;
658
+ body: string | undefined;
659
+ headers?: Record<string, string>;
660
+ multiValueHeaders?: Record<string, string[]>;
661
+ };
662
+
663
+ export type LoggerContext = {
664
+ fn: {
665
+ name: string;
666
+ version: string;
667
+ };
668
+ req: {
669
+ id: string | undefined;
670
+ awsRequestId: string;
671
+ path: string;
672
+ ip: string | undefined;
673
+ userAgent: string | undefined;
674
+ };
675
+ };
676
+
677
+ export type GetInputResponse = {
678
+ body: any;
679
+ query: any;
680
+ params: any;
681
+ };
682
+
683
+ export type AmazonApiGatewayV1EndpointHandler = (
684
+ event: APIGatewayProxyEvent,
685
+ context: Context,
686
+ ) => Promise<AmazonApiGatewayEndpointHandlerResponse>;
687
+
688
+ export type AmazonApiGatewayV2EndpointHandler = (
689
+ event: APIGatewayProxyEventV2,
690
+ context: Context,
691
+ ) => Promise<AmazonApiGatewayEndpointHandlerResponse>;
692
+
693
+ export type HandlerEvent<T extends Function> = T extends (
694
+ event: infer E,
695
+ context: Context,
696
+ ) => any
697
+ ? E
698
+ : never;