@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,226 @@
1
+ import { EnvironmentParser } from '@geekmidas/envkit';
2
+ import type { Service } from '@geekmidas/services';
3
+ import { ServiceDiscovery } from '@geekmidas/services';
4
+ import { Hono } from 'hono';
5
+ import { type HttpHandler, http } from 'msw';
6
+ import type { Endpoint } from './Endpoint';
7
+ import { HonoEndpoint } from './HonoEndpointAdaptor';
8
+
9
+ /**
10
+ * Header used to identify which test context a request belongs to.
11
+ * Each concurrent test registers its own context (services, db transaction, etc.)
12
+ * and the MSW handler looks it up by this header value.
13
+ */
14
+ export const TEST_CONTEXT_HEADER = 'x-test-context-id';
15
+
16
+ /**
17
+ * Per-test context containing an isolated ServiceDiscovery instance.
18
+ * Registered in the context map and looked up per-request via the context ID header.
19
+ */
20
+ export interface MswTestContext {
21
+ serviceDiscovery: ServiceDiscovery<any>;
22
+ }
23
+
24
+ /**
25
+ * Options for creating MSW handlers from endpoint constructs.
26
+ *
27
+ * @example
28
+ * ```typescript
29
+ * import { createMswHandlers, registerTestContext } from '@geekmidas/constructs/testing';
30
+ * import { setupServer } from 'msw/node';
31
+ *
32
+ * // Create handlers once (global)
33
+ * const { handlers, registerContext, removeContext } = createMswHandlers(
34
+ * [getUsers, createUser],
35
+ * { baseURL: 'http://localhost:3000' },
36
+ * );
37
+ * const server = setupServer(...handlers);
38
+ *
39
+ * // Per test: register an isolated context with its own services/transaction
40
+ * it('should list users', async ({ db }) => {
41
+ * const contextId = crypto.randomUUID();
42
+ * registerContext(contextId, {
43
+ * services: { database: db, auth: mockAuth },
44
+ * });
45
+ *
46
+ * const api = createApi({
47
+ * baseURL: 'http://localhost:3000',
48
+ * headers: { [TEST_CONTEXT_HEADER]: contextId },
49
+ * });
50
+ *
51
+ * const result = await api('GET /users');
52
+ * expect(result).toBeDefined();
53
+ *
54
+ * removeContext(contextId);
55
+ * });
56
+ * ```
57
+ */
58
+ export interface CreateMswHandlersOptions {
59
+ /** Base URL the client fetches from (e.g., 'http://localhost:3000') */
60
+ baseURL: string;
61
+ }
62
+
63
+ /**
64
+ * Options for registering a per-test context.
65
+ * Follows the same pattern as TestRequestAdaptor — services, database,
66
+ * publisher, and auditorStorage are provided explicitly.
67
+ */
68
+ export interface RegisterContextOptions {
69
+ /** Service instances keyed by serviceName */
70
+ services?: Record<string, unknown>;
71
+ /** Database instance — required when endpoints use .database() */
72
+ database?: unknown;
73
+ /** Event publisher service definition */
74
+ publisher?: Service;
75
+ /** Audit storage instance — required when endpoints use .auditor() */
76
+ auditorStorage?: unknown;
77
+ }
78
+
79
+ const MSW_HTTP_METHODS = [
80
+ 'get',
81
+ 'post',
82
+ 'put',
83
+ 'patch',
84
+ 'delete',
85
+ 'options',
86
+ ] as const;
87
+
88
+ type MswHttpMethod = (typeof MSW_HTTP_METHODS)[number];
89
+
90
+ /**
91
+ * Result of creating MSW handlers from endpoint constructs.
92
+ */
93
+ export interface CreateMswHandlersResult {
94
+ /** MSW handlers to pass to setupServer() */
95
+ handlers: HttpHandler[];
96
+ /** Register an isolated context for a test */
97
+ registerContext: (id: string, options: RegisterContextOptions) => void;
98
+ }
99
+
100
+ /**
101
+ * Creates MSW HTTP handlers from endpoint constructs.
102
+ *
103
+ * Mounts endpoints on a Hono app and creates MSW handlers that intercept
104
+ * fetch requests and route them through `app.request()` — giving frontend
105
+ * tests full endpoint behavior (validation, auth, sessions) without HTTP.
106
+ *
107
+ * Each test registers its own isolated context via `registerContext()`,
108
+ * which is resolved per-request using the `x-test-context-id` header.
109
+ * This allows concurrent tests with their own transactions and services.
110
+ *
111
+ * @param endpoints - Array of endpoint constructs to create handlers for
112
+ * @param options - Configuration including baseURL
113
+ * @returns MSW handlers, the Hono app, and context management functions
114
+ */
115
+ export function createMswHandlers(
116
+ endpoints: Endpoint<any, any, any, any, any, any>[],
117
+ options: CreateMswHandlersOptions,
118
+ ): CreateMswHandlersResult {
119
+ const { baseURL } = options;
120
+ const contexts = new Map<string, MswTestContext>();
121
+
122
+ /**
123
+ * Register an isolated context for a test.
124
+ * Creates a fresh ServiceDiscovery and pre-registers all provided services.
125
+ */
126
+ function registerContext(id: string, ctxOptions: RegisterContextOptions) {
127
+ const envParser = new EnvironmentParser({});
128
+ const serviceDiscovery = new ServiceDiscovery(envParser);
129
+
130
+ const serviceDefs: Service[] = [];
131
+
132
+ // Register explicit services
133
+ if (ctxOptions.services) {
134
+ for (const [name, instance] of Object.entries(ctxOptions.services)) {
135
+ serviceDefs.push({
136
+ serviceName: name,
137
+ register: () => instance,
138
+ } as Service);
139
+ }
140
+ }
141
+
142
+ // Register database service from endpoint metadata
143
+ if (ctxOptions.database !== undefined) {
144
+ for (const endpoint of endpoints) {
145
+ if (endpoint.databaseService) {
146
+ serviceDefs.push({
147
+ serviceName: endpoint.databaseService.serviceName,
148
+ register: () => ctxOptions.database,
149
+ } as Service);
150
+ break;
151
+ }
152
+ }
153
+ }
154
+
155
+ // Register publisher service
156
+ if (ctxOptions.publisher) {
157
+ serviceDefs.push(ctxOptions.publisher);
158
+ }
159
+
160
+ // Register auditor storage service from endpoint metadata
161
+ if (ctxOptions.auditorStorage !== undefined) {
162
+ for (const endpoint of endpoints) {
163
+ if (endpoint.auditorStorageService) {
164
+ serviceDefs.push({
165
+ serviceName: endpoint.auditorStorageService.serviceName,
166
+ register: () => ctxOptions.auditorStorage,
167
+ } as Service);
168
+ break;
169
+ }
170
+ }
171
+ }
172
+
173
+ if (serviceDefs.length > 0) {
174
+ serviceDiscovery.register(serviceDefs);
175
+ }
176
+
177
+ contexts.set(id, { serviceDiscovery });
178
+ }
179
+
180
+ // Create a Hono app per-request that uses the correct ServiceDiscovery.
181
+ // We use a wrapper app that resolves the context from the header,
182
+ // then delegates to a context-specific Hono app.
183
+ const handlers: HttpHandler[] = [];
184
+
185
+ for (const endpoint of endpoints) {
186
+ const method = endpoint.method.toLowerCase() as MswHttpMethod;
187
+ if (!MSW_HTTP_METHODS.includes(method)) continue;
188
+
189
+ const mswUrl = `${baseURL}${endpoint.route}`;
190
+ const mswMethod = http[method];
191
+
192
+ handlers.push(
193
+ mswMethod(mswUrl, async ({ request }) => {
194
+ const contextId = request.headers.get(TEST_CONTEXT_HEADER);
195
+ const ctx = contextId ? contexts.get(contextId) : undefined;
196
+
197
+ if (!ctx) {
198
+ return new Response(
199
+ JSON.stringify({
200
+ error: 'Missing or unknown test context ID',
201
+ hint: `Set the '${TEST_CONTEXT_HEADER}' header to a registered context ID`,
202
+ }),
203
+ { status: 500, headers: { 'content-type': 'application/json' } },
204
+ );
205
+ }
206
+
207
+ // Build a fresh Hono app with this context's ServiceDiscovery
208
+ const app = new Hono();
209
+ HonoEndpoint.addRoute(endpoint, ctx.serviceDiscovery as any, app);
210
+
211
+ const response = await app.request(request);
212
+
213
+ return new Response(response.body, {
214
+ status: response.status,
215
+ statusText: response.statusText,
216
+ headers: response.headers,
217
+ });
218
+ }),
219
+ );
220
+ }
221
+
222
+ return {
223
+ handlers,
224
+ registerContext,
225
+ };
226
+ }
@@ -0,0 +1,466 @@
1
+ import type {
2
+ AuditActor,
3
+ AuditableAction,
4
+ AuditStorage,
5
+ } from '@geekmidas/audit';
6
+ import { DefaultAuditor } from '@geekmidas/audit';
7
+ import { EnvironmentParser } from '@geekmidas/envkit';
8
+ import { ForbiddenError, wrapError } from '@geekmidas/errors';
9
+ import type { EventPublisher } from '@geekmidas/events';
10
+ import type { Logger } from '@geekmidas/logger';
11
+ import type {
12
+ InferComposableStandardSchema,
13
+ InferStandardSchema,
14
+ } from '@geekmidas/schema';
15
+ import {
16
+ runWithRequestContext,
17
+ type Service,
18
+ ServiceDiscovery,
19
+ type ServiceRecord,
20
+ } from '@geekmidas/services';
21
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
22
+ import { startMonitors } from '../monitor';
23
+ import { publishConstructEvents } from '../publisher';
24
+ import type { HttpMethod } from '../types';
25
+ import type { MappedAudit } from './audit';
26
+ import {
27
+ type CookieOptions,
28
+ Endpoint,
29
+ type EndpointSchemas,
30
+ ResponseBuilder,
31
+ } from './Endpoint';
32
+ import {
33
+ createCookieHeaderAccessor,
34
+ createObjectHeaders,
35
+ } from './lazyAccessors';
36
+ import {
37
+ type AuditExecutionContext,
38
+ executeWithAuditTransaction,
39
+ } from './processAudits';
40
+
41
+ export type TestHttpResponse<TBody = any> = {
42
+ body: TBody;
43
+ status: number;
44
+ headers: Record<string, string | string[]>;
45
+ };
46
+
47
+ /**
48
+ * Serializes a cookie into a Set-Cookie header string
49
+ */
50
+ function serializeCookie(
51
+ name: string,
52
+ value: string,
53
+ options?: CookieOptions,
54
+ ): string {
55
+ let cookieString = `${name}=${value}`;
56
+
57
+ if (options) {
58
+ if (options.maxAge !== undefined) {
59
+ cookieString += `; Max-Age=${options.maxAge}`;
60
+ }
61
+ if (options.expires) {
62
+ cookieString += `; Expires=${options.expires.toUTCString()}`;
63
+ }
64
+ if (options.domain) {
65
+ cookieString += `; Domain=${options.domain}`;
66
+ }
67
+ if (options.path) {
68
+ cookieString += `; Path=${options.path}`;
69
+ }
70
+ if (options.httpOnly) {
71
+ cookieString += '; HttpOnly';
72
+ }
73
+ if (options.secure) {
74
+ cookieString += '; Secure';
75
+ }
76
+ if (options.sameSite) {
77
+ cookieString += `; SameSite=${options.sameSite}`;
78
+ }
79
+ }
80
+
81
+ return cookieString;
82
+ }
83
+
84
+ export class TestEndpointAdaptor<
85
+ TRoute extends string,
86
+ TMethod extends HttpMethod,
87
+ TInput extends EndpointSchemas = {},
88
+ TOutSchema extends StandardSchemaV1 | undefined = undefined,
89
+ TServices extends Service[] = [],
90
+ TLogger extends Logger = Logger,
91
+ TSession = unknown,
92
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
93
+ TEventPublisherServiceName extends string = string,
94
+ TAuditStorage extends AuditStorage | undefined = undefined,
95
+ TAuditStorageServiceName extends string = string,
96
+ TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
97
+ string,
98
+ unknown
99
+ >,
100
+ TDatabase = undefined,
101
+ TDatabaseServiceName extends string = string,
102
+ > {
103
+ static getDefaultServiceDiscover<
104
+ TRoute extends string,
105
+ TMethod extends HttpMethod,
106
+ TInput extends EndpointSchemas = {},
107
+ TOutSchema extends StandardSchemaV1 | undefined = undefined,
108
+ TServices extends Service[] = [],
109
+ TLogger extends Logger = Logger,
110
+ TSession = unknown,
111
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
112
+ TEventPublisherServiceName extends string = string,
113
+ TAuditStorage extends AuditStorage | undefined = undefined,
114
+ TAuditStorageServiceName extends string = string,
115
+ TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
116
+ string,
117
+ unknown
118
+ >,
119
+ TDatabase = undefined,
120
+ TDatabaseServiceName extends string = string,
121
+ >(
122
+ _endpoint: Endpoint<
123
+ TRoute,
124
+ TMethod,
125
+ TInput,
126
+ TOutSchema,
127
+ TServices,
128
+ TLogger,
129
+ TSession,
130
+ TEventPublisher,
131
+ TEventPublisherServiceName,
132
+ TAuditStorage,
133
+ TAuditStorageServiceName,
134
+ TAuditAction,
135
+ TDatabase,
136
+ TDatabaseServiceName
137
+ >,
138
+ ) {
139
+ return ServiceDiscovery.getInstance(new EnvironmentParser({}));
140
+ }
141
+ constructor(
142
+ private readonly endpoint: Endpoint<
143
+ TRoute,
144
+ TMethod,
145
+ TInput,
146
+ TOutSchema,
147
+ TServices,
148
+ TLogger,
149
+ TSession,
150
+ TEventPublisher,
151
+ TEventPublisherServiceName,
152
+ TAuditStorage,
153
+ TAuditStorageServiceName,
154
+ TAuditAction,
155
+ TDatabase,
156
+ TDatabaseServiceName
157
+ >,
158
+ private serviceDiscovery: ServiceDiscovery<any> = TestEndpointAdaptor.getDefaultServiceDiscover(
159
+ endpoint,
160
+ ),
161
+ ) {}
162
+
163
+ async fullRequest(
164
+ ctx: TestRequestAdaptor<
165
+ TInput,
166
+ TServices,
167
+ TEventPublisher,
168
+ TEventPublisherServiceName,
169
+ TAuditStorage,
170
+ TAuditStorageServiceName,
171
+ TDatabase,
172
+ TDatabaseServiceName
173
+ >,
174
+ ): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>> {
175
+ const body = await this.endpoint.parseInput((ctx as any).body, 'body');
176
+ const query = await this.endpoint.parseInput((ctx as any).query, 'query');
177
+ const params = await this.endpoint.parseInput(
178
+ (ctx as any).params,
179
+ 'params',
180
+ );
181
+
182
+ // Lazy accessors - defer parsing until needed
183
+ const header = createObjectHeaders(ctx.headers);
184
+ const cookie = createCookieHeaderAccessor(ctx.headers.cookie);
185
+
186
+ // Request context setup
187
+ const startTime = Date.now();
188
+ const requestId =
189
+ (ctx as any).requestId ??
190
+ ctx.headers['x-request-id'] ??
191
+ crypto.randomUUID();
192
+
193
+ const logger = this.endpoint.logger.child({
194
+ requestId,
195
+ route: this.endpoint.route,
196
+ host: ctx.headers.host,
197
+ method: this.endpoint.method,
198
+ }) as TLogger;
199
+
200
+ // Get database from context for session extraction
201
+ const rawDb = (ctx as any).database as TDatabase;
202
+
203
+ const monitor = await startMonitors(
204
+ this.endpoint,
205
+ this.serviceDiscovery,
206
+ logger,
207
+ );
208
+
209
+ // Wrap handler execution in request context
210
+ try {
211
+ const response = await runWithRequestContext(
212
+ { logger, requestId, startTime },
213
+ async () =>
214
+ this.run(ctx, { body, query, params, header, cookie, logger, rawDb }),
215
+ );
216
+ await monitor.settle(response.status);
217
+ return response;
218
+ } catch (error) {
219
+ await monitor.settle(wrapError(error).statusCode, error);
220
+ throw error;
221
+ }
222
+ }
223
+
224
+ private async run(
225
+ ctx: TestRequestAdaptor<
226
+ TInput,
227
+ TServices,
228
+ TEventPublisher,
229
+ TEventPublisherServiceName,
230
+ TAuditStorage,
231
+ TAuditStorageServiceName,
232
+ TDatabase,
233
+ TDatabaseServiceName
234
+ >,
235
+ {
236
+ body,
237
+ query,
238
+ params,
239
+ header,
240
+ cookie,
241
+ logger,
242
+ rawDb,
243
+ }: {
244
+ body: unknown;
245
+ query: unknown;
246
+ params: unknown;
247
+ header: ReturnType<typeof createObjectHeaders>;
248
+ cookie: ReturnType<typeof createCookieHeaderAccessor>;
249
+ logger: TLogger;
250
+ rawDb: TDatabase;
251
+ },
252
+ ): Promise<TestHttpResponse<InferStandardSchema<TOutSchema>>> {
253
+ const session = await this.endpoint.getSession({
254
+ logger,
255
+ services: ctx.services,
256
+ header,
257
+ cookie,
258
+ ...(rawDb !== undefined && { db: rawDb }),
259
+ } as any);
260
+
261
+ // Check authorization
262
+ const isAuthorized = await this.endpoint.authorize({
263
+ header,
264
+ cookie,
265
+ services: ctx.services,
266
+ logger,
267
+ session,
268
+ ...(rawDb !== undefined && { db: rawDb }),
269
+ body,
270
+ query,
271
+ params,
272
+ } as any);
273
+
274
+ if (!isAuthorized) {
275
+ logger.warn('Forbidden access attempt');
276
+ throw new ForbiddenError(
277
+ 'Forbidden access to the endpoint',
278
+ 'You do not have permission to access this resource.',
279
+ );
280
+ }
281
+
282
+ // Create audit context if audit storage is provided
283
+ // The auditorStorage instance is required when endpoint uses .auditor()
284
+ const auditorStorage = (ctx as any).auditorStorage as TAuditStorage;
285
+ let auditContext: AuditExecutionContext<TAuditAction> | undefined;
286
+
287
+ if (auditorStorage) {
288
+ // Extract actor if configured
289
+ let actor: AuditActor = { id: 'system', type: 'system' };
290
+ if (this.endpoint.actorExtractor) {
291
+ try {
292
+ actor = await this.endpoint.actorExtractor({
293
+ services: ctx.services as any,
294
+ session,
295
+ header,
296
+ cookie,
297
+ logger,
298
+ });
299
+ } catch (error) {
300
+ logger.error(error as Error, 'Failed to extract actor for audits');
301
+ }
302
+ }
303
+
304
+ const auditor = new DefaultAuditor<TAuditAction>({
305
+ actor,
306
+ storage: auditorStorage as AuditStorage,
307
+ metadata: {
308
+ endpoint: this.endpoint.route,
309
+ method: this.endpoint.method,
310
+ },
311
+ });
312
+
313
+ auditContext = { auditor, storage: auditorStorage as AuditStorage };
314
+ }
315
+
316
+ // Warn if declarative audits are configured but no audit storage
317
+ const audits = this.endpoint.audits as MappedAudit<
318
+ TAuditAction,
319
+ TOutSchema
320
+ >[];
321
+ if (!auditContext && audits?.length) {
322
+ logger.warn('No auditor storage service available');
323
+ }
324
+
325
+ // Execute handler with automatic audit transaction support
326
+ const result = await executeWithAuditTransaction(
327
+ auditContext,
328
+ async (auditor) => {
329
+ // Use audit transaction as db if available (when storage has same database)
330
+ // For testing, the tester controls whether to use transactional auditing
331
+ const trx = auditor?.getTransaction?.();
332
+ const db = trx ?? rawDb;
333
+
334
+ const responseBuilder = new ResponseBuilder();
335
+ const response = await this.endpoint.handler(
336
+ {
337
+ body,
338
+ query,
339
+ params,
340
+ session,
341
+ services: ctx.services,
342
+ logger,
343
+ header,
344
+ cookie,
345
+ auditor,
346
+ db,
347
+ } as any,
348
+ responseBuilder,
349
+ );
350
+
351
+ // Check if response has metadata
352
+ let data = response;
353
+ let metadata = responseBuilder.getMetadata();
354
+
355
+ if (Endpoint.hasMetadata(response)) {
356
+ data = response.data;
357
+ metadata = response.metadata;
358
+ }
359
+
360
+ const output = await this.endpoint.parseOutput(data);
361
+
362
+ return { output, metadata, responseBuilder };
363
+ },
364
+ // Process declarative audits after handler (inside transaction)
365
+ async (result, auditor) => {
366
+ if (!audits?.length) return;
367
+
368
+ for (const audit of audits) {
369
+ if (audit.when && !audit.when(result.output as any)) {
370
+ continue;
371
+ }
372
+ const payload = audit.payload(result.output as any);
373
+ const entityId = audit.entityId?.(result.output as any);
374
+ auditor.audit(audit.type as any, payload as any, {
375
+ table: audit.table,
376
+ entityId,
377
+ });
378
+ }
379
+ },
380
+ // Pass rawDb so storage can reuse existing transactions
381
+ { db: rawDb },
382
+ );
383
+
384
+ const { output, metadata } = result;
385
+
386
+ ctx.publisher && (await this.serviceDiscovery.register([ctx.publisher]));
387
+ await publishConstructEvents(this.endpoint, output, this.serviceDiscovery);
388
+
389
+ // Convert cookies to Set-Cookie headers
390
+ const headers: Record<string, string | string[]> = {
391
+ ...(metadata.headers || {}),
392
+ };
393
+
394
+ if (metadata.cookies && metadata.cookies.size > 0) {
395
+ const setCookieValues: string[] = [];
396
+ for (const [name, cookie] of metadata.cookies.entries()) {
397
+ setCookieValues.push(
398
+ serializeCookie(name, cookie.value, cookie.options),
399
+ );
400
+ }
401
+ headers['set-cookie'] = setCookieValues;
402
+ }
403
+
404
+ // Return HTTP response format
405
+ return {
406
+ body: output,
407
+ status: metadata.status || 200,
408
+ headers,
409
+ };
410
+ }
411
+
412
+ async request(
413
+ ctx: TestRequestAdaptor<
414
+ TInput,
415
+ TServices,
416
+ TEventPublisher,
417
+ TEventPublisherServiceName,
418
+ TAuditStorage,
419
+ TAuditStorageServiceName,
420
+ TDatabase,
421
+ TDatabaseServiceName
422
+ >,
423
+ ): Promise<InferStandardSchema<TOutSchema>> {
424
+ const response = await this.fullRequest(ctx);
425
+ return response.body;
426
+ }
427
+ }
428
+
429
+ /**
430
+ * Conditional audit storage requirement - required when TAuditStorage is configured
431
+ */
432
+ type AuditStorageRequirement<
433
+ TAuditStorage extends AuditStorage | undefined = undefined,
434
+ > = TAuditStorage extends undefined
435
+ ? {}
436
+ : {
437
+ /** Audit storage instance - required when endpoint uses .auditor() */
438
+ auditorStorage: TAuditStorage;
439
+ };
440
+
441
+ /**
442
+ * Conditional database requirement - required when TDatabase is configured
443
+ */
444
+ type DatabaseRequirement<TDatabase = undefined> = TDatabase extends undefined
445
+ ? {}
446
+ : {
447
+ /** Database instance - required when endpoint uses .database() */
448
+ database: TDatabase;
449
+ };
450
+
451
+ export type TestRequestAdaptor<
452
+ TInput extends EndpointSchemas = {},
453
+ TServices extends Service[] = [],
454
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
455
+ TEventPublisherServiceName extends string = string,
456
+ TAuditStorage extends AuditStorage | undefined = undefined,
457
+ _TAuditStorageServiceName extends string = string,
458
+ TDatabase = undefined,
459
+ _TDatabaseServiceName extends string = string,
460
+ > = {
461
+ services: ServiceRecord<TServices>;
462
+ headers: Record<string, string>;
463
+ publisher?: Service<TEventPublisherServiceName, TEventPublisher>;
464
+ } & InferComposableStandardSchema<TInput> &
465
+ AuditStorageRequirement<TAuditStorage> &
466
+ DatabaseRequirement<TDatabase>;