@geekmidas/constructs 10.0.0-alpha.98 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (533) hide show
  1. package/CHANGELOG.md +437 -0
  2. package/README.md +193 -285
  3. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
  4. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
  5. package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
  6. package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
  7. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
  8. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
  9. package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
  10. package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
  11. package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
  12. package/dist/Construct-BWF5HxaM.mjs.map +1 -0
  13. package/dist/Construct-JlyQkBkv.d.cts +117 -0
  14. package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
  15. package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
  16. package/dist/Construct-TGIM_E4o.cjs.map +1 -0
  17. package/dist/Construct-pxwC6fDD.d.mts +117 -0
  18. package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
  19. package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
  20. package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
  21. package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
  22. package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
  23. package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
  24. package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
  25. package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
  26. package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
  27. package/dist/Queue-BL68oDJ-.d.mts +66 -0
  28. package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
  29. package/dist/Queue-DxJ6btRE.d.cts +66 -0
  30. package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
  31. package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
  32. package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
  33. package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
  34. package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
  35. package/dist/Topic-DJXoDeMP.d.cts +60 -0
  36. package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
  37. package/dist/Topic-DxWQBgMN.d.mts +60 -0
  38. package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
  39. package/dist/adaptors/aws.cjs +205 -355
  40. package/dist/adaptors/aws.cjs.map +1 -1
  41. package/dist/adaptors/aws.d.cts +48 -126
  42. package/dist/adaptors/aws.d.cts.map +1 -1
  43. package/dist/adaptors/aws.d.mts +49 -127
  44. package/dist/adaptors/aws.d.mts.map +1 -1
  45. package/dist/adaptors/aws.mjs +178 -325
  46. package/dist/adaptors/aws.mjs.map +1 -1
  47. package/dist/adaptors/hono.cjs +9 -3
  48. package/dist/adaptors/hono.d.cts +15 -7
  49. package/dist/adaptors/hono.d.cts.map +1 -1
  50. package/dist/adaptors/hono.d.mts +17 -9
  51. package/dist/adaptors/hono.d.mts.map +1 -1
  52. package/dist/adaptors/hono.mjs +9 -2
  53. package/dist/adaptors/testing.cjs +209 -831
  54. package/dist/adaptors/testing.cjs.map +1 -1
  55. package/dist/adaptors/testing.d.cts +55 -351
  56. package/dist/adaptors/testing.d.cts.map +1 -1
  57. package/dist/adaptors/testing.d.mts +53 -349
  58. package/dist/adaptors/testing.d.mts.map +1 -1
  59. package/dist/adaptors/testing.mjs +195 -798
  60. package/dist/adaptors/testing.mjs.map +1 -1
  61. package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
  62. package/dist/clone-I_WIpiFf.cjs.map +1 -0
  63. package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
  64. package/dist/clone-pdXxc0t3.mjs.map +1 -0
  65. package/dist/crons/index.cjs +66 -190
  66. package/dist/crons/index.cjs.map +1 -1
  67. package/dist/crons/index.d.cts +35 -70
  68. package/dist/crons/index.d.cts.map +1 -1
  69. package/dist/crons/index.d.mts +32 -70
  70. package/dist/crons/index.d.mts.map +1 -1
  71. package/dist/crons/index.mjs +63 -184
  72. package/dist/crons/index.mjs.map +1 -1
  73. package/dist/endpoints/index.cjs +761 -19
  74. package/dist/endpoints/index.cjs.map +1 -0
  75. package/dist/endpoints/index.d.cts +322 -22
  76. package/dist/endpoints/index.d.cts.map +1 -1
  77. package/dist/endpoints/index.d.mts +321 -22
  78. package/dist/endpoints/index.d.mts.map +1 -1
  79. package/dist/endpoints/index.mjs +751 -6
  80. package/dist/endpoints/index.mjs.map +1 -0
  81. package/dist/functions/index.cjs +5 -2
  82. package/dist/functions/index.d.cts +3 -3
  83. package/dist/functions/index.d.mts +3 -3
  84. package/dist/functions/index.mjs +5 -2
  85. package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
  86. package/dist/functions-EqTloHjo.mjs.map +1 -0
  87. package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
  88. package/dist/functions-SqtCDc9c.cjs.map +1 -0
  89. package/dist/index-C7iynzLI.d.mts +139 -0
  90. package/dist/index-C7iynzLI.d.mts.map +1 -0
  91. package/dist/index-D4dM_WDY.d.cts +142 -0
  92. package/dist/index-D4dM_WDY.d.cts.map +1 -0
  93. package/dist/index.cjs +3 -6
  94. package/dist/index.d.cts +4 -27
  95. package/dist/index.d.mts +4 -27
  96. package/dist/index.mjs +3 -3
  97. package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
  98. package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
  99. package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
  100. package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
  101. package/dist/monitors/index.cjs +49 -0
  102. package/dist/monitors/index.cjs.map +1 -0
  103. package/dist/monitors/index.d.cts +45 -0
  104. package/dist/monitors/index.d.cts.map +1 -0
  105. package/dist/monitors/index.d.mts +45 -0
  106. package/dist/monitors/index.d.mts.map +1 -0
  107. package/dist/monitors/index.mjs +48 -0
  108. package/dist/monitors/index.mjs.map +1 -0
  109. package/dist/processAudits-BJZT5gmy.cjs +92 -0
  110. package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
  111. package/dist/processAudits-CwyaaSQc.mjs +80 -0
  112. package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
  113. package/dist/publisher-BZgcrVPy.cjs +53 -0
  114. package/dist/publisher-BZgcrVPy.cjs.map +1 -0
  115. package/dist/publisher-CnpeMv-r.mjs +41 -0
  116. package/dist/publisher-CnpeMv-r.mjs.map +1 -0
  117. package/dist/queue/index.cjs +114 -6
  118. package/dist/queue/index.cjs.map +1 -0
  119. package/dist/queue/index.d.cts +45 -3
  120. package/dist/queue/index.d.cts.map +1 -0
  121. package/dist/queue/index.d.mts +44 -3
  122. package/dist/queue/index.d.mts.map +1 -0
  123. package/dist/queue/index.mjs +112 -3
  124. package/dist/queue/index.mjs.map +1 -0
  125. package/dist/subscribers/index.cjs +80 -111
  126. package/dist/subscribers/index.cjs.map +1 -1
  127. package/dist/subscribers/index.d.cts +43 -46
  128. package/dist/subscribers/index.d.cts.map +1 -1
  129. package/dist/subscribers/index.d.mts +42 -46
  130. package/dist/subscribers/index.d.mts.map +1 -1
  131. package/dist/subscribers/index.mjs +78 -108
  132. package/dist/subscribers/index.mjs.map +1 -1
  133. package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
  134. package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
  135. package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
  136. package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
  137. package/dist/topic/index.cjs +91 -3
  138. package/dist/topic/index.cjs.map +1 -0
  139. package/dist/topic/index.d.cts +32 -2
  140. package/dist/topic/index.d.cts.map +1 -0
  141. package/dist/topic/index.d.mts +32 -2
  142. package/dist/topic/index.d.mts.map +1 -0
  143. package/dist/topic/index.mjs +89 -2
  144. package/dist/topic/index.mjs.map +1 -0
  145. package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
  146. package/dist/types-BdAaYDvd.d.cts.map +1 -0
  147. package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
  148. package/dist/types-DNngH0fX.d.mts.map +1 -0
  149. package/dist/types.d.cts +1 -1
  150. package/dist/types.d.mts +1 -1
  151. package/dist/types.mjs +0 -1
  152. package/package.json +55 -223
  153. package/src/Construct.ts +209 -0
  154. package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
  155. package/src/__benchmarks__/endpoint.bench.ts +494 -0
  156. package/src/__benchmarks__/fixtures.ts +241 -0
  157. package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
  158. package/src/__benchmarks__/hono-server.bench.ts +249 -0
  159. package/src/__benchmarks__/response-builder.bench.ts +428 -0
  160. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
  161. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
  162. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
  163. package/src/__tests__/Construct.environment.spec.ts +704 -0
  164. package/src/__tests__/builder-reuse.spec.ts +587 -0
  165. package/src/__tests__/monitor.spec.ts +636 -0
  166. package/src/__tests__/publisher.setting.spec.ts +508 -0
  167. package/src/__tests__/publisher.spec.ts +452 -0
  168. package/src/adaptors/aws.ts +6 -0
  169. package/src/adaptors/hono.ts +1 -0
  170. package/src/adaptors/testing.ts +11 -0
  171. package/src/clone.ts +38 -0
  172. package/src/crons/AWSScheduledFunction.ts +73 -0
  173. package/src/crons/Cron.ts +149 -0
  174. package/src/crons/CronBuilder.ts +261 -0
  175. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
  176. package/src/crons/__tests__/Cron.spec.ts +472 -0
  177. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
  178. package/src/crons/index.ts +12 -0
  179. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
  180. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
  181. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
  182. package/src/endpoints/Authorizer.ts +152 -0
  183. package/src/endpoints/Endpoint.ts +1287 -0
  184. package/src/endpoints/EndpointBuilder.ts +749 -0
  185. package/src/endpoints/EndpointFactory.ts +1179 -0
  186. package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
  187. package/src/endpoints/MswEndpointAdaptor.ts +226 -0
  188. package/src/endpoints/TestEndpointAdaptor.ts +466 -0
  189. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
  190. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
  191. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
  192. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
  193. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
  194. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
  195. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
  196. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
  197. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
  198. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
  199. package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
  200. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
  201. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
  202. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
  203. package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
  204. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
  205. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
  206. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
  207. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
  208. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
  209. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
  210. package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
  211. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
  212. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
  213. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
  214. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
  215. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
  216. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
  217. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
  218. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
  219. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
  220. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
  221. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
  222. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
  223. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
  224. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
  225. package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
  226. package/src/endpoints/__tests__/helpers.spec.ts +37 -0
  227. package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
  228. package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
  229. package/src/endpoints/audit.ts +87 -0
  230. package/src/endpoints/helpers.ts +98 -0
  231. package/src/endpoints/index.ts +42 -0
  232. package/src/endpoints/lazyAccessors.ts +241 -0
  233. package/src/endpoints/parseHonoQuery.ts +16 -0
  234. package/src/endpoints/parseQueryParams.ts +32 -0
  235. package/src/endpoints/processAudits.ts +371 -0
  236. package/src/endpoints/rls.ts +67 -0
  237. package/src/functions/AWSLambdaFunction.ts +374 -0
  238. package/src/functions/BaseFunctionBuilder.ts +212 -0
  239. package/src/functions/Function.ts +238 -0
  240. package/src/functions/FunctionBuilder.ts +381 -0
  241. package/src/functions/FunctionExecutionWrapper.ts +216 -0
  242. package/src/functions/TestFunctionAdaptor.ts +252 -0
  243. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
  244. package/src/functions/__tests__/Function.audits.spec.ts +393 -0
  245. package/src/functions/__tests__/Function.spec.ts +477 -0
  246. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
  247. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
  248. package/src/functions/index.ts +12 -0
  249. package/src/index.ts +29 -0
  250. package/src/monitor.ts +145 -0
  251. package/src/monitors/heartbeat.ts +86 -0
  252. package/src/monitors/index.ts +6 -0
  253. package/src/publisher.ts +93 -0
  254. package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
  255. package/src/queue/Queue.ts +128 -0
  256. package/src/queue/QueueBuilder.ts +115 -0
  257. package/src/queue/TestQueueAdaptor.ts +63 -0
  258. package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
  259. package/src/queue/index.ts +12 -0
  260. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
  261. package/src/subscribers/Subscriber.ts +117 -0
  262. package/src/subscribers/SubscriberBuilder.ts +183 -0
  263. package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
  264. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
  265. package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
  266. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
  267. package/src/subscribers/index.ts +6 -0
  268. package/src/telemetry.ts +103 -0
  269. package/src/topic/Topic.ts +103 -0
  270. package/src/topic/TopicBuilder.ts +53 -0
  271. package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
  272. package/src/topic/index.ts +11 -0
  273. package/src/types.ts +13 -0
  274. package/test.ts +91 -0
  275. package/tsconfig.json +9 -0
  276. package/tsdown.config.ts +35 -0
  277. package/dist/Construct-B1vGBPme.mjs.map +0 -1
  278. package/dist/Construct-BQALFCh2.d.cts +0 -230
  279. package/dist/Construct-BQALFCh2.d.cts.map +0 -1
  280. package/dist/Construct-DUSXuTHP.cjs.map +0 -1
  281. package/dist/Construct-QXnl3VqT.d.mts +0 -230
  282. package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
  283. package/dist/Cron-DI3nKoic.d.cts +0 -45
  284. package/dist/Cron-DI3nKoic.d.cts.map +0 -1
  285. package/dist/Cron-uYAHPnp7.d.mts +0 -45
  286. package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
  287. package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
  288. package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
  289. package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
  290. package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
  291. package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
  292. package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
  293. package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
  294. package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
  295. package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
  296. package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
  297. package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
  298. package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
  299. package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
  300. package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
  301. package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
  302. package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
  303. package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
  304. package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
  305. package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
  306. package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
  307. package/dist/Function-DuqGcbOI.d.mts +0 -76
  308. package/dist/Function-DuqGcbOI.d.mts.map +0 -1
  309. package/dist/Function-Pu-1kKZz.d.cts +0 -76
  310. package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
  311. package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
  312. package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
  313. package/dist/Queue-A3wfD0it.cjs +0 -109
  314. package/dist/Queue-A3wfD0it.cjs.map +0 -1
  315. package/dist/Queue-D6USGS4q.mjs +0 -104
  316. package/dist/Queue-D6USGS4q.mjs.map +0 -1
  317. package/dist/Queue-DlsHRzUp.d.mts +0 -105
  318. package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
  319. package/dist/Queue-HPyi0e1i.d.cts +0 -105
  320. package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
  321. package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
  322. package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
  323. package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
  324. package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
  325. package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
  326. package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
  327. package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
  328. package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
  329. package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
  330. package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
  331. package/dist/Subscriber-CtN9R48-.d.mts +0 -61
  332. package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
  333. package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
  334. package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
  335. package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
  336. package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
  337. package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
  338. package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
  339. package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
  340. package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
  341. package/dist/Topic-D74b5cgs.mjs +0 -99
  342. package/dist/Topic-D74b5cgs.mjs.map +0 -1
  343. package/dist/Topic-GHxcU8AG.cjs +0 -104
  344. package/dist/Topic-GHxcU8AG.cjs.map +0 -1
  345. package/dist/auth-BMCJN30Y.d.cts +0 -268
  346. package/dist/auth-BMCJN30Y.d.cts.map +0 -1
  347. package/dist/auth-CcuceLYo.d.mts +0 -268
  348. package/dist/auth-CcuceLYo.d.mts.map +0 -1
  349. package/dist/auth.cjs +0 -433
  350. package/dist/auth.cjs.map +0 -1
  351. package/dist/auth.d.cts +0 -2
  352. package/dist/auth.d.mts +0 -2
  353. package/dist/auth.mjs +0 -426
  354. package/dist/auth.mjs.map +0 -1
  355. package/dist/cache-CXh6GIgb.d.mts +0 -44
  356. package/dist/cache-CXh6GIgb.d.mts.map +0 -1
  357. package/dist/cache-DnGDGly3.d.cts +0 -44
  358. package/dist/cache-DnGDGly3.d.cts.map +0 -1
  359. package/dist/cache.cjs +0 -69
  360. package/dist/cache.cjs.map +0 -1
  361. package/dist/cache.d.cts +0 -2
  362. package/dist/cache.d.mts +0 -2
  363. package/dist/cache.mjs +0 -68
  364. package/dist/cache.mjs.map +0 -1
  365. package/dist/cipher-C1lEFX63.mjs +0 -225
  366. package/dist/cipher-C1lEFX63.mjs.map +0 -1
  367. package/dist/cipher-CVxfwLjk.cjs +0 -332
  368. package/dist/cipher-CVxfwLjk.cjs.map +0 -1
  369. package/dist/clone-EKNovYHu.mjs.map +0 -1
  370. package/dist/clone-UGJpvQnL.cjs.map +0 -1
  371. package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
  372. package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
  373. package/dist/construct-interface-DluK3_da.d.mts +0 -162
  374. package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
  375. package/dist/construct-interface.cjs +0 -114
  376. package/dist/construct-interface.cjs.map +0 -1
  377. package/dist/construct-interface.d.cts +0 -2
  378. package/dist/construct-interface.d.mts +0 -2
  379. package/dist/construct-interface.mjs +0 -107
  380. package/dist/construct-interface.mjs.map +0 -1
  381. package/dist/credential.cjs +0 -156
  382. package/dist/credential.cjs.map +0 -1
  383. package/dist/credential.d.cts +0 -86
  384. package/dist/credential.d.cts.map +0 -1
  385. package/dist/credential.d.mts +0 -86
  386. package/dist/credential.d.mts.map +0 -1
  387. package/dist/credential.mjs +0 -152
  388. package/dist/credential.mjs.map +0 -1
  389. package/dist/database/kysely.cjs +0 -4
  390. package/dist/database/kysely.d.cts +0 -2
  391. package/dist/database/kysely.d.mts +0 -2
  392. package/dist/database/kysely.mjs +0 -2
  393. package/dist/email.cjs +0 -72
  394. package/dist/email.cjs.map +0 -1
  395. package/dist/email.d.cts +0 -46
  396. package/dist/email.d.cts.map +0 -1
  397. package/dist/email.d.mts +0 -46
  398. package/dist/email.d.mts.map +0 -1
  399. package/dist/email.mjs +0 -71
  400. package/dist/email.mjs.map +0 -1
  401. package/dist/encryption.cjs +0 -96
  402. package/dist/encryption.cjs.map +0 -1
  403. package/dist/encryption.d.cts +0 -117
  404. package/dist/encryption.d.cts.map +0 -1
  405. package/dist/encryption.d.mts +0 -117
  406. package/dist/encryption.d.mts.map +0 -1
  407. package/dist/encryption.mjs +0 -83
  408. package/dist/encryption.mjs.map +0 -1
  409. package/dist/external-api-MJ8id87V.d.mts +0 -105
  410. package/dist/external-api-MJ8id87V.d.mts.map +0 -1
  411. package/dist/external-api-O107yzZJ.d.cts +0 -105
  412. package/dist/external-api-O107yzZJ.d.cts.map +0 -1
  413. package/dist/external-api.cjs +0 -142
  414. package/dist/external-api.cjs.map +0 -1
  415. package/dist/external-api.d.cts +0 -2
  416. package/dist/external-api.d.mts +0 -2
  417. package/dist/external-api.mjs +0 -139
  418. package/dist/external-api.mjs.map +0 -1
  419. package/dist/file-server.cjs +0 -186
  420. package/dist/file-server.cjs.map +0 -1
  421. package/dist/file-server.d.cts +0 -152
  422. package/dist/file-server.d.cts.map +0 -1
  423. package/dist/file-server.d.mts +0 -152
  424. package/dist/file-server.d.mts.map +0 -1
  425. package/dist/file-server.mjs +0 -184
  426. package/dist/file-server.mjs.map +0 -1
  427. package/dist/functions-BFizikJU.mjs.map +0 -1
  428. package/dist/functions-CfzJG9hK.cjs.map +0 -1
  429. package/dist/index-BuzRvKOQ.d.cts +0 -115
  430. package/dist/index-BuzRvKOQ.d.cts.map +0 -1
  431. package/dist/index-CTkKOer4.d.mts +0 -115
  432. package/dist/index-CTkKOer4.d.mts.map +0 -1
  433. package/dist/index-CeEtxDmK.d.cts +0 -79
  434. package/dist/index-CeEtxDmK.d.cts.map +0 -1
  435. package/dist/index-CeEtxDmK.d.mts +0 -79
  436. package/dist/index-CeEtxDmK.d.mts.map +0 -1
  437. package/dist/index.d.cts.map +0 -1
  438. package/dist/index.d.mts.map +0 -1
  439. package/dist/kms-B-Hm3d5r.cjs +0 -85
  440. package/dist/kms-B-Hm3d5r.cjs.map +0 -1
  441. package/dist/kms-BdUlMJEZ.mjs +0 -85
  442. package/dist/kms-BdUlMJEZ.mjs.map +0 -1
  443. package/dist/kysely-Bii4l6eP.mjs +0 -370
  444. package/dist/kysely-Bii4l6eP.mjs.map +0 -1
  445. package/dist/kysely-CO_Dk43W.cjs +0 -383
  446. package/dist/kysely-CO_Dk43W.cjs.map +0 -1
  447. package/dist/kysely-D0bpzgPs.d.cts +0 -175
  448. package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
  449. package/dist/kysely-DUqC3Ie0.d.mts +0 -175
  450. package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
  451. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
  452. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
  453. package/dist/lazyAccessors-CFanua0O.mjs +0 -174
  454. package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
  455. package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
  456. package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
  457. package/dist/mobile-app.cjs +0 -73
  458. package/dist/mobile-app.cjs.map +0 -1
  459. package/dist/mobile-app.d.cts +0 -61
  460. package/dist/mobile-app.d.cts.map +0 -1
  461. package/dist/mobile-app.d.mts +0 -61
  462. package/dist/mobile-app.d.mts.map +0 -1
  463. package/dist/mobile-app.mjs +0 -72
  464. package/dist/mobile-app.mjs.map +0 -1
  465. package/dist/object-storage.cjs +0 -56
  466. package/dist/object-storage.cjs.map +0 -1
  467. package/dist/object-storage.d.cts +0 -32
  468. package/dist/object-storage.d.cts.map +0 -1
  469. package/dist/object-storage.d.mts +0 -32
  470. package/dist/object-storage.d.mts.map +0 -1
  471. package/dist/object-storage.mjs +0 -55
  472. package/dist/object-storage.mjs.map +0 -1
  473. package/dist/processAudits-BRRVVHUB.mjs +0 -131
  474. package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
  475. package/dist/processAudits-DasOZjPl.cjs +0 -154
  476. package/dist/processAudits-DasOZjPl.cjs.map +0 -1
  477. package/dist/rest-api.cjs +0 -216
  478. package/dist/rest-api.cjs.map +0 -1
  479. package/dist/rest-api.d.cts +0 -241
  480. package/dist/rest-api.d.cts.map +0 -1
  481. package/dist/rest-api.d.mts +0 -241
  482. package/dist/rest-api.d.mts.map +0 -1
  483. package/dist/rest-api.mjs +0 -215
  484. package/dist/rest-api.mjs.map +0 -1
  485. package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
  486. package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
  487. package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
  488. package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
  489. package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
  490. package/dist/shutdown-BMJmAhSt.cjs +0 -38
  491. package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
  492. package/dist/shutdown-C7xa8x9S.mjs +0 -27
  493. package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
  494. package/dist/site.cjs +0 -74
  495. package/dist/site.cjs.map +0 -1
  496. package/dist/site.d.cts +0 -104
  497. package/dist/site.d.cts.map +0 -1
  498. package/dist/site.d.mts +0 -104
  499. package/dist/site.d.mts.map +0 -1
  500. package/dist/site.mjs +0 -73
  501. package/dist/site.mjs.map +0 -1
  502. package/dist/stages-BSCF19o2.d.cts +0 -56
  503. package/dist/stages-BSCF19o2.d.cts.map +0 -1
  504. package/dist/stages-BSCF19o2.d.mts +0 -56
  505. package/dist/stages-BSCF19o2.d.mts.map +0 -1
  506. package/dist/surfaceEnv-CNimK76p.cjs +0 -56
  507. package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
  508. package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
  509. package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
  510. package/dist/telemetry-B48RLjyk.d.cts +0 -40
  511. package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
  512. package/dist/telemetry-DRtT1_0A.d.mts +0 -40
  513. package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
  514. package/dist/telemetry.cjs +0 -56
  515. package/dist/telemetry.cjs.map +0 -1
  516. package/dist/telemetry.d.cts +0 -2
  517. package/dist/telemetry.d.mts +0 -2
  518. package/dist/telemetry.mjs +0 -55
  519. package/dist/telemetry.mjs.map +0 -1
  520. package/dist/tracing-CxaZ98IB.mjs +0 -110
  521. package/dist/tracing-CxaZ98IB.mjs.map +0 -1
  522. package/dist/tracing-DPMidF_r.cjs +0 -127
  523. package/dist/tracing-DPMidF_r.cjs.map +0 -1
  524. package/dist/types-DMuSQeLL.d.cts.map +0 -1
  525. package/dist/types-DMuSQeLL.d.mts.map +0 -1
  526. package/dist/worker.cjs +0 -191
  527. package/dist/worker.cjs.map +0 -1
  528. package/dist/worker.d.cts +0 -171
  529. package/dist/worker.d.cts.map +0 -1
  530. package/dist/worker.d.mts +0 -171
  531. package/dist/worker.d.mts.map +0 -1
  532. package/dist/worker.mjs +0 -190
  533. package/dist/worker.mjs.map +0 -1
@@ -0,0 +1,631 @@
1
+ import type {
2
+ AuditableAction,
3
+ Auditor,
4
+ AuditRecord,
5
+ AuditStorage,
6
+ } from '@geekmidas/audit';
7
+ import { DefaultAuditor } from '@geekmidas/audit';
8
+ import { ConsoleLogger } from '@geekmidas/logger/console';
9
+ import type { Service, ServiceDiscovery } from '@geekmidas/services';
10
+ import { describe, expect, it, vi } from 'vitest';
11
+ import { z } from 'zod';
12
+ import { EndpointBuilder } from '../EndpointBuilder';
13
+ import {
14
+ createAuditContext,
15
+ executeWithAuditTransaction,
16
+ processEndpointAudits,
17
+ } from '../processAudits';
18
+
19
+ // Test audit actions
20
+ type TestAuditAction =
21
+ | AuditableAction<'user.created', { userId: string; email: string }>
22
+ | AuditableAction<'user.updated', { userId: string; changes: string[] }>;
23
+
24
+ // In-memory audit storage
25
+ class InMemoryAuditStorage implements AuditStorage {
26
+ records: AuditRecord[] = [];
27
+ withTransactionCalled = false;
28
+ transactionDb: unknown = null;
29
+
30
+ async write(records: AuditRecord[]): Promise<void> {
31
+ this.records.push(...records);
32
+ }
33
+
34
+ async query(): Promise<AuditRecord[]> {
35
+ return this.records;
36
+ }
37
+
38
+ withTransaction<T>(
39
+ auditor: Auditor<any>,
40
+ fn: () => Promise<T>,
41
+ db?: unknown,
42
+ ): Promise<T> {
43
+ this.withTransactionCalled = true;
44
+ this.transactionDb = db;
45
+ // Simulate transaction by setting a mock transaction
46
+ if ('setTransaction' in auditor) {
47
+ (auditor as any).setTransaction({ mockTrx: true });
48
+ }
49
+ return fn().then(async (result) => {
50
+ await auditor.flush();
51
+ return result;
52
+ });
53
+ }
54
+ }
55
+
56
+ // Storage without transaction support
57
+ class SimpleAuditStorage implements AuditStorage {
58
+ records: AuditRecord[] = [];
59
+
60
+ async write(records: AuditRecord[]): Promise<void> {
61
+ this.records.push(...records);
62
+ }
63
+
64
+ async query(): Promise<AuditRecord[]> {
65
+ return this.records;
66
+ }
67
+ }
68
+
69
+ const createMockServiceDiscovery = (
70
+ storage: AuditStorage,
71
+ ): ServiceDiscovery<any, any> => {
72
+ return {
73
+ register: vi.fn().mockResolvedValue({ auditStorage: storage }),
74
+ } as unknown as ServiceDiscovery<any, any>;
75
+ };
76
+
77
+ const auditStorageService = {
78
+ serviceName: 'auditStorage' as const,
79
+ async register() {
80
+ return new InMemoryAuditStorage();
81
+ },
82
+ } satisfies Service<'auditStorage', InMemoryAuditStorage>;
83
+
84
+ const logger = new ConsoleLogger();
85
+
86
+ describe('processAudits', () => {
87
+ describe('processEndpointAudits', () => {
88
+ it('should skip processing when no audits and no existing records', async () => {
89
+ const endpoint = new EndpointBuilder('/users', 'POST').handle(
90
+ async () => ({ id: '123' }),
91
+ );
92
+
93
+ const storage = new InMemoryAuditStorage();
94
+ const discovery = createMockServiceDiscovery(storage);
95
+
96
+ await processEndpointAudits(endpoint, { id: '123' }, discovery, logger, {
97
+ session: {},
98
+ header: () => undefined,
99
+ cookie: () => undefined,
100
+ services: {},
101
+ });
102
+
103
+ expect(storage.records).toHaveLength(0);
104
+ });
105
+
106
+ it('should warn when no storage service but has audits', async () => {
107
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
108
+
109
+ const endpoint = new EndpointBuilder('/users', 'POST')
110
+ .output(outputSchema)
111
+ .audit<TestAuditAction>([
112
+ {
113
+ type: 'user.created',
114
+ payload: (r) => ({ userId: r.id, email: r.email }),
115
+ },
116
+ ])
117
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
118
+
119
+ const warnSpy = vi.spyOn(logger, 'warn');
120
+ const discovery = createMockServiceDiscovery(new InMemoryAuditStorage());
121
+
122
+ await processEndpointAudits(
123
+ endpoint,
124
+ { id: '123', email: 'test@test.com' },
125
+ discovery,
126
+ logger,
127
+ {
128
+ session: {},
129
+ header: () => undefined,
130
+ cookie: () => undefined,
131
+ services: {},
132
+ },
133
+ );
134
+
135
+ expect(warnSpy).toHaveBeenCalledWith(
136
+ 'No auditor storage service available',
137
+ );
138
+ });
139
+
140
+ it('should process declarative audits', async () => {
141
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
142
+ const storage = new InMemoryAuditStorage();
143
+
144
+ // Create a custom storage service that returns our shared storage
145
+ const customStorageService = {
146
+ serviceName: 'auditStorage' as const,
147
+ async register() {
148
+ return storage;
149
+ },
150
+ } satisfies Service<'auditStorage', InMemoryAuditStorage>;
151
+
152
+ const endpoint = new EndpointBuilder('/users', 'POST')
153
+ .output(outputSchema)
154
+ .auditor(customStorageService)
155
+ .audit<TestAuditAction>([
156
+ {
157
+ type: 'user.created',
158
+ payload: (r) => ({ userId: r.id, email: r.email }),
159
+ },
160
+ ])
161
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
162
+
163
+ // Mock the service discovery to return our storage
164
+ const mockDiscovery = {
165
+ register: vi.fn().mockImplementation(async () => {
166
+ return { auditStorage: storage };
167
+ }),
168
+ } as unknown as ServiceDiscovery<any, any>;
169
+
170
+ await processEndpointAudits(
171
+ endpoint,
172
+ { id: '123', email: 'test@test.com' },
173
+ mockDiscovery,
174
+ logger,
175
+ {
176
+ session: {},
177
+ header: () => undefined,
178
+ cookie: () => undefined,
179
+ services: {},
180
+ },
181
+ );
182
+
183
+ expect(storage.records).toHaveLength(1);
184
+ expect(storage.records[0].type).toBe('user.created');
185
+ expect(storage.records[0].payload).toEqual({
186
+ userId: '123',
187
+ email: 'test@test.com',
188
+ });
189
+ });
190
+
191
+ it('should skip audits when when condition returns false', async () => {
192
+ const outputSchema = z.object({
193
+ id: z.string(),
194
+ email: z.string(),
195
+ active: z.boolean(),
196
+ });
197
+ const storage = new InMemoryAuditStorage();
198
+
199
+ const endpoint = new EndpointBuilder('/users', 'POST')
200
+ .output(outputSchema)
201
+ .auditor(auditStorageService)
202
+ .audit<TestAuditAction>([
203
+ {
204
+ type: 'user.created',
205
+ payload: (r) => ({ userId: r.id, email: r.email }),
206
+ when: (r) => r.active,
207
+ },
208
+ ])
209
+ .handle(async () => ({
210
+ id: '123',
211
+ email: 'test@test.com',
212
+ active: false,
213
+ }));
214
+
215
+ const discovery = createMockServiceDiscovery(storage);
216
+
217
+ await processEndpointAudits(
218
+ endpoint,
219
+ { id: '123', email: 'test@test.com', active: false },
220
+ discovery,
221
+ logger,
222
+ {
223
+ session: {},
224
+ header: () => undefined,
225
+ cookie: () => undefined,
226
+ services: {},
227
+ },
228
+ );
229
+
230
+ expect(storage.records).toHaveLength(0);
231
+ });
232
+
233
+ it('should use existing auditor when provided', async () => {
234
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
235
+ const storage = new InMemoryAuditStorage();
236
+
237
+ const endpoint = new EndpointBuilder('/users', 'POST')
238
+ .output(outputSchema)
239
+ .auditor(auditStorageService)
240
+ .audit<TestAuditAction>([
241
+ {
242
+ type: 'user.created',
243
+ payload: (r) => ({ userId: r.id, email: r.email }),
244
+ },
245
+ ])
246
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
247
+
248
+ const discovery = createMockServiceDiscovery(storage);
249
+
250
+ // Create an existing auditor with some records already
251
+ const existingAuditor = new DefaultAuditor<TestAuditAction>({
252
+ actor: { id: 'existing-user', type: 'user' },
253
+ storage,
254
+ });
255
+ existingAuditor.audit('user.updated', {
256
+ userId: '456',
257
+ changes: ['name'],
258
+ });
259
+
260
+ await processEndpointAudits(
261
+ endpoint,
262
+ { id: '123', email: 'test@test.com' },
263
+ discovery,
264
+ logger,
265
+ {
266
+ session: {},
267
+ header: () => undefined,
268
+ cookie: () => undefined,
269
+ services: {},
270
+ },
271
+ existingAuditor,
272
+ );
273
+
274
+ // Should have both the existing record and the new declarative one
275
+ expect(storage.records).toHaveLength(2);
276
+ });
277
+
278
+ it('should extract actor when configured', async () => {
279
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
280
+ const storage = new InMemoryAuditStorage();
281
+
282
+ const endpoint = new EndpointBuilder('/users', 'POST')
283
+ .output(outputSchema)
284
+ .auditor(auditStorageService)
285
+ .actor(({ session }) => ({
286
+ id: (session as any).userId,
287
+ type: 'user',
288
+ }))
289
+ .audit<TestAuditAction>([
290
+ {
291
+ type: 'user.created',
292
+ payload: (r) => ({ userId: r.id, email: r.email }),
293
+ },
294
+ ])
295
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
296
+
297
+ const discovery = createMockServiceDiscovery(storage);
298
+
299
+ await processEndpointAudits(
300
+ endpoint,
301
+ { id: '123', email: 'test@test.com' },
302
+ discovery,
303
+ logger,
304
+ {
305
+ session: { userId: 'actor-123' },
306
+ header: () => undefined,
307
+ cookie: () => undefined,
308
+ services: {},
309
+ },
310
+ );
311
+
312
+ expect(storage.records).toHaveLength(1);
313
+ expect(storage.records[0].actor.id).toBe('actor-123');
314
+ });
315
+
316
+ it('should handle actor extraction errors gracefully', async () => {
317
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
318
+ const storage = new InMemoryAuditStorage();
319
+
320
+ const endpoint = new EndpointBuilder('/users', 'POST')
321
+ .output(outputSchema)
322
+ .auditor(auditStorageService)
323
+ .actor(() => {
324
+ throw new Error('Actor extraction failed');
325
+ })
326
+ .audit<TestAuditAction>([
327
+ {
328
+ type: 'user.created',
329
+ payload: (r) => ({ userId: r.id, email: r.email }),
330
+ },
331
+ ])
332
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
333
+
334
+ const discovery = createMockServiceDiscovery(storage);
335
+
336
+ // Should not throw, continue with system actor
337
+ await processEndpointAudits(
338
+ endpoint,
339
+ { id: '123', email: 'test@test.com' },
340
+ discovery,
341
+ logger,
342
+ {
343
+ session: {},
344
+ header: () => undefined,
345
+ cookie: () => undefined,
346
+ services: {},
347
+ },
348
+ );
349
+
350
+ expect(storage.records).toHaveLength(1);
351
+ expect(storage.records[0].actor.id).toBe('system');
352
+ });
353
+
354
+ it('should include entityId and table when configured', async () => {
355
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
356
+ const storage = new InMemoryAuditStorage();
357
+
358
+ const endpoint = new EndpointBuilder('/users', 'POST')
359
+ .output(outputSchema)
360
+ .auditor(auditStorageService)
361
+ .audit<TestAuditAction>([
362
+ {
363
+ type: 'user.created',
364
+ payload: (r) => ({ userId: r.id, email: r.email }),
365
+ entityId: (r) => r.id,
366
+ table: 'users',
367
+ },
368
+ ])
369
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
370
+
371
+ const discovery = createMockServiceDiscovery(storage);
372
+
373
+ await processEndpointAudits(
374
+ endpoint,
375
+ { id: '123', email: 'test@test.com' },
376
+ discovery,
377
+ logger,
378
+ {
379
+ session: {},
380
+ header: () => undefined,
381
+ cookie: () => undefined,
382
+ services: {},
383
+ },
384
+ );
385
+
386
+ expect(storage.records).toHaveLength(1);
387
+ expect(storage.records[0].entityId).toBe('123');
388
+ expect(storage.records[0].table).toBe('users');
389
+ });
390
+
391
+ it('should handle errors during processing', async () => {
392
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
393
+
394
+ const endpoint = new EndpointBuilder('/users', 'POST')
395
+ .output(outputSchema)
396
+ .auditor(auditStorageService)
397
+ .audit<TestAuditAction>([
398
+ {
399
+ type: 'user.created',
400
+ payload: () => {
401
+ throw new Error('Payload extraction failed');
402
+ },
403
+ },
404
+ ])
405
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
406
+
407
+ const discovery = createMockServiceDiscovery(new InMemoryAuditStorage());
408
+ const errorSpy = vi.spyOn(logger, 'error');
409
+
410
+ // Should not throw
411
+ await processEndpointAudits(
412
+ endpoint,
413
+ { id: '123', email: 'test@test.com' },
414
+ discovery,
415
+ logger,
416
+ {
417
+ session: {},
418
+ header: () => undefined,
419
+ cookie: () => undefined,
420
+ services: {},
421
+ },
422
+ );
423
+
424
+ expect(errorSpy).toHaveBeenCalled();
425
+ });
426
+ });
427
+
428
+ describe('createAuditContext', () => {
429
+ it('should return undefined when no storage service', async () => {
430
+ const endpoint = new EndpointBuilder('/users', 'POST').handle(
431
+ async () => ({ id: '123' }),
432
+ );
433
+
434
+ const discovery = createMockServiceDiscovery(new InMemoryAuditStorage());
435
+
436
+ const context = await createAuditContext(endpoint, discovery, logger, {
437
+ session: {},
438
+ header: () => undefined,
439
+ cookie: () => undefined,
440
+ services: {},
441
+ });
442
+
443
+ expect(context).toBeUndefined();
444
+ });
445
+
446
+ it('should create audit context with storage and auditor', async () => {
447
+ const storage = new InMemoryAuditStorage();
448
+
449
+ const endpoint = new EndpointBuilder('/users', 'POST')
450
+ .auditor(auditStorageService)
451
+ .handle(async () => ({ id: '123' }));
452
+
453
+ const discovery = createMockServiceDiscovery(storage);
454
+
455
+ const context = await createAuditContext(endpoint, discovery, logger, {
456
+ session: {},
457
+ header: () => undefined,
458
+ cookie: () => undefined,
459
+ services: {},
460
+ });
461
+
462
+ expect(context).toBeDefined();
463
+ expect(context!.storage).toBe(storage);
464
+ expect(context!.auditor).toBeDefined();
465
+ });
466
+
467
+ it('should use custom actor extractor', async () => {
468
+ const storage = new InMemoryAuditStorage();
469
+
470
+ const endpoint = new EndpointBuilder('/users', 'POST')
471
+ .auditor(auditStorageService)
472
+ .actor(({ session }) => ({
473
+ id: (session as any).userId,
474
+ type: 'user',
475
+ }))
476
+ .handle(async () => ({ id: '123' }));
477
+
478
+ const discovery = createMockServiceDiscovery(storage);
479
+
480
+ const context = await createAuditContext(endpoint, discovery, logger, {
481
+ session: { userId: 'actor-456' },
482
+ header: () => undefined,
483
+ cookie: () => undefined,
484
+ services: {},
485
+ });
486
+
487
+ expect(context).toBeDefined();
488
+
489
+ // Record an audit and check the actor
490
+ context!.auditor.audit('user.created' as any, {
491
+ userId: '123',
492
+ email: 'test@test.com',
493
+ });
494
+ await context!.auditor.flush();
495
+
496
+ expect(storage.records[0].actor.id).toBe('actor-456');
497
+ });
498
+
499
+ it('should use system actor when extraction fails', async () => {
500
+ const storage = new InMemoryAuditStorage();
501
+
502
+ const endpoint = new EndpointBuilder('/users', 'POST')
503
+ .auditor(auditStorageService)
504
+ .actor(() => {
505
+ throw new Error('Actor extraction failed');
506
+ })
507
+ .handle(async () => ({ id: '123' }));
508
+
509
+ const discovery = createMockServiceDiscovery(storage);
510
+
511
+ const context = await createAuditContext(endpoint, discovery, logger, {
512
+ session: {},
513
+ header: () => undefined,
514
+ cookie: () => undefined,
515
+ services: {},
516
+ });
517
+
518
+ expect(context).toBeDefined();
519
+
520
+ context!.auditor.audit('user.created' as any, {
521
+ userId: '123',
522
+ email: 'test@test.com',
523
+ });
524
+ await context!.auditor.flush();
525
+
526
+ expect(storage.records[0].actor.id).toBe('system');
527
+ });
528
+ });
529
+
530
+ describe('executeWithAuditTransaction', () => {
531
+ it('should run handler without context', async () => {
532
+ const handlerFn = vi.fn().mockResolvedValue({ id: '123' });
533
+
534
+ const result = await executeWithAuditTransaction(undefined, handlerFn);
535
+
536
+ expect(result).toEqual({ id: '123' });
537
+ expect(handlerFn).toHaveBeenCalledWith(undefined);
538
+ });
539
+
540
+ it('should use transaction when storage supports it', async () => {
541
+ const storage = new InMemoryAuditStorage();
542
+ const auditor = new DefaultAuditor<TestAuditAction>({
543
+ actor: { id: 'test', type: 'user' },
544
+ storage,
545
+ });
546
+
547
+ const context = { auditor, storage };
548
+ const handlerFn = vi.fn().mockResolvedValue({ id: '123' });
549
+
550
+ const result = await executeWithAuditTransaction(context, handlerFn);
551
+
552
+ expect(result).toEqual({ id: '123' });
553
+ expect(storage.withTransactionCalled).toBe(true);
554
+ });
555
+
556
+ it('should pass db option to storage transaction', async () => {
557
+ const storage = new InMemoryAuditStorage();
558
+ const auditor = new DefaultAuditor<TestAuditAction>({
559
+ actor: { id: 'test', type: 'user' },
560
+ storage,
561
+ });
562
+
563
+ const context = { auditor, storage };
564
+ const mockDb = { isMockDb: true };
565
+
566
+ await executeWithAuditTransaction(
567
+ context,
568
+ async () => ({ id: '123' }),
569
+ undefined,
570
+ { db: mockDb },
571
+ );
572
+
573
+ expect(storage.transactionDb).toBe(mockDb);
574
+ });
575
+
576
+ it('should call onComplete callback', async () => {
577
+ const storage = new InMemoryAuditStorage();
578
+ const auditor = new DefaultAuditor<TestAuditAction>({
579
+ actor: { id: 'test', type: 'user' },
580
+ storage,
581
+ });
582
+
583
+ const context = { auditor, storage };
584
+ const onComplete = vi.fn();
585
+
586
+ const _result = await executeWithAuditTransaction(
587
+ context,
588
+ async () => ({ id: '123' }),
589
+ onComplete,
590
+ );
591
+
592
+ expect(onComplete).toHaveBeenCalledWith({ id: '123' }, auditor);
593
+ });
594
+
595
+ it('should flush audits when storage has no transaction support', async () => {
596
+ const storage = new SimpleAuditStorage();
597
+ const auditor = new DefaultAuditor<TestAuditAction>({
598
+ actor: { id: 'test', type: 'user' },
599
+ storage,
600
+ });
601
+
602
+ const context = { auditor, storage };
603
+
604
+ await executeWithAuditTransaction(context, async (a) => {
605
+ a!.audit('user.created', { userId: '123', email: 'test@test.com' });
606
+ return { id: '123' };
607
+ });
608
+
609
+ expect(storage.records).toHaveLength(1);
610
+ });
611
+
612
+ it('should call onComplete even without transaction support', async () => {
613
+ const storage = new SimpleAuditStorage();
614
+ const auditor = new DefaultAuditor<TestAuditAction>({
615
+ actor: { id: 'test', type: 'user' },
616
+ storage,
617
+ });
618
+
619
+ const context = { auditor, storage };
620
+ const onComplete = vi.fn();
621
+
622
+ await executeWithAuditTransaction(
623
+ context,
624
+ async () => ({ id: '123' }),
625
+ onComplete,
626
+ );
627
+
628
+ expect(onComplete).toHaveBeenCalled();
629
+ });
630
+ });
631
+ });
@@ -0,0 +1,87 @@
1
+ import type {
2
+ AuditActor,
3
+ AuditableAction,
4
+ AuditStorage,
5
+ ExtractAuditPayload,
6
+ ExtractAuditType,
7
+ } from '@geekmidas/audit';
8
+ import type { Logger } from '@geekmidas/logger';
9
+ import type { InferStandardSchema } from '@geekmidas/schema';
10
+ import type { Service, ServiceRecord } from '@geekmidas/services';
11
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
12
+ import type { CookieFn, HeaderFn } from './Endpoint';
13
+
14
+ /**
15
+ * Defines how to map an endpoint response to an audit record.
16
+ * Similar to MappedEvent for events.
17
+ *
18
+ * @template TAuditAction - Union of all allowed audit action types
19
+ * @template TOutput - The output schema of the endpoint
20
+ */
21
+ export interface MappedAudit<
22
+ TAuditAction extends AuditableAction<string, unknown>,
23
+ TOutput extends StandardSchemaV1 | undefined,
24
+ TType extends ExtractAuditType<TAuditAction> = ExtractAuditType<TAuditAction>,
25
+ > {
26
+ /** The audit type (must be a valid type from TAuditAction) */
27
+ type: TType;
28
+ /** Function to extract payload from the endpoint response */
29
+ payload: (
30
+ response: TOutput extends StandardSchemaV1
31
+ ? InferStandardSchema<TOutput>
32
+ : unknown,
33
+ ) => ExtractAuditPayload<TAuditAction, TType>;
34
+ /** Optional condition to determine if audit should be recorded */
35
+ when?: (
36
+ response: TOutput extends StandardSchemaV1
37
+ ? InferStandardSchema<TOutput>
38
+ : unknown,
39
+ ) => boolean;
40
+ /** Optional function to extract entity ID for easier querying */
41
+ entityId?: (
42
+ response: TOutput extends StandardSchemaV1
43
+ ? InferStandardSchema<TOutput>
44
+ : unknown,
45
+ ) => string | Record<string, unknown>;
46
+ /** Optional table name for the audit record */
47
+ table?: string;
48
+ }
49
+
50
+ /**
51
+ * Function type for extracting actor information from request context.
52
+ *
53
+ * @template TServices - Available service dependencies
54
+ * @template TSession - Session data type
55
+ * @template TLogger - Logger type
56
+ */
57
+ export type ActorExtractor<
58
+ TServices extends Service[] = [],
59
+ TSession = unknown,
60
+ TLogger extends Logger = Logger,
61
+ > = (ctx: {
62
+ services: ServiceRecord<TServices>;
63
+ session: TSession;
64
+ header: HeaderFn;
65
+ cookie: CookieFn;
66
+ logger: TLogger;
67
+ }) => AuditActor | Promise<AuditActor>;
68
+
69
+ /**
70
+ * Configuration for the auditor on an endpoint.
71
+ */
72
+ export interface EndpointAuditorConfig<
73
+ TAuditStorage extends AuditStorage,
74
+ TAuditStorageServiceName extends string,
75
+ TServices extends Service[],
76
+ TSession,
77
+ TLogger extends Logger,
78
+ TAuditAction extends AuditableAction<string, unknown>,
79
+ TOutput extends StandardSchemaV1 | undefined,
80
+ > {
81
+ /** The audit storage service */
82
+ storageService: Service<TAuditStorageServiceName, TAuditStorage>;
83
+ /** Optional actor extractor function */
84
+ actorExtractor?: ActorExtractor<TServices, TSession, TLogger>;
85
+ /** Declarative audit definitions */
86
+ audits: MappedAudit<TAuditAction, TOutput>[];
87
+ }