@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,652 @@
1
+ import type { EventPublisher, PublishableMessage } from '@geekmidas/events';
2
+ import type { Logger } from '@geekmidas/logger';
3
+ import { ConsoleLogger } from '@geekmidas/logger/console';
4
+ import type { Service } from '@geekmidas/services';
5
+ import { serviceContext } from '@geekmidas/services';
6
+ import { beforeEach, describe, expect, it, vi } from 'vitest';
7
+ import { z } from 'zod';
8
+ import { Subscriber } from '../Subscriber';
9
+ import { SubscriberBuilder } from '../SubscriberBuilder';
10
+ import { TestSubscriberAdaptor } from '../TestSubscriberAdaptor';
11
+
12
+ // --- Test fixtures ---
13
+
14
+ type UserEvent =
15
+ | PublishableMessage<
16
+ 'user.created',
17
+ { userId: string; email: string; name: string }
18
+ >
19
+ | PublishableMessage<
20
+ 'user.updated',
21
+ { userId: string; changes: Record<string, any> }
22
+ >
23
+ | PublishableMessage<'user.deleted', { userId: string }>;
24
+
25
+ class TestEventPublisher implements EventPublisher<UserEvent> {
26
+ publishedEvents: UserEvent[] = [];
27
+ async publish(events: UserEvent[]): Promise<void> {
28
+ this.publishedEvents.push(...events);
29
+ }
30
+ }
31
+
32
+ const TestEventService: Service<'testEventPublisher', TestEventPublisher> = {
33
+ serviceName: 'testEventPublisher' as const,
34
+ register() {
35
+ return new TestEventPublisher();
36
+ },
37
+ };
38
+
39
+ const TestDbService: Service<'db', { query: () => string }> = {
40
+ serviceName: 'db' as const,
41
+ register() {
42
+ return { query: () => 'result' };
43
+ },
44
+ };
45
+
46
+ describe('TestSubscriberAdaptor', () => {
47
+ let logger: ConsoleLogger;
48
+
49
+ beforeEach(() => {
50
+ logger = new ConsoleLogger();
51
+ vi.clearAllMocks();
52
+ });
53
+
54
+ describe('basic execution', () => {
55
+ it('should invoke a subscriber and return result', async () => {
56
+ const subscriber = new SubscriberBuilder()
57
+ .publisher(TestEventService)
58
+ .subscribe('user.created')
59
+ .handle(async ({ events }) => ({
60
+ processed: events.length,
61
+ }));
62
+
63
+ const adaptor = new TestSubscriberAdaptor(subscriber);
64
+
65
+ const result = await adaptor.invoke({
66
+ events: [
67
+ {
68
+ type: 'user.created',
69
+ payload: {
70
+ userId: '1',
71
+ email: 'test@example.com',
72
+ name: 'Test',
73
+ },
74
+ },
75
+ ],
76
+ services: {},
77
+ });
78
+
79
+ expect(result).toEqual({ processed: 1 });
80
+ });
81
+
82
+ it('should return early with batchItemFailures for empty events', async () => {
83
+ const handler = vi.fn(async () => ({ processed: 0 }));
84
+ const subscriber = new SubscriberBuilder()
85
+ .publisher(TestEventService)
86
+ .subscribe('user.created')
87
+ .handle(handler);
88
+
89
+ const adaptor = new TestSubscriberAdaptor(subscriber);
90
+
91
+ const result = await adaptor.invoke({
92
+ events: [],
93
+ services: {},
94
+ });
95
+
96
+ expect(result).toEqual({ batchItemFailures: [] });
97
+ expect(handler).not.toHaveBeenCalled();
98
+ });
99
+
100
+ it('should handle multiple events in a batch', async () => {
101
+ const processedIds: string[] = [];
102
+ const subscriber = new SubscriberBuilder()
103
+ .publisher(TestEventService)
104
+ .subscribe(['user.created', 'user.updated'])
105
+ .handle(async ({ events }) => {
106
+ for (const event of events) {
107
+ processedIds.push(event.payload.userId);
108
+ }
109
+ return { count: events.length };
110
+ });
111
+
112
+ const adaptor = new TestSubscriberAdaptor(subscriber);
113
+
114
+ const result = await adaptor.invoke({
115
+ events: [
116
+ {
117
+ type: 'user.created',
118
+ payload: {
119
+ userId: '1',
120
+ email: 'a@b.com',
121
+ name: 'A',
122
+ },
123
+ },
124
+ {
125
+ type: 'user.updated',
126
+ payload: {
127
+ userId: '2',
128
+ changes: { name: 'B' },
129
+ },
130
+ },
131
+ ] as any,
132
+ services: {},
133
+ });
134
+
135
+ expect(result).toEqual({ count: 2 });
136
+ expect(processedIds).toEqual(['1', '2']);
137
+ });
138
+ });
139
+
140
+ describe('output validation', () => {
141
+ it('should validate output against schema', async () => {
142
+ const outputSchema = z.object({ processed: z.number() });
143
+
144
+ const subscriber = new SubscriberBuilder()
145
+ .publisher(TestEventService)
146
+ .output(outputSchema)
147
+ .subscribe('user.created')
148
+ .handle(async ({ events }) => ({
149
+ processed: events.length,
150
+ }));
151
+
152
+ const adaptor = new TestSubscriberAdaptor(subscriber);
153
+
154
+ const result = await adaptor.invoke({
155
+ events: [
156
+ {
157
+ type: 'user.created',
158
+ payload: {
159
+ userId: '1',
160
+ email: 'test@example.com',
161
+ name: 'Test',
162
+ },
163
+ },
164
+ ],
165
+ services: {},
166
+ });
167
+
168
+ expect(result).toEqual({ processed: 1 });
169
+ });
170
+
171
+ it('should throw on invalid output', async () => {
172
+ const outputSchema = z.object({ processed: z.number() });
173
+
174
+ const subscriber = new SubscriberBuilder()
175
+ .publisher(TestEventService)
176
+ .output(outputSchema)
177
+ .subscribe('user.created')
178
+ .handle(async () => ({
179
+ processed: 'not-a-number' as any,
180
+ }));
181
+
182
+ const adaptor = new TestSubscriberAdaptor(subscriber);
183
+
184
+ await expect(
185
+ adaptor.invoke({
186
+ events: [
187
+ {
188
+ type: 'user.created',
189
+ payload: {
190
+ userId: '1',
191
+ email: 'test@example.com',
192
+ name: 'Test',
193
+ },
194
+ },
195
+ ],
196
+ services: {},
197
+ }),
198
+ ).rejects.toThrow('Subscriber output validation failed');
199
+ });
200
+ });
201
+
202
+ describe('event filtering', () => {
203
+ it('should filter out events not in subscribedEvents', async () => {
204
+ const receivedEvents: any[] = [];
205
+ const subscriber = new SubscriberBuilder()
206
+ .publisher(TestEventService)
207
+ .subscribe('user.created')
208
+ .handle(async ({ events }) => {
209
+ receivedEvents.push(...events);
210
+ return { count: events.length };
211
+ });
212
+
213
+ const adaptor = new TestSubscriberAdaptor(subscriber);
214
+
215
+ const result = await adaptor.invoke({
216
+ events: [
217
+ {
218
+ type: 'user.created',
219
+ payload: {
220
+ userId: '1',
221
+ email: 'a@b.com',
222
+ name: 'A',
223
+ },
224
+ },
225
+ // This event type is not subscribed — should be filtered
226
+ {
227
+ type: 'user.deleted',
228
+ payload: { userId: '2' },
229
+ },
230
+ ] as any,
231
+ services: {},
232
+ });
233
+
234
+ expect(result).toEqual({ count: 1 });
235
+ expect(receivedEvents).toHaveLength(1);
236
+ expect(receivedEvents[0].type).toBe('user.created');
237
+ });
238
+
239
+ it('should return early if all events are filtered out', async () => {
240
+ const handler = vi.fn(async () => ({}));
241
+ const subscriber = new SubscriberBuilder()
242
+ .publisher(TestEventService)
243
+ .subscribe('user.created')
244
+ .handle(handler);
245
+
246
+ const adaptor = new TestSubscriberAdaptor(subscriber);
247
+
248
+ const result = await adaptor.invoke({
249
+ events: [
250
+ {
251
+ type: 'user.deleted',
252
+ payload: { userId: '1' },
253
+ },
254
+ ] as any,
255
+ services: {},
256
+ });
257
+
258
+ expect(result).toEqual({ batchItemFailures: [] });
259
+ expect(handler).not.toHaveBeenCalled();
260
+ });
261
+
262
+ it('should accept all events when subscribedEvents is undefined', async () => {
263
+ // Build a subscriber without .subscribe() — accepts all
264
+ const subscriber = new Subscriber(
265
+ async ({ events }) => ({ count: events.length }),
266
+ 30000,
267
+ undefined, // no subscribedEvents filter
268
+ );
269
+
270
+ const adaptor = new TestSubscriberAdaptor(subscriber as any);
271
+
272
+ const result = await adaptor.invoke({
273
+ events: [
274
+ { type: 'user.created', payload: { userId: '1' } },
275
+ { type: 'user.deleted', payload: { userId: '2' } },
276
+ ] as any,
277
+ services: {},
278
+ });
279
+
280
+ expect(result).toEqual({ count: 2 });
281
+ });
282
+ });
283
+
284
+ describe('services', () => {
285
+ it('should use provided services from request', async () => {
286
+ const subscriber = new SubscriberBuilder()
287
+ .publisher(TestEventService)
288
+ .services([TestDbService])
289
+ .subscribe('user.created')
290
+ .handle(async ({ services }) => ({
291
+ value: services.db.query(),
292
+ }));
293
+
294
+ const adaptor = new TestSubscriberAdaptor(subscriber);
295
+
296
+ const result = await adaptor.invoke({
297
+ events: [
298
+ {
299
+ type: 'user.created',
300
+ payload: {
301
+ userId: '1',
302
+ email: 'a@b.com',
303
+ name: 'A',
304
+ },
305
+ },
306
+ ],
307
+ services: { db: { query: () => 'injected-result' } },
308
+ });
309
+
310
+ expect(result).toEqual({ value: 'injected-result' });
311
+ });
312
+
313
+ it('should auto-resolve services when not provided', async () => {
314
+ const subscriber = new SubscriberBuilder()
315
+ .publisher(TestEventService)
316
+ .services([TestDbService])
317
+ .subscribe('user.created')
318
+ .handle(async ({ services }) => ({
319
+ value: services.db.query(),
320
+ }));
321
+
322
+ const adaptor = new TestSubscriberAdaptor(subscriber);
323
+
324
+ const result = await adaptor.invoke({
325
+ events: [
326
+ {
327
+ type: 'user.created',
328
+ payload: {
329
+ userId: '1',
330
+ email: 'a@b.com',
331
+ name: 'A',
332
+ },
333
+ },
334
+ ],
335
+ });
336
+
337
+ expect(result).toEqual({ value: 'result' });
338
+ });
339
+
340
+ it('should use custom ServiceDiscovery when provided', async () => {
341
+ const subscriber = new SubscriberBuilder()
342
+ .publisher(TestEventService)
343
+ .services([TestDbService])
344
+ .subscribe('user.created')
345
+ .handle(async ({ services }) => ({
346
+ value: services.db.query(),
347
+ }));
348
+
349
+ const mockDiscovery = {
350
+ register: vi.fn().mockResolvedValue({
351
+ db: { query: () => 'custom-discovery' },
352
+ }),
353
+ } as any;
354
+
355
+ const adaptor = new TestSubscriberAdaptor(subscriber, mockDiscovery);
356
+
357
+ const result = await adaptor.invoke({
358
+ events: [
359
+ {
360
+ type: 'user.created',
361
+ payload: {
362
+ userId: '1',
363
+ email: 'a@b.com',
364
+ name: 'A',
365
+ },
366
+ },
367
+ ],
368
+ });
369
+
370
+ expect(result).toEqual({ value: 'custom-discovery' });
371
+ expect(mockDiscovery.register).toHaveBeenCalledWith(subscriber.services);
372
+ });
373
+ });
374
+
375
+ describe('logging', () => {
376
+ it('should create child logger with test context', async () => {
377
+ const mockLogger: Logger = {
378
+ debug: vi.fn(),
379
+ info: vi.fn(),
380
+ warn: vi.fn(),
381
+ error: vi.fn(),
382
+ fatal: vi.fn(),
383
+ trace: vi.fn(),
384
+ child: vi.fn().mockReturnThis(),
385
+ };
386
+
387
+ const subscriber = new SubscriberBuilder()
388
+ .publisher(TestEventService)
389
+ .logger(mockLogger)
390
+ .subscribe('user.created')
391
+ .handle(async ({ logger }) => {
392
+ logger.info('Processing events');
393
+ return {};
394
+ });
395
+
396
+ const adaptor = new TestSubscriberAdaptor(subscriber);
397
+
398
+ await adaptor.invoke({
399
+ events: [
400
+ {
401
+ type: 'user.created',
402
+ payload: {
403
+ userId: '1',
404
+ email: 'a@b.com',
405
+ name: 'A',
406
+ },
407
+ },
408
+ ],
409
+ services: {},
410
+ });
411
+
412
+ expect(mockLogger.child).toHaveBeenCalledWith({ test: true });
413
+ expect(mockLogger.info).toHaveBeenCalledWith('Processing events');
414
+ });
415
+ });
416
+
417
+ describe('event publishing', () => {
418
+ it('should publish events after successful execution', async () => {
419
+ const testPublisher = new TestEventPublisher();
420
+ const publisherService: Service<'publisher', TestEventPublisher> = {
421
+ serviceName: 'publisher' as const,
422
+ register() {
423
+ return testPublisher;
424
+ },
425
+ };
426
+
427
+ const subscriber = new Subscriber(
428
+ async ({ events }) => ({
429
+ count: events.length,
430
+ }),
431
+ 30000,
432
+ ['user.created'] as any,
433
+ z.object({ count: z.number() }),
434
+ [],
435
+ logger,
436
+ publisherService as any,
437
+ );
438
+
439
+ // Add events to publish after handler completes
440
+ (subscriber as any).events = [
441
+ {
442
+ type: 'user.updated',
443
+ payload: (response: any) => ({
444
+ userId: 'derived',
445
+ changes: { count: response.count },
446
+ }),
447
+ },
448
+ ];
449
+
450
+ const adaptor = new TestSubscriberAdaptor(subscriber as any);
451
+
452
+ await adaptor.invoke({
453
+ events: [
454
+ {
455
+ type: 'user.created',
456
+ payload: {
457
+ userId: '1',
458
+ email: 'a@b.com',
459
+ name: 'A',
460
+ },
461
+ },
462
+ ] as any,
463
+ services: {},
464
+ });
465
+
466
+ expect(testPublisher.publishedEvents).toHaveLength(1);
467
+ expect(testPublisher.publishedEvents[0]).toEqual({
468
+ type: 'user.updated',
469
+ payload: { userId: 'derived', changes: { count: 1 } },
470
+ });
471
+ });
472
+
473
+ it('should conditionally publish events with when clause', async () => {
474
+ const testPublisher = new TestEventPublisher();
475
+ const publisherService: Service<'publisher', TestEventPublisher> = {
476
+ serviceName: 'publisher' as const,
477
+ register() {
478
+ return testPublisher;
479
+ },
480
+ };
481
+
482
+ const subscriber = new Subscriber(
483
+ async () => ({ success: false }),
484
+ 30000,
485
+ ['user.created'] as any,
486
+ z.object({ success: z.boolean() }),
487
+ [],
488
+ logger,
489
+ publisherService as any,
490
+ );
491
+
492
+ (subscriber as any).events = [
493
+ {
494
+ type: 'user.updated',
495
+ payload: () => ({
496
+ userId: 'test',
497
+ changes: {},
498
+ }),
499
+ when: (response: any) => response.success === true,
500
+ },
501
+ ];
502
+
503
+ const adaptor = new TestSubscriberAdaptor(subscriber as any);
504
+
505
+ await adaptor.invoke({
506
+ events: [
507
+ {
508
+ type: 'user.created',
509
+ payload: {
510
+ userId: '1',
511
+ email: 'a@b.com',
512
+ name: 'A',
513
+ },
514
+ },
515
+ ] as any,
516
+ services: {},
517
+ });
518
+
519
+ // when clause returned false — no events published
520
+ expect(testPublisher.publishedEvents).toHaveLength(0);
521
+ });
522
+ });
523
+
524
+ describe('error handling', () => {
525
+ it('should propagate errors from handler execution', async () => {
526
+ const subscriber = new SubscriberBuilder()
527
+ .publisher(TestEventService)
528
+ .subscribe('user.created')
529
+ .handle(async () => {
530
+ throw new Error('Handler failed');
531
+ });
532
+
533
+ const adaptor = new TestSubscriberAdaptor(subscriber);
534
+
535
+ await expect(
536
+ adaptor.invoke({
537
+ events: [
538
+ {
539
+ type: 'user.created',
540
+ payload: {
541
+ userId: '1',
542
+ email: 'a@b.com',
543
+ name: 'A',
544
+ },
545
+ },
546
+ ],
547
+ services: {},
548
+ }),
549
+ ).rejects.toThrow('Handler failed');
550
+ });
551
+ });
552
+
553
+ describe('default service discovery', () => {
554
+ it('should create default service discovery', () => {
555
+ const discovery = TestSubscriberAdaptor.getDefaultServiceDiscovery();
556
+ expect(discovery).toBeDefined();
557
+ });
558
+ });
559
+
560
+ describe('request context', () => {
561
+ it('should make serviceContext.getLogger() available inside handler', async () => {
562
+ let contextLogger: any;
563
+
564
+ const subscriber = new SubscriberBuilder()
565
+ .publisher(TestEventService)
566
+ .subscribe('user.created')
567
+ .handle(async ({ events }) => {
568
+ contextLogger = serviceContext.getLogger();
569
+ return { processed: events.length };
570
+ });
571
+
572
+ const adaptor = new TestSubscriberAdaptor(subscriber);
573
+
574
+ await adaptor.invoke({
575
+ events: [
576
+ {
577
+ type: 'user.created',
578
+ payload: {
579
+ userId: '1',
580
+ email: 'test@example.com',
581
+ name: 'Test',
582
+ },
583
+ },
584
+ ],
585
+ services: {},
586
+ });
587
+
588
+ expect(contextLogger).toBeDefined();
589
+ });
590
+
591
+ it('should make serviceContext.hasContext() return true inside handler', async () => {
592
+ let hasContext = false;
593
+
594
+ const subscriber = new SubscriberBuilder()
595
+ .publisher(TestEventService)
596
+ .subscribe('user.created')
597
+ .handle(async ({ events }) => {
598
+ hasContext = serviceContext.hasContext();
599
+ return { processed: events.length };
600
+ });
601
+
602
+ const adaptor = new TestSubscriberAdaptor(subscriber);
603
+
604
+ await adaptor.invoke({
605
+ events: [
606
+ {
607
+ type: 'user.created',
608
+ payload: {
609
+ userId: '1',
610
+ email: 'test@example.com',
611
+ name: 'Test',
612
+ },
613
+ },
614
+ ],
615
+ services: {},
616
+ });
617
+
618
+ expect(hasContext).toBe(true);
619
+ });
620
+
621
+ it('should provide a request ID starting with test-', async () => {
622
+ let requestId: string | undefined;
623
+
624
+ const subscriber = new SubscriberBuilder()
625
+ .publisher(TestEventService)
626
+ .subscribe('user.created')
627
+ .handle(async ({ events }) => {
628
+ requestId = serviceContext.getRequestId();
629
+ return { processed: events.length };
630
+ });
631
+
632
+ const adaptor = new TestSubscriberAdaptor(subscriber);
633
+
634
+ await adaptor.invoke({
635
+ events: [
636
+ {
637
+ type: 'user.created',
638
+ payload: {
639
+ userId: '1',
640
+ email: 'test@example.com',
641
+ name: 'Test',
642
+ },
643
+ },
644
+ ],
645
+ services: {},
646
+ });
647
+
648
+ expect(requestId).toBeDefined();
649
+ expect(requestId).toMatch(/^test-/);
650
+ });
651
+ });
652
+ });
@@ -0,0 +1,6 @@
1
+ import { SubscriberBuilder } from './SubscriberBuilder';
2
+
3
+ export { Subscriber } from './Subscriber';
4
+ export { SubscriberBuilder };
5
+
6
+ export const s = new SubscriberBuilder();