@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,951 @@
1
+ import type { AuditableAction } from '@geekmidas/audit';
2
+ import {
3
+ type AuditLogTable,
4
+ KyselyAuditStorage,
5
+ } from '@geekmidas/audit/kysely';
6
+ import { EnvironmentParser } from '@geekmidas/envkit';
7
+ import type { Logger } from '@geekmidas/logger';
8
+ import type { Service } from '@geekmidas/services';
9
+ import { ServiceDiscovery } from '@geekmidas/services';
10
+ import { createMockContext, createMockV2Event } from '@geekmidas/testkit/aws';
11
+ import {
12
+ CamelCasePlugin,
13
+ type Generated,
14
+ Kysely,
15
+ PostgresDialect,
16
+ sql,
17
+ } from 'kysely';
18
+ import pg from 'pg';
19
+ import {
20
+ afterAll,
21
+ afterEach,
22
+ beforeAll,
23
+ beforeEach,
24
+ describe,
25
+ expect,
26
+ it,
27
+ vi,
28
+ } from 'vitest';
29
+ import { z } from 'zod';
30
+ import { TEST_DATABASE_CONFIG } from '../../../../testkit/test/globalSetup';
31
+ import { AmazonApiGatewayV2Endpoint } from '../AmazonApiGatewayV2EndpointAdaptor';
32
+ import type { MappedAudit } from '../audit';
33
+ import { Endpoint, type EndpointContext } from '../Endpoint';
34
+
35
+ // Database schema - use different table names to avoid conflicts with HonoEndpoint tests
36
+ interface TestDatabase {
37
+ awsAuditLogs: AuditLogTable;
38
+ awsUsers: {
39
+ id: Generated<number>;
40
+ name: string;
41
+ email: string;
42
+ };
43
+ }
44
+
45
+ // Audit action types
46
+ type TestAuditAction =
47
+ | AuditableAction<'user.created', { userId: number; email: string }>
48
+ | AuditableAction<'user.updated', { userId: number; changes: string[] }>
49
+ | AuditableAction<'user.deleted', { userId: number }>;
50
+
51
+ describe('AmazonApiGatewayV2Endpoint Kysely Audit Integration', () => {
52
+ let db: Kysely<TestDatabase>;
53
+ let auditStorage: KyselyAuditStorage<TestDatabase>;
54
+ let mockLogger: Logger;
55
+ let envParser: EnvironmentParser<{}>;
56
+
57
+ const createMockLogger = (): Logger => ({
58
+ debug: vi.fn(),
59
+ info: vi.fn(),
60
+ warn: vi.fn(),
61
+ error: vi.fn(),
62
+ fatal: vi.fn(),
63
+ trace: vi.fn(),
64
+ child: vi.fn(function (this: Logger) {
65
+ return this;
66
+ }),
67
+ });
68
+
69
+ beforeAll(async () => {
70
+ db = new Kysely<TestDatabase>({
71
+ dialect: new PostgresDialect({
72
+ pool: new pg.Pool({
73
+ ...TEST_DATABASE_CONFIG,
74
+ database: 'postgres',
75
+ }),
76
+ }),
77
+ plugins: [new CamelCasePlugin()],
78
+ });
79
+
80
+ // Create audit_logs table
81
+ await db.schema
82
+ .createTable('awsAuditLogs')
83
+ .ifNotExists()
84
+ .addColumn('id', 'varchar(32)', (col) => col.primaryKey())
85
+ .addColumn('type', 'varchar', (col) => col.notNull())
86
+ .addColumn('operation', 'varchar', (col) => col.notNull())
87
+ .addColumn('table', 'varchar')
88
+ .addColumn('entityId', 'varchar')
89
+ .addColumn('oldValues', 'jsonb')
90
+ .addColumn('newValues', 'jsonb')
91
+ .addColumn('payload', 'jsonb')
92
+ .addColumn('timestamp', 'timestamp', (col) =>
93
+ col.defaultTo(sql`now()`).notNull(),
94
+ )
95
+ .addColumn('actorId', 'varchar')
96
+ .addColumn('actorType', 'varchar')
97
+ .addColumn('actorData', 'jsonb')
98
+ .addColumn('metadata', 'jsonb')
99
+ .execute();
100
+
101
+ // Create users table
102
+ await db.schema
103
+ .createTable('awsUsers')
104
+ .ifNotExists()
105
+ .addColumn('id', 'serial', (col) => col.primaryKey())
106
+ .addColumn('name', 'varchar', (col) => col.notNull())
107
+ .addColumn('email', 'varchar', (col) => col.notNull().unique())
108
+ .execute();
109
+
110
+ auditStorage = new KyselyAuditStorage({
111
+ db,
112
+ tableName: 'awsAuditLogs',
113
+ });
114
+ });
115
+
116
+ beforeEach(() => {
117
+ mockLogger = createMockLogger();
118
+ envParser = new EnvironmentParser({});
119
+ ServiceDiscovery.reset();
120
+ });
121
+
122
+ afterEach(async () => {
123
+ await db.deleteFrom('awsAuditLogs').execute();
124
+ await db.deleteFrom('awsUsers').execute();
125
+ });
126
+
127
+ afterAll(async () => {
128
+ await db.schema.dropTable('awsAuditLogs').ifExists().execute();
129
+ await db.schema.dropTable('awsUsers').ifExists().execute();
130
+ await db.destroy();
131
+ });
132
+
133
+ describe('declarative audits with real database', () => {
134
+ it('should write declarative audit to database on successful request', async () => {
135
+ const auditStorageService: Service<
136
+ 'auditStorage',
137
+ KyselyAuditStorage<TestDatabase>
138
+ > = {
139
+ serviceName: 'auditStorage' as const,
140
+ register: vi.fn().mockResolvedValue(auditStorage),
141
+ };
142
+
143
+ const outputSchema = z.object({ id: z.number(), email: z.string() });
144
+
145
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
146
+ {
147
+ type: 'user.created',
148
+ payload: (response) => ({
149
+ userId: response.id,
150
+ email: response.email,
151
+ }),
152
+ },
153
+ ];
154
+
155
+ const endpoint = new Endpoint({
156
+ route: '/users',
157
+ method: 'POST',
158
+ fn: async () => {
159
+ return { id: 1, email: 'test@example.com' };
160
+ },
161
+ input: undefined,
162
+ output: outputSchema,
163
+ services: [],
164
+ logger: mockLogger,
165
+ timeout: undefined,
166
+ memorySize: undefined,
167
+ status: 201,
168
+ getSession: undefined,
169
+ authorize: undefined,
170
+ description: undefined,
171
+ events: [],
172
+ publisherService: undefined,
173
+ auditorStorageService: auditStorageService,
174
+ audits,
175
+ });
176
+
177
+ const adapter = new AmazonApiGatewayV2Endpoint(
178
+ envParser,
179
+ endpoint as any,
180
+ );
181
+ const handler = adapter.handler;
182
+
183
+ const event = createMockV2Event({
184
+ requestContext: {
185
+ ...createMockV2Event().requestContext,
186
+ http: {
187
+ method: 'POST',
188
+ path: '/users',
189
+ protocol: 'HTTP/1.1',
190
+ sourceIp: '192.168.1.1',
191
+ userAgent: 'test-agent',
192
+ },
193
+ },
194
+ body: JSON.stringify({}),
195
+ });
196
+ const context = createMockContext();
197
+ const response = await handler(event, context);
198
+
199
+ expect(response.statusCode).toBe(201);
200
+
201
+ // Verify audit was written to the real database
202
+ const auditsInDb = await db
203
+ .selectFrom('awsAuditLogs')
204
+ .selectAll()
205
+ .execute();
206
+
207
+ expect(auditsInDb).toHaveLength(1);
208
+ expect(auditsInDb[0].type).toBe('user.created');
209
+ expect(auditsInDb[0].payload).toEqual({
210
+ userId: 1,
211
+ email: 'test@example.com',
212
+ });
213
+ });
214
+
215
+ it('should not write audit when handler fails', async () => {
216
+ const auditStorageService: Service<
217
+ 'auditStorage',
218
+ KyselyAuditStorage<TestDatabase>
219
+ > = {
220
+ serviceName: 'auditStorage' as const,
221
+ register: vi.fn().mockResolvedValue(auditStorage),
222
+ };
223
+
224
+ const outputSchema = z.object({ id: z.number(), email: z.string() });
225
+
226
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
227
+ {
228
+ type: 'user.created',
229
+ payload: (response) => ({
230
+ userId: response.id,
231
+ email: response.email,
232
+ }),
233
+ },
234
+ ];
235
+
236
+ const endpoint = new Endpoint({
237
+ route: '/users',
238
+ method: 'POST',
239
+ fn: async () => {
240
+ throw new Error('Handler failed');
241
+ },
242
+ input: undefined,
243
+ output: outputSchema,
244
+ services: [],
245
+ logger: mockLogger,
246
+ timeout: undefined,
247
+ memorySize: undefined,
248
+ status: 201,
249
+ getSession: undefined,
250
+ authorize: undefined,
251
+ description: undefined,
252
+ events: [],
253
+ publisherService: undefined,
254
+ auditorStorageService: auditStorageService,
255
+ audits,
256
+ });
257
+
258
+ const adapter = new AmazonApiGatewayV2Endpoint(
259
+ envParser,
260
+ endpoint as any,
261
+ );
262
+ const handler = adapter.handler;
263
+
264
+ const event = createMockV2Event({
265
+ requestContext: {
266
+ ...createMockV2Event().requestContext,
267
+ http: {
268
+ method: 'POST',
269
+ path: '/users',
270
+ protocol: 'HTTP/1.1',
271
+ sourceIp: '192.168.1.1',
272
+ userAgent: 'test-agent',
273
+ },
274
+ },
275
+ body: JSON.stringify({}),
276
+ });
277
+ const context = createMockContext();
278
+ const response = await handler(event, context);
279
+
280
+ expect(response.statusCode).toBe(500);
281
+
282
+ // Verify no audit was written
283
+ const auditsInDb = await db
284
+ .selectFrom('awsAuditLogs')
285
+ .selectAll()
286
+ .execute();
287
+
288
+ expect(auditsInDb).toHaveLength(0);
289
+ });
290
+ });
291
+
292
+ describe('manual audits with real database', () => {
293
+ it('should write manual audits from handler to database', async () => {
294
+ const auditStorageService: Service<
295
+ 'auditStorage',
296
+ KyselyAuditStorage<TestDatabase>
297
+ > = {
298
+ serviceName: 'auditStorage' as const,
299
+ register: vi.fn().mockResolvedValue(auditStorage),
300
+ };
301
+
302
+ const outputSchema = z.object({ id: z.number(), email: z.string() });
303
+
304
+ const endpoint = new Endpoint({
305
+ route: '/users',
306
+ method: 'POST',
307
+ fn: async (
308
+ ctx: EndpointContext<
309
+ undefined,
310
+ [],
311
+ Logger,
312
+ unknown,
313
+ TestAuditAction,
314
+ undefined,
315
+ KyselyAuditStorage<TestDatabase>
316
+ >,
317
+ ) => {
318
+ // Manual audit in handler - auditor is guaranteed to exist when TAuditStorage is configured
319
+ ctx.auditor.audit('user.created', {
320
+ userId: 42,
321
+ email: 'manual@example.com',
322
+ });
323
+
324
+ return { id: 42, email: 'manual@example.com' };
325
+ },
326
+ input: undefined,
327
+ output: outputSchema,
328
+ services: [],
329
+ logger: mockLogger,
330
+ timeout: undefined,
331
+ memorySize: undefined,
332
+ status: 201,
333
+ getSession: undefined,
334
+ authorize: undefined,
335
+ description: undefined,
336
+ events: [],
337
+ publisherService: undefined,
338
+ auditorStorageService: auditStorageService,
339
+ audits: [],
340
+ });
341
+
342
+ const adapter = new AmazonApiGatewayV2Endpoint(
343
+ envParser,
344
+ endpoint as any,
345
+ );
346
+ const handler = adapter.handler;
347
+
348
+ const event = createMockV2Event({
349
+ requestContext: {
350
+ ...createMockV2Event().requestContext,
351
+ http: {
352
+ method: 'POST',
353
+ path: '/users',
354
+ protocol: 'HTTP/1.1',
355
+ sourceIp: '192.168.1.1',
356
+ userAgent: 'test-agent',
357
+ },
358
+ },
359
+ body: JSON.stringify({}),
360
+ });
361
+ const context = createMockContext();
362
+ const response = await handler(event, context);
363
+
364
+ expect(response.statusCode).toBe(201);
365
+
366
+ // Verify manual audit was written
367
+ const auditsInDb = await db
368
+ .selectFrom('awsAuditLogs')
369
+ .selectAll()
370
+ .execute();
371
+
372
+ expect(auditsInDb).toHaveLength(1);
373
+ expect(auditsInDb[0].type).toBe('user.created');
374
+ expect(auditsInDb[0].payload).toEqual({
375
+ userId: 42,
376
+ email: 'manual@example.com',
377
+ });
378
+ });
379
+
380
+ it('should not write manual audit when handler fails after audit call', async () => {
381
+ const auditStorageService: Service<
382
+ 'auditStorage',
383
+ KyselyAuditStorage<TestDatabase>
384
+ > = {
385
+ serviceName: 'auditStorage' as const,
386
+ register: vi.fn().mockResolvedValue(auditStorage),
387
+ };
388
+
389
+ const outputSchema = z.object({ id: z.number(), email: z.string() });
390
+
391
+ const endpoint = new Endpoint({
392
+ route: '/users',
393
+ method: 'POST',
394
+ fn: async (
395
+ ctx: EndpointContext<
396
+ undefined,
397
+ [],
398
+ Logger,
399
+ unknown,
400
+ TestAuditAction,
401
+ undefined,
402
+ KyselyAuditStorage<TestDatabase>
403
+ >,
404
+ ) => {
405
+ // Manual audit before failure - auditor is guaranteed to exist
406
+ ctx.auditor.audit('user.created', {
407
+ userId: 99,
408
+ email: 'shouldnotexist@example.com',
409
+ });
410
+
411
+ // Fail after audit
412
+ throw new Error('Handler failed after audit');
413
+ },
414
+ input: undefined,
415
+ output: outputSchema,
416
+ services: [],
417
+ logger: mockLogger,
418
+ timeout: undefined,
419
+ memorySize: undefined,
420
+ status: 201,
421
+ getSession: undefined,
422
+ authorize: undefined,
423
+ description: undefined,
424
+ events: [],
425
+ publisherService: undefined,
426
+ auditorStorageService: auditStorageService,
427
+ audits: [],
428
+ });
429
+
430
+ const adapter = new AmazonApiGatewayV2Endpoint(
431
+ envParser,
432
+ endpoint as any,
433
+ );
434
+ const handler = adapter.handler;
435
+
436
+ const event = createMockV2Event({
437
+ requestContext: {
438
+ ...createMockV2Event().requestContext,
439
+ http: {
440
+ method: 'POST',
441
+ path: '/users',
442
+ protocol: 'HTTP/1.1',
443
+ sourceIp: '192.168.1.1',
444
+ userAgent: 'test-agent',
445
+ },
446
+ },
447
+ body: JSON.stringify({}),
448
+ });
449
+ const context = createMockContext();
450
+ const response = await handler(event, context);
451
+
452
+ expect(response.statusCode).toBe(500);
453
+
454
+ // Verify no audit was written (transaction rolled back)
455
+ const auditsInDb = await db
456
+ .selectFrom('awsAuditLogs')
457
+ .selectAll()
458
+ .execute();
459
+
460
+ expect(auditsInDb).toHaveLength(0);
461
+ });
462
+ });
463
+
464
+ describe('transactional consistency with real database', () => {
465
+ it('should commit both user insert and audit on success', async () => {
466
+ const databaseService: Service<'database', Kysely<TestDatabase>> = {
467
+ serviceName: 'database' as const,
468
+ register: vi.fn().mockResolvedValue(db),
469
+ };
470
+
471
+ const auditStorageService: Service<
472
+ 'auditStorage',
473
+ KyselyAuditStorage<TestDatabase>
474
+ > = {
475
+ serviceName: 'auditStorage' as const,
476
+ register: vi.fn().mockResolvedValue(auditStorage),
477
+ };
478
+
479
+ const outputSchema = z.object({ id: z.number(), email: z.string() });
480
+
481
+ const endpoint = new Endpoint({
482
+ route: '/users',
483
+ method: 'POST',
484
+ fn: async (
485
+ ctx: EndpointContext<
486
+ undefined,
487
+ [typeof databaseService],
488
+ Logger,
489
+ unknown,
490
+ TestAuditAction,
491
+ undefined,
492
+ KyselyAuditStorage<TestDatabase>
493
+ >,
494
+ ) => {
495
+ const database = ctx.services.database;
496
+
497
+ // Insert user
498
+ const user = await database
499
+ .insertInto('awsUsers')
500
+ .values({ name: 'Success User', email: 'success@example.com' })
501
+ .returningAll()
502
+ .executeTakeFirstOrThrow();
503
+
504
+ // Record audit - auditor is guaranteed to exist
505
+ ctx.auditor.audit('user.created', {
506
+ userId: user.id,
507
+ email: user.email,
508
+ });
509
+
510
+ return { id: user.id, email: user.email };
511
+ },
512
+ input: undefined,
513
+ output: outputSchema,
514
+ services: [databaseService],
515
+ logger: mockLogger,
516
+ timeout: undefined,
517
+ memorySize: undefined,
518
+ status: 201,
519
+ getSession: undefined,
520
+ authorize: undefined,
521
+ description: undefined,
522
+ events: [],
523
+ publisherService: undefined,
524
+ auditorStorageService: auditStorageService,
525
+ audits: [],
526
+ });
527
+
528
+ const adapter = new AmazonApiGatewayV2Endpoint(
529
+ envParser,
530
+ endpoint as any,
531
+ );
532
+ const handler = adapter.handler;
533
+
534
+ const event = createMockV2Event({
535
+ requestContext: {
536
+ ...createMockV2Event().requestContext,
537
+ http: {
538
+ method: 'POST',
539
+ path: '/users',
540
+ protocol: 'HTTP/1.1',
541
+ sourceIp: '192.168.1.1',
542
+ userAgent: 'test-agent',
543
+ },
544
+ },
545
+ body: JSON.stringify({}),
546
+ });
547
+ const context = createMockContext();
548
+ const response = await handler(event, context);
549
+
550
+ expect(response.statusCode).toBe(201);
551
+
552
+ // Verify user was created
553
+ const usersInDb = await db.selectFrom('awsUsers').selectAll().execute();
554
+ expect(usersInDb).toHaveLength(1);
555
+ expect(usersInDb[0].email).toBe('success@example.com');
556
+
557
+ // Verify audit was written
558
+ const auditsInDb = await db
559
+ .selectFrom('awsAuditLogs')
560
+ .selectAll()
561
+ .execute();
562
+ expect(auditsInDb).toHaveLength(1);
563
+ expect(auditsInDb[0].type).toBe('user.created');
564
+ expect(auditsInDb[0].payload).toEqual({
565
+ userId: usersInDb[0].id,
566
+ email: 'success@example.com',
567
+ });
568
+ });
569
+
570
+ it('should handle combined declarative and manual audits', async () => {
571
+ const auditStorageService: Service<
572
+ 'auditStorage',
573
+ KyselyAuditStorage<TestDatabase>
574
+ > = {
575
+ serviceName: 'auditStorage' as const,
576
+ register: vi.fn().mockResolvedValue(auditStorage),
577
+ };
578
+
579
+ const outputSchema = z.object({ id: z.number(), email: z.string() });
580
+
581
+ // Declarative audit
582
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
583
+ {
584
+ type: 'user.created',
585
+ payload: (response) => ({
586
+ userId: response.id,
587
+ email: response.email,
588
+ }),
589
+ },
590
+ ];
591
+
592
+ const endpoint = new Endpoint({
593
+ route: '/users',
594
+ method: 'POST',
595
+ fn: async (
596
+ ctx: EndpointContext<
597
+ undefined,
598
+ [],
599
+ Logger,
600
+ unknown,
601
+ TestAuditAction,
602
+ undefined,
603
+ KyselyAuditStorage<TestDatabase>
604
+ >,
605
+ ) => {
606
+ // Manual audit - auditor is guaranteed to exist
607
+ ctx.auditor.audit('user.updated', {
608
+ userId: 100,
609
+ changes: ['verified'],
610
+ });
611
+
612
+ return { id: 100, email: 'combined@example.com' };
613
+ },
614
+ input: undefined,
615
+ output: outputSchema,
616
+ services: [],
617
+ logger: mockLogger,
618
+ timeout: undefined,
619
+ memorySize: undefined,
620
+ status: 201,
621
+ getSession: undefined,
622
+ authorize: undefined,
623
+ description: undefined,
624
+ events: [],
625
+ publisherService: undefined,
626
+ auditorStorageService: auditStorageService,
627
+ audits,
628
+ });
629
+
630
+ const adapter = new AmazonApiGatewayV2Endpoint(
631
+ envParser,
632
+ endpoint as any,
633
+ );
634
+ const handler = adapter.handler;
635
+
636
+ const event = createMockV2Event({
637
+ requestContext: {
638
+ ...createMockV2Event().requestContext,
639
+ http: {
640
+ method: 'POST',
641
+ path: '/users',
642
+ protocol: 'HTTP/1.1',
643
+ sourceIp: '192.168.1.1',
644
+ userAgent: 'test-agent',
645
+ },
646
+ },
647
+ body: JSON.stringify({}),
648
+ });
649
+ const context = createMockContext();
650
+ const response = await handler(event, context);
651
+
652
+ expect(response.statusCode).toBe(201);
653
+
654
+ // Verify both audits were written
655
+ const auditsInDb = await db
656
+ .selectFrom('awsAuditLogs')
657
+ .selectAll()
658
+ .execute();
659
+
660
+ expect(auditsInDb).toHaveLength(2);
661
+
662
+ const auditTypes = auditsInDb.map((a) => a.type).sort();
663
+ expect(auditTypes).toEqual(['user.created', 'user.updated']);
664
+ });
665
+ });
666
+
667
+ describe('actor extraction with real database', () => {
668
+ it('should include actor information in audit records', async () => {
669
+ const auditStorageService: Service<
670
+ 'auditStorage',
671
+ KyselyAuditStorage<TestDatabase>
672
+ > = {
673
+ serviceName: 'auditStorage' as const,
674
+ register: vi.fn().mockResolvedValue(auditStorage),
675
+ };
676
+
677
+ const outputSchema = z.object({ id: z.number(), email: z.string() });
678
+
679
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
680
+ {
681
+ type: 'user.created',
682
+ payload: (response) => ({
683
+ userId: response.id,
684
+ email: response.email,
685
+ }),
686
+ },
687
+ ];
688
+
689
+ const endpoint = new Endpoint({
690
+ route: '/users',
691
+ method: 'POST',
692
+ fn: async () => {
693
+ return { id: 1, email: 'actor-test@example.com' };
694
+ },
695
+ input: undefined,
696
+ output: outputSchema,
697
+ services: [],
698
+ logger: mockLogger,
699
+ timeout: undefined,
700
+ memorySize: undefined,
701
+ status: 201,
702
+ getSession: undefined,
703
+ authorize: undefined,
704
+ description: undefined,
705
+ events: [],
706
+ publisherService: undefined,
707
+ auditorStorageService: auditStorageService,
708
+ audits,
709
+ actorExtractor: async ({ header }) => {
710
+ const userId = header('x-user-id');
711
+ return {
712
+ id: userId ?? 'anonymous',
713
+ type: userId ? 'user' : 'anonymous',
714
+ };
715
+ },
716
+ });
717
+
718
+ const adapter = new AmazonApiGatewayV2Endpoint(
719
+ envParser,
720
+ endpoint as any,
721
+ );
722
+ const handler = adapter.handler;
723
+
724
+ const event = createMockV2Event({
725
+ requestContext: {
726
+ ...createMockV2Event().requestContext,
727
+ http: {
728
+ method: 'POST',
729
+ path: '/users',
730
+ protocol: 'HTTP/1.1',
731
+ sourceIp: '192.168.1.1',
732
+ userAgent: 'test-agent',
733
+ },
734
+ },
735
+ headers: {
736
+ 'content-type': 'application/json',
737
+ 'x-user-id': 'user-123',
738
+ },
739
+ body: JSON.stringify({}),
740
+ });
741
+ const context = createMockContext();
742
+ const response = await handler(event, context);
743
+
744
+ expect(response.statusCode).toBe(201);
745
+
746
+ // Verify actor was included in audit
747
+ const auditsInDb = await db
748
+ .selectFrom('awsAuditLogs')
749
+ .selectAll()
750
+ .execute();
751
+
752
+ expect(auditsInDb).toHaveLength(1);
753
+ expect(auditsInDb[0].actorId).toBe('user-123');
754
+ expect(auditsInDb[0].actorType).toBe('user');
755
+ });
756
+ });
757
+
758
+ describe('RLS context with real database', () => {
759
+ it('should set RLS context variables in transaction', async () => {
760
+ const databaseService: Service<'database', Kysely<TestDatabase>> = {
761
+ serviceName: 'database' as const,
762
+ register: vi.fn().mockResolvedValue(db),
763
+ };
764
+
765
+ type TestSession = { userId: string; tenantId: string };
766
+
767
+ const outputSchema = z.object({
768
+ userId: z.string(),
769
+ tenantId: z.string(),
770
+ });
771
+
772
+ const endpoint = new Endpoint({
773
+ route: '/rls-test',
774
+ method: 'GET',
775
+ fn: async (ctx) => {
776
+ // Query the session variables to verify they were set
777
+ const userIdResult = await sql<{ value: string }>`
778
+ SELECT current_setting('app.user_id', true) as value
779
+ `.execute(ctx.db);
780
+
781
+ const tenantIdResult = await sql<{ value: string }>`
782
+ SELECT current_setting('app.tenant_id', true) as value
783
+ `.execute(ctx.db);
784
+
785
+ return {
786
+ userId: userIdResult.rows[0]?.value ?? 'not-set',
787
+ tenantId: tenantIdResult.rows[0]?.value ?? 'not-set',
788
+ };
789
+ },
790
+ input: undefined,
791
+ output: outputSchema,
792
+ services: [databaseService],
793
+ logger: mockLogger,
794
+ timeout: undefined,
795
+ memorySize: undefined,
796
+ status: 200,
797
+ getSession: async () => ({
798
+ userId: 'test-user-123',
799
+ tenantId: 'test-tenant-456',
800
+ }),
801
+ authorize: undefined,
802
+ description: undefined,
803
+ databaseService,
804
+ rlsConfig: {
805
+ extractor: async ({ session }) => ({
806
+ user_id: session.userId,
807
+ tenant_id: session.tenantId,
808
+ }),
809
+ prefix: 'app',
810
+ },
811
+ rlsBypass: false,
812
+ });
813
+
814
+ const adapter = new AmazonApiGatewayV2Endpoint(
815
+ envParser,
816
+ endpoint as any,
817
+ );
818
+ const handler = adapter.handler;
819
+
820
+ const event = createMockV2Event();
821
+ const context = createMockContext();
822
+ const response = await handler(event, context);
823
+
824
+ expect(response.statusCode).toBe(200);
825
+
826
+ const body = JSON.parse(response.body!);
827
+ expect(body.userId).toBe('test-user-123');
828
+ expect(body.tenantId).toBe('test-tenant-456');
829
+ });
830
+
831
+ it('should bypass RLS when rlsBypass is true', async () => {
832
+ const databaseService: Service<'database', Kysely<TestDatabase>> = {
833
+ serviceName: 'database' as const,
834
+ register: vi.fn().mockResolvedValue(db),
835
+ };
836
+
837
+ type TestSession = { userId: string };
838
+
839
+ const outputSchema = z.object({ userId: z.string() });
840
+
841
+ const endpoint = new Endpoint({
842
+ route: '/admin/rls-bypass',
843
+ method: 'GET',
844
+ fn: async (ctx) => {
845
+ // Query the session variable - should not be set when bypassed
846
+ const userIdResult = await sql<{ value: string | null }>`
847
+ SELECT current_setting('app.user_id', true) as value
848
+ `.execute(ctx.db);
849
+
850
+ // current_setting returns empty string when not set
851
+ return {
852
+ userId: userIdResult.rows[0]?.value || 'not-set',
853
+ };
854
+ },
855
+ input: undefined,
856
+ output: outputSchema,
857
+ services: [databaseService],
858
+ logger: mockLogger,
859
+ timeout: undefined,
860
+ memorySize: undefined,
861
+ status: 200,
862
+ getSession: async () => ({ userId: 'admin-user' }),
863
+ authorize: undefined,
864
+ description: undefined,
865
+ databaseService,
866
+ rlsConfig: {
867
+ extractor: async ({ session }) => ({
868
+ user_id: session.userId,
869
+ }),
870
+ prefix: 'app',
871
+ },
872
+ rlsBypass: true, // Bypass RLS
873
+ });
874
+
875
+ const adapter = new AmazonApiGatewayV2Endpoint(
876
+ envParser,
877
+ endpoint as any,
878
+ );
879
+ const handler = adapter.handler;
880
+
881
+ const event = createMockV2Event();
882
+ const context = createMockContext();
883
+ const response = await handler(event, context);
884
+
885
+ expect(response.statusCode).toBe(200);
886
+
887
+ const body = JSON.parse(response.body!);
888
+ // When bypassed, the RLS context should not be set (returns 'not-set')
889
+ expect(body.userId).toBe('not-set');
890
+ });
891
+
892
+ it('should use custom prefix for RLS context variables', async () => {
893
+ const databaseService: Service<'database', Kysely<TestDatabase>> = {
894
+ serviceName: 'database' as const,
895
+ register: vi.fn().mockResolvedValue(db),
896
+ };
897
+
898
+ type TestSession = { userId: string };
899
+
900
+ const outputSchema = z.object({ userId: z.string() });
901
+
902
+ const endpoint = new Endpoint({
903
+ route: '/custom-prefix',
904
+ method: 'GET',
905
+ fn: async (ctx) => {
906
+ // Query the session variable with custom prefix
907
+ const userIdResult = await sql<{ value: string }>`
908
+ SELECT current_setting('myapp.user_id', true) as value
909
+ `.execute(ctx.db);
910
+
911
+ return {
912
+ userId: userIdResult.rows[0]?.value ?? 'not-set',
913
+ };
914
+ },
915
+ input: undefined,
916
+ output: outputSchema,
917
+ services: [databaseService],
918
+ logger: mockLogger,
919
+ timeout: undefined,
920
+ memorySize: undefined,
921
+ status: 200,
922
+ getSession: async () => ({ userId: 'custom-user' }),
923
+ authorize: undefined,
924
+ description: undefined,
925
+ databaseService,
926
+ rlsConfig: {
927
+ extractor: async ({ session }) => ({
928
+ user_id: session.userId,
929
+ }),
930
+ prefix: 'myapp', // Custom prefix
931
+ },
932
+ rlsBypass: false,
933
+ });
934
+
935
+ const adapter = new AmazonApiGatewayV2Endpoint(
936
+ envParser,
937
+ endpoint as any,
938
+ );
939
+ const handler = adapter.handler;
940
+
941
+ const event = createMockV2Event();
942
+ const context = createMockContext();
943
+ const response = await handler(event, context);
944
+
945
+ expect(response.statusCode).toBe(200);
946
+
947
+ const body = JSON.parse(response.body!);
948
+ expect(body.userId).toBe('custom-user');
949
+ });
950
+ });
951
+ });