@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,137 @@
1
+ import type { Service } from '@geekmidas/services';
2
+ import { describe, expect, it } from 'vitest';
3
+ import { z } from 'zod';
4
+ import { Queue } from '../Queue';
5
+ import { QueueBuilder } from '../QueueBuilder';
6
+ import { TestQueueAdaptor } from '../TestQueueAdaptor';
7
+
8
+ const schema = z.object({ orderId: z.string() });
9
+
10
+ const svc = (name: string): Service<string, object> => ({
11
+ serviceName: name,
12
+ async register() {
13
+ return {};
14
+ },
15
+ });
16
+
17
+ describe('QueueBuilder', () => {
18
+ it('builds a Queue from .queue().message().handle()', () => {
19
+ const handler = async () => {};
20
+ const queue = new QueueBuilder()
21
+ .queue('orders')
22
+ .message(schema)
23
+ .handle(handler);
24
+
25
+ expect(Queue.isQueue(queue)).toBe(true);
26
+ expect(queue.name).toBe('orders');
27
+ expect(queue.messageSchema).toBe(schema);
28
+ expect(queue.handler).toBe(handler);
29
+ expect(queue.services).toEqual([]);
30
+ });
31
+
32
+ it('collects services as an array', () => {
33
+ const a = svc('a');
34
+ const queue = new QueueBuilder()
35
+ .queue('jobs')
36
+ .services([a])
37
+ .message(schema)
38
+ .handle(async () => {});
39
+
40
+ expect(queue.services).toEqual([a]);
41
+ });
42
+
43
+ it('captures batchSize and fifo', () => {
44
+ const queue = new QueueBuilder()
45
+ .queue('orders')
46
+ .batchSize(5)
47
+ .fifo()
48
+ .message(schema)
49
+ .handle(async () => {});
50
+
51
+ expect(queue.batchSize).toBe(5);
52
+ expect(queue.fifo).toBe(true);
53
+ });
54
+
55
+ it('throws when the name is missing', () => {
56
+ expect(() =>
57
+ new QueueBuilder().message(schema).handle(async () => {}),
58
+ ).toThrow(/name/);
59
+ });
60
+
61
+ it('throws when the message schema is missing', () => {
62
+ const builder = new QueueBuilder().queue('x');
63
+ expect(() =>
64
+ (builder as QueueBuilder<'x', typeof schema>).handle(async () => {}),
65
+ ).toThrow(/message/);
66
+ });
67
+
68
+ it('resets builder state after handle', () => {
69
+ const builder = new QueueBuilder();
70
+ builder
71
+ .queue('first')
72
+ .services([svc('x')])
73
+ .message(schema)
74
+ .handle(async () => {});
75
+ // State cleared — a second handle with no name throws.
76
+ expect(() =>
77
+ (builder as QueueBuilder<string, typeof schema>).handle(async () => {}),
78
+ ).toThrow(/name/);
79
+ });
80
+ });
81
+
82
+ describe('Queue.publisher', () => {
83
+ it('exposes a `<name>Publisher` producer service', () => {
84
+ const queue = new QueueBuilder()
85
+ .queue('orders')
86
+ .message(schema)
87
+ .handle(async () => {});
88
+
89
+ expect(queue.publisher.serviceName).toBe('ordersPublisher');
90
+ });
91
+
92
+ it('requires the namespaced connection-string env var (sniffed into the manifest)', async () => {
93
+ const producer = new QueueBuilder()
94
+ .queue('orderEvents')
95
+ .message(schema)
96
+ .handle(async () => {});
97
+
98
+ // Inject the publisher into a construct's services so getEnvironment sniffs it.
99
+ const consumer = new QueueBuilder()
100
+ .queue('caller')
101
+ .services([producer.publisher])
102
+ .message(schema)
103
+ .handle(async () => {});
104
+
105
+ const env = await consumer.getEnvironment();
106
+ expect(env).toContain('ORDER_EVENTS_PUBLISHER_CONNECTION_STRING');
107
+ });
108
+ });
109
+
110
+ describe('TestQueueAdaptor', () => {
111
+ it('invokes the handler with the batch of messages and services', async () => {
112
+ const seen: { messages: unknown[]; hadDb: boolean }[] = [];
113
+ const db = svc('db');
114
+
115
+ const queue = new QueueBuilder()
116
+ .queue('orders')
117
+ .services([db])
118
+ .message(schema)
119
+ .handle(async ({ messages, services }) => {
120
+ seen.push({
121
+ messages,
122
+ hadDb: 'db' in (services as Record<string, unknown>),
123
+ });
124
+ return { processed: messages.length };
125
+ });
126
+
127
+ const adapter = new TestQueueAdaptor(queue);
128
+ const result = await adapter.invoke({
129
+ messages: [{ orderId: '1' }, { orderId: '2' }],
130
+ });
131
+
132
+ expect(result).toEqual({ processed: 2 });
133
+ expect(seen).toHaveLength(1);
134
+ expect(seen[0]?.messages).toEqual([{ orderId: '1' }, { orderId: '2' }]);
135
+ expect(seen[0]?.hadDb).toBe(true);
136
+ });
137
+ });
@@ -0,0 +1,12 @@
1
+ export {
2
+ Queue,
3
+ type QueueContext,
4
+ type QueueHandler,
5
+ type QueueMessage,
6
+ } from './Queue';
7
+
8
+ import { QueueBuilder } from './QueueBuilder';
9
+
10
+ export { QueueBuilder } from './QueueBuilder';
11
+
12
+ export const q = new QueueBuilder();
@@ -0,0 +1,342 @@
1
+ import type { EnvironmentParser } from '@geekmidas/envkit';
2
+ import { wrapError } from '@geekmidas/errors';
3
+ import type { EventPublisher } from '@geekmidas/events';
4
+ import type { Logger } from '@geekmidas/logger';
5
+ import type { InferStandardSchema } from '@geekmidas/schema';
6
+ import type { Service, ServiceRecord } from '@geekmidas/services';
7
+ import { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';
8
+ import middy, { type MiddlewareObj } from '@middy/core';
9
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
10
+ import type {
11
+ Context,
12
+ Handler,
13
+ SNSEvent,
14
+ SNSEventRecord,
15
+ SQSEvent,
16
+ SQSRecord,
17
+ } from 'aws-lambda';
18
+ import type { Subscriber } from './Subscriber';
19
+
20
+ export type AWSLambdaHandler<TEvent = any, TResult = any> = Handler<
21
+ TEvent,
22
+ TResult
23
+ >;
24
+
25
+ type SubscriberEvent<TServices extends Service[], TLogger extends Logger> = {
26
+ events: any[];
27
+ services: ServiceRecord<TServices>;
28
+ logger: TLogger;
29
+ };
30
+
31
+ type Middleware<
32
+ TServices extends Service[],
33
+ TLogger extends Logger,
34
+ TOutSchema extends StandardSchemaV1 | undefined,
35
+ > = MiddlewareObj<
36
+ SubscriberEvent<TServices, TLogger>,
37
+ InferStandardSchema<TOutSchema>,
38
+ Error,
39
+ Context
40
+ >;
41
+
42
+ export class AWSLambdaSubscriber<
43
+ TServices extends Service[] = [],
44
+ TLogger extends Logger = Logger,
45
+ OutSchema extends StandardSchemaV1 | undefined = undefined,
46
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
47
+ TEventPublisherServiceName extends string = string,
48
+ TSubscribedEvents extends any[] = [],
49
+ > {
50
+ private _logger!: TLogger;
51
+ private _services!: ServiceRecord<TServices>;
52
+
53
+ constructor(
54
+ private envParser: EnvironmentParser<{}>,
55
+ readonly subscriber: Subscriber<
56
+ TServices,
57
+ TLogger,
58
+ OutSchema,
59
+ TEventPublisher,
60
+ TEventPublisherServiceName,
61
+ TSubscribedEvents
62
+ >,
63
+ ) {
64
+ this._logger = subscriber.logger;
65
+ }
66
+
67
+ get logger(): TLogger {
68
+ return this._logger;
69
+ }
70
+
71
+ private async getServices(): Promise<ServiceRecord<TServices>> {
72
+ if (this._services) {
73
+ return this._services;
74
+ }
75
+
76
+ const serviceDiscovery = ServiceDiscovery.getInstance(this.envParser);
77
+
78
+ if (this.subscriber.services.length > 0) {
79
+ const registered = await serviceDiscovery.register(
80
+ this.subscriber.services,
81
+ );
82
+ this._services = registered as ServiceRecord<TServices>;
83
+ } else {
84
+ this._services = {} as ServiceRecord<TServices>;
85
+ }
86
+
87
+ return this._services;
88
+ }
89
+
90
+ private error(): Middleware<TServices, TLogger, OutSchema> {
91
+ return {
92
+ onError: (req) => {
93
+ const logger = req.event?.logger || this.subscriber.logger;
94
+ logger.error(req.error || {}, 'Error processing subscriber');
95
+
96
+ // Re-throw the wrapped error to let Lambda handle it
97
+ throw wrapError(req.error);
98
+ },
99
+ };
100
+ }
101
+
102
+ private loggerMiddleware(): Middleware<TServices, TLogger, OutSchema> {
103
+ return {
104
+ before: (req) => {
105
+ this._logger = this.subscriber.logger.child({
106
+ subscriber: {
107
+ name: req.context.functionName,
108
+ version: req.context.functionVersion,
109
+ memory: req.context.memoryLimitInMB,
110
+ },
111
+ req: {
112
+ id: req.context.awsRequestId,
113
+ },
114
+ }) as TLogger;
115
+
116
+ req.event.logger = this._logger;
117
+ },
118
+ };
119
+ }
120
+
121
+ private services(): Middleware<TServices, TLogger, OutSchema> {
122
+ return {
123
+ before: async (req) => {
124
+ req.event.services = await this.getServices();
125
+ },
126
+ };
127
+ }
128
+
129
+ private parseEvents(): Middleware<TServices, TLogger, OutSchema> {
130
+ return {
131
+ before: async (req) => {
132
+ const { logger, ...e } = req.event;
133
+ const rawEvent = e as any as SQSEvent | SNSEvent;
134
+
135
+ logger.info({
136
+ rawEvent,
137
+ });
138
+
139
+ // Parse events based on the event type
140
+ const events: any[] = [];
141
+
142
+ if ('Records' in rawEvent) {
143
+ if (this.isSQSEvent(rawEvent)) {
144
+ // SQS Event
145
+ for (const record of rawEvent.Records) {
146
+ try {
147
+ const event = this.parseSQSRecord(record);
148
+ if (this.shouldIncludeEvent(event)) {
149
+ events.push(event);
150
+ }
151
+ } catch (error) {
152
+ this.logger.error(
153
+ { error, record },
154
+ 'Failed to parse SQS record',
155
+ );
156
+ }
157
+ }
158
+ } else if (this.isSNSEvent(rawEvent)) {
159
+ // SNS Event
160
+ for (const record of rawEvent.Records) {
161
+ try {
162
+ const event = this.parseSNSRecord(record);
163
+ if (this.shouldIncludeEvent(event)) {
164
+ events.push(event);
165
+ }
166
+ } catch (error) {
167
+ this.logger.error(
168
+ { error, record },
169
+ 'Failed to parse SNS record',
170
+ );
171
+ }
172
+ }
173
+ }
174
+ }
175
+
176
+ (req.event as any).events = events;
177
+ },
178
+ };
179
+ }
180
+
181
+ private isSQSEvent(event: SQSEvent | SNSEvent): event is SQSEvent {
182
+ const firstRecord = event.Records[0];
183
+ return (
184
+ 'Records' in event &&
185
+ event.Records.length > 0 &&
186
+ firstRecord !== undefined &&
187
+ 'eventSource' in firstRecord &&
188
+ firstRecord.eventSource === 'aws:sqs'
189
+ );
190
+ }
191
+
192
+ private isSNSEvent(event: SQSEvent | SNSEvent): event is SNSEvent {
193
+ const firstRecord = event.Records[0];
194
+ return (
195
+ 'Records' in event &&
196
+ event.Records.length > 0 &&
197
+ firstRecord !== undefined &&
198
+ 'EventSource' in firstRecord &&
199
+ firstRecord.EventSource === 'aws:sns'
200
+ );
201
+ }
202
+
203
+ private parseSNSRecord(record: SNSEventRecord): any {
204
+ const message = this.safeJsonParse(record.Sns.Message);
205
+ const messageType = record.Sns.MessageAttributes?.type?.Value;
206
+
207
+ // Not JSON — wrap raw string with type from MessageAttributes if available
208
+ if (message === null) {
209
+ return messageType
210
+ ? { type: messageType, payload: record.Sns.Message }
211
+ : record.Sns.Message;
212
+ }
213
+
214
+ // Resolve type from MessageAttributes (preferred) or message body
215
+ const resolvedType = messageType ?? message.type;
216
+
217
+ if (message.type) {
218
+ return message; // Full event format: { type, payload }
219
+ }
220
+
221
+ // Payload-only format: type is in MessageAttributes
222
+ return resolvedType ? { type: resolvedType, payload: message } : message;
223
+ }
224
+
225
+ private parseSQSRecord(record: SQSRecord): any {
226
+ const body = this.safeJsonParse(record.body);
227
+
228
+ // Not JSON — return raw body as-is
229
+ if (body === null) {
230
+ return record.body;
231
+ }
232
+
233
+ // Check if this is an SNS message wrapped in SQS
234
+ if (body.Type === 'Notification' && body.Message) {
235
+ const snsMessage = this.safeJsonParse(body.Message);
236
+ const messageType = body.MessageAttributes?.type?.Value;
237
+
238
+ // SNS Message not JSON — wrap with type from MessageAttributes if available
239
+ if (snsMessage === null) {
240
+ return messageType
241
+ ? { type: messageType, payload: body.Message }
242
+ : body.Message;
243
+ }
244
+
245
+ if (snsMessage.type) {
246
+ return snsMessage; // Full event format: { type, payload }
247
+ }
248
+
249
+ // Payload-only format: type is in MessageAttributes
250
+ const resolvedType = messageType ?? snsMessage.type;
251
+ return resolvedType
252
+ ? { type: resolvedType, payload: snsMessage }
253
+ : snsMessage;
254
+ }
255
+
256
+ // Direct SQS message
257
+ return body;
258
+ }
259
+
260
+ private safeJsonParse(value: string): any | null {
261
+ try {
262
+ return JSON.parse(value);
263
+ } catch {
264
+ return null;
265
+ }
266
+ }
267
+
268
+ private shouldIncludeEvent(event: any): boolean {
269
+ // No event type (raw string/non-object) — always include
270
+ if (typeof event !== 'object' || !event?.type) {
271
+ return true;
272
+ }
273
+
274
+ // No filter configured — accept all
275
+ if (!this.subscriber.subscribedEvents) {
276
+ return true;
277
+ }
278
+
279
+ return this.subscriber.subscribedEvents.includes(event.type as any);
280
+ }
281
+
282
+ private async _handler(event: SubscriberEvent<TServices, TLogger>) {
283
+ // If no events after filtering, return early
284
+ if (event.events.length === 0) {
285
+ this.logger.info('No subscribed events to process');
286
+ return {
287
+ batchItemFailures: [],
288
+ };
289
+ }
290
+
291
+ // Execute the subscriber with the parsed context
292
+ const result = await this.subscriber.handler({
293
+ events: event.events,
294
+ services: event.services,
295
+ logger: event.logger,
296
+ });
297
+
298
+ // Parse output if schema is provided
299
+ if (this.subscriber.outputSchema && result) {
300
+ const validationResult =
301
+ await this.subscriber.outputSchema['~standard'].validate(result);
302
+
303
+ if (validationResult.issues) {
304
+ this.logger.error(
305
+ { issues: validationResult.issues },
306
+ 'Subscriber output validation failed',
307
+ );
308
+ throw new Error('Subscriber output validation failed');
309
+ }
310
+
311
+ return validationResult.value;
312
+ }
313
+
314
+ return result;
315
+ }
316
+
317
+ get handler(): AWSLambdaHandler {
318
+ const handler = this._handler.bind(this);
319
+
320
+ // Apply middleware in order
321
+ const chain = middy(handler)
322
+ .use(this.loggerMiddleware())
323
+ .use(this.parseEvents())
324
+ .use(this.error())
325
+ .use(this.services());
326
+
327
+ // Wrap entire Middy chain in request context for service access
328
+ const wrappedHandler = async (event: unknown, context: Context) => {
329
+ const startTime = Date.now();
330
+ const requestId = context.awsRequestId;
331
+ const logger = this.subscriber.logger.child({
332
+ requestId,
333
+ }) as TLogger;
334
+
335
+ return runWithRequestContext({ logger, requestId, startTime }, () =>
336
+ chain(event as Parameters<typeof chain>[0], context),
337
+ );
338
+ };
339
+
340
+ return wrappedHandler as unknown as AWSLambdaHandler;
341
+ }
342
+ }
@@ -0,0 +1,117 @@
1
+ import type {
2
+ EventPublisher,
3
+ ExtractPublisherMessage,
4
+ } from '@geekmidas/events';
5
+ import type { Logger } from '@geekmidas/logger';
6
+ import { ConsoleLogger } from '@geekmidas/logger/console';
7
+ import type { InferStandardSchema } from '@geekmidas/schema';
8
+ import type { Service, ServiceRecord } from '@geekmidas/services';
9
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
10
+ import { Construct, ConstructType } from '../Construct';
11
+
12
+ const DEFAULT_LOGGER = new ConsoleLogger() as any;
13
+
14
+ // Helper type to extract payload types for subscribed events
15
+ type ExtractEventPayloads<
16
+ TPublisher extends EventPublisher<any> | undefined,
17
+ TEventTypes extends any[],
18
+ > = TPublisher extends EventPublisher<any>
19
+ ? Extract<ExtractPublisherMessage<TPublisher>, { type: TEventTypes[number] }>
20
+ : never;
21
+
22
+ export class Subscriber<
23
+ TServices extends Service[] = [],
24
+ TLogger extends Logger = Logger,
25
+ OutSchema extends StandardSchemaV1 | undefined = undefined,
26
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
27
+ TEventPublisherServiceName extends string = string,
28
+ TSubscribedEvents extends
29
+ ExtractPublisherMessage<TEventPublisher>['type'][] = ExtractPublisherMessage<TEventPublisher>['type'][],
30
+ > extends Construct<
31
+ TLogger,
32
+ TEventPublisherServiceName,
33
+ TEventPublisher,
34
+ OutSchema,
35
+ TServices
36
+ > {
37
+ __IS_SUBSCRIBER__ = true;
38
+
39
+ static isSubscriber(
40
+ obj: any,
41
+ ): obj is Subscriber<any, any, any, any, any, any> {
42
+ return Boolean(
43
+ obj &&
44
+ obj.__IS_SUBSCRIBER__ === true &&
45
+ obj.type === ConstructType.Subscriber,
46
+ );
47
+ }
48
+
49
+ constructor(
50
+ public readonly handler: SubscriberHandler<
51
+ TEventPublisher,
52
+ TSubscribedEvents,
53
+ TServices,
54
+ TLogger,
55
+ OutSchema
56
+ >,
57
+ public override readonly timeout: number = 30000,
58
+ protected _subscribedEvents?: TSubscribedEvents,
59
+ public override readonly outputSchema?: OutSchema,
60
+ public override readonly services: TServices = [] as unknown as TServices,
61
+ public override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,
62
+ public override readonly publisherService?: Service<
63
+ TEventPublisherServiceName,
64
+ TEventPublisher
65
+ >,
66
+ /**
67
+ * The name of the {@link Topic} this subscriber binds to (via
68
+ * `s.topic(topic)`), recorded for the manifest so infra wires the SNS
69
+ * subscription. Undefined when the subscriber's events are typed from a
70
+ * (hand-written) publisher instead.
71
+ */
72
+ public readonly topicName?: string,
73
+ ) {
74
+ super(
75
+ ConstructType.Subscriber,
76
+ logger,
77
+ services,
78
+ [],
79
+ publisherService,
80
+ outputSchema,
81
+ );
82
+ }
83
+
84
+ get subscribedEvents(): TSubscribedEvents | undefined {
85
+ return this._subscribedEvents;
86
+ }
87
+ }
88
+
89
+ // Handler type for subscribers that receives an array of events
90
+ export type SubscriberHandler<
91
+ TEventPublisher extends EventPublisher<any> | undefined,
92
+ TSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],
93
+ TServices extends Service[] = [],
94
+ TLogger extends Logger = Logger,
95
+ OutSchema extends StandardSchemaV1 | undefined = undefined,
96
+ > = (
97
+ ctx: SubscriberContext<
98
+ TEventPublisher,
99
+ TSubscribedEvents,
100
+ TServices,
101
+ TLogger
102
+ >,
103
+ ) => OutSchema extends StandardSchemaV1
104
+ ? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>>
105
+ : any | Promise<any>;
106
+
107
+ // Context type for subscriber handlers
108
+ export type SubscriberContext<
109
+ TEventPublisher extends EventPublisher<any> | undefined,
110
+ TSubscribedEvents extends ExtractPublisherMessage<TEventPublisher>['type'][],
111
+ TServices extends Service[] = [],
112
+ TLogger extends Logger = Logger,
113
+ > = {
114
+ events: ExtractEventPayloads<TEventPublisher, TSubscribedEvents>[];
115
+ services: ServiceRecord<TServices>;
116
+ logger: TLogger;
117
+ };