@geekmidas/constructs 10.0.0-alpha.16 → 10.0.0-alpha.160

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 (485) hide show
  1. package/README.md +246 -158
  2. package/dist/Construct-127M7yrl.d.cts +231 -0
  3. package/dist/Construct-127M7yrl.d.cts.map +1 -0
  4. package/dist/Construct-BMk_CRSD.d.mts +231 -0
  5. package/dist/Construct-BMk_CRSD.d.mts.map +1 -0
  6. package/dist/{Construct-BeYVu_QF.mjs → Construct-CGuc_Ijk.mjs} +8 -9
  7. package/dist/Construct-CGuc_Ijk.mjs.map +1 -0
  8. package/dist/{Construct-DqdlARxq.cjs → Construct-DorKS0Ua.cjs} +8 -9
  9. package/dist/Construct-DorKS0Ua.cjs.map +1 -0
  10. package/dist/{Cron-l4Wlz6G9.d.mts → Cron-D6Y7BBt3.d.mts} +15 -8
  11. package/dist/Cron-D6Y7BBt3.d.mts.map +1 -0
  12. package/dist/{Cron-zsoSAwZo.d.cts → Cron-D_sfaMGz.d.cts} +14 -7
  13. package/dist/Cron-D_sfaMGz.d.cts.map +1 -0
  14. package/dist/CronBuilder-4BZhkChG.d.mts +47 -0
  15. package/dist/CronBuilder-4BZhkChG.d.mts.map +1 -0
  16. package/dist/{CronBuilder-D_0HNBTr.mjs → CronBuilder-BJ5LoadF.mjs} +28 -11
  17. package/dist/CronBuilder-BJ5LoadF.mjs.map +1 -0
  18. package/dist/{CronBuilder-BdnI6lxF.cjs → CronBuilder-B_NSP-Y5.cjs} +27 -10
  19. package/dist/CronBuilder-B_NSP-Y5.cjs.map +1 -0
  20. package/dist/CronBuilder-C91MVLSr.d.cts +47 -0
  21. package/dist/CronBuilder-C91MVLSr.d.cts.map +1 -0
  22. package/dist/Endpoint-52z1P0Ue.cjs +581 -0
  23. package/dist/Endpoint-52z1P0Ue.cjs.map +1 -0
  24. package/dist/{Endpoint-oS-Fe3d_.d.mts → Endpoint-BUoDD96P.d.mts} +104 -23
  25. package/dist/Endpoint-BUoDD96P.d.mts.map +1 -0
  26. package/dist/{Endpoint-DBflWAe4.d.cts → Endpoint-YYwjqtS1.d.cts} +101 -20
  27. package/dist/Endpoint-YYwjqtS1.d.cts.map +1 -0
  28. package/dist/Endpoint-sUOU7uLx.mjs +552 -0
  29. package/dist/Endpoint-sUOU7uLx.mjs.map +1 -0
  30. package/dist/{index-Cc4kKPag.d.mts → EndpointFactory-BbVOeryo.d.mts} +189 -106
  31. package/dist/EndpointFactory-BbVOeryo.d.mts.map +1 -0
  32. package/dist/{EndpointFactory-Bm3aKRdV.mjs → EndpointFactory-Bzi9Sl7r.mjs} +269 -53
  33. package/dist/EndpointFactory-Bzi9Sl7r.mjs.map +1 -0
  34. package/dist/{EndpointFactory-CLvWuHyt.cjs → EndpointFactory-Cf_Cs1ym.cjs} +309 -51
  35. package/dist/EndpointFactory-Cf_Cs1ym.cjs.map +1 -0
  36. package/dist/{index-C1ZwNOOk.d.cts → EndpointFactory-Hh1r6J_C.d.cts} +187 -104
  37. package/dist/EndpointFactory-Hh1r6J_C.d.cts.map +1 -0
  38. package/dist/Function-BIEsY0Hm.d.cts +76 -0
  39. package/dist/Function-BIEsY0Hm.d.cts.map +1 -0
  40. package/dist/Function-BKReud5p.d.mts +76 -0
  41. package/dist/Function-BKReud5p.d.mts.map +1 -0
  42. package/dist/{HonoEndpointAdaptor-92zavCsV.cjs → HonoEndpointAdaptor-BTbqfSaa.cjs} +115 -41
  43. package/dist/HonoEndpointAdaptor-BTbqfSaa.cjs.map +1 -0
  44. package/dist/{HonoEndpointAdaptor-yYaU7jVJ.mjs → HonoEndpointAdaptor-CBVey2cY.mjs} +112 -38
  45. package/dist/HonoEndpointAdaptor-CBVey2cY.mjs.map +1 -0
  46. package/dist/ObjectSubscriberBuilder-DfzXQEKW.d.mts +129 -0
  47. package/dist/ObjectSubscriberBuilder-DfzXQEKW.d.mts.map +1 -0
  48. package/dist/ObjectSubscriberBuilder-LWkey_oq.d.cts +129 -0
  49. package/dist/ObjectSubscriberBuilder-LWkey_oq.d.cts.map +1 -0
  50. package/dist/ProcessorBuilder-D4oYvZeG.d.mts +216 -0
  51. package/dist/ProcessorBuilder-D4oYvZeG.d.mts.map +1 -0
  52. package/dist/ProcessorBuilder-_jdZlbfW.d.cts +216 -0
  53. package/dist/ProcessorBuilder-_jdZlbfW.d.cts.map +1 -0
  54. package/dist/{Queue-D9X6OoON.d.mts → Queue-B8HGg439.d.mts} +42 -41
  55. package/dist/Queue-B8HGg439.d.mts.map +1 -0
  56. package/dist/{Queue-DYPB2KWL.d.cts → Queue-C4rijiM7.d.cts} +43 -42
  57. package/dist/Queue-C4rijiM7.d.cts.map +1 -0
  58. package/dist/Queue-D4Iaidrs.cjs +109 -0
  59. package/dist/Queue-D4Iaidrs.cjs.map +1 -0
  60. package/dist/Queue-u8w8_HpE.mjs +104 -0
  61. package/dist/Queue-u8w8_HpE.mjs.map +1 -0
  62. package/dist/QueueBuilder-2wP5lEC8.mjs +118 -0
  63. package/dist/QueueBuilder-2wP5lEC8.mjs.map +1 -0
  64. package/dist/QueueBuilder-BxsZ9o5z.cjs +135 -0
  65. package/dist/QueueBuilder-BxsZ9o5z.cjs.map +1 -0
  66. package/dist/QueueBuilder-CVS_qPuo.d.mts +75 -0
  67. package/dist/QueueBuilder-CVS_qPuo.d.mts.map +1 -0
  68. package/dist/QueueBuilder-SQli59An.d.cts +75 -0
  69. package/dist/QueueBuilder-SQli59An.d.cts.map +1 -0
  70. package/dist/Subscriber-5rCX1Nph.d.cts +83 -0
  71. package/dist/Subscriber-5rCX1Nph.d.cts.map +1 -0
  72. package/dist/Subscriber-CtQXhcL7.d.mts +83 -0
  73. package/dist/Subscriber-CtQXhcL7.d.mts.map +1 -0
  74. package/dist/SubscriberBuilder-CpFhShTJ.mjs +238 -0
  75. package/dist/SubscriberBuilder-CpFhShTJ.mjs.map +1 -0
  76. package/dist/SubscriberBuilder-DJEvNRdD.cjs +261 -0
  77. package/dist/SubscriberBuilder-DJEvNRdD.cjs.map +1 -0
  78. package/dist/Topic-DN2gYJ-p.mjs +99 -0
  79. package/dist/Topic-DN2gYJ-p.mjs.map +1 -0
  80. package/dist/Topic-Dp9Q7Lj2.cjs +104 -0
  81. package/dist/Topic-Dp9Q7Lj2.cjs.map +1 -0
  82. package/dist/adaptors/aws.cjs +147 -168
  83. package/dist/adaptors/aws.cjs.map +1 -1
  84. package/dist/adaptors/aws.d.cts +57 -48
  85. package/dist/adaptors/aws.d.cts.map +1 -1
  86. package/dist/adaptors/aws.d.mts +58 -49
  87. package/dist/adaptors/aws.d.mts.map +1 -1
  88. package/dist/adaptors/aws.mjs +142 -164
  89. package/dist/adaptors/aws.mjs.map +1 -1
  90. package/dist/adaptors/awsWebsocket.cjs +354 -0
  91. package/dist/adaptors/awsWebsocket.cjs.map +1 -0
  92. package/dist/adaptors/awsWebsocket.d.cts +156 -0
  93. package/dist/adaptors/awsWebsocket.d.cts.map +1 -0
  94. package/dist/adaptors/awsWebsocket.d.mts +156 -0
  95. package/dist/adaptors/awsWebsocket.d.mts.map +1 -0
  96. package/dist/adaptors/awsWebsocket.mjs +347 -0
  97. package/dist/adaptors/awsWebsocket.mjs.map +1 -0
  98. package/dist/adaptors/hono.cjs +1 -1
  99. package/dist/adaptors/hono.d.cts +8 -7
  100. package/dist/adaptors/hono.d.cts.map +1 -1
  101. package/dist/adaptors/hono.d.mts +10 -9
  102. package/dist/adaptors/hono.d.mts.map +1 -1
  103. package/dist/adaptors/hono.mjs +1 -1
  104. package/dist/adaptors/testing.cjs +1174 -41
  105. package/dist/adaptors/testing.cjs.map +1 -1
  106. package/dist/adaptors/testing.d.cts +517 -40
  107. package/dist/adaptors/testing.d.cts.map +1 -1
  108. package/dist/adaptors/testing.d.mts +517 -40
  109. package/dist/adaptors/testing.d.mts.map +1 -1
  110. package/dist/adaptors/testing.mjs +1140 -36
  111. package/dist/adaptors/testing.mjs.map +1 -1
  112. package/dist/auth-BqWz2JxC.d.cts +274 -0
  113. package/dist/auth-BqWz2JxC.d.cts.map +1 -0
  114. package/dist/auth-DnB9H9KL.d.mts +274 -0
  115. package/dist/auth-DnB9H9KL.d.mts.map +1 -0
  116. package/dist/auth.cjs +308 -23
  117. package/dist/auth.cjs.map +1 -1
  118. package/dist/auth.d.cts +2 -104
  119. package/dist/auth.d.mts +2 -104
  120. package/dist/auth.mjs +304 -25
  121. package/dist/auth.mjs.map +1 -1
  122. package/dist/cache-CCHcO9Oo.d.mts +44 -0
  123. package/dist/cache-CCHcO9Oo.d.mts.map +1 -0
  124. package/dist/cache-CQjMNPrC.d.cts +44 -0
  125. package/dist/cache-CQjMNPrC.d.cts.map +1 -0
  126. package/dist/cache.cjs +3 -19
  127. package/dist/cache.cjs.map +1 -1
  128. package/dist/cache.d.cts +2 -43
  129. package/dist/cache.d.mts +2 -43
  130. package/dist/cache.mjs +2 -18
  131. package/dist/cache.mjs.map +1 -1
  132. package/dist/cipher-C1lEFX63.mjs +225 -0
  133. package/dist/cipher-C1lEFX63.mjs.map +1 -0
  134. package/dist/cipher-CVxfwLjk.cjs +332 -0
  135. package/dist/cipher-CVxfwLjk.cjs.map +1 -0
  136. package/dist/cipher-DSDxPRIp.d.cts +106 -0
  137. package/dist/cipher-DSDxPRIp.d.cts.map +1 -0
  138. package/dist/cipher-DSDxPRIp.d.mts +106 -0
  139. package/dist/cipher-DSDxPRIp.d.mts.map +1 -0
  140. package/dist/{construct-interface-DPlxfpoS.d.mts → construct-interface-CSA9VeWM.d.mts} +47 -8
  141. package/dist/construct-interface-CSA9VeWM.d.mts.map +1 -0
  142. package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-DugP0E5q.d.cts} +47 -8
  143. package/dist/construct-interface-DugP0E5q.d.cts.map +1 -0
  144. package/dist/construct-interface.cjs +38 -4
  145. package/dist/construct-interface.cjs.map +1 -1
  146. package/dist/construct-interface.d.cts +2 -2
  147. package/dist/construct-interface.d.mts +2 -2
  148. package/dist/construct-interface.mjs +37 -5
  149. package/dist/construct-interface.mjs.map +1 -1
  150. package/dist/credential-DYymbp_7.cjs +257 -0
  151. package/dist/credential-DYymbp_7.cjs.map +1 -0
  152. package/dist/credential-DfSAOOdY.mjs +222 -0
  153. package/dist/credential-DfSAOOdY.mjs.map +1 -0
  154. package/dist/credential.cjs +7 -129
  155. package/dist/credential.d.cts +2 -58
  156. package/dist/credential.d.mts +2 -58
  157. package/dist/credential.mjs +2 -128
  158. package/dist/crons/index.cjs +127 -1
  159. package/dist/crons/index.cjs.map +1 -1
  160. package/dist/crons/index.d.cts +43 -3
  161. package/dist/crons/index.d.cts.map +1 -1
  162. package/dist/crons/index.d.mts +43 -3
  163. package/dist/crons/index.d.mts.map +1 -1
  164. package/dist/crons/index.mjs +126 -2
  165. package/dist/crons/index.mjs.map +1 -1
  166. package/dist/database/kysely.cjs +3 -194
  167. package/dist/database/kysely.d.cts +2 -149
  168. package/dist/database/kysely.d.mts +2 -149
  169. package/dist/database/kysely.mjs +2 -192
  170. package/dist/email.cjs +4 -16
  171. package/dist/email.cjs.map +1 -1
  172. package/dist/email.d.cts +1 -1
  173. package/dist/email.d.cts.map +1 -1
  174. package/dist/email.d.mts +2 -2
  175. package/dist/email.d.mts.map +1 -1
  176. package/dist/email.mjs +2 -14
  177. package/dist/email.mjs.map +1 -1
  178. package/dist/encryption/kms.cjs +95 -0
  179. package/dist/encryption/kms.cjs.map +1 -0
  180. package/dist/encryption/kms.d.cts +7 -0
  181. package/dist/encryption/kms.d.cts.map +1 -0
  182. package/dist/encryption/kms.d.mts +7 -0
  183. package/dist/encryption/kms.d.mts.map +1 -0
  184. package/dist/encryption/kms.mjs +93 -0
  185. package/dist/encryption/kms.mjs.map +1 -0
  186. package/dist/encryption.cjs +116 -0
  187. package/dist/encryption.cjs.map +1 -0
  188. package/dist/encryption.d.cts +37 -0
  189. package/dist/encryption.d.cts.map +1 -0
  190. package/dist/encryption.d.mts +37 -0
  191. package/dist/encryption.d.mts.map +1 -0
  192. package/dist/encryption.mjs +101 -0
  193. package/dist/encryption.mjs.map +1 -0
  194. package/dist/endpoints/index.cjs +32 -10
  195. package/dist/endpoints/index.d.cts +106 -3
  196. package/dist/endpoints/index.d.cts.map +1 -0
  197. package/dist/endpoints/index.d.mts +106 -3
  198. package/dist/endpoints/index.d.mts.map +1 -0
  199. package/dist/endpoints/index.mjs +6 -4
  200. package/dist/expire-C586zznE.d.cts +38 -0
  201. package/dist/expire-C586zznE.d.cts.map +1 -0
  202. package/dist/expire-C586zznE.d.mts +38 -0
  203. package/dist/expire-C586zznE.d.mts.map +1 -0
  204. package/dist/expire-CieftS01.cjs +67 -0
  205. package/dist/expire-CieftS01.cjs.map +1 -0
  206. package/dist/expire-CpzUAfr9.mjs +50 -0
  207. package/dist/expire-CpzUAfr9.mjs.map +1 -0
  208. package/dist/external-api.cjs +106 -0
  209. package/dist/external-api.cjs.map +1 -0
  210. package/dist/external-api.d.cts +2 -0
  211. package/dist/external-api.d.mts +2 -0
  212. package/dist/external-api.mjs +103 -0
  213. package/dist/external-api.mjs.map +1 -0
  214. package/dist/fake-BqhP8RRQ.d.mts +201 -0
  215. package/dist/fake-BqhP8RRQ.d.mts.map +1 -0
  216. package/dist/fake-DqieDYYA.d.cts +201 -0
  217. package/dist/fake-DqieDYYA.d.cts.map +1 -0
  218. package/dist/file-server.cjs +123 -30
  219. package/dist/file-server.cjs.map +1 -1
  220. package/dist/file-server.d.cts +115 -1
  221. package/dist/file-server.d.cts.map +1 -1
  222. package/dist/file-server.d.mts +115 -1
  223. package/dist/file-server.d.mts.map +1 -1
  224. package/dist/file-server.mjs +122 -32
  225. package/dist/file-server.mjs.map +1 -1
  226. package/dist/functions/index.cjs +1 -1
  227. package/dist/functions/index.d.cts +2 -1
  228. package/dist/functions/index.d.mts +2 -1
  229. package/dist/functions/index.mjs +1 -1
  230. package/dist/{functions-C53GW2eQ.mjs → functions-BvIDQKAA.mjs} +117 -22
  231. package/dist/functions-BvIDQKAA.mjs.map +1 -0
  232. package/dist/{functions-B6qCvfmy.cjs → functions-DLF6-IK8.cjs} +122 -18
  233. package/dist/functions-DLF6-IK8.cjs.map +1 -0
  234. package/dist/inbox-CR3L1fOI.d.cts +195 -0
  235. package/dist/inbox-CR3L1fOI.d.cts.map +1 -0
  236. package/dist/inbox-YOdxlyfj.d.mts +195 -0
  237. package/dist/inbox-YOdxlyfj.d.mts.map +1 -0
  238. package/dist/inbox.cjs +291 -0
  239. package/dist/inbox.cjs.map +1 -0
  240. package/dist/inbox.d.cts +2 -0
  241. package/dist/inbox.d.mts +2 -0
  242. package/dist/inbox.mjs +283 -0
  243. package/dist/inbox.mjs.map +1 -0
  244. package/dist/index-BoQ3-M-K.d.mts +115 -0
  245. package/dist/index-BoQ3-M-K.d.mts.map +1 -0
  246. package/dist/index-DPTHa6Ud.d.cts +115 -0
  247. package/dist/index-DPTHa6Ud.d.cts.map +1 -0
  248. package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
  249. package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
  250. package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
  251. package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
  252. package/dist/index.cjs +4 -1
  253. package/dist/index.d.cts +26 -3
  254. package/dist/index.d.cts.map +1 -0
  255. package/dist/index.d.mts +26 -3
  256. package/dist/index.d.mts.map +1 -0
  257. package/dist/index.mjs +3 -2
  258. package/dist/kysely-CebjCWTl.d.cts +216 -0
  259. package/dist/kysely-CebjCWTl.d.cts.map +1 -0
  260. package/dist/kysely-Cs4uPO8k.mjs +371 -0
  261. package/dist/kysely-Cs4uPO8k.mjs.map +1 -0
  262. package/dist/kysely-CukArHJ0.cjs +384 -0
  263. package/dist/kysely-CukArHJ0.cjs.map +1 -0
  264. package/dist/kysely-De5rAC-E.d.mts +216 -0
  265. package/dist/kysely-De5rAC-E.d.mts.map +1 -0
  266. package/dist/{telemetry-DGcFlVpB.d.cts → lambdaTelemetry-8vnmVZQ5.d.cts} +2 -2
  267. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +1 -0
  268. package/dist/{telemetry-DGcFlVpB.d.mts → lambdaTelemetry-8vnmVZQ5.d.mts} +2 -2
  269. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +1 -0
  270. package/dist/mobile-app.cjs +74 -0
  271. package/dist/mobile-app.cjs.map +1 -0
  272. package/dist/mobile-app.d.cts +73 -0
  273. package/dist/mobile-app.d.cts.map +1 -0
  274. package/dist/mobile-app.d.mts +73 -0
  275. package/dist/mobile-app.d.mts.map +1 -0
  276. package/dist/mobile-app.mjs +73 -0
  277. package/dist/mobile-app.mjs.map +1 -0
  278. package/dist/object-storage.cjs +8 -1
  279. package/dist/object-storage.cjs.map +1 -1
  280. package/dist/object-storage.d.cts +10 -1
  281. package/dist/object-storage.d.cts.map +1 -1
  282. package/dist/object-storage.d.mts +10 -1
  283. package/dist/object-storage.d.mts.map +1 -1
  284. package/dist/object-storage.mjs +7 -2
  285. package/dist/object-storage.mjs.map +1 -1
  286. package/dist/optionalPeers-D7Wt6dnF.mjs +140 -0
  287. package/dist/optionalPeers-D7Wt6dnF.mjs.map +1 -0
  288. package/dist/optionalPeers-DuNQXXe1.cjs +223 -0
  289. package/dist/optionalPeers-DuNQXXe1.cjs.map +1 -0
  290. package/dist/origins-BjxYht13.cjs +96 -0
  291. package/dist/origins-BjxYht13.cjs.map +1 -0
  292. package/dist/origins-Boc9qbo-.mjs +73 -0
  293. package/dist/origins-Boc9qbo-.mjs.map +1 -0
  294. package/dist/pattern-C1CEcglD.mjs +241 -0
  295. package/dist/pattern-C1CEcglD.mjs.map +1 -0
  296. package/dist/pattern-QFaUIr77.cjs +288 -0
  297. package/dist/pattern-QFaUIr77.cjs.map +1 -0
  298. package/dist/privateAddress-Bg5fUsbp.mjs +21 -0
  299. package/dist/privateAddress-Bg5fUsbp.mjs.map +1 -0
  300. package/dist/privateAddress-CqGyuFHn.cjs +26 -0
  301. package/dist/privateAddress-CqGyuFHn.cjs.map +1 -0
  302. package/dist/processors/index.cjs +214 -0
  303. package/dist/processors/index.cjs.map +1 -0
  304. package/dist/processors/index.d.cts +78 -0
  305. package/dist/processors/index.d.cts.map +1 -0
  306. package/dist/processors/index.d.mts +78 -0
  307. package/dist/processors/index.d.mts.map +1 -0
  308. package/dist/processors/index.mjs +193 -0
  309. package/dist/processors/index.mjs.map +1 -0
  310. package/dist/queue/index.cjs +5 -192
  311. package/dist/queue/index.d.cts +3 -53
  312. package/dist/queue/index.d.mts +3 -53
  313. package/dist/queue/index.mjs +3 -190
  314. package/dist/random-password.cjs +86 -0
  315. package/dist/random-password.cjs.map +1 -0
  316. package/dist/random-password.d.cts +30 -0
  317. package/dist/random-password.d.cts.map +1 -0
  318. package/dist/random-password.d.mts +30 -0
  319. package/dist/random-password.d.mts.map +1 -0
  320. package/dist/random-password.mjs +84 -0
  321. package/dist/random-password.mjs.map +1 -0
  322. package/dist/readRequestBody-BmKnPl0a.mjs +293 -0
  323. package/dist/readRequestBody-BmKnPl0a.mjs.map +1 -0
  324. package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-CN9GVdeE.cjs} +141 -47
  325. package/dist/readRequestBody-CN9GVdeE.cjs.map +1 -0
  326. package/dist/{processAudits-D_2W5x8k.cjs → requestLogger-CnoYd-Ah.cjs} +63 -3
  327. package/dist/requestLogger-CnoYd-Ah.cjs.map +1 -0
  328. package/dist/{processAudits-BpRlPQMW.mjs → requestLogger-D2JS7pPM.mjs} +51 -3
  329. package/dist/requestLogger-D2JS7pPM.mjs.map +1 -0
  330. package/dist/rest-api.cjs +85 -70
  331. package/dist/rest-api.cjs.map +1 -1
  332. package/dist/rest-api.d.cts +77 -59
  333. package/dist/rest-api.d.cts.map +1 -1
  334. package/dist/rest-api.d.mts +77 -59
  335. package/dist/rest-api.d.mts.map +1 -1
  336. package/dist/rest-api.mjs +87 -72
  337. package/dist/rest-api.mjs.map +1 -1
  338. package/dist/runSubscriber-HEqXkin1.mjs +117 -0
  339. package/dist/runSubscriber-HEqXkin1.mjs.map +1 -0
  340. package/dist/runSubscriber-sVJfLA0-.cjs +134 -0
  341. package/dist/runSubscriber-sVJfLA0-.cjs.map +1 -0
  342. package/dist/shutdown-BMJmAhSt.cjs +38 -0
  343. package/dist/shutdown-BMJmAhSt.cjs.map +1 -0
  344. package/dist/shutdown-C7xa8x9S.mjs +27 -0
  345. package/dist/shutdown-C7xa8x9S.mjs.map +1 -0
  346. package/dist/site.cjs +104 -8
  347. package/dist/site.cjs.map +1 -1
  348. package/dist/site.d.cts +132 -2
  349. package/dist/site.d.cts.map +1 -1
  350. package/dist/site.d.mts +132 -2
  351. package/dist/site.d.mts.map +1 -1
  352. package/dist/site.mjs +102 -11
  353. package/dist/site.mjs.map +1 -1
  354. package/dist/stages-DaTaoQei.d.cts +73 -0
  355. package/dist/stages-DaTaoQei.d.cts.map +1 -0
  356. package/dist/stages-DaTaoQei.d.mts +73 -0
  357. package/dist/stages-DaTaoQei.d.mts.map +1 -0
  358. package/dist/subscribers/index.cjs +134 -1
  359. package/dist/subscribers/index.cjs.map +1 -0
  360. package/dist/subscribers/index.d.cts +74 -3
  361. package/dist/subscribers/index.d.cts.map +1 -0
  362. package/dist/subscribers/index.d.mts +74 -3
  363. package/dist/subscribers/index.d.mts.map +1 -0
  364. package/dist/subscribers/index.mjs +132 -2
  365. package/dist/subscribers/index.mjs.map +1 -0
  366. package/dist/telemetry-C1oqncFY.d.cts +40 -0
  367. package/dist/telemetry-C1oqncFY.d.cts.map +1 -0
  368. package/dist/telemetry-CObow3Dn.d.mts +40 -0
  369. package/dist/telemetry-CObow3Dn.d.mts.map +1 -0
  370. package/dist/telemetry.cjs +56 -0
  371. package/dist/telemetry.cjs.map +1 -0
  372. package/dist/telemetry.d.cts +2 -0
  373. package/dist/telemetry.d.mts +2 -0
  374. package/dist/telemetry.mjs +55 -0
  375. package/dist/telemetry.mjs.map +1 -0
  376. package/dist/topic/index.cjs +2 -134
  377. package/dist/topic/index.d.cts +2 -3
  378. package/dist/topic/index.d.mts +2 -3
  379. package/dist/topic/index.mjs +2 -132
  380. package/dist/tracing-Bbj1uoFJ.mjs +127 -0
  381. package/dist/tracing-Bbj1uoFJ.mjs.map +1 -0
  382. package/dist/tracing-C0ooU0V2.cjs +150 -0
  383. package/dist/tracing-C0ooU0V2.cjs.map +1 -0
  384. package/dist/websocket-api-Bg9SowJ5.mjs +1710 -0
  385. package/dist/websocket-api-Bg9SowJ5.mjs.map +1 -0
  386. package/dist/websocket-api-CPEzJyDt.d.mts +1201 -0
  387. package/dist/websocket-api-CPEzJyDt.d.mts.map +1 -0
  388. package/dist/websocket-api-DkF8Hva-.d.cts +1201 -0
  389. package/dist/websocket-api-DkF8Hva-.d.cts.map +1 -0
  390. package/dist/websocket-api-czxhekGG.cjs +1889 -0
  391. package/dist/websocket-api-czxhekGG.cjs.map +1 -0
  392. package/dist/websocket-api.cjs +35 -0
  393. package/dist/websocket-api.d.cts +2 -0
  394. package/dist/websocket-api.d.mts +2 -0
  395. package/dist/websocket-api.mjs +3 -0
  396. package/dist/worker.cjs +174 -32
  397. package/dist/worker.cjs.map +1 -1
  398. package/dist/worker.d.cts +147 -47
  399. package/dist/worker.d.cts.map +1 -1
  400. package/dist/worker.d.mts +147 -47
  401. package/dist/worker.d.mts.map +1 -1
  402. package/dist/worker.mjs +175 -33
  403. package/dist/worker.mjs.map +1 -1
  404. package/package.json +180 -43
  405. package/dist/Construct-BeYVu_QF.mjs.map +0 -1
  406. package/dist/Construct-DfbwIntp.d.cts +0 -115
  407. package/dist/Construct-DfbwIntp.d.cts.map +0 -1
  408. package/dist/Construct-DqdlARxq.cjs.map +0 -1
  409. package/dist/Construct-l5aOn_jv.d.mts +0 -115
  410. package/dist/Construct-l5aOn_jv.d.mts.map +0 -1
  411. package/dist/Cron-l4Wlz6G9.d.mts.map +0 -1
  412. package/dist/Cron-zsoSAwZo.d.cts.map +0 -1
  413. package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
  414. package/dist/CronBuilder-CyT71Nzg.d.cts +0 -41
  415. package/dist/CronBuilder-CyT71Nzg.d.cts.map +0 -1
  416. package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
  417. package/dist/CronBuilder-UoNgFe8S.d.mts +0 -41
  418. package/dist/CronBuilder-UoNgFe8S.d.mts.map +0 -1
  419. package/dist/Endpoint-BpZHtJ2W.cjs +0 -1689
  420. package/dist/Endpoint-BpZHtJ2W.cjs.map +0 -1
  421. package/dist/Endpoint-DBflWAe4.d.cts.map +0 -1
  422. package/dist/Endpoint-ONsly_dq.mjs +0 -1671
  423. package/dist/Endpoint-ONsly_dq.mjs.map +0 -1
  424. package/dist/Endpoint-oS-Fe3d_.d.mts.map +0 -1
  425. package/dist/EndpointFactory-Bm3aKRdV.mjs.map +0 -1
  426. package/dist/EndpointFactory-CLvWuHyt.cjs.map +0 -1
  427. package/dist/HonoEndpointAdaptor-92zavCsV.cjs.map +0 -1
  428. package/dist/HonoEndpointAdaptor-yYaU7jVJ.mjs.map +0 -1
  429. package/dist/Queue-D9X6OoON.d.mts.map +0 -1
  430. package/dist/Queue-DYPB2KWL.d.cts.map +0 -1
  431. package/dist/Subscriber-C4heaAyO.d.mts +0 -51
  432. package/dist/Subscriber-C4heaAyO.d.mts.map +0 -1
  433. package/dist/Subscriber-CotDUELC.d.cts +0 -51
  434. package/dist/Subscriber-CotDUELC.d.cts.map +0 -1
  435. package/dist/SubscriberBuilder-BEv0eoHy.d.cts +0 -59
  436. package/dist/SubscriberBuilder-BEv0eoHy.d.cts.map +0 -1
  437. package/dist/SubscriberBuilder-C0ZEtGDI.cjs +0 -125
  438. package/dist/SubscriberBuilder-C0ZEtGDI.cjs.map +0 -1
  439. package/dist/SubscriberBuilder-h7B_cHMr.mjs +0 -114
  440. package/dist/SubscriberBuilder-h7B_cHMr.mjs.map +0 -1
  441. package/dist/SubscriberBuilder-tyH5yTk5.d.mts +0 -59
  442. package/dist/SubscriberBuilder-tyH5yTk5.d.mts.map +0 -1
  443. package/dist/Topic-DEVGo0Dm.d.cts +0 -89
  444. package/dist/Topic-DEVGo0Dm.d.cts.map +0 -1
  445. package/dist/Topic-zk_6Gthr.d.mts +0 -89
  446. package/dist/Topic-zk_6Gthr.d.mts.map +0 -1
  447. package/dist/auth.d.cts.map +0 -1
  448. package/dist/auth.d.mts.map +0 -1
  449. package/dist/cache.d.cts.map +0 -1
  450. package/dist/cache.d.mts.map +0 -1
  451. package/dist/construct-interface-DPlxfpoS.d.mts.map +0 -1
  452. package/dist/construct-interface-DgXTJcOD.d.cts.map +0 -1
  453. package/dist/credential.cjs.map +0 -1
  454. package/dist/credential.d.cts.map +0 -1
  455. package/dist/credential.d.mts.map +0 -1
  456. package/dist/credential.mjs.map +0 -1
  457. package/dist/database/kysely.cjs.map +0 -1
  458. package/dist/database/kysely.d.cts.map +0 -1
  459. package/dist/database/kysely.d.mts.map +0 -1
  460. package/dist/database/kysely.mjs.map +0 -1
  461. package/dist/functions-B6qCvfmy.cjs.map +0 -1
  462. package/dist/functions-C53GW2eQ.mjs.map +0 -1
  463. package/dist/index-B2urf3YI.d.cts +0 -26
  464. package/dist/index-B2urf3YI.d.cts.map +0 -1
  465. package/dist/index-C1ZwNOOk.d.cts.map +0 -1
  466. package/dist/index-Cc4kKPag.d.mts.map +0 -1
  467. package/dist/index-DMCDvnsM.d.mts +0 -26
  468. package/dist/index-DMCDvnsM.d.mts.map +0 -1
  469. package/dist/index-D_frT6MP.d.cts +0 -165
  470. package/dist/index-D_frT6MP.d.cts.map +0 -1
  471. package/dist/index-DcyIYbDS.d.mts +0 -165
  472. package/dist/index-DcyIYbDS.d.mts.map +0 -1
  473. package/dist/lazyAccessors-BHtcqgz2.mjs +0 -211
  474. package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
  475. package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
  476. package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
  477. package/dist/processAudits-D_2W5x8k.cjs.map +0 -1
  478. package/dist/queue/index.cjs.map +0 -1
  479. package/dist/queue/index.d.cts.map +0 -1
  480. package/dist/queue/index.d.mts.map +0 -1
  481. package/dist/queue/index.mjs.map +0 -1
  482. package/dist/telemetry-DGcFlVpB.d.cts.map +0 -1
  483. package/dist/telemetry-DGcFlVpB.d.mts.map +0 -1
  484. package/dist/topic/index.cjs.map +0 -1
  485. package/dist/topic/index.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"worker.d.cts","names":["_$__topic0.TopicMessage","_$__construct_interface0.ServicesOf","_$__functions0.FunctionHandler","_$__functions0.Function"],"sources":["../src/worker.ts"],"mappings":";;;;;;;;;;;;;;;iBAiFiB;;;;;;;;;EAShB,SAAS;;;;;;;EAOT,YAAY;;qBAGA,OAAO,0CACR,WAAW;mBAkBJ;;mBAEA;WAlBT,IAAI;;WAGJ,QAAQ;;WAGR,WAAW;;;;;WAMX,gBAAgB;EAEzB,YACC,IAAI,cAAc,QACD,SAAQ,cAER;;EAAA,wBAAuB,cACxC,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAkCjB,SAAS,GAAG,wBACX,QAAQ,WAAW,SAAS,KAC1B,OAAO;;;;;;EAcV,KAAK,UAAU,qBAAkB,YAAA,0BAAA,WAAA;;;;;;;;;;;EAcjC,MAAM,2BAA2B,gBAAgB,aAChD,OAAO,MAAM,YAAY,WAAQ,sBAAA,mBAAA,eAAAA,aAAA;;;;;;;;;EAalC,UAAU,UAAU,qBAAqB,yBACxC,SAAS,QAAQ,UAAU,KAAK,WAAW,UAAU,KAAE,sBAAA,mBAAA;;;;;;;;;;;;EAkBxD,MAAM,UAAU,0BAA0B,QAAQ,IAAC,gBAAA,kBAAA,iEAAA;EAInD,OAAO,UAAU,kBAAkB,QAAQ,IAAC,gBAAA,0BAAA,OAAA,iEAAA;EAI5C,QAAQ,aAAU,gBAAA,yCAAA,iEAAA;EAIlB,WAAW,aAAU,gBAAA,yCAAA,iEAAA;EAIrB,gBAAgB,mBAAmB,cAAc,YAAY,IAAC,gBAAA,yCAAAC,WAAA,KAAA,iEAAA;EAI9D,SAAS,UAAU,WAAW,UAAU,IAAC,gBAAA,yCAAA,IAAA,iEAAA;;;;;;EASzC,UACI,MAAM,WACR,WAAW,OAAO,2CAClBE,SAAA,8BAAA,4EAAA,kCAAAD,gBAAA,8BAAA,yCAAA;;UAMM;;cAKI;;;;;;;EAUZ,MAAM,qBAAqB,eAAe,OAAO;;;;;UAazC;EASR,WAAW"}
1
+ {"version":3,"file":"worker.d.cts","names":["EventPublisher","_$__topic0.TopicMessage","_$__construct_interface0.ServicesOf","_$__functions0.FunctionHandler","_$__functions0.Function"],"sources":["../src/subscribers/InboxSubscriberBuilder.ts","../src/worker.ts"],"mappings":"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"}
package/dist/worker.d.mts CHANGED
@@ -1,17 +1,59 @@
1
- import { t as StandardSchemaV1 } from "./index-CeEtxDmK.mjs";
2
- import { a as FunctionHandler, r as Function, t as FunctionBuilder } from "./index-DcyIYbDS.mjs";
3
- import { n as Consumable, r as Declarable, s as ServicesOf } from "./construct-interface-DPlxfpoS.mjs";
4
- import { i as ScheduleExpression } from "./Cron-l4Wlz6G9.mjs";
5
- import { t as CronBuilder } from "./CronBuilder-UoNgFe8S.mjs";
6
- import { n as TopicEvents, r as TopicMessage, t as Topic } from "./Topic-zk_6Gthr.mjs";
7
- import { t as SubscriberBuilder } from "./SubscriberBuilder-tyH5yTk5.mjs";
8
- import "./index-DMCDvnsM.mjs";
9
- import { ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
1
+ import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.mjs";
2
+ import { c as Topic, l as TopicEvents, u as TopicMessage } from "./Construct-BMk_CRSD.mjs";
3
+ import { i as FunctionHandler, n as Function, t as DatabaseContext } from "./Function-BKReud5p.mjs";
4
+ import { c as ServicesOf, i as Declarable, r as Consumable } from "./construct-interface-CSA9VeWM.mjs";
5
+ import { t as FunctionBuilder } from "./index-BoQ3-M-K.mjs";
6
+ import { i as ScheduleExpression } from "./Cron-D6Y7BBt3.mjs";
7
+ import { n as Telemetry } from "./telemetry-CObow3Dn.mjs";
8
+ import { t as Subscriber } from "./Subscriber-CtQXhcL7.mjs";
9
+ import { i as InboxClient, l as ReceiptNotification, n as Inbox, o as InboxMessage } from "./inbox-YOdxlyfj.mjs";
10
+ import { t as CronBuilder } from "./CronBuilder-4BZhkChG.mjs";
11
+ import { ObjectStorage } from "./object-storage.mjs";
12
+ import { t as QueueBuilder } from "./QueueBuilder-CVS_qPuo.mjs";
13
+ import { n as ObjectSubscriberBuilder, o as SubscriberBuilder } from "./ObjectSubscriberBuilder-DfzXQEKW.mjs";
14
+ import "./topic/index.mjs";
15
+ import { ConstructName, Declaration, Dependency, INBOX_EVENT } from "@geekmidas/manifest";
16
+ import { EventPublisher as EventPublisher$1 } from "@geekmidas/events";
17
+ import { Service, ServiceRecord } from "@geekmidas/services";
10
18
  import { EnvironmentParser } from "@geekmidas/envkit";
11
- import { EventPublisher } from "@geekmidas/events";
12
- import { Service } from "@geekmidas/services";
13
19
  import { Logger } from "@geekmidas/logger";
14
- import { ComposableStandardSchema } from "@geekmidas/schema";
20
+ import { ComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
21
+ //#region src/subscribers/InboxSubscriberBuilder.d.ts
22
+ type InboxSubscriber<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TDatabase = undefined, TDatabaseServiceName extends string = string> = Subscriber<TServices, TLogger, OutSchema, EventPublisher$1<{
23
+ type: typeof INBOX_EVENT;
24
+ payload: ReceiptNotification;
25
+ }>, [typeof INBOX_EVENT], TDatabase, TDatabaseServiceName>;
26
+ type InboxSubscriberContext<TServices extends Service[] = [], TLogger extends Logger = Logger, TDatabase = undefined> = {
27
+ /** The messages received, one per envelope recipient the inbox takes. */
28
+ messages: InboxMessage[];
29
+ /** The inbox, under its own id too: its domain and its raw messages. */
30
+ inbox: InboxClient;
31
+ services: ServiceRecord<TServices>;
32
+ logger: TLogger;
33
+ } & DatabaseContext<TDatabase>;
34
+ type InboxSubscriberHandler<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TDatabase = undefined> = (ctx: InboxSubscriberContext<TServices, TLogger, TDatabase>) => OutSchema extends StandardSchemaV1 ? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>> : any | Promise<any>;
35
+ declare class InboxSubscriberBuilder<TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TDatabase = undefined, TDatabaseServiceName extends string = string> {
36
+ private readonly inner;
37
+ private readonly inbox;
38
+ private readonly acceptsAutomated;
39
+ constructor(inner: SubscriberBuilder<any, any, any, any, any, any, any>, inbox: Inbox<string>, acceptsAutomated?: boolean);
40
+ /**
41
+ * Hands this handler mail marked `Auto-Submitted` too — auto-replies,
42
+ * out-of-office notices, bounces — which are otherwise dropped so a reply
43
+ * can never be answered by another. A handler that takes them should not
44
+ * reply to them.
45
+ */
46
+ automated(): this;
47
+ dependsOn<const T extends readonly Consumable[]>(constructs: T): InboxSubscriberBuilder<[...TServices, ...ServicesOf<T>], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
48
+ services<T extends Service[]>(services: T): InboxSubscriberBuilder<[...TServices, ...T], TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
49
+ database<T, TDbName extends string>(source: Consumable<TDbName, T> | Service<TDbName, T>): InboxSubscriberBuilder<TServices, TLogger, OutSchema, T, TDbName>;
50
+ timeout(timeout: number): this;
51
+ output<T extends StandardSchemaV1>(schema: T): InboxSubscriberBuilder<TServices, TLogger, T, TDatabase, TDatabaseServiceName>;
52
+ logger<T extends Logger>(logger: T): InboxSubscriberBuilder<TServices, T, OutSchema, TDatabase, TDatabaseServiceName>;
53
+ handle(fn: InboxSubscriberHandler<TServices, TLogger, OutSchema, TDatabase>): InboxSubscriber<TServices, TLogger, OutSchema, TDatabase, TDatabaseServiceName>;
54
+ private with;
55
+ }
56
+ //#endregion
15
57
  //#region src/worker.d.ts
16
58
  export interface WorkerConfig {
17
59
  /**
@@ -30,10 +72,16 @@ export interface WorkerConfig {
30
72
  * which is what an application's own `config/env.ts` always was.
31
73
  */
32
74
  envParser?: EnvironmentParser<{}>;
75
+ /**
76
+ * What the worker's process emits — the `Telemetry` construct, passed like
77
+ * the logger. An edge to the node: the deploy hands the process the
78
+ * `OTEL_*` keys its stage resolves.
79
+ */
80
+ telemetry?: Telemetry;
33
81
  }
34
- export declare class Worker<TName extends string = string> implements Declarable<TName> {
82
+ export declare class Worker<TName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string> implements Declarable<TName> {
35
83
  private readonly config;
36
- /** Internal: how `.calls()` carries edges into the copy it returns. */
84
+ /** Internal: how `.database()` carries its edge into the copy it returns. */
37
85
  private readonly dependencies;
38
86
  readonly id: TName;
39
87
  /** Always defined — the worker's own, or the console logger. */
@@ -42,14 +90,18 @@ export declare class Worker<TName extends string = string> implements Declarable
42
90
  readonly envParser: EnvironmentParser<{}>;
43
91
  /**
44
92
  * Where this worker's schedules live, when it has crons and a server runs
45
- * them. `undefined` until `.database(…)` says.
93
+ * them — and the database everything built from it receives as `db`.
94
+ * `undefined` until `.database(…)` says.
46
95
  */
47
96
  readonly scheduleStore?: Consumable<string, unknown>;
48
97
  constructor(id: ConstructName<TName>, config?: WorkerConfig,
49
- /** Internal: how `.calls()` carries edges into the copy it returns. */
98
+ /** Internal: how `.database()` carries its edge into the copy it returns. */
50
99
  dependencies?: readonly Dependency[], scheduleStore?: Consumable<string, unknown>);
51
100
  /**
52
- * The database this worker keeps its schedules in.
101
+ * The database this worker keeps its schedules in, and the one everything
102
+ * built from it — crons, queues, subscribers, functions — receives as `db`.
103
+ * One of them that works against another database names it with its own
104
+ * `.database(other)`, which replaces this one for that runnable alone.
53
105
  *
54
106
  * Only a server target uses it. On AWS a cron is an EventBridge rule
55
107
  * invoking a Lambda and nothing here is consulted — but a server has nothing
@@ -66,35 +118,83 @@ export declare class Worker<TName extends string = string> implements Declarable
66
118
  * @example
67
119
  * ```ts
68
120
  * export const jobs = new Worker('Jobs', { logger }).database(database);
121
+ *
122
+ * export const sweep = jobs
123
+ * .cron('rate(1 hour)')
124
+ * .handle(async ({ db }) => db.deleteFrom('sessions').execute());
69
125
  * ```
70
126
  */
71
- database<T, TDbName extends string>(source: Consumable<TDbName, T>): Worker<TName>;
127
+ database<T, TDbName extends string>(source: Consumable<TDbName, T>): Worker<TName, T, TDbName>;
72
128
  /**
73
129
  * A scheduled runnable.
74
130
  *
75
131
  * @example `worker.cron('rate(1 day)').handle(async ({ logger }) => { … })`
76
132
  */
77
- cron(schedule: ScheduleExpression): CronBuilder<ComposableStandardSchema, Service[], Logger, undefined, undefined, string, undefined, string>;
133
+ cron(schedule: ScheduleExpression): CronBuilder<ComposableStandardSchema, Service[], Logger, undefined, TDatabase, TDatabaseServiceName>;
78
134
  /**
79
- * A runnable that consumes a topic.
135
+ * A queue and its one consumer, run by this worker.
80
136
  *
81
- * Binding is not publishing: a consumer is handed the topic's event types
82
- * and no connection string it could publish with. Chain `.publishes(…)` when
83
- * the handler emits follow-up events, which is the only reason it would need
84
- * one.
137
+ * One construct, because a queue has exactly one consumer: nothing else can
138
+ * attach a second, or forget to attach the first. Producers send to it by
139
+ * depending on it — `.dependsOn([emails])` makes `services.emails` the
140
+ * publisher.
85
141
  *
86
- * @example `worker.topic(users).subscribe(['user.created']).handle(…)`
142
+ * @example
143
+ * ```ts
144
+ * export const emails = worker
145
+ * .queue('Emails')
146
+ * .message(z.object({ userId: z.uuid(), template: z.string() }))
147
+ * .handle(async ({ messages, services }) => { … });
148
+ * ```
87
149
  */
88
- topic<TTopicName extends string, TEvents extends TopicEvents>(topic: Topic<TTopicName, TEvents>): SubscriberBuilder<[], Logger, undefined, EventPublisher<TopicMessage<TEvents_1>>, string, []>;
150
+ queue<TQueueName extends string>(name: TQueueName): QueueBuilder<TQueueName, undefined, [], Logger, TDatabase, TDatabaseServiceName>;
89
151
  /**
90
- * A runnable that consumes events typed from a publisher service.
152
+ * A runnable that reacts to a bucket's objects changing.
153
+ *
154
+ * A bucket is a topic whose publisher is the storage: the binding is the
155
+ * same as {@link Worker.topic}'s, and so is everything after it — the
156
+ * services, the database, how it is delivered. The handler is handed the
157
+ * objects; reading one still means depending on the bucket,
158
+ * `.dependsOn([uploads])`.
91
159
  *
92
- * The older of the two ways to bind a subscriber, kept for a project whose
93
- * events come from a hand-written publisher rather than a `Topic`
94
- * construct. `topic()` is the one to reach for: it types the events the same
95
- * way and hands the consumer no connection string it could publish with.
160
+ * @example
161
+ * ```ts
162
+ * export const onAvatar = worker
163
+ * .objects(uploads)
164
+ * .on(['object.created'], { prefix: 'avatars/', suffix: '.png' })
165
+ * .handle(async ({ objects }) => { … });
166
+ * ```
96
167
  */
97
- publisher<T extends EventPublisher<any>, TPubName extends string>(service: Service<TPubName, T> | Consumable<TPubName, T>): SubscriberBuilder<[], Logger, undefined, EventPublisher<any>, string, []>;
168
+ objects<TBucketName extends string>(bucket: ObjectStorage<TBucketName>): ObjectSubscriberBuilder<[], Logger, undefined, [], TDatabase, TDatabaseServiceName>;
169
+ /**
170
+ * A runnable handed the mail an {@link Inbox} receives.
171
+ *
172
+ * Bound, as a topic subscriber is: the inbox's topic is what it consumes,
173
+ * and what it is handed is the messages on it, parsed — one per envelope
174
+ * recipient the inbox receives at. It reads its inbox's raw messages
175
+ * without depending on it; anything else it uses it names, as ever.
176
+ *
177
+ * @example
178
+ * ```ts
179
+ * export const onRequest = worker
180
+ * .inbox(requests)
181
+ * .handle(async ({ messages, db }) => {
182
+ * for (const message of messages) message.recipient.subdomain;
183
+ * });
184
+ * ```
185
+ */
186
+ inbox<TInboxName extends string>(inbox: Inbox<TInboxName>): InboxSubscriberBuilder<[], Logger, undefined, TDatabase, TDatabaseServiceName>;
187
+ /**
188
+ * A runnable that consumes a topic.
189
+ *
190
+ * Binding is not publishing: a consumer is handed the topic's event types
191
+ * and no connection string it could publish with. A handler that emits
192
+ * follow-up events depends on the topic it emits to —
193
+ * `.dependsOn([orders])` — which is the only reason it would need one.
194
+ *
195
+ * @example `worker.topic(users).subscribe(['user.created']).handle(…)`
196
+ */
197
+ topic<TTopicName extends string, TEvents extends TopicEvents>(topic: Topic<TTopicName, TEvents>): SubscriberBuilder<[], Logger, undefined, EventPublisher<TopicMessage<TEvents_1>>, [], TDatabase, TDatabaseServiceName>;
98
198
  /**
99
199
  * Everything below builds a function — the runnable with no schedule and no
100
200
  * topic, invoked by something else.
@@ -106,32 +206,32 @@ export declare class Worker<TName extends string = string> implements Declarable
106
206
  * makes a cron, a topic makes a subscriber, and anything else makes a
107
207
  * function.
108
208
  */
109
- input<T extends ComposableStandardSchema>(schema: T): FunctionBuilder<T, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
110
- output<T extends StandardSchemaV1>(schema: T): FunctionBuilder<ComposableStandardSchema, T, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
111
- timeout(ms: number): FunctionBuilder<ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
112
- memorySize(mb: number): FunctionBuilder<ComposableStandardSchema, undefined, [], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
113
- dependsOn<const T extends readonly Consumable[]>(constructs: T): FunctionBuilder<ComposableStandardSchema, undefined, [...ServicesOf<T>], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
114
- services<T extends Service[]>(services: T): FunctionBuilder<ComposableStandardSchema, undefined, [...T], Logger, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>>;
209
+ input<T extends ComposableStandardSchema>(schema: T): FunctionBuilder<T, undefined, [], Logger, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>>;
210
+ output<T extends StandardSchemaV1>(schema: T): FunctionBuilder<any, T, [], Logger, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>>;
211
+ timeout(ms: number): FunctionBuilder<any, undefined, [], Logger, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>>;
212
+ memorySize(mb: number): FunctionBuilder<any, undefined, [], Logger, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>>;
213
+ dependsOn<const T extends readonly Consumable[]>(constructs: T): FunctionBuilder<any, undefined, [...ServicesOf<T>], Logger, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>>;
214
+ services<T extends Service[]>(services: T): FunctionBuilder<any, undefined, [...T], Logger, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>>;
115
215
  /**
116
216
  * A function with no input schema — the shortest runnable there is.
117
217
  *
118
218
  * @example `worker.handle(async ({ logger }) => { … })`
119
219
  */
120
- handle(...args: Parameters<ReturnType<Worker<TName>['schemalessFunction']>['handle']>): Function<ComposableStandardSchema, [], Logger, undefined, undefined, string, undefined, string, undefined, string, AuditableAction<string, unknown>, FunctionHandler<ComposableStandardSchema, [], Logger, undefined, undefined, undefined, AuditableAction<string, unknown>>>;
220
+ handle(...args: Parameters<ReturnType<Worker<TName, TDatabase, TDatabaseServiceName>['schemalessFunction']>['handle']>): Function<any, [], Logger, undefined, undefined, string, TDatabase, TDatabaseServiceName, AuditableAction<string, unknown>, FunctionHandler<any, [], Logger, undefined, TDatabase, undefined, AuditableAction<string, unknown>>>;
121
221
  /** The builder `handle` delegates to, named so its type can be referred to. */
122
222
  private schemalessFunction;
123
223
  /** The function builder the delegating methods above are built on. */
124
224
  private get functions();
125
- /**
126
- * Resources and surfaces this worker calls.
127
- *
128
- * Not `.dependsOn()`: this records the edge that derives the worker's
129
- * environment and its access, the same distinction `RestApi.calls()` draws.
130
- */
131
- calls(constructs: readonly Declarable[]): Worker<TName>;
132
225
  /**
133
226
  * Stamps this worker's id onto a builder, so everything built from it says
134
- * which process runs it.
227
+ * which process runs it — and hands it the worker's database.
228
+ *
229
+ * The database goes through the builder's own `.database()` rather than
230
+ * being written into its fields, so the default is recorded exactly as an
231
+ * explicit one would be: the client the handler gets, and the edge the
232
+ * manifest reads. That is also what lets a later `.database(other)` replace
233
+ * it outright. The builder arrives already typed with this worker's
234
+ * database; this is the runtime half of that.
135
235
  */
136
236
  private own;
137
237
  declare(): Declaration[];
@@ -1 +1 @@
1
- {"version":3,"file":"worker.d.mts","names":["_$__topic0.TopicMessage","_$__construct_interface0.ServicesOf","_$__functions0.FunctionHandler","_$__functions0.Function"],"sources":["../src/worker.ts"],"mappings":";;;;;;;;;;;;;;;iBAiFiB;;;;;;;;;EAShB,SAAS;;;;;;;EAOT,YAAY;;qBAGA,OAAO,0CACR,WAAW;mBAkBJ;;mBAEA;WAlBT,IAAI;;WAGJ,QAAQ;;WAGR,WAAW;;;;;WAMX,gBAAgB;EAEzB,YACC,IAAI,cAAc,QACD,SAAQ,cAER;;EAAA,wBAAuB,cACxC,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAkCjB,SAAS,GAAG,wBACX,QAAQ,WAAW,SAAS,KAC1B,OAAO;;;;;;EAcV,KAAK,UAAU,qBAAkB,YAAA,0BAAA,WAAA;;;;;;;;;;;EAcjC,MAAM,2BAA2B,gBAAgB,aAChD,OAAO,MAAM,YAAY,WAAQ,sBAAA,mBAAA,eAAAA,aAAA;;;;;;;;;EAalC,UAAU,UAAU,qBAAqB,yBACxC,SAAS,QAAQ,UAAU,KAAK,WAAW,UAAU,KAAE,sBAAA,mBAAA;;;;;;;;;;;;EAkBxD,MAAM,UAAU,0BAA0B,QAAQ,IAAC,gBAAA,kBAAA,iEAAA;EAInD,OAAO,UAAU,kBAAkB,QAAQ,IAAC,gBAAA,0BAAA,OAAA,iEAAA;EAI5C,QAAQ,aAAU,gBAAA,yCAAA,iEAAA;EAIlB,WAAW,aAAU,gBAAA,yCAAA,iEAAA;EAIrB,gBAAgB,mBAAmB,cAAc,YAAY,IAAC,gBAAA,yCAAAC,WAAA,KAAA,iEAAA;EAI9D,SAAS,UAAU,WAAW,UAAU,IAAC,gBAAA,yCAAA,IAAA,iEAAA;;;;;;EASzC,UACI,MAAM,WACR,WAAW,OAAO,2CAClBE,SAAA,8BAAA,4EAAA,kCAAAD,gBAAA,8BAAA,yCAAA;;UAMM;;cAKI;;;;;;;EAUZ,MAAM,qBAAqB,eAAe,OAAO;;;;;UAazC;EASR,WAAW"}
1
+ {"version":3,"file":"worker.d.mts","names":["EventPublisher","_$__topic0.TopicMessage","_$__construct_interface0.ServicesOf","_$__functions0.FunctionHandler","_$__functions0.Function"],"sources":["../src/subscribers/InboxSubscriberBuilder.ts","../src/worker.ts"],"mappings":"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"}
package/dist/worker.mjs CHANGED
@@ -1,10 +1,95 @@
1
1
  import { edgeTo } from "./construct-interface.mjs";
2
- import { t as FunctionBuilder } from "./functions-C53GW2eQ.mjs";
2
+ import { t as FunctionBuilder } from "./functions-BvIDQKAA.mjs";
3
3
  import { n as envParserFor } from "./surfaceEnv-wMT5QzgZ.mjs";
4
- import { t as CronBuilder } from "./CronBuilder-D_0HNBTr.mjs";
5
- import { t as SubscriberBuilder } from "./SubscriberBuilder-h7B_cHMr.mjs";
6
- import { canonicalId } from "@geekmidas/manifest";
4
+ import { t as CronBuilder } from "./CronBuilder-BJ5LoadF.mjs";
5
+ import { t as QueueBuilder } from "./QueueBuilder-2wP5lEC8.mjs";
6
+ import { r as ObjectSubscriberBuilder, t as SubscriberBuilder } from "./SubscriberBuilder-CpFhShTJ.mjs";
7
+ import { INBOX_EVENT, canonicalId, serviceKey } from "@geekmidas/manifest";
7
8
  import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
9
+ //#region src/subscribers/InboxSubscriberBuilder.ts
10
+ var InboxSubscriberBuilder = class InboxSubscriberBuilder {
11
+ inner;
12
+ inbox;
13
+ acceptsAutomated;
14
+ constructor(inner, inbox, acceptsAutomated = false) {
15
+ this.inner = inner;
16
+ this.inbox = inbox;
17
+ this.acceptsAutomated = acceptsAutomated;
18
+ }
19
+ /**
20
+ * Hands this handler mail marked `Auto-Submitted` too — auto-replies,
21
+ * out-of-office notices, bounces — which are otherwise dropped so a reply
22
+ * can never be answered by another. A handler that takes them should not
23
+ * reply to them.
24
+ */
25
+ automated() {
26
+ return new InboxSubscriberBuilder(this.inner, this.inbox, true);
27
+ }
28
+ dependsOn(constructs) {
29
+ return this.with(this.inner.dependsOn(constructs));
30
+ }
31
+ services(services) {
32
+ return this.with(this.inner.services(services));
33
+ }
34
+ database(source) {
35
+ return this.with(this.inner.database(source));
36
+ }
37
+ timeout(timeout) {
38
+ return this.with(this.inner.timeout(timeout));
39
+ }
40
+ output(schema) {
41
+ return this.with(this.inner.output(schema));
42
+ }
43
+ logger(logger) {
44
+ return this.with(this.inner.logger(logger));
45
+ }
46
+ handle(fn) {
47
+ const key = serviceKey(this.inbox.id);
48
+ const acceptsAutomated = this.acceptsAutomated;
49
+ const handler = async (ctx) => {
50
+ const inbox = ctx.services[key];
51
+ const notifications = ctx.events.filter((event) => event?.type === INBOX_EVENT);
52
+ if (notifications.length === 0) return void 0;
53
+ const { autoReplying, isAutoSubmitted } = await import("@geekmidas/emailkit/autoSubmitted").catch((error) => {
54
+ throw new InboxNeedsEmailkit(error);
55
+ });
56
+ const messages = [];
57
+ for (const { payload } of notifications) for (const message of await inbox.messages(payload)) {
58
+ if (!acceptsAutomated && isAutoSubmitted(message.headers)) {
59
+ ctx.logger.debug({
60
+ recipient: message.recipient.address,
61
+ autoSubmitted: message.headers["auto-submitted"]
62
+ }, "Dropped automatic mail: it is never answered");
63
+ continue;
64
+ }
65
+ messages.push(message);
66
+ }
67
+ if (messages.length === 0) return void 0;
68
+ return autoReplying(() => fn({
69
+ ...ctx,
70
+ messages,
71
+ inbox
72
+ }));
73
+ };
74
+ const subscriber = this.inner.subscribe([INBOX_EVENT]).handle(handler);
75
+ subscriber.inboxName = this.inbox.id;
76
+ subscriber.inboxAddressing = this.inbox.addressing;
77
+ return subscriber;
78
+ }
79
+ with(inner) {
80
+ return new InboxSubscriberBuilder(inner, this.inbox, this.acceptsAutomated);
81
+ }
82
+ };
83
+ /** A worker received mail for an inbox, and `@geekmidas/emailkit` is not installed. */
84
+ var InboxNeedsEmailkit = class extends Error {
85
+ cause;
86
+ constructor(cause) {
87
+ super("A worker received mail for an inbox, and reading it needs @geekmidas/emailkit, which is not installed. Add it to the app that runs the worker: pnpm add @geekmidas/emailkit");
88
+ this.cause = cause;
89
+ this.name = "InboxNeedsEmailkit";
90
+ }
91
+ };
92
+ //#endregion
8
93
  //#region src/worker.ts
9
94
  var Worker = class Worker {
10
95
  config;
@@ -16,7 +101,8 @@ var Worker = class Worker {
16
101
  envParser;
17
102
  /**
18
103
  * Where this worker's schedules live, when it has crons and a server runs
19
- * them. `undefined` until `.database(…)` says.
104
+ * them — and the database everything built from it receives as `db`.
105
+ * `undefined` until `.database(…)` says.
20
106
  */
21
107
  scheduleStore;
22
108
  constructor(id, config = {}, dependencies = [], scheduleStore) {
@@ -32,7 +118,10 @@ var Worker = class Worker {
32
118
  this.scheduleStore = scheduleStore;
33
119
  }
34
120
  /**
35
- * The database this worker keeps its schedules in.
121
+ * The database this worker keeps its schedules in, and the one everything
122
+ * built from it — crons, queues, subscribers, functions — receives as `db`.
123
+ * One of them that works against another database names it with its own
124
+ * `.database(other)`, which replaces this one for that runnable alone.
36
125
  *
37
126
  * Only a server target uses it. On AWS a cron is an EventBridge rule
38
127
  * invoking a Lambda and nothing here is consulted — but a server has nothing
@@ -49,6 +138,10 @@ var Worker = class Worker {
49
138
  * @example
50
139
  * ```ts
51
140
  * export const jobs = new Worker('Jobs', { logger }).database(database);
141
+ *
142
+ * export const sweep = jobs
143
+ * .cron('rate(1 hour)')
144
+ * .handle(async ({ db }) => db.deleteFrom('sessions').execute());
52
145
  * ```
53
146
  */
54
147
  database(source) {
@@ -63,12 +156,72 @@ var Worker = class Worker {
63
156
  return this.own(new CronBuilder().logger(this.logger)).schedule(schedule);
64
157
  }
65
158
  /**
159
+ * A queue and its one consumer, run by this worker.
160
+ *
161
+ * One construct, because a queue has exactly one consumer: nothing else can
162
+ * attach a second, or forget to attach the first. Producers send to it by
163
+ * depending on it — `.dependsOn([emails])` makes `services.emails` the
164
+ * publisher.
165
+ *
166
+ * @example
167
+ * ```ts
168
+ * export const emails = worker
169
+ * .queue('Emails')
170
+ * .message(z.object({ userId: z.uuid(), template: z.string() }))
171
+ * .handle(async ({ messages, services }) => { … });
172
+ * ```
173
+ */
174
+ queue(name) {
175
+ return this.own(new QueueBuilder().logger(this.logger)).queue(name);
176
+ }
177
+ /**
178
+ * A runnable that reacts to a bucket's objects changing.
179
+ *
180
+ * A bucket is a topic whose publisher is the storage: the binding is the
181
+ * same as {@link Worker.topic}'s, and so is everything after it — the
182
+ * services, the database, how it is delivered. The handler is handed the
183
+ * objects; reading one still means depending on the bucket,
184
+ * `.dependsOn([uploads])`.
185
+ *
186
+ * @example
187
+ * ```ts
188
+ * export const onAvatar = worker
189
+ * .objects(uploads)
190
+ * .on(['object.created'], { prefix: 'avatars/', suffix: '.png' })
191
+ * .handle(async ({ objects }) => { … });
192
+ * ```
193
+ */
194
+ objects(bucket) {
195
+ const inner = this.own(new SubscriberBuilder().logger(this.logger));
196
+ return new ObjectSubscriberBuilder(inner, bucket.id);
197
+ }
198
+ /**
199
+ * A runnable handed the mail an {@link Inbox} receives.
200
+ *
201
+ * Bound, as a topic subscriber is: the inbox's topic is what it consumes,
202
+ * and what it is handed is the messages on it, parsed — one per envelope
203
+ * recipient the inbox receives at. It reads its inbox's raw messages
204
+ * without depending on it; anything else it uses it names, as ever.
205
+ *
206
+ * @example
207
+ * ```ts
208
+ * export const onRequest = worker
209
+ * .inbox(requests)
210
+ * .handle(async ({ messages, db }) => {
211
+ * for (const message of messages) message.recipient.subdomain;
212
+ * });
213
+ * ```
214
+ */
215
+ inbox(inbox) {
216
+ return new InboxSubscriberBuilder(this.own(new SubscriberBuilder().logger(this.logger)).topic(inbox.topic).dependsOn([inbox]), inbox);
217
+ }
218
+ /**
66
219
  * A runnable that consumes a topic.
67
220
  *
68
221
  * Binding is not publishing: a consumer is handed the topic's event types
69
- * and no connection string it could publish with. Chain `.publishes(…)` when
70
- * the handler emits follow-up events, which is the only reason it would need
71
- * one.
222
+ * and no connection string it could publish with. A handler that emits
223
+ * follow-up events depends on the topic it emits to —
224
+ * `.dependsOn([orders])` — which is the only reason it would need one.
72
225
  *
73
226
  * @example `worker.topic(users).subscribe(['user.created']).handle(…)`
74
227
  */
@@ -76,17 +229,6 @@ var Worker = class Worker {
76
229
  return this.own(new SubscriberBuilder().logger(this.logger)).topic(topic);
77
230
  }
78
231
  /**
79
- * A runnable that consumes events typed from a publisher service.
80
- *
81
- * The older of the two ways to bind a subscriber, kept for a project whose
82
- * events come from a hand-written publisher rather than a `Topic`
83
- * construct. `topic()` is the one to reach for: it types the events the same
84
- * way and hands the consumer no connection string it could publish with.
85
- */
86
- publisher(service) {
87
- return this.own(new SubscriberBuilder().logger(this.logger)).publisher(service);
88
- }
89
- /**
90
232
  * Everything below builds a function — the runnable with no schedule and no
91
233
  * topic, invoked by something else.
92
234
  *
@@ -132,28 +274,28 @@ var Worker = class Worker {
132
274
  return this.own(new FunctionBuilder().logger(this.logger));
133
275
  }
134
276
  /**
135
- * Resources and surfaces this worker calls.
136
- *
137
- * Not `.dependsOn()`: this records the edge that derives the worker's
138
- * environment and its access, the same distinction `RestApi.calls()` draws.
139
- */
140
- calls(constructs) {
141
- return new Worker(this.id, this.config, [...this.dependencies, ...constructs.map(edgeTo)], this.scheduleStore);
142
- }
143
- /**
144
277
  * Stamps this worker's id onto a builder, so everything built from it says
145
- * which process runs it.
278
+ * which process runs it — and hands it the worker's database.
279
+ *
280
+ * The database goes through the builder's own `.database()` rather than
281
+ * being written into its fields, so the default is recorded exactly as an
282
+ * explicit one would be: the client the handler gets, and the edge the
283
+ * manifest reads. That is also what lets a later `.database(other)` replace
284
+ * it outright. The builder arrives already typed with this worker's
285
+ * database; this is the runtime half of that.
146
286
  */
147
287
  own(builder) {
148
- builder._owner = this.id;
149
- builder._scheduleStore = this.scheduleStore;
150
- return builder;
288
+ const owned = this.scheduleStore ? builder.database(this.scheduleStore) : builder;
289
+ owned._owner = this.id;
290
+ owned._scheduleStore = this.scheduleStore;
291
+ return owned;
151
292
  }
152
293
  declare() {
153
294
  return [{
154
295
  kind: "worker",
155
296
  id: this.id,
156
297
  ...this.dependencies.length ? { dependencies: this.dependencies } : {},
298
+ ...this.config.telemetry ? { telemetry: this.config.telemetry.id } : {},
157
299
  provides: []
158
300
  }];
159
301
  }