@geekmidas/constructs 10.0.0-alpha.99 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (533) hide show
  1. package/CHANGELOG.md +437 -0
  2. package/README.md +193 -285
  3. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
  4. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
  5. package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
  6. package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
  7. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
  8. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
  9. package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
  10. package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
  11. package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
  12. package/dist/Construct-BWF5HxaM.mjs.map +1 -0
  13. package/dist/Construct-JlyQkBkv.d.cts +117 -0
  14. package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
  15. package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
  16. package/dist/Construct-TGIM_E4o.cjs.map +1 -0
  17. package/dist/Construct-pxwC6fDD.d.mts +117 -0
  18. package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
  19. package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
  20. package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
  21. package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
  22. package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
  23. package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
  24. package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
  25. package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
  26. package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
  27. package/dist/Queue-BL68oDJ-.d.mts +66 -0
  28. package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
  29. package/dist/Queue-DxJ6btRE.d.cts +66 -0
  30. package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
  31. package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
  32. package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
  33. package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
  34. package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
  35. package/dist/Topic-DJXoDeMP.d.cts +60 -0
  36. package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
  37. package/dist/Topic-DxWQBgMN.d.mts +60 -0
  38. package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
  39. package/dist/adaptors/aws.cjs +205 -355
  40. package/dist/adaptors/aws.cjs.map +1 -1
  41. package/dist/adaptors/aws.d.cts +48 -126
  42. package/dist/adaptors/aws.d.cts.map +1 -1
  43. package/dist/adaptors/aws.d.mts +49 -127
  44. package/dist/adaptors/aws.d.mts.map +1 -1
  45. package/dist/adaptors/aws.mjs +178 -325
  46. package/dist/adaptors/aws.mjs.map +1 -1
  47. package/dist/adaptors/hono.cjs +9 -3
  48. package/dist/adaptors/hono.d.cts +15 -7
  49. package/dist/adaptors/hono.d.cts.map +1 -1
  50. package/dist/adaptors/hono.d.mts +17 -9
  51. package/dist/adaptors/hono.d.mts.map +1 -1
  52. package/dist/adaptors/hono.mjs +9 -2
  53. package/dist/adaptors/testing.cjs +209 -831
  54. package/dist/adaptors/testing.cjs.map +1 -1
  55. package/dist/adaptors/testing.d.cts +55 -351
  56. package/dist/adaptors/testing.d.cts.map +1 -1
  57. package/dist/adaptors/testing.d.mts +53 -349
  58. package/dist/adaptors/testing.d.mts.map +1 -1
  59. package/dist/adaptors/testing.mjs +195 -798
  60. package/dist/adaptors/testing.mjs.map +1 -1
  61. package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
  62. package/dist/clone-I_WIpiFf.cjs.map +1 -0
  63. package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
  64. package/dist/clone-pdXxc0t3.mjs.map +1 -0
  65. package/dist/crons/index.cjs +66 -190
  66. package/dist/crons/index.cjs.map +1 -1
  67. package/dist/crons/index.d.cts +35 -70
  68. package/dist/crons/index.d.cts.map +1 -1
  69. package/dist/crons/index.d.mts +32 -70
  70. package/dist/crons/index.d.mts.map +1 -1
  71. package/dist/crons/index.mjs +63 -184
  72. package/dist/crons/index.mjs.map +1 -1
  73. package/dist/endpoints/index.cjs +761 -19
  74. package/dist/endpoints/index.cjs.map +1 -0
  75. package/dist/endpoints/index.d.cts +322 -22
  76. package/dist/endpoints/index.d.cts.map +1 -1
  77. package/dist/endpoints/index.d.mts +321 -22
  78. package/dist/endpoints/index.d.mts.map +1 -1
  79. package/dist/endpoints/index.mjs +751 -6
  80. package/dist/endpoints/index.mjs.map +1 -0
  81. package/dist/functions/index.cjs +5 -2
  82. package/dist/functions/index.d.cts +3 -3
  83. package/dist/functions/index.d.mts +3 -3
  84. package/dist/functions/index.mjs +5 -2
  85. package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
  86. package/dist/functions-EqTloHjo.mjs.map +1 -0
  87. package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
  88. package/dist/functions-SqtCDc9c.cjs.map +1 -0
  89. package/dist/index-C7iynzLI.d.mts +139 -0
  90. package/dist/index-C7iynzLI.d.mts.map +1 -0
  91. package/dist/index-D4dM_WDY.d.cts +142 -0
  92. package/dist/index-D4dM_WDY.d.cts.map +1 -0
  93. package/dist/index.cjs +3 -6
  94. package/dist/index.d.cts +4 -27
  95. package/dist/index.d.mts +4 -27
  96. package/dist/index.mjs +3 -3
  97. package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
  98. package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
  99. package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
  100. package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
  101. package/dist/monitors/index.cjs +49 -0
  102. package/dist/monitors/index.cjs.map +1 -0
  103. package/dist/monitors/index.d.cts +45 -0
  104. package/dist/monitors/index.d.cts.map +1 -0
  105. package/dist/monitors/index.d.mts +45 -0
  106. package/dist/monitors/index.d.mts.map +1 -0
  107. package/dist/monitors/index.mjs +48 -0
  108. package/dist/monitors/index.mjs.map +1 -0
  109. package/dist/processAudits-BJZT5gmy.cjs +92 -0
  110. package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
  111. package/dist/processAudits-CwyaaSQc.mjs +80 -0
  112. package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
  113. package/dist/publisher-BZgcrVPy.cjs +53 -0
  114. package/dist/publisher-BZgcrVPy.cjs.map +1 -0
  115. package/dist/publisher-CnpeMv-r.mjs +41 -0
  116. package/dist/publisher-CnpeMv-r.mjs.map +1 -0
  117. package/dist/queue/index.cjs +114 -6
  118. package/dist/queue/index.cjs.map +1 -0
  119. package/dist/queue/index.d.cts +45 -3
  120. package/dist/queue/index.d.cts.map +1 -0
  121. package/dist/queue/index.d.mts +44 -3
  122. package/dist/queue/index.d.mts.map +1 -0
  123. package/dist/queue/index.mjs +112 -3
  124. package/dist/queue/index.mjs.map +1 -0
  125. package/dist/subscribers/index.cjs +80 -111
  126. package/dist/subscribers/index.cjs.map +1 -1
  127. package/dist/subscribers/index.d.cts +43 -46
  128. package/dist/subscribers/index.d.cts.map +1 -1
  129. package/dist/subscribers/index.d.mts +42 -46
  130. package/dist/subscribers/index.d.mts.map +1 -1
  131. package/dist/subscribers/index.mjs +78 -108
  132. package/dist/subscribers/index.mjs.map +1 -1
  133. package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
  134. package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
  135. package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
  136. package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
  137. package/dist/topic/index.cjs +91 -3
  138. package/dist/topic/index.cjs.map +1 -0
  139. package/dist/topic/index.d.cts +32 -2
  140. package/dist/topic/index.d.cts.map +1 -0
  141. package/dist/topic/index.d.mts +32 -2
  142. package/dist/topic/index.d.mts.map +1 -0
  143. package/dist/topic/index.mjs +89 -2
  144. package/dist/topic/index.mjs.map +1 -0
  145. package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
  146. package/dist/types-BdAaYDvd.d.cts.map +1 -0
  147. package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
  148. package/dist/types-DNngH0fX.d.mts.map +1 -0
  149. package/dist/types.d.cts +1 -1
  150. package/dist/types.d.mts +1 -1
  151. package/dist/types.mjs +0 -1
  152. package/package.json +55 -223
  153. package/src/Construct.ts +209 -0
  154. package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
  155. package/src/__benchmarks__/endpoint.bench.ts +494 -0
  156. package/src/__benchmarks__/fixtures.ts +241 -0
  157. package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
  158. package/src/__benchmarks__/hono-server.bench.ts +249 -0
  159. package/src/__benchmarks__/response-builder.bench.ts +428 -0
  160. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
  161. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
  162. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
  163. package/src/__tests__/Construct.environment.spec.ts +704 -0
  164. package/src/__tests__/builder-reuse.spec.ts +587 -0
  165. package/src/__tests__/monitor.spec.ts +636 -0
  166. package/src/__tests__/publisher.setting.spec.ts +508 -0
  167. package/src/__tests__/publisher.spec.ts +452 -0
  168. package/src/adaptors/aws.ts +6 -0
  169. package/src/adaptors/hono.ts +1 -0
  170. package/src/adaptors/testing.ts +11 -0
  171. package/src/clone.ts +38 -0
  172. package/src/crons/AWSScheduledFunction.ts +73 -0
  173. package/src/crons/Cron.ts +149 -0
  174. package/src/crons/CronBuilder.ts +261 -0
  175. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
  176. package/src/crons/__tests__/Cron.spec.ts +472 -0
  177. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
  178. package/src/crons/index.ts +12 -0
  179. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
  180. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
  181. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
  182. package/src/endpoints/Authorizer.ts +152 -0
  183. package/src/endpoints/Endpoint.ts +1287 -0
  184. package/src/endpoints/EndpointBuilder.ts +749 -0
  185. package/src/endpoints/EndpointFactory.ts +1179 -0
  186. package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
  187. package/src/endpoints/MswEndpointAdaptor.ts +226 -0
  188. package/src/endpoints/TestEndpointAdaptor.ts +466 -0
  189. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
  190. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
  191. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
  192. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
  193. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
  194. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
  195. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
  196. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
  197. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
  198. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
  199. package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
  200. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
  201. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
  202. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
  203. package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
  204. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
  205. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
  206. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
  207. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
  208. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
  209. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
  210. package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
  211. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
  212. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
  213. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
  214. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
  215. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
  216. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
  217. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
  218. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
  219. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
  220. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
  221. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
  222. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
  223. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
  224. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
  225. package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
  226. package/src/endpoints/__tests__/helpers.spec.ts +37 -0
  227. package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
  228. package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
  229. package/src/endpoints/audit.ts +87 -0
  230. package/src/endpoints/helpers.ts +98 -0
  231. package/src/endpoints/index.ts +42 -0
  232. package/src/endpoints/lazyAccessors.ts +241 -0
  233. package/src/endpoints/parseHonoQuery.ts +16 -0
  234. package/src/endpoints/parseQueryParams.ts +32 -0
  235. package/src/endpoints/processAudits.ts +371 -0
  236. package/src/endpoints/rls.ts +67 -0
  237. package/src/functions/AWSLambdaFunction.ts +374 -0
  238. package/src/functions/BaseFunctionBuilder.ts +212 -0
  239. package/src/functions/Function.ts +238 -0
  240. package/src/functions/FunctionBuilder.ts +381 -0
  241. package/src/functions/FunctionExecutionWrapper.ts +216 -0
  242. package/src/functions/TestFunctionAdaptor.ts +252 -0
  243. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
  244. package/src/functions/__tests__/Function.audits.spec.ts +393 -0
  245. package/src/functions/__tests__/Function.spec.ts +477 -0
  246. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
  247. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
  248. package/src/functions/index.ts +12 -0
  249. package/src/index.ts +29 -0
  250. package/src/monitor.ts +145 -0
  251. package/src/monitors/heartbeat.ts +86 -0
  252. package/src/monitors/index.ts +6 -0
  253. package/src/publisher.ts +93 -0
  254. package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
  255. package/src/queue/Queue.ts +128 -0
  256. package/src/queue/QueueBuilder.ts +115 -0
  257. package/src/queue/TestQueueAdaptor.ts +63 -0
  258. package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
  259. package/src/queue/index.ts +12 -0
  260. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
  261. package/src/subscribers/Subscriber.ts +117 -0
  262. package/src/subscribers/SubscriberBuilder.ts +183 -0
  263. package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
  264. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
  265. package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
  266. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
  267. package/src/subscribers/index.ts +6 -0
  268. package/src/telemetry.ts +103 -0
  269. package/src/topic/Topic.ts +103 -0
  270. package/src/topic/TopicBuilder.ts +53 -0
  271. package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
  272. package/src/topic/index.ts +11 -0
  273. package/src/types.ts +13 -0
  274. package/test.ts +91 -0
  275. package/tsconfig.json +9 -0
  276. package/tsdown.config.ts +35 -0
  277. package/dist/Construct-B1vGBPme.mjs.map +0 -1
  278. package/dist/Construct-BQALFCh2.d.cts +0 -230
  279. package/dist/Construct-BQALFCh2.d.cts.map +0 -1
  280. package/dist/Construct-DUSXuTHP.cjs.map +0 -1
  281. package/dist/Construct-QXnl3VqT.d.mts +0 -230
  282. package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
  283. package/dist/Cron-DI3nKoic.d.cts +0 -45
  284. package/dist/Cron-DI3nKoic.d.cts.map +0 -1
  285. package/dist/Cron-uYAHPnp7.d.mts +0 -45
  286. package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
  287. package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
  288. package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
  289. package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
  290. package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
  291. package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
  292. package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
  293. package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
  294. package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
  295. package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
  296. package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
  297. package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
  298. package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
  299. package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
  300. package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
  301. package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
  302. package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
  303. package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
  304. package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
  305. package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
  306. package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
  307. package/dist/Function-DuqGcbOI.d.mts +0 -76
  308. package/dist/Function-DuqGcbOI.d.mts.map +0 -1
  309. package/dist/Function-Pu-1kKZz.d.cts +0 -76
  310. package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
  311. package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
  312. package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
  313. package/dist/Queue-A3wfD0it.cjs +0 -109
  314. package/dist/Queue-A3wfD0it.cjs.map +0 -1
  315. package/dist/Queue-D6USGS4q.mjs +0 -104
  316. package/dist/Queue-D6USGS4q.mjs.map +0 -1
  317. package/dist/Queue-DlsHRzUp.d.mts +0 -105
  318. package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
  319. package/dist/Queue-HPyi0e1i.d.cts +0 -105
  320. package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
  321. package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
  322. package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
  323. package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
  324. package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
  325. package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
  326. package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
  327. package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
  328. package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
  329. package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
  330. package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
  331. package/dist/Subscriber-CtN9R48-.d.mts +0 -61
  332. package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
  333. package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
  334. package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
  335. package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
  336. package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
  337. package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
  338. package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
  339. package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
  340. package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
  341. package/dist/Topic-D74b5cgs.mjs +0 -99
  342. package/dist/Topic-D74b5cgs.mjs.map +0 -1
  343. package/dist/Topic-GHxcU8AG.cjs +0 -104
  344. package/dist/Topic-GHxcU8AG.cjs.map +0 -1
  345. package/dist/auth-BMCJN30Y.d.cts +0 -268
  346. package/dist/auth-BMCJN30Y.d.cts.map +0 -1
  347. package/dist/auth-CcuceLYo.d.mts +0 -268
  348. package/dist/auth-CcuceLYo.d.mts.map +0 -1
  349. package/dist/auth.cjs +0 -433
  350. package/dist/auth.cjs.map +0 -1
  351. package/dist/auth.d.cts +0 -2
  352. package/dist/auth.d.mts +0 -2
  353. package/dist/auth.mjs +0 -426
  354. package/dist/auth.mjs.map +0 -1
  355. package/dist/cache-CXh6GIgb.d.mts +0 -44
  356. package/dist/cache-CXh6GIgb.d.mts.map +0 -1
  357. package/dist/cache-DnGDGly3.d.cts +0 -44
  358. package/dist/cache-DnGDGly3.d.cts.map +0 -1
  359. package/dist/cache.cjs +0 -69
  360. package/dist/cache.cjs.map +0 -1
  361. package/dist/cache.d.cts +0 -2
  362. package/dist/cache.d.mts +0 -2
  363. package/dist/cache.mjs +0 -68
  364. package/dist/cache.mjs.map +0 -1
  365. package/dist/cipher-C1lEFX63.mjs +0 -225
  366. package/dist/cipher-C1lEFX63.mjs.map +0 -1
  367. package/dist/cipher-CVxfwLjk.cjs +0 -332
  368. package/dist/cipher-CVxfwLjk.cjs.map +0 -1
  369. package/dist/clone-EKNovYHu.mjs.map +0 -1
  370. package/dist/clone-UGJpvQnL.cjs.map +0 -1
  371. package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
  372. package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
  373. package/dist/construct-interface-DluK3_da.d.mts +0 -162
  374. package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
  375. package/dist/construct-interface.cjs +0 -114
  376. package/dist/construct-interface.cjs.map +0 -1
  377. package/dist/construct-interface.d.cts +0 -2
  378. package/dist/construct-interface.d.mts +0 -2
  379. package/dist/construct-interface.mjs +0 -107
  380. package/dist/construct-interface.mjs.map +0 -1
  381. package/dist/credential.cjs +0 -156
  382. package/dist/credential.cjs.map +0 -1
  383. package/dist/credential.d.cts +0 -86
  384. package/dist/credential.d.cts.map +0 -1
  385. package/dist/credential.d.mts +0 -86
  386. package/dist/credential.d.mts.map +0 -1
  387. package/dist/credential.mjs +0 -152
  388. package/dist/credential.mjs.map +0 -1
  389. package/dist/database/kysely.cjs +0 -4
  390. package/dist/database/kysely.d.cts +0 -2
  391. package/dist/database/kysely.d.mts +0 -2
  392. package/dist/database/kysely.mjs +0 -2
  393. package/dist/email.cjs +0 -72
  394. package/dist/email.cjs.map +0 -1
  395. package/dist/email.d.cts +0 -46
  396. package/dist/email.d.cts.map +0 -1
  397. package/dist/email.d.mts +0 -46
  398. package/dist/email.d.mts.map +0 -1
  399. package/dist/email.mjs +0 -71
  400. package/dist/email.mjs.map +0 -1
  401. package/dist/encryption.cjs +0 -96
  402. package/dist/encryption.cjs.map +0 -1
  403. package/dist/encryption.d.cts +0 -117
  404. package/dist/encryption.d.cts.map +0 -1
  405. package/dist/encryption.d.mts +0 -117
  406. package/dist/encryption.d.mts.map +0 -1
  407. package/dist/encryption.mjs +0 -83
  408. package/dist/encryption.mjs.map +0 -1
  409. package/dist/external-api-MJ8id87V.d.mts +0 -105
  410. package/dist/external-api-MJ8id87V.d.mts.map +0 -1
  411. package/dist/external-api-O107yzZJ.d.cts +0 -105
  412. package/dist/external-api-O107yzZJ.d.cts.map +0 -1
  413. package/dist/external-api.cjs +0 -142
  414. package/dist/external-api.cjs.map +0 -1
  415. package/dist/external-api.d.cts +0 -2
  416. package/dist/external-api.d.mts +0 -2
  417. package/dist/external-api.mjs +0 -139
  418. package/dist/external-api.mjs.map +0 -1
  419. package/dist/file-server.cjs +0 -186
  420. package/dist/file-server.cjs.map +0 -1
  421. package/dist/file-server.d.cts +0 -152
  422. package/dist/file-server.d.cts.map +0 -1
  423. package/dist/file-server.d.mts +0 -152
  424. package/dist/file-server.d.mts.map +0 -1
  425. package/dist/file-server.mjs +0 -184
  426. package/dist/file-server.mjs.map +0 -1
  427. package/dist/functions-BFizikJU.mjs.map +0 -1
  428. package/dist/functions-CfzJG9hK.cjs.map +0 -1
  429. package/dist/index-BuzRvKOQ.d.cts +0 -115
  430. package/dist/index-BuzRvKOQ.d.cts.map +0 -1
  431. package/dist/index-CTkKOer4.d.mts +0 -115
  432. package/dist/index-CTkKOer4.d.mts.map +0 -1
  433. package/dist/index-CeEtxDmK.d.cts +0 -79
  434. package/dist/index-CeEtxDmK.d.cts.map +0 -1
  435. package/dist/index-CeEtxDmK.d.mts +0 -79
  436. package/dist/index-CeEtxDmK.d.mts.map +0 -1
  437. package/dist/index.d.cts.map +0 -1
  438. package/dist/index.d.mts.map +0 -1
  439. package/dist/kms-B-Hm3d5r.cjs +0 -85
  440. package/dist/kms-B-Hm3d5r.cjs.map +0 -1
  441. package/dist/kms-BdUlMJEZ.mjs +0 -85
  442. package/dist/kms-BdUlMJEZ.mjs.map +0 -1
  443. package/dist/kysely-Bii4l6eP.mjs +0 -370
  444. package/dist/kysely-Bii4l6eP.mjs.map +0 -1
  445. package/dist/kysely-CO_Dk43W.cjs +0 -383
  446. package/dist/kysely-CO_Dk43W.cjs.map +0 -1
  447. package/dist/kysely-D0bpzgPs.d.cts +0 -175
  448. package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
  449. package/dist/kysely-DUqC3Ie0.d.mts +0 -175
  450. package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
  451. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
  452. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
  453. package/dist/lazyAccessors-CFanua0O.mjs +0 -174
  454. package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
  455. package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
  456. package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
  457. package/dist/mobile-app.cjs +0 -73
  458. package/dist/mobile-app.cjs.map +0 -1
  459. package/dist/mobile-app.d.cts +0 -61
  460. package/dist/mobile-app.d.cts.map +0 -1
  461. package/dist/mobile-app.d.mts +0 -61
  462. package/dist/mobile-app.d.mts.map +0 -1
  463. package/dist/mobile-app.mjs +0 -72
  464. package/dist/mobile-app.mjs.map +0 -1
  465. package/dist/object-storage.cjs +0 -56
  466. package/dist/object-storage.cjs.map +0 -1
  467. package/dist/object-storage.d.cts +0 -32
  468. package/dist/object-storage.d.cts.map +0 -1
  469. package/dist/object-storage.d.mts +0 -32
  470. package/dist/object-storage.d.mts.map +0 -1
  471. package/dist/object-storage.mjs +0 -55
  472. package/dist/object-storage.mjs.map +0 -1
  473. package/dist/processAudits-BRRVVHUB.mjs +0 -131
  474. package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
  475. package/dist/processAudits-DasOZjPl.cjs +0 -154
  476. package/dist/processAudits-DasOZjPl.cjs.map +0 -1
  477. package/dist/rest-api.cjs +0 -216
  478. package/dist/rest-api.cjs.map +0 -1
  479. package/dist/rest-api.d.cts +0 -241
  480. package/dist/rest-api.d.cts.map +0 -1
  481. package/dist/rest-api.d.mts +0 -241
  482. package/dist/rest-api.d.mts.map +0 -1
  483. package/dist/rest-api.mjs +0 -215
  484. package/dist/rest-api.mjs.map +0 -1
  485. package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
  486. package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
  487. package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
  488. package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
  489. package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
  490. package/dist/shutdown-BMJmAhSt.cjs +0 -38
  491. package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
  492. package/dist/shutdown-C7xa8x9S.mjs +0 -27
  493. package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
  494. package/dist/site.cjs +0 -74
  495. package/dist/site.cjs.map +0 -1
  496. package/dist/site.d.cts +0 -104
  497. package/dist/site.d.cts.map +0 -1
  498. package/dist/site.d.mts +0 -104
  499. package/dist/site.d.mts.map +0 -1
  500. package/dist/site.mjs +0 -73
  501. package/dist/site.mjs.map +0 -1
  502. package/dist/stages-BSCF19o2.d.cts +0 -56
  503. package/dist/stages-BSCF19o2.d.cts.map +0 -1
  504. package/dist/stages-BSCF19o2.d.mts +0 -56
  505. package/dist/stages-BSCF19o2.d.mts.map +0 -1
  506. package/dist/surfaceEnv-CNimK76p.cjs +0 -56
  507. package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
  508. package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
  509. package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
  510. package/dist/telemetry-B48RLjyk.d.cts +0 -40
  511. package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
  512. package/dist/telemetry-DRtT1_0A.d.mts +0 -40
  513. package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
  514. package/dist/telemetry.cjs +0 -56
  515. package/dist/telemetry.cjs.map +0 -1
  516. package/dist/telemetry.d.cts +0 -2
  517. package/dist/telemetry.d.mts +0 -2
  518. package/dist/telemetry.mjs +0 -55
  519. package/dist/telemetry.mjs.map +0 -1
  520. package/dist/tracing-CxaZ98IB.mjs +0 -110
  521. package/dist/tracing-CxaZ98IB.mjs.map +0 -1
  522. package/dist/tracing-DPMidF_r.cjs +0 -127
  523. package/dist/tracing-DPMidF_r.cjs.map +0 -1
  524. package/dist/types-DMuSQeLL.d.cts.map +0 -1
  525. package/dist/types-DMuSQeLL.d.mts.map +0 -1
  526. package/dist/worker.cjs +0 -191
  527. package/dist/worker.cjs.map +0 -1
  528. package/dist/worker.d.cts +0 -171
  529. package/dist/worker.d.cts.map +0 -1
  530. package/dist/worker.d.mts +0 -171
  531. package/dist/worker.d.mts.map +0 -1
  532. package/dist/worker.mjs +0 -190
  533. package/dist/worker.mjs.map +0 -1
@@ -0,0 +1,86 @@
1
+ import type { Service } from '@geekmidas/services';
2
+ import type { ConstructMonitor } from '../monitor';
3
+
4
+ export interface HeartbeatOptions {
5
+ /**
6
+ * The environment variable holding the heartbeat URL. When it is unset the
7
+ * monitor does nothing, so only the stages that set it are monitored.
8
+ * @default 'HEARTBEAT_URL'
9
+ */
10
+ env?: string;
11
+ /** The URL to request when a run starts. Omit for providers without one. */
12
+ start?: (url: string) => string;
13
+ /** The URL to request when a run succeeds. @default the URL itself */
14
+ success?: (url: string) => string;
15
+ /**
16
+ * The URL to request when a run fails. Omit to send nothing, and let the
17
+ * provider alert on the missed success ping instead.
18
+ */
19
+ failure?: (url: string) => string;
20
+ /** Milliseconds to wait for the provider. @default 3000 */
21
+ timeout?: number;
22
+ }
23
+
24
+ /**
25
+ * A monitor that pings a URL when a run succeeds, and optionally when it
26
+ * starts or fails — the shape most heartbeat and cron-monitoring services
27
+ * share.
28
+ *
29
+ * @example
30
+ * ```typescript
31
+ * cron
32
+ * .schedule('rate(1 day)')
33
+ * .monitor(heartbeat.betterStack())
34
+ * .handle(async () => {});
35
+ * ```
36
+ */
37
+ export function heartbeat(
38
+ options: HeartbeatOptions = {},
39
+ ): Service<`heartbeat:${string}`, ConstructMonitor> {
40
+ const {
41
+ env = 'HEARTBEAT_URL',
42
+ start,
43
+ success = (url) => url,
44
+ failure,
45
+ timeout = 3000,
46
+ } = options;
47
+
48
+ return {
49
+ serviceName: `heartbeat:${env}`,
50
+ async register({ envParser }) {
51
+ const { url } = envParser
52
+ .create((get) => ({ url: get(env).string().optional() }))
53
+ .parse();
54
+
55
+ const ping = async (target?: (url: string) => string) => {
56
+ if (!url || !target) {
57
+ return;
58
+ }
59
+ const response = await fetch(target(url), {
60
+ signal: AbortSignal.timeout(timeout),
61
+ });
62
+ if (!response.ok) {
63
+ throw new Error(`Heartbeat responded with ${response.status}`);
64
+ }
65
+ };
66
+
67
+ return {
68
+ start: () => ping(start),
69
+ success: () => ping(success),
70
+ failure: () => ping(failure),
71
+ };
72
+ },
73
+ };
74
+ }
75
+
76
+ /** Better Stack heartbeats: `{url}` on success, `{url}/fail` on failure. */
77
+ heartbeat.betterStack = (env?: string) =>
78
+ heartbeat({ env, failure: (url) => `${url}/fail` });
79
+
80
+ /** Healthchecks.io: `{url}/start`, `{url}` and `{url}/fail`. */
81
+ heartbeat.healthchecks = (env?: string) =>
82
+ heartbeat({
83
+ env,
84
+ start: (url) => `${url}/start`,
85
+ failure: (url) => `${url}/fail`,
86
+ });
@@ -0,0 +1,6 @@
1
+ export type {
2
+ ConstructMonitor,
3
+ MonitorContext,
4
+ MonitorService,
5
+ } from '../monitor';
6
+ export { type HeartbeatOptions, heartbeat } from './heartbeat';
@@ -0,0 +1,93 @@
1
+ import type { AuditStorage } from '@geekmidas/audit';
2
+ import type { EventPublisher, MappedEvent } from '@geekmidas/events';
3
+ import type { Logger } from '@geekmidas/logger';
4
+ import type { InferStandardSchema } from '@geekmidas/schema';
5
+ import type { Service, ServiceDiscovery } from '@geekmidas/services';
6
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
7
+ import type { Construct } from './Construct';
8
+
9
+ export async function publishEvents<
10
+ T extends EventPublisher<any> | undefined,
11
+ OutSchema extends StandardSchemaV1 | undefined = undefined,
12
+ TServiceName extends string = string,
13
+ TPublisherService extends Service<TServiceName, T> | undefined = undefined,
14
+ >(
15
+ logger: Logger,
16
+ serviceDiscovery: ServiceDiscovery<any>,
17
+ ev: MappedEvent<T, OutSchema>[] = [],
18
+ response: InferStandardSchema<OutSchema>,
19
+ publisherService: TPublisherService,
20
+ ) {
21
+ try {
22
+ if (!ev?.length) {
23
+ logger.debug('No events to publish');
24
+ return;
25
+ }
26
+ if (!publisherService) {
27
+ logger.warn('No publisher service available');
28
+ return;
29
+ }
30
+
31
+ const services = await serviceDiscovery.register([publisherService]);
32
+
33
+ const publisher = services[
34
+ publisherService.serviceName
35
+ ] as EventPublisher<any>;
36
+
37
+ const events: MappedEvent<T, OutSchema>[] = [];
38
+
39
+ for (const { when, payload, type, ...e } of ev) {
40
+ logger.debug({ event: type }, 'Processing event');
41
+ const resolvedPayload = await payload(response);
42
+ const event = {
43
+ ...e,
44
+ type,
45
+ payload: resolvedPayload,
46
+ };
47
+
48
+ if (!when || when(response as any)) {
49
+ events.push(event);
50
+ }
51
+ }
52
+
53
+ if (events.length) {
54
+ logger.debug({ eventCount: ev.length }, 'Publishing events');
55
+
56
+ await publisher.publish(events).catch((err) => {
57
+ logger.error(err, 'Failed to publish events');
58
+ });
59
+ }
60
+ } catch (error) {
61
+ logger.error(error as any, 'Something went wrong publishing events');
62
+ }
63
+ }
64
+
65
+ export async function publishConstructEvents<
66
+ T extends EventPublisher<any> | undefined,
67
+ OutSchema extends StandardSchemaV1 | undefined = undefined,
68
+ TServiceName extends string = string,
69
+ TServices extends Service[] = [],
70
+ TAuditStorageServiceName extends string = string,
71
+ TAuditStorage extends AuditStorage | undefined = undefined,
72
+ >(
73
+ construct: Construct<
74
+ Logger,
75
+ TServiceName,
76
+ T,
77
+ OutSchema,
78
+ TServices,
79
+ TAuditStorageServiceName,
80
+ TAuditStorage
81
+ >,
82
+ response: InferStandardSchema<OutSchema>,
83
+ serviceDiscovery: ServiceDiscovery<any>,
84
+ logger: Logger = construct.logger,
85
+ ) {
86
+ return publishEvents(
87
+ logger,
88
+ serviceDiscovery,
89
+ construct.events,
90
+ response,
91
+ construct.publisherService,
92
+ );
93
+ }
@@ -0,0 +1,162 @@
1
+ import type { EnvironmentParser } from '@geekmidas/envkit';
2
+ import { wrapError } from '@geekmidas/errors';
3
+ import type { Logger } from '@geekmidas/logger';
4
+ import type { InferStandardSchema } from '@geekmidas/schema';
5
+ import type { Service, ServiceRecord } from '@geekmidas/services';
6
+ import { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';
7
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
8
+ import type {
9
+ Context,
10
+ Handler,
11
+ SQSBatchResponse,
12
+ SQSEvent,
13
+ SQSRecord,
14
+ } from 'aws-lambda';
15
+ import type { Queue } from './Queue';
16
+
17
+ export type AWSLambdaHandler<TEvent = any, TResult = any> = Handler<
18
+ TEvent,
19
+ TResult
20
+ >;
21
+
22
+ /**
23
+ * Runs a {@link Queue} worker as an AWS Lambda backed by an SQS event-source
24
+ * mapping. Unlike a subscriber, a queue drains *every* record (no type filter):
25
+ * each record body (`{ type, payload }`, as written by the SQS publisher) is
26
+ * unwrapped to its `payload`, validated against the queue's `messageSchema`, and
27
+ * the whole batch is handed to the handler as `messages`.
28
+ *
29
+ * Uses SQS partial-batch responses: a record that fails to parse, validate, or
30
+ * (when the handler throws) process is returned in `batchItemFailures` so SQS
31
+ * retries only those records.
32
+ */
33
+ export class AWSLambdaQueue<
34
+ TName extends string = string,
35
+ TMessage extends StandardSchemaV1 = StandardSchemaV1,
36
+ TServices extends Service[] = [],
37
+ TLogger extends Logger = Logger,
38
+ > {
39
+ private _services?: ServiceRecord<TServices>;
40
+
41
+ constructor(
42
+ private readonly envParser: EnvironmentParser<{}>,
43
+ readonly queue: Queue<TName, TMessage, TServices, TLogger>,
44
+ ) {}
45
+
46
+ get logger(): TLogger {
47
+ return this.queue.logger;
48
+ }
49
+
50
+ private async getServices(): Promise<ServiceRecord<TServices>> {
51
+ if (this._services) {
52
+ return this._services;
53
+ }
54
+
55
+ const serviceDiscovery = ServiceDiscovery.getInstance(this.envParser);
56
+
57
+ this._services =
58
+ this.queue.services.length > 0
59
+ ? ((await serviceDiscovery.register(
60
+ this.queue.services,
61
+ )) as ServiceRecord<TServices>)
62
+ : ({} as ServiceRecord<TServices>);
63
+
64
+ return this._services;
65
+ }
66
+
67
+ private safeJsonParse(value: string): unknown {
68
+ try {
69
+ return JSON.parse(value);
70
+ } catch {
71
+ return null;
72
+ }
73
+ }
74
+
75
+ /**
76
+ * Unwrap the queue payload from an SQS record. The SQS publisher writes
77
+ * `{ type, payload }`; a payload-only body is also accepted as-is.
78
+ */
79
+ private extractPayload(record: SQSRecord): unknown {
80
+ const body = this.safeJsonParse(record.body);
81
+ if (body && typeof body === 'object' && 'payload' in body) {
82
+ return (body as { payload: unknown }).payload;
83
+ }
84
+ return body ?? record.body;
85
+ }
86
+
87
+ private async _handler(
88
+ event: SQSEvent,
89
+ context: Context,
90
+ ): Promise<SQSBatchResponse> {
91
+ const logger = this.queue.logger.child({
92
+ queue: {
93
+ name: this.queue.name,
94
+ fn: context.functionName,
95
+ },
96
+ req: { id: context.awsRequestId },
97
+ }) as TLogger;
98
+
99
+ const services = await this.getServices();
100
+ const schema = this.queue.messageSchema;
101
+
102
+ const batchItemFailures: { itemIdentifier: string }[] = [];
103
+ const messages: InferStandardSchema<TMessage>[] = [];
104
+
105
+ for (const record of event.Records) {
106
+ try {
107
+ const payload = this.extractPayload(record);
108
+ const validation = await schema['~standard'].validate(payload);
109
+ if (validation.issues) {
110
+ logger.error(
111
+ { issues: validation.issues, messageId: record.messageId },
112
+ 'Queue message failed validation',
113
+ );
114
+ batchItemFailures.push({ itemIdentifier: record.messageId });
115
+ continue;
116
+ }
117
+ messages.push(validation.value as InferStandardSchema<TMessage>);
118
+ } catch (error) {
119
+ logger.error(
120
+ { error, messageId: record.messageId },
121
+ 'Failed to parse SQS record',
122
+ );
123
+ batchItemFailures.push({ itemIdentifier: record.messageId });
124
+ }
125
+ }
126
+
127
+ if (messages.length === 0) {
128
+ return { batchItemFailures };
129
+ }
130
+
131
+ try {
132
+ await this.queue.handler({ messages, services, logger });
133
+ } catch (error) {
134
+ logger.error(wrapError(error), 'Queue handler failed; retrying batch');
135
+ // Handler processes the batch atomically — fail the whole batch so SQS
136
+ // retries every (valid) record.
137
+ for (const record of event.Records) {
138
+ if (
139
+ !batchItemFailures.some((f) => f.itemIdentifier === record.messageId)
140
+ ) {
141
+ batchItemFailures.push({ itemIdentifier: record.messageId });
142
+ }
143
+ }
144
+ }
145
+
146
+ return { batchItemFailures };
147
+ }
148
+
149
+ get handler(): AWSLambdaHandler<SQSEvent, SQSBatchResponse> {
150
+ const handler = this._handler.bind(this);
151
+
152
+ return (async (event: SQSEvent, context: Context) => {
153
+ const startTime = Date.now();
154
+ const requestId = context.awsRequestId;
155
+ const logger = this.queue.logger.child({ requestId }) as TLogger;
156
+
157
+ return runWithRequestContext({ logger, requestId, startTime }, () =>
158
+ handler(event, context),
159
+ );
160
+ }) as unknown as AWSLambdaHandler<SQSEvent, SQSBatchResponse>;
161
+ }
162
+ }
@@ -0,0 +1,128 @@
1
+ import { environmentCase } from '@geekmidas/envkit';
2
+ import {
3
+ type EventPublisher,
4
+ type EventPublisherConnectionString,
5
+ type PublishableMessage,
6
+ Publisher,
7
+ } from '@geekmidas/events';
8
+ import type { Logger } from '@geekmidas/logger';
9
+ import { ConsoleLogger } from '@geekmidas/logger/console';
10
+ import type { InferStandardSchema } from '@geekmidas/schema';
11
+ import type { Service, ServiceRecord } from '@geekmidas/services';
12
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
13
+ import { Construct, ConstructType } from '../Construct';
14
+
15
+ const DEFAULT_LOGGER = new ConsoleLogger() as unknown as Logger;
16
+
17
+ /**
18
+ * The wire message a queue carries: `{ type: <queue name>, payload: <message> }`.
19
+ * The producer publishes this shape and the worker receives the `payload`s as
20
+ * its `messages`. Typing `type` to the queue name keeps the publisher fully
21
+ * typed and lets pg-boss (local) / SQS (deployed) route by name.
22
+ */
23
+ export type QueueMessage<
24
+ TName extends string,
25
+ TMessage extends StandardSchemaV1,
26
+ > = PublishableMessage<TName, InferStandardSchema<TMessage>>;
27
+
28
+ /**
29
+ * A queue worker — a point-to-point SQS-style queue and its single consumer.
30
+ * Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue
31
+ * drains every message of its one `message` type. Build one with `q` (see
32
+ * `QueueBuilder`); `gkm build` discovers it into the manifest's `queues` field.
33
+ *
34
+ * The producer side is {@link Queue.publisher} — a ready-to-inject `Service`
35
+ * that any endpoint/function drops into `.services([...])` to send messages.
36
+ */
37
+ export class Queue<
38
+ TName extends string = string,
39
+ TMessage extends StandardSchemaV1 = StandardSchemaV1,
40
+ TServices extends Service[] = [],
41
+ TLogger extends Logger = Logger,
42
+ > extends Construct<TLogger, string, undefined, undefined, TServices> {
43
+ __IS_QUEUE__ = true;
44
+
45
+ static isQueue(
46
+ obj: unknown,
47
+ ): obj is Queue<string, StandardSchemaV1, Service[], Logger> {
48
+ return Boolean(
49
+ obj &&
50
+ (obj as { __IS_QUEUE__?: boolean }).__IS_QUEUE__ === true &&
51
+ (obj as Construct).type === ConstructType.Queue,
52
+ );
53
+ }
54
+
55
+ constructor(
56
+ public readonly name: TName,
57
+ public readonly handler: QueueHandler<TMessage, TServices, TLogger>,
58
+ public readonly messageSchema: TMessage,
59
+ public override readonly timeout: number = 30000,
60
+ public override readonly services: TServices = [] as unknown as TServices,
61
+ public override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,
62
+ /** SQS event-source batch size (deployed). */
63
+ public readonly batchSize?: number,
64
+ /** Whether the queue is FIFO (deployed). */
65
+ public readonly fifo?: boolean,
66
+ ) {
67
+ super(
68
+ ConstructType.Queue,
69
+ logger,
70
+ services,
71
+ [],
72
+ undefined,
73
+ undefined,
74
+ timeout,
75
+ );
76
+ }
77
+
78
+ /**
79
+ * The producer side — a `Service` exposing an `EventPublisher` typed to this
80
+ * queue's message. Inject it via `.services([queue.publisher])`; the handler
81
+ * then calls `services.<name>Publisher.publish([{ type, payload }])`.
82
+ *
83
+ * It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and builds the transport from
84
+ * the URL protocol — `pgboss://` locally, `sqs://` deployed — so the same
85
+ * code publishes to Postgres in dev and SQS in prod. Because it's a `Service`,
86
+ * `Construct.getEnvironment()` sniffs it, so the env requirement flows into
87
+ * the manifest and infra links exactly this queue with least privilege.
88
+ */
89
+ get publisher(): Service<
90
+ `${TName}Publisher`,
91
+ EventPublisher<QueueMessage<TName, TMessage>>
92
+ > {
93
+ const envVar = `${environmentCase(this.name)}_PUBLISHER_CONNECTION_STRING`;
94
+ return {
95
+ serviceName: `${this.name}Publisher`,
96
+ async register({ envParser }) {
97
+ const { connectionString } = envParser
98
+ .create((get) => ({
99
+ connectionString: get(envVar).string(),
100
+ }))
101
+ .parse();
102
+
103
+ return Publisher.fromConnectionString<QueueMessage<TName, TMessage>>(
104
+ connectionString as EventPublisherConnectionString,
105
+ );
106
+ },
107
+ };
108
+ }
109
+ }
110
+
111
+ /** The context a queue handler receives — a batch of typed messages. */
112
+ export type QueueContext<
113
+ TMessage extends StandardSchemaV1,
114
+ TServices extends Service[] = [],
115
+ TLogger extends Logger = Logger,
116
+ > = {
117
+ messages: InferStandardSchema<TMessage>[];
118
+ services: ServiceRecord<TServices>;
119
+ logger: TLogger;
120
+ };
121
+
122
+ export type QueueHandler<
123
+ TMessage extends StandardSchemaV1,
124
+ TServices extends Service[] = [],
125
+ TLogger extends Logger = Logger,
126
+ > = (
127
+ ctx: QueueContext<TMessage, TServices, TLogger>,
128
+ ) => unknown | Promise<unknown>;
@@ -0,0 +1,115 @@
1
+ import type { Logger } from '@geekmidas/logger';
2
+ import { DEFAULT_LOGGER } from '@geekmidas/logger/console';
3
+ import type { Service } from '@geekmidas/services';
4
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
5
+ import { cloneWith } from '../clone';
6
+ import { Queue, type QueueHandler } from './Queue';
7
+
8
+ /**
9
+ * Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.
10
+ * Services are an array (sniffed for required env vars); `message` is the typed
11
+ * job payload; `handle` is the single consumer. The queue name is captured as a
12
+ * literal so `queue.publisher` is typed to `{ type: '<name>', payload }`.
13
+ */
14
+ export class QueueBuilder<
15
+ TName extends string = string,
16
+ TMessage extends StandardSchemaV1 | undefined = undefined,
17
+ TServices extends Service[] = [],
18
+ TLogger extends Logger = Logger,
19
+ > {
20
+ private _name?: string;
21
+ private _messageSchema?: TMessage;
22
+ private _timeout = 30000;
23
+ private _batchSize?: number;
24
+ private _fifo?: boolean;
25
+ private _services: TServices = [] as Service[] as TServices;
26
+ private _logger: TLogger = DEFAULT_LOGGER as TLogger;
27
+
28
+ /** The queue name — drives the infra queue and its `<NAME>_*` env vars. */
29
+ queue<T extends string>(
30
+ name: T,
31
+ ): QueueBuilder<T, TMessage, TServices, TLogger> {
32
+ return cloneWith(this, { _name: name }) as unknown as QueueBuilder<
33
+ T,
34
+ TMessage,
35
+ TServices,
36
+ TLogger
37
+ >;
38
+ }
39
+
40
+ timeout(timeout: number): this {
41
+ return cloneWith(this, { _timeout: timeout });
42
+ }
43
+
44
+ /** SQS event-source batch size (deployed). */
45
+ batchSize(batchSize: number): this {
46
+ return cloneWith(this, { _batchSize: batchSize });
47
+ }
48
+
49
+ /** Mark the queue as FIFO (deployed). */
50
+ fifo(fifo = true): this {
51
+ return cloneWith(this, { _fifo: fifo });
52
+ }
53
+
54
+ services<T extends Service[]>(
55
+ services: T,
56
+ ): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {
57
+ return cloneWith(this, {
58
+ _services: [...this._services, ...services] as unknown as TServices,
59
+ }) as unknown as QueueBuilder<
60
+ TName,
61
+ TMessage,
62
+ [...TServices, ...T],
63
+ TLogger
64
+ >;
65
+ }
66
+
67
+ logger<T extends Logger>(
68
+ logger: T,
69
+ ): QueueBuilder<TName, TMessage, TServices, T> {
70
+ return cloneWith(this, {
71
+ _logger: logger as unknown as TLogger,
72
+ }) as unknown as QueueBuilder<TName, TMessage, TServices, T>;
73
+ }
74
+
75
+ /** The typed message (job) payload the queue carries. */
76
+ message<T extends StandardSchemaV1>(
77
+ schema: T,
78
+ ): QueueBuilder<TName, T, TServices, TLogger> {
79
+ return cloneWith(this, {
80
+ _messageSchema: schema as unknown as TMessage,
81
+ }) as unknown as QueueBuilder<TName, T, TServices, TLogger>;
82
+ }
83
+
84
+ handle(
85
+ fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,
86
+ ): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {
87
+ if (!this._name) {
88
+ throw new Error(
89
+ 'Queue requires a name — call .queue(name) before .handle().',
90
+ );
91
+ }
92
+ if (!this._messageSchema) {
93
+ throw new Error(
94
+ 'Queue requires a message schema — call .message(schema) before .handle().',
95
+ );
96
+ }
97
+
98
+ const queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(
99
+ this._name as TName,
100
+ fn,
101
+ this._messageSchema as NonNullable<TMessage>,
102
+ this._timeout,
103
+ this._services,
104
+ this._logger,
105
+ this._batchSize,
106
+ this._fifo,
107
+ );
108
+
109
+ // No reset. `.handle()` reads this builder and leaves it alone, so a
110
+ // configured base keeps its configuration for every construct built
111
+ // from it. The reset that used to be here wiped the base on first use.
112
+
113
+ return queue;
114
+ }
115
+ }
@@ -0,0 +1,63 @@
1
+ import { EnvironmentParser } from '@geekmidas/envkit';
2
+ import type { Logger } from '@geekmidas/logger';
3
+ import type { InferStandardSchema } from '@geekmidas/schema';
4
+ import type { Service, ServiceRecord } from '@geekmidas/services';
5
+ import { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';
6
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
7
+ import type { Queue } from './Queue';
8
+
9
+ /**
10
+ * In-memory test driver for a {@link Queue} worker. Hand it a batch of messages
11
+ * and it registers the queue's services, runs the handler in a request context,
12
+ * and returns the handler result — no SQS/pg-boss required.
13
+ *
14
+ * @example
15
+ * const adapter = new TestQueueAdaptor(ordersQueue);
16
+ * await adapter.invoke({ messages: [{ orderId: '123' }] });
17
+ */
18
+ export class TestQueueAdaptor<
19
+ TName extends string = string,
20
+ TMessage extends StandardSchemaV1 = StandardSchemaV1,
21
+ TServices extends Service[] = [],
22
+ TLogger extends Logger = Logger,
23
+ > {
24
+ static getDefaultServiceDiscovery() {
25
+ return ServiceDiscovery.getInstance(new EnvironmentParser({}));
26
+ }
27
+
28
+ constructor(
29
+ private readonly queue: Queue<TName, TMessage, TServices, TLogger>,
30
+ private serviceDiscovery: ServiceDiscovery<any> = TestQueueAdaptor.getDefaultServiceDiscovery(),
31
+ ) {}
32
+
33
+ async invoke(
34
+ request: TestQueueRequest<TMessage, TServices>,
35
+ ): Promise<unknown> {
36
+ const logger = this.queue.logger.child({ test: true }) as TLogger;
37
+
38
+ const services =
39
+ request.services ??
40
+ ((await this.serviceDiscovery.register(
41
+ this.queue.services,
42
+ )) as ServiceRecord<TServices>);
43
+
44
+ const requestId = `test-${Date.now()}`;
45
+ const startTime = Date.now();
46
+
47
+ return runWithRequestContext({ logger, requestId, startTime }, () =>
48
+ this.queue.handler({
49
+ messages: request.messages,
50
+ services,
51
+ logger,
52
+ }),
53
+ );
54
+ }
55
+ }
56
+
57
+ export type TestQueueRequest<
58
+ TMessage extends StandardSchemaV1 = StandardSchemaV1,
59
+ TServices extends Service[] = [],
60
+ > = {
61
+ messages: InferStandardSchema<TMessage>[];
62
+ services?: ServiceRecord<TServices>;
63
+ };