@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,602 @@
1
+ import type {
2
+ AuditableAction,
3
+ AuditRecord,
4
+ AuditStorage,
5
+ } from '@geekmidas/audit';
6
+ import type { Logger } from '@geekmidas/logger';
7
+ import type { Service } from '@geekmidas/services';
8
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
9
+ import { z } from 'zod';
10
+ import type { MappedAudit } from '../audit';
11
+ import { e } from '../EndpointFactory';
12
+ import { TestEndpointAdaptor } from '../TestEndpointAdaptor';
13
+
14
+ // Test audit action types
15
+ type TestAuditAction =
16
+ | AuditableAction<'user.created', { userId: string; email: string }>
17
+ | AuditableAction<'user.updated', { userId: string; changes: string[] }>;
18
+
19
+ // In-memory audit storage for testing - implements AuditStorage<TestAuditAction>
20
+ class InMemoryAuditStorage implements AuditStorage<TestAuditAction> {
21
+ // Type marker for ExtractStorageAuditAction to work
22
+ declare readonly __auditActionType?: TestAuditAction;
23
+
24
+ records: AuditRecord[] = [];
25
+
26
+ async write(records: AuditRecord[]): Promise<void> {
27
+ this.records.push(...records);
28
+ }
29
+
30
+ async query(): Promise<AuditRecord[]> {
31
+ return this.records;
32
+ }
33
+
34
+ clear(): void {
35
+ this.records = [];
36
+ }
37
+ }
38
+
39
+ // Mock database for testing
40
+ interface MockDatabase {
41
+ query: (sql: string) => Promise<any[]>;
42
+ }
43
+
44
+ const createMockDatabase = (): MockDatabase => ({
45
+ query: vi.fn().mockResolvedValue([]),
46
+ });
47
+
48
+ // Mock logger
49
+ const createMockLogger = (): Logger => {
50
+ const logger: Logger = {
51
+ debug: vi.fn(),
52
+ info: vi.fn(),
53
+ warn: vi.fn(),
54
+ error: vi.fn(),
55
+ fatal: vi.fn(),
56
+ trace: vi.fn(),
57
+ child: vi.fn(() => logger),
58
+ };
59
+ return logger;
60
+ };
61
+
62
+ describe('TestEndpointAdaptor with auditorStorage and database', () => {
63
+ let mockLogger: Logger;
64
+
65
+ beforeEach(() => {
66
+ vi.clearAllMocks();
67
+ mockLogger = createMockLogger();
68
+ });
69
+
70
+ describe('auditorStorage', () => {
71
+ it('should process declarative audits when auditorStorage is provided', async () => {
72
+ const auditStorage = new InMemoryAuditStorage();
73
+
74
+ const auditStorageService: Service<'auditStorage', InMemoryAuditStorage> =
75
+ {
76
+ serviceName: 'auditStorage' as const,
77
+ register: vi.fn().mockResolvedValue(auditStorage),
78
+ };
79
+
80
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
81
+
82
+ type OutputType = z.infer<typeof outputSchema>;
83
+
84
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
85
+ {
86
+ type: 'user.created',
87
+ payload: (response: OutputType) => ({
88
+ userId: response.id,
89
+ email: response.email,
90
+ }),
91
+ },
92
+ ];
93
+
94
+ const endpoint = e
95
+ .post('/users')
96
+ .logger(mockLogger)
97
+ .auditor(auditStorageService)
98
+ .output(outputSchema)
99
+ .audit(audits)
100
+ .handle(async () => ({ id: '123', email: 'test@example.com' }));
101
+
102
+ const adapter = new TestEndpointAdaptor(endpoint);
103
+
104
+ const result = await adapter.request({
105
+ services: {},
106
+ headers: { host: 'example.com' },
107
+ auditorStorage: auditStorage,
108
+ });
109
+
110
+ expect(result).toEqual({ id: '123', email: 'test@example.com' });
111
+
112
+ // Verify audit was written
113
+ expect(auditStorage.records).toHaveLength(1);
114
+ expect(auditStorage.records[0].type).toBe('user.created');
115
+ expect(auditStorage.records[0].payload).toEqual({
116
+ userId: '123',
117
+ email: 'test@example.com',
118
+ });
119
+ });
120
+
121
+ it('should allow manual auditing via auditor in handler context', async () => {
122
+ const auditStorage = new InMemoryAuditStorage();
123
+
124
+ const auditStorageService: Service<'auditStorage', InMemoryAuditStorage> =
125
+ {
126
+ serviceName: 'auditStorage' as const,
127
+ register: vi.fn().mockResolvedValue(auditStorage),
128
+ };
129
+
130
+ const endpoint = e
131
+ .post('/users')
132
+ .logger(mockLogger)
133
+ .auditor(auditStorageService)
134
+ .output(z.object({ id: z.string(), email: z.string() }))
135
+ .handle(async ({ auditor }) => {
136
+ // Manual audit in handler
137
+ auditor.audit('user.created', {
138
+ userId: 'manual-123',
139
+ email: 'manual@example.com',
140
+ });
141
+
142
+ return { id: 'manual-123', email: 'manual@example.com' };
143
+ });
144
+
145
+ const adapter = new TestEndpointAdaptor(endpoint);
146
+
147
+ const result = await adapter.request({
148
+ services: {},
149
+ headers: { host: 'example.com' },
150
+ auditorStorage: auditStorage,
151
+ });
152
+
153
+ expect(result).toEqual({ id: 'manual-123', email: 'manual@example.com' });
154
+
155
+ // Verify manual audit was written
156
+ expect(auditStorage.records).toHaveLength(1);
157
+ expect(auditStorage.records[0].type).toBe('user.created');
158
+ expect(auditStorage.records[0].payload).toEqual({
159
+ userId: 'manual-123',
160
+ email: 'manual@example.com',
161
+ });
162
+ });
163
+
164
+ it('should extract actor from session when actorExtractor is configured', async () => {
165
+ const auditStorage = new InMemoryAuditStorage();
166
+
167
+ const auditStorageService: Service<'auditStorage', InMemoryAuditStorage> =
168
+ {
169
+ serviceName: 'auditStorage' as const,
170
+ register: vi.fn().mockResolvedValue(auditStorage),
171
+ };
172
+
173
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
174
+
175
+ type OutputType = z.infer<typeof outputSchema>;
176
+
177
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
178
+ {
179
+ type: 'user.created',
180
+ payload: (response: OutputType) => ({
181
+ userId: response.id,
182
+ email: response.email,
183
+ }),
184
+ },
185
+ ];
186
+
187
+ const endpoint = e
188
+ .post('/users')
189
+ .logger(mockLogger)
190
+ .auditor(auditStorageService)
191
+ .actor(({ header }) => ({
192
+ id: header('x-user-id') ?? 'anonymous',
193
+ type: 'user',
194
+ }))
195
+ .output(outputSchema)
196
+ .audit(audits)
197
+ .handle(async () => ({ id: '123', email: 'test@example.com' }));
198
+
199
+ const adapter = new TestEndpointAdaptor(endpoint);
200
+
201
+ const result = await adapter.request({
202
+ services: {},
203
+ headers: { host: 'example.com', 'x-user-id': 'actor-456' },
204
+ auditorStorage: auditStorage,
205
+ });
206
+
207
+ expect(result).toEqual({ id: '123', email: 'test@example.com' });
208
+
209
+ // Verify actor was extracted
210
+ expect(auditStorage.records).toHaveLength(1);
211
+ expect(auditStorage.records[0].actor).toEqual({
212
+ id: 'actor-456',
213
+ type: 'user',
214
+ });
215
+ });
216
+
217
+ it('should warn when declarative audits are configured but no auditorStorage provided', async () => {
218
+ const outputSchema = z.object({ id: z.string(), email: z.string() });
219
+
220
+ type OutputType = z.infer<typeof outputSchema>;
221
+
222
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
223
+ {
224
+ type: 'user.created',
225
+ payload: (response: OutputType) => ({
226
+ userId: response.id,
227
+ email: response.email,
228
+ }),
229
+ },
230
+ ];
231
+
232
+ // Create endpoint without auditor to test the warning
233
+ const endpoint = e
234
+ .post('/users')
235
+ .logger(mockLogger)
236
+ .output(outputSchema)
237
+ .handle(async () => ({ id: '123', email: 'test@example.com' }));
238
+
239
+ // Manually set audits to simulate a configuration error
240
+ (endpoint as any).audits = audits;
241
+
242
+ const adapter = new TestEndpointAdaptor(endpoint);
243
+
244
+ // Call without auditorStorage - this won't be type-enforced without .auditor()
245
+ const result = await adapter.request({
246
+ services: {},
247
+ headers: { host: 'example.com' },
248
+ });
249
+
250
+ expect(result).toEqual({ id: '123', email: 'test@example.com' });
251
+
252
+ // Should warn about missing audit storage
253
+ expect(mockLogger.warn).toHaveBeenCalledWith(
254
+ 'No auditor storage service available',
255
+ );
256
+ });
257
+ });
258
+
259
+ describe('database', () => {
260
+ it('should provide database instance to handler context', async () => {
261
+ const mockDb = createMockDatabase();
262
+ (mockDb.query as any).mockResolvedValue([{ id: '1', name: 'Test User' }]);
263
+
264
+ const databaseService: Service<'database', MockDatabase> = {
265
+ serviceName: 'database' as const,
266
+ register: vi.fn().mockResolvedValue(mockDb),
267
+ };
268
+
269
+ const endpoint = e
270
+ .get('/users')
271
+ .logger(mockLogger)
272
+ .database(databaseService)
273
+ .output(z.object({ users: z.array(z.any()) }))
274
+ .handle(async ({ db }) => {
275
+ const users = await db.query('SELECT * FROM users');
276
+ return { users };
277
+ });
278
+
279
+ const adapter = new TestEndpointAdaptor(endpoint);
280
+
281
+ const result = await adapter.request({
282
+ services: {},
283
+ headers: { host: 'example.com' },
284
+ database: mockDb,
285
+ });
286
+
287
+ expect(result).toEqual({ users: [{ id: '1', name: 'Test User' }] });
288
+ expect(mockDb.query).toHaveBeenCalledWith('SELECT * FROM users');
289
+ });
290
+
291
+ it('should allow using test doubles for database', async () => {
292
+ // Create a test double that returns specific test data
293
+ const testDb: MockDatabase = {
294
+ query: vi.fn().mockImplementation((sql: string) => {
295
+ if (sql.includes('users')) {
296
+ return Promise.resolve([
297
+ { id: 'test-1', name: 'Test User 1' },
298
+ { id: 'test-2', name: 'Test User 2' },
299
+ ]);
300
+ }
301
+ return Promise.resolve([]);
302
+ }),
303
+ };
304
+
305
+ const databaseService: Service<'database', MockDatabase> = {
306
+ serviceName: 'database' as const,
307
+ register: vi.fn().mockResolvedValue(testDb),
308
+ };
309
+
310
+ const endpoint = e
311
+ .get('/users')
312
+ .logger(mockLogger)
313
+ .database(databaseService)
314
+ .output(z.object({ count: z.number(), users: z.array(z.any()) }))
315
+ .handle(async ({ db }) => {
316
+ const users = await db.query('SELECT * FROM users');
317
+ return { count: users.length, users };
318
+ });
319
+
320
+ const adapter = new TestEndpointAdaptor(endpoint);
321
+
322
+ const result = await adapter.request({
323
+ services: {},
324
+ headers: { host: 'example.com' },
325
+ database: testDb,
326
+ });
327
+
328
+ expect(result).toEqual({
329
+ count: 2,
330
+ users: [
331
+ { id: 'test-1', name: 'Test User 1' },
332
+ { id: 'test-2', name: 'Test User 2' },
333
+ ],
334
+ });
335
+ });
336
+ });
337
+
338
+ describe('auditorStorage and database together', () => {
339
+ it('should support both auditorStorage and database in the same request', async () => {
340
+ const auditStorage = new InMemoryAuditStorage();
341
+ const mockDb = createMockDatabase();
342
+ (mockDb.query as any).mockResolvedValue([
343
+ { id: 'db-user-1', email: 'dbuser@example.com' },
344
+ ]);
345
+
346
+ const auditStorageService: Service<'auditStorage', InMemoryAuditStorage> =
347
+ {
348
+ serviceName: 'auditStorage' as const,
349
+ register: vi.fn().mockResolvedValue(auditStorage),
350
+ };
351
+
352
+ const databaseService: Service<'database', MockDatabase> = {
353
+ serviceName: 'database' as const,
354
+ register: vi.fn().mockResolvedValue(mockDb),
355
+ };
356
+
357
+ const outputSchema = z.object({
358
+ id: z.string(),
359
+ email: z.string(),
360
+ source: z.string(),
361
+ });
362
+
363
+ type OutputType = z.infer<typeof outputSchema>;
364
+
365
+ const audits: MappedAudit<TestAuditAction, typeof outputSchema>[] = [
366
+ {
367
+ type: 'user.created',
368
+ payload: (response: OutputType) => ({
369
+ userId: response.id,
370
+ email: response.email,
371
+ }),
372
+ },
373
+ ];
374
+
375
+ const endpoint = e
376
+ .post('/users')
377
+ .logger(mockLogger)
378
+ .database(databaseService)
379
+ .auditor(auditStorageService)
380
+ .output(outputSchema)
381
+ .audit(audits)
382
+ .handle(async ({ db, auditor }) => {
383
+ // Use database
384
+ const users = await db.query('SELECT * FROM users LIMIT 1');
385
+ const user = users[0];
386
+
387
+ // Manual audit
388
+ auditor.audit('user.updated', {
389
+ userId: user.id,
390
+ changes: ['accessed'],
391
+ });
392
+
393
+ return { id: user.id, email: user.email, source: 'database' };
394
+ });
395
+
396
+ const adapter = new TestEndpointAdaptor(endpoint);
397
+
398
+ const result = await adapter.request({
399
+ services: {},
400
+ headers: { host: 'example.com' },
401
+ database: mockDb,
402
+ auditorStorage: auditStorage,
403
+ });
404
+
405
+ expect(result).toEqual({
406
+ id: 'db-user-1',
407
+ email: 'dbuser@example.com',
408
+ source: 'database',
409
+ });
410
+
411
+ // Verify database was queried
412
+ expect(mockDb.query).toHaveBeenCalledWith('SELECT * FROM users LIMIT 1');
413
+
414
+ // Verify both audits were written (manual + declarative)
415
+ expect(auditStorage.records).toHaveLength(2);
416
+ expect(auditStorage.records[0].type).toBe('user.updated');
417
+ expect(auditStorage.records[0].payload).toEqual({
418
+ userId: 'db-user-1',
419
+ changes: ['accessed'],
420
+ });
421
+ expect(auditStorage.records[1].type).toBe('user.created');
422
+ expect(auditStorage.records[1].payload).toEqual({
423
+ userId: 'db-user-1',
424
+ email: 'dbuser@example.com',
425
+ });
426
+ });
427
+
428
+ it('should work with EndpointFactory configured with default auditor and database', async () => {
429
+ const auditStorage = new InMemoryAuditStorage();
430
+ const mockDb = createMockDatabase();
431
+ (mockDb.query as any).mockResolvedValue([]);
432
+
433
+ const auditStorageService: Service<'auditStorage', InMemoryAuditStorage> =
434
+ {
435
+ serviceName: 'auditStorage' as const,
436
+ register: vi.fn().mockResolvedValue(auditStorage),
437
+ };
438
+
439
+ const databaseService: Service<'database', MockDatabase> = {
440
+ serviceName: 'database' as const,
441
+ register: vi.fn().mockResolvedValue(mockDb),
442
+ };
443
+
444
+ // Create a router with default auditor and database
445
+ const router = e
446
+ .logger(mockLogger)
447
+ .database(databaseService)
448
+ .auditor(auditStorageService);
449
+
450
+ const outputSchema = z.object({ success: z.boolean() });
451
+
452
+ type OutputType = z.infer<typeof outputSchema>;
453
+
454
+ const endpoint = router
455
+ .get('/health')
456
+ .output(outputSchema)
457
+ .audit([
458
+ {
459
+ type: 'user.created',
460
+ payload: (_response: OutputType) => ({
461
+ userId: 'system',
462
+ email: 'health@check.com',
463
+ }),
464
+ when: (response: OutputType) => response.success,
465
+ },
466
+ ] satisfies MappedAudit<TestAuditAction, typeof outputSchema>[])
467
+ .handle(async ({ db, auditor }) => {
468
+ // Both db and auditor should be available from router defaults
469
+ await db.query('SELECT 1');
470
+
471
+ // Manual audit
472
+ auditor.audit('user.updated', {
473
+ userId: 'system',
474
+ changes: ['health_check'],
475
+ });
476
+
477
+ return { success: true };
478
+ });
479
+
480
+ const adapter = new TestEndpointAdaptor(endpoint);
481
+
482
+ const result = await adapter.request({
483
+ services: {},
484
+ headers: { host: 'example.com' },
485
+ database: mockDb,
486
+ auditorStorage: auditStorage,
487
+ });
488
+
489
+ expect(result).toEqual({ success: true });
490
+ expect(mockDb.query).toHaveBeenCalledWith('SELECT 1');
491
+
492
+ // Both manual and declarative audits
493
+ expect(auditStorage.records).toHaveLength(2);
494
+ });
495
+ });
496
+
497
+ describe('type enforcement', () => {
498
+ it('should require auditorStorage when endpoint uses .auditor()', async () => {
499
+ const auditStorage = new InMemoryAuditStorage();
500
+
501
+ const auditStorageService: Service<'auditStorage', InMemoryAuditStorage> =
502
+ {
503
+ serviceName: 'auditStorage' as const,
504
+ register: vi.fn().mockResolvedValue(auditStorage),
505
+ };
506
+
507
+ const endpoint = e
508
+ .post('/users')
509
+ .logger(mockLogger)
510
+ .auditor(auditStorageService)
511
+ .output(z.object({ id: z.string() }))
512
+ .handle(async ({ auditor }) => {
513
+ auditor.audit('user.created', {
514
+ userId: 'test',
515
+ email: 'test@example.com',
516
+ });
517
+ return { id: 'test' };
518
+ });
519
+
520
+ const adapter = new TestEndpointAdaptor(endpoint);
521
+
522
+ // This call demonstrates that auditorStorage is required
523
+ // TypeScript would error if auditorStorage was omitted
524
+ const result = await adapter.request({
525
+ services: {},
526
+ headers: { host: 'example.com' },
527
+ auditorStorage: auditStorage, // Required when .auditor() is used
528
+ });
529
+
530
+ expect(result).toEqual({ id: 'test' });
531
+ });
532
+
533
+ it('should require database when endpoint uses .database()', async () => {
534
+ const mockDb = createMockDatabase();
535
+
536
+ const databaseService: Service<'database', MockDatabase> = {
537
+ serviceName: 'database' as const,
538
+ register: vi.fn().mockResolvedValue(mockDb),
539
+ };
540
+
541
+ const endpoint = e
542
+ .get('/data')
543
+ .logger(mockLogger)
544
+ .database(databaseService)
545
+ .output(z.object({ data: z.array(z.any()) }))
546
+ .handle(async ({ db }) => {
547
+ const data = await db.query('SELECT * FROM data');
548
+ return { data };
549
+ });
550
+
551
+ const adapter = new TestEndpointAdaptor(endpoint);
552
+
553
+ // This call demonstrates that database is required
554
+ // TypeScript would error if database was omitted
555
+ const result = await adapter.request({
556
+ services: {},
557
+ headers: { host: 'example.com' },
558
+ database: mockDb, // Required when .database() is used
559
+ });
560
+
561
+ expect(result).toEqual({ data: [] });
562
+ });
563
+
564
+ it('should not require auditorStorage when endpoint does not use .auditor()', async () => {
565
+ const endpoint = e
566
+ .get('/simple')
567
+ .logger(mockLogger)
568
+ .output(z.object({ message: z.string() }))
569
+ .handle(async () => ({ message: 'Hello' }));
570
+
571
+ const adapter = new TestEndpointAdaptor(endpoint);
572
+
573
+ // auditorStorage is NOT required here because .auditor() was not called
574
+ const result = await adapter.request({
575
+ services: {},
576
+ headers: { host: 'example.com' },
577
+ // No auditorStorage needed
578
+ });
579
+
580
+ expect(result).toEqual({ message: 'Hello' });
581
+ });
582
+
583
+ it('should not require database when endpoint does not use .database()', async () => {
584
+ const endpoint = e
585
+ .get('/simple')
586
+ .logger(mockLogger)
587
+ .output(z.object({ message: z.string() }))
588
+ .handle(async () => ({ message: 'Hello' }));
589
+
590
+ const adapter = new TestEndpointAdaptor(endpoint);
591
+
592
+ // database is NOT required here because .database() was not called
593
+ const result = await adapter.request({
594
+ services: {},
595
+ headers: { host: 'example.com' },
596
+ // No database needed
597
+ });
598
+
599
+ expect(result).toEqual({ message: 'Hello' });
600
+ });
601
+ });
602
+ });