@geekmidas/constructs 10.0.0-alpha.15 → 10.0.0-alpha.150

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 (454) hide show
  1. package/README.md +222 -158
  2. package/dist/Construct-127M7yrl.d.cts +231 -0
  3. package/dist/Construct-127M7yrl.d.cts.map +1 -0
  4. package/dist/{Construct-BeYVu_QF.mjs → Construct-CGuc_Ijk.mjs} +8 -9
  5. package/dist/Construct-CGuc_Ijk.mjs.map +1 -0
  6. package/dist/{Construct-DqdlARxq.cjs → Construct-DorKS0Ua.cjs} +8 -9
  7. package/dist/Construct-DorKS0Ua.cjs.map +1 -0
  8. package/dist/Construct-DySlwh8o.d.mts +231 -0
  9. package/dist/Construct-DySlwh8o.d.mts.map +1 -0
  10. package/dist/{Cron-DKqnnTdH.d.cts → Cron-D8mB_cPX.d.mts} +16 -9
  11. package/dist/Cron-D8mB_cPX.d.mts.map +1 -0
  12. package/dist/{Cron-SyqS5oWJ.d.mts → Cron-D_sfaMGz.d.cts} +16 -9
  13. package/dist/Cron-D_sfaMGz.d.cts.map +1 -0
  14. package/dist/{CronBuilder-D_0HNBTr.mjs → CronBuilder-BJ5LoadF.mjs} +28 -11
  15. package/dist/CronBuilder-BJ5LoadF.mjs.map +1 -0
  16. package/dist/{CronBuilder-BdnI6lxF.cjs → CronBuilder-B_NSP-Y5.cjs} +27 -10
  17. package/dist/CronBuilder-B_NSP-Y5.cjs.map +1 -0
  18. package/dist/CronBuilder-C91MVLSr.d.cts +47 -0
  19. package/dist/CronBuilder-C91MVLSr.d.cts.map +1 -0
  20. package/dist/CronBuilder-Cmajva3g.d.mts +47 -0
  21. package/dist/CronBuilder-Cmajva3g.d.mts.map +1 -0
  22. package/dist/Endpoint-52z1P0Ue.cjs +581 -0
  23. package/dist/Endpoint-52z1P0Ue.cjs.map +1 -0
  24. package/dist/{Endpoint-DuT4TEEq.d.mts → Endpoint-BbHh3Qoc.d.mts} +124 -43
  25. package/dist/Endpoint-BbHh3Qoc.d.mts.map +1 -0
  26. package/dist/{Endpoint-C6yyHpRS.d.cts → Endpoint-YYwjqtS1.d.cts} +122 -41
  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/{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-BPSZ_Lp_.d.cts → EndpointFactory-Hh1r6J_C.d.cts} +187 -104
  35. package/dist/EndpointFactory-Hh1r6J_C.d.cts.map +1 -0
  36. package/dist/{index-BoZ-iisU.d.mts → EndpointFactory-qcLzi4f-.d.mts} +188 -105
  37. package/dist/EndpointFactory-qcLzi4f-.d.mts.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-DfMzTGS4.d.mts +76 -0
  41. package/dist/Function-DfMzTGS4.d.mts.map +1 -0
  42. package/dist/{HonoEndpointAdaptor-92zavCsV.cjs → HonoEndpointAdaptor-BXBdb2Bt.cjs} +79 -31
  43. package/dist/HonoEndpointAdaptor-BXBdb2Bt.cjs.map +1 -0
  44. package/dist/{HonoEndpointAdaptor-yYaU7jVJ.mjs → HonoEndpointAdaptor-DR3j7S35.mjs} +76 -28
  45. package/dist/HonoEndpointAdaptor-DR3j7S35.mjs.map +1 -0
  46. package/dist/ObjectSubscriberBuilder-Cv8C7yS1.d.mts +129 -0
  47. package/dist/ObjectSubscriberBuilder-Cv8C7yS1.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-CwfP-M33.d.mts +216 -0
  51. package/dist/ProcessorBuilder-CwfP-M33.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-BnK3UH8r.d.mts} +42 -41
  55. package/dist/Queue-BnK3UH8r.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-DmwFtLzQ.d.mts +75 -0
  67. package/dist/QueueBuilder-DmwFtLzQ.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-CW_Dl-YR.d.mts +83 -0
  73. package/dist/Subscriber-CW_Dl-YR.d.mts.map +1 -0
  74. package/dist/SubscriberBuilder-BL_GTcwh.mjs +237 -0
  75. package/dist/SubscriberBuilder-BL_GTcwh.mjs.map +1 -0
  76. package/dist/SubscriberBuilder-CWzKwX1p.cjs +260 -0
  77. package/dist/SubscriberBuilder-CWzKwX1p.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 +134 -160
  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 +130 -157
  89. package/dist/adaptors/aws.mjs.map +1 -1
  90. package/dist/adaptors/hono.cjs +1 -1
  91. package/dist/adaptors/hono.d.cts +5 -6
  92. package/dist/adaptors/hono.d.cts.map +1 -1
  93. package/dist/adaptors/hono.d.mts +6 -7
  94. package/dist/adaptors/hono.d.mts.map +1 -1
  95. package/dist/adaptors/hono.mjs +1 -1
  96. package/dist/adaptors/testing.cjs +955 -38
  97. package/dist/adaptors/testing.cjs.map +1 -1
  98. package/dist/adaptors/testing.d.cts +437 -39
  99. package/dist/adaptors/testing.d.cts.map +1 -1
  100. package/dist/adaptors/testing.d.mts +436 -38
  101. package/dist/adaptors/testing.d.mts.map +1 -1
  102. package/dist/adaptors/testing.mjs +929 -34
  103. package/dist/adaptors/testing.mjs.map +1 -1
  104. package/dist/auth-BqWz2JxC.d.cts +274 -0
  105. package/dist/auth-BqWz2JxC.d.cts.map +1 -0
  106. package/dist/auth-DnB9H9KL.d.mts +274 -0
  107. package/dist/auth-DnB9H9KL.d.mts.map +1 -0
  108. package/dist/auth.cjs +320 -21
  109. package/dist/auth.cjs.map +1 -1
  110. package/dist/auth.d.cts +2 -104
  111. package/dist/auth.d.mts +2 -104
  112. package/dist/auth.mjs +316 -23
  113. package/dist/auth.mjs.map +1 -1
  114. package/dist/cache-CQjMNPrC.d.cts +44 -0
  115. package/dist/cache-CQjMNPrC.d.cts.map +1 -0
  116. package/dist/cache-e3tfMQ9g.d.mts +44 -0
  117. package/dist/cache-e3tfMQ9g.d.mts.map +1 -0
  118. package/dist/cache.d.cts +2 -43
  119. package/dist/cache.d.mts +2 -43
  120. package/dist/cipher-C1lEFX63.mjs +225 -0
  121. package/dist/cipher-C1lEFX63.mjs.map +1 -0
  122. package/dist/cipher-CVxfwLjk.cjs +332 -0
  123. package/dist/cipher-CVxfwLjk.cjs.map +1 -0
  124. package/dist/cipher-DSDxPRIp.d.cts +106 -0
  125. package/dist/cipher-DSDxPRIp.d.cts.map +1 -0
  126. package/dist/cipher-DSDxPRIp.d.mts +106 -0
  127. package/dist/cipher-DSDxPRIp.d.mts.map +1 -0
  128. package/dist/{construct-interface-DPlxfpoS.d.mts → construct-interface-CSA9VeWM.d.mts} +47 -8
  129. package/dist/construct-interface-CSA9VeWM.d.mts.map +1 -0
  130. package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-DugP0E5q.d.cts} +47 -8
  131. package/dist/construct-interface-DugP0E5q.d.cts.map +1 -0
  132. package/dist/construct-interface.cjs +38 -4
  133. package/dist/construct-interface.cjs.map +1 -1
  134. package/dist/construct-interface.d.cts +2 -2
  135. package/dist/construct-interface.d.mts +2 -2
  136. package/dist/construct-interface.mjs +37 -5
  137. package/dist/construct-interface.mjs.map +1 -1
  138. package/dist/credential-DYymbp_7.cjs +257 -0
  139. package/dist/credential-DYymbp_7.cjs.map +1 -0
  140. package/dist/credential-DfSAOOdY.mjs +222 -0
  141. package/dist/credential-DfSAOOdY.mjs.map +1 -0
  142. package/dist/credential.cjs +7 -129
  143. package/dist/credential.d.cts +2 -58
  144. package/dist/credential.d.mts +2 -58
  145. package/dist/credential.mjs +2 -128
  146. package/dist/crons/index.cjs +126 -1
  147. package/dist/crons/index.cjs.map +1 -1
  148. package/dist/crons/index.d.cts +43 -3
  149. package/dist/crons/index.d.cts.map +1 -1
  150. package/dist/crons/index.d.mts +43 -3
  151. package/dist/crons/index.d.mts.map +1 -1
  152. package/dist/crons/index.mjs +125 -2
  153. package/dist/crons/index.mjs.map +1 -1
  154. package/dist/database/kysely.cjs +3 -194
  155. package/dist/database/kysely.d.cts +2 -149
  156. package/dist/database/kysely.d.mts +2 -149
  157. package/dist/database/kysely.mjs +2 -192
  158. package/dist/email.d.cts +1 -1
  159. package/dist/email.d.cts.map +1 -1
  160. package/dist/email.d.mts +2 -2
  161. package/dist/email.d.mts.map +1 -1
  162. package/dist/encryption/kms.cjs +95 -0
  163. package/dist/encryption/kms.cjs.map +1 -0
  164. package/dist/encryption/kms.d.cts +7 -0
  165. package/dist/encryption/kms.d.cts.map +1 -0
  166. package/dist/encryption/kms.d.mts +7 -0
  167. package/dist/encryption/kms.d.mts.map +1 -0
  168. package/dist/encryption/kms.mjs +93 -0
  169. package/dist/encryption/kms.mjs.map +1 -0
  170. package/dist/encryption.cjs +116 -0
  171. package/dist/encryption.cjs.map +1 -0
  172. package/dist/encryption.d.cts +37 -0
  173. package/dist/encryption.d.cts.map +1 -0
  174. package/dist/encryption.d.mts +37 -0
  175. package/dist/encryption.d.mts.map +1 -0
  176. package/dist/encryption.mjs +101 -0
  177. package/dist/encryption.mjs.map +1 -0
  178. package/dist/endpoints/index.cjs +32 -10
  179. package/dist/endpoints/index.d.cts +106 -3
  180. package/dist/endpoints/index.d.cts.map +1 -0
  181. package/dist/endpoints/index.d.mts +106 -3
  182. package/dist/endpoints/index.d.mts.map +1 -0
  183. package/dist/endpoints/index.mjs +6 -4
  184. package/dist/expire-C586zznE.d.cts +38 -0
  185. package/dist/expire-C586zznE.d.cts.map +1 -0
  186. package/dist/expire-C586zznE.d.mts +38 -0
  187. package/dist/expire-C586zznE.d.mts.map +1 -0
  188. package/dist/expire-CieftS01.cjs +67 -0
  189. package/dist/expire-CieftS01.cjs.map +1 -0
  190. package/dist/expire-CpzUAfr9.mjs +50 -0
  191. package/dist/expire-CpzUAfr9.mjs.map +1 -0
  192. package/dist/external-api.cjs +106 -0
  193. package/dist/external-api.cjs.map +1 -0
  194. package/dist/external-api.d.cts +2 -0
  195. package/dist/external-api.d.mts +2 -0
  196. package/dist/external-api.mjs +103 -0
  197. package/dist/external-api.mjs.map +1 -0
  198. package/dist/fake-BqhP8RRQ.d.mts +201 -0
  199. package/dist/fake-BqhP8RRQ.d.mts.map +1 -0
  200. package/dist/fake-DqieDYYA.d.cts +201 -0
  201. package/dist/fake-DqieDYYA.d.cts.map +1 -0
  202. package/dist/file-server.cjs +123 -30
  203. package/dist/file-server.cjs.map +1 -1
  204. package/dist/file-server.d.cts +115 -1
  205. package/dist/file-server.d.cts.map +1 -1
  206. package/dist/file-server.d.mts +115 -1
  207. package/dist/file-server.d.mts.map +1 -1
  208. package/dist/file-server.mjs +122 -32
  209. package/dist/file-server.mjs.map +1 -1
  210. package/dist/functions/index.cjs +1 -1
  211. package/dist/functions/index.d.cts +2 -1
  212. package/dist/functions/index.d.mts +2 -1
  213. package/dist/functions/index.mjs +1 -1
  214. package/dist/{functions-C53GW2eQ.mjs → functions-BvIDQKAA.mjs} +117 -22
  215. package/dist/functions-BvIDQKAA.mjs.map +1 -0
  216. package/dist/{functions-B6qCvfmy.cjs → functions-DLF6-IK8.cjs} +122 -18
  217. package/dist/functions-DLF6-IK8.cjs.map +1 -0
  218. package/dist/inbox-CR3L1fOI.d.cts +195 -0
  219. package/dist/inbox-CR3L1fOI.d.cts.map +1 -0
  220. package/dist/inbox-CjxpLVkH.d.mts +195 -0
  221. package/dist/inbox-CjxpLVkH.d.mts.map +1 -0
  222. package/dist/inbox.cjs +291 -0
  223. package/dist/inbox.cjs.map +1 -0
  224. package/dist/inbox.d.cts +2 -0
  225. package/dist/inbox.d.mts +2 -0
  226. package/dist/inbox.mjs +283 -0
  227. package/dist/inbox.mjs.map +1 -0
  228. package/dist/index-DCkDQkwj.d.mts +115 -0
  229. package/dist/index-DCkDQkwj.d.mts.map +1 -0
  230. package/dist/index-DPTHa6Ud.d.cts +115 -0
  231. package/dist/index-DPTHa6Ud.d.cts.map +1 -0
  232. package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
  233. package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
  234. package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
  235. package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
  236. package/dist/index.cjs +4 -1
  237. package/dist/index.d.cts +26 -3
  238. package/dist/index.d.cts.map +1 -0
  239. package/dist/index.d.mts +26 -3
  240. package/dist/index.d.mts.map +1 -0
  241. package/dist/index.mjs +3 -2
  242. package/dist/kysely-CebjCWTl.d.cts +216 -0
  243. package/dist/kysely-CebjCWTl.d.cts.map +1 -0
  244. package/dist/kysely-Cs4uPO8k.mjs +371 -0
  245. package/dist/kysely-Cs4uPO8k.mjs.map +1 -0
  246. package/dist/kysely-CukArHJ0.cjs +384 -0
  247. package/dist/kysely-CukArHJ0.cjs.map +1 -0
  248. package/dist/kysely-DE4kADWD.d.mts +216 -0
  249. package/dist/kysely-DE4kADWD.d.mts.map +1 -0
  250. package/dist/{telemetry-DGcFlVpB.d.cts → lambdaTelemetry-8vnmVZQ5.d.cts} +2 -2
  251. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +1 -0
  252. package/dist/{telemetry-DGcFlVpB.d.mts → lambdaTelemetry-8vnmVZQ5.d.mts} +2 -2
  253. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +1 -0
  254. package/dist/mobile-app.cjs +74 -0
  255. package/dist/mobile-app.cjs.map +1 -0
  256. package/dist/mobile-app.d.cts +73 -0
  257. package/dist/mobile-app.d.cts.map +1 -0
  258. package/dist/mobile-app.d.mts +73 -0
  259. package/dist/mobile-app.d.mts.map +1 -0
  260. package/dist/mobile-app.mjs +73 -0
  261. package/dist/mobile-app.mjs.map +1 -0
  262. package/dist/object-storage.cjs +8 -1
  263. package/dist/object-storage.cjs.map +1 -1
  264. package/dist/object-storage.d.cts +10 -1
  265. package/dist/object-storage.d.cts.map +1 -1
  266. package/dist/object-storage.d.mts +10 -1
  267. package/dist/object-storage.d.mts.map +1 -1
  268. package/dist/object-storage.mjs +7 -2
  269. package/dist/object-storage.mjs.map +1 -1
  270. package/dist/pattern-C1CEcglD.mjs +241 -0
  271. package/dist/pattern-C1CEcglD.mjs.map +1 -0
  272. package/dist/pattern-QFaUIr77.cjs +288 -0
  273. package/dist/pattern-QFaUIr77.cjs.map +1 -0
  274. package/dist/processors/index.cjs +214 -0
  275. package/dist/processors/index.cjs.map +1 -0
  276. package/dist/processors/index.d.cts +78 -0
  277. package/dist/processors/index.d.cts.map +1 -0
  278. package/dist/processors/index.d.mts +78 -0
  279. package/dist/processors/index.d.mts.map +1 -0
  280. package/dist/processors/index.mjs +193 -0
  281. package/dist/processors/index.mjs.map +1 -0
  282. package/dist/queue/index.cjs +5 -192
  283. package/dist/queue/index.d.cts +3 -53
  284. package/dist/queue/index.d.mts +3 -53
  285. package/dist/queue/index.mjs +3 -190
  286. package/dist/random-password.cjs +86 -0
  287. package/dist/random-password.cjs.map +1 -0
  288. package/dist/random-password.d.cts +30 -0
  289. package/dist/random-password.d.cts.map +1 -0
  290. package/dist/random-password.d.mts +30 -0
  291. package/dist/random-password.d.mts.map +1 -0
  292. package/dist/random-password.mjs +84 -0
  293. package/dist/random-password.mjs.map +1 -0
  294. package/dist/{lazyAccessors-BHtcqgz2.mjs → readRequestBody-BTIl3k-D.mjs} +99 -39
  295. package/dist/readRequestBody-BTIl3k-D.mjs.map +1 -0
  296. package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-Dej_L3c4.cjs} +118 -46
  297. package/dist/readRequestBody-Dej_L3c4.cjs.map +1 -0
  298. package/dist/requestLogger-BZcXwdBs.cjs +207 -0
  299. package/dist/requestLogger-BZcXwdBs.cjs.map +1 -0
  300. package/dist/requestLogger-pA4gi3E1.mjs +178 -0
  301. package/dist/requestLogger-pA4gi3E1.mjs.map +1 -0
  302. package/dist/rest-api.cjs +85 -70
  303. package/dist/rest-api.cjs.map +1 -1
  304. package/dist/rest-api.d.cts +77 -59
  305. package/dist/rest-api.d.cts.map +1 -1
  306. package/dist/rest-api.d.mts +77 -59
  307. package/dist/rest-api.d.mts.map +1 -1
  308. package/dist/rest-api.mjs +87 -72
  309. package/dist/rest-api.mjs.map +1 -1
  310. package/dist/runSubscriber-CC_2C9F2.cjs +133 -0
  311. package/dist/runSubscriber-CC_2C9F2.cjs.map +1 -0
  312. package/dist/runSubscriber-DyHWp_Lf.mjs +116 -0
  313. package/dist/runSubscriber-DyHWp_Lf.mjs.map +1 -0
  314. package/dist/shutdown-BMJmAhSt.cjs +38 -0
  315. package/dist/shutdown-BMJmAhSt.cjs.map +1 -0
  316. package/dist/shutdown-C7xa8x9S.mjs +27 -0
  317. package/dist/shutdown-C7xa8x9S.mjs.map +1 -0
  318. package/dist/site.cjs +85 -8
  319. package/dist/site.cjs.map +1 -1
  320. package/dist/site.d.cts +98 -2
  321. package/dist/site.d.cts.map +1 -1
  322. package/dist/site.d.mts +98 -2
  323. package/dist/site.d.mts.map +1 -1
  324. package/dist/site.mjs +84 -11
  325. package/dist/site.mjs.map +1 -1
  326. package/dist/stages-DaTaoQei.d.cts +73 -0
  327. package/dist/stages-DaTaoQei.d.cts.map +1 -0
  328. package/dist/stages-DaTaoQei.d.mts +73 -0
  329. package/dist/stages-DaTaoQei.d.mts.map +1 -0
  330. package/dist/subscribers/index.cjs +134 -1
  331. package/dist/subscribers/index.cjs.map +1 -0
  332. package/dist/subscribers/index.d.cts +74 -3
  333. package/dist/subscribers/index.d.cts.map +1 -0
  334. package/dist/subscribers/index.d.mts +74 -3
  335. package/dist/subscribers/index.d.mts.map +1 -0
  336. package/dist/subscribers/index.mjs +132 -2
  337. package/dist/subscribers/index.mjs.map +1 -0
  338. package/dist/telemetry-C1oqncFY.d.cts +40 -0
  339. package/dist/telemetry-C1oqncFY.d.cts.map +1 -0
  340. package/dist/telemetry-CObow3Dn.d.mts +40 -0
  341. package/dist/telemetry-CObow3Dn.d.mts.map +1 -0
  342. package/dist/telemetry.cjs +56 -0
  343. package/dist/telemetry.cjs.map +1 -0
  344. package/dist/telemetry.d.cts +2 -0
  345. package/dist/telemetry.d.mts +2 -0
  346. package/dist/telemetry.mjs +55 -0
  347. package/dist/telemetry.mjs.map +1 -0
  348. package/dist/topic/index.cjs +2 -134
  349. package/dist/topic/index.d.cts +2 -3
  350. package/dist/topic/index.d.mts +2 -3
  351. package/dist/topic/index.mjs +2 -132
  352. package/dist/tracing-Bbj1uoFJ.mjs +127 -0
  353. package/dist/tracing-Bbj1uoFJ.mjs.map +1 -0
  354. package/dist/tracing-C0ooU0V2.cjs +150 -0
  355. package/dist/tracing-C0ooU0V2.cjs.map +1 -0
  356. package/dist/websocket-api.cjs +951 -0
  357. package/dist/websocket-api.cjs.map +1 -0
  358. package/dist/websocket-api.d.cts +556 -0
  359. package/dist/websocket-api.d.cts.map +1 -0
  360. package/dist/websocket-api.d.mts +556 -0
  361. package/dist/websocket-api.d.mts.map +1 -0
  362. package/dist/websocket-api.mjs +933 -0
  363. package/dist/websocket-api.mjs.map +1 -0
  364. package/dist/worker.cjs +174 -32
  365. package/dist/worker.cjs.map +1 -1
  366. package/dist/worker.d.cts +147 -47
  367. package/dist/worker.d.cts.map +1 -1
  368. package/dist/worker.d.mts +147 -47
  369. package/dist/worker.d.mts.map +1 -1
  370. package/dist/worker.mjs +175 -33
  371. package/dist/worker.mjs.map +1 -1
  372. package/package.json +155 -44
  373. package/dist/Construct-BeYVu_QF.mjs.map +0 -1
  374. package/dist/Construct-DfbwIntp.d.cts +0 -115
  375. package/dist/Construct-DfbwIntp.d.cts.map +0 -1
  376. package/dist/Construct-DqdlARxq.cjs.map +0 -1
  377. package/dist/Construct-l5aOn_jv.d.mts +0 -115
  378. package/dist/Construct-l5aOn_jv.d.mts.map +0 -1
  379. package/dist/Cron-DKqnnTdH.d.cts.map +0 -1
  380. package/dist/Cron-SyqS5oWJ.d.mts.map +0 -1
  381. package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
  382. package/dist/CronBuilder-CRGnDfTq.d.mts +0 -41
  383. package/dist/CronBuilder-CRGnDfTq.d.mts.map +0 -1
  384. package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
  385. package/dist/CronBuilder-Df1q9PNy.d.cts +0 -41
  386. package/dist/CronBuilder-Df1q9PNy.d.cts.map +0 -1
  387. package/dist/Endpoint-BpZHtJ2W.cjs +0 -1689
  388. package/dist/Endpoint-BpZHtJ2W.cjs.map +0 -1
  389. package/dist/Endpoint-C6yyHpRS.d.cts.map +0 -1
  390. package/dist/Endpoint-DuT4TEEq.d.mts.map +0 -1
  391. package/dist/Endpoint-ONsly_dq.mjs +0 -1671
  392. package/dist/Endpoint-ONsly_dq.mjs.map +0 -1
  393. package/dist/EndpointFactory-Bm3aKRdV.mjs.map +0 -1
  394. package/dist/EndpointFactory-CLvWuHyt.cjs.map +0 -1
  395. package/dist/HonoEndpointAdaptor-92zavCsV.cjs.map +0 -1
  396. package/dist/HonoEndpointAdaptor-yYaU7jVJ.mjs.map +0 -1
  397. package/dist/Queue-D9X6OoON.d.mts.map +0 -1
  398. package/dist/Queue-DYPB2KWL.d.cts.map +0 -1
  399. package/dist/Subscriber-C4heaAyO.d.mts +0 -51
  400. package/dist/Subscriber-C4heaAyO.d.mts.map +0 -1
  401. package/dist/Subscriber-CotDUELC.d.cts +0 -51
  402. package/dist/Subscriber-CotDUELC.d.cts.map +0 -1
  403. package/dist/SubscriberBuilder-BEv0eoHy.d.cts +0 -59
  404. package/dist/SubscriberBuilder-BEv0eoHy.d.cts.map +0 -1
  405. package/dist/SubscriberBuilder-C0ZEtGDI.cjs +0 -125
  406. package/dist/SubscriberBuilder-C0ZEtGDI.cjs.map +0 -1
  407. package/dist/SubscriberBuilder-h7B_cHMr.mjs +0 -114
  408. package/dist/SubscriberBuilder-h7B_cHMr.mjs.map +0 -1
  409. package/dist/SubscriberBuilder-tyH5yTk5.d.mts +0 -59
  410. package/dist/SubscriberBuilder-tyH5yTk5.d.mts.map +0 -1
  411. package/dist/Topic-DEVGo0Dm.d.cts +0 -89
  412. package/dist/Topic-DEVGo0Dm.d.cts.map +0 -1
  413. package/dist/Topic-zk_6Gthr.d.mts +0 -89
  414. package/dist/Topic-zk_6Gthr.d.mts.map +0 -1
  415. package/dist/auth.d.cts.map +0 -1
  416. package/dist/auth.d.mts.map +0 -1
  417. package/dist/cache.d.cts.map +0 -1
  418. package/dist/cache.d.mts.map +0 -1
  419. package/dist/construct-interface-DPlxfpoS.d.mts.map +0 -1
  420. package/dist/construct-interface-DgXTJcOD.d.cts.map +0 -1
  421. package/dist/credential.cjs.map +0 -1
  422. package/dist/credential.d.cts.map +0 -1
  423. package/dist/credential.d.mts.map +0 -1
  424. package/dist/credential.mjs.map +0 -1
  425. package/dist/database/kysely.cjs.map +0 -1
  426. package/dist/database/kysely.d.cts.map +0 -1
  427. package/dist/database/kysely.d.mts.map +0 -1
  428. package/dist/database/kysely.mjs.map +0 -1
  429. package/dist/functions-B6qCvfmy.cjs.map +0 -1
  430. package/dist/functions-C53GW2eQ.mjs.map +0 -1
  431. package/dist/index-B2urf3YI.d.cts +0 -26
  432. package/dist/index-B2urf3YI.d.cts.map +0 -1
  433. package/dist/index-BPSZ_Lp_.d.cts.map +0 -1
  434. package/dist/index-BoZ-iisU.d.mts.map +0 -1
  435. package/dist/index-CdaU--_B.d.cts +0 -165
  436. package/dist/index-CdaU--_B.d.cts.map +0 -1
  437. package/dist/index-DMCDvnsM.d.mts +0 -26
  438. package/dist/index-DMCDvnsM.d.mts.map +0 -1
  439. package/dist/index-PQRWOQj4.d.mts +0 -165
  440. package/dist/index-PQRWOQj4.d.mts.map +0 -1
  441. package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
  442. package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
  443. package/dist/processAudits-BpRlPQMW.mjs +0 -77
  444. package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
  445. package/dist/processAudits-D_2W5x8k.cjs +0 -88
  446. package/dist/processAudits-D_2W5x8k.cjs.map +0 -1
  447. package/dist/queue/index.cjs.map +0 -1
  448. package/dist/queue/index.d.cts.map +0 -1
  449. package/dist/queue/index.d.mts.map +0 -1
  450. package/dist/queue/index.mjs.map +0 -1
  451. package/dist/telemetry-DGcFlVpB.d.cts.map +0 -1
  452. package/dist/telemetry-DGcFlVpB.d.mts.map +0 -1
  453. package/dist/topic/index.cjs.map +0 -1
  454. package/dist/topic/index.mjs.map +0 -1
@@ -0,0 +1,556 @@
1
+ import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.cjs";
2
+ import { c as ServicesOf, i as Declarable, r as Consumable, t as Authenticator } from "./construct-interface-DugP0E5q.cjs";
3
+ import { n as Telemetry } from "./telemetry-C1oqncFY.cjs";
4
+ import { EnvironmentParser } from "@geekmidas/envkit";
5
+ import { Logger } from "@geekmidas/logger";
6
+ import { InferStandardSchema } from "@geekmidas/schema";
7
+ import { Service, ServiceRecord, ServiceRegisterOptions } from "@geekmidas/services";
8
+ import { ConstructName, Declaration } from "@geekmidas/manifest";
9
+ import { Hono } from "hono";
10
+ import { IncomingMessage, Server } from "node:http";
11
+ import { Duplex } from "node:stream";
12
+ //#region src/websocket/transport.d.ts
13
+ /**
14
+ * How a send reaches the process holding the socket.
15
+ *
16
+ * A connection id names the process it lives on — `<instance>.<n>` — so a send
17
+ * needs no registry: it is published to that instance's channel and nowhere
18
+ * else. A broadcast goes to every instance. On a stack the channels are Redis
19
+ * pub/sub, so an endpoint in another container reaches a socket the same way a
20
+ * route beside it does; in one process (a test, a single dev server) they are
21
+ * a map.
22
+ */
23
+ /** What one process is asked to do with the sockets it holds. */
24
+ type Delivery = {
25
+ kind: 'send';
26
+ ids: readonly string[];
27
+ payload: string;
28
+ } | {
29
+ kind: 'broadcast';
30
+ payload: string;
31
+ except?: readonly string[];
32
+ } | {
33
+ kind: 'close';
34
+ ids: readonly string[];
35
+ code: number;
36
+ reason: string;
37
+ };
38
+ interface WebSocketTransport {
39
+ /** Deliver to one instance, or to every instance when it is `'*'`. */
40
+ publish(instance: string, delivery: Delivery): Promise<void>;
41
+ /** Receive what is published to `instance`, and every broadcast. */
42
+ subscribe(instance: string, receive: (delivery: Delivery) => void): Promise<void>;
43
+ close(): Promise<void>;
44
+ }
45
+ /** A connection string names no transport this package knows. */
46
+ export declare class UnsupportedWebSocketTransport extends Error {
47
+ readonly connectionString: string;
48
+ constructor(connectionString: string);
49
+ }
50
+ /**
51
+ * In one process: the server and whoever sends meet in a map, keyed by the
52
+ * channel the connection string names.
53
+ */
54
+ export declare class MemoryTransport implements WebSocketTransport {
55
+ private readonly channel;
56
+ private readonly subscribed;
57
+ constructor(channel: string);
58
+ publish(instance: string, delivery: Delivery): Promise<void>;
59
+ subscribe(instance: string, receive: (delivery: Delivery) => void): Promise<void>;
60
+ close(): Promise<void>;
61
+ }
62
+ /** The subset of an ioredis client the transport uses. */
63
+ interface RedisClient {
64
+ publish(channel: string, message: string): Promise<number>;
65
+ subscribe(...channels: string[]): Promise<unknown>;
66
+ on(event: 'message', listener: (channel: string, message: string) => void): unknown;
67
+ duplicate(): RedisClient;
68
+ quit(): Promise<unknown>;
69
+ }
70
+ /**
71
+ * Over Redis pub/sub: one channel per instance and one for broadcasts, under
72
+ * a prefix that keeps two surfaces — or two projects on one Redis — apart.
73
+ * Channels are not scoped by database index, so the prefix is what does it.
74
+ *
75
+ * Publishing and subscribing take separate connections, because a connection
76
+ * that has subscribed can do nothing else.
77
+ */
78
+ export declare class RedisTransport implements WebSocketTransport {
79
+ private readonly client;
80
+ private readonly prefix;
81
+ private subscriber?;
82
+ private closed?;
83
+ constructor(client: RedisClient, prefix: string);
84
+ private channel;
85
+ publish(instance: string, delivery: Delivery): Promise<void>;
86
+ subscribe(instance: string, receive: (delivery: Delivery) => void): Promise<void>;
87
+ /** Idempotent: the server and a shutdown hook may both close it. */
88
+ close(): Promise<void>;
89
+ }
90
+ /**
91
+ * The transport a connection string names.
92
+ *
93
+ * `redis://` and `rediss://` take an optional `channel` query parameter, the
94
+ * prefix every channel is named under; `memory://<channel>` is in-process.
95
+ * Absent, the channel is `fallback` — the surface's own.
96
+ */
97
+ export declare function transportFromConnectionString(connectionString: string, fallback: string): Promise<WebSocketTransport>;
98
+ //#endregion
99
+ //#region src/websocket/publisher.d.ts
100
+ /**
101
+ * What a surface sends its sockets, by action — `WebSocketApiConfig.messages`.
102
+ */
103
+ type WebSocketMessages = Record<string, StandardSchemaV1>;
104
+ /** A surface that declares no messages: any action, any data. */
105
+ type NoMessages = Record<never, never>;
106
+ /** The actions a publisher sends: the declared ones, or any. */
107
+ type MessageAction<TMessages extends WebSocketMessages> = [keyof TMessages] extends [never] ? string : keyof TMessages & string;
108
+ /** What `action`'s data is, as its schema takes it. */
109
+ type MessageData<TMessages extends WebSocketMessages, TAction extends string> = TAction extends keyof TMessages ? StandardSchemaV1.InferInput<TMessages[TAction]> : unknown;
110
+ /** A message sent on an action the surface does not declare. */
111
+ export declare class UnknownWebSocketMessage extends Error {
112
+ readonly surface: string;
113
+ readonly action: string;
114
+ readonly declared: readonly string[];
115
+ constructor(surface: string, action: string, declared: readonly string[]);
116
+ }
117
+ /** A message whose data its action's schema refused. */
118
+ export declare class InvalidWebSocketMessage extends Error {
119
+ readonly surface: string;
120
+ readonly action: string;
121
+ readonly issues: readonly StandardSchemaV1.Issue[];
122
+ constructor(surface: string, action: string, issues: readonly StandardSchemaV1.Issue[]);
123
+ }
124
+ /**
125
+ * How anything reaches a socket — `services.realtime` in an endpoint, and
126
+ * `sockets` in a route of the surface itself.
127
+ *
128
+ * A message is `{ action, data }`, the shape a client's frames arrive in —
129
+ * or, where the surface names a `frame.discriminator`, flat: `{ [key]: action,
130
+ * ...data }`.
131
+ * Where the surface declares its messages, `action` is one of them and
132
+ * `data` is typed and checked by its schema before anything is sent; where it
133
+ * declares none, any action and any JSON value go. A message is serialised
134
+ * once, whatever the number of sockets it goes to. An id whose process has
135
+ * gone is dropped silently, as API Gateway's `postToConnection` to a closed
136
+ * connection is a no-op the sender rarely wants to handle.
137
+ */
138
+ export declare class WebSocketPublisher<TMessages extends WebSocketMessages = NoMessages> {
139
+ private readonly transport;
140
+ /**
141
+ * Delivers to this process's own sockets without a round trip through
142
+ * the transport — set on the server's own publisher.
143
+ */
144
+ private readonly local?;
145
+ /** The surface's declared messages, which every send is checked by. */
146
+ private readonly declared?;
147
+ /** How the surface writes a frame. Absent, `{ action, data }`. */
148
+ private readonly frame;
149
+ constructor(transport: WebSocketTransport,
150
+ /**
151
+ * Delivers to this process's own sockets without a round trip through
152
+ * the transport — set on the server's own publisher.
153
+ */
154
+ local?: {
155
+ instance: string;
156
+ deliver(delivery: Delivery): void;
157
+ } | undefined,
158
+ /** The surface's declared messages, which every send is checked by. */
159
+ declared?: {
160
+ surface: string;
161
+ messages: TMessages;
162
+ } | undefined,
163
+ /** How the surface writes a frame. Absent, `{ action, data }`. */
164
+ frame?: FrameShape);
165
+ /** Send `action`'s message to each connection. */
166
+ send<TAction extends MessageAction<TMessages>>(ids: string | readonly string[], action: TAction, data: MessageData<TMessages, TAction>): Promise<void>;
167
+ /** Send `action`'s message to every open connection, on every process. */
168
+ broadcast<TAction extends MessageAction<TMessages>>(action: TAction, data: MessageData<TMessages, TAction>, options?: {
169
+ except?: readonly string[];
170
+ }): Promise<void>;
171
+ /** Close each connection, with a close code and reason its client sees. */
172
+ close(ids: string | readonly string[], code?: number, reason?: string): Promise<void>;
173
+ /**
174
+ * The frame, checked by the action's schema where the surface declares
175
+ * its messages.
176
+ *
177
+ * @throws {UnknownWebSocketMessage}, {InvalidWebSocketMessage}, and for a
178
+ * flat frame {WebSocketDataNotAnObject}, {WebSocketDataHasDiscriminator}
179
+ */
180
+ private payload;
181
+ /** One delivery per process that holds any of `ids`. */
182
+ private each;
183
+ }
184
+ //#endregion
185
+ //#region src/websocket/frame.d.ts
186
+ /** `WebSocketApiConfig.frame`: where a flat frame keeps its action. */
187
+ interface WebSocketFrame {
188
+ /** The key a frame's action lives in — `type` for `{ "type": … }`. */
189
+ discriminator: string;
190
+ }
191
+ /** A frame as the server reads it, whatever shape it arrived in. */
192
+ interface DecodedFrame {
193
+ action: string;
194
+ /** Echoed on the reply. Only an `{ action, data }` frame carries one. */
195
+ id?: string | number;
196
+ data?: unknown;
197
+ }
198
+ /** A declared message whose schema does not describe an object. */
199
+ export declare class WebSocketMessageNotAnObject extends Error {
200
+ readonly surface: string;
201
+ readonly action: string;
202
+ readonly discriminator: string;
203
+ constructor(surface: string, action: string, discriminator: string);
204
+ }
205
+ /** A declared message whose schema has a field named the discriminator. */
206
+ export declare class WebSocketMessageDeclaresDiscriminator extends Error {
207
+ readonly surface: string;
208
+ readonly action: string;
209
+ readonly discriminator: string;
210
+ constructor(surface: string, action: string, discriminator: string);
211
+ }
212
+ /** Data sent in a flat frame that is not an object. */
213
+ export declare class WebSocketDataNotAnObject extends Error {
214
+ readonly surface: string;
215
+ readonly action: string;
216
+ readonly discriminator: string;
217
+ constructor(surface: string, action: string, discriminator: string);
218
+ }
219
+ /** Data sent in a flat frame that carries the discriminator itself. */
220
+ export declare class WebSocketDataHasDiscriminator extends Error {
221
+ readonly surface: string;
222
+ readonly action: string;
223
+ readonly discriminator: string;
224
+ constructor(surface: string, action: string, discriminator: string);
225
+ }
226
+ /** How one surface writes and reads its frames. */
227
+ declare class FrameShape {
228
+ readonly surface: string;
229
+ /** The flat frame's key; absent, frames are `{ action, data }`. */
230
+ readonly discriminator?: string | undefined;
231
+ constructor(surface: string,
232
+ /** The flat frame's key; absent, frames are `{ action, data }`. */
233
+ discriminator?: string | undefined);
234
+ /** The key an inbound frame names its action under. */
235
+ get key(): string;
236
+ /**
237
+ * The frame for `action`'s `data`, serialised.
238
+ *
239
+ * @throws {WebSocketDataNotAnObject}, {WebSocketDataHasDiscriminator} for
240
+ * a flat frame whose data cannot sit beside the discriminator.
241
+ */
242
+ encode(action: string, data: unknown, id?: string | number): string;
243
+ /** A parsed frame's action, id and data — `undefined` when it names none. */
244
+ decode(frame: unknown): DecodedFrame | undefined;
245
+ /** The id a frame that names no action carried, to echo on its error. */
246
+ idOf(frame: unknown): string | number | undefined;
247
+ /**
248
+ * Refuse a declared message a flat frame cannot carry: one that is not an
249
+ * object, or that has a field named the discriminator.
250
+ *
251
+ * @throws {WebSocketMessageNotAnObject}, {WebSocketMessageDeclaresDiscriminator}
252
+ */
253
+ check(messages: WebSocketMessages): void;
254
+ }
255
+ //#endregion
256
+ //#region src/websocket/route.d.ts
257
+ /** One open connection, as a handler sees it. */
258
+ interface Connection {
259
+ readonly id: string;
260
+ /**
261
+ * What the connect handler returned — who the connection is for, the room
262
+ * it joined. `{}` when it returned nothing.
263
+ */
264
+ readonly data: Record<string, unknown>;
265
+ }
266
+ interface BaseContext<TServices extends Service[], TMessages extends WebSocketMessages> {
267
+ services: ServiceRecord<TServices>;
268
+ logger: Logger;
269
+ /** Every socket this surface holds, on whichever process holds it. */
270
+ sockets: WebSocketPublisher<TMessages>;
271
+ }
272
+ interface ConnectContext<TServices extends Service[], TMessages extends WebSocketMessages = NoMessages> extends BaseContext<TServices, TMessages> {
273
+ connectionId: string;
274
+ headers: Headers;
275
+ query: URLSearchParams;
276
+ /**
277
+ * Whose connection it is, from the surface's `.auth()` — `null` when the
278
+ * upgrade carried no session, and when the surface names no authenticator.
279
+ * Throw an `UnauthorizedError` to refuse it.
280
+ */
281
+ session: unknown;
282
+ }
283
+ interface MessageContext<TBody, TServices extends Service[], TMessages extends WebSocketMessages = NoMessages> extends BaseContext<TServices, TMessages> {
284
+ connection: Connection;
285
+ body: TBody;
286
+ /** Send to this connection alone. */
287
+ reply(message: unknown): void;
288
+ }
289
+ interface DisconnectContext<TServices extends Service[], TMessages extends WebSocketMessages = NoMessages> extends BaseContext<TServices, TMessages> {
290
+ connection: Connection;
291
+ code: number;
292
+ reason: string;
293
+ }
294
+ /** What a frame is dispatched on: an action, or the connection's lifecycle. */
295
+ type RouteKind = 'connect' | 'disconnect' | 'message';
296
+ /**
297
+ * A handler bound to a WebSocket surface — what `realtime.route('chat.send')
298
+ * …handle()` returns, and what a file exports.
299
+ *
300
+ * Carries `surface` and `constructs` the way an endpoint does, so discovery
301
+ * records what its process reaches without knowing what a route is.
302
+ */
303
+ export declare class WebSocketRoute {
304
+ readonly kind: RouteKind;
305
+ /** The `action` it answers; `$connect` and `$disconnect` for the lifecycle. */
306
+ readonly action: string;
307
+ readonly surface: {
308
+ id: string;
309
+ };
310
+ readonly services: readonly Service[];
311
+ /** Construct ids it depends on — its edges in the manifest. */
312
+ readonly constructs: readonly string[];
313
+ readonly handler: (context: never) => unknown;
314
+ readonly schema?: StandardSchemaV1 | undefined;
315
+ readonly __IS_WEBSOCKET_ROUTE__ = true;
316
+ static isRoute(value: unknown): value is WebSocketRoute;
317
+ constructor(kind: RouteKind,
318
+ /** The `action` it answers; `$connect` and `$disconnect` for the lifecycle. */
319
+ action: string, surface: {
320
+ id: string;
321
+ }, services: readonly Service[],
322
+ /** Construct ids it depends on — its edges in the manifest. */
323
+ constructs: readonly string[], handler: (context: never) => unknown, schema?: StandardSchemaV1 | undefined);
324
+ }
325
+ /** The builder `connect()`, `disconnect()` and `route()` start. */
326
+ export declare class WebSocketRouteBuilder<TKind extends RouteKind, TSchema extends StandardSchemaV1 | undefined = undefined, TServices extends Service[] = [],
327
+ /** The surface's declared messages, which `sockets` sends. */
328
+ TMessages extends WebSocketMessages = NoMessages> {
329
+ private readonly kind;
330
+ private readonly action;
331
+ private readonly surface;
332
+ private readonly _services;
333
+ private readonly _constructs;
334
+ private readonly schema?;
335
+ constructor(kind: TKind, action: string, surface: {
336
+ id: string;
337
+ }, _services?: readonly Service[], _constructs?: readonly string[], schema?: TSchema | undefined);
338
+ /** The schema a frame's `data` must satisfy before the handler runs. */
339
+ body<S extends StandardSchemaV1>(schema: S): WebSocketRouteBuilder<TKind, S, TServices, TMessages>;
340
+ /** What the handler reaches, as `services.<id>` — per route, as an endpoint's. */
341
+ dependsOn<const T extends readonly Consumable[]>(constructs: T): WebSocketRouteBuilder<TKind, TSchema, [...TServices, ...(ServicesOf<T> extends Service[] ? ServicesOf<T> : [])], TMessages>;
342
+ /**
343
+ * The handler. A message handler's return value, when there is one, is
344
+ * sent back to the connection as the reply to that frame; a connect
345
+ * handler's is kept as the connection's `data`.
346
+ */
347
+ handle(handler: TKind extends 'connect' ? (context: ConnectContext<TServices, TMessages>) => Record<string, unknown> | undefined | Promise<Record<string, unknown> | undefined> : TKind extends 'disconnect' ? (context: DisconnectContext<TServices, TMessages>) => unknown : (context: MessageContext<TSchema extends StandardSchemaV1 ? InferStandardSchema<TSchema> : unknown, TServices, TMessages>) => unknown): WebSocketRoute;
348
+ }
349
+ //#endregion
350
+ //#region src/websocket/server.d.ts
351
+ /** Close codes a client sees. */
352
+ export declare const CLOSE: {
353
+ readonly normal: 1000;
354
+ /** The process is stopping; reconnect and land on another. */
355
+ readonly serviceRestart: 1012;
356
+ /** It stopped reading, and what was queued for it passed the limit. */
357
+ readonly tooSlow: 1013;
358
+ };
359
+ /** Two routes answer one action. */
360
+ export declare class DuplicateWebSocketRoute extends Error {
361
+ readonly surface: string;
362
+ readonly action: string;
363
+ constructor(surface: string, action: string);
364
+ }
365
+ interface WebSocketServerOptions<TMessages extends WebSocketMessages = NoMessages> {
366
+ surface: string;
367
+ /** What the surface sends its sockets — see `WebSocketApiConfig.messages`. */
368
+ messages?: TMessages;
369
+ /** The shape its frames take — see `WebSocketApiConfig.frame`. */
370
+ frame?: WebSocketFrame;
371
+ routes: readonly WebSocketRoute[];
372
+ transport: WebSocketTransport;
373
+ envParser: EnvironmentParser<{}>;
374
+ logger: Logger;
375
+ authenticator?: Authenticator;
376
+ /**
377
+ * Origins a browser may open a socket from. A request with an `Origin`
378
+ * not in the list is refused with 403; one with none — a server, a load
379
+ * generator — is not a browser, and is let through.
380
+ */
381
+ trustedOrigins: readonly string[];
382
+ /**
383
+ * The surface's own public address, `<ID>_URL`. Its origin is always
384
+ * trusted: a native client (React Native's `WebSocket`) sends the socket's
385
+ * own origin as its `Origin`.
386
+ */
387
+ url?: string;
388
+ /** How often each socket is pinged; one that missed the last is dropped. */
389
+ heartbeatMs?: number;
390
+ /** The largest frame accepted, in bytes. */
391
+ maxPayload?: number;
392
+ /** Queued bytes a socket may hold before it is closed as too slow. */
393
+ maxBufferedBytes?: number;
394
+ }
395
+ export declare class WebSocketSurfaceServer<TMessages extends WebSocketMessages = NoMessages> {
396
+ private readonly wss;
397
+ private readonly options;
398
+ /** This process, as connection ids name it. */
399
+ readonly instance: string;
400
+ /** `sockets` in a route: local sends skip the transport. */
401
+ readonly publisher: WebSocketPublisher<TMessages>;
402
+ private readonly held;
403
+ private readonly routes;
404
+ private readonly lifecycle;
405
+ private readonly heartbeat;
406
+ private readonly frame;
407
+ private readonly trusted;
408
+ private next;
409
+ private closing;
410
+ private constructor();
411
+ static start<TMessages extends WebSocketMessages = NoMessages>(options: WebSocketServerOptions<TMessages>): Promise<WebSocketSurfaceServer<TMessages>>;
412
+ /** How many sockets this process holds. */
413
+ get size(): number;
414
+ /** Take over `server`'s upgrades. */
415
+ attach(server: Server): void;
416
+ /** Upgrade one request, or refuse it with a status line. */
417
+ upgrade(request: IncomingMessage, socket: Duplex, head: Buffer): Promise<void>;
418
+ private open;
419
+ /** Parse, validate and run one frame. Errors go back as frames, not closes. */
420
+ private dispatch;
421
+ /** Run a handler with its services, inside a request context of its own. */
422
+ private run;
423
+ private error;
424
+ /** Write, unless the socket has stopped reading and its queue is full. */
425
+ private write;
426
+ /** What the transport, or a local publisher, asked of this process. */
427
+ private deliver;
428
+ /** Drop every socket that missed the last ping, and ping the rest. */
429
+ private beat;
430
+ /**
431
+ * Stop: refuse new upgrades, close every socket with `code` — 1012 tells
432
+ * a client to reconnect, and it lands on a process that is still up — and
433
+ * leave the transport.
434
+ */
435
+ close(code?: number, reason?: string): Promise<void>;
436
+ }
437
+ //#endregion
438
+ //#region src/websocket-api.d.ts
439
+ export interface WebSocketApiConfig<TMessages extends WebSocketMessages = NoMessages> {
440
+ /** The app that serves it, relative to the workspace root. */
441
+ path: string;
442
+ /**
443
+ * What it sends its sockets, by action — each with the schema its `data`
444
+ * is checked by before it is sent.
445
+ *
446
+ * ```ts
447
+ * messages: {
448
+ * announcement: z.object({ text: z.string() }),
449
+ * 'chat.said': z.object({ from: z.string(), text: z.string() }),
450
+ * }
451
+ * ```
452
+ *
453
+ * The publisher is typed by it — `services.realtime.broadcast(
454
+ * 'announcement', { text })` — in an endpoint and in a route's `sockets`
455
+ * alike. Absent, any action and any data go, unchecked.
456
+ */
457
+ messages?: TMessages;
458
+ /**
459
+ * The shape its frames take. Absent, `{ "action": …, "id"?: …, "data": … }`.
460
+ *
461
+ * With a `discriminator`, frames are flat — the action under that key and
462
+ * the data's fields beside it, both ways, `$error` replies included:
463
+ *
464
+ * ```ts
465
+ * frame: { discriminator: 'type' },
466
+ * // realtime.send(ids, 'chat.message.created', { chatId, message })
467
+ * // wire: {"type":"chat.message.created","chatId":"…","message":{…}}
468
+ * ```
469
+ *
470
+ * Every message must then be an object schema that has no field of that
471
+ * name; one that is not is refused when the surface is built. A flat frame
472
+ * carries no `id`: every other field is the data.
473
+ */
474
+ frame?: WebSocketFrame;
475
+ /** The label it answers on. Absent, its id kebab-cased. */
476
+ subdomain?: string;
477
+ /** How many processes serve it on one machine. Default 1. */
478
+ replicas?: number;
479
+ logger?: Logger;
480
+ envParser?: EnvironmentParser<{}>;
481
+ telemetry?: Telemetry;
482
+ /** Seconds between pings; a socket that misses one is dropped. Default 30. */
483
+ heartbeat?: number;
484
+ /** The largest frame accepted, in bytes. Default 1 MiB. */
485
+ maxPayload?: number;
486
+ }
487
+ /** A replica count that is not a whole number of at least one. */
488
+ export declare class InvalidReplicaCount extends Error {
489
+ readonly id: string;
490
+ readonly replicas: number;
491
+ constructor(id: string, replicas: number);
492
+ }
493
+ export declare class WebSocketApi<TName extends string = string, TMessages extends WebSocketMessages = NoMessages> implements Declarable<TName> {
494
+ private readonly config;
495
+ /** Internal: how `.auth()` carries the authenticator into its copy. */
496
+ readonly authenticator?: Authenticator | undefined;
497
+ readonly id: TName;
498
+ readonly keys: {
499
+ url: string;
500
+ trustedOrigins: string;
501
+ publisherConnectionString: string;
502
+ };
503
+ readonly logger: Logger;
504
+ readonly envParser: EnvironmentParser<{}>;
505
+ readonly telemetry?: Telemetry;
506
+ /**
507
+ * The shape its frames take — `{ action, data }`, or flat under
508
+ * `discriminator`. What a client of the surface decodes by.
509
+ */
510
+ readonly frame: {
511
+ readonly discriminator?: string;
512
+ };
513
+ /**
514
+ * The surface as a dependency: `services.<id>` is its publisher, so an
515
+ * endpoint sends to a socket the way a route beside it does.
516
+ */
517
+ readonly service: Service<Uncapitalize<TName>, WebSocketPublisher<TMessages>>;
518
+ constructor(id: ConstructName<TName>, config: WebSocketApiConfig<TMessages>,
519
+ /** Internal: how `.auth()` carries the authenticator into its copy. */
520
+ authenticator?: Authenticator | undefined);
521
+ /** The handler a connection's upgrade runs: refuse it, or say who it is. */
522
+ connect(): WebSocketRouteBuilder<'connect', undefined, [], TMessages>;
523
+ /** The handler a closed connection runs. */
524
+ disconnect(): WebSocketRouteBuilder<'disconnect', undefined, [], TMessages>;
525
+ /**
526
+ * The handler for frames whose `action` — or, for flat frames, whose
527
+ * discriminator — is `action`. `$default` answers
528
+ * any action nothing else does.
529
+ */
530
+ route(action: string): WebSocketRouteBuilder<'message', undefined, [], TMessages>;
531
+ /** What authenticates a connection — its session reaches `connect()`. */
532
+ auth(construct: Authenticator): WebSocketApi<TName, TMessages>;
533
+ /**
534
+ * Serve it: the routes exported by `modules` that were built from this
535
+ * surface, on whatever HTTP server `attach` is handed.
536
+ *
537
+ * `app` answers plain HTTP — the generated entry puts `/health` in front
538
+ * of it — and `attach` takes over the server's upgrades. The sockets are
539
+ * closed with 1012 when the server shuts down.
540
+ */
541
+ server(options: ServiceRegisterOptions & {
542
+ modules?: readonly object[];
543
+ }): Promise<{
544
+ app: Hono;
545
+ attach(server: Server): void;
546
+ /** Close every socket with 1012, so the HTTP server can close. */
547
+ release(): Promise<void>;
548
+ server: WebSocketSurfaceServer<TMessages>;
549
+ }>;
550
+ /** The declared messages, with the surface they are checked for. */
551
+ private get declared();
552
+ declare(): Declaration[];
553
+ }
554
+ //#endregion
555
+ export type { ConnectContext, Connection, Delivery, DisconnectContext, MessageAction, MessageContext, MessageData, NoMessages, RouteKind, WebSocketFrame, WebSocketMessages, WebSocketServerOptions, WebSocketTransport };
556
+ //# sourceMappingURL=websocket-api.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"websocket-api.d.cts","names":[],"sources":["../src/websocket/transport.ts","../src/websocket/publisher.ts","../src/websocket/frame.ts","../src/websocket/route.ts","../src/websocket/server.ts","../src/websocket-api.ts"],"mappings":"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"}