@geekmidas/constructs 7.0.1 → 10.0.0-alpha.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 (385) hide show
  1. package/README.md +71 -44
  2. package/dist/{AWSScheduledFunction-ysaCsdWx.d.mts → AWSScheduledFunction-BvFvBsBN.d.cts} +10 -5
  3. package/dist/{AWSScheduledFunction-ysaCsdWx.d.mts.map → AWSScheduledFunction-BvFvBsBN.d.cts.map} +1 -1
  4. package/dist/{AWSScheduledFunction-CTIa90EH.d.cts → AWSScheduledFunction-CVccZO-L.d.mts} +10 -5
  5. package/dist/{AWSScheduledFunction-CTIa90EH.d.cts.map → AWSScheduledFunction-CVccZO-L.d.mts.map} +1 -1
  6. package/dist/{AWSScheduledFunction-CufMMhGB.mjs → AWSScheduledFunction-Db1lttJH.mjs} +3 -3
  7. package/dist/{AWSScheduledFunction-CufMMhGB.mjs.map → AWSScheduledFunction-Db1lttJH.mjs.map} +1 -1
  8. package/dist/{AWSScheduledFunction-DbkDr8CA.cjs → AWSScheduledFunction-qu4ieRZR.cjs} +9 -9
  9. package/dist/{AWSScheduledFunction-DbkDr8CA.cjs.map → AWSScheduledFunction-qu4ieRZR.cjs.map} +1 -1
  10. package/dist/{Construct-_1wX7p_Y.d.cts → Construct-B-xc0SE9.d.mts} +27 -5
  11. package/dist/Construct-B-xc0SE9.d.mts.map +1 -0
  12. package/dist/{Construct-r0U2zBwW.mjs → Construct-HmWM6YYu.mjs} +4 -3
  13. package/dist/Construct-HmWM6YYu.mjs.map +1 -0
  14. package/dist/{Construct-DCMuYOox.d.mts → Construct-WhCXIOPV.d.cts} +29 -7
  15. package/dist/Construct-WhCXIOPV.d.cts.map +1 -0
  16. package/dist/{Construct-vXMZJgRp.cjs → Construct-roId57cU.cjs} +7 -43
  17. package/dist/Construct-roId57cU.cjs.map +1 -0
  18. package/dist/{lazyAccessors-DmTG8sQH.cjs → Endpoint-BBkV6l0k.cjs} +869 -1079
  19. package/dist/Endpoint-BBkV6l0k.cjs.map +1 -0
  20. package/dist/{lazyAccessors-DfqZR6C4.mjs → Endpoint-BGwpNEX4.mjs} +840 -1003
  21. package/dist/Endpoint-BGwpNEX4.mjs.map +1 -0
  22. package/dist/{Endpoint-CAzNbDEt.d.cts → Endpoint-BnxZqIX-.d.cts} +53 -4
  23. package/dist/Endpoint-BnxZqIX-.d.cts.map +1 -0
  24. package/dist/{Endpoint-CLPSIl6S.d.mts → Endpoint-ROcXU-eH.d.mts} +55 -6
  25. package/dist/Endpoint-ROcXU-eH.d.mts.map +1 -0
  26. package/dist/EndpointFactory-DYoGLaIT.cjs +850 -0
  27. package/dist/EndpointFactory-DYoGLaIT.cjs.map +1 -0
  28. package/dist/EndpointFactory-Di0X9AWp.mjs +808 -0
  29. package/dist/EndpointFactory-Di0X9AWp.mjs.map +1 -0
  30. package/dist/{HonoEndpointAdaptor-DJDT3PMx.mjs → HonoEndpointAdaptor-DFKIIG2o.mjs} +5 -4
  31. package/dist/HonoEndpointAdaptor-DFKIIG2o.mjs.map +1 -0
  32. package/dist/{HonoEndpointAdaptor-CkJENANP.cjs → HonoEndpointAdaptor-wMsCyMgt.cjs} +24 -23
  33. package/dist/HonoEndpointAdaptor-wMsCyMgt.cjs.map +1 -0
  34. package/dist/{Queue-DaxjwmOQ.d.cts → Queue-D6WeziRD.d.cts} +43 -4
  35. package/dist/Queue-D6WeziRD.d.cts.map +1 -0
  36. package/dist/{Queue-HBDf0fqz.d.mts → Queue-DpUeqdC8.d.mts} +43 -4
  37. package/dist/Queue-DpUeqdC8.d.mts.map +1 -0
  38. package/dist/{Subscriber-B69ngPwl.d.cts → Subscriber-4rBJgDKI.d.mts} +9 -4
  39. package/dist/{Subscriber-B69ngPwl.d.cts.map → Subscriber-4rBJgDKI.d.mts.map} +1 -1
  40. package/dist/{Subscriber-D8Xm-86W.d.mts → Subscriber-DVQowdyj.d.cts} +11 -6
  41. package/dist/Subscriber-DVQowdyj.d.cts.map +1 -0
  42. package/dist/{Topic-C5ZMfveW.d.cts → Topic-Ohx9dvWr.d.cts} +33 -2
  43. package/dist/Topic-Ohx9dvWr.d.cts.map +1 -0
  44. package/dist/{Topic-DT10AqHk.d.mts → Topic-cmy2jOUy.d.mts} +33 -2
  45. package/dist/Topic-cmy2jOUy.d.mts.map +1 -0
  46. package/dist/adaptors/aws.cjs +39 -26
  47. package/dist/adaptors/aws.cjs.map +1 -1
  48. package/dist/adaptors/aws.d.cts +24 -16
  49. package/dist/adaptors/aws.d.cts.map +1 -1
  50. package/dist/adaptors/aws.d.mts +25 -17
  51. package/dist/adaptors/aws.d.mts.map +1 -1
  52. package/dist/adaptors/aws.mjs +26 -14
  53. package/dist/adaptors/aws.mjs.map +1 -1
  54. package/dist/adaptors/hono.cjs +9 -6
  55. package/dist/adaptors/hono.d.cts +7 -6
  56. package/dist/adaptors/hono.d.cts.map +1 -1
  57. package/dist/adaptors/hono.d.mts +8 -7
  58. package/dist/adaptors/hono.d.mts.map +1 -1
  59. package/dist/adaptors/hono.mjs +9 -6
  60. package/dist/adaptors/testing.cjs +18 -14
  61. package/dist/adaptors/testing.cjs.map +1 -1
  62. package/dist/adaptors/testing.d.cts +7 -6
  63. package/dist/adaptors/testing.d.cts.map +1 -1
  64. package/dist/adaptors/testing.d.mts +11 -10
  65. package/dist/adaptors/testing.d.mts.map +1 -1
  66. package/dist/adaptors/testing.mjs +10 -7
  67. package/dist/adaptors/testing.mjs.map +1 -1
  68. package/dist/auth.cjs +165 -0
  69. package/dist/auth.cjs.map +1 -0
  70. package/dist/auth.d.cts +108 -0
  71. package/dist/auth.d.cts.map +1 -0
  72. package/dist/auth.d.mts +108 -0
  73. package/dist/auth.d.mts.map +1 -0
  74. package/dist/auth.mjs +164 -0
  75. package/dist/auth.mjs.map +1 -0
  76. package/dist/cache-0ANvRQnD.mjs +51 -0
  77. package/dist/cache-0ANvRQnD.mjs.map +1 -0
  78. package/dist/cache-3WSvAulx.cjs +57 -0
  79. package/dist/cache-3WSvAulx.cjs.map +1 -0
  80. package/dist/cache-CdQ7OLpR.d.cts +47 -0
  81. package/dist/cache-CdQ7OLpR.d.cts.map +1 -0
  82. package/dist/cache-DYoJFcfd.d.mts +47 -0
  83. package/dist/cache-DYoJFcfd.d.mts.map +1 -0
  84. package/dist/cache.cjs +3 -0
  85. package/dist/cache.d.cts +3 -0
  86. package/dist/cache.d.mts +3 -0
  87. package/dist/cache.mjs +3 -0
  88. package/dist/chunk-DWy1uDak.cjs +39 -0
  89. package/dist/clone-DblgEZZa.mjs +39 -0
  90. package/dist/clone-DblgEZZa.mjs.map +1 -0
  91. package/dist/clone-Dy0cR2SZ.cjs +45 -0
  92. package/dist/clone-Dy0cR2SZ.cjs.map +1 -0
  93. package/dist/construct-interface-BfjcOD_E.cjs +117 -0
  94. package/dist/construct-interface-BfjcOD_E.cjs.map +1 -0
  95. package/dist/construct-interface-BqwRNYA2.d.mts +131 -0
  96. package/dist/construct-interface-BqwRNYA2.d.mts.map +1 -0
  97. package/dist/construct-interface-D2nNkHUN.d.cts +131 -0
  98. package/dist/construct-interface-D2nNkHUN.d.cts.map +1 -0
  99. package/dist/construct-interface-Z4CpS8tK.mjs +81 -0
  100. package/dist/construct-interface-Z4CpS8tK.mjs.map +1 -0
  101. package/dist/construct-interface.cjs +8 -0
  102. package/dist/construct-interface.d.cts +2 -0
  103. package/dist/construct-interface.d.mts +2 -0
  104. package/dist/construct-interface.mjs +3 -0
  105. package/dist/credential.cjs +96 -0
  106. package/dist/credential.cjs.map +1 -0
  107. package/dist/credential.d.cts +61 -0
  108. package/dist/credential.d.cts.map +1 -0
  109. package/dist/credential.d.mts +61 -0
  110. package/dist/credential.d.mts.map +1 -0
  111. package/dist/credential.mjs +94 -0
  112. package/dist/credential.mjs.map +1 -0
  113. package/dist/crons/index.cjs +39 -37
  114. package/dist/crons/index.cjs.map +1 -1
  115. package/dist/crons/index.d.cts +21 -8
  116. package/dist/crons/index.d.cts.map +1 -1
  117. package/dist/crons/index.d.mts +29 -13
  118. package/dist/crons/index.d.mts.map +1 -1
  119. package/dist/crons/index.mjs +37 -36
  120. package/dist/crons/index.mjs.map +1 -1
  121. package/dist/database/kysely.cjs +181 -0
  122. package/dist/database/kysely.cjs.map +1 -0
  123. package/dist/database/kysely.d.cts +152 -0
  124. package/dist/database/kysely.d.cts.map +1 -0
  125. package/dist/database/kysely.d.mts +152 -0
  126. package/dist/database/kysely.d.mts.map +1 -0
  127. package/dist/database/kysely.mjs +180 -0
  128. package/dist/database/kysely.mjs.map +1 -0
  129. package/dist/email.cjs +59 -0
  130. package/dist/email.cjs.map +1 -0
  131. package/dist/email.d.cts +50 -0
  132. package/dist/email.d.cts.map +1 -0
  133. package/dist/email.d.mts +50 -0
  134. package/dist/email.d.mts.map +1 -0
  135. package/dist/email.mjs +58 -0
  136. package/dist/email.mjs.map +1 -0
  137. package/dist/endpoints/index.cjs +21 -747
  138. package/dist/endpoints/index.d.cts +7 -343
  139. package/dist/endpoints/index.d.mts +7 -342
  140. package/dist/endpoints/index.mjs +11 -738
  141. package/dist/file-server.cjs +154 -0
  142. package/dist/file-server.cjs.map +1 -0
  143. package/dist/file-server.d.cts +156 -0
  144. package/dist/file-server.d.cts.map +1 -0
  145. package/dist/file-server.d.mts +156 -0
  146. package/dist/file-server.d.mts.map +1 -0
  147. package/dist/file-server.mjs +152 -0
  148. package/dist/file-server.mjs.map +1 -0
  149. package/dist/functions/index.cjs +4 -2
  150. package/dist/functions/index.d.cts +3 -2
  151. package/dist/functions/index.d.mts +3 -2
  152. package/dist/functions/index.mjs +4 -2
  153. package/dist/{functions-B-qt91O7.mjs → functions-CvT_q7Y4.mjs} +55 -51
  154. package/dist/functions-CvT_q7Y4.mjs.map +1 -0
  155. package/dist/{functions-C8i1kCMM.cjs → functions-DukjG8ov.cjs} +62 -57
  156. package/dist/functions-DukjG8ov.cjs.map +1 -0
  157. package/dist/index-7OcOWe75.d.cts +419 -0
  158. package/dist/index-7OcOWe75.d.cts.map +1 -0
  159. package/dist/index-Bt-F7u8L.d.mts +419 -0
  160. package/dist/index-Bt-F7u8L.d.mts.map +1 -0
  161. package/dist/{index-DP6fqv0I.d.mts → index-CPeqtKgq.d.mts} +48 -19
  162. package/dist/index-CPeqtKgq.d.mts.map +1 -0
  163. package/dist/{index-BGeTScmi.d.cts → index-Dadljnh_.d.cts} +36 -9
  164. package/dist/index-Dadljnh_.d.cts.map +1 -0
  165. package/dist/index.cjs +1 -1
  166. package/dist/index.d.cts +3 -3
  167. package/dist/index.d.mts +3 -3
  168. package/dist/index.mjs +1 -1
  169. package/dist/lazyAccessors-DM6HcXQk.mjs +175 -0
  170. package/dist/lazyAccessors-DM6HcXQk.mjs.map +1 -0
  171. package/dist/lazyAccessors-DrJj8NpA.cjs +223 -0
  172. package/dist/lazyAccessors-DrJj8NpA.cjs.map +1 -0
  173. package/dist/object-storage.cjs +48 -0
  174. package/dist/object-storage.cjs.map +1 -0
  175. package/dist/object-storage.d.cts +36 -0
  176. package/dist/object-storage.d.cts.map +1 -0
  177. package/dist/object-storage.d.mts +36 -0
  178. package/dist/object-storage.d.mts.map +1 -0
  179. package/dist/object-storage.mjs +47 -0
  180. package/dist/object-storage.mjs.map +1 -0
  181. package/dist/{processAudits-CKjjivyz.cjs → processAudits-Bc8rz6Ev.cjs} +3 -3
  182. package/dist/{processAudits-CKjjivyz.cjs.map → processAudits-Bc8rz6Ev.cjs.map} +1 -1
  183. package/dist/{processAudits-ySnizdMG.mjs → processAudits-D89tICM4.mjs} +1 -1
  184. package/dist/{processAudits-ySnizdMG.mjs.map → processAudits-D89tICM4.mjs.map} +1 -1
  185. package/dist/{publisher-BrFOF847.mjs → publisher-CGEo8UKD.mjs} +1 -1
  186. package/dist/{publisher-BrFOF847.mjs.map → publisher-CGEo8UKD.mjs.map} +1 -1
  187. package/dist/{publisher-lFQleddL.cjs → publisher-CqGsXB2X.cjs} +1 -1
  188. package/dist/{publisher-lFQleddL.cjs.map → publisher-CqGsXB2X.cjs.map} +1 -1
  189. package/dist/queue/index.cjs +92 -30
  190. package/dist/queue/index.cjs.map +1 -1
  191. package/dist/queue/index.d.cts +19 -4
  192. package/dist/queue/index.d.cts.map +1 -1
  193. package/dist/queue/index.d.mts +22 -6
  194. package/dist/queue/index.d.mts.map +1 -1
  195. package/dist/queue/index.mjs +90 -29
  196. package/dist/queue/index.mjs.map +1 -1
  197. package/dist/rest-api.cjs +187 -0
  198. package/dist/rest-api.cjs.map +1 -0
  199. package/dist/rest-api.d.cts +221 -0
  200. package/dist/rest-api.d.cts.map +1 -0
  201. package/dist/rest-api.d.mts +221 -0
  202. package/dist/rest-api.d.mts.map +1 -0
  203. package/dist/rest-api.mjs +186 -0
  204. package/dist/rest-api.mjs.map +1 -0
  205. package/dist/site.cjs +48 -0
  206. package/dist/site.cjs.map +1 -0
  207. package/dist/site.d.cts +101 -0
  208. package/dist/site.d.cts.map +1 -0
  209. package/dist/site.d.mts +101 -0
  210. package/dist/site.d.mts.map +1 -0
  211. package/dist/site.mjs +47 -0
  212. package/dist/site.mjs.map +1 -0
  213. package/dist/subscribers/index.cjs +35 -27
  214. package/dist/subscribers/index.cjs.map +1 -1
  215. package/dist/subscribers/index.d.cts +20 -5
  216. package/dist/subscribers/index.d.cts.map +1 -1
  217. package/dist/subscribers/index.d.mts +23 -7
  218. package/dist/subscribers/index.d.mts.map +1 -1
  219. package/dist/subscribers/index.mjs +34 -27
  220. package/dist/subscribers/index.mjs.map +1 -1
  221. package/dist/surfaceEnv-BFXEms2f.cjs +39 -0
  222. package/dist/surfaceEnv-BFXEms2f.cjs.map +1 -0
  223. package/dist/surfaceEnv-C3Ktahea.mjs +27 -0
  224. package/dist/surfaceEnv-C3Ktahea.mjs.map +1 -0
  225. package/dist/{telemetry-3vdxGn4q.d.mts → telemetry-C3L0iS28.d.cts} +2 -2
  226. package/dist/{telemetry-3vdxGn4q.d.mts.map → telemetry-C3L0iS28.d.cts.map} +1 -1
  227. package/dist/{telemetry-Dqx-D3F7.d.cts → telemetry-D7bVFLGi.d.mts} +2 -2
  228. package/dist/{telemetry-Dqx-D3F7.d.cts.map → telemetry-D7bVFLGi.d.mts.map} +1 -1
  229. package/dist/topic/index.cjs +56 -13
  230. package/dist/topic/index.cjs.map +1 -1
  231. package/dist/topic/index.d.cts +2 -2
  232. package/dist/topic/index.d.cts.map +1 -1
  233. package/dist/topic/index.d.mts +2 -2
  234. package/dist/topic/index.d.mts.map +1 -1
  235. package/dist/topic/index.mjs +54 -12
  236. package/dist/topic/index.mjs.map +1 -1
  237. package/dist/{types-BDNGr7pv.d.mts → types-BlAkSuGI.d.cts} +1 -1
  238. package/dist/{types-BDNGr7pv.d.mts.map → types-BlAkSuGI.d.cts.map} +1 -1
  239. package/dist/{types-BdAaYDvd.d.cts → types-aKksMEWL.d.mts} +1 -1
  240. package/dist/{types-BdAaYDvd.d.cts.map → types-aKksMEWL.d.mts.map} +1 -1
  241. package/dist/types.d.cts +1 -1
  242. package/dist/types.d.mts +1 -1
  243. package/package.json +155 -23
  244. package/CHANGELOG.md +0 -366
  245. package/dist/Construct-DCMuYOox.d.mts.map +0 -1
  246. package/dist/Construct-_1wX7p_Y.d.cts.map +0 -1
  247. package/dist/Construct-r0U2zBwW.mjs.map +0 -1
  248. package/dist/Construct-vXMZJgRp.cjs.map +0 -1
  249. package/dist/Endpoint-CAzNbDEt.d.cts.map +0 -1
  250. package/dist/Endpoint-CLPSIl6S.d.mts.map +0 -1
  251. package/dist/HonoEndpointAdaptor-CkJENANP.cjs.map +0 -1
  252. package/dist/HonoEndpointAdaptor-DJDT3PMx.mjs.map +0 -1
  253. package/dist/Queue-DaxjwmOQ.d.cts.map +0 -1
  254. package/dist/Queue-HBDf0fqz.d.mts.map +0 -1
  255. package/dist/Subscriber-D8Xm-86W.d.mts.map +0 -1
  256. package/dist/Topic-C5ZMfveW.d.cts.map +0 -1
  257. package/dist/Topic-DT10AqHk.d.mts.map +0 -1
  258. package/dist/endpoints/index.cjs.map +0 -1
  259. package/dist/endpoints/index.d.cts.map +0 -1
  260. package/dist/endpoints/index.d.mts.map +0 -1
  261. package/dist/endpoints/index.mjs.map +0 -1
  262. package/dist/functions-B-qt91O7.mjs.map +0 -1
  263. package/dist/functions-C8i1kCMM.cjs.map +0 -1
  264. package/dist/index-BGeTScmi.d.cts.map +0 -1
  265. package/dist/index-DP6fqv0I.d.mts.map +0 -1
  266. package/dist/lazyAccessors-DfqZR6C4.mjs.map +0 -1
  267. package/dist/lazyAccessors-DmTG8sQH.cjs.map +0 -1
  268. package/src/Construct.ts +0 -204
  269. package/src/__benchmarks__/build-time-optimization.bench.ts +0 -274
  270. package/src/__benchmarks__/endpoint.bench.ts +0 -494
  271. package/src/__benchmarks__/fixtures.ts +0 -241
  272. package/src/__benchmarks__/hono-adaptor.bench.ts +0 -533
  273. package/src/__benchmarks__/hono-server.bench.ts +0 -249
  274. package/src/__benchmarks__/response-builder.bench.ts +0 -428
  275. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +0 -319
  276. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +0 -530
  277. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +0 -567
  278. package/src/__tests__/Construct.environment.spec.ts +0 -704
  279. package/src/__tests__/publisher.setting.spec.ts +0 -508
  280. package/src/__tests__/publisher.spec.ts +0 -452
  281. package/src/adaptors/aws.ts +0 -6
  282. package/src/adaptors/hono.ts +0 -1
  283. package/src/adaptors/testing.ts +0 -11
  284. package/src/crons/AWSScheduledFunction.ts +0 -73
  285. package/src/crons/Cron.ts +0 -149
  286. package/src/crons/CronBuilder.ts +0 -271
  287. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +0 -152
  288. package/src/crons/__tests__/Cron.spec.ts +0 -464
  289. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +0 -227
  290. package/src/crons/index.ts +0 -12
  291. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +0 -677
  292. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +0 -105
  293. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +0 -97
  294. package/src/endpoints/Authorizer.ts +0 -152
  295. package/src/endpoints/Endpoint.ts +0 -1287
  296. package/src/endpoints/EndpointBuilder.ts +0 -758
  297. package/src/endpoints/EndpointFactory.ts +0 -1148
  298. package/src/endpoints/HonoEndpointAdaptor.ts +0 -677
  299. package/src/endpoints/MswEndpointAdaptor.ts +0 -226
  300. package/src/endpoints/TestEndpointAdaptor.ts +0 -422
  301. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +0 -499
  302. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +0 -560
  303. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +0 -1304
  304. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +0 -626
  305. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +0 -732
  306. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +0 -296
  307. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +0 -951
  308. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +0 -111
  309. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +0 -307
  310. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +0 -629
  311. package/src/endpoints/__tests__/Authorizer.spec.ts +0 -286
  312. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +0 -207
  313. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +0 -187
  314. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +0 -175
  315. package/src/endpoints/__tests__/Endpoint.spec.ts +0 -857
  316. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +0 -448
  317. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +0 -47
  318. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +0 -523
  319. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +0 -492
  320. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +0 -509
  321. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +0 -190
  322. package/src/endpoints/__tests__/EndpointFactory.spec.ts +0 -479
  323. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +0 -155
  324. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +0 -703
  325. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +0 -632
  326. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +0 -577
  327. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +0 -1067
  328. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +0 -317
  329. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +0 -289
  330. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +0 -128
  331. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +0 -1207
  332. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +0 -211
  333. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +0 -235
  334. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +0 -602
  335. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +0 -1044
  336. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +0 -54
  337. package/src/endpoints/__tests__/endpoint-types.test.ts +0 -88
  338. package/src/endpoints/__tests__/helpers.spec.ts +0 -37
  339. package/src/endpoints/__tests__/lazyAccessors.spec.ts +0 -330
  340. package/src/endpoints/__tests__/processAudits.spec.ts +0 -631
  341. package/src/endpoints/audit.ts +0 -87
  342. package/src/endpoints/helpers.ts +0 -98
  343. package/src/endpoints/index.ts +0 -42
  344. package/src/endpoints/lazyAccessors.ts +0 -241
  345. package/src/endpoints/parseHonoQuery.ts +0 -16
  346. package/src/endpoints/parseQueryParams.ts +0 -32
  347. package/src/endpoints/processAudits.ts +0 -371
  348. package/src/endpoints/rls.ts +0 -67
  349. package/src/functions/AWSLambdaFunction.ts +0 -348
  350. package/src/functions/BaseFunctionBuilder.ts +0 -201
  351. package/src/functions/Function.ts +0 -238
  352. package/src/functions/FunctionBuilder.ts +0 -391
  353. package/src/functions/FunctionExecutionWrapper.ts +0 -216
  354. package/src/functions/TestFunctionAdaptor.ts +0 -217
  355. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +0 -513
  356. package/src/functions/__tests__/Function.audits.spec.ts +0 -393
  357. package/src/functions/__tests__/Function.spec.ts +0 -477
  358. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +0 -207
  359. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +0 -480
  360. package/src/functions/index.ts +0 -12
  361. package/src/index.ts +0 -23
  362. package/src/publisher.ts +0 -93
  363. package/src/queue/AWSLambdaQueueAdaptor.ts +0 -162
  364. package/src/queue/Queue.ts +0 -128
  365. package/src/queue/QueueBuilder.ts +0 -115
  366. package/src/queue/TestQueueAdaptor.ts +0 -63
  367. package/src/queue/__tests__/QueueBuilder.spec.ts +0 -137
  368. package/src/queue/index.ts +0 -12
  369. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +0 -342
  370. package/src/subscribers/Subscriber.ts +0 -117
  371. package/src/subscribers/SubscriberBuilder.ts +0 -186
  372. package/src/subscribers/TestSubscriberAdaptor.ts +0 -133
  373. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +0 -1018
  374. package/src/subscribers/__tests__/Subscriber.spec.ts +0 -430
  375. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +0 -652
  376. package/src/subscribers/index.ts +0 -6
  377. package/src/telemetry.ts +0 -103
  378. package/src/topic/Topic.ts +0 -103
  379. package/src/topic/TopicBuilder.ts +0 -51
  380. package/src/topic/__tests__/TopicBuilder.spec.ts +0 -82
  381. package/src/topic/index.ts +0 -11
  382. package/src/types.ts +0 -13
  383. package/test.ts +0 -91
  384. package/tsconfig.json +0 -9
  385. package/tsdown.config.ts +0 -34
@@ -1,1067 +0,0 @@
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 { Hono } from 'hono';
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 type { MappedAudit } from '../audit';
32
- import { Endpoint, type EndpointContext } from '../Endpoint';
33
- import { HonoEndpoint } from '../HonoEndpointAdaptor';
34
-
35
- // Use unique table names to avoid conflicts with parallel tests
36
- const AUDIT_TABLE = 'hono_audit_logs' as const;
37
- const USERS_TABLE = 'hono_audit_users' as const;
38
-
39
- // Database schema
40
- interface TestDatabase {
41
- [AUDIT_TABLE]: AuditLogTable;
42
- [USERS_TABLE]: {
43
- id: Generated<number>;
44
- name: string;
45
- email: string;
46
- };
47
- }
48
-
49
- // Audit action types
50
- type TestAuditAction =
51
- | AuditableAction<'user.created', { userId: number; email: string }>
52
- | AuditableAction<'user.updated', { userId: number; changes: string[] }>
53
- | AuditableAction<'user.deleted', { userId: number }>;
54
-
55
- describe('HonoEndpoint Kysely Audit Integration', () => {
56
- let db: Kysely<TestDatabase>;
57
- let auditStorage: KyselyAuditStorage<TestDatabase>;
58
- let mockLogger: Logger;
59
-
60
- const createMockLogger = (): Logger => ({
61
- debug: vi.fn(),
62
- info: vi.fn(),
63
- warn: vi.fn(),
64
- error: vi.fn(),
65
- fatal: vi.fn(),
66
- trace: vi.fn(),
67
- child: vi.fn(function (this: Logger) {
68
- return this;
69
- }),
70
- });
71
-
72
- const createServiceDiscovery = () => {
73
- const envParser = new EnvironmentParser({});
74
- ServiceDiscovery.reset();
75
- return ServiceDiscovery.getInstance(envParser);
76
- };
77
-
78
- beforeAll(async () => {
79
- db = new Kysely<TestDatabase>({
80
- dialect: new PostgresDialect({
81
- pool: new pg.Pool({
82
- ...TEST_DATABASE_CONFIG,
83
- database: 'postgres',
84
- }),
85
- }),
86
- plugins: [new CamelCasePlugin()],
87
- });
88
-
89
- // Create audit_logs table
90
- await db.schema
91
- .createTable(AUDIT_TABLE)
92
- .ifNotExists()
93
- .addColumn('id', 'varchar(32)', (col) => col.primaryKey())
94
- .addColumn('type', 'varchar', (col) => col.notNull())
95
- .addColumn('operation', 'varchar', (col) => col.notNull())
96
- .addColumn('table', 'varchar')
97
- .addColumn('entityId', 'varchar')
98
- .addColumn('oldValues', 'jsonb')
99
- .addColumn('newValues', 'jsonb')
100
- .addColumn('payload', 'jsonb')
101
- .addColumn('timestamp', 'timestamp', (col) =>
102
- col.defaultTo(sql`now()`).notNull(),
103
- )
104
- .addColumn('actorId', 'varchar')
105
- .addColumn('actorType', 'varchar')
106
- .addColumn('actorData', 'jsonb')
107
- .addColumn('metadata', 'jsonb')
108
- .execute();
109
-
110
- // Create users table
111
- await db.schema
112
- .createTable(USERS_TABLE)
113
- .ifNotExists()
114
- .addColumn('id', 'serial', (col) => col.primaryKey())
115
- .addColumn('name', 'varchar', (col) => col.notNull())
116
- .addColumn('email', 'varchar', (col) => col.notNull().unique())
117
- .execute();
118
-
119
- auditStorage = new KyselyAuditStorage({
120
- db,
121
- tableName: AUDIT_TABLE,
122
- });
123
- });
124
-
125
- beforeEach(() => {
126
- mockLogger = createMockLogger();
127
- });
128
-
129
- afterEach(async () => {
130
- await db.deleteFrom(AUDIT_TABLE).execute();
131
- await db.deleteFrom(USERS_TABLE).execute();
132
- });
133
-
134
- afterAll(async () => {
135
- await db.schema.dropTable(AUDIT_TABLE).ifExists().execute();
136
- await db.schema.dropTable(USERS_TABLE).ifExists().execute();
137
- await db.destroy();
138
- });
139
-
140
- describe('declarative audits with real database', () => {
141
- it('should write declarative audit to database on successful request', async () => {
142
- const serviceDiscovery = createServiceDiscovery();
143
-
144
- const auditStorageService: Service<
145
- 'auditStorage',
146
- KyselyAuditStorage<TestDatabase>
147
- > = {
148
- serviceName: 'auditStorage' as const,
149
- register: vi.fn().mockResolvedValue(auditStorage),
150
- };
151
-
152
- const outputSchema = z.object({ id: z.number(), email: z.string() });
153
-
154
- const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
155
- {
156
- type: 'user.created',
157
- payload: (response) => ({
158
- userId: response.id,
159
- email: response.email,
160
- }),
161
- },
162
- ];
163
-
164
- const endpoint = new Endpoint({
165
- route: '/users',
166
- method: 'POST',
167
- fn: async () => {
168
- return { id: 1, email: 'test@example.com' };
169
- },
170
- input: undefined,
171
- output: outputSchema,
172
- services: [],
173
- logger: mockLogger,
174
- timeout: undefined,
175
- memorySize: undefined,
176
- status: 201,
177
- getSession: undefined,
178
- authorize: undefined,
179
- description: undefined,
180
- events: [],
181
- publisherService: undefined,
182
- auditorStorageService: auditStorageService,
183
- audits,
184
- });
185
-
186
- const adaptor = new HonoEndpoint(endpoint);
187
- const app = new Hono();
188
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
189
- adaptor.addRoute(serviceDiscovery, app);
190
-
191
- const response = await app.request('/users', {
192
- method: 'POST',
193
- body: JSON.stringify({}),
194
- headers: { 'Content-Type': 'application/json' },
195
- });
196
-
197
- expect(response.status).toBe(201);
198
-
199
- // Verify audit was written to the real database
200
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
201
-
202
- expect(auditsInDb).toHaveLength(1);
203
- expect(auditsInDb[0].type).toBe('user.created');
204
- expect(auditsInDb[0].payload).toEqual({
205
- userId: 1,
206
- email: 'test@example.com',
207
- });
208
- });
209
-
210
- it('should not write audit when handler fails', async () => {
211
- const serviceDiscovery = createServiceDiscovery();
212
-
213
- const auditStorageService: Service<
214
- 'auditStorage',
215
- KyselyAuditStorage<TestDatabase>
216
- > = {
217
- serviceName: 'auditStorage' as const,
218
- register: vi.fn().mockResolvedValue(auditStorage),
219
- };
220
-
221
- const outputSchema = z.object({ id: z.number(), email: z.string() });
222
-
223
- const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
224
- {
225
- type: 'user.created',
226
- payload: (response) => ({
227
- userId: response.id,
228
- email: response.email,
229
- }),
230
- },
231
- ];
232
-
233
- const endpoint = new Endpoint({
234
- route: '/users',
235
- method: 'POST',
236
- fn: async () => {
237
- throw new Error('Handler failed');
238
- },
239
- input: undefined,
240
- output: outputSchema,
241
- services: [],
242
- logger: mockLogger,
243
- timeout: undefined,
244
- memorySize: undefined,
245
- status: 201,
246
- getSession: undefined,
247
- authorize: undefined,
248
- description: undefined,
249
- events: [],
250
- publisherService: undefined,
251
- auditorStorageService: auditStorageService,
252
- audits,
253
- });
254
-
255
- const adaptor = new HonoEndpoint(endpoint);
256
- const app = new Hono();
257
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
258
- adaptor.addRoute(serviceDiscovery, app);
259
-
260
- const response = await app.request('/users', {
261
- method: 'POST',
262
- body: JSON.stringify({}),
263
- headers: { 'Content-Type': 'application/json' },
264
- });
265
-
266
- expect(response.status).toBe(500);
267
-
268
- // Verify no audit was written
269
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
270
-
271
- expect(auditsInDb).toHaveLength(0);
272
- });
273
- });
274
-
275
- describe('manual audits with real database', () => {
276
- it('should write manual audits from handler to database', async () => {
277
- const serviceDiscovery = createServiceDiscovery();
278
-
279
- const auditStorageService: Service<
280
- 'auditStorage',
281
- KyselyAuditStorage<TestDatabase>
282
- > = {
283
- serviceName: 'auditStorage' as const,
284
- register: vi.fn().mockResolvedValue(auditStorage),
285
- };
286
-
287
- const outputSchema = z.object({ id: z.number(), email: z.string() });
288
-
289
- const endpoint = new Endpoint({
290
- route: '/users',
291
- method: 'POST',
292
- fn: async (
293
- ctx: EndpointContext<
294
- undefined,
295
- [],
296
- Logger,
297
- unknown,
298
- TestAuditAction,
299
- undefined,
300
- KyselyAuditStorage<TestDatabase>
301
- >,
302
- ) => {
303
- // Manual audit in handler - auditor is guaranteed to exist when TAuditStorage is configured
304
- ctx.auditor.audit('user.created', {
305
- userId: 42,
306
- email: 'manual@example.com',
307
- });
308
-
309
- return { id: 42, email: 'manual@example.com' };
310
- },
311
- input: undefined,
312
- output: outputSchema,
313
- services: [],
314
- logger: mockLogger,
315
- timeout: undefined,
316
- memorySize: undefined,
317
- status: 201,
318
- getSession: undefined,
319
- authorize: undefined,
320
- description: undefined,
321
- events: [],
322
- publisherService: undefined,
323
- auditorStorageService: auditStorageService,
324
- audits: [],
325
- });
326
-
327
- const adaptor = new HonoEndpoint(endpoint);
328
- const app = new Hono();
329
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
330
- adaptor.addRoute(serviceDiscovery, app);
331
-
332
- const response = await app.request('/users', {
333
- method: 'POST',
334
- body: JSON.stringify({}),
335
- headers: { 'Content-Type': 'application/json' },
336
- });
337
-
338
- expect(response.status).toBe(201);
339
-
340
- // Verify manual audit was written
341
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
342
-
343
- expect(auditsInDb).toHaveLength(1);
344
- expect(auditsInDb[0].type).toBe('user.created');
345
- expect(auditsInDb[0].payload).toEqual({
346
- userId: 42,
347
- email: 'manual@example.com',
348
- });
349
- });
350
-
351
- it('should not write manual audit when handler fails after audit call', async () => {
352
- const serviceDiscovery = createServiceDiscovery();
353
-
354
- const auditStorageService: Service<
355
- 'auditStorage',
356
- KyselyAuditStorage<TestDatabase>
357
- > = {
358
- serviceName: 'auditStorage' as const,
359
- register: vi.fn().mockResolvedValue(auditStorage),
360
- };
361
-
362
- const outputSchema = z.object({ id: z.number(), email: z.string() });
363
-
364
- const endpoint = new Endpoint({
365
- route: '/users',
366
- method: 'POST',
367
- fn: async (
368
- ctx: EndpointContext<
369
- undefined,
370
- [],
371
- Logger,
372
- unknown,
373
- TestAuditAction,
374
- undefined,
375
- KyselyAuditStorage<TestDatabase>
376
- >,
377
- ) => {
378
- // Manual audit before failure - auditor is guaranteed to exist
379
- ctx.auditor.audit('user.created', {
380
- userId: 99,
381
- email: 'shouldnotexist@example.com',
382
- });
383
-
384
- // Fail after audit
385
- throw new Error('Handler failed after audit');
386
- },
387
- input: undefined,
388
- output: outputSchema,
389
- services: [],
390
- logger: mockLogger,
391
- timeout: undefined,
392
- memorySize: undefined,
393
- status: 201,
394
- getSession: undefined,
395
- authorize: undefined,
396
- description: undefined,
397
- events: [],
398
- publisherService: undefined,
399
- auditorStorageService: auditStorageService,
400
- audits: [],
401
- });
402
-
403
- const adaptor = new HonoEndpoint(endpoint);
404
- const app = new Hono();
405
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
406
- adaptor.addRoute(serviceDiscovery, app);
407
-
408
- const response = await app.request('/users', {
409
- method: 'POST',
410
- body: JSON.stringify({}),
411
- headers: { 'Content-Type': 'application/json' },
412
- });
413
-
414
- expect(response.status).toBe(500);
415
-
416
- // Verify no audit was written (transaction rolled back)
417
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
418
-
419
- expect(auditsInDb).toHaveLength(0);
420
- });
421
- });
422
-
423
- describe('transactional consistency with real database', () => {
424
- it('should commit both user insert and audit on success', async () => {
425
- const serviceDiscovery = createServiceDiscovery();
426
-
427
- const databaseService: Service<'database', Kysely<TestDatabase>> = {
428
- serviceName: 'database' as const,
429
- register: vi.fn().mockResolvedValue(db),
430
- };
431
-
432
- const auditStorageService: Service<
433
- 'auditStorage',
434
- KyselyAuditStorage<TestDatabase>
435
- > = {
436
- serviceName: 'auditStorage' as const,
437
- register: vi.fn().mockResolvedValue(auditStorage),
438
- };
439
-
440
- const outputSchema = z.object({ id: z.number(), email: z.string() });
441
-
442
- const endpoint = new Endpoint({
443
- route: '/users',
444
- method: 'POST',
445
- fn: async (
446
- ctx: EndpointContext<
447
- undefined,
448
- [typeof databaseService],
449
- Logger,
450
- unknown,
451
- TestAuditAction,
452
- undefined,
453
- KyselyAuditStorage<TestDatabase>
454
- >,
455
- ) => {
456
- const database = ctx.services.database;
457
-
458
- // Insert user
459
- const user = await database
460
- .insertInto(USERS_TABLE)
461
- .values({ name: 'Success User', email: 'success@example.com' })
462
- .returningAll()
463
- .executeTakeFirstOrThrow();
464
-
465
- // Record audit - auditor is guaranteed to exist
466
- ctx.auditor.audit('user.created', {
467
- userId: user.id,
468
- email: user.email,
469
- });
470
-
471
- return { id: user.id, email: user.email };
472
- },
473
- input: undefined,
474
- output: outputSchema,
475
- services: [databaseService],
476
- logger: mockLogger,
477
- timeout: undefined,
478
- memorySize: undefined,
479
- status: 201,
480
- getSession: undefined,
481
- authorize: undefined,
482
- description: undefined,
483
- events: [],
484
- publisherService: undefined,
485
- auditorStorageService: auditStorageService,
486
- audits: [],
487
- });
488
-
489
- const adaptor = new HonoEndpoint(endpoint);
490
- const app = new Hono();
491
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
492
- adaptor.addRoute(serviceDiscovery, app);
493
-
494
- const response = await app.request('/users', {
495
- method: 'POST',
496
- body: JSON.stringify({}),
497
- headers: { 'Content-Type': 'application/json' },
498
- });
499
-
500
- expect(response.status).toBe(201);
501
-
502
- // Verify user was created
503
- const usersInDb = await db.selectFrom(USERS_TABLE).selectAll().execute();
504
- expect(usersInDb).toHaveLength(1);
505
- expect(usersInDb[0].email).toBe('success@example.com');
506
-
507
- // Verify audit was written
508
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
509
- expect(auditsInDb).toHaveLength(1);
510
- expect(auditsInDb[0].type).toBe('user.created');
511
- expect(auditsInDb[0].payload).toEqual({
512
- userId: usersInDb[0].id,
513
- email: 'success@example.com',
514
- });
515
- });
516
-
517
- it('should handle combined declarative and manual audits', async () => {
518
- const serviceDiscovery = createServiceDiscovery();
519
-
520
- const auditStorageService: Service<
521
- 'auditStorage',
522
- KyselyAuditStorage<TestDatabase>
523
- > = {
524
- serviceName: 'auditStorage' as const,
525
- register: vi.fn().mockResolvedValue(auditStorage),
526
- };
527
-
528
- const outputSchema = z.object({ id: z.number(), email: z.string() });
529
-
530
- // Declarative audit
531
- const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
532
- {
533
- type: 'user.created',
534
- payload: (response) => ({
535
- userId: response.id,
536
- email: response.email,
537
- }),
538
- },
539
- ];
540
-
541
- const endpoint = new Endpoint({
542
- route: '/users',
543
- method: 'POST',
544
- fn: async (
545
- ctx: EndpointContext<
546
- undefined,
547
- [],
548
- Logger,
549
- unknown,
550
- TestAuditAction,
551
- undefined,
552
- KyselyAuditStorage<TestDatabase>
553
- >,
554
- ) => {
555
- // Manual audit - auditor is guaranteed to exist
556
- ctx.auditor.audit('user.updated', {
557
- userId: 100,
558
- changes: ['verified'],
559
- });
560
-
561
- return { id: 100, email: 'combined@example.com' };
562
- },
563
- input: undefined,
564
- output: outputSchema,
565
- services: [],
566
- logger: mockLogger,
567
- timeout: undefined,
568
- memorySize: undefined,
569
- status: 201,
570
- getSession: undefined,
571
- authorize: undefined,
572
- description: undefined,
573
- events: [],
574
- publisherService: undefined,
575
- auditorStorageService: auditStorageService,
576
- audits,
577
- });
578
-
579
- const adaptor = new HonoEndpoint(endpoint);
580
- const app = new Hono();
581
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
582
- adaptor.addRoute(serviceDiscovery, app);
583
-
584
- const response = await app.request('/users', {
585
- method: 'POST',
586
- body: JSON.stringify({}),
587
- headers: { 'Content-Type': 'application/json' },
588
- });
589
-
590
- expect(response.status).toBe(201);
591
-
592
- // Verify both audits were written
593
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
594
-
595
- expect(auditsInDb).toHaveLength(2);
596
-
597
- const auditTypes = auditsInDb.map((a) => a.type).sort();
598
- expect(auditTypes).toEqual(['user.created', 'user.updated']);
599
- });
600
- });
601
-
602
- describe('actor extraction with real database', () => {
603
- it('should include actor information in audit records', async () => {
604
- const serviceDiscovery = createServiceDiscovery();
605
-
606
- const auditStorageService: Service<
607
- 'auditStorage',
608
- KyselyAuditStorage<TestDatabase>
609
- > = {
610
- serviceName: 'auditStorage' as const,
611
- register: vi.fn().mockResolvedValue(auditStorage),
612
- };
613
-
614
- const outputSchema = z.object({ id: z.number(), email: z.string() });
615
-
616
- const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
617
- {
618
- type: 'user.created',
619
- payload: (response) => ({
620
- userId: response.id,
621
- email: response.email,
622
- }),
623
- },
624
- ];
625
-
626
- const endpoint = new Endpoint({
627
- route: '/users',
628
- method: 'POST',
629
- fn: async () => {
630
- return { id: 1, email: 'actor-test@example.com' };
631
- },
632
- input: undefined,
633
- output: outputSchema,
634
- services: [],
635
- logger: mockLogger,
636
- timeout: undefined,
637
- memorySize: undefined,
638
- status: 201,
639
- getSession: undefined,
640
- authorize: undefined,
641
- description: undefined,
642
- events: [],
643
- publisherService: undefined,
644
- auditorStorageService: auditStorageService,
645
- audits,
646
- actorExtractor: async ({ header }) => {
647
- const userId = header('x-user-id');
648
- return {
649
- id: userId ?? 'anonymous',
650
- type: userId ? 'user' : 'anonymous',
651
- };
652
- },
653
- });
654
-
655
- const adaptor = new HonoEndpoint(endpoint);
656
- const app = new Hono();
657
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
658
- adaptor.addRoute(serviceDiscovery, app);
659
-
660
- const response = await app.request('/users', {
661
- method: 'POST',
662
- body: JSON.stringify({}),
663
- headers: {
664
- 'Content-Type': 'application/json',
665
- 'x-user-id': 'user-123',
666
- },
667
- });
668
-
669
- expect(response.status).toBe(201);
670
-
671
- // Verify actor was included in audit
672
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
673
-
674
- expect(auditsInDb).toHaveLength(1);
675
- expect(auditsInDb[0].actorId).toBe('user-123');
676
- expect(auditsInDb[0].actorType).toBe('user');
677
- });
678
- });
679
-
680
- describe('database service name matching', () => {
681
- it('should use audit transaction as db when databaseServiceName matches', async () => {
682
- const serviceDiscovery = createServiceDiscovery();
683
-
684
- // Create audit storage WITH databaseServiceName
685
- const auditStorageWithServiceName = new KyselyAuditStorage({
686
- db,
687
- tableName: AUDIT_TABLE,
688
- databaseServiceName: 'database', // Matches the database service
689
- });
690
-
691
- const databaseService: Service<'database', Kysely<TestDatabase>> = {
692
- serviceName: 'database' as const,
693
- register: vi.fn().mockResolvedValue(db),
694
- };
695
-
696
- const auditStorageService: Service<
697
- 'auditStorage',
698
- KyselyAuditStorage<TestDatabase>
699
- > = {
700
- serviceName: 'auditStorage' as const,
701
- register: vi.fn().mockResolvedValue(auditStorageWithServiceName),
702
- };
703
-
704
- const outputSchema = z.object({ id: z.number(), email: z.string() });
705
-
706
- let receivedDbIsTransaction = false;
707
-
708
- const endpoint = new Endpoint({
709
- route: '/users',
710
- method: 'POST',
711
- fn: async (
712
- ctx: EndpointContext<
713
- undefined,
714
- [typeof databaseService],
715
- Logger,
716
- unknown,
717
- TestAuditAction,
718
- Kysely<TestDatabase>,
719
- KyselyAuditStorage<TestDatabase>
720
- >,
721
- ) => {
722
- // Check if db is a transaction (has isTransaction property from Kysely)
723
- // When databaseServiceName matches, db should be the transaction
724
- receivedDbIsTransaction = (ctx.db as any)?.isTransaction === true;
725
-
726
- // Insert user using ctx.db (should be the transaction)
727
- const user = await ctx.db
728
- .insertInto(USERS_TABLE)
729
- .values({ name: 'Transaction User', email: 'trx@example.com' })
730
- .returningAll()
731
- .executeTakeFirstOrThrow();
732
-
733
- // Record audit
734
- ctx.auditor.audit('user.created', {
735
- userId: user.id,
736
- email: user.email,
737
- });
738
-
739
- return { id: user.id, email: user.email };
740
- },
741
- input: undefined,
742
- output: outputSchema,
743
- services: [databaseService],
744
- logger: mockLogger,
745
- timeout: undefined,
746
- memorySize: undefined,
747
- status: 201,
748
- getSession: undefined,
749
- authorize: undefined,
750
- description: undefined,
751
- events: [],
752
- publisherService: undefined,
753
- auditorStorageService: auditStorageService,
754
- audits: [],
755
- databaseService,
756
- });
757
-
758
- const adaptor = new HonoEndpoint(endpoint);
759
- const app = new Hono();
760
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
761
- adaptor.addRoute(serviceDiscovery, app);
762
-
763
- const response = await app.request('/users', {
764
- method: 'POST',
765
- body: JSON.stringify({}),
766
- headers: { 'Content-Type': 'application/json' },
767
- });
768
-
769
- expect(response.status).toBe(201);
770
- expect(receivedDbIsTransaction).toBe(true);
771
-
772
- // Verify both user and audit were committed
773
- const usersInDb = await db.selectFrom(USERS_TABLE).selectAll().execute();
774
- expect(usersInDb).toHaveLength(1);
775
- expect(usersInDb[0].email).toBe('trx@example.com');
776
-
777
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
778
- expect(auditsInDb).toHaveLength(1);
779
- });
780
-
781
- it('should use raw db when databaseServiceName does not match', async () => {
782
- const serviceDiscovery = createServiceDiscovery();
783
-
784
- // Create audit storage with DIFFERENT databaseServiceName
785
- const auditStorageWithDifferentServiceName = new KyselyAuditStorage({
786
- db,
787
- tableName: AUDIT_TABLE,
788
- databaseServiceName: 'auditDatabase', // Different from 'database'
789
- });
790
-
791
- const databaseService: Service<'database', Kysely<TestDatabase>> = {
792
- serviceName: 'database' as const,
793
- register: vi.fn().mockResolvedValue(db),
794
- };
795
-
796
- const auditStorageService: Service<
797
- 'auditStorage',
798
- KyselyAuditStorage<TestDatabase>
799
- > = {
800
- serviceName: 'auditStorage' as const,
801
- register: vi
802
- .fn()
803
- .mockResolvedValue(auditStorageWithDifferentServiceName),
804
- };
805
-
806
- const outputSchema = z.object({ id: z.number(), email: z.string() });
807
-
808
- let receivedDbIsTransaction = false;
809
-
810
- const endpoint = new Endpoint({
811
- route: '/users',
812
- method: 'POST',
813
- fn: async (
814
- ctx: EndpointContext<
815
- undefined,
816
- [typeof databaseService],
817
- Logger,
818
- unknown,
819
- TestAuditAction,
820
- Kysely<TestDatabase>,
821
- KyselyAuditStorage<TestDatabase>
822
- >,
823
- ) => {
824
- // When databaseServiceName doesn't match, db should be raw (not a transaction)
825
- receivedDbIsTransaction = (ctx.db as any)?.isTransaction === true;
826
-
827
- // Insert user using ctx.db (should be raw db, not transaction)
828
- const user = await ctx.db
829
- .insertInto(USERS_TABLE)
830
- .values({ name: 'Raw DB User', email: 'raw@example.com' })
831
- .returningAll()
832
- .executeTakeFirstOrThrow();
833
-
834
- // Record audit
835
- ctx.auditor.audit('user.created', {
836
- userId: user.id,
837
- email: user.email,
838
- });
839
-
840
- return { id: user.id, email: user.email };
841
- },
842
- input: undefined,
843
- output: outputSchema,
844
- services: [databaseService],
845
- logger: mockLogger,
846
- timeout: undefined,
847
- memorySize: undefined,
848
- status: 201,
849
- getSession: undefined,
850
- authorize: undefined,
851
- description: undefined,
852
- events: [],
853
- publisherService: undefined,
854
- auditorStorageService: auditStorageService,
855
- audits: [],
856
- databaseService,
857
- });
858
-
859
- const adaptor = new HonoEndpoint(endpoint);
860
- const app = new Hono();
861
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
862
- adaptor.addRoute(serviceDiscovery, app);
863
-
864
- const response = await app.request('/users', {
865
- method: 'POST',
866
- body: JSON.stringify({}),
867
- headers: { 'Content-Type': 'application/json' },
868
- });
869
-
870
- expect(response.status).toBe(201);
871
- // db should NOT be a transaction since service names don't match
872
- expect(receivedDbIsTransaction).toBe(false);
873
-
874
- // Both should still be committed (but not in the same transaction)
875
- const usersInDb = await db.selectFrom(USERS_TABLE).selectAll().execute();
876
- expect(usersInDb).toHaveLength(1);
877
-
878
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
879
- expect(auditsInDb).toHaveLength(1);
880
- });
881
-
882
- it('should use raw db when databaseServiceName is not set on audit storage', async () => {
883
- const serviceDiscovery = createServiceDiscovery();
884
-
885
- // Create audit storage WITHOUT databaseServiceName (uses default auditStorage from beforeAll)
886
- const databaseService: Service<'database', Kysely<TestDatabase>> = {
887
- serviceName: 'database' as const,
888
- register: vi.fn().mockResolvedValue(db),
889
- };
890
-
891
- const auditStorageService: Service<
892
- 'auditStorage',
893
- KyselyAuditStorage<TestDatabase>
894
- > = {
895
- serviceName: 'auditStorage' as const,
896
- register: vi.fn().mockResolvedValue(auditStorage), // No databaseServiceName set
897
- };
898
-
899
- const outputSchema = z.object({ id: z.number(), email: z.string() });
900
-
901
- let receivedDbIsTransaction = false;
902
-
903
- const endpoint = new Endpoint({
904
- route: '/users',
905
- method: 'POST',
906
- fn: async (
907
- ctx: EndpointContext<
908
- undefined,
909
- [typeof databaseService],
910
- Logger,
911
- unknown,
912
- TestAuditAction,
913
- Kysely<TestDatabase>,
914
- KyselyAuditStorage<TestDatabase>
915
- >,
916
- ) => {
917
- // When databaseServiceName is not set, db should be raw
918
- receivedDbIsTransaction = (ctx.db as any)?.isTransaction === true;
919
-
920
- const user = await ctx.db
921
- .insertInto(USERS_TABLE)
922
- .values({
923
- name: 'No ServiceName User',
924
- email: 'noname@example.com',
925
- })
926
- .returningAll()
927
- .executeTakeFirstOrThrow();
928
-
929
- ctx.auditor.audit('user.created', {
930
- userId: user.id,
931
- email: user.email,
932
- });
933
-
934
- return { id: user.id, email: user.email };
935
- },
936
- input: undefined,
937
- output: outputSchema,
938
- services: [databaseService],
939
- logger: mockLogger,
940
- timeout: undefined,
941
- memorySize: undefined,
942
- status: 201,
943
- getSession: undefined,
944
- authorize: undefined,
945
- description: undefined,
946
- events: [],
947
- publisherService: undefined,
948
- auditorStorageService: auditStorageService,
949
- audits: [],
950
- databaseService,
951
- });
952
-
953
- const adaptor = new HonoEndpoint(endpoint);
954
- const app = new Hono();
955
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
956
- adaptor.addRoute(serviceDiscovery, app);
957
-
958
- const response = await app.request('/users', {
959
- method: 'POST',
960
- body: JSON.stringify({}),
961
- headers: { 'Content-Type': 'application/json' },
962
- });
963
-
964
- expect(response.status).toBe(201);
965
- expect(receivedDbIsTransaction).toBe(false);
966
-
967
- const usersInDb = await db.selectFrom(USERS_TABLE).selectAll().execute();
968
- expect(usersInDb).toHaveLength(1);
969
-
970
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
971
- expect(auditsInDb).toHaveLength(1);
972
- });
973
-
974
- it('should rollback both user insert and audit when handler fails with matching databaseServiceName', async () => {
975
- const serviceDiscovery = createServiceDiscovery();
976
-
977
- // Create audit storage WITH databaseServiceName
978
- const auditStorageWithServiceName = new KyselyAuditStorage({
979
- db,
980
- tableName: AUDIT_TABLE,
981
- databaseServiceName: 'database',
982
- });
983
-
984
- const databaseService: Service<'database', Kysely<TestDatabase>> = {
985
- serviceName: 'database' as const,
986
- register: vi.fn().mockResolvedValue(db),
987
- };
988
-
989
- const auditStorageService: Service<
990
- 'auditStorage',
991
- KyselyAuditStorage<TestDatabase>
992
- > = {
993
- serviceName: 'auditStorage' as const,
994
- register: vi.fn().mockResolvedValue(auditStorageWithServiceName),
995
- };
996
-
997
- const outputSchema = z.object({ id: z.number(), email: z.string() });
998
-
999
- const endpoint = new Endpoint({
1000
- route: '/users',
1001
- method: 'POST',
1002
- fn: async (
1003
- ctx: EndpointContext<
1004
- undefined,
1005
- [typeof databaseService],
1006
- Logger,
1007
- unknown,
1008
- TestAuditAction,
1009
- Kysely<TestDatabase>,
1010
- KyselyAuditStorage<TestDatabase>
1011
- >,
1012
- ) => {
1013
- // Insert user (should be rolled back)
1014
- const user = await ctx.db
1015
- .insertInto(USERS_TABLE)
1016
- .values({ name: 'Rollback User', email: 'rollback@example.com' })
1017
- .returningAll()
1018
- .executeTakeFirstOrThrow();
1019
-
1020
- // Record audit (should also be rolled back)
1021
- ctx.auditor.audit('user.created', {
1022
- userId: user.id,
1023
- email: user.email,
1024
- });
1025
-
1026
- // Fail after both operations
1027
- throw new Error('Simulated failure');
1028
- },
1029
- input: undefined,
1030
- output: outputSchema,
1031
- services: [databaseService],
1032
- logger: mockLogger,
1033
- timeout: undefined,
1034
- memorySize: undefined,
1035
- status: 201,
1036
- getSession: undefined,
1037
- authorize: undefined,
1038
- description: undefined,
1039
- events: [],
1040
- publisherService: undefined,
1041
- auditorStorageService: auditStorageService,
1042
- audits: [],
1043
- databaseService,
1044
- });
1045
-
1046
- const adaptor = new HonoEndpoint(endpoint);
1047
- const app = new Hono();
1048
- HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
1049
- adaptor.addRoute(serviceDiscovery, app);
1050
-
1051
- const response = await app.request('/users', {
1052
- method: 'POST',
1053
- body: JSON.stringify({}),
1054
- headers: { 'Content-Type': 'application/json' },
1055
- });
1056
-
1057
- expect(response.status).toBe(500);
1058
-
1059
- // Both should be rolled back since they're in the same transaction
1060
- const usersInDb = await db.selectFrom(USERS_TABLE).selectAll().execute();
1061
- expect(usersInDb).toHaveLength(0);
1062
-
1063
- const auditsInDb = await db.selectFrom(AUDIT_TABLE).selectAll().execute();
1064
- expect(auditsInDb).toHaveLength(0);
1065
- });
1066
- });
1067
- });