@geekmidas/constructs 10.0.0-alpha.17 → 10.0.0-alpha.170

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-Ca_qHQu2.d.cts} +16 -9
  11. package/dist/Cron-Ca_qHQu2.d.cts.map +1 -0
  12. package/dist/{Cron-zsoSAwZo.d.cts → Cron-DPJiR7Lt.d.mts} +15 -8
  13. package/dist/Cron-DPJiR7Lt.d.mts.map +1 -0
  14. package/dist/CronBuilder-BC4za5Bx.d.mts +47 -0
  15. package/dist/CronBuilder-BC4za5Bx.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-C3RrAF1-.d.cts +47 -0
  21. package/dist/CronBuilder-C3RrAF1-.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-DBflWAe4.d.cts → Endpoint-BlIZLsBQ.d.cts} +101 -20
  25. package/dist/Endpoint-BlIZLsBQ.d.cts.map +1 -0
  26. package/dist/{Endpoint-oS-Fe3d_.d.mts → Endpoint-DC7mreOr.d.mts} +104 -23
  27. package/dist/Endpoint-DC7mreOr.d.mts.map +1 -0
  28. package/dist/Endpoint-sUOU7uLx.mjs +552 -0
  29. package/dist/Endpoint-sUOU7uLx.mjs.map +1 -0
  30. package/dist/{EndpointFactory-Bm3aKRdV.mjs → EndpointFactory-Bzi9Sl7r.mjs} +269 -53
  31. package/dist/EndpointFactory-Bzi9Sl7r.mjs.map +1 -0
  32. package/dist/{EndpointFactory-CLvWuHyt.cjs → EndpointFactory-Cf_Cs1ym.cjs} +309 -51
  33. package/dist/EndpointFactory-Cf_Cs1ym.cjs.map +1 -0
  34. package/dist/{index-Cc4kKPag.d.mts → EndpointFactory-DCmnCmkX.d.mts} +189 -106
  35. package/dist/EndpointFactory-DCmnCmkX.d.mts.map +1 -0
  36. package/dist/{index-C1ZwNOOk.d.cts → EndpointFactory-cVTb8kCc.d.cts} +187 -104
  37. package/dist/EndpointFactory-cVTb8kCc.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-AwGKoUKy.d.mts +129 -0
  47. package/dist/ObjectSubscriberBuilder-AwGKoUKy.d.mts.map +1 -0
  48. package/dist/ObjectSubscriberBuilder-CB6imsX4.d.cts +129 -0
  49. package/dist/ObjectSubscriberBuilder-CB6imsX4.d.cts.map +1 -0
  50. package/dist/ProcessorBuilder-CeEZ2vCx.d.cts +216 -0
  51. package/dist/ProcessorBuilder-CeEZ2vCx.d.cts.map +1 -0
  52. package/dist/ProcessorBuilder-CwIlm75W.d.mts +216 -0
  53. package/dist/ProcessorBuilder-CwIlm75W.d.mts.map +1 -0
  54. package/dist/Queue-9Hh20ZCk.mjs +104 -0
  55. package/dist/Queue-9Hh20ZCk.mjs.map +1 -0
  56. package/dist/{Queue-D9X6OoON.d.mts → Queue-B8HGg439.d.mts} +42 -41
  57. package/dist/Queue-B8HGg439.d.mts.map +1 -0
  58. package/dist/{Queue-DYPB2KWL.d.cts → Queue-C4rijiM7.d.cts} +43 -42
  59. package/dist/Queue-C4rijiM7.d.cts.map +1 -0
  60. package/dist/Queue-W1wueijP.cjs +109 -0
  61. package/dist/Queue-W1wueijP.cjs.map +1 -0
  62. package/dist/QueueBuilder-BDcv9B71.cjs +135 -0
  63. package/dist/QueueBuilder-BDcv9B71.cjs.map +1 -0
  64. package/dist/QueueBuilder-CUERv8jt.d.mts +75 -0
  65. package/dist/QueueBuilder-CUERv8jt.d.mts.map +1 -0
  66. package/dist/QueueBuilder-CmB1vOgn.d.cts +75 -0
  67. package/dist/QueueBuilder-CmB1vOgn.d.cts.map +1 -0
  68. package/dist/QueueBuilder-CrZL8HHs.mjs +118 -0
  69. package/dist/QueueBuilder-CrZL8HHs.mjs.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-BGoOeCT6.mjs +99 -0
  79. package/dist/Topic-BGoOeCT6.mjs.map +1 -0
  80. package/dist/Topic-DLCZBNwK.cjs +104 -0
  81. package/dist/Topic-DLCZBNwK.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-1yI2wR-4.d.cts +274 -0
  113. package/dist/auth-1yI2wR-4.d.cts.map +1 -0
  114. package/dist/auth-D4NMXgLt.d.mts +274 -0
  115. package/dist/auth-D4NMXgLt.d.mts.map +1 -0
  116. package/dist/auth.cjs +311 -26
  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 +307 -28
  121. package/dist/auth.mjs.map +1 -1
  122. package/dist/cache-0VoeOTF9.d.mts +44 -0
  123. package/dist/cache-0VoeOTF9.d.mts.map +1 -0
  124. package/dist/cache-CW-sArzS.d.cts +44 -0
  125. package/dist/cache-CW-sArzS.d.cts.map +1 -0
  126. package/dist/cache.cjs +4 -20
  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 +4 -20
  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-DhbaONW2.d.cts} +63 -8
  141. package/dist/construct-interface-DhbaONW2.d.cts.map +1 -0
  142. package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-DxfkFxkl.d.mts} +63 -8
  143. package/dist/construct-interface-DxfkFxkl.d.mts.map +1 -0
  144. package/dist/construct-interface.cjs +47 -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 +45 -5
  149. package/dist/construct-interface.mjs.map +1 -1
  150. package/dist/credential-B80mOxwT.mjs +222 -0
  151. package/dist/credential-B80mOxwT.mjs.map +1 -0
  152. package/dist/credential-RlgbzZAc.cjs +257 -0
  153. package/dist/credential-RlgbzZAc.cjs.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 +24 -17
  171. package/dist/email.cjs.map +1 -1
  172. package/dist/email.d.cts +15 -5
  173. package/dist/email.d.cts.map +1 -1
  174. package/dist/email.d.mts +16 -6
  175. package/dist/email.d.mts.map +1 -1
  176. package/dist/email.mjs +23 -17
  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-BvOXkZmj.d.mts +201 -0
  215. package/dist/fake-BvOXkZmj.d.mts.map +1 -0
  216. package/dist/fake-Djx8E0o1.d.cts +201 -0
  217. package/dist/fake-Djx8E0o1.d.cts.map +1 -0
  218. package/dist/file-server.cjs +200 -48
  219. package/dist/file-server.cjs.map +1 -1
  220. package/dist/file-server.d.cts +147 -15
  221. package/dist/file-server.d.cts.map +1 -1
  222. package/dist/file-server.d.mts +147 -15
  223. package/dist/file-server.d.mts.map +1 -1
  224. package/dist/file-server.mjs +198 -50
  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-BjvMs7EJ.d.cts +195 -0
  235. package/dist/inbox-BjvMs7EJ.d.cts.map +1 -0
  236. package/dist/inbox-C8bOR9UL.d.mts +195 -0
  237. package/dist/inbox-C8bOR9UL.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-DaK-C7N3.d.cts +115 -0
  245. package/dist/index-DaK-C7N3.d.cts.map +1 -0
  246. package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
  247. package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
  248. package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
  249. package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
  250. package/dist/index-vCS4HBEG.d.mts +115 -0
  251. package/dist/index-vCS4HBEG.d.mts.map +1 -0
  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-2HqIQ2fC.d.cts +216 -0
  259. package/dist/kysely-2HqIQ2fC.d.cts.map +1 -0
  260. package/dist/kysely-BGvpd_ZH.d.mts +216 -0
  261. package/dist/kysely-BGvpd_ZH.d.mts.map +1 -0
  262. package/dist/kysely-Bc9xzaik.mjs +371 -0
  263. package/dist/kysely-Bc9xzaik.mjs.map +1 -0
  264. package/dist/kysely-D7f6J2lh.cjs +384 -0
  265. package/dist/kysely-D7f6J2lh.cjs.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 +78 -0
  271. package/dist/mobile-app.cjs.map +1 -0
  272. package/dist/mobile-app.d.cts +77 -0
  273. package/dist/mobile-app.d.cts.map +1 -0
  274. package/dist/mobile-app.d.mts +77 -0
  275. package/dist/mobile-app.d.mts.map +1 -0
  276. package/dist/mobile-app.mjs +77 -0
  277. package/dist/mobile-app.mjs.map +1 -0
  278. package/dist/object-storage.cjs +14 -7
  279. package/dist/object-storage.cjs.map +1 -1
  280. package/dist/object-storage.d.cts +12 -3
  281. package/dist/object-storage.d.cts.map +1 -1
  282. package/dist/object-storage.d.mts +12 -3
  283. package/dist/object-storage.d.mts.map +1 -1
  284. package/dist/object-storage.mjs +14 -9
  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 +100 -73
  331. package/dist/rest-api.cjs.map +1 -1
  332. package/dist/rest-api.d.cts +83 -59
  333. package/dist/rest-api.d.cts.map +1 -1
  334. package/dist/rest-api.d.mts +83 -59
  335. package/dist/rest-api.d.mts.map +1 -1
  336. package/dist/rest-api.mjs +97 -76
  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 +137 -10
  347. package/dist/site.cjs.map +1 -1
  348. package/dist/site.d.cts +153 -3
  349. package/dist/site.d.cts.map +1 -1
  350. package/dist/site.d.mts +153 -3
  351. package/dist/site.d.mts.map +1 -1
  352. package/dist/site.mjs +117 -13
  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-BirKau0X.d.mts +40 -0
  367. package/dist/telemetry-BirKau0X.d.mts.map +1 -0
  368. package/dist/telemetry-DjJgtQ_N.d.cts +40 -0
  369. package/dist/telemetry-DjJgtQ_N.d.cts.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-C6LGg9-D.mjs +1716 -0
  385. package/dist/websocket-api-C6LGg9-D.mjs.map +1 -0
  386. package/dist/websocket-api-CD-E5Ogr.d.cts +1207 -0
  387. package/dist/websocket-api-CD-E5Ogr.d.cts.map +1 -0
  388. package/dist/websocket-api-CoKPJJRl.cjs +1895 -0
  389. package/dist/websocket-api-CoKPJJRl.cjs.map +1 -0
  390. package/dist/websocket-api-pJJfeTcm.d.mts +1207 -0
  391. package/dist/websocket-api-pJJfeTcm.d.mts.map +1 -0
  392. package/dist/websocket-api.cjs +42 -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
package/dist/worker.d.cts CHANGED
@@ -1,17 +1,59 @@
1
- import { t as StandardSchemaV1 } from "./index-CeEtxDmK.cjs";
2
- import { a as FunctionHandler, r as Function, t as FunctionBuilder } from "./index-D_frT6MP.cjs";
3
- import { n as Consumable, r as Declarable, s as ServicesOf } from "./construct-interface-DgXTJcOD.cjs";
4
- import { i as ScheduleExpression } from "./Cron-zsoSAwZo.cjs";
5
- import { t as CronBuilder } from "./CronBuilder-CyT71Nzg.cjs";
6
- import { n as TopicEvents, r as TopicMessage, t as Topic } from "./Topic-DEVGo0Dm.cjs";
7
- import { t as SubscriberBuilder } from "./SubscriberBuilder-BEv0eoHy.cjs";
8
- import "./index-B2urf3YI.cjs";
1
+ import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.cjs";
2
+ import { c as Topic, l as TopicEvents, u as TopicMessage } from "./Construct-127M7yrl.cjs";
3
+ import { i as FunctionHandler, n as Function, t as DatabaseContext } from "./Function-BIEsY0Hm.cjs";
4
+ import { i as Declarable, l as ServicesOf, r as Consumable } from "./construct-interface-DhbaONW2.cjs";
5
+ import { t as FunctionBuilder } from "./index-DaK-C7N3.cjs";
6
+ import { i as ScheduleExpression } from "./Cron-Ca_qHQu2.cjs";
7
+ import { n as Telemetry } from "./telemetry-DjJgtQ_N.cjs";
8
+ import { t as Subscriber } from "./Subscriber-5rCX1Nph.cjs";
9
+ import { i as InboxClient, l as ReceiptNotification, n as Inbox, o as InboxMessage } from "./inbox-BjvMs7EJ.cjs";
10
+ import { t as CronBuilder } from "./CronBuilder-C3RrAF1-.cjs";
11
+ import { ObjectStorage } from "./object-storage.cjs";
12
+ import { t as QueueBuilder } from "./QueueBuilder-CmB1vOgn.cjs";
13
+ import { n as ObjectSubscriberBuilder, o as SubscriberBuilder } from "./ObjectSubscriberBuilder-CB6imsX4.cjs";
14
+ import "./topic/index.cjs";
9
15
  import { EnvironmentParser } from "@geekmidas/envkit";
10
- import { EventPublisher } from "@geekmidas/events";
11
16
  import { Logger } from "@geekmidas/logger";
12
- import { ComposableStandardSchema } from "@geekmidas/schema";
13
- import { Service } from "@geekmidas/services";
14
- import { ConstructName, Declaration, Dependency } from "@geekmidas/manifest";
17
+ import { ComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
18
+ import { Service, ServiceRecord } from "@geekmidas/services";
19
+ import { EventPublisher as EventPublisher$1 } from "@geekmidas/events";
20
+ import { ConstructName, Declaration, Dependency, INBOX_EVENT } from "@geekmidas/manifest";
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.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 { i as Declarable, l as ServicesOf, r as Consumable } from "./construct-interface-DxfkFxkl.mjs";
5
+ import { t as FunctionBuilder } from "./index-vCS4HBEG.mjs";
6
+ import { i as ScheduleExpression } from "./Cron-DPJiR7Lt.mjs";
7
+ import { n as Telemetry } from "./telemetry-BirKau0X.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-C8bOR9UL.mjs";
10
+ import { t as CronBuilder } from "./CronBuilder-BC4za5Bx.mjs";
11
+ import { ObjectStorage } from "./object-storage.mjs";
12
+ import { t as QueueBuilder } from "./QueueBuilder-CUERv8jt.mjs";
13
+ import { n as ObjectSubscriberBuilder, o as SubscriberBuilder } from "./ObjectSubscriberBuilder-AwGKoUKy.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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"}