@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,636 @@
1
+ import { EnvironmentParser } from '@geekmidas/envkit';
2
+ import { NotFoundError } from '@geekmidas/errors';
3
+ import { ServiceDiscovery } from '@geekmidas/services';
4
+ import { createMockContext, createMockV2Event } from '@geekmidas/testkit/aws';
5
+ import { Hono } from 'hono';
6
+ import { HttpResponse, http } from 'msw';
7
+ import { setupServer } from 'msw/node';
8
+ import {
9
+ afterAll,
10
+ afterEach,
11
+ beforeAll,
12
+ beforeEach,
13
+ describe,
14
+ expect,
15
+ it,
16
+ vi,
17
+ } from 'vitest';
18
+ import { z } from 'zod';
19
+ import { AWSScheduledFunction } from '../crons/AWSScheduledFunction';
20
+ import { CronBuilder } from '../crons/CronBuilder';
21
+ import { AmazonApiGatewayV2Endpoint } from '../endpoints/AmazonApiGatewayV2EndpointAdaptor';
22
+ import { EndpointFactory } from '../endpoints/EndpointFactory';
23
+ import { HonoEndpoint } from '../endpoints/HonoEndpointAdaptor';
24
+ import { TestEndpointAdaptor } from '../endpoints/TestEndpointAdaptor';
25
+ import { AWSLambdaFunction } from '../functions/AWSLambdaFunction';
26
+ import { FunctionBuilder } from '../functions/FunctionBuilder';
27
+ import { TestFunctionAdaptor } from '../functions/TestFunctionAdaptor';
28
+ import type { ConstructMonitor, MonitorService } from '../monitor';
29
+ import { heartbeat } from '../monitors';
30
+
31
+ const HEARTBEAT = 'https://heartbeat.test/api/v1/heartbeat/abc';
32
+
33
+ /** Every heartbeat request MSW saw, as `path`. */
34
+ const pings: string[] = [];
35
+
36
+ const server = setupServer(
37
+ http.get('https://heartbeat.test/*', ({ request }) => {
38
+ pings.push(new URL(request.url).pathname.replace('/api/v1/heartbeat', ''));
39
+ return new HttpResponse(null, { status: 200 });
40
+ }),
41
+ );
42
+
43
+ /** A monitor that writes down what it was told, in order. */
44
+ function recorder(serviceName = 'recorder') {
45
+ const calls: string[] = [];
46
+ const service = {
47
+ serviceName,
48
+ async register(): Promise<ConstructMonitor<string>> {
49
+ return {
50
+ async start() {
51
+ calls.push('start');
52
+ return 'run-1';
53
+ },
54
+ async success({ run, status }) {
55
+ calls.push(`success:${run}${status ? `:${status}` : ''}`);
56
+ },
57
+ async failure({ run, status, error }) {
58
+ calls.push(
59
+ `failure:${run}${status ? `:${status}` : ''}:${(error as Error).message}`,
60
+ );
61
+ },
62
+ };
63
+ },
64
+ } satisfies MonitorService;
65
+
66
+ return { calls, service };
67
+ }
68
+
69
+ const throwing = {
70
+ serviceName: 'throwing',
71
+ async register(): Promise<ConstructMonitor> {
72
+ return {
73
+ async start() {
74
+ throw new Error('start failed');
75
+ },
76
+ async success() {
77
+ throw new Error('success failed');
78
+ },
79
+ async failure() {
80
+ throw new Error('failure failed');
81
+ },
82
+ };
83
+ },
84
+ } satisfies MonitorService;
85
+
86
+ function discovery(env: Record<string, string> = {}) {
87
+ return ServiceDiscovery.getInstance(new EnvironmentParser(env));
88
+ }
89
+
90
+ beforeAll(() => server.listen({ onUnhandledRequest: 'error' }));
91
+ afterAll(() => server.close());
92
+ beforeEach(() => {
93
+ // Services are cached by name, so each test starts from its own env.
94
+ ServiceDiscovery.reset();
95
+ pings.length = 0;
96
+ });
97
+ afterEach(() => server.resetHandlers());
98
+
99
+ describe('heartbeat', () => {
100
+ it('pings the URL when a run succeeds', async () => {
101
+ const cron = new CronBuilder()
102
+ .input(z.object({}))
103
+ .schedule('rate(1 day)')
104
+ .monitor(heartbeat.betterStack())
105
+ .handle(async () => ({ ok: true }));
106
+
107
+ await new TestFunctionAdaptor(
108
+ cron,
109
+ discovery({ HEARTBEAT_URL: HEARTBEAT }),
110
+ ).invoke({ input: {}, services: {} });
111
+
112
+ expect(pings).toEqual(['/abc']);
113
+ });
114
+
115
+ it('pings the failure URL and rethrows when a run fails', async () => {
116
+ const cron = new CronBuilder()
117
+ .input(z.object({}))
118
+ .schedule('rate(1 day)')
119
+ .monitor(heartbeat.betterStack())
120
+ .handle(async () => {
121
+ throw new Error('boom');
122
+ });
123
+
124
+ await expect(
125
+ new TestFunctionAdaptor(
126
+ cron,
127
+ discovery({ HEARTBEAT_URL: HEARTBEAT }),
128
+ ).invoke({ input: {}, services: {} }),
129
+ ).rejects.toThrow('boom');
130
+
131
+ expect(pings).toEqual(['/abc/fail']);
132
+ });
133
+
134
+ it('pings start before success for providers that take one', async () => {
135
+ const fn = new FunctionBuilder()
136
+ .input(z.object({}))
137
+ .monitor(heartbeat.healthchecks())
138
+ .handle(async () => ({}));
139
+
140
+ await new TestFunctionAdaptor(
141
+ fn,
142
+ discovery({ HEARTBEAT_URL: HEARTBEAT }),
143
+ ).invoke({ input: {}, services: {} });
144
+
145
+ expect(pings).toEqual(['/abc/start', '/abc']);
146
+ });
147
+
148
+ it('does nothing when its env var is unset', async () => {
149
+ const cron = new CronBuilder()
150
+ .input(z.object({}))
151
+ .schedule('rate(1 day)')
152
+ .monitor(heartbeat.betterStack())
153
+ .handle(async () => ({}));
154
+
155
+ await new TestFunctionAdaptor(cron, discovery()).invoke({
156
+ input: {},
157
+ services: {},
158
+ });
159
+
160
+ expect(pings).toEqual([]);
161
+ });
162
+
163
+ it('reads the env var it was given', async () => {
164
+ const cron = new CronBuilder()
165
+ .input(z.object({}))
166
+ .schedule('rate(1 day)')
167
+ .monitor(heartbeat.betterStack('NIGHTLY_HEARTBEAT_URL'))
168
+ .handle(async () => ({}));
169
+
170
+ await new TestFunctionAdaptor(
171
+ cron,
172
+ discovery({ NIGHTLY_HEARTBEAT_URL: `${HEARTBEAT}/nightly` }),
173
+ ).invoke({ input: {}, services: {} });
174
+
175
+ expect(pings).toEqual(['/abc/nightly']);
176
+ });
177
+
178
+ it('does not fail the run when the provider is down', async () => {
179
+ server.use(
180
+ http.get('https://heartbeat.test/*', () =>
181
+ HttpResponse.json({ error: 'down' }, { status: 503 }),
182
+ ),
183
+ );
184
+ const cron = new CronBuilder()
185
+ .input(z.object({}))
186
+ .schedule('rate(1 day)')
187
+ .monitor(heartbeat.betterStack())
188
+ .output(z.object({ ok: z.boolean() }))
189
+ .handle(async () => ({ ok: true }));
190
+
191
+ const output = await new TestFunctionAdaptor(
192
+ cron,
193
+ discovery({ HEARTBEAT_URL: HEARTBEAT }),
194
+ ).invoke({ input: {}, services: {} });
195
+
196
+ expect(output).toEqual({ ok: true });
197
+ });
198
+
199
+ it('declares its env var as optional', async () => {
200
+ const cron = new CronBuilder()
201
+ .input(z.object({}))
202
+ .schedule('rate(1 day)')
203
+ .monitor(heartbeat.betterStack('NIGHTLY_HEARTBEAT_URL'))
204
+ .handle(async () => ({}));
205
+
206
+ expect(await cron.getEnvironment({ markOptional: true })).toContain(
207
+ 'NIGHTLY_HEARTBEAT_URL?',
208
+ );
209
+ });
210
+ });
211
+
212
+ describe('duplicate monitors', () => {
213
+ it('refuses two heartbeats reading the same env var', () => {
214
+ expect(() =>
215
+ new CronBuilder()
216
+ .monitor(heartbeat.betterStack())
217
+ .monitor(heartbeat.healthchecks()),
218
+ ).toThrow('Monitor "heartbeat:HEARTBEAT_URL" is already set');
219
+ });
220
+
221
+ it('refuses an endpoint repeating its factory’s monitor', () => {
222
+ const e = new EndpointFactory().monitor(heartbeat.betterStack());
223
+
224
+ expect(() => e.get('/x').monitor(heartbeat.betterStack())).toThrow(
225
+ 'is already set',
226
+ );
227
+ });
228
+
229
+ it('refuses the same monitor twice on a factory', () => {
230
+ expect(() =>
231
+ new EndpointFactory()
232
+ .monitor(heartbeat.betterStack())
233
+ .monitor(heartbeat.healthchecks()),
234
+ ).toThrow('is already set');
235
+ });
236
+
237
+ it('allows two heartbeats on their own env vars', async () => {
238
+ const fn = new FunctionBuilder()
239
+ .input(z.object({}))
240
+ .monitor(heartbeat.betterStack('BETTER_STACK_HEARTBEAT_URL'))
241
+ .monitor(heartbeat.healthchecks('HEALTHCHECKS_HEARTBEAT_URL'))
242
+ .handle(async () => ({}));
243
+
244
+ await new TestFunctionAdaptor(
245
+ fn,
246
+ discovery({
247
+ BETTER_STACK_HEARTBEAT_URL: `${HEARTBEAT}/bs`,
248
+ HEALTHCHECKS_HEARTBEAT_URL: `${HEARTBEAT}/hc`,
249
+ }),
250
+ ).invoke({ input: {}, services: {} });
251
+
252
+ // Each provider gets its own pings, in its own URL shape.
253
+ expect(pings.sort()).toEqual(['/abc/bs', '/abc/hc', '/abc/hc/start']);
254
+ });
255
+ });
256
+
257
+ describe('functions and crons', () => {
258
+ it('report start, then success with what start returned', async () => {
259
+ const { calls, service } = recorder();
260
+ const fn = new FunctionBuilder()
261
+ .input(z.object({}))
262
+ .monitor(service)
263
+ .handle(async () => ({}));
264
+
265
+ await new TestFunctionAdaptor(fn, discovery()).invoke({
266
+ input: {},
267
+ services: {},
268
+ });
269
+
270
+ expect(calls).toEqual(['start', 'success:run-1']);
271
+ });
272
+
273
+ it('tell every monitor, in the AWS Lambda handler', async () => {
274
+ const one = recorder('one');
275
+ const two = recorder('two');
276
+ const cron = new CronBuilder()
277
+ .input(z.object({}))
278
+ .schedule('rate(1 day)')
279
+ .monitor(one.service)
280
+ .monitor(two.service)
281
+ .handle(async () => {
282
+ throw new Error('boom');
283
+ });
284
+ discovery();
285
+
286
+ const handler = new AWSScheduledFunction(new EnvironmentParser({}), cron)
287
+ .handler;
288
+
289
+ // The handler rethrows the wrapped error; monitors get the original.
290
+ await expect(handler({}, createMockContext(), vi.fn())).rejects.toThrow();
291
+ expect(one.calls).toEqual(['start', 'failure:run-1:boom']);
292
+ expect(two.calls).toEqual(['start', 'failure:run-1:boom']);
293
+ });
294
+
295
+ it('ignore a monitor that throws', async () => {
296
+ const fn = new FunctionBuilder()
297
+ .input(z.object({}))
298
+ .monitor(throwing)
299
+ .output(z.object({ ok: z.boolean() }))
300
+ .handle(async () => ({ ok: true }));
301
+
302
+ const output = await new TestFunctionAdaptor(fn, discovery()).invoke({
303
+ input: {},
304
+ services: {},
305
+ });
306
+
307
+ expect(output).toEqual({ ok: true });
308
+ });
309
+
310
+ it('inherit a shared base’s monitor, and add their own', async () => {
311
+ const shared = recorder('shared');
312
+ const own = recorder('own');
313
+ const base = new CronBuilder().monitor(shared.service);
314
+
315
+ const nightly = base
316
+ .schedule('rate(1 day)')
317
+ .monitor(own.service)
318
+ .handle(async () => ({}));
319
+ const hourly = base.schedule('rate(1 hour)').handle(async () => ({}));
320
+
321
+ expect(nightly.monitors.map((m) => m.serviceName)).toEqual([
322
+ 'shared',
323
+ 'own',
324
+ ]);
325
+ expect(hourly.monitors.map((m) => m.serviceName)).toEqual(['shared']);
326
+ });
327
+ });
328
+
329
+ describe('endpoints', () => {
330
+ function api(monitor: MonitorService) {
331
+ const e = new EndpointFactory().monitor(monitor);
332
+ return {
333
+ ok: e.get('/ok').handle(async () => ({ ok: true })),
334
+ missing: e.get('/missing').handle(async () => {
335
+ throw new NotFoundError('nope');
336
+ }),
337
+ broken: e.get('/broken').handle(async () => {
338
+ throw new Error('boom');
339
+ }),
340
+ };
341
+ }
342
+
343
+ it('inherit the factory’s monitor, and add their own', () => {
344
+ const shared = recorder('shared');
345
+ const own = recorder('own');
346
+ const e = new EndpointFactory().monitor(shared.service);
347
+
348
+ const withOwn = e
349
+ .get('/a')
350
+ .monitor(own.service)
351
+ .handle(async () => ({}));
352
+ const without = e.get('/b').handle(async () => ({}));
353
+
354
+ expect(withOwn.monitors.map((m) => m.serviceName)).toEqual([
355
+ 'shared',
356
+ 'own',
357
+ ]);
358
+ expect(without.monitors.map((m) => m.serviceName)).toEqual(['shared']);
359
+ });
360
+
361
+ describe('TestEndpointAdaptor', () => {
362
+ const request = (endpoint: any) =>
363
+ new TestEndpointAdaptor(endpoint, discovery()).fullRequest({
364
+ services: {},
365
+ headers: {},
366
+ } as any);
367
+
368
+ it('reports a 2xx as a success', async () => {
369
+ const { calls, service } = recorder();
370
+ await request(api(service).ok);
371
+ expect(calls).toEqual(['start', 'success:run-1:200']);
372
+ });
373
+
374
+ it('reports a 4xx as a success: the caller erred, not the service', async () => {
375
+ const { calls, service } = recorder();
376
+ await expect(request(api(service).missing)).rejects.toThrow('nope');
377
+ expect(calls).toEqual(['start', 'success:run-1:404']);
378
+ });
379
+
380
+ it('reports a thrown error as a 500 failure', async () => {
381
+ const { calls, service } = recorder();
382
+ await expect(request(api(service).broken)).rejects.toThrow('boom');
383
+ expect(calls).toEqual(['start', 'failure:run-1:500:boom']);
384
+ });
385
+ });
386
+
387
+ describe('Hono', () => {
388
+ async function serve(endpoint: any, path: string) {
389
+ const app = new Hono();
390
+ new HonoEndpoint(endpoint).addRoute(discovery(), app);
391
+ return app.request(path);
392
+ }
393
+
394
+ it('reports a 2xx as a success, without holding the response', async () => {
395
+ const { calls, service } = recorder();
396
+ const response = await serve(api(service).ok, '/ok');
397
+
398
+ expect(response.status).toBe(200);
399
+ await vi.waitFor(() =>
400
+ expect(calls).toEqual(['start', 'success:run-1:200']),
401
+ );
402
+ });
403
+
404
+ it('reports a 4xx as a success', async () => {
405
+ const { calls, service } = recorder();
406
+ const response = await serve(api(service).missing, '/missing');
407
+
408
+ expect(response.status).toBe(404);
409
+ await vi.waitFor(() =>
410
+ expect(calls).toEqual(['start', 'success:run-1:404']),
411
+ );
412
+ });
413
+
414
+ it('reports a 5xx as a failure, with the error', async () => {
415
+ const { calls, service } = recorder();
416
+ const response = await serve(api(service).broken, '/broken');
417
+
418
+ expect(response.status).toBe(500);
419
+ await vi.waitFor(() =>
420
+ expect(calls).toEqual(['start', 'failure:run-1:500:boom']),
421
+ );
422
+ });
423
+ });
424
+
425
+ describe('API Gateway', () => {
426
+ async function invoke(endpoint: any) {
427
+ discovery();
428
+ const handler = new AmazonApiGatewayV2Endpoint(
429
+ new EnvironmentParser({}),
430
+ endpoint,
431
+ ).handler;
432
+ return handler(createMockV2Event(), createMockContext(), vi.fn());
433
+ }
434
+
435
+ it('reports a 2xx as a success', async () => {
436
+ const { calls, service } = recorder();
437
+ const response: any = await invoke(api(service).ok);
438
+
439
+ expect(response.statusCode).toBe(200);
440
+ expect(calls).toEqual(['start', 'success:run-1:200']);
441
+ });
442
+
443
+ it('reports a 4xx as a success', async () => {
444
+ const { calls, service } = recorder();
445
+ const response: any = await invoke(api(service).missing);
446
+
447
+ expect(response.statusCode).toBe(404);
448
+ expect(calls).toEqual(['start', 'success:run-1:404']);
449
+ });
450
+
451
+ it('reports a 5xx as a failure, with the error', async () => {
452
+ const { calls, service } = recorder();
453
+ const response: any = await invoke(api(service).broken);
454
+
455
+ expect(response.statusCode).toBe(500);
456
+ expect(calls).toEqual(['start', 'failure:run-1:500:boom']);
457
+ });
458
+ });
459
+ });
460
+
461
+ /**
462
+ * The heartbeat over real HTTP (MSW), on every construct and runtime: what
463
+ * actually reaches the provider when a run succeeds or fails.
464
+ */
465
+ describe('heartbeat requests, per construct', () => {
466
+ const env = { HEARTBEAT_URL: HEARTBEAT };
467
+
468
+ function endpoints() {
469
+ const e = new EndpointFactory().monitor(heartbeat.betterStack());
470
+ return {
471
+ ok: e.get('/ok').handle(async () => ({ ok: true })),
472
+ missing: e.get('/missing').handle(async () => {
473
+ throw new NotFoundError('nope');
474
+ }),
475
+ broken: e.get('/broken').handle(async () => {
476
+ throw new Error('boom');
477
+ }),
478
+ };
479
+ }
480
+
481
+ describe('function, AWS Lambda handler', () => {
482
+ const invoke = (fn: any) =>
483
+ new AWSLambdaFunction(new EnvironmentParser(env), fn).handler(
484
+ {},
485
+ createMockContext(),
486
+ vi.fn(),
487
+ );
488
+
489
+ it('sends the success ping', async () => {
490
+ await invoke(
491
+ new FunctionBuilder()
492
+ .monitor(heartbeat.betterStack())
493
+ .handle(async () => ({})),
494
+ );
495
+ expect(pings).toEqual(['/abc']);
496
+ });
497
+
498
+ it('sends the failure ping', async () => {
499
+ await expect(
500
+ invoke(
501
+ new FunctionBuilder()
502
+ .monitor(heartbeat.betterStack())
503
+ .handle(async () => {
504
+ throw new Error('boom');
505
+ }),
506
+ ),
507
+ ).rejects.toThrow();
508
+ expect(pings).toEqual(['/abc/fail']);
509
+ });
510
+ });
511
+
512
+ describe('cron, AWS Lambda handler', () => {
513
+ const invoke = (cron: any) =>
514
+ new AWSScheduledFunction(new EnvironmentParser(env), cron).handler(
515
+ {},
516
+ createMockContext(),
517
+ vi.fn(),
518
+ );
519
+
520
+ it('sends the success ping', async () => {
521
+ await invoke(
522
+ new CronBuilder()
523
+ .schedule('rate(1 day)')
524
+ .monitor(heartbeat.betterStack())
525
+ .handle(async () => ({})),
526
+ );
527
+ expect(pings).toEqual(['/abc']);
528
+ });
529
+
530
+ it('sends the failure ping', async () => {
531
+ await expect(
532
+ invoke(
533
+ new CronBuilder()
534
+ .schedule('rate(1 day)')
535
+ .monitor(heartbeat.betterStack())
536
+ .handle(async () => {
537
+ throw new Error('boom');
538
+ }),
539
+ ),
540
+ ).rejects.toThrow();
541
+ expect(pings).toEqual(['/abc/fail']);
542
+ });
543
+
544
+ it('sends the start ping first, for Healthchecks.io', async () => {
545
+ await invoke(
546
+ new CronBuilder()
547
+ .schedule('rate(1 day)')
548
+ .monitor(heartbeat.healthchecks())
549
+ .handle(async () => ({})),
550
+ );
551
+ expect(pings).toEqual(['/abc/start', '/abc']);
552
+ });
553
+
554
+ it('sends one ping per run, from a shared base', async () => {
555
+ const base = new CronBuilder().monitor(heartbeat.betterStack());
556
+
557
+ await invoke(base.schedule('rate(1 day)').handle(async () => ({})));
558
+ await invoke(base.schedule('rate(1 hour)').handle(async () => ({})));
559
+
560
+ expect(pings).toEqual(['/abc', '/abc']);
561
+ });
562
+ });
563
+
564
+ describe('endpoint, TestEndpointAdaptor', () => {
565
+ const request = (endpoint: any) =>
566
+ new TestEndpointAdaptor(endpoint, discovery(env)).fullRequest({
567
+ services: {},
568
+ headers: {},
569
+ } as any);
570
+
571
+ it('sends the success ping on a 2xx', async () => {
572
+ await request(endpoints().ok);
573
+ expect(pings).toEqual(['/abc']);
574
+ });
575
+
576
+ it('sends the success ping on a 4xx', async () => {
577
+ await expect(request(endpoints().missing)).rejects.toThrow();
578
+ expect(pings).toEqual(['/abc']);
579
+ });
580
+
581
+ it('sends the failure ping on a 5xx', async () => {
582
+ await expect(request(endpoints().broken)).rejects.toThrow();
583
+ expect(pings).toEqual(['/abc/fail']);
584
+ });
585
+ });
586
+
587
+ describe('endpoint, Hono', () => {
588
+ async function serve(endpoint: any, path: string) {
589
+ const app = new Hono();
590
+ new HonoEndpoint(endpoint).addRoute(discovery(env), app);
591
+ return app.request(path);
592
+ }
593
+
594
+ // Hono does not wait on the ping, so each test waits for it to land.
595
+ it('sends the success ping on a 2xx', async () => {
596
+ expect((await serve(endpoints().ok, '/ok')).status).toBe(200);
597
+ await vi.waitFor(() => expect(pings).toEqual(['/abc']));
598
+ });
599
+
600
+ it('sends the success ping on a 4xx', async () => {
601
+ expect((await serve(endpoints().missing, '/missing')).status).toBe(404);
602
+ await vi.waitFor(() => expect(pings).toEqual(['/abc']));
603
+ });
604
+
605
+ it('sends the failure ping on a 5xx', async () => {
606
+ expect((await serve(endpoints().broken, '/broken')).status).toBe(500);
607
+ await vi.waitFor(() => expect(pings).toEqual(['/abc/fail']));
608
+ });
609
+ });
610
+
611
+ describe('endpoint, API Gateway', () => {
612
+ const invoke = (endpoint: any) =>
613
+ new AmazonApiGatewayV2Endpoint(
614
+ new EnvironmentParser(env),
615
+ endpoint,
616
+ ).handler(createMockV2Event(), createMockContext(), vi.fn()) as Promise<{
617
+ statusCode: number;
618
+ }>;
619
+
620
+ // Awaited before the response returns: the ping is there already.
621
+ it('sends the success ping on a 2xx', async () => {
622
+ expect((await invoke(endpoints().ok)).statusCode).toBe(200);
623
+ expect(pings).toEqual(['/abc']);
624
+ });
625
+
626
+ it('sends the success ping on a 4xx', async () => {
627
+ expect((await invoke(endpoints().missing)).statusCode).toBe(404);
628
+ expect(pings).toEqual(['/abc']);
629
+ });
630
+
631
+ it('sends the failure ping on a 5xx', async () => {
632
+ expect((await invoke(endpoints().broken)).statusCode).toBe(500);
633
+ expect(pings).toEqual(['/abc/fail']);
634
+ });
635
+ });
636
+ });