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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (485) hide show
  1. package/README.md +246 -158
  2. package/dist/Construct-127M7yrl.d.cts +231 -0
  3. package/dist/Construct-127M7yrl.d.cts.map +1 -0
  4. package/dist/Construct-BMk_CRSD.d.mts +231 -0
  5. package/dist/Construct-BMk_CRSD.d.mts.map +1 -0
  6. package/dist/{Construct-BeYVu_QF.mjs → Construct-CGuc_Ijk.mjs} +8 -9
  7. package/dist/Construct-CGuc_Ijk.mjs.map +1 -0
  8. package/dist/{Construct-DqdlARxq.cjs → Construct-DorKS0Ua.cjs} +8 -9
  9. package/dist/Construct-DorKS0Ua.cjs.map +1 -0
  10. package/dist/{Cron-l4Wlz6G9.d.mts → Cron-D6Y7BBt3.d.mts} +15 -8
  11. package/dist/Cron-D6Y7BBt3.d.mts.map +1 -0
  12. package/dist/{Cron-zsoSAwZo.d.cts → Cron-D_sfaMGz.d.cts} +14 -7
  13. package/dist/Cron-D_sfaMGz.d.cts.map +1 -0
  14. package/dist/CronBuilder-4BZhkChG.d.mts +47 -0
  15. package/dist/CronBuilder-4BZhkChG.d.mts.map +1 -0
  16. package/dist/{CronBuilder-D_0HNBTr.mjs → CronBuilder-BJ5LoadF.mjs} +28 -11
  17. package/dist/CronBuilder-BJ5LoadF.mjs.map +1 -0
  18. package/dist/{CronBuilder-BdnI6lxF.cjs → CronBuilder-B_NSP-Y5.cjs} +27 -10
  19. package/dist/CronBuilder-B_NSP-Y5.cjs.map +1 -0
  20. package/dist/CronBuilder-C91MVLSr.d.cts +47 -0
  21. package/dist/CronBuilder-C91MVLSr.d.cts.map +1 -0
  22. package/dist/Endpoint-52z1P0Ue.cjs +581 -0
  23. package/dist/Endpoint-52z1P0Ue.cjs.map +1 -0
  24. package/dist/{Endpoint-oS-Fe3d_.d.mts → Endpoint-BUoDD96P.d.mts} +104 -23
  25. package/dist/Endpoint-BUoDD96P.d.mts.map +1 -0
  26. package/dist/{Endpoint-DBflWAe4.d.cts → Endpoint-YYwjqtS1.d.cts} +101 -20
  27. package/dist/Endpoint-YYwjqtS1.d.cts.map +1 -0
  28. package/dist/Endpoint-sUOU7uLx.mjs +552 -0
  29. package/dist/Endpoint-sUOU7uLx.mjs.map +1 -0
  30. package/dist/{index-Cc4kKPag.d.mts → EndpointFactory-BbVOeryo.d.mts} +189 -106
  31. package/dist/EndpointFactory-BbVOeryo.d.mts.map +1 -0
  32. package/dist/{EndpointFactory-Bm3aKRdV.mjs → EndpointFactory-Bzi9Sl7r.mjs} +269 -53
  33. package/dist/EndpointFactory-Bzi9Sl7r.mjs.map +1 -0
  34. package/dist/{EndpointFactory-CLvWuHyt.cjs → EndpointFactory-Cf_Cs1ym.cjs} +309 -51
  35. package/dist/EndpointFactory-Cf_Cs1ym.cjs.map +1 -0
  36. package/dist/{index-C1ZwNOOk.d.cts → EndpointFactory-Hh1r6J_C.d.cts} +187 -104
  37. package/dist/EndpointFactory-Hh1r6J_C.d.cts.map +1 -0
  38. package/dist/Function-BIEsY0Hm.d.cts +76 -0
  39. package/dist/Function-BIEsY0Hm.d.cts.map +1 -0
  40. package/dist/Function-BKReud5p.d.mts +76 -0
  41. package/dist/Function-BKReud5p.d.mts.map +1 -0
  42. package/dist/{HonoEndpointAdaptor-92zavCsV.cjs → HonoEndpointAdaptor-BTbqfSaa.cjs} +115 -41
  43. package/dist/HonoEndpointAdaptor-BTbqfSaa.cjs.map +1 -0
  44. package/dist/{HonoEndpointAdaptor-yYaU7jVJ.mjs → HonoEndpointAdaptor-CBVey2cY.mjs} +112 -38
  45. package/dist/HonoEndpointAdaptor-CBVey2cY.mjs.map +1 -0
  46. package/dist/ObjectSubscriberBuilder-DfzXQEKW.d.mts +129 -0
  47. package/dist/ObjectSubscriberBuilder-DfzXQEKW.d.mts.map +1 -0
  48. package/dist/ObjectSubscriberBuilder-LWkey_oq.d.cts +129 -0
  49. package/dist/ObjectSubscriberBuilder-LWkey_oq.d.cts.map +1 -0
  50. package/dist/ProcessorBuilder-D4oYvZeG.d.mts +216 -0
  51. package/dist/ProcessorBuilder-D4oYvZeG.d.mts.map +1 -0
  52. package/dist/ProcessorBuilder-_jdZlbfW.d.cts +216 -0
  53. package/dist/ProcessorBuilder-_jdZlbfW.d.cts.map +1 -0
  54. package/dist/{Queue-D9X6OoON.d.mts → Queue-B8HGg439.d.mts} +42 -41
  55. package/dist/Queue-B8HGg439.d.mts.map +1 -0
  56. package/dist/{Queue-DYPB2KWL.d.cts → Queue-C4rijiM7.d.cts} +43 -42
  57. package/dist/Queue-C4rijiM7.d.cts.map +1 -0
  58. package/dist/Queue-D4Iaidrs.cjs +109 -0
  59. package/dist/Queue-D4Iaidrs.cjs.map +1 -0
  60. package/dist/Queue-u8w8_HpE.mjs +104 -0
  61. package/dist/Queue-u8w8_HpE.mjs.map +1 -0
  62. package/dist/QueueBuilder-2wP5lEC8.mjs +118 -0
  63. package/dist/QueueBuilder-2wP5lEC8.mjs.map +1 -0
  64. package/dist/QueueBuilder-BxsZ9o5z.cjs +135 -0
  65. package/dist/QueueBuilder-BxsZ9o5z.cjs.map +1 -0
  66. package/dist/QueueBuilder-CVS_qPuo.d.mts +75 -0
  67. package/dist/QueueBuilder-CVS_qPuo.d.mts.map +1 -0
  68. package/dist/QueueBuilder-SQli59An.d.cts +75 -0
  69. package/dist/QueueBuilder-SQli59An.d.cts.map +1 -0
  70. package/dist/Subscriber-5rCX1Nph.d.cts +83 -0
  71. package/dist/Subscriber-5rCX1Nph.d.cts.map +1 -0
  72. package/dist/Subscriber-CtQXhcL7.d.mts +83 -0
  73. package/dist/Subscriber-CtQXhcL7.d.mts.map +1 -0
  74. package/dist/SubscriberBuilder-CpFhShTJ.mjs +238 -0
  75. package/dist/SubscriberBuilder-CpFhShTJ.mjs.map +1 -0
  76. package/dist/SubscriberBuilder-DJEvNRdD.cjs +261 -0
  77. package/dist/SubscriberBuilder-DJEvNRdD.cjs.map +1 -0
  78. package/dist/Topic-DN2gYJ-p.mjs +99 -0
  79. package/dist/Topic-DN2gYJ-p.mjs.map +1 -0
  80. package/dist/Topic-Dp9Q7Lj2.cjs +104 -0
  81. package/dist/Topic-Dp9Q7Lj2.cjs.map +1 -0
  82. package/dist/adaptors/aws.cjs +147 -168
  83. package/dist/adaptors/aws.cjs.map +1 -1
  84. package/dist/adaptors/aws.d.cts +57 -48
  85. package/dist/adaptors/aws.d.cts.map +1 -1
  86. package/dist/adaptors/aws.d.mts +58 -49
  87. package/dist/adaptors/aws.d.mts.map +1 -1
  88. package/dist/adaptors/aws.mjs +142 -164
  89. package/dist/adaptors/aws.mjs.map +1 -1
  90. package/dist/adaptors/awsWebsocket.cjs +354 -0
  91. package/dist/adaptors/awsWebsocket.cjs.map +1 -0
  92. package/dist/adaptors/awsWebsocket.d.cts +156 -0
  93. package/dist/adaptors/awsWebsocket.d.cts.map +1 -0
  94. package/dist/adaptors/awsWebsocket.d.mts +156 -0
  95. package/dist/adaptors/awsWebsocket.d.mts.map +1 -0
  96. package/dist/adaptors/awsWebsocket.mjs +347 -0
  97. package/dist/adaptors/awsWebsocket.mjs.map +1 -0
  98. package/dist/adaptors/hono.cjs +1 -1
  99. package/dist/adaptors/hono.d.cts +8 -7
  100. package/dist/adaptors/hono.d.cts.map +1 -1
  101. package/dist/adaptors/hono.d.mts +10 -9
  102. package/dist/adaptors/hono.d.mts.map +1 -1
  103. package/dist/adaptors/hono.mjs +1 -1
  104. package/dist/adaptors/testing.cjs +1174 -41
  105. package/dist/adaptors/testing.cjs.map +1 -1
  106. package/dist/adaptors/testing.d.cts +517 -40
  107. package/dist/adaptors/testing.d.cts.map +1 -1
  108. package/dist/adaptors/testing.d.mts +517 -40
  109. package/dist/adaptors/testing.d.mts.map +1 -1
  110. package/dist/adaptors/testing.mjs +1140 -36
  111. package/dist/adaptors/testing.mjs.map +1 -1
  112. package/dist/auth-BqWz2JxC.d.cts +274 -0
  113. package/dist/auth-BqWz2JxC.d.cts.map +1 -0
  114. package/dist/auth-DnB9H9KL.d.mts +274 -0
  115. package/dist/auth-DnB9H9KL.d.mts.map +1 -0
  116. package/dist/auth.cjs +308 -23
  117. package/dist/auth.cjs.map +1 -1
  118. package/dist/auth.d.cts +2 -104
  119. package/dist/auth.d.mts +2 -104
  120. package/dist/auth.mjs +304 -25
  121. package/dist/auth.mjs.map +1 -1
  122. package/dist/cache-CCHcO9Oo.d.mts +44 -0
  123. package/dist/cache-CCHcO9Oo.d.mts.map +1 -0
  124. package/dist/cache-CQjMNPrC.d.cts +44 -0
  125. package/dist/cache-CQjMNPrC.d.cts.map +1 -0
  126. package/dist/cache.cjs +3 -19
  127. package/dist/cache.cjs.map +1 -1
  128. package/dist/cache.d.cts +2 -43
  129. package/dist/cache.d.mts +2 -43
  130. package/dist/cache.mjs +2 -18
  131. package/dist/cache.mjs.map +1 -1
  132. package/dist/cipher-C1lEFX63.mjs +225 -0
  133. package/dist/cipher-C1lEFX63.mjs.map +1 -0
  134. package/dist/cipher-CVxfwLjk.cjs +332 -0
  135. package/dist/cipher-CVxfwLjk.cjs.map +1 -0
  136. package/dist/cipher-DSDxPRIp.d.cts +106 -0
  137. package/dist/cipher-DSDxPRIp.d.cts.map +1 -0
  138. package/dist/cipher-DSDxPRIp.d.mts +106 -0
  139. package/dist/cipher-DSDxPRIp.d.mts.map +1 -0
  140. package/dist/{construct-interface-DPlxfpoS.d.mts → construct-interface-CSA9VeWM.d.mts} +47 -8
  141. package/dist/construct-interface-CSA9VeWM.d.mts.map +1 -0
  142. package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-DugP0E5q.d.cts} +47 -8
  143. package/dist/construct-interface-DugP0E5q.d.cts.map +1 -0
  144. package/dist/construct-interface.cjs +38 -4
  145. package/dist/construct-interface.cjs.map +1 -1
  146. package/dist/construct-interface.d.cts +2 -2
  147. package/dist/construct-interface.d.mts +2 -2
  148. package/dist/construct-interface.mjs +37 -5
  149. package/dist/construct-interface.mjs.map +1 -1
  150. package/dist/credential-DYymbp_7.cjs +257 -0
  151. package/dist/credential-DYymbp_7.cjs.map +1 -0
  152. package/dist/credential-DfSAOOdY.mjs +222 -0
  153. package/dist/credential-DfSAOOdY.mjs.map +1 -0
  154. package/dist/credential.cjs +7 -129
  155. package/dist/credential.d.cts +2 -58
  156. package/dist/credential.d.mts +2 -58
  157. package/dist/credential.mjs +2 -128
  158. package/dist/crons/index.cjs +127 -1
  159. package/dist/crons/index.cjs.map +1 -1
  160. package/dist/crons/index.d.cts +43 -3
  161. package/dist/crons/index.d.cts.map +1 -1
  162. package/dist/crons/index.d.mts +43 -3
  163. package/dist/crons/index.d.mts.map +1 -1
  164. package/dist/crons/index.mjs +126 -2
  165. package/dist/crons/index.mjs.map +1 -1
  166. package/dist/database/kysely.cjs +3 -194
  167. package/dist/database/kysely.d.cts +2 -149
  168. package/dist/database/kysely.d.mts +2 -149
  169. package/dist/database/kysely.mjs +2 -192
  170. package/dist/email.cjs +4 -16
  171. package/dist/email.cjs.map +1 -1
  172. package/dist/email.d.cts +1 -1
  173. package/dist/email.d.cts.map +1 -1
  174. package/dist/email.d.mts +2 -2
  175. package/dist/email.d.mts.map +1 -1
  176. package/dist/email.mjs +2 -14
  177. package/dist/email.mjs.map +1 -1
  178. package/dist/encryption/kms.cjs +95 -0
  179. package/dist/encryption/kms.cjs.map +1 -0
  180. package/dist/encryption/kms.d.cts +7 -0
  181. package/dist/encryption/kms.d.cts.map +1 -0
  182. package/dist/encryption/kms.d.mts +7 -0
  183. package/dist/encryption/kms.d.mts.map +1 -0
  184. package/dist/encryption/kms.mjs +93 -0
  185. package/dist/encryption/kms.mjs.map +1 -0
  186. package/dist/encryption.cjs +116 -0
  187. package/dist/encryption.cjs.map +1 -0
  188. package/dist/encryption.d.cts +37 -0
  189. package/dist/encryption.d.cts.map +1 -0
  190. package/dist/encryption.d.mts +37 -0
  191. package/dist/encryption.d.mts.map +1 -0
  192. package/dist/encryption.mjs +101 -0
  193. package/dist/encryption.mjs.map +1 -0
  194. package/dist/endpoints/index.cjs +32 -10
  195. package/dist/endpoints/index.d.cts +106 -3
  196. package/dist/endpoints/index.d.cts.map +1 -0
  197. package/dist/endpoints/index.d.mts +106 -3
  198. package/dist/endpoints/index.d.mts.map +1 -0
  199. package/dist/endpoints/index.mjs +6 -4
  200. package/dist/expire-C586zznE.d.cts +38 -0
  201. package/dist/expire-C586zznE.d.cts.map +1 -0
  202. package/dist/expire-C586zznE.d.mts +38 -0
  203. package/dist/expire-C586zznE.d.mts.map +1 -0
  204. package/dist/expire-CieftS01.cjs +67 -0
  205. package/dist/expire-CieftS01.cjs.map +1 -0
  206. package/dist/expire-CpzUAfr9.mjs +50 -0
  207. package/dist/expire-CpzUAfr9.mjs.map +1 -0
  208. package/dist/external-api.cjs +106 -0
  209. package/dist/external-api.cjs.map +1 -0
  210. package/dist/external-api.d.cts +2 -0
  211. package/dist/external-api.d.mts +2 -0
  212. package/dist/external-api.mjs +103 -0
  213. package/dist/external-api.mjs.map +1 -0
  214. package/dist/fake-BqhP8RRQ.d.mts +201 -0
  215. package/dist/fake-BqhP8RRQ.d.mts.map +1 -0
  216. package/dist/fake-DqieDYYA.d.cts +201 -0
  217. package/dist/fake-DqieDYYA.d.cts.map +1 -0
  218. package/dist/file-server.cjs +123 -30
  219. package/dist/file-server.cjs.map +1 -1
  220. package/dist/file-server.d.cts +115 -1
  221. package/dist/file-server.d.cts.map +1 -1
  222. package/dist/file-server.d.mts +115 -1
  223. package/dist/file-server.d.mts.map +1 -1
  224. package/dist/file-server.mjs +122 -32
  225. package/dist/file-server.mjs.map +1 -1
  226. package/dist/functions/index.cjs +1 -1
  227. package/dist/functions/index.d.cts +2 -1
  228. package/dist/functions/index.d.mts +2 -1
  229. package/dist/functions/index.mjs +1 -1
  230. package/dist/{functions-C53GW2eQ.mjs → functions-BvIDQKAA.mjs} +117 -22
  231. package/dist/functions-BvIDQKAA.mjs.map +1 -0
  232. package/dist/{functions-B6qCvfmy.cjs → functions-DLF6-IK8.cjs} +122 -18
  233. package/dist/functions-DLF6-IK8.cjs.map +1 -0
  234. package/dist/inbox-CR3L1fOI.d.cts +195 -0
  235. package/dist/inbox-CR3L1fOI.d.cts.map +1 -0
  236. package/dist/inbox-YOdxlyfj.d.mts +195 -0
  237. package/dist/inbox-YOdxlyfj.d.mts.map +1 -0
  238. package/dist/inbox.cjs +291 -0
  239. package/dist/inbox.cjs.map +1 -0
  240. package/dist/inbox.d.cts +2 -0
  241. package/dist/inbox.d.mts +2 -0
  242. package/dist/inbox.mjs +283 -0
  243. package/dist/inbox.mjs.map +1 -0
  244. package/dist/index-BoQ3-M-K.d.mts +115 -0
  245. package/dist/index-BoQ3-M-K.d.mts.map +1 -0
  246. package/dist/index-DPTHa6Ud.d.cts +115 -0
  247. package/dist/index-DPTHa6Ud.d.cts.map +1 -0
  248. package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
  249. package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
  250. package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
  251. package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
  252. package/dist/index.cjs +4 -1
  253. package/dist/index.d.cts +26 -3
  254. package/dist/index.d.cts.map +1 -0
  255. package/dist/index.d.mts +26 -3
  256. package/dist/index.d.mts.map +1 -0
  257. package/dist/index.mjs +3 -2
  258. package/dist/kysely-CebjCWTl.d.cts +216 -0
  259. package/dist/kysely-CebjCWTl.d.cts.map +1 -0
  260. package/dist/kysely-Cs4uPO8k.mjs +371 -0
  261. package/dist/kysely-Cs4uPO8k.mjs.map +1 -0
  262. package/dist/kysely-CukArHJ0.cjs +384 -0
  263. package/dist/kysely-CukArHJ0.cjs.map +1 -0
  264. package/dist/kysely-De5rAC-E.d.mts +216 -0
  265. package/dist/kysely-De5rAC-E.d.mts.map +1 -0
  266. package/dist/{telemetry-DGcFlVpB.d.cts → lambdaTelemetry-8vnmVZQ5.d.cts} +2 -2
  267. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +1 -0
  268. package/dist/{telemetry-DGcFlVpB.d.mts → lambdaTelemetry-8vnmVZQ5.d.mts} +2 -2
  269. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +1 -0
  270. package/dist/mobile-app.cjs +74 -0
  271. package/dist/mobile-app.cjs.map +1 -0
  272. package/dist/mobile-app.d.cts +73 -0
  273. package/dist/mobile-app.d.cts.map +1 -0
  274. package/dist/mobile-app.d.mts +73 -0
  275. package/dist/mobile-app.d.mts.map +1 -0
  276. package/dist/mobile-app.mjs +73 -0
  277. package/dist/mobile-app.mjs.map +1 -0
  278. package/dist/object-storage.cjs +8 -1
  279. package/dist/object-storage.cjs.map +1 -1
  280. package/dist/object-storage.d.cts +10 -1
  281. package/dist/object-storage.d.cts.map +1 -1
  282. package/dist/object-storage.d.mts +10 -1
  283. package/dist/object-storage.d.mts.map +1 -1
  284. package/dist/object-storage.mjs +7 -2
  285. package/dist/object-storage.mjs.map +1 -1
  286. package/dist/optionalPeers-D7Wt6dnF.mjs +140 -0
  287. package/dist/optionalPeers-D7Wt6dnF.mjs.map +1 -0
  288. package/dist/optionalPeers-DuNQXXe1.cjs +223 -0
  289. package/dist/optionalPeers-DuNQXXe1.cjs.map +1 -0
  290. package/dist/origins-BjxYht13.cjs +96 -0
  291. package/dist/origins-BjxYht13.cjs.map +1 -0
  292. package/dist/origins-Boc9qbo-.mjs +73 -0
  293. package/dist/origins-Boc9qbo-.mjs.map +1 -0
  294. package/dist/pattern-C1CEcglD.mjs +241 -0
  295. package/dist/pattern-C1CEcglD.mjs.map +1 -0
  296. package/dist/pattern-QFaUIr77.cjs +288 -0
  297. package/dist/pattern-QFaUIr77.cjs.map +1 -0
  298. package/dist/privateAddress-Bg5fUsbp.mjs +21 -0
  299. package/dist/privateAddress-Bg5fUsbp.mjs.map +1 -0
  300. package/dist/privateAddress-CqGyuFHn.cjs +26 -0
  301. package/dist/privateAddress-CqGyuFHn.cjs.map +1 -0
  302. package/dist/processors/index.cjs +214 -0
  303. package/dist/processors/index.cjs.map +1 -0
  304. package/dist/processors/index.d.cts +78 -0
  305. package/dist/processors/index.d.cts.map +1 -0
  306. package/dist/processors/index.d.mts +78 -0
  307. package/dist/processors/index.d.mts.map +1 -0
  308. package/dist/processors/index.mjs +193 -0
  309. package/dist/processors/index.mjs.map +1 -0
  310. package/dist/queue/index.cjs +5 -192
  311. package/dist/queue/index.d.cts +3 -53
  312. package/dist/queue/index.d.mts +3 -53
  313. package/dist/queue/index.mjs +3 -190
  314. package/dist/random-password.cjs +86 -0
  315. package/dist/random-password.cjs.map +1 -0
  316. package/dist/random-password.d.cts +30 -0
  317. package/dist/random-password.d.cts.map +1 -0
  318. package/dist/random-password.d.mts +30 -0
  319. package/dist/random-password.d.mts.map +1 -0
  320. package/dist/random-password.mjs +84 -0
  321. package/dist/random-password.mjs.map +1 -0
  322. package/dist/readRequestBody-BmKnPl0a.mjs +293 -0
  323. package/dist/readRequestBody-BmKnPl0a.mjs.map +1 -0
  324. package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-CN9GVdeE.cjs} +141 -47
  325. package/dist/readRequestBody-CN9GVdeE.cjs.map +1 -0
  326. package/dist/{processAudits-D_2W5x8k.cjs → requestLogger-CnoYd-Ah.cjs} +63 -3
  327. package/dist/requestLogger-CnoYd-Ah.cjs.map +1 -0
  328. package/dist/{processAudits-BpRlPQMW.mjs → requestLogger-D2JS7pPM.mjs} +51 -3
  329. package/dist/requestLogger-D2JS7pPM.mjs.map +1 -0
  330. package/dist/rest-api.cjs +85 -70
  331. package/dist/rest-api.cjs.map +1 -1
  332. package/dist/rest-api.d.cts +77 -59
  333. package/dist/rest-api.d.cts.map +1 -1
  334. package/dist/rest-api.d.mts +77 -59
  335. package/dist/rest-api.d.mts.map +1 -1
  336. package/dist/rest-api.mjs +87 -72
  337. package/dist/rest-api.mjs.map +1 -1
  338. package/dist/runSubscriber-HEqXkin1.mjs +117 -0
  339. package/dist/runSubscriber-HEqXkin1.mjs.map +1 -0
  340. package/dist/runSubscriber-sVJfLA0-.cjs +134 -0
  341. package/dist/runSubscriber-sVJfLA0-.cjs.map +1 -0
  342. package/dist/shutdown-BMJmAhSt.cjs +38 -0
  343. package/dist/shutdown-BMJmAhSt.cjs.map +1 -0
  344. package/dist/shutdown-C7xa8x9S.mjs +27 -0
  345. package/dist/shutdown-C7xa8x9S.mjs.map +1 -0
  346. package/dist/site.cjs +104 -8
  347. package/dist/site.cjs.map +1 -1
  348. package/dist/site.d.cts +132 -2
  349. package/dist/site.d.cts.map +1 -1
  350. package/dist/site.d.mts +132 -2
  351. package/dist/site.d.mts.map +1 -1
  352. package/dist/site.mjs +102 -11
  353. package/dist/site.mjs.map +1 -1
  354. package/dist/stages-DaTaoQei.d.cts +73 -0
  355. package/dist/stages-DaTaoQei.d.cts.map +1 -0
  356. package/dist/stages-DaTaoQei.d.mts +73 -0
  357. package/dist/stages-DaTaoQei.d.mts.map +1 -0
  358. package/dist/subscribers/index.cjs +134 -1
  359. package/dist/subscribers/index.cjs.map +1 -0
  360. package/dist/subscribers/index.d.cts +74 -3
  361. package/dist/subscribers/index.d.cts.map +1 -0
  362. package/dist/subscribers/index.d.mts +74 -3
  363. package/dist/subscribers/index.d.mts.map +1 -0
  364. package/dist/subscribers/index.mjs +132 -2
  365. package/dist/subscribers/index.mjs.map +1 -0
  366. package/dist/telemetry-C1oqncFY.d.cts +40 -0
  367. package/dist/telemetry-C1oqncFY.d.cts.map +1 -0
  368. package/dist/telemetry-CObow3Dn.d.mts +40 -0
  369. package/dist/telemetry-CObow3Dn.d.mts.map +1 -0
  370. package/dist/telemetry.cjs +56 -0
  371. package/dist/telemetry.cjs.map +1 -0
  372. package/dist/telemetry.d.cts +2 -0
  373. package/dist/telemetry.d.mts +2 -0
  374. package/dist/telemetry.mjs +55 -0
  375. package/dist/telemetry.mjs.map +1 -0
  376. package/dist/topic/index.cjs +2 -134
  377. package/dist/topic/index.d.cts +2 -3
  378. package/dist/topic/index.d.mts +2 -3
  379. package/dist/topic/index.mjs +2 -132
  380. package/dist/tracing-Bbj1uoFJ.mjs +127 -0
  381. package/dist/tracing-Bbj1uoFJ.mjs.map +1 -0
  382. package/dist/tracing-C0ooU0V2.cjs +150 -0
  383. package/dist/tracing-C0ooU0V2.cjs.map +1 -0
  384. package/dist/websocket-api-Bg9SowJ5.mjs +1710 -0
  385. package/dist/websocket-api-Bg9SowJ5.mjs.map +1 -0
  386. package/dist/websocket-api-CPEzJyDt.d.mts +1201 -0
  387. package/dist/websocket-api-CPEzJyDt.d.mts.map +1 -0
  388. package/dist/websocket-api-DkF8Hva-.d.cts +1201 -0
  389. package/dist/websocket-api-DkF8Hva-.d.cts.map +1 -0
  390. package/dist/websocket-api-czxhekGG.cjs +1889 -0
  391. package/dist/websocket-api-czxhekGG.cjs.map +1 -0
  392. package/dist/websocket-api.cjs +35 -0
  393. package/dist/websocket-api.d.cts +2 -0
  394. package/dist/websocket-api.d.mts +2 -0
  395. package/dist/websocket-api.mjs +3 -0
  396. package/dist/worker.cjs +174 -32
  397. package/dist/worker.cjs.map +1 -1
  398. package/dist/worker.d.cts +147 -47
  399. package/dist/worker.d.cts.map +1 -1
  400. package/dist/worker.d.mts +147 -47
  401. package/dist/worker.d.mts.map +1 -1
  402. package/dist/worker.mjs +175 -33
  403. package/dist/worker.mjs.map +1 -1
  404. package/package.json +180 -43
  405. package/dist/Construct-BeYVu_QF.mjs.map +0 -1
  406. package/dist/Construct-DfbwIntp.d.cts +0 -115
  407. package/dist/Construct-DfbwIntp.d.cts.map +0 -1
  408. package/dist/Construct-DqdlARxq.cjs.map +0 -1
  409. package/dist/Construct-l5aOn_jv.d.mts +0 -115
  410. package/dist/Construct-l5aOn_jv.d.mts.map +0 -1
  411. package/dist/Cron-l4Wlz6G9.d.mts.map +0 -1
  412. package/dist/Cron-zsoSAwZo.d.cts.map +0 -1
  413. package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
  414. package/dist/CronBuilder-CyT71Nzg.d.cts +0 -41
  415. package/dist/CronBuilder-CyT71Nzg.d.cts.map +0 -1
  416. package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
  417. package/dist/CronBuilder-UoNgFe8S.d.mts +0 -41
  418. package/dist/CronBuilder-UoNgFe8S.d.mts.map +0 -1
  419. package/dist/Endpoint-BpZHtJ2W.cjs +0 -1689
  420. package/dist/Endpoint-BpZHtJ2W.cjs.map +0 -1
  421. package/dist/Endpoint-DBflWAe4.d.cts.map +0 -1
  422. package/dist/Endpoint-ONsly_dq.mjs +0 -1671
  423. package/dist/Endpoint-ONsly_dq.mjs.map +0 -1
  424. package/dist/Endpoint-oS-Fe3d_.d.mts.map +0 -1
  425. package/dist/EndpointFactory-Bm3aKRdV.mjs.map +0 -1
  426. package/dist/EndpointFactory-CLvWuHyt.cjs.map +0 -1
  427. package/dist/HonoEndpointAdaptor-92zavCsV.cjs.map +0 -1
  428. package/dist/HonoEndpointAdaptor-yYaU7jVJ.mjs.map +0 -1
  429. package/dist/Queue-D9X6OoON.d.mts.map +0 -1
  430. package/dist/Queue-DYPB2KWL.d.cts.map +0 -1
  431. package/dist/Subscriber-C4heaAyO.d.mts +0 -51
  432. package/dist/Subscriber-C4heaAyO.d.mts.map +0 -1
  433. package/dist/Subscriber-CotDUELC.d.cts +0 -51
  434. package/dist/Subscriber-CotDUELC.d.cts.map +0 -1
  435. package/dist/SubscriberBuilder-BEv0eoHy.d.cts +0 -59
  436. package/dist/SubscriberBuilder-BEv0eoHy.d.cts.map +0 -1
  437. package/dist/SubscriberBuilder-C0ZEtGDI.cjs +0 -125
  438. package/dist/SubscriberBuilder-C0ZEtGDI.cjs.map +0 -1
  439. package/dist/SubscriberBuilder-h7B_cHMr.mjs +0 -114
  440. package/dist/SubscriberBuilder-h7B_cHMr.mjs.map +0 -1
  441. package/dist/SubscriberBuilder-tyH5yTk5.d.mts +0 -59
  442. package/dist/SubscriberBuilder-tyH5yTk5.d.mts.map +0 -1
  443. package/dist/Topic-DEVGo0Dm.d.cts +0 -89
  444. package/dist/Topic-DEVGo0Dm.d.cts.map +0 -1
  445. package/dist/Topic-zk_6Gthr.d.mts +0 -89
  446. package/dist/Topic-zk_6Gthr.d.mts.map +0 -1
  447. package/dist/auth.d.cts.map +0 -1
  448. package/dist/auth.d.mts.map +0 -1
  449. package/dist/cache.d.cts.map +0 -1
  450. package/dist/cache.d.mts.map +0 -1
  451. package/dist/construct-interface-DPlxfpoS.d.mts.map +0 -1
  452. package/dist/construct-interface-DgXTJcOD.d.cts.map +0 -1
  453. package/dist/credential.cjs.map +0 -1
  454. package/dist/credential.d.cts.map +0 -1
  455. package/dist/credential.d.mts.map +0 -1
  456. package/dist/credential.mjs.map +0 -1
  457. package/dist/database/kysely.cjs.map +0 -1
  458. package/dist/database/kysely.d.cts.map +0 -1
  459. package/dist/database/kysely.d.mts.map +0 -1
  460. package/dist/database/kysely.mjs.map +0 -1
  461. package/dist/functions-B6qCvfmy.cjs.map +0 -1
  462. package/dist/functions-C53GW2eQ.mjs.map +0 -1
  463. package/dist/index-B2urf3YI.d.cts +0 -26
  464. package/dist/index-B2urf3YI.d.cts.map +0 -1
  465. package/dist/index-C1ZwNOOk.d.cts.map +0 -1
  466. package/dist/index-Cc4kKPag.d.mts.map +0 -1
  467. package/dist/index-DMCDvnsM.d.mts +0 -26
  468. package/dist/index-DMCDvnsM.d.mts.map +0 -1
  469. package/dist/index-D_frT6MP.d.cts +0 -165
  470. package/dist/index-D_frT6MP.d.cts.map +0 -1
  471. package/dist/index-DcyIYbDS.d.mts +0 -165
  472. package/dist/index-DcyIYbDS.d.mts.map +0 -1
  473. package/dist/lazyAccessors-BHtcqgz2.mjs +0 -211
  474. package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
  475. package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
  476. package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
  477. package/dist/processAudits-D_2W5x8k.cjs.map +0 -1
  478. package/dist/queue/index.cjs.map +0 -1
  479. package/dist/queue/index.d.cts.map +0 -1
  480. package/dist/queue/index.d.mts.map +0 -1
  481. package/dist/queue/index.mjs.map +0 -1
  482. package/dist/telemetry-DGcFlVpB.d.cts.map +0 -1
  483. package/dist/telemetry-DGcFlVpB.d.mts.map +0 -1
  484. package/dist/topic/index.cjs.map +0 -1
  485. package/dist/topic/index.mjs.map +0 -1
@@ -0,0 +1,354 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
2
+ const require_origins = require("../origins-BjxYht13.cjs");
3
+ let _geekmidas_manifest = require("@geekmidas/manifest");
4
+ let _aws_sdk_client_apigatewaymanagementapi = require("@aws-sdk/client-apigatewaymanagementapi");
5
+ let _aws_sdk_client_dynamodb = require("@aws-sdk/client-dynamodb");
6
+ let electrodb = require("electrodb");
7
+ //#region src/websocket/apigateway.ts
8
+ /**
9
+ * The API Gateway (v2, WebSocket) adaptor: a Lambda per route, over the
10
+ * surface's `WebSocketCore`.
11
+ *
12
+ * API Gateway holds the sockets. A Lambda only sees events — `$connect`, a
13
+ * frame on a route, `$disconnect` — so this owns what the gateway does not:
14
+ *
15
+ * - **the Origin check** in `$connect`, against the same origins the Node
16
+ * adaptor trusts;
17
+ * - **the connection table**, where a connection's `data` (what the connect
18
+ * handler returned) is kept between invocations, and the ids a broadcast
19
+ * goes to are read from;
20
+ * - **the sink**, `postToConnection` and `deleteConnection` on the management
21
+ * API, with a connection that has gone (410) dropped from the table rather
22
+ * than reported — as a Redis publisher drops a socket nobody holds.
23
+ *
24
+ * Both are reached through the surface's `<ID>_PUBLISHER_CONNECTION_STRING`,
25
+ * an `apigateway://` string on an AWS stage, which is also what
26
+ * `services.<surface>` reads in any other Lambda.
27
+ *
28
+ * This is the AWS adaptor, `@geekmidas/constructs/aws-websocket`: it imports
29
+ * the AWS SDK clients it is built on, so they are needed only by a project
30
+ * that serves a surface from API Gateway.
31
+ */
32
+ /**
33
+ * How long a row outlives its connection's start. API Gateway closes every
34
+ * connection after two hours, so a row the `$disconnect` never deleted — a
35
+ * Lambda that timed out — expires a little after that.
36
+ */
37
+ const CONNECTION_TTL_SECONDS = 7800;
38
+ /**
39
+ * The connection table in DynamoDB: one item per connection, keyed by
40
+ * `connectionId`, with its `data` as JSON and an `expiresAt` the table's TTL
41
+ * reads. Provisioned beside the API by `@geekmidas/cloud`, so a surface on
42
+ * AWS needs nothing declared for it.
43
+ */
44
+ var DynamoConnectionTable = class DynamoConnectionTable {
45
+ table;
46
+ options;
47
+ connections;
48
+ /** A table on a client of DynamoDB at `region` (or an emulator's `endpoint`). */
49
+ static create(table, options) {
50
+ const client = new _aws_sdk_client_dynamodb.DynamoDBClient({
51
+ region: options.region,
52
+ ...options.endpoint ? { endpoint: options.endpoint } : {}
53
+ });
54
+ return new DynamoConnectionTable(table, client, { ttl: options.ttl });
55
+ }
56
+ constructor(table, client, options = {}) {
57
+ this.table = table;
58
+ this.options = options;
59
+ this.connections = connectionEntity(table, client);
60
+ }
61
+ async put(connection) {
62
+ const ttl = this.options.ttl ?? 7800;
63
+ await this.connections.put({
64
+ connectionId: connection.id,
65
+ data: JSON.stringify(connection.data),
66
+ expiresAt: nowSeconds() + ttl
67
+ }).go();
68
+ }
69
+ async get(id) {
70
+ const { data: item } = await this.connections.get({ connectionId: id }).go({ consistent: true });
71
+ if (!item || item.expiresAt <= nowSeconds()) return void 0;
72
+ return {
73
+ id,
74
+ data: JSON.parse(item.data)
75
+ };
76
+ }
77
+ async delete(ids) {
78
+ if (ids.length === 0) return;
79
+ await this.connections.delete(ids.map((connectionId) => ({ connectionId }))).go();
80
+ }
81
+ async ids() {
82
+ const { data: items } = await this.connections.scan.where(({ expiresAt }, { gt }) => gt(expiresAt, nowSeconds())).go({
83
+ pages: "all",
84
+ attributes: ["connectionId", "expiresAt"]
85
+ });
86
+ return items.map((item) => item.connectionId);
87
+ }
88
+ };
89
+ /**
90
+ * One connection's row. The table's hash key is the `connectionId` attribute
91
+ * itself, as `@geekmidas/cloud` provisions it, and `expiresAt` is its TTL.
92
+ */
93
+ function connectionEntity(table, client) {
94
+ return new electrodb.Entity({
95
+ model: {
96
+ entity: "connection",
97
+ service: "gkm-websocket",
98
+ version: "1"
99
+ },
100
+ attributes: {
101
+ connectionId: {
102
+ type: "string",
103
+ required: true
104
+ },
105
+ data: {
106
+ type: "string",
107
+ required: true
108
+ },
109
+ expiresAt: {
110
+ type: "number",
111
+ required: true
112
+ }
113
+ },
114
+ indexes: { primary: { pk: {
115
+ field: "connectionId",
116
+ composite: ["connectionId"],
117
+ casing: "none"
118
+ } } }
119
+ }, {
120
+ table,
121
+ client
122
+ });
123
+ }
124
+ /**
125
+ * A publisher's sink on API Gateway: each send a `postToConnection`, each
126
+ * close a `deleteConnection`, a broadcast every id in the table. A connection
127
+ * that has gone answers 410; it is dropped from the table, and the send to
128
+ * the rest goes on.
129
+ *
130
+ * API Gateway closes a connection with a code of its own: `close(ids, code,
131
+ * reason)` ends the connections, but its client does not see `code` or
132
+ * `reason`.
133
+ */
134
+ var ApiGatewaySink = class ApiGatewaySink {
135
+ client;
136
+ table;
137
+ /** A sink on a client of the management API at `target`. */
138
+ static create(target, table) {
139
+ const client = new _aws_sdk_client_apigatewaymanagementapi.ApiGatewayManagementApiClient({
140
+ region: target.region,
141
+ endpoint: target.endpoint
142
+ });
143
+ return new ApiGatewaySink(client, table);
144
+ }
145
+ constructor(client, table) {
146
+ this.client = client;
147
+ this.table = table;
148
+ }
149
+ async send(ids, payload) {
150
+ if (ids.length === 0) return;
151
+ const data = new TextEncoder().encode(payload);
152
+ const gone = await this.each(ids, (id) => this.client.send(new _aws_sdk_client_apigatewaymanagementapi.PostToConnectionCommand({
153
+ ConnectionId: id,
154
+ Data: data
155
+ })));
156
+ await this.table.delete(gone);
157
+ }
158
+ async broadcast(payload, except) {
159
+ const skip = new Set(except ?? []);
160
+ const ids = (await this.table.ids()).filter((id) => !skip.has(id));
161
+ await this.send(ids, payload);
162
+ }
163
+ async close(ids) {
164
+ if (ids.length === 0) return;
165
+ await this.each(ids, (id) => this.client.send(new _aws_sdk_client_apigatewaymanagementapi.DeleteConnectionCommand({ ConnectionId: id })));
166
+ await this.table.delete(ids);
167
+ }
168
+ /** Call `fn` for each id; the ids that had gone. Anything else throws. */
169
+ async each(ids, fn) {
170
+ const gone = [];
171
+ await Promise.all(ids.map(async (id) => {
172
+ try {
173
+ await fn(id);
174
+ } catch (error) {
175
+ if (!isGone(error)) throw error;
176
+ gone.push(id);
177
+ }
178
+ }));
179
+ return gone;
180
+ }
181
+ };
182
+ /**
183
+ * `services.<surface>` on an AWS stage: the management API's sink for an
184
+ * `apigateway://` publisher string. An AWS build's entry registers it with
185
+ * `registerWebSocketSinkDriver`, and {@link AmazonApiGatewayWebSocket} does
186
+ * for its own Lambda.
187
+ */
188
+ const apiGatewayWebSocketDriver = {
189
+ scheme: _geekmidas_manifest.API_GATEWAY_WEBSOCKET_SCHEME,
190
+ sink: (connectionString) => apiGatewayFromConnectionString(connectionString).sink
191
+ };
192
+ /** A table and a sink from an `apigateway://` publisher string. */
193
+ function apiGatewayFromConnectionString(connectionString) {
194
+ const target = (0, _geekmidas_manifest.parseApiGatewayWebSocketUrl)(connectionString);
195
+ const table = DynamoConnectionTable.create(target.table, {
196
+ region: target.region,
197
+ ...target.tableEndpoint ? { endpoint: target.tableEndpoint } : {}
198
+ });
199
+ return {
200
+ target,
201
+ table,
202
+ sink: ApiGatewaySink.create(target, table)
203
+ };
204
+ }
205
+ /**
206
+ * A WebSocket surface served by API Gateway: `handler` is the Lambda for one
207
+ * or more of its routes.
208
+ *
209
+ * ```ts
210
+ * // .gkm/aws/websocket/routes/send.ts, as `gkm build --provider aws` writes it
211
+ * const adaptor = new AmazonApiGatewayWebSocket(realtime, { modules: [{ send }] });
212
+ * export const handler = adaptor.handler;
213
+ * ```
214
+ */
215
+ var AmazonApiGatewayWebSocket = class {
216
+ surface;
217
+ options;
218
+ ready;
219
+ constructor(surface, options = {}) {
220
+ this.surface = surface;
221
+ this.options = options;
222
+ require_origins.registerWebSocketSinkDriver(apiGatewayWebSocketDriver);
223
+ }
224
+ /** The Lambda handler. */
225
+ handler = (event) => this.handle(event);
226
+ get logger() {
227
+ return this.surface.logger;
228
+ }
229
+ /** Read the keys and build the core once per container. */
230
+ setup() {
231
+ this.ready ??= Promise.resolve().then(() => {
232
+ const envParser = this.options.envParser ?? this.surface.envParser;
233
+ const { keys } = this.surface;
234
+ const config = envParser.create((get) => ({
235
+ connectionString: get(keys.publisherConnectionString).string().optional(),
236
+ origins: get(keys.trustedOrigins).string().default("").transform((value) => value.split(",").map((origin) => origin.trim()).filter(Boolean)),
237
+ url: get(keys.url).string().optional()
238
+ })).parse();
239
+ let { table, sink } = this.options;
240
+ if (!table || !sink) {
241
+ if (!config.connectionString) throw new WebSocketPublisherNotConfigured(this.surface.id, keys.publisherConnectionString);
242
+ const fromString = apiGatewayFromConnectionString(config.connectionString);
243
+ table ??= fromString.table;
244
+ sink ??= fromString.sink;
245
+ }
246
+ return {
247
+ core: this.surface.core({
248
+ envParser,
249
+ sink,
250
+ ...this.options.modules ? { modules: this.options.modules } : {}
251
+ }),
252
+ table,
253
+ sink,
254
+ trusted: [...config.origins, ...require_origins.ownOrigins(config.url)]
255
+ };
256
+ });
257
+ return this.ready;
258
+ }
259
+ async handle(event) {
260
+ const { connectionId, eventType } = event.requestContext;
261
+ const { core, table, sink, trusted } = await this.setup();
262
+ if (eventType === "CONNECT") {
263
+ const headers = headersOf(event);
264
+ const origin = headers.get("origin");
265
+ if (origin && !(0, _geekmidas_manifest.trustsOrigin)(origin, trusted)) return {
266
+ statusCode: 403,
267
+ body: "Forbidden"
268
+ };
269
+ const outcome = await core.connect({
270
+ connectionId,
271
+ headers,
272
+ query: queryOf(event)
273
+ });
274
+ if (!outcome.accepted) return {
275
+ statusCode: outcome.status,
276
+ body: outcome.statusText
277
+ };
278
+ await table.put(outcome.connection);
279
+ return { statusCode: 200 };
280
+ }
281
+ const connection = await table.get(connectionId) ?? {
282
+ id: connectionId,
283
+ data: {}
284
+ };
285
+ if (eventType === "DISCONNECT") {
286
+ await core.disconnect(connection, {
287
+ code: event.requestContext.disconnectStatusCode ?? 1005,
288
+ reason: event.requestContext.disconnectReason ?? ""
289
+ });
290
+ await table.delete([connectionId]);
291
+ return { statusCode: 200 };
292
+ }
293
+ const writes = [];
294
+ const write = (payload) => {
295
+ writes.push(sink.send([connectionId], payload).catch((error) => {
296
+ this.logger.error({
297
+ err: error,
298
+ connectionId
299
+ }, "WebSocket reply could not be posted");
300
+ }));
301
+ };
302
+ const raw = event.isBase64Encoded ? Uint8Array.from(Buffer.from(event.body ?? "", "base64")) : event.body ?? "";
303
+ await core.message(connection, raw, write);
304
+ await Promise.all(writes);
305
+ return { statusCode: 200 };
306
+ }
307
+ };
308
+ /** A Lambda of the surface was started without its publisher string. */
309
+ var WebSocketPublisherNotConfigured = class extends Error {
310
+ surface;
311
+ key;
312
+ constructor(surface, key) {
313
+ super(`${surface}'s Lambda has no ${key}, so it cannot reach its connections. Link the route to its surface — gkm build and @geekmidas/cloud's fromManifest do — or pass a table and a sink to AmazonApiGatewayWebSocket.`);
314
+ this.surface = surface;
315
+ this.key = key;
316
+ this.name = "WebSocketPublisherNotConfigured";
317
+ }
318
+ };
319
+ function headersOf(event) {
320
+ const headers = new Headers();
321
+ if (event.multiValueHeaders) {
322
+ for (const [name, values] of Object.entries(event.multiValueHeaders)) for (const value of values ?? []) headers.append(name, value);
323
+ return headers;
324
+ }
325
+ for (const [name, value] of Object.entries(event.headers ?? {})) if (value !== void 0) headers.append(name, value);
326
+ return headers;
327
+ }
328
+ function queryOf(event) {
329
+ const query = new URLSearchParams();
330
+ if (event.multiValueQueryStringParameters) {
331
+ for (const [name, values] of Object.entries(event.multiValueQueryStringParameters)) for (const value of values ?? []) query.append(name, value);
332
+ return query;
333
+ }
334
+ for (const [name, value] of Object.entries(event.queryStringParameters ?? {})) if (value !== void 0) query.append(name, value);
335
+ return query;
336
+ }
337
+ /** A management API answer for a connection that has gone. */
338
+ function isGone(error) {
339
+ const e = error;
340
+ return e?.name === "GoneException" || e?.$metadata?.httpStatusCode === 410;
341
+ }
342
+ function nowSeconds() {
343
+ return Math.floor(Date.now() / 1e3);
344
+ }
345
+ //#endregion
346
+ exports.AmazonApiGatewayWebSocket = AmazonApiGatewayWebSocket;
347
+ exports.ApiGatewaySink = ApiGatewaySink;
348
+ exports.CONNECTION_TTL_SECONDS = CONNECTION_TTL_SECONDS;
349
+ exports.DynamoConnectionTable = DynamoConnectionTable;
350
+ exports.WebSocketPublisherNotConfigured = WebSocketPublisherNotConfigured;
351
+ exports.apiGatewayFromConnectionString = apiGatewayFromConnectionString;
352
+ exports.apiGatewayWebSocketDriver = apiGatewayWebSocketDriver;
353
+
354
+ //# sourceMappingURL=awsWebsocket.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"awsWebsocket.cjs","names":["DynamoDBClient","Entity","ApiGatewayManagementApiClient","PostToConnectionCommand","DeleteConnectionCommand","API_GATEWAY_WEBSOCKET_SCHEME","parseApiGatewayWebSocketUrl","ownOrigins","trustsOrigin"],"sources":["../../src/websocket/apigateway.ts"],"sourcesContent":["/**\n * The API Gateway (v2, WebSocket) adaptor: a Lambda per route, over the\n * surface's `WebSocketCore`.\n *\n * API Gateway holds the sockets. A Lambda only sees events — `$connect`, a\n * frame on a route, `$disconnect` — so this owns what the gateway does not:\n *\n * - **the Origin check** in `$connect`, against the same origins the Node\n * adaptor trusts;\n * - **the connection table**, where a connection's `data` (what the connect\n * handler returned) is kept between invocations, and the ids a broadcast\n * goes to are read from;\n * - **the sink**, `postToConnection` and `deleteConnection` on the management\n * API, with a connection that has gone (410) dropped from the table rather\n * than reported — as a Redis publisher drops a socket nobody holds.\n *\n * Both are reached through the surface's `<ID>_PUBLISHER_CONNECTION_STRING`,\n * an `apigateway://` string on an AWS stage, which is also what\n * `services.<surface>` reads in any other Lambda.\n *\n * This is the AWS adaptor, `@geekmidas/constructs/aws-websocket`: it imports\n * the AWS SDK clients it is built on, so they are needed only by a project\n * that serves a surface from API Gateway.\n */\n\nimport {\n\tApiGatewayManagementApiClient,\n\tDeleteConnectionCommand,\n\tPostToConnectionCommand,\n} from '@aws-sdk/client-apigatewaymanagementapi';\nimport { DynamoDBClient } from '@aws-sdk/client-dynamodb';\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport {\n\tAPI_GATEWAY_WEBSOCKET_SCHEME,\n\ttype ApiGatewayWebSocketTarget,\n\tparseApiGatewayWebSocketUrl,\n\ttrustsOrigin,\n} from '@geekmidas/manifest';\nimport { Entity } from 'electrodb';\nimport type { WebSocketApi } from '../websocket-api';\nimport type { WebSocketCore } from './core';\nimport {\n\tregisterWebSocketSinkDriver,\n\ttype WebSocketSinkDriver,\n} from './drivers';\nimport { ownOrigins } from './origins';\nimport type { NoMessages, WebSocketMessages, WebSocketSink } from './publisher';\nimport type { Connection } from './route';\n\n/**\n * How long a row outlives its connection's start. API Gateway closes every\n * connection after two hours, so a row the `$disconnect` never deleted — a\n * Lambda that timed out — expires a little after that.\n */\nexport const CONNECTION_TTL_SECONDS = 2 * 60 * 60 + 10 * 60;\n\n/**\n * Where a surface's open connections are kept on API Gateway, by id: the\n * `data` its connect handler returned, which every later invocation hands\n * to its route, and the list a broadcast goes to.\n */\nexport interface ConnectionTable {\n\tput(connection: Connection): Promise<void>;\n\tget(id: string): Promise<Connection | undefined>;\n\tdelete(ids: readonly string[]): Promise<void>;\n\t/** Every open connection's id. */\n\tids(): Promise<string[]>;\n}\n\n/**\n * The connection table in DynamoDB: one item per connection, keyed by\n * `connectionId`, with its `data` as JSON and an `expiresAt` the table's TTL\n * reads. Provisioned beside the API by `@geekmidas/cloud`, so a surface on\n * AWS needs nothing declared for it.\n */\nexport class DynamoConnectionTable implements ConnectionTable {\n\tprivate readonly connections: ReturnType<typeof connectionEntity>;\n\n\t/** A table on a client of DynamoDB at `region` (or an emulator's `endpoint`). */\n\tstatic create(\n\t\ttable: string,\n\t\toptions: {\n\t\t\tregion: string;\n\t\t\t/** An emulator's address; AWS's own when absent. */\n\t\t\tendpoint?: string;\n\t\t\t/** Seconds a row is kept. Default {@link CONNECTION_TTL_SECONDS}. */\n\t\t\tttl?: number;\n\t\t},\n\t): DynamoConnectionTable {\n\t\tconst client = new DynamoDBClient({\n\t\t\tregion: options.region,\n\t\t\t...(options.endpoint ? { endpoint: options.endpoint } : {}),\n\t\t});\n\t\treturn new DynamoConnectionTable(table, client, { ttl: options.ttl });\n\t}\n\n\tconstructor(\n\t\treadonly table: string,\n\t\tclient: DynamoDBClient,\n\t\tprivate readonly options: {\n\t\t\t/** Seconds a row is kept. Default {@link CONNECTION_TTL_SECONDS}. */\n\t\t\tttl?: number;\n\t\t} = {},\n\t) {\n\t\tthis.connections = connectionEntity(table, client);\n\t}\n\n\tasync put(connection: Connection): Promise<void> {\n\t\tconst ttl = this.options.ttl ?? CONNECTION_TTL_SECONDS;\n\t\tawait this.connections\n\t\t\t.put({\n\t\t\t\tconnectionId: connection.id,\n\t\t\t\tdata: JSON.stringify(connection.data),\n\t\t\t\texpiresAt: nowSeconds() + ttl,\n\t\t\t})\n\t\t\t.go();\n\t}\n\n\tasync get(id: string): Promise<Connection | undefined> {\n\t\t// `$connect` wrote it a moment ago; the first frame must see it.\n\t\tconst { data: item } = await this.connections\n\t\t\t.get({ connectionId: id })\n\t\t\t.go({ consistent: true });\n\t\tif (!item || item.expiresAt <= nowSeconds()) return undefined;\n\t\treturn { id, data: JSON.parse(item.data) };\n\t}\n\n\tasync delete(ids: readonly string[]): Promise<void> {\n\t\tif (ids.length === 0) return;\n\t\tawait this.connections\n\t\t\t.delete(ids.map((connectionId) => ({ connectionId })))\n\t\t\t.go();\n\t}\n\n\tasync ids(): Promise<string[]> {\n\t\tconst { data: items } = await this.connections.scan\n\t\t\t.where(({ expiresAt }, { gt }) => gt(expiresAt, nowSeconds()))\n\t\t\t.go({ pages: 'all', attributes: ['connectionId', 'expiresAt'] });\n\t\t// DynamoDB deletes an expired item eventually, not on time.\n\t\treturn items.map((item) => item.connectionId);\n\t}\n}\n\n/**\n * One connection's row. The table's hash key is the `connectionId` attribute\n * itself, as `@geekmidas/cloud` provisions it, and `expiresAt` is its TTL.\n */\nfunction connectionEntity(table: string, client: DynamoDBClient) {\n\treturn new Entity(\n\t\t{\n\t\t\tmodel: {\n\t\t\t\tentity: 'connection',\n\t\t\t\tservice: 'gkm-websocket',\n\t\t\t\tversion: '1',\n\t\t\t},\n\t\t\tattributes: {\n\t\t\t\tconnectionId: { type: 'string', required: true },\n\t\t\t\tdata: { type: 'string', required: true },\n\t\t\t\texpiresAt: { type: 'number', required: true },\n\t\t\t},\n\t\t\tindexes: {\n\t\t\t\tprimary: {\n\t\t\t\t\t// A connection id is case-sensitive; ElectroDB lowercases keys\n\t\t\t\t\t// unless told not to, and a lowered id is a 410 on every post.\n\t\t\t\t\tpk: {\n\t\t\t\t\t\tfield: 'connectionId',\n\t\t\t\t\t\tcomposite: ['connectionId'],\n\t\t\t\t\t\tcasing: 'none',\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{ table, client },\n\t);\n}\n\n/**\n * A publisher's sink on API Gateway: each send a `postToConnection`, each\n * close a `deleteConnection`, a broadcast every id in the table. A connection\n * that has gone answers 410; it is dropped from the table, and the send to\n * the rest goes on.\n *\n * API Gateway closes a connection with a code of its own: `close(ids, code,\n * reason)` ends the connections, but its client does not see `code` or\n * `reason`.\n */\nexport class ApiGatewaySink implements WebSocketSink {\n\t/** A sink on a client of the management API at `target`. */\n\tstatic create(\n\t\ttarget: Pick<ApiGatewayWebSocketTarget, 'endpoint' | 'region'>,\n\t\ttable: ConnectionTable,\n\t): ApiGatewaySink {\n\t\tconst client = new ApiGatewayManagementApiClient({\n\t\t\tregion: target.region,\n\t\t\tendpoint: target.endpoint,\n\t\t});\n\t\treturn new ApiGatewaySink(client, table);\n\t}\n\n\tconstructor(\n\t\tprivate readonly client: ApiGatewayManagementApiClient,\n\t\tprivate readonly table: ConnectionTable,\n\t) {}\n\n\tasync send(ids: readonly string[], payload: string): Promise<void> {\n\t\tif (ids.length === 0) return;\n\t\tconst data = new TextEncoder().encode(payload);\n\t\tconst gone = await this.each(ids, (id) =>\n\t\t\tthis.client.send(\n\t\t\t\tnew PostToConnectionCommand({\n\t\t\t\t\tConnectionId: id,\n\t\t\t\t\tData: data,\n\t\t\t\t}),\n\t\t\t),\n\t\t);\n\t\tawait this.table.delete(gone);\n\t}\n\n\tasync broadcast(payload: string, except?: readonly string[]): Promise<void> {\n\t\tconst skip = new Set(except ?? []);\n\t\tconst ids = (await this.table.ids()).filter((id) => !skip.has(id));\n\t\tawait this.send(ids, payload);\n\t}\n\n\tasync close(ids: readonly string[]): Promise<void> {\n\t\tif (ids.length === 0) return;\n\t\tawait this.each(ids, (id) =>\n\t\t\tthis.client.send(new DeleteConnectionCommand({ ConnectionId: id })),\n\t\t);\n\t\t// Its `$disconnect` deletes the row too; a connection that was already\n\t\t// gone has no `$disconnect` left to run.\n\t\tawait this.table.delete(ids);\n\t}\n\n\t/** Call `fn` for each id; the ids that had gone. Anything else throws. */\n\tprivate async each(\n\t\tids: readonly string[],\n\t\tfn: (id: string) => Promise<unknown>,\n\t): Promise<string[]> {\n\t\tconst gone: string[] = [];\n\t\tawait Promise.all(\n\t\t\tids.map(async (id) => {\n\t\t\t\ttry {\n\t\t\t\t\tawait fn(id);\n\t\t\t\t} catch (error) {\n\t\t\t\t\tif (!isGone(error)) throw error;\n\t\t\t\t\tgone.push(id);\n\t\t\t\t}\n\t\t\t}),\n\t\t);\n\t\treturn gone;\n\t}\n}\n\n/**\n * `services.<surface>` on an AWS stage: the management API's sink for an\n * `apigateway://` publisher string. An AWS build's entry registers it with\n * `registerWebSocketSinkDriver`, and {@link AmazonApiGatewayWebSocket} does\n * for its own Lambda.\n */\nexport const apiGatewayWebSocketDriver: WebSocketSinkDriver = {\n\tscheme: API_GATEWAY_WEBSOCKET_SCHEME,\n\tsink: (connectionString) =>\n\t\tapiGatewayFromConnectionString(connectionString).sink,\n};\n\n/** A table and a sink from an `apigateway://` publisher string. */\nexport function apiGatewayFromConnectionString(connectionString: string): {\n\ttarget: ApiGatewayWebSocketTarget;\n\ttable: DynamoConnectionTable;\n\tsink: ApiGatewaySink;\n} {\n\tconst target = parseApiGatewayWebSocketUrl(connectionString);\n\tconst table = DynamoConnectionTable.create(target.table, {\n\t\tregion: target.region,\n\t\t...(target.tableEndpoint ? { endpoint: target.tableEndpoint } : {}),\n\t});\n\treturn { target, table, sink: ApiGatewaySink.create(target, table) };\n}\n\n/**\n * What API Gateway invokes a WebSocket route's Lambda with — the fields this\n * adaptor reads. `headers` and the query arrive on `$connect` only.\n */\nexport interface ApiGatewayWebSocketEvent {\n\trequestContext: {\n\t\tconnectionId: string;\n\t\teventType: 'CONNECT' | 'MESSAGE' | 'DISCONNECT';\n\t\trouteKey: string;\n\t\tdisconnectStatusCode?: number;\n\t\tdisconnectReason?: string;\n\t};\n\theaders?: Record<string, string | undefined> | null;\n\tmultiValueHeaders?: Record<string, string[] | undefined> | null;\n\tqueryStringParameters?: Record<string, string | undefined> | null;\n\tmultiValueQueryStringParameters?: Record<string, string[] | undefined> | null;\n\tbody?: string | null;\n\tisBase64Encoded?: boolean;\n}\n\n/** What the Lambda answers: a non-2xx on `$connect` refuses the socket. */\nexport interface ApiGatewayWebSocketResult {\n\tstatusCode: number;\n\tbody?: string;\n}\n\nexport interface AmazonApiGatewayWebSocketOptions {\n\t/**\n\t * Files exporting the routes this Lambda serves — the generated handler\n\t * hands in the one route API Gateway invokes it for.\n\t */\n\tmodules?: readonly object[];\n\t/** Where the surface's keys are read. Absent, the surface's own parser. */\n\tenvParser?: EnvironmentParser<{}>;\n\t/**\n\t * The connection table and the sink, in place of the ones the\n\t * `apigateway://` publisher string names.\n\t */\n\ttable?: ConnectionTable;\n\tsink?: WebSocketSink;\n}\n\n/**\n * A WebSocket surface served by API Gateway: `handler` is the Lambda for one\n * or more of its routes.\n *\n * ```ts\n * // .gkm/aws/websocket/routes/send.ts, as `gkm build --provider aws` writes it\n * const adaptor = new AmazonApiGatewayWebSocket(realtime, { modules: [{ send }] });\n * export const handler = adaptor.handler;\n * ```\n */\nexport class AmazonApiGatewayWebSocket<\n\tTMessages extends WebSocketMessages = NoMessages,\n> {\n\tprivate ready?: Promise<{\n\t\tcore: WebSocketCore<TMessages>;\n\t\ttable: ConnectionTable;\n\t\tsink: WebSocketSink;\n\t\ttrusted: string[];\n\t}>;\n\n\tconstructor(\n\t\tprivate readonly surface: WebSocketApi<string, TMessages>,\n\t\tprivate readonly options: AmazonApiGatewayWebSocketOptions = {},\n\t) {\n\t\t// A route's own `services.<surface>` publishes through API Gateway too.\n\t\tregisterWebSocketSinkDriver(apiGatewayWebSocketDriver);\n\t}\n\n\t/** The Lambda handler. */\n\treadonly handler = (\n\t\tevent: ApiGatewayWebSocketEvent,\n\t): Promise<ApiGatewayWebSocketResult> => this.handle(event);\n\n\tprivate get logger(): Logger {\n\t\treturn this.surface.logger;\n\t}\n\n\t/** Read the keys and build the core once per container. */\n\tprivate setup() {\n\t\tthis.ready ??= Promise.resolve().then(() => {\n\t\t\tconst envParser = this.options.envParser ?? this.surface.envParser;\n\t\t\tconst { keys } = this.surface;\n\t\t\tconst config = envParser\n\t\t\t\t.create((get) => ({\n\t\t\t\t\tconnectionString: get(keys.publisherConnectionString)\n\t\t\t\t\t\t.string()\n\t\t\t\t\t\t.optional(),\n\t\t\t\t\torigins: get(keys.trustedOrigins)\n\t\t\t\t\t\t.string()\n\t\t\t\t\t\t.default('')\n\t\t\t\t\t\t.transform((value: string) =>\n\t\t\t\t\t\t\tvalue\n\t\t\t\t\t\t\t\t.split(',')\n\t\t\t\t\t\t\t\t.map((origin) => origin.trim())\n\t\t\t\t\t\t\t\t.filter(Boolean),\n\t\t\t\t\t\t),\n\t\t\t\t\turl: get(keys.url).string().optional(),\n\t\t\t\t}))\n\t\t\t\t.parse();\n\n\t\t\tlet { table, sink } = this.options;\n\t\t\tif (!table || !sink) {\n\t\t\t\tif (!config.connectionString) {\n\t\t\t\t\tthrow new WebSocketPublisherNotConfigured(\n\t\t\t\t\t\tthis.surface.id,\n\t\t\t\t\t\tkeys.publisherConnectionString,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tconst fromString = apiGatewayFromConnectionString(\n\t\t\t\t\tconfig.connectionString,\n\t\t\t\t);\n\t\t\t\ttable ??= fromString.table;\n\t\t\t\tsink ??= fromString.sink;\n\t\t\t}\n\n\t\t\tconst core = this.surface.core({\n\t\t\t\tenvParser,\n\t\t\t\tsink,\n\t\t\t\t...(this.options.modules ? { modules: this.options.modules } : {}),\n\t\t\t});\n\t\t\treturn {\n\t\t\t\tcore,\n\t\t\t\ttable,\n\t\t\t\tsink,\n\t\t\t\ttrusted: [...config.origins, ...ownOrigins(config.url)],\n\t\t\t};\n\t\t});\n\t\treturn this.ready;\n\t}\n\n\tasync handle(\n\t\tevent: ApiGatewayWebSocketEvent,\n\t): Promise<ApiGatewayWebSocketResult> {\n\t\tconst { connectionId, eventType } = event.requestContext;\n\t\tconst { core, table, sink, trusted } = await this.setup();\n\n\t\tif (eventType === 'CONNECT') {\n\t\t\tconst headers = headersOf(event);\n\t\t\tconst origin = headers.get('origin');\n\t\t\tif (origin && !trustsOrigin(origin, trusted)) {\n\t\t\t\treturn { statusCode: 403, body: 'Forbidden' };\n\t\t\t}\n\n\t\t\tconst outcome = await core.connect({\n\t\t\t\tconnectionId,\n\t\t\t\theaders,\n\t\t\t\tquery: queryOf(event),\n\t\t\t});\n\t\t\tif (!outcome.accepted) {\n\t\t\t\treturn { statusCode: outcome.status, body: outcome.statusText };\n\t\t\t}\n\t\t\tawait table.put(outcome.connection);\n\t\t\treturn { statusCode: 200 };\n\t\t}\n\n\t\t// A connection the table no longer has — a row that expired early, or\n\t\t// one written by a `$connect` that failed after accepting — is still\n\t\t// served, with nothing its connect handler said about it.\n\t\tconst connection = (await table.get(connectionId)) ?? {\n\t\t\tid: connectionId,\n\t\t\tdata: {},\n\t\t};\n\n\t\tif (eventType === 'DISCONNECT') {\n\t\t\tawait core.disconnect(connection, {\n\t\t\t\tcode: event.requestContext.disconnectStatusCode ?? 1005,\n\t\t\t\treason: event.requestContext.disconnectReason ?? '',\n\t\t\t});\n\t\t\tawait table.delete([connectionId]);\n\t\t\treturn { statusCode: 200 };\n\t\t}\n\n\t\t// What the route writes back — its reply, `reply()`, an `$error` — is\n\t\t// posted to the caller, and waited for before the Lambda returns: a\n\t\t// frozen container sends nothing.\n\t\tconst writes: Promise<void>[] = [];\n\t\tconst write = (payload: string) => {\n\t\t\twrites.push(\n\t\t\t\tsink.send([connectionId], payload).catch((error) => {\n\t\t\t\t\tthis.logger.error(\n\t\t\t\t\t\t{ err: error, connectionId },\n\t\t\t\t\t\t'WebSocket reply could not be posted',\n\t\t\t\t\t);\n\t\t\t\t}),\n\t\t\t);\n\t\t};\n\t\tconst raw = event.isBase64Encoded\n\t\t\t? Uint8Array.from(Buffer.from(event.body ?? '', 'base64'))\n\t\t\t: (event.body ?? '');\n\t\tawait core.message(connection, raw, write);\n\t\tawait Promise.all(writes);\n\t\treturn { statusCode: 200 };\n\t}\n}\n\n/** A Lambda of the surface was started without its publisher string. */\nexport class WebSocketPublisherNotConfigured extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly key: string,\n\t) {\n\t\tsuper(\n\t\t\t`${surface}'s Lambda has no ${key}, so it cannot reach its connections. Link the route to its surface — gkm build and @geekmidas/cloud's fromManifest do — or pass a table and a sink to AmazonApiGatewayWebSocket.`,\n\t\t);\n\t\tthis.name = 'WebSocketPublisherNotConfigured';\n\t}\n}\n\nfunction headersOf(event: ApiGatewayWebSocketEvent): Headers {\n\tconst headers = new Headers();\n\tif (event.multiValueHeaders) {\n\t\tfor (const [name, values] of Object.entries(event.multiValueHeaders)) {\n\t\t\tfor (const value of values ?? []) headers.append(name, value);\n\t\t}\n\t\treturn headers;\n\t}\n\tfor (const [name, value] of Object.entries(event.headers ?? {})) {\n\t\tif (value !== undefined) headers.append(name, value);\n\t}\n\treturn headers;\n}\n\nfunction queryOf(event: ApiGatewayWebSocketEvent): URLSearchParams {\n\tconst query = new URLSearchParams();\n\tif (event.multiValueQueryStringParameters) {\n\t\tfor (const [name, values] of Object.entries(\n\t\t\tevent.multiValueQueryStringParameters,\n\t\t)) {\n\t\t\tfor (const value of values ?? []) query.append(name, value);\n\t\t}\n\t\treturn query;\n\t}\n\tfor (const [name, value] of Object.entries(\n\t\tevent.queryStringParameters ?? {},\n\t)) {\n\t\tif (value !== undefined) query.append(name, value);\n\t}\n\treturn query;\n}\n\n/** A management API answer for a connection that has gone. */\nfunction isGone(error: unknown): boolean {\n\tconst e = error as {\n\t\tname?: string;\n\t\t$metadata?: { httpStatusCode?: number };\n\t} | null;\n\treturn e?.name === 'GoneException' || e?.$metadata?.httpStatusCode === 410;\n}\n\nfunction nowSeconds(): number {\n\treturn Math.floor(Date.now() / 1000);\n}\n"],"mappings":"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"}
@@ -0,0 +1,156 @@
1
+ import { L as Connection, _t as WebSocketSink, a as WebSocketSinkDriver, ht as WebSocketMessages, n as WebSocketApi, pt as NoMessages } from "../websocket-api-DkF8Hva-.cjs";
2
+ import { EnvironmentParser } from "@geekmidas/envkit";
3
+ import { ApiGatewayWebSocketTarget } from "@geekmidas/manifest";
4
+ import { ApiGatewayManagementApiClient } from "@aws-sdk/client-apigatewaymanagementapi";
5
+ import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
6
+ //#region src/websocket/apigateway.d.ts
7
+ /**
8
+ * How long a row outlives its connection's start. API Gateway closes every
9
+ * connection after two hours, so a row the `$disconnect` never deleted — a
10
+ * Lambda that timed out — expires a little after that.
11
+ */
12
+ export declare const CONNECTION_TTL_SECONDS: number;
13
+ /**
14
+ * Where a surface's open connections are kept on API Gateway, by id: the
15
+ * `data` its connect handler returned, which every later invocation hands
16
+ * to its route, and the list a broadcast goes to.
17
+ */
18
+ interface ConnectionTable {
19
+ put(connection: Connection): Promise<void>;
20
+ get(id: string): Promise<Connection | undefined>;
21
+ delete(ids: readonly string[]): Promise<void>;
22
+ /** Every open connection's id. */
23
+ ids(): Promise<string[]>;
24
+ }
25
+ /**
26
+ * The connection table in DynamoDB: one item per connection, keyed by
27
+ * `connectionId`, with its `data` as JSON and an `expiresAt` the table's TTL
28
+ * reads. Provisioned beside the API by `@geekmidas/cloud`, so a surface on
29
+ * AWS needs nothing declared for it.
30
+ */
31
+ export declare class DynamoConnectionTable implements ConnectionTable {
32
+ readonly table: string;
33
+ private readonly options;
34
+ private readonly connections;
35
+ /** A table on a client of DynamoDB at `region` (or an emulator's `endpoint`). */
36
+ static create(table: string, options: {
37
+ region: string;
38
+ /** An emulator's address; AWS's own when absent. */
39
+ endpoint?: string;
40
+ /** Seconds a row is kept. Default {@link CONNECTION_TTL_SECONDS}. */
41
+ ttl?: number;
42
+ }): DynamoConnectionTable;
43
+ constructor(table: string, client: DynamoDBClient, options?: {
44
+ /** Seconds a row is kept. Default {@link CONNECTION_TTL_SECONDS}. */
45
+ ttl?: number;
46
+ });
47
+ put(connection: Connection): Promise<void>;
48
+ get(id: string): Promise<Connection | undefined>;
49
+ delete(ids: readonly string[]): Promise<void>;
50
+ ids(): Promise<string[]>;
51
+ }
52
+ /**
53
+ * A publisher's sink on API Gateway: each send a `postToConnection`, each
54
+ * close a `deleteConnection`, a broadcast every id in the table. A connection
55
+ * that has gone answers 410; it is dropped from the table, and the send to
56
+ * the rest goes on.
57
+ *
58
+ * API Gateway closes a connection with a code of its own: `close(ids, code,
59
+ * reason)` ends the connections, but its client does not see `code` or
60
+ * `reason`.
61
+ */
62
+ export declare class ApiGatewaySink implements WebSocketSink {
63
+ private readonly client;
64
+ private readonly table;
65
+ /** A sink on a client of the management API at `target`. */
66
+ static create(target: Pick<ApiGatewayWebSocketTarget, 'endpoint' | 'region'>, table: ConnectionTable): ApiGatewaySink;
67
+ constructor(client: ApiGatewayManagementApiClient, table: ConnectionTable);
68
+ send(ids: readonly string[], payload: string): Promise<void>;
69
+ broadcast(payload: string, except?: readonly string[]): Promise<void>;
70
+ close(ids: readonly string[]): Promise<void>;
71
+ /** Call `fn` for each id; the ids that had gone. Anything else throws. */
72
+ private each;
73
+ }
74
+ /**
75
+ * `services.<surface>` on an AWS stage: the management API's sink for an
76
+ * `apigateway://` publisher string. An AWS build's entry registers it with
77
+ * `registerWebSocketSinkDriver`, and {@link AmazonApiGatewayWebSocket} does
78
+ * for its own Lambda.
79
+ */
80
+ export declare const apiGatewayWebSocketDriver: WebSocketSinkDriver;
81
+ /** A table and a sink from an `apigateway://` publisher string. */
82
+ export declare function apiGatewayFromConnectionString(connectionString: string): {
83
+ target: ApiGatewayWebSocketTarget;
84
+ table: DynamoConnectionTable;
85
+ sink: ApiGatewaySink;
86
+ };
87
+ /**
88
+ * What API Gateway invokes a WebSocket route's Lambda with — the fields this
89
+ * adaptor reads. `headers` and the query arrive on `$connect` only.
90
+ */
91
+ interface ApiGatewayWebSocketEvent {
92
+ requestContext: {
93
+ connectionId: string;
94
+ eventType: 'CONNECT' | 'MESSAGE' | 'DISCONNECT';
95
+ routeKey: string;
96
+ disconnectStatusCode?: number;
97
+ disconnectReason?: string;
98
+ };
99
+ headers?: Record<string, string | undefined> | null;
100
+ multiValueHeaders?: Record<string, string[] | undefined> | null;
101
+ queryStringParameters?: Record<string, string | undefined> | null;
102
+ multiValueQueryStringParameters?: Record<string, string[] | undefined> | null;
103
+ body?: string | null;
104
+ isBase64Encoded?: boolean;
105
+ }
106
+ /** What the Lambda answers: a non-2xx on `$connect` refuses the socket. */
107
+ interface ApiGatewayWebSocketResult {
108
+ statusCode: number;
109
+ body?: string;
110
+ }
111
+ interface AmazonApiGatewayWebSocketOptions {
112
+ /**
113
+ * Files exporting the routes this Lambda serves — the generated handler
114
+ * hands in the one route API Gateway invokes it for.
115
+ */
116
+ modules?: readonly object[];
117
+ /** Where the surface's keys are read. Absent, the surface's own parser. */
118
+ envParser?: EnvironmentParser<{}>;
119
+ /**
120
+ * The connection table and the sink, in place of the ones the
121
+ * `apigateway://` publisher string names.
122
+ */
123
+ table?: ConnectionTable;
124
+ sink?: WebSocketSink;
125
+ }
126
+ /**
127
+ * A WebSocket surface served by API Gateway: `handler` is the Lambda for one
128
+ * or more of its routes.
129
+ *
130
+ * ```ts
131
+ * // .gkm/aws/websocket/routes/send.ts, as `gkm build --provider aws` writes it
132
+ * const adaptor = new AmazonApiGatewayWebSocket(realtime, { modules: [{ send }] });
133
+ * export const handler = adaptor.handler;
134
+ * ```
135
+ */
136
+ export declare class AmazonApiGatewayWebSocket<TMessages extends WebSocketMessages = NoMessages> {
137
+ private readonly surface;
138
+ private readonly options;
139
+ private ready?;
140
+ constructor(surface: WebSocketApi<string, TMessages>, options?: AmazonApiGatewayWebSocketOptions);
141
+ /** The Lambda handler. */
142
+ readonly handler: (event: ApiGatewayWebSocketEvent) => Promise<ApiGatewayWebSocketResult>;
143
+ private get logger();
144
+ /** Read the keys and build the core once per container. */
145
+ private setup;
146
+ handle(event: ApiGatewayWebSocketEvent): Promise<ApiGatewayWebSocketResult>;
147
+ }
148
+ /** A Lambda of the surface was started without its publisher string. */
149
+ export declare class WebSocketPublisherNotConfigured extends Error {
150
+ readonly surface: string;
151
+ readonly key: string;
152
+ constructor(surface: string, key: string);
153
+ }
154
+ //#endregion
155
+ export type { AmazonApiGatewayWebSocketOptions, ApiGatewayWebSocketEvent, ApiGatewayWebSocketResult, ConnectionTable };
156
+ //# sourceMappingURL=awsWebsocket.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"awsWebsocket.d.cts","names":[],"sources":["../../src/websocket/apigateway.ts"],"mappings":";;;;;;;;;;;qBAuDa;;;;;;UAOI;EAChB,IAAI,YAAY,aAAa;EAC7B,IAAI,aAAa,QAAQ;EACzB,OAAO,yBAAyB;;EAEhC,OAAO;;;;;;;;qBASK,iCAAiC;WAsBnC;mBAEQ;mBAvBD;;SAGV,OACN,eACA;IACC;;IAEA;;IAEA;MAEC;EAQH,YACU,eACT,QAAQ,gBACS;;IAEhB;;EAMI,IAAI,YAAY,aAAa;EAW7B,IAAI,aAAa,QAAQ;EASzB,OAAO,yBAAyB;EAOhC,OAAO;;;;;;;;;;;;qBAoDD,0BAA0B;mBAcpB;mBACA;;SAbX,OACN,QAAQ,KAAK,mDACb,OAAO,kBACL;EAQH,YACkB,QAAQ,+BACR,OAAO;EAGnB,KAAK,wBAAwB,kBAAkB;EAc/C,UAAU,iBAAiB,6BAA6B;EAMxD,MAAM,yBAAyB;;UAWvB;;;;;;;;qBAyBF,2BAA2B;;wBAOxB,+BAA+B;EAC9C,QAAQ;EACR,OAAO;EACP,MAAM;;;;;;UAcU;EAChB;IACC;IACA;IACA;IACA;IACA;;EAED,UAAU;EACV,oBAAoB;EACpB,wBAAwB;EACxB,kCAAkC;EAClC;EACA;;;UAIgB;EAChB;EACA;;UAGgB;;;;;EAKhB;;EAEA,YAAY;;;;;EAKZ,QAAQ;EACR,OAAO;;;;;;;;;;;;qBAaK,0BACZ,kBAAkB,oBAAoB;mBAUpB;mBACA;UATV;EAOR,YACkB,SAAS,qBAAqB,YAC9B,UAAS;;WAOlB,UAAO,OACR,6BACL,QAAQ;cAEC;;UAKJ;EAoDF,OACL,OAAO,2BACL,QAAQ;;;qBAgEC,wCAAwC;WAE1C;WACA;EAFV,YACU,iBACA"}