@geekmidas/constructs 10.0.0-alpha.99 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (533) hide show
  1. package/CHANGELOG.md +437 -0
  2. package/README.md +193 -285
  3. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
  4. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
  5. package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
  6. package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
  7. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
  8. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
  9. package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
  10. package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
  11. package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
  12. package/dist/Construct-BWF5HxaM.mjs.map +1 -0
  13. package/dist/Construct-JlyQkBkv.d.cts +117 -0
  14. package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
  15. package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
  16. package/dist/Construct-TGIM_E4o.cjs.map +1 -0
  17. package/dist/Construct-pxwC6fDD.d.mts +117 -0
  18. package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
  19. package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
  20. package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
  21. package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
  22. package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
  23. package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
  24. package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
  25. package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
  26. package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
  27. package/dist/Queue-BL68oDJ-.d.mts +66 -0
  28. package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
  29. package/dist/Queue-DxJ6btRE.d.cts +66 -0
  30. package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
  31. package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
  32. package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
  33. package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
  34. package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
  35. package/dist/Topic-DJXoDeMP.d.cts +60 -0
  36. package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
  37. package/dist/Topic-DxWQBgMN.d.mts +60 -0
  38. package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
  39. package/dist/adaptors/aws.cjs +205 -355
  40. package/dist/adaptors/aws.cjs.map +1 -1
  41. package/dist/adaptors/aws.d.cts +48 -126
  42. package/dist/adaptors/aws.d.cts.map +1 -1
  43. package/dist/adaptors/aws.d.mts +49 -127
  44. package/dist/adaptors/aws.d.mts.map +1 -1
  45. package/dist/adaptors/aws.mjs +178 -325
  46. package/dist/adaptors/aws.mjs.map +1 -1
  47. package/dist/adaptors/hono.cjs +9 -3
  48. package/dist/adaptors/hono.d.cts +15 -7
  49. package/dist/adaptors/hono.d.cts.map +1 -1
  50. package/dist/adaptors/hono.d.mts +17 -9
  51. package/dist/adaptors/hono.d.mts.map +1 -1
  52. package/dist/adaptors/hono.mjs +9 -2
  53. package/dist/adaptors/testing.cjs +209 -831
  54. package/dist/adaptors/testing.cjs.map +1 -1
  55. package/dist/adaptors/testing.d.cts +55 -351
  56. package/dist/adaptors/testing.d.cts.map +1 -1
  57. package/dist/adaptors/testing.d.mts +53 -349
  58. package/dist/adaptors/testing.d.mts.map +1 -1
  59. package/dist/adaptors/testing.mjs +195 -798
  60. package/dist/adaptors/testing.mjs.map +1 -1
  61. package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
  62. package/dist/clone-I_WIpiFf.cjs.map +1 -0
  63. package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
  64. package/dist/clone-pdXxc0t3.mjs.map +1 -0
  65. package/dist/crons/index.cjs +66 -190
  66. package/dist/crons/index.cjs.map +1 -1
  67. package/dist/crons/index.d.cts +35 -70
  68. package/dist/crons/index.d.cts.map +1 -1
  69. package/dist/crons/index.d.mts +32 -70
  70. package/dist/crons/index.d.mts.map +1 -1
  71. package/dist/crons/index.mjs +63 -184
  72. package/dist/crons/index.mjs.map +1 -1
  73. package/dist/endpoints/index.cjs +761 -19
  74. package/dist/endpoints/index.cjs.map +1 -0
  75. package/dist/endpoints/index.d.cts +322 -22
  76. package/dist/endpoints/index.d.cts.map +1 -1
  77. package/dist/endpoints/index.d.mts +321 -22
  78. package/dist/endpoints/index.d.mts.map +1 -1
  79. package/dist/endpoints/index.mjs +751 -6
  80. package/dist/endpoints/index.mjs.map +1 -0
  81. package/dist/functions/index.cjs +5 -2
  82. package/dist/functions/index.d.cts +3 -3
  83. package/dist/functions/index.d.mts +3 -3
  84. package/dist/functions/index.mjs +5 -2
  85. package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
  86. package/dist/functions-EqTloHjo.mjs.map +1 -0
  87. package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
  88. package/dist/functions-SqtCDc9c.cjs.map +1 -0
  89. package/dist/index-C7iynzLI.d.mts +139 -0
  90. package/dist/index-C7iynzLI.d.mts.map +1 -0
  91. package/dist/index-D4dM_WDY.d.cts +142 -0
  92. package/dist/index-D4dM_WDY.d.cts.map +1 -0
  93. package/dist/index.cjs +3 -6
  94. package/dist/index.d.cts +4 -27
  95. package/dist/index.d.mts +4 -27
  96. package/dist/index.mjs +3 -3
  97. package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
  98. package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
  99. package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
  100. package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
  101. package/dist/monitors/index.cjs +49 -0
  102. package/dist/monitors/index.cjs.map +1 -0
  103. package/dist/monitors/index.d.cts +45 -0
  104. package/dist/monitors/index.d.cts.map +1 -0
  105. package/dist/monitors/index.d.mts +45 -0
  106. package/dist/monitors/index.d.mts.map +1 -0
  107. package/dist/monitors/index.mjs +48 -0
  108. package/dist/monitors/index.mjs.map +1 -0
  109. package/dist/processAudits-BJZT5gmy.cjs +92 -0
  110. package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
  111. package/dist/processAudits-CwyaaSQc.mjs +80 -0
  112. package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
  113. package/dist/publisher-BZgcrVPy.cjs +53 -0
  114. package/dist/publisher-BZgcrVPy.cjs.map +1 -0
  115. package/dist/publisher-CnpeMv-r.mjs +41 -0
  116. package/dist/publisher-CnpeMv-r.mjs.map +1 -0
  117. package/dist/queue/index.cjs +114 -6
  118. package/dist/queue/index.cjs.map +1 -0
  119. package/dist/queue/index.d.cts +45 -3
  120. package/dist/queue/index.d.cts.map +1 -0
  121. package/dist/queue/index.d.mts +44 -3
  122. package/dist/queue/index.d.mts.map +1 -0
  123. package/dist/queue/index.mjs +112 -3
  124. package/dist/queue/index.mjs.map +1 -0
  125. package/dist/subscribers/index.cjs +80 -111
  126. package/dist/subscribers/index.cjs.map +1 -1
  127. package/dist/subscribers/index.d.cts +43 -46
  128. package/dist/subscribers/index.d.cts.map +1 -1
  129. package/dist/subscribers/index.d.mts +42 -46
  130. package/dist/subscribers/index.d.mts.map +1 -1
  131. package/dist/subscribers/index.mjs +78 -108
  132. package/dist/subscribers/index.mjs.map +1 -1
  133. package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
  134. package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
  135. package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
  136. package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
  137. package/dist/topic/index.cjs +91 -3
  138. package/dist/topic/index.cjs.map +1 -0
  139. package/dist/topic/index.d.cts +32 -2
  140. package/dist/topic/index.d.cts.map +1 -0
  141. package/dist/topic/index.d.mts +32 -2
  142. package/dist/topic/index.d.mts.map +1 -0
  143. package/dist/topic/index.mjs +89 -2
  144. package/dist/topic/index.mjs.map +1 -0
  145. package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
  146. package/dist/types-BdAaYDvd.d.cts.map +1 -0
  147. package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
  148. package/dist/types-DNngH0fX.d.mts.map +1 -0
  149. package/dist/types.d.cts +1 -1
  150. package/dist/types.d.mts +1 -1
  151. package/dist/types.mjs +0 -1
  152. package/package.json +55 -223
  153. package/src/Construct.ts +209 -0
  154. package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
  155. package/src/__benchmarks__/endpoint.bench.ts +494 -0
  156. package/src/__benchmarks__/fixtures.ts +241 -0
  157. package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
  158. package/src/__benchmarks__/hono-server.bench.ts +249 -0
  159. package/src/__benchmarks__/response-builder.bench.ts +428 -0
  160. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
  161. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
  162. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
  163. package/src/__tests__/Construct.environment.spec.ts +704 -0
  164. package/src/__tests__/builder-reuse.spec.ts +587 -0
  165. package/src/__tests__/monitor.spec.ts +636 -0
  166. package/src/__tests__/publisher.setting.spec.ts +508 -0
  167. package/src/__tests__/publisher.spec.ts +452 -0
  168. package/src/adaptors/aws.ts +6 -0
  169. package/src/adaptors/hono.ts +1 -0
  170. package/src/adaptors/testing.ts +11 -0
  171. package/src/clone.ts +38 -0
  172. package/src/crons/AWSScheduledFunction.ts +73 -0
  173. package/src/crons/Cron.ts +149 -0
  174. package/src/crons/CronBuilder.ts +261 -0
  175. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
  176. package/src/crons/__tests__/Cron.spec.ts +472 -0
  177. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
  178. package/src/crons/index.ts +12 -0
  179. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
  180. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
  181. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
  182. package/src/endpoints/Authorizer.ts +152 -0
  183. package/src/endpoints/Endpoint.ts +1287 -0
  184. package/src/endpoints/EndpointBuilder.ts +749 -0
  185. package/src/endpoints/EndpointFactory.ts +1179 -0
  186. package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
  187. package/src/endpoints/MswEndpointAdaptor.ts +226 -0
  188. package/src/endpoints/TestEndpointAdaptor.ts +466 -0
  189. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
  190. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
  191. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
  192. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
  193. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
  194. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
  195. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
  196. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
  197. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
  198. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
  199. package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
  200. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
  201. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
  202. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
  203. package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
  204. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
  205. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
  206. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
  207. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
  208. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
  209. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
  210. package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
  211. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
  212. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
  213. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
  214. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
  215. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
  216. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
  217. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
  218. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
  219. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
  220. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
  221. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
  222. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
  223. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
  224. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
  225. package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
  226. package/src/endpoints/__tests__/helpers.spec.ts +37 -0
  227. package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
  228. package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
  229. package/src/endpoints/audit.ts +87 -0
  230. package/src/endpoints/helpers.ts +98 -0
  231. package/src/endpoints/index.ts +42 -0
  232. package/src/endpoints/lazyAccessors.ts +241 -0
  233. package/src/endpoints/parseHonoQuery.ts +16 -0
  234. package/src/endpoints/parseQueryParams.ts +32 -0
  235. package/src/endpoints/processAudits.ts +371 -0
  236. package/src/endpoints/rls.ts +67 -0
  237. package/src/functions/AWSLambdaFunction.ts +374 -0
  238. package/src/functions/BaseFunctionBuilder.ts +212 -0
  239. package/src/functions/Function.ts +238 -0
  240. package/src/functions/FunctionBuilder.ts +381 -0
  241. package/src/functions/FunctionExecutionWrapper.ts +216 -0
  242. package/src/functions/TestFunctionAdaptor.ts +252 -0
  243. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
  244. package/src/functions/__tests__/Function.audits.spec.ts +393 -0
  245. package/src/functions/__tests__/Function.spec.ts +477 -0
  246. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
  247. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
  248. package/src/functions/index.ts +12 -0
  249. package/src/index.ts +29 -0
  250. package/src/monitor.ts +145 -0
  251. package/src/monitors/heartbeat.ts +86 -0
  252. package/src/monitors/index.ts +6 -0
  253. package/src/publisher.ts +93 -0
  254. package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
  255. package/src/queue/Queue.ts +128 -0
  256. package/src/queue/QueueBuilder.ts +115 -0
  257. package/src/queue/TestQueueAdaptor.ts +63 -0
  258. package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
  259. package/src/queue/index.ts +12 -0
  260. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
  261. package/src/subscribers/Subscriber.ts +117 -0
  262. package/src/subscribers/SubscriberBuilder.ts +183 -0
  263. package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
  264. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
  265. package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
  266. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
  267. package/src/subscribers/index.ts +6 -0
  268. package/src/telemetry.ts +103 -0
  269. package/src/topic/Topic.ts +103 -0
  270. package/src/topic/TopicBuilder.ts +53 -0
  271. package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
  272. package/src/topic/index.ts +11 -0
  273. package/src/types.ts +13 -0
  274. package/test.ts +91 -0
  275. package/tsconfig.json +9 -0
  276. package/tsdown.config.ts +35 -0
  277. package/dist/Construct-B1vGBPme.mjs.map +0 -1
  278. package/dist/Construct-BQALFCh2.d.cts +0 -230
  279. package/dist/Construct-BQALFCh2.d.cts.map +0 -1
  280. package/dist/Construct-DUSXuTHP.cjs.map +0 -1
  281. package/dist/Construct-QXnl3VqT.d.mts +0 -230
  282. package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
  283. package/dist/Cron-DI3nKoic.d.cts +0 -45
  284. package/dist/Cron-DI3nKoic.d.cts.map +0 -1
  285. package/dist/Cron-uYAHPnp7.d.mts +0 -45
  286. package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
  287. package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
  288. package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
  289. package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
  290. package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
  291. package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
  292. package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
  293. package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
  294. package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
  295. package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
  296. package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
  297. package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
  298. package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
  299. package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
  300. package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
  301. package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
  302. package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
  303. package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
  304. package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
  305. package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
  306. package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
  307. package/dist/Function-DuqGcbOI.d.mts +0 -76
  308. package/dist/Function-DuqGcbOI.d.mts.map +0 -1
  309. package/dist/Function-Pu-1kKZz.d.cts +0 -76
  310. package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
  311. package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
  312. package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
  313. package/dist/Queue-A3wfD0it.cjs +0 -109
  314. package/dist/Queue-A3wfD0it.cjs.map +0 -1
  315. package/dist/Queue-D6USGS4q.mjs +0 -104
  316. package/dist/Queue-D6USGS4q.mjs.map +0 -1
  317. package/dist/Queue-DlsHRzUp.d.mts +0 -105
  318. package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
  319. package/dist/Queue-HPyi0e1i.d.cts +0 -105
  320. package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
  321. package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
  322. package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
  323. package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
  324. package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
  325. package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
  326. package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
  327. package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
  328. package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
  329. package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
  330. package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
  331. package/dist/Subscriber-CtN9R48-.d.mts +0 -61
  332. package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
  333. package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
  334. package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
  335. package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
  336. package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
  337. package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
  338. package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
  339. package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
  340. package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
  341. package/dist/Topic-D74b5cgs.mjs +0 -99
  342. package/dist/Topic-D74b5cgs.mjs.map +0 -1
  343. package/dist/Topic-GHxcU8AG.cjs +0 -104
  344. package/dist/Topic-GHxcU8AG.cjs.map +0 -1
  345. package/dist/auth-BMCJN30Y.d.cts +0 -268
  346. package/dist/auth-BMCJN30Y.d.cts.map +0 -1
  347. package/dist/auth-CcuceLYo.d.mts +0 -268
  348. package/dist/auth-CcuceLYo.d.mts.map +0 -1
  349. package/dist/auth.cjs +0 -433
  350. package/dist/auth.cjs.map +0 -1
  351. package/dist/auth.d.cts +0 -2
  352. package/dist/auth.d.mts +0 -2
  353. package/dist/auth.mjs +0 -426
  354. package/dist/auth.mjs.map +0 -1
  355. package/dist/cache-CXh6GIgb.d.mts +0 -44
  356. package/dist/cache-CXh6GIgb.d.mts.map +0 -1
  357. package/dist/cache-DnGDGly3.d.cts +0 -44
  358. package/dist/cache-DnGDGly3.d.cts.map +0 -1
  359. package/dist/cache.cjs +0 -69
  360. package/dist/cache.cjs.map +0 -1
  361. package/dist/cache.d.cts +0 -2
  362. package/dist/cache.d.mts +0 -2
  363. package/dist/cache.mjs +0 -68
  364. package/dist/cache.mjs.map +0 -1
  365. package/dist/cipher-C1lEFX63.mjs +0 -225
  366. package/dist/cipher-C1lEFX63.mjs.map +0 -1
  367. package/dist/cipher-CVxfwLjk.cjs +0 -332
  368. package/dist/cipher-CVxfwLjk.cjs.map +0 -1
  369. package/dist/clone-EKNovYHu.mjs.map +0 -1
  370. package/dist/clone-UGJpvQnL.cjs.map +0 -1
  371. package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
  372. package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
  373. package/dist/construct-interface-DluK3_da.d.mts +0 -162
  374. package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
  375. package/dist/construct-interface.cjs +0 -114
  376. package/dist/construct-interface.cjs.map +0 -1
  377. package/dist/construct-interface.d.cts +0 -2
  378. package/dist/construct-interface.d.mts +0 -2
  379. package/dist/construct-interface.mjs +0 -107
  380. package/dist/construct-interface.mjs.map +0 -1
  381. package/dist/credential.cjs +0 -156
  382. package/dist/credential.cjs.map +0 -1
  383. package/dist/credential.d.cts +0 -86
  384. package/dist/credential.d.cts.map +0 -1
  385. package/dist/credential.d.mts +0 -86
  386. package/dist/credential.d.mts.map +0 -1
  387. package/dist/credential.mjs +0 -152
  388. package/dist/credential.mjs.map +0 -1
  389. package/dist/database/kysely.cjs +0 -4
  390. package/dist/database/kysely.d.cts +0 -2
  391. package/dist/database/kysely.d.mts +0 -2
  392. package/dist/database/kysely.mjs +0 -2
  393. package/dist/email.cjs +0 -72
  394. package/dist/email.cjs.map +0 -1
  395. package/dist/email.d.cts +0 -46
  396. package/dist/email.d.cts.map +0 -1
  397. package/dist/email.d.mts +0 -46
  398. package/dist/email.d.mts.map +0 -1
  399. package/dist/email.mjs +0 -71
  400. package/dist/email.mjs.map +0 -1
  401. package/dist/encryption.cjs +0 -96
  402. package/dist/encryption.cjs.map +0 -1
  403. package/dist/encryption.d.cts +0 -117
  404. package/dist/encryption.d.cts.map +0 -1
  405. package/dist/encryption.d.mts +0 -117
  406. package/dist/encryption.d.mts.map +0 -1
  407. package/dist/encryption.mjs +0 -83
  408. package/dist/encryption.mjs.map +0 -1
  409. package/dist/external-api-MJ8id87V.d.mts +0 -105
  410. package/dist/external-api-MJ8id87V.d.mts.map +0 -1
  411. package/dist/external-api-O107yzZJ.d.cts +0 -105
  412. package/dist/external-api-O107yzZJ.d.cts.map +0 -1
  413. package/dist/external-api.cjs +0 -142
  414. package/dist/external-api.cjs.map +0 -1
  415. package/dist/external-api.d.cts +0 -2
  416. package/dist/external-api.d.mts +0 -2
  417. package/dist/external-api.mjs +0 -139
  418. package/dist/external-api.mjs.map +0 -1
  419. package/dist/file-server.cjs +0 -186
  420. package/dist/file-server.cjs.map +0 -1
  421. package/dist/file-server.d.cts +0 -152
  422. package/dist/file-server.d.cts.map +0 -1
  423. package/dist/file-server.d.mts +0 -152
  424. package/dist/file-server.d.mts.map +0 -1
  425. package/dist/file-server.mjs +0 -184
  426. package/dist/file-server.mjs.map +0 -1
  427. package/dist/functions-BFizikJU.mjs.map +0 -1
  428. package/dist/functions-CfzJG9hK.cjs.map +0 -1
  429. package/dist/index-BuzRvKOQ.d.cts +0 -115
  430. package/dist/index-BuzRvKOQ.d.cts.map +0 -1
  431. package/dist/index-CTkKOer4.d.mts +0 -115
  432. package/dist/index-CTkKOer4.d.mts.map +0 -1
  433. package/dist/index-CeEtxDmK.d.cts +0 -79
  434. package/dist/index-CeEtxDmK.d.cts.map +0 -1
  435. package/dist/index-CeEtxDmK.d.mts +0 -79
  436. package/dist/index-CeEtxDmK.d.mts.map +0 -1
  437. package/dist/index.d.cts.map +0 -1
  438. package/dist/index.d.mts.map +0 -1
  439. package/dist/kms-B-Hm3d5r.cjs +0 -85
  440. package/dist/kms-B-Hm3d5r.cjs.map +0 -1
  441. package/dist/kms-BdUlMJEZ.mjs +0 -85
  442. package/dist/kms-BdUlMJEZ.mjs.map +0 -1
  443. package/dist/kysely-Bii4l6eP.mjs +0 -370
  444. package/dist/kysely-Bii4l6eP.mjs.map +0 -1
  445. package/dist/kysely-CO_Dk43W.cjs +0 -383
  446. package/dist/kysely-CO_Dk43W.cjs.map +0 -1
  447. package/dist/kysely-D0bpzgPs.d.cts +0 -175
  448. package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
  449. package/dist/kysely-DUqC3Ie0.d.mts +0 -175
  450. package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
  451. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
  452. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
  453. package/dist/lazyAccessors-CFanua0O.mjs +0 -174
  454. package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
  455. package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
  456. package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
  457. package/dist/mobile-app.cjs +0 -73
  458. package/dist/mobile-app.cjs.map +0 -1
  459. package/dist/mobile-app.d.cts +0 -61
  460. package/dist/mobile-app.d.cts.map +0 -1
  461. package/dist/mobile-app.d.mts +0 -61
  462. package/dist/mobile-app.d.mts.map +0 -1
  463. package/dist/mobile-app.mjs +0 -72
  464. package/dist/mobile-app.mjs.map +0 -1
  465. package/dist/object-storage.cjs +0 -56
  466. package/dist/object-storage.cjs.map +0 -1
  467. package/dist/object-storage.d.cts +0 -32
  468. package/dist/object-storage.d.cts.map +0 -1
  469. package/dist/object-storage.d.mts +0 -32
  470. package/dist/object-storage.d.mts.map +0 -1
  471. package/dist/object-storage.mjs +0 -55
  472. package/dist/object-storage.mjs.map +0 -1
  473. package/dist/processAudits-BRRVVHUB.mjs +0 -131
  474. package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
  475. package/dist/processAudits-DasOZjPl.cjs +0 -154
  476. package/dist/processAudits-DasOZjPl.cjs.map +0 -1
  477. package/dist/rest-api.cjs +0 -216
  478. package/dist/rest-api.cjs.map +0 -1
  479. package/dist/rest-api.d.cts +0 -241
  480. package/dist/rest-api.d.cts.map +0 -1
  481. package/dist/rest-api.d.mts +0 -241
  482. package/dist/rest-api.d.mts.map +0 -1
  483. package/dist/rest-api.mjs +0 -215
  484. package/dist/rest-api.mjs.map +0 -1
  485. package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
  486. package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
  487. package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
  488. package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
  489. package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
  490. package/dist/shutdown-BMJmAhSt.cjs +0 -38
  491. package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
  492. package/dist/shutdown-C7xa8x9S.mjs +0 -27
  493. package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
  494. package/dist/site.cjs +0 -74
  495. package/dist/site.cjs.map +0 -1
  496. package/dist/site.d.cts +0 -104
  497. package/dist/site.d.cts.map +0 -1
  498. package/dist/site.d.mts +0 -104
  499. package/dist/site.d.mts.map +0 -1
  500. package/dist/site.mjs +0 -73
  501. package/dist/site.mjs.map +0 -1
  502. package/dist/stages-BSCF19o2.d.cts +0 -56
  503. package/dist/stages-BSCF19o2.d.cts.map +0 -1
  504. package/dist/stages-BSCF19o2.d.mts +0 -56
  505. package/dist/stages-BSCF19o2.d.mts.map +0 -1
  506. package/dist/surfaceEnv-CNimK76p.cjs +0 -56
  507. package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
  508. package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
  509. package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
  510. package/dist/telemetry-B48RLjyk.d.cts +0 -40
  511. package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
  512. package/dist/telemetry-DRtT1_0A.d.mts +0 -40
  513. package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
  514. package/dist/telemetry.cjs +0 -56
  515. package/dist/telemetry.cjs.map +0 -1
  516. package/dist/telemetry.d.cts +0 -2
  517. package/dist/telemetry.d.mts +0 -2
  518. package/dist/telemetry.mjs +0 -55
  519. package/dist/telemetry.mjs.map +0 -1
  520. package/dist/tracing-CxaZ98IB.mjs +0 -110
  521. package/dist/tracing-CxaZ98IB.mjs.map +0 -1
  522. package/dist/tracing-DPMidF_r.cjs +0 -127
  523. package/dist/tracing-DPMidF_r.cjs.map +0 -1
  524. package/dist/types-DMuSQeLL.d.cts.map +0 -1
  525. package/dist/types-DMuSQeLL.d.mts.map +0 -1
  526. package/dist/worker.cjs +0 -191
  527. package/dist/worker.cjs.map +0 -1
  528. package/dist/worker.d.cts +0 -171
  529. package/dist/worker.d.cts.map +0 -1
  530. package/dist/worker.d.mts +0 -171
  531. package/dist/worker.d.mts.map +0 -1
  532. package/dist/worker.mjs +0 -190
  533. package/dist/worker.mjs.map +0 -1
@@ -0,0 +1,451 @@
1
+ import type {
2
+ AuditableAction,
3
+ AuditRecord,
4
+ AuditStorage,
5
+ } from '@geekmidas/audit';
6
+ import type { Service } from '@geekmidas/services';
7
+ import { describe, expect, it } from 'vitest';
8
+ import { z } from 'zod';
9
+ import type { ActorExtractor, MappedAudit } from '../audit';
10
+ import { EndpointBuilder } from '../EndpointBuilder';
11
+
12
+ // In-memory audit storage for testing
13
+ class InMemoryAuditStorage implements AuditStorage {
14
+ records: AuditRecord[] = [];
15
+
16
+ async write(records: AuditRecord[]): Promise<void> {
17
+ this.records.push(...records);
18
+ }
19
+
20
+ async query(): Promise<AuditRecord[]> {
21
+ return this.records;
22
+ }
23
+ }
24
+
25
+ const auditStorageService = {
26
+ serviceName: 'auditStorage' as const,
27
+ async register() {
28
+ return new InMemoryAuditStorage();
29
+ },
30
+ } satisfies Service<'auditStorage', InMemoryAuditStorage>;
31
+
32
+ // Define test audit actions
33
+ type TestAuditAction =
34
+ | AuditableAction<'user.created', { userId: string; email: string }>
35
+ | AuditableAction<'user.updated', { userId: string; changes: string[] }>
36
+ | AuditableAction<'user.deleted', { userId: string }>;
37
+
38
+ describe('EndpointBuilder audit methods', () => {
39
+ describe('auditor', () => {
40
+ it('should set auditor storage service', () => {
41
+ const builder = new EndpointBuilder('/users', 'POST').auditor(
42
+ auditStorageService,
43
+ );
44
+
45
+ expect((builder as any)._auditorStorage).toBe(auditStorageService);
46
+ });
47
+
48
+ it('should return builder for chaining', () => {
49
+ const builder = new EndpointBuilder('/users', 'POST');
50
+ const result = builder.auditor(auditStorageService);
51
+
52
+ expect(result).toBeInstanceOf(EndpointBuilder);
53
+ expect(result).not.toBe(builder);
54
+ });
55
+
56
+ it('should pass auditor storage service to endpoint', () => {
57
+ const endpoint = new EndpointBuilder('/users', 'POST')
58
+ .auditor(auditStorageService)
59
+ .handle(async () => ({ id: '123' }));
60
+
61
+ expect(endpoint.auditorStorageService).toBe(auditStorageService);
62
+ });
63
+
64
+ it('should allow chaining with other methods', () => {
65
+ const bodySchema = z.object({ name: z.string() });
66
+ const outputSchema = z.object({ id: z.string() });
67
+
68
+ const endpoint = new EndpointBuilder('/users', 'POST')
69
+ .body(bodySchema)
70
+ .output(outputSchema)
71
+ .auditor(auditStorageService)
72
+ .status(201)
73
+ .handle(async () => ({ id: '123' }));
74
+
75
+ expect(endpoint.auditorStorageService).toBe(auditStorageService);
76
+ expect(endpoint.input?.body).toBe(bodySchema);
77
+ expect(endpoint.outputSchema).toBe(outputSchema);
78
+ expect(endpoint.status).toBe(201);
79
+ });
80
+ });
81
+
82
+ describe('actor', () => {
83
+ it('should set actor extractor function', () => {
84
+ const actorExtractor: ActorExtractor = ({ session }) => ({
85
+ id: (session as any)?.userId ?? 'anonymous',
86
+ type: 'user',
87
+ });
88
+
89
+ const builder = new EndpointBuilder('/users', 'POST').actor(
90
+ actorExtractor,
91
+ );
92
+
93
+ expect((builder as any)._actorExtractor).toBe(actorExtractor);
94
+ });
95
+
96
+ it('should return builder for chaining', () => {
97
+ const builder = new EndpointBuilder('/users', 'POST');
98
+ const result = builder.actor(() => ({ id: '123', type: 'user' }));
99
+
100
+ expect(result).toBeInstanceOf(EndpointBuilder);
101
+ expect(result).not.toBe(builder);
102
+ });
103
+
104
+ it('should pass actor extractor to endpoint', () => {
105
+ const actorExtractor: ActorExtractor = ({ header }) => ({
106
+ id: header('x-user-id') ?? 'anonymous',
107
+ type: 'user',
108
+ ip: header('x-forwarded-for'),
109
+ });
110
+
111
+ const endpoint = new EndpointBuilder('/users', 'POST')
112
+ .auditor(auditStorageService)
113
+ .actor(actorExtractor)
114
+ .handle(async () => ({ id: '123' }));
115
+
116
+ expect(endpoint.actorExtractor).toBe(actorExtractor);
117
+ });
118
+
119
+ it('should work with async actor extractor', () => {
120
+ const asyncActorExtractor: ActorExtractor = async ({ services }) => {
121
+ // Simulate async lookup
122
+ await Promise.resolve();
123
+ return { id: 'async-user', type: 'user' };
124
+ };
125
+
126
+ const endpoint = new EndpointBuilder('/users', 'POST')
127
+ .auditor(auditStorageService)
128
+ .actor(asyncActorExtractor)
129
+ .handle(async () => ({ id: '123' }));
130
+
131
+ expect(endpoint.actorExtractor).toBe(asyncActorExtractor);
132
+ });
133
+
134
+ it('should allow chaining auditor and actor in any order', () => {
135
+ const actorExtractor: ActorExtractor = () => ({
136
+ id: '123',
137
+ type: 'user',
138
+ });
139
+
140
+ // auditor then actor
141
+ const endpoint1 = new EndpointBuilder('/users', 'POST')
142
+ .auditor(auditStorageService)
143
+ .actor(actorExtractor)
144
+ .handle(async () => ({ id: '123' }));
145
+
146
+ // actor then auditor
147
+ const endpoint2 = new EndpointBuilder('/users', 'POST')
148
+ .actor(actorExtractor)
149
+ .auditor(auditStorageService)
150
+ .handle(async () => ({ id: '123' }));
151
+
152
+ expect(endpoint1.auditorStorageService).toBe(auditStorageService);
153
+ expect(endpoint1.actorExtractor).toBe(actorExtractor);
154
+ expect(endpoint2.auditorStorageService).toBe(auditStorageService);
155
+ expect(endpoint2.actorExtractor).toBe(actorExtractor);
156
+ });
157
+ });
158
+
159
+ describe('audit', () => {
160
+ it('should set declarative audit definitions', () => {
161
+ const outputSchema = z.object({
162
+ id: z.string(),
163
+ email: z.string(),
164
+ active: z.boolean(),
165
+ });
166
+
167
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
168
+ {
169
+ type: 'user.created',
170
+ payload: (response) => ({
171
+ userId: response.id,
172
+ email: response.email,
173
+ }),
174
+ },
175
+ ];
176
+
177
+ const builder = new EndpointBuilder('/users', 'POST')
178
+ .output(outputSchema)
179
+ .audit<TestAuditAction>(audits);
180
+
181
+ expect((builder as any)._audits).toBe(audits);
182
+ });
183
+
184
+ it('should return builder for chaining', () => {
185
+ const builder = new EndpointBuilder('/users', 'POST');
186
+ const result = builder.audit([]);
187
+
188
+ expect(result).toBeInstanceOf(EndpointBuilder);
189
+ expect(result).not.toBe(builder);
190
+ });
191
+
192
+ it('should pass audit definitions to endpoint', () => {
193
+ const outputSchema = z.object({
194
+ id: z.string(),
195
+ email: z.string(),
196
+ active: z.boolean(),
197
+ });
198
+
199
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
200
+ {
201
+ type: 'user.created',
202
+ payload: (response) => ({
203
+ userId: response.id,
204
+ email: response.email,
205
+ }),
206
+ when: (response) => response.active,
207
+ entityId: (response) => response.id,
208
+ table: 'users',
209
+ },
210
+ ];
211
+
212
+ const endpoint = new EndpointBuilder('/users', 'POST')
213
+ .output(outputSchema)
214
+ .auditor(auditStorageService)
215
+ .audit<TestAuditAction>(audits)
216
+ .handle(async () => ({
217
+ id: '123',
218
+ email: 'test@test.com',
219
+ active: true,
220
+ }));
221
+
222
+ expect(endpoint.audits).toBe(audits);
223
+ });
224
+
225
+ it('should support multiple audit definitions', () => {
226
+ const outputSchema = z.object({
227
+ id: z.string(),
228
+ email: z.string(),
229
+ changes: z.array(z.string()),
230
+ });
231
+
232
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
233
+ {
234
+ type: 'user.created',
235
+ payload: (response) => ({
236
+ userId: response.id,
237
+ email: response.email,
238
+ }),
239
+ },
240
+ {
241
+ type: 'user.updated',
242
+ payload: (response) => ({
243
+ userId: response.id,
244
+ changes: response.changes,
245
+ }),
246
+ when: (response) => response.changes.length > 0,
247
+ },
248
+ ];
249
+
250
+ const endpoint = new EndpointBuilder('/users', 'POST')
251
+ .output(outputSchema)
252
+ .auditor(auditStorageService)
253
+ .audit<TestAuditAction>(audits)
254
+ .handle(async () => ({
255
+ id: '123',
256
+ email: 'test@test.com',
257
+ changes: ['name'],
258
+ }));
259
+
260
+ expect(endpoint.audits).toHaveLength(2);
261
+ expect(endpoint.audits[0].type).toBe('user.created');
262
+ expect(endpoint.audits[1].type).toBe('user.updated');
263
+ });
264
+
265
+ it('should support conditional audits with when function', () => {
266
+ const outputSchema = z.object({
267
+ id: z.string(),
268
+ email: z.string(),
269
+ active: z.boolean(),
270
+ });
271
+
272
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
273
+ {
274
+ type: 'user.created',
275
+ payload: (response) => ({
276
+ userId: response.id,
277
+ email: response.email,
278
+ }),
279
+ when: (response) => response.active,
280
+ },
281
+ ];
282
+
283
+ const endpoint = new EndpointBuilder('/users', 'POST')
284
+ .output(outputSchema)
285
+ .audit<TestAuditAction>(audits)
286
+ .handle(async () => ({
287
+ id: '123',
288
+ email: 'test@test.com',
289
+ active: true,
290
+ }));
291
+
292
+ // Verify the when function works
293
+ const whenFn = endpoint.audits[0].when!;
294
+ expect(whenFn({ id: '1', email: 'a@b.com', active: true })).toBe(true);
295
+ expect(whenFn({ id: '1', email: 'a@b.com', active: false })).toBe(false);
296
+ });
297
+
298
+ it('should support entityId extraction', () => {
299
+ const outputSchema = z.object({
300
+ id: z.string(),
301
+ email: z.string(),
302
+ });
303
+
304
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
305
+ {
306
+ type: 'user.created',
307
+ payload: (response) => ({
308
+ userId: response.id,
309
+ email: response.email,
310
+ }),
311
+ entityId: (response) => response.id,
312
+ },
313
+ ];
314
+
315
+ const endpoint = new EndpointBuilder('/users', 'POST')
316
+ .output(outputSchema)
317
+ .audit<TestAuditAction>(audits)
318
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
319
+
320
+ const entityIdFn = endpoint.audits[0].entityId!;
321
+ expect(entityIdFn({ id: 'user-456', email: 'a@b.com' })).toBe('user-456');
322
+ });
323
+
324
+ it('should support composite entityId', () => {
325
+ const outputSchema = z.object({
326
+ id: z.string(),
327
+ orgId: z.string(),
328
+ email: z.string(),
329
+ });
330
+
331
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
332
+ {
333
+ type: 'user.created',
334
+ payload: (response) => ({
335
+ userId: response.id,
336
+ email: response.email,
337
+ }),
338
+ entityId: (response) => ({
339
+ userId: response.id,
340
+ orgId: response.orgId,
341
+ }),
342
+ },
343
+ ];
344
+
345
+ const endpoint = new EndpointBuilder('/users', 'POST')
346
+ .output(outputSchema)
347
+ .audit<TestAuditAction>(audits)
348
+ .handle(async () => ({
349
+ id: '123',
350
+ orgId: 'org-1',
351
+ email: 'test@test.com',
352
+ }));
353
+
354
+ const entityIdFn = endpoint.audits[0].entityId!;
355
+ expect(entityIdFn({ id: 'u-1', orgId: 'o-1', email: 'a@b.com' })).toEqual(
356
+ {
357
+ userId: 'u-1',
358
+ orgId: 'o-1',
359
+ },
360
+ );
361
+ });
362
+ });
363
+
364
+ describe('full audit chain', () => {
365
+ it('should support complete audit configuration', () => {
366
+ const outputSchema = z.object({
367
+ id: z.string(),
368
+ email: z.string(),
369
+ active: z.boolean(),
370
+ });
371
+
372
+ const actorExtractor: ActorExtractor = ({ session, header }) => ({
373
+ id: (session as any)?.userId ?? 'anonymous',
374
+ type: 'user',
375
+ ip: header('x-forwarded-for'),
376
+ });
377
+
378
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
379
+ {
380
+ type: 'user.created',
381
+ payload: (response) => ({
382
+ userId: response.id,
383
+ email: response.email,
384
+ }),
385
+ when: (response) => response.active,
386
+ entityId: (response) => response.id,
387
+ table: 'users',
388
+ },
389
+ ];
390
+
391
+ const endpoint = new EndpointBuilder('/users', 'POST')
392
+ .output(outputSchema)
393
+ .auditor(auditStorageService)
394
+ .actor(actorExtractor)
395
+ .audit<TestAuditAction>(audits)
396
+ .handle(async () => ({
397
+ id: '123',
398
+ email: 'test@test.com',
399
+ active: true,
400
+ }));
401
+
402
+ expect(endpoint.auditorStorageService).toBe(auditStorageService);
403
+ expect(endpoint.actorExtractor).toBe(actorExtractor);
404
+ expect(endpoint.audits).toBe(audits);
405
+ expect(endpoint.audits[0].table).toBe('users');
406
+ });
407
+
408
+ it('should work without actor extractor', () => {
409
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
410
+
411
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
412
+ {
413
+ type: 'user.created',
414
+ payload: (response) => ({
415
+ userId: response.id,
416
+ email: response.email,
417
+ }),
418
+ },
419
+ ];
420
+
421
+ const endpoint = new EndpointBuilder('/users', 'POST')
422
+ .output(outputSchema)
423
+ .auditor(auditStorageService)
424
+ .audit<TestAuditAction>(audits)
425
+ .handle(async () => ({ id: '123', email: 'test@test.com' }));
426
+
427
+ expect(endpoint.auditorStorageService).toBe(auditStorageService);
428
+ expect(endpoint.actorExtractor).toBeUndefined();
429
+ expect(endpoint.audits).toBe(audits);
430
+ });
431
+
432
+ it('should work without audit definitions (imperative auditing only)', () => {
433
+ const endpoint = new EndpointBuilder('/users', 'POST')
434
+ .auditor(auditStorageService)
435
+ .actor(() => ({ id: '123', type: 'user' }))
436
+ .handle(async () => ({ id: '123' }));
437
+
438
+ expect(endpoint.auditorStorageService).toBe(auditStorageService);
439
+ expect(endpoint.actorExtractor).toBeDefined();
440
+ expect(endpoint.audits).toEqual([]);
441
+ });
442
+
443
+ it('should default to empty audits array', () => {
444
+ const endpoint = new EndpointBuilder('/users', 'GET').handle(
445
+ async () => ({}),
446
+ );
447
+
448
+ expect(endpoint.audits).toEqual([]);
449
+ });
450
+ });
451
+ });
@@ -0,0 +1,50 @@
1
+ import { describe, expect, it } from 'vitest';
2
+ import { z } from 'zod';
3
+ import { EndpointBuilder } from '../EndpointBuilder';
4
+
5
+ describe('EndpointBuilder.responseType', () => {
6
+ it("defaults to 'application/json' when not set", () => {
7
+ const endpoint = new EndpointBuilder('/users', 'GET')
8
+ .output(z.object({ id: z.string() }))
9
+ .handle(async () => ({ id: '1' }));
10
+
11
+ expect(endpoint.responseType).toBe('application/json');
12
+ });
13
+
14
+ it('stores a custom response type on the built Endpoint', () => {
15
+ const endpoint = new EndpointBuilder('/checkout-page', 'GET')
16
+ .output(z.string())
17
+ .responseType('text/html')
18
+ .handle(async () => '<html></html>');
19
+
20
+ expect(endpoint.responseType).toBe('text/html');
21
+ });
22
+
23
+ it('returns the builder for chaining', () => {
24
+ const builder = new EndpointBuilder('/users', 'GET');
25
+ const result = builder.responseType('text/plain');
26
+
27
+ // A new builder rather than the same one: a configured base has to stay
28
+ // reusable, so a chain step cannot write back into what it came from.
29
+ expect(result).toBeInstanceOf(EndpointBuilder);
30
+ expect(result).not.toBe(builder);
31
+ });
32
+
33
+ it('supports any arbitrary MIME type', () => {
34
+ const endpoint = new EndpointBuilder('/export.csv', 'GET')
35
+ .output(z.string())
36
+ .responseType('text/csv')
37
+ .handle(async () => 'a,b,c\n1,2,3');
38
+
39
+ expect(endpoint.responseType).toBe('text/csv');
40
+ });
41
+
42
+ it('last call wins when chained multiple times', () => {
43
+ const endpoint = new EndpointBuilder('/pdf', 'GET')
44
+ .responseType('text/html')
45
+ .responseType('application/pdf')
46
+ .handle(async () => 'pdf-bytes');
47
+
48
+ expect(endpoint.responseType).toBe('application/pdf');
49
+ });
50
+ });